<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.21 (Ruby 3.3.6) -->
<?rfc rfcedstyle="yes"?>
<?rfc tocindent="yes"?>
<?rfc strict="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc text-list-symbols="o-*+"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-belchior-satp-gateway-recovery-03" category="info" consensus="true" submissionType="IETF" tocDepth="4" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.25.0 -->
  <front>
    <title abbrev="SATP Gateway Crash Recovery">Secure Asset Transfer Protocol (SATP) Gateway Crash Recovery Mechanism</title>
    <seriesInfo name="Internet-Draft" value="draft-belchior-satp-gateway-recovery-03"/>
    <author initials="R." surname="Belchior" fullname="Rafael Belchior">
      <organization>INESC-ID, Técnico Lisboa, Blockdaemon</organization>
      <address>
        <email>rafael.belchior@tecnico.ulisboa.pt</email>
      </address>
    </author>
    <author initials="M." surname="Correia" fullname="Miguel Correia">
      <organization>INESC-ID, Técnico Lisboa</organization>
      <address>
        <email>miguel.p.correia@tecnico.ulisboa.pt</email>
      </address>
    </author>
    <author initials="A." surname="Augusto" fullname="André Augusto">
      <organization>INESC-ID, Técnico Lisboa</organization>
      <address>
        <email>andre.augusto@tecnico.ulisboa.pt</email>
      </address>
    </author>
    <author initials="T." surname="Hardjono" fullname="Thomas Hardjono">
      <organization>MIT</organization>
      <address>
        <email>hardjono@mit.edu</email>
      </address>
    </author>
    <date year="2025" month="January" day="20"/>
    <area>Applications and Real-Time</area>
    <workgroup>Secure Asset Transfer Protocol</workgroup>
    <keyword>Internet-Draft</keyword>
    <abstract>
      <?line 90?>

<t>This memo describes the crash recovery mechanism for the Secure Asset Transfer Protocol (SATP). The goal of this draft is to specify the message flow that implements a crash recovery mechanism. The mechanism assures that gateways running SATP are able to recover faults, enforcing ACID properties for asset transfers across ledgers (i.e., double spend does not occur).</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://ietf-satp.github.io/draft-belchior-satp-gateway-recovery/draft-belchior-satp-gateway-recovery.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-belchior-satp-gateway-recovery/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        Secure Asset Transfer Protocol Working Group mailing list (<eref target="mailto:sat@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/sat/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/sat/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/ietf-satp/draft-belchior-satp-gateway-recovery"/>.</t>
    </note>
  </front>
  <middle>
    <?line 95?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>Gateway systems that perform digital asset transfers among networks must possess a degree of resiliency and fault tolerance in the face of possible crashes. Accounting for the possibility of crashes is
particularly important to guarantee asset consistency across networks.</t>
      <t>The crash recovering mechanism is applied to a version of SATP <xref target="I-D.draft-ietf-satp-core"/> using either 2PC or 3PC, which are atomic commitment protocol (ACP).
2PC and 3PC considers two roles: a coordinator who manages the protocol's execution and participants who manage the resources that must be kept consistent. The origin gateway plays the ACP role of Coordinator, and the destination Gateway plays the Participant role in relay mode. Gateways exchange messages corresponding to the protocol execution, generating log entries for each one.
The crash recovery draft does not depend on the specific SATP messages, but defines procedures to recover from crashes and for rollbacks, independently of the specific protocol phase being executed.</t>
      <t>Log entries are organized into logs. Logs enable either the same or other backup gateways to resume any phase of SATP. This log can also serve as an accountability tool in case of disputes. Log entries are then the basis satisfying one of the key deployment requirements of gateways for asset transfers: a high degree of availability. In this document, we consider two common strategies to increase availability: (1) to support the recovery of the gateways (self-healing model) and (2) to employ backup gateways with the ability to resume a stalled transfer (primary-backup model).</t>
      <t>This memo proposes:</t>
      <t>(i) the logging model of the crash recovery mechanism; (ii) the log storage types; (iii) the log storage API; (iv)  the log entry format; (v) the recovery and rollback procedures.</t>
    </section>
    <section anchor="terminology">
      <name>Terminology</name>
      <t>There following are some terminology used in the current document:</t>
      <ul spacing="normal">
        <li>
          <t>Gateway: The collection of services which connects to a minimum of one network or system, and which implements the secure asset transfer protocol.</t>
        </li>
        <li>
          <t>Primary Gateway: The node of a network that has been selected or elected to act as a gateway in an asset transfer.</t>
        </li>
        <li>
          <t>Backup Gateway: The node of a network that has been selected or elected to act as a backup gateway to a primary gateway.</t>
        </li>
        <li>
          <t>Message Flow Parameters: The parameters and payload employed in a message flow between a sending gateway and receiving gateway.</t>
        </li>
        <li>
          <t>Origin Gateway: The gateway that initiates the transfer protocol. Acts as a coordinator of the ACP and mediates the message flow.</t>
        </li>
        <li>
          <t>Destination Gateway: The gateway that is the target of an asset transfer. It follows instructions from the origin Gateway.</t>
        </li>
        <li>
          <t>Log: Set of log entries such that those are ordered by the time of its creation.</t>
        </li>
        <li>
          <t>Public (or Shared) Log: log where several gateways can read and write from it.</t>
        </li>
        <li>
          <t>Private Log: log where only one gateway can read and write from it.</t>
        </li>
        <li>
          <t>Log data: The log information is retained by a gateway connected to an exchanged message within an asset transfer protocol.</t>
        </li>
        <li>
          <t>Log entry: The log information generated and persisted by a gateway regarding one specific message flow step.</t>
        </li>
        <li>
          <t>Log format: The format of log data generated by a gateway.</t>
        </li>
        <li>
          <t>Atomic commit protocol (ACP): A protocol that guarantees that assets taken from a network are persisted into the other network. Examples are two and three-phase commit protocols (2PC, 3PC, respectively) and non-blocking atomic commit protocols.</t>
        </li>
        <li>
          <t>Fault: A fault is an event that alters the expected behavior of a system.</t>
        </li>
        <li>
          <t>Crash-fault tolerant models: the models allowing a system to keep operating correctly despite having a set of faulty components.</t>
        </li>
      </ul>
    </section>
    <section anchor="log-model">
      <name>Logging Model</name>
      <t>We consider the log file to be a stack of log entries. Each time a log entry is added, it goes to the top of the stack (the highest index).
For each protocol step a gateway performs, a log entry is created immediately before executing and immediately after executing a given operation.</t>
      <t>To manipulate the log, we define a set of log primitives that translate log entry requests from a process into log entries, realized by the log storage API (for the context of SATP, Section 3.5):</t>
      <ul spacing="normal">
        <li>
          <t>writeLogEntry(e,L) (WRITE) - appends a log entry e in the log L (held by the corresponding Log Storage Support).</t>
        </li>
        <li>
          <t>getLogEntry(i,L) (READ) - retrieves a log entry with index i from log L.</t>
        </li>
      </ul>
      <t>From these primitives, other functions can be built:</t>
      <ul spacing="normal">
        <li>
          <t>getLogLength (L) (READ) - obtains the number of log entries from log L.</t>
        </li>
        <li>
          <t>getLogDiff(l1,l2) (READ) - obtains the difference between two logs.</t>
        </li>
        <li>
          <t>getLastEntry(L): obtains the last log entry from log L.</t>
        </li>
        <li>
          <t>getLog(L): retrieves the whole log L.</t>
        </li>
        <li>
          <t>updateLog(l1,l2): updates l1 based on l2 (uses getLogDiff and writeLogEntry).</t>
        </li>
      </ul>
      <t>The following example shows a simplified version log referring to the transfer initiation flow SATP phase. Each log entry (simplified, see the definition in Section 3) is composed of metadata (phase, sequence number) and one attribute from the payload (operation). Operations map behavior to state (see Section 4).</t>
      <section anchor="example">
        <name>Example</name>
        <figure anchor="example-log-model">
          <artwork><![CDATA[
     ,--.                     ,--.                                 ,-------.
     |G1|                     |G2|                                 |Log API|
     `--'                     `--'                                 `-------'
      |             [1]: writeLogEntry <1,1,init-validate>             |
      | --------------------------------------------------------------->
      |                        |                                       |
      | initiate SATP's phase 1|                                       |
      | ----------------------->                                       |
      |                        |                                       |
      |                        | [2]: writeLogEntry <1,2,exec-validate>|
      |                        | -------------------------------------->
      |                        |                                       |
      |                        |----.                                  |
      |                        |    | execute validate from p1         |
      |                        |<---'                                  |
      |                        |                                       |
      |                        | [3]: writeLogEntry <1,3,done-validate>|
      |                        | -------------------------------------->
      |                        |                                       |
      |                        | [4]: writeLogEntry <1,4,ack-validate> |
      |                        | -------------------------------------->
      |                        |                                       |
      |   validation complete  |                                       |
      | <-----------------------                                       |
     ,--.                     ,--.                                 ,-------.
     |G1|                     |G2|                                 |Log API|
     `--'                     `--'                                 `-------'

]]></artwork>
        </figure>
        <t>This example shows the sequence of logging operations over part of the first phase of SATP (simplified):</t>
        <ol spacing="normal" type="1"><li>
            <t>At step 1, G1 writes an init-validate operation, meaning it will require G2 to initiate the validate function:
This step generates a log entry (p1, 1, init-validate).</t>
          </li>
          <li>
            <t>At step 2, G2 writes an exec-validate operation, meaning it will try to execute the validate function:
This step generates a log entry (p1, 2, exec-validate).</t>
          </li>
          <li>
            <t>At step 3, G2 writes a done-validate operation, meaning it successfully executed the validate function:
This step generates a log entry (p1, 3, done-validate).</t>
          </li>
          <li>
            <t>At step 4, G2 writes an ack-validate operation, meaning it will send an acknowledgment to G1 regarding the done-validate:
This step generates a log entry (p1, 4, ack-validate).</t>
          </li>
        </ol>
        <t>Without loss of generality, the above logging model applies to all phases of SATP.</t>
      </section>
      <section anchor="satp-example">
        <name>SATP Example</name>
        <t>This example showcases the logging procedure step 2.4 of SATP (lock-assertion) by both gateways.</t>
        <figure anchor="satp-example-lock-assertion">
          <artwork><![CDATA[
    ,----------.               ,----------.                                   ,-------.
     |Gateway G1|               |Gateway G2|                                   |Log API|
     `----------'               `----------'                                   `-------'
          |----.                     |                                             |
          |    | 1 using log api     |                                             |
          |<---'                     |                                             |
          |                          |                                             |
          |              2 writeLogEntry(2,2.2-1,init-lock-assertion)              |
          | ----------------------------------------------------------------------->
          |                          |                                             |
          |  3 Lock-Assertion (2.2)  |                                             |
          | ------------------------->                                             |
          |                          |                                             |
          |                          | 4 writeLogEntry(2,2.2-2,exec-lock-assertion)|
          |                          | -------------------------------------------->
          |                          |                                             |
          |                          |----.                                        |
          |                          |    | 5 execute lock assertion phase         |
          |                          |<---'                                        |
          |                          |                                             |
          |                          | 6 writeLogEntry(2,2.2-3,done-lock-assertion)|
          |                          | -------------------------------------------->
          |                          |                                             |
          |                          |----.                                        |
          |                          |    | 7 generate lock assertion receipt      |
          |                          |<---'                                        |
          |                          |                                             |
          |                          |  8 (optional) write lock assertion receipt  |
          |                          | -------------------------------------------->
          |                          |                                             |
          |                          | 9 writeLogEntry(2,2.2-4,ack-lock-assertion) |
          |                          | -------------------------------------------->
          |                          |                                             |
          | 10 lock assertion receipt|                                             |
          | <-------------------------                                             |
     ,----------.               ,----------.                                   ,-------.
     |Gateway G1|               |Gateway G2|                                   |Log API|
     `----------'               `----------'                                   `-------'

]]></artwork>
        </figure>
      </section>
      <section anchor="log-storage-modes">
        <name>Log Storage Modes</name>
        <t>Gateways store state that is captured by logs. Gateways have private logs recording enterprise-sensitive data that can be used, for instance, for analytics. Entries can include end-to-end cross-jurisdiction transaction latency and throughput.</t>
        <t>Apart from the enterprise log, a state log can be public or private, centralized or decentralized. This log is meant to be shared with everyone with an internet connection (public) or only within the gateway consortium (private). Logs can be stored locally or in a cloud service, per gateway (centralized), or in a decentralized infrastructure (i.e., decentralized ledger, decentralized database). We call the latter option decentralized log storage. The type of the state log depends on the trust assumptions among gateways and the log access mode.</t>
        <t>In greater detail:</t>
        <ol spacing="normal" type="1"><li>
            <t>Public decentralized log: log entries are stored on a decentralized public log (e.g., Ethereum blockchain, IPFS). Each gateway writes non-encrypted log entries to a decentralized log storage.
Although this is the best option for providing accountability of gateways, availability, and integrity of the logs, leading to shorter dispute resolution, this can lead to leak of information which can lead to privacy issues.
The integrity of the log can be asserted by hashing the entries and comparing it to each stored hash on the decentralized log storage.
A solution to the privacy problems could be given by gateways publishing a hash of the log entry plus metadata to the decentralized log storage instead of the log entries. Although this is a first step towards resolving privacy issues, a tradeoff with data availability exists.
In particular, this choice leads to lower availability guarantees since a gateway needs to wait for the counterparty gateway to deliver the logs in case logs need to be shared. In this case, the decentralized log storage acts as a notarizing service.
This mode is recommended when gateways operate in the  Relay Mode: Client-initiated Gateway to Gateway. This mode can also be used by the Direct Mode: Client to Multiple Gateway access mode because gateways may need to share state between themselves.
Note: the difference between the mentioned modes is that in Direct Mode: Client to Multiple Gateway, a single client/organization controls all the gateways, whereas, in the Relay Mode, gateways are controlled by different organizations.</t>
          </li>
          <li>
            <t>Public centralized log: log entries are published in a bulletin that more organizations control. That bulletin can be updated or removed at any time. Accountability is only guaranteed provided that there are multiple copies of such bulletin by conflicting parties.
Availability and integrity can be obtained via redundancy.</t>
          </li>
          <li>
            <t>Private centralized log. Each gateway stores logs locally or in a cloud in the private log storage mode but does not share them by default with other gateways. If needed, logs are requested from the counterparty gateway.
Saving logs locally is faster than saving them on the respective ledger since issuing a transaction is several orders of magnitude slower than writing on a disk or accessing a cloud service.
Nonetheless, this model delivers weaker integrity and availability guarantees.</t>
          </li>
          <li>
            <t>Private decentralized log. Each gateway stores logs in a private blockchain, and are shared with other gateways by default.</t>
          </li>
        </ol>
        <t>Each log storage mode provides a different process to recover the state from crashes. In the private log, a gateway requires the most recent log from the counterparty gateway. This mode is the one where the most trust is needed.
The gateway publishes hashes of log entries and metadata on a decentralized log storage in the centralized public log. Gateways who need the logs request them from other gateways and perform integrity checks of the received logs.
In the public decentralized mode, the gateways publish the plain log entries on decentralized log storage. This is the most trustless and decentralized mode of operation.</t>
        <t>By default, if there are gateways from different institutions involved in an asset transfer, the storage mode should be a decentralized log storage. The decentralized log storage can provide a common source of truth to solve disputes and maintain a shared state, alleviating trust assumptions between gateways.</t>
      </section>
      <section anchor="log-storage-api">
        <name>Log Storage API</name>
        <t>The log storage API allows developers to be abstracted from the log storage support, providing a standardized way
to interact with logs (e.g., relational vs. non-relational, local vs. on-chain). It also handles access control if needed.</t>
        <figure anchor="api-table">
          <artwork><![CDATA[
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Function                              | Parameters                       | Endpoint                                                               |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Append log entry                      | logId - log entry to be appended | POST / writeLogEntry/:logId Host: example.org Accept: application/json |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Obtains a log entry                   | id - log entry id                | GET getLogEntry/:id Host: example.org                                  |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Obtains the length of the log         | None                             | GET getLogLength Host: example.org                                     |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Obtains the difference                | log - log to be compared         |  POST /getLogDiff/:log Host: example.org                                     |
| between a given log and a current log |                                  |                                                                        |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Obtains the last log entry            | None                             | GET getLastEntry Host: example.org                                     |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+
| Obtains the whole log                 | None                             | GET getLog Host: example.org                                           |
+---------------------------------------+----------------------------------+------------------------------------------------------------------------+

]]></artwork>
        </figure>
        <t>The following table maps the respective return values and response examples:</t>
        <figure anchor="return-values-api-table">
          <artwork><![CDATA[
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| Returns                         | Response Example                                                                                                                                      |
+=================================+=======================================================================================================================================================+
| The entry index of the last log | HTTP/1.1 200 OK Cache-Control: private Date: Mon, 02 Mar 2020 05:07:35 GMT Content-Type: application/json { "success": true, "response_data":"2" }    |
| (string)                        |                                                                                                                                                       |
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| A log entry                     | HTTP/1.1 200 OK Cache-Control: private Date: Mon, 02 Mar 2020 05:07:35 GMT Content-Type: application/json { "success": true, "response_data": {...} } |
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| The length of the log           | HTTP/1.1 200 OK Cache-Control: private Date: Mon, 02 Mar 2020 05:07:35 GMT Content-Type: application/json { "success": true, "response_data":"2" }    |
| (string)                        |                                                                                                                                                       |
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| The difference between two logs | HTTP/1.1 200 OK Cache-Control: private Date: Mon, 02 Mar 2020 05:07:35 GMT Content-Type: application/json { "success": true, "response_data": {...} } |
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| A log entry                     | HTTP/1.1 200 OK Cache-Control: private Date: Mon, 02 Mar 2020 05:07:35 GMT Content-Type: application/json { "success": true, "response_data": {...} } |
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| The log                         | HTTP/1.1 200 OK Cache-Control: private Date: Mon, 02 Mar 2020 05:07:35 GMT Content-Type: application/json { "success": true, "response_data": {...} } |
+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+

]]></artwork>
        </figure>
        <section anchor="response-codes">
          <name>Response Codes</name>
          <t>The log storage API  MUST respond with return codes indicating the failure (error 5XX) or success of the operation (200). The application may carry out a further operation in the future to determine the ultimate status of the operation.</t>
          <t>The log storage API response is in JSON format and contains two fields: 1) success: true if the operation was successful, and 2) response_data: contains the payload of the response generated by the log storage API.</t>
        </section>
      </section>
    </section>
    <section anchor="format">
      <name>Format of Log Entries</name>
      <t>A gateway stores the log entries in its log, and they capture gateways operations. Entries account for the current status of one of the three SATP flows: Transfer Initiation flow, Lock-Evidence flow, and Commitment Establishment flow.</t>
      <t>The recommended format for log entries is JSON, with protocol-specific mandatory fields supporting a free format field for plaintext or encrypted payloads directed at the SATP gateway or an underlying network. Although the recommended format is JSON, other formats can be used (e.g., XML).</t>
      <t>The mandatory fields of a log entry, that SATP generates, are:</t>
      <ul spacing="normal">
        <li>
          <t>Version: SATP protocol Version (major, minor).</t>
        </li>
        <li>
          <t>Session ID: a unique identifier (UUIDv2) representing a session.</t>
        </li>
        <li>
          <t>Context ID: a unique identifier (UUIDv2) representing a session context <xref target="I-D.draft-avrilionis-satp-setup-stage-01"/>.</t>
        </li>
        <li>
          <t>Sequence Number: monotonically increasing counter that uniquely represents a message from a session.</t>
        </li>
        <li>
          <t>SATP Phase: current SATP phase.</t>
        </li>
        <li>
          <t>Resource URL: Location of Resource to be accessed.</t>
        </li>
        <li>
          <t>Developer URN: Assertion of developer/application identity.</t>
        </li>
        <li>
          <t>Action/Response: GET/POST and arguments (or Response Code).</t>
        </li>
        <li>
          <t>Credential Profile: Specify the type of auth (e.g., SAML, OAuth, X.509)</t>
        </li>
        <li>
          <t>Credential Block: Credential token, certificate, string.</t>
        </li>
        <li>
          <t>Payload Profile: Asset Profile provenance and capabilities.</t>
        </li>
        <li>
          <t>Application Profile: Vendor or Application-specific profile.</t>
        </li>
        <li>
          <t>Payload: Payload for POST, responses, and native network transactions. The payload is specific to the current SATP phase.</t>
        </li>
        <li>
          <t>Payload Hash: hash of the current message payload.</t>
        </li>
      </ul>
      <t>In addition to the attributes that belong to SATP s schema, each log entry REQUIRES the following attributes:</t>
      <ul spacing="normal">
        <li>
          <t>timestamp REQUIRED: timestamp referring to when the log entry was generated (UNIX format).</t>
        </li>
        <li>
          <t>origin_gateway_pubkey REQUIRED: the public key of the gateway initiating a transfer.</t>
        </li>
        <li>
          <t>origin_gateway_system REQUIRED: the ID  of the source network.</t>
        </li>
        <li>
          <t>destination_gateway_pubkey REQUIRED: the public key of the gateway involved in a transfer.</t>
        </li>
        <li>
          <t>destination_gateway_system REQUIRED: the ID of the destination Gateway involved in a transfer.</t>
        </li>
        <li>
          <t>logging_profile REQUIRED: contains the profile regarding the logging procedure. Default is a local store.</t>
        </li>
        <li>
          <t>Message_signature REQUIRED: Gateway ECDSA signature over the log entry.</t>
        </li>
        <li>
          <t>Last_entry_hash REQUIRED: Hash of previous log entry.</t>
        </li>
        <li>
          <t>Access_control_profile REQUIRED: the profile regarding the confidentiality of the log entries being stored. Default is only the gateway that created the logs that can access them.</t>
        </li>
        <li>
          <t>Operation: the high-level operation being executed by the gateway on that step.
There are five types of operations: Operation init- states the intention of a node to execute a particular operation; Operation exec- expresses that the node is executing the operation; Operation done- states when a node successfully executes a step of the protocol;
Operation ack- refers to when a node acknowledges a message received from another (e.g., the command executed); Operation fail- occurs when an agent fails to execute a specific step.</t>
        </li>
      </ul>
      <t>Optional field entries are:</t>
      <ul spacing="normal">
        <li>
          <t>recovery message: the type of recovery message, if the gateway is involved in a recovery procedure.</t>
        </li>
        <li>
          <t>recovery payload: the payload associated with the recovery message.</t>
        </li>
      </ul>
      <t>Example of a log entry created by G1, corresponding to locking an asset (phase 2.3 of the SATP protocol):</t>
      <figure anchor="example-log-entry">
        <artwork><![CDATA[
{
  "Version": "1.0",
  "Session ID": "123e4567-e89b-12d3-a456-426655440000",
  "Sequence Number": 1,
  "SATP Phase": "Initialization",
  "Resource URL": "http://myresource.com",
  "Developer URN": "urn:myapp:developerid",
  "Action/Response": "POST /myresource",
  "Credential Profile": "OAuth",
  "Credential Block": "ABC123TOKEN",
  "Payload Profile": "ProvenanceProfile1",
  "Application Profile": "AppProfile1",
  "Payload": "{ 'key1': 'value1', 'key2': 'value2' }",
  "Payload Hash": "abc123def456",
  "timestamp": 1646176142,
  "origin_gateway_pubkey": "abc123",
  "origin_gateway_system": "system1",
  "destination_gateway_pubkey": "def456",
  "destination_gateway_system": "system2",
  "logging_profile": "Local Store",
  "Message_signature": "ecdsa_signature_here",
  "Last_entry_hash": "hash_of_last_entry",
  "Access_control_profile": "GatewayOnly",
  "Operation": "init",
  "recovery message": "recovery_message_here",
  "recovery payload": "recovery_payload_here"
}
]]></artwork>
      </figure>
      <t>Example of a log entry created by G2, acknowledging G1 locking an asset (phase 2.4 of the SATP protocol) :</t>
      <figure anchor="example-log-entry-two">
        <artwork><![CDATA[
{
    "sessionId": "4eb424c8-aead-4e9e-a321-a160ac3909ac",
    "contextId": "5eb424c8-aead-4e9e-a321-a160ac3909ac",
    "seqNumber": 7,
    "phaseId": "lock",
    "originGatewayId": "5.47.165.186",
    "originNetworkId": "Hyperledger-Fabric-JusticeChain",
    "destinationGatewayId": "192.47.113.116",
    "destinationNetworkId": "Ethereum",
    "timestamp": "1606157333",
    "payload": {
    "messageType": "2pc-log",
    "message": "LOCK_ASSET_ACK",
    "votes": "none"
}
]]></artwork>
      </figure>
    </section>
    <section anchor="procedure">
      <name>Crash Recovery Procedure</name>
      <t>This section defines general considerations about crash recovery for the self-healing mode. Note that the procedure for the primary-backup mode is the same, but first has a session resumption process.</t>
      <section anchor="crm">
        <name>Crash Recovery Model</name>
        <t>Gateways can fail by crashing (i.e., becoming silent). In order to be able to recover from these crashes, gateways store log entries in a persistent data storage. Thus, gateways can recover by obtaining the latest successful operation and continuing from there. We consider two recovery models:</t>
        <ol spacing="normal" type="1"><li>
            <t>Self-healing mode: assumes that after a crash, a gateway eventually recovers. The gateway does not lose its long-term keys (public-private key pair) and can reestablish all TLS connections.</t>
          </li>
          <li>
            <t>Primary-backup mode assumes that a gateway may never recover after a crash but that this failure can be detected by timeout <xref target="AD76"/>. If the timeout is exceeded, a backup gateway detects that failure unequivocally and takes the role of the primary gateway. The failure is detected using heartbeat messages and a conservative period.</t>
          </li>
        </ol>
        <t>In both modes, after a gateway recovers, the gateways follow a general recovery procedure (in Section 6.2 explained in detail for each phase):</t>
        <ol spacing="normal" type="1"><li>
            <t>Crash communication: using the self-healing or primary-backup modes, a node recovers. After that, it sends a message RECOVER to the counterparty gateways.</t>
          </li>
          <li>
            <t>State update: The gateway syncs its state with the latest state, either by requesting it from the decentralized log storage or other gateways (depending on the log storage mode).
If a decentralized log storage is available, the crashed gateway attempts to update its local log, using getLogDiff from the shared log.
If there is no shared log, the crashed gateway needs to synchronize itself with the counterparty gateway by querying the counterparty gateway with a recovery message RECOVER containing the latest log before the crash.
The counterparty gateway sends back a RECOVER-UPDATE message with its log. The recovered gateway can now reconstruct the updated log via getLogDiff, and derive the current state of the asset transfer.
The gateways now share the same state and can proceed with its operation.</t>
          </li>
          <li>
            <t>Recovery communication: The gateway and informs other gateways of the recovery with a recovery confirmation message is sent (RECOVERY-UPDATE-ACK), and the respective acknowledgment is sent by the counterparty gateway (RECOVERY-SUCCESS).</t>
          </li>
        </ol>
        <t>Finally, the gateway resumes the normal execution of SATP (session resumption).</t>
      </section>
      <section anchor="rp">
        <name>Recovery Procedure</name>
        <t>The previous section explained the general procedure that gateways follow upon crashing. In more detail, for each SATP phase, we define the recovery procedure:</t>
        <section anchor="transfer-initiation-flow">
          <name>Transfer Initiation Flow</name>
          <t>This phase of SATP follows the Crash Recovery Model from Section 6.1.</t>
        </section>
        <section anchor="lock-evidence-flow">
          <name>Lock-Evidence Flow</name>
          <t>This phase of SATP follows the Crash Recovery Model from Section 6.1.
Note that, in this phase, distributed ledgers were changed by gateways. The crash gateways' recovery should take place in less than the timeout specified for the asset transfer. Otherwise, the rollback protocol present in the next section is applied.</t>
        </section>
        <section anchor="commitment-establishment-flow">
          <name>Commitment Establishment  Flow</name>
          <t>As transactions cannot be undone on blockchains, reverting a transaction includes issuing new transactions (with the contrary effect of the ones to be reverted). We use a rollback list to keep track of which transaction may be rolled back.
The crash recovery protocol for the Stage 2 (lock) and Stage 3 (mint) is as follows:</t>
          <ol spacing="normal" type="1"><li>
              <t>Rollback lists for all the gateways involved are initialized.</t>
            </li>
            <li>
              <t>On step 2.1A, add a pre-lock transaction to the origin gateway rollback list.</t>
            </li>
            <li>
              <t>On step 2.1B, if the request is denied, abort the transaction and apply rollbacks on the origin gateway.</t>
            </li>
            <li>
              <t>On step 3.4A, add a lock transaction to the origin gateway rollback list.</t>
            </li>
            <li>
              <t>On step 3.4B, if the commit fails, abort the transaction and apply rollbacks on the origin gateway.</t>
            </li>
            <li>
              <t>On step 3.6A,  add a create asset transaction to the rollback list of the destination gateway.</t>
            </li>
            <li>
              <t>On step 3.8, if the commit is successful (confirmed by the ack final receipt), SATP terminates (3.9).</t>
            </li>
          </ol>
          <t>8: Otherwise, if the last commit is unsuccessful, then abort the transaction and apply rollbacks to both gateways.</t>
        </section>
      </section>
      <section anchor="recovery-messages">
        <name>Recovery Messages</name>
        <t>SATP-2PC messages are used to recover from crashes at the several SATP phases.
These messages inform gateways of the current state of a recovery procedure.
SATP-2PC messages follow the log format from Section 4.</t>
        <section anchor="recover">
          <name>RECOVER</name>
          <t>A recover message is sent from the crashed gateway to the counterparty gateway, sending its most recent state.
This message type is encoded on the recovery message field of an SATP log.</t>
          <t>The parameters of the recovery message payload consist of the following:</t>
          <ul spacing="normal">
            <li>
              <t>Session ID: a unique identifier (UUIDv2) representing a session.</t>
            </li>
            <li>
              <t>Context ID: a unique identifier (UUIDv2) representing a session context <xref target="I-D.draft-avrilionis-satp-setup-stage-01"/>.</t>
            </li>
            <li>
              <t>Message Type REQUIRED: urn:ietf:SATP-2pc:msgtype:recover-msg.</t>
            </li>
            <li>
              <t>SATP phase: latest SATP phase registered.</t>
            </li>
            <li>
              <t>Sequence number: latest sequence number registered.</t>
            </li>
            <li>
              <t>Is_Backup REQUIRED: indicates whether the sender is a backup gateway or not.</t>
            </li>
            <li>
              <t>New Identity Public Key: The public key of the sender if it is a backup gateway.</t>
            </li>
            <li>
              <t>Last_entry_timestamp REQUIRED: Timestamp of last known log entry.</t>
            </li>
            <li>
              <t>Sender Signature REQUIRED. The digital signature of the sender.</t>
            </li>
          </ul>
        </section>
        <section anchor="recover-udpdate">
          <name>RECOVER-UDPDATE</name>
          <t>The counterparty gateway sends the recover update message after receiving a RECOVER message from a recovered gateway. The recovered gateway informs of its current state (via the current state of the log).
The counterparty gateway now calculates the difference between the log entry corresponding to the received sequence number from the recovered gateway and
the latest sequence number (corresponding to the latest log entry).
This state is sent to the recovered gateway.</t>
          <t>The parameters of the recover update payload consist of the following:</t>
          <ul spacing="normal">
            <li>
              <t>Session ID: a unique identifier (UUIDv2) representing a session.</t>
            </li>
            <li>
              <t>Context ID: a unique identifier (UUIDv2) representing a session context <xref target="I-D.draft-avrilionis-satp-setup-stage-01"/>.</t>
            </li>
            <li>
              <t>Message Type REQUIRED: urn:ietf:SATP-2pc:msgtype:recover-update-msg.</t>
            </li>
            <li>
              <t>Hash Recover Message REQUIRED. The hash of previous message.</t>
            </li>
            <li>
              <t>Recovered logs: the list of log messages that the recovered gateway needs to update.</t>
            </li>
            <li>
              <t>Sender Signature REQUIRED. The digital signature of the sender.</t>
            </li>
          </ul>
        </section>
        <section anchor="recover-success">
          <name>RECOVER-SUCCESS</name>
          <t>The recover-success message (response to RECOVER-UPDATE) states if the recovered gateway's logs have been successfully updated. If inconsistencies are detected, the recovered gateway answers with initiates a dispute (RECOVER-DISPUTE message).</t>
          <t>The counterparty gateway sends this message to sinalize the recovered gateway acknowledging that the state is synchronized.</t>
          <t>The parameters of this message consist of the following:</t>
          <ul spacing="normal">
            <li>
              <t>Session ID: a unique identifier (UUIDv2) representing a session.</t>
            </li>
            <li>
              <t>Context ID: a unique identifier (UUIDv2) representing a session context <xref target="I-D.draft-avrilionis-satp-setup-stage-01"/>.</t>
            </li>
            <li>
              <t>Message Type REQUIRED: urn:ietf:SATP-2pc:msgtype:recover-update-ack-msg.</t>
            </li>
            <li>
              <t>Hash Recover Update Message REQUIRED. The hash of previous message.</t>
            </li>
            <li>
              <t>success: true/false.</t>
            </li>
            <li>
              <t>entries changed: list of hashes of log entries that were appended to the recovered gateway log.</t>
            </li>
            <li>
              <t>Sender Signature REQUIRED. The digital signature of the sender.</t>
            </li>
          </ul>
        </section>
        <section anchor="rollback">
          <name>ROLLBACK</name>
          <t>A rollback message is sent by a gateway that initiates a rollback. The parameters of this message consist of the following:</t>
          <ul spacing="normal">
            <li>
              <t>Session ID: a unique identifier (UUIDv2) representing a session.</t>
            </li>
            <li>
              <t>Context ID: a unique identifier (UUIDv2) representing a session context <xref target="I-D.draft-avrilionis-satp-setup-stage-01"/>.</t>
            </li>
            <li>
              <t>Message Type REQUIRED: urn:ietf:SATP-2pc:msgtype:rollback-msg.</t>
            </li>
            <li>
              <t>success: true/false.</t>
            </li>
            <li>
              <t>actions performed: actions performed to rollback a state (e.g., UNLOCK; BURN).</t>
            </li>
            <li>
              <t>proofs: a list of proofs specific to the network</t>
            </li>
            <li>
              <t>Sender Signature REQUIRED. The digital signature of the sender.</t>
            </li>
          </ul>
        </section>
        <section anchor="rollback-ack">
          <name>ROLLBACK-ACK</name>
          <t>The counterparty gateway sends the rollback-ack message to the recovered gateway acknowledging that the rollback has been performed successfully.</t>
          <t>The parameters of this message consist of the following:</t>
          <ul spacing="normal">
            <li>
              <t>Session ID: a unique identifier (UUIDv2) representing a session.</t>
            </li>
            <li>
              <t>Context ID: a unique identifier (UUIDv2) representing a session context <xref target="I-D.draft-avrilionis-satp-setup-stage-01"/>.</t>
            </li>
            <li>
              <t>Message Type REQUIRED: urn:ietf:SATP-2pc:msgtype:rollback-ack-msg.</t>
            </li>
            <li>
              <t>success: true/false.</t>
            </li>
            <li>
              <t>actions performed: actions performed to rollback a state (e.g., UNLOCK; BURN).</t>
            </li>
            <li>
              <t>proofs: a list of proofs specific to the network</t>
            </li>
            <li>
              <t>Sender Signature REQUIRED. The digital signature of the sender.</t>
            </li>
          </ul>
        </section>
      </section>
      <section anchor="examples">
        <name>Examples</name>
        <t>There are several situations when a crash may occur.</t>
        <section anchor="crashing-before-issuing-a-command-to-the-counterparty-gateway">
          <name>Crashing before issuing a command to the counterparty gateway</name>
          <t>The following figure represents the origin gateway (G1) crashing before it issued an init command to the destination gateway (G2).</t>
          <artwork><![CDATA[
   ,--.                           ,--.              ,-------.
     |G1|                           |G2|              |Log API|
     `--'                           `--'              `-------'
       |     [1]: writeLogEntry <1, 1, init-validate>     |
       |------------------------------------------------->|
       |                              |                   |
       |----.                         |                   |
       |    | [2]  Crash              |                   |
       |<---'  ...                    |                   |
       |      [3]recover              |                   |
       |                              |                   |
       |                              |                   |
       |      [4] <1, 2, RECOVER>     |                   |
       |----------------------------->|                   |
       |                              |                   |
       |                              | [5] getLogEntry(i)|
       |                              |------------------>|
       |                              |                   |
       |                              |   [6] logEntries  |
       |                              |< - - - - - - - - -|
       |                              |                   |
       |   [7] <1,3,RECOVER-UPDATE>   |                   |
       |<-----------------------------|                   |
       |                              |                   |
       |----.                         |                   |
       |    | [8] process log         |                   |
       |<---'                         |                   |
       |                              |                   |
       |              [9] <1,4,writeLogEntry>             |
       |------------------------------------------------->|
       |                              |                   |
       | [10] <1,5,RECOVER-UPDATE-ACK>|                   |
       |----------------------------->|                   |
       |                              |                   |
       |   [11] <1,6,RECOVER-SUCESS>  |                   |
       |<-----------------------------|                   |
       |                              |                   |
       |           [12]: <1,7,init-validateNext>          |
       |------------------------------------------------->|
     ,--.                           ,--.             ,-------.
     |G1|                           |G2|             |Log API|
     `--'                           `--'             `-------'

]]></artwork>
        </section>
        <section anchor="crashing-after-issuing-a-command-to-the-counterparty-gateway">
          <name>Crashing after issuing a command to the counterparty gateway</name>
          <t>The second scenario requires further synchronization (figure below). At the retrieval of the latest log entry, G1 notices its log is outdated. It updates it upon necessary validation and then communicates its recovery to G2. The process then continues as defined.</t>
          <artwork><![CDATA[
     ,--.                          ,--.                             ,-------.
     |G1|                          |G2|                             |Log API|
     `--'                          `--'                             `-------'
       |            [1]: writeLogEntry <1,1,init-validate>              |
       |--------------------------------------------------------------->|
       |                             |                                  |
       |   [2]: <1,1,init-validate>  |                                  |
       |---------------------------->|                                  |
       |                             |                                  |
       |----.                        |                                  |
       |    | [3] Crash              |                                  |
       |<---'                        |                                  |
       |                             |                                  |
       |                             |[4]: writeLogEntry <exec-validate>|
       |                             |--------------------------------->|
       |                             |                                  |
       |                             |----.                             |
       |                             |    | [5]: execute validate       |
       |                             |<---'                             |
       |                             |                                  |
       |                             |[6]: writeLogEntry <done-validate>|
       |                             |--------------------------------->|
       |                             |                                  |
       |                             |[7]: writeLogEntry <ack-validate> |
       |                             |--------------------------------->|
       |                             |                                  |
       | [8] <1,2,init-validate-ack> |                                  |
       |  discovers that G1 crashed  |                                  |
       |  via timeout                |                                  |
       |<----------------------------|                                  |
       |                             |                                  |
       |----.                        |                                  |
       |    | [9] Recover            |                                  |
       |<---'                        |                                  |
       |                             |                                  |
       |     [10] <1, 2, RECOVER>    |                                  |
       |----------------------------->                                  |
       |                             |                                  |
       |                             |        [11] getLogEntry(i)       |
       |                             |--------------------------------->|
       |                             |                                  |
       |                             |          [12] logEntries         |
       |                             |<- - - - - - - - - - - - - - - - -|
       |                             |                                  |
       |   [13] <1,3,RECOVER-UPDATE> |                                  |
       |<----------------------------|                                  |
       |                             |                                  |
       |----.                        |                                  |
       |    | [14] process log       |                                  |
       |<---'                        |                                  |
       |                             |                                  |
       |                     [15] <1,4,writeLogEntry>                    |
       |--------------------------------------------------------------->|
       |                             |                                  |
       |[16] <1,5,RECOVER-UPDATE-ACK>|                                  |
       |---------------------------->|                                  |
       |                             |                                  |
       |  [17] <1,6,RECOVER-SUCESS>  |                                  |
       |<----------------------------|                                  |
       |                             |                                  |
       |                  [18]: <1,7,init-validateNext>                 |
       |--------------------------------------------------------------->|
     ,--.                           ,--.                             ,-------.
     |G1|                           |G2|                             |Log API|
     `--'                           `--'                             `-------'

]]></artwork>
        </section>
        <section anchor="rollback-after-counterparty-gateway-crash">
          <name>Rollback after counterparty gateway crash</name>
          <t>At the retrieval of the latest log entry, G1 notices its log is outdated. It updates it upon necessary validation and then communicates its recovery to G2. The process then continues as defined.</t>
          <artwork><![CDATA[
    ,--.                            ,--.                            ,-------.
     |G1|                            |G2|                            |Log API|
     `--'                            `--'                            `-------'
       |              ...              |                                  |
       |                               |                                  |
       |  [1] <3, 1, COMMIT-PREPARE>   |                                  |
       |------------------------------>|                                  |
       |                               |                ...               |
       |----.                          |                                  |
       |    | [2]  Crash               |                                  |
       |<---'                          |                                  |
       |                               |                                  |
       |[3] <3, 2, COMMIT-PREPARE-ACK> |                                  |
       |  discovers that G1 crashed    |                                  |
       |  via timeout                  |                                  |
       |<------------------------------|                                  |
       |                          .----|                                  |
       |             [4]  Timeout |    |                                  |
       |                          '--->|                                  |
       |                               |                                  |
       |                               |[5]: writeLogEntry <exec-rollback>|
       |                               |--------------------------------->|
       |                               |                                  |
       |                               |----.                             |
       |                               |    | [6]: execute rollback       |
       |                               |<---'                             |
       |                               |                                  |
       |                               |[7]: writeLogEntry <done-rollback>|
       |                               |--------------------------------->|
       |                               |                                  |
       |                               |[8]: writeLogEntry <ack-rollback> |
       |                               |--------------------------------->|
       |                               |                                  |
       |                               |                                  |
       |----.                          |                                  |
       |    | [9] Recover              |                                  |
       |<---'                          |                                  |
       |      [10] <3, 3, RECOVER>     |                                  |
       |------------------------------>|                                  |
       |                               |                                  |
       |                               | [11] getLogEntry(i)              |
       |                               |--------------------------------->|
       |                               |                                  |
       |                               |   [12] logEntries                |
       |                               |<- - - - - - - - - - - - - - - - -|
       |                               |                                  |
       |   [13] <3, 4, RECOVER-UPDATE> |                                  |
       |<------------------------------|                                  |
       |                               |                                  |
       |----.                          |                                  |
       |    | [14] process log         |                                  |
       |<---'                          |                                  |
       |                               |                                  |
       |                  [15] <3, 5, writeLogEntry>                      |
       |----------------------------------------------------------------->|
       |                               |                                  |
       |[16] <3, 6, RECOVER-UPDATE-ACK>|                                  |
       |------------------------------>|                                  |
       |                               |                                  |
       |   [17] <3, 7, RECOVER-SUCESS> |                                  |
       |<------------------------------|                                  |
       |                               |                                  |
       |   [18] G1 discovers G2 made   |                                  |
       |        the rollback           |                                  |
       |                               |                                  |
       |----.                          |                                  |
       |    | [19]  Rollback           |                                  |
       |<---'                          |                                  |
       |                               |                                  |
       |  [20] <3, 8, ROLLBACK-ACK>    |                                  |
       |------------------------------>|                                  |
       |                               |                                  |
     ,--.                             ,--.                             ,-------.
     |G1|                             |G2|                             |Log API|
     `--'                             `--'                             `-------'

]]></artwork>
        </section>
      </section>
    </section>
    <section anchor="session-resumption">
      <name>Session Resumption</name>
      <t>This section explains how the primary-backup mode works for crash recovery. First, there is a session resumption phase. After that, the gateways perform the protocol specified in Section 5.</t>
      <section anchor="gateway-replacement">
        <name>Gateway Replacement</name>
        <t>The gateway replacemenet protocol introduces an assumption. We assume every gateway has a valid X.509 certificate that was issued by its owner, which is the entity legally responsible for the gateway.
Moreover, in the extensions field of the certificate, there is a list containing the hash of the authorized backup gateways.
When the primary gateway crashes, a replacement is bootstrapped with the latest version of the local state, and it engages in a protocol with the counterparty gateway.
This protocol aims to establish trust between gateways and the creation of a new TLS session:</t>
        <ol spacing="normal" type="1"><li>
            <t>Validate the backup gateway certificate by running a certification path algorithm, which includes validating all the intermediate certificates up to a trusted root (can be the VASPs CA).</t>
          </li>
          <li>
            <t>The counterparty gateway verifies if the parent certificate of the crashed gateway and the backup gateway is the same (proving they belong to the same authority).</t>
          </li>
          <li>
            <t>Verify if the backup gateway certificate hash belongs to the list specified in the crashed gateway certificate extensions.</t>
          </li>
        </ol>
        <t>The backup gateway, on its turn, defines gateways to replace it in case of a crash (X.509 certificate extensions).</t>
      </section>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>We assume a trusted, authenticated, secure, reliable communication channel between gateways (i.e., messages cannot be spoofed and/or altered by an adversary) using TLS/HTTPS <xref target="TLS"/>. Clients support acceptable credential schemes such as OAuth2.0.
We assume the storage service used provides the means necessary to assure the logs' confidentiality and integrity, stored and in transit. The service must provide an authentication and authorization scheme, e.g., based on OAuth and OIDC <xref target="OIDC"/>, and use secure channels based on TLS/HTTPS.
The present protocol is crash fault-tolerant, meaning that it handles gateways that crash for several reasons (e.g., power outage). The present protocol does not support Byzantine faults, where gateways can behave arbitrarily (including being malicious). This implies that both gateways are considered trusted. We assume logs are not tampered with or lost.</t>
      <t>Log entries need integrity, availability, and confidentiality guarantees, as they are an attractive point of attack. Every log entry contains a hash of its payload for guaranteeing integrity.  If extra guarantees are needed (e.g., non-repudiation),  a log entry might be signed by its creator. Availability is guaranteed by the usage of the log storage API that connects a gateway to a dependable storage (local, external, or decentralized). Each underlying storage provides different guarantees. Access control can be enforced via the access control profile that each log can have associated with, i.e., the profile can be resolved, indicating who can access the log entry in which condition. Access control profiles can be implemented with access control lists for simple authorization. The authentication of the entities accessing the logs is done at the Log Storage API level (e.g., username+password authentication in local storage vs. decentralized access control).</t>
      <t>For extra guarantees, the nodes running the log storage API (or the gateway nodes themselves) can be protected by hardening technologies such as Intel SGX.</t>
    </section>
    <section anchor="performance-considerations">
      <name>Performance Considerations</name>
      <t>After the session setup using asymmetric-cryptography, the authenticated messages in the TLS Record Protocol utilize symmetric-key operations (using the session key). Since symmetric-key
operations are much faster than public-key operations, a persistent TLS connection delivers performance suitable for quickly exchange of log entries across gateways. Upon a crash, gateways might employ their best effort for resuming the crashed session.</t>
    </section>
    <section anchor="assumptions">
      <name>Assumptions</name>
      <t>For the protocol to work correctly, a few assumptions are taken: i) the crashed gateways eventually recover, at most for a fixed time (or are replaced); ii) The Log API is reliable - all requests are served up to a pre-defined time bound.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="TLS">
          <front>
            <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
            <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
            <date month="August" year="2018"/>
            <abstract>
              <t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t>
              <t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8446"/>
          <seriesInfo name="DOI" value="10.17487/RFC8446"/>
        </reference>
        <reference anchor="HTTP2">
          <front>
            <title>HTTP/2</title>
            <author fullname="M. Thomson" initials="M." role="editor" surname="Thomson"/>
            <author fullname="C. Benfield" initials="C." role="editor" surname="Benfield"/>
            <date month="June" year="2022"/>
            <abstract>
              <t>This specification describes an optimized expression of the semantics of the Hypertext Transfer Protocol (HTTP), referred to as HTTP version 2 (HTTP/2). HTTP/2 enables a more efficient use of network resources and a reduced latency by introducing field compression and allowing multiple concurrent exchanges on the same connection.</t>
              <t>This document obsoletes RFCs 7540 and 8740.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9113"/>
          <seriesInfo name="DOI" value="10.17487/RFC9113"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="OIDC" target="http://openid.net/specs/openid-connect-core-1_0.html">
          <front>
            <title>OpenID Connect Core 1.0</title>
            <author initials="N." surname="Sakimura">
              <organization/>
            </author>
            <author initials="J." surname="Bradley">
              <organization/>
            </author>
            <author initials="M." surname="Jones">
              <organization/>
            </author>
            <author initials="B." surname="de Medeiros">
              <organization/>
            </author>
            <author initials="C." surname="Mortimore">
              <organization/>
            </author>
            <date year="2014" month="November"/>
          </front>
        </reference>
        <reference anchor="AD76" target="http://openid.net/specs/openid-connect-core-1_0.html">
          <front>
            <title>A principle for resilient sharing of distributed resources</title>
            <author initials="P." surname="Alsberg">
              <organization/>
            </author>
            <author initials="D." surname="Day">
              <organization/>
            </author>
            <date year="1976"/>
          </front>
        </reference>
        <reference anchor="I-D.draft-ietf-satp-core">
          <front>
            <title>Secure Asset Transfer Protocol (SATP) Core</title>
            <author fullname="Martin Hargreaves" initials="M." surname="Hargreaves">
              <organization>Quant Network</organization>
            </author>
            <author fullname="Thomas Hardjono" initials="T." surname="Hardjono">
              <organization>MIT</organization>
            </author>
            <author fullname="Rafael Belchior" initials="R." surname="Belchior">
         </author>
            <author fullname="Venkatraman Ramakrishna" initials="V." surname="Ramakrishna">
              <organization>IBM</organization>
            </author>
            <date day="10" month="January" year="2025"/>
            <abstract>
              <t>   This memo describes the Secure Asset Transfer (SAT) Protocol for
   digital assets.  SAT is a protocol operating between two gateways
   that conducts the transfer of a digital asset from one gateway to
   another, each representing their corresponding digital asset
   networks.  The protocol establishes a secure channel between the
   endpoints and implements a 2-phase commit (2PC) to ensure the
   properties of transfer atomicity, consistency, isolation and
   durability.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-satp-core-08"/>
        </reference>
        <reference anchor="I-D.draft-avrilionis-satp-setup-stage-01">
          <front>
            <title>SATP Setup Stage</title>
            <author fullname="Denis Avrilionis" initials="D." surname="Avrilionis">
              <organization>Compellio S.A.</organization>
            </author>
            <author fullname="Thomas Hardjono" initials="T." surname="Hardjono">
              <organization>MIT</organization>
            </author>
            <date day="16" month="December" year="2024"/>
            <abstract>
              <t>   SATP Core defines an unidirectional transfer of assets in three
   stages, namely the Transfer Initiation stage (Stage-1), the Lock-
   Assertion stage (Stage-2) and the Commitment Establishment stage
   (Stage-3).  This document defines the Setup Phase, often called
   "Stage-0", prior to the execution of SATP Core.  During Setup, the
   two Gateways that would participate in the asset transfer are bound
   together via a "transfer context".  The transfer context conveys
   information regarding the assets to be exchanged.  Gateway can
   perform any kind of negotiation based on that transfer context,
   before entering into SATP Core.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-avrilionis-satp-setup-stage-01"/>
        </reference>
      </references>
    </references>
  </back>
  <!-- ##markdown-source:
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
E7kMWhwAzeoiYz8RSgCjNDJCueeh3CtBqUqibg2QZjHEA914kcAZ0174fCqY
e63y2Ajmvgdzv4LMUG5dhku0lUr7NLvA2266mQH0AiV5WxMp3uHwmwMOkIXA
INy/wEEvW+BRx/C9D32NdyAtuRABRqjcXfC1L5viE7lTM+5Wq0GqNrGH1bdX
OHBIX4S3Iu72QQiys++ZDA1FbbRh5aT949F3AOdNZ7HsMP+HwqpGhbjkVd3P
itgTs8eq+POvNhCAdSLQ/lQl3iWv6n6qKj8Ntn66m+5G0jrslP/pyiU+Elk0
jz+10/VK1idCuqbZTXXaqxh0eq1ep9eWs1SVdC/pdDNt5cqfh/+B6e+ppziv
Qzsv1YQp73xap+sn9CmQrm32eTrdr6UFOZRVaGHjTr+21V/bDAHYRLRu1Sn/
c9epGIhF5bAo+ti2nW54oNse0o1/Nu70oJak5KD3J0ldp1P+557TlKo0RRfU
82K7Tv9AJKXuozEVpxolO3I1uw4F3x5JqQe1HMX2hep+/Uedfnd3zYp+Sqfr
rBEb2yNKnf6pqpcsF+Qc680XIRl+pBNVeLeHt8fG3R7LPSQZPMxH58ps6IJS
y4WI9VwZRvNiIZ4j7Nfomk+jc7rUO5dLUkOeYnzq1Bi3BO+MbmPAEl37sdcC
dSzXfejw1SKXQXR6Qd9m/isCSbMs4iFeVsud3pCMIsNkMdLQ+ahdZG08/5IX
cvsfCxhpFPPtDV1XRfw73t9aL+pimmeLyXS+QIeSQzLVuEsjDy7fEUeCBets
CbDO2TMmy+2UW2qIZ2W554XnIx08CLw1yclPXKoHmsIQ4AO6MkVfmiVeZNFf
NEWO97KOK6Qt89A75DWKbjPishJ4MpIfAIaFLGbkbnhOx3V2QRX4aXFHyOYR
GjcI5+j7lGSLkfWea+EtveuzGUxnp+W+KE0TvWDyiB2W8DRune1LbdgTv/oU
qQGvNAFOdGRA0wDfpBZ4tc8bTrUjf4vOHtPo4Bg4J8iKsWuvsV7EFLVHIQiz
ucTpkR++82CyXtR0MiUDEDtGNxqNk1RNyD8Bl7fA4CAy24mb1Ap0/dI9NDk5
MtqzVcwJQeEHTd2ZANaO8VJcwxKSr8twGsVpS528fHy6I/erdmXEWIRuMUDe
+XJeCHLsyOS5tx53jcMEzTiTKfvdioPaAP05BO9jovPsPCZurrgWB/6+rZLz
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
EXpp+JXPDg85IMR7ZSGOds6H2+JpFBsOv2BrNGgk1pFp257Io0H8Xj9ldpfq
29/K3gInvVerZqZvY2+x58OqPerGNIz2w0s7qYNpbbOb74kOmmUD1pY9fY0y
0/+Kh9GSqWvLnr5fsXdd0/61te7b3VtjDvtTPlXlU3e/zoz2bcin6s+b7t2r
7W4rXV3JpF+Ahd90D7azzF1rdl/qgIcrdW8bG97anr5GFl5996Z7fxOr30pP
N0SZW1+drjagn+vepFYbfOLF6moD+glNhy6mh02HtZ4fpB03vhUTn6zTpQu5
wfst1vnKhd5unTd5L+ts+y+/X7kqvjn2v4Z4A+m2R7f6Ry+ePTs5a798dfzy
8NXaC7u1fV3F4dvBdXnD6oPVy/dN7/eupams8RO4QV3lC9IE2iCRInpViqAd
/QbP+jd52r/JzfjGtuPOp/WFLhYU2ILz/XDFWNvAdfuz8+On9EX2zTprsHWD
2/hO+QZPtTc8xytk0lZ98T9kPbVWYecwuG1fN2YXvmmaqLGekm34G6KJN/fr
LcRuilvS19c4x236uoJHbs4C+sX3bTZewpa7t4Ez3dq+rlrw7eFa3/BG+1pv
vNy6r6+Y7teZMLfu68ZsmdvPka2ZQKX7LfX57Jk3aQ758jKn3qr5xWXO5+qL
DZtAIndb6mrT5ubya4Ofz8TbbOCEGR1Uif5mTZxfWEaznROmea+lqpbOb4K3
FVs38QjqD6VPemoWjfQ1+qKfUiDV9eG6tOE2fX0O+QVKk7dSXrOvr1d+vemJ
7nW/VQrEu+Hb4y/F25tYzG/SpK5u2qh+HbO6Czp85TLllTMfSwI8o6aSlKcu
NzHGx3GSrXIyr456jEmKWz5ZZX2qYqqoU8ovWkrUJRF+MrykB/O524IsqXc5
xs6WLHmlKQEcZlhrhDkSc/dcF77HGFOnjxZDyvfKCXEJPkp6xvlxMYevTyQr
yZfpGoDLKYVlkiQiOzI2Sm6w5JyOF6nOW5IgTbI6SwKYRE8kPTDlPIgxn7JN
g+aSbTzLco3Ybdmcc/r3QqeGwgZdkiFyoQ5LNgUrQPGOlZycYfEirBiV5ZTg
tJxdxnQav9gSQZWcuj7BcxRgl3LUDLKsMEWOUemjlYSu51LdzGVW4bo0BDJl
siwANxNJNEUZ2GSxLk1bKulLXOMonnG5DpcbucgXpnC5WByl2WyWlHLMl1DR
F5RIWUiXM8z9bN0JsX0lwU9IBZikdpGm4uTuXhDdR5h/M5kAsovpzJGETd1n
r5fwS8ldh7VdMNQVA+fDUYyC0WGCEU8MEJ0D1lVTEjHjpz8fnr406uhwh9Pb
rY2dhhVBtnJZNeAtLmQ4JUtf1fy2grwKMoLE5aqJ9cCE5pZBoSvXQGivwBQ0
mDPvZ4RmaWG5BM1EwNyhcWltkNBLcqIO7LAXz0qYTu1sZcgWpvdCJsb6nS2f
Ft7SD+VTk6STlBNyKBkzbShvc1VM+DEpRynKsgViAGO5gyTzDS+E3Cq3CF8o
PLCnESYug281poVMYsrGXkoUS6kkUp2s0r1keHdpYXzeSRBE2ZhCfEd3KIki
5cKifA5YyQz5F8TAjqQuBi65gzVqT9X79/A7pvk+SmKKKpZaj1Q/aV4wcL56
CZU405R/b4r3oFTjpNfZ7QTT5owmnG0Z83DHQ8liR0Q1klRLMx2BIPSXtMgV
8L0k3cV8MLdX6kVxztxCTxDvLakSJU85EV9cMMvYcWcoPmRcwoRfB5ewT8Qo
P+EJthSHow8iw6niaJ7U/MXJoyPAGv7n40cWfphok1fUrpzxXzpUd2zmWkq0
4XczIyRHla7aRZYAJaVFixDk0hvEWEEgHSUlIuYCWPQtVp6V6HSsxkiJQ3kK
8+wCy8kuCkpoo2phcAnt7eL/sPxXhLfdmqEyKPN0WA6VBRYl7InyQYx5SWPY
EJssFDn4nPLuw8INMZUKDY3lkGaYaNVW0AsTI1KIvc3rj1kCmHfCXZ2yBGEz
hBVTo1FD2mKoxCmlwXwaJFvB3EghxUjmb6xsuGzZEgMlEpssIkS/pi3SsPzD
EZF2CsyayknlM+iU5EVRUD6UY9I3wjxhUvstcls2iqN5UP3QjUQZDC2MHUoa
DrImjwJYeNKUdN+ua5qlbZBhixFnF97BNJwBALN4MmXBEE9Sr9TQhpnloMQF
mEAadGO5LJoLShMRlGgLywcz7XHBAhOmjMko+TomtiHRYb9pksbQIiGap/gb
YKCUpB0I5BiTLQdVYO3HTm7Y9GxFgJqOFKRTUlLHFjXQmDduCNOxKeKicjNb
oY5m4io24sdM1eWaW6DEkeQV1Za+lIGwFBSmp22FFaIvplmlCl2wNiCsWIXA
CLmYVdfDWuhcJVtkG9LULL1XZuPT5xpqWpZqUna6LPtkZUmllWrGqDf5yoRU
KJiyGUt+FeSs04AIuHye0CMIQVjYmf7LHFAHB41RdTzM7uzKGWIX57B25Tz9
5UlRbnHMwV1hBl6FlIpyW5WtjkabZY1cvoAnM6NhwcyORS7KQVcAYxrlmOAX
+9TDaZpBr3Gw4Z0ACIk6ffIrKh6gBbzkMw9VTq0oAvacpN1ZihKyyBYcmeVs
ho5PwzYVS84moHpPJYt6SV0Ic7jSW9Rx8dInp1phLMIXRUx5x3yvlI7SlSJU
zbCuBIMDLYDrTmOEvfRdI/gOJc8MJz+OjJz7Usl4WRmiVS4LUy5pAiudxGSf
mgcYM4uYVQyk3H8u4uE7qjbIqbSqmbOiYZ4Zv/911Gt083IFXNw+wqJPAxtk
JMniHBYZ1AA9HuPehkPRodbVShBF0+fn+Q6r48qp0hANlo60WNUQa9NSjsZh
ganvIzWGw4c/izLeMLd52lfxTp1Ca2oKzbSQ1SiTLWXChnPi77gTxqiS4wNO
AIN6K9ZAjKHjM+FLJPjYeIWyTWcRyVptJH1Njkkq7QkEk2SLGxuPMIBjBmVP
bbdJnW78P/3DvhD83QAA

-->

</rfc>
