Transaction Log

A Transaction Log is a record of a MobileCoin transaction that was constructed and sent from this wallet.

Transaction Log

Due to the privacy properties of the MobileCoin ledger, transactions are ephemeral. Once they have been created, they only exist until they are validated, and then only the outputs are written to the ledger. For this reason, the Full-service Wallet stores outgoing transactions in the transaction_log table in order to preserve transaction history. Received transactions are instead saved as txos.

Attributes

Name	Type	Description
id	integer	Unique identifier for the transaction log. This value is not associated to the ledger.
account_id	string	Unique identifier for the assigned associated account. If the transaction is outgoing, this account is from whence the TXO came. If received, this is the receiving account.
value_map	map (string, uint64)	Total value per token associated to this transaction log.
fee_value	string (uint64)	Fee value associated to this transaction log.
fee_token_id	string (uint64)	Fee token id associated to this transaction log.
submitted_block_index	string (uint64)	The block index of the highest block on the network at the time the transaction was submitted.
tombstone_block_index	string (uint64)	The tombstone block index.
finalized_block_index	string (uint64)	The scanned block block index in which this transaction occurred.
status	string	String representing the transaction log status. Valid statuses are "built", "pending", "succeeded", "failed".
input_txos	[InputTxo]	A list of the TXOs which were inputs to this transaction.
payload_txos	[OutputTxo]	A list of the TXOs which were payloads of this transaction.
change_txos	[OutputTxo]	A list of the TXOs which were change in this transaction.
sent_time	Timestamp	Time at which sent transaction log was created. Only available if direction is "sent". This value is null if "received" or if the sent transactions were recovered from the ledger (is_sent_recovered = true).
comment	string	An arbitrary string attached to the object.
failure_code	integer	Code representing the cause of "failed" status.
failure_message	string	Human parsable explanation of "failed" status.

Input Txo

Attributes

Name	Type	Description
txo_id	string	Unique identifier for the txo.
amount	Amount	Amount of this txo.

Output Txo

Attributes

Name	Type	Description
txo_id	string	Unique identifier for the txo.
amount	Amount	Amount of this txo.
recipient_public_address_b58	string	Public address b58 of the recipient of this txo.

Example

Sent - Pending

{
  "id": "ab447d73553309ccaf60aedc1eaa67b47f65bee504872e4358682d76df486a87",
  "account_id": "a8c9c7acb96cf4ad9154eec9384c09f2c75a340b441924847fe5f60a41805bde",
  "value_map": {
    "0": "42000000000000"
  },
  "fee_value": "10000000000",
  "fee_token_id": "0",
  "submitted_block_index": "152950",
  "finalized_block_index": null,
  "status": "pending",
  "input_txos": [
    {
      "id": "eb735cafa6d8b14a69361cc05cb3a5970752d27d1265a1ffdfd22c0171c2b20d",
      "value": "50000000000",
      "token_id": "0"
    }
  ],
  "payload_txos": [
    {
      "id": "fd39b4e740cb302edf5da89c22c20bea0e4408df40e31c1dbb2ec0055435861c",
      "value": "30000000000",
      "token_id": "0"
      "recipient_public_address_b58": "vrewh94jfm43m430nmv2084j3k230j3mfm4i3mv39nffrwv43"
    }
  ],
  "change_txos": [
    {
      "id": "bcb45b4fab868324003631b6490a0bf46aaf37078a8d366b490437513c6786e4",
      "value": "10000000000",
      "token_id": "0"
      "recipient_public_address_b58": "grewmvn3990435vm032492v43mgkvocdajcl2icas"
    }
  ],
  "sent_time": "2021-02-28 01:42:28 UTC",
  "comment": "",
  "failure_code": null,
  "failure_message": null
}

Sent - Failed

{
  "id": "ab447d73553309ccaf60aedc1eaa67b47f65bee504872e4358682d76df486a87",
  "account_id": "a8c9c7acb96cf4ad9154eec9384c09f2c75a340b441924847fe5f60a41805bde",
  "value_map": {
    "0": "42000000000000"
  },
  "fee_value": "10000000000",
  "fee_token_id": "0",
  "submitted_block_index": "152950",
  "finalized_block_index": null,
  "status": "failed",
  "input_txos": [
    {
      "id": "eb735cafa6d8b14a69361cc05cb3a5970752d27d1265a1ffdfd22c0171c2b20d",
      "value": "50000000000",
      "token_id": "0"
    }
  ],
  "payload_txos": [
    {
      "id": "fd39b4e740cb302edf5da89c22c20bea0e4408df40e31c1dbb2ec0055435861c",
      "value": "30000000000",
      "token_id": "0"
      "recipient_public_address_b58": "vrewh94jfm43m430nmv2084j3k230j3mfm4i3mv39nffrwv43"
    }
  ],
  "change_txos": [
    {
      "id": "bcb45b4fab868324003631b6490a0bf46aaf37078a8d366b490437513c6786e4",
      "value": "10000000000",
      "token_id": "0"
      "recipient_public_address_b58": "grewmvn3990435vm032492v43mgkvocdajcl2icas"
    }
  ],
  "sent_time": "2021-02-28 01:42:28 UTC",
  "comment": "This is an example of a failed sent transaction log of 1.288 MOB and 0.01 MOB fee!",
  "failure_code": 3,
  "failure_message:": "Contains spent key image."
}

Sent - Success

{
  "id": "ab447d73553309ccaf60aedc1eaa67b47f65bee504872e4358682d76df486a87",
  "account_id": "a8c9c7acb96cf4ad9154eec9384c09f2c75a340b441924847fe5f60a41805bde",
  "value_map": {
    "0": "42000000000000"
  },
  "fee_value": "10000000000",
  "fee_token_id": "0",
  "submitted_block_index": "152950",
  "finalized_block_index": "152951",
  "status": "succeeded",
  "input_txos": [
    {
      "id": "eb735cafa6d8b14a69361cc05cb3a5970752d27d1265a1ffdfd22c0171c2b20d",
      "value": "50000000000",
      "token_id": "0"
    }
  ],
  "payload_txos": [
    {
      "id": "fd39b4e740cb302edf5da89c22c20bea0e4408df40e31c1dbb2ec0055435861c",
      "value": "30000000000",
      "token_id": "0"
      "recipient_public_address_b58": "vrewh94jfm43m430nmv2084j3k230j3mfm4i3mv39nffrwv43"
    }
  ],
  "change_txos": [
    {
      "id": "bcb45b4fab868324003631b6490a0bf46aaf37078a8d366b490437513c6786e4",
      "value": "10000000000",
      "token_id": "0"
      "recipient_public_address_b58": "grewmvn3990435vm032492v43mgkvocdajcl2icas"
    }
  ],
  "sent_time": "2021-02-28 01:42:28 UTC",
  "comment": "",
  "failure_code": null,
  "failure_message": null
}