Transactions

Get Committed Transactions

Returns the list of committed transactions.

POSThttps://xrd.nownodes.io/core/stream/transactions

Body

application/json

network*string

The logical name of the network

Example: "{{network}}"

from_state_version*integer (int64)

The first (resultant) state version to be returned

limit*integer

The maximum number of transactions that will be returned.

sbor_format_optionsobject

Requested SBOR formats to include in the response

transaction_format_optionsobject

Requested transaction formats to include in the response

substate_format_optionsobject

Requested substate formats to include in the response

include_proofsboolean

Whether to include LedgerProofs (default false)

Response

200400500

Committed transactions response

Body

application/json

previous_state_identifiersall of

Identifiers for the state on top of which the returned transactions were executed (ie from_state_version - 1). This should be used for sanity-checking that you're reading from the ledger history you're expecting. If this is field is missing, the previous state does not exists (from_state_version is 0).

from_state_version*integer (int64)

The first (resultant) state version in the returned response (if any). This matches the from_state_version in the request.

count*integer (int32)

An integer between 0 and 10000, giving the total count of transactions in the returned response

max_ledger_state_version*integer (int64)

The maximum state version currently committed on this node's ledger.

transactions*array of object

A committed transactions list starting from the from_state_version (inclusive).

proofsarray of object

A ledger proof list starting from from_state_version (inclusive) stored by this node.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://xrd.nownodes.io/core/stream/transactions', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "network": "{{network}}",
      "from_state_version": 0,
      "limit": 0
    }),
});
const data = await response.json();

Response

200400500

{
  "previous_state_identifiers": {
    "state_version": 0,
    "state_tree_hash": "text",
    "transaction_tree_hash": "text",
    "receipt_tree_hash": "text"
  },
  "from_state_version": 0,
  "count": 0,
  "max_ledger_state_version": 0,
  "transactions": [
    {
      "resultant_state_identifiers": {
        "state_version": 0,
        "state_tree_hash": "text",
        "transaction_tree_hash": "text",
        "receipt_tree_hash": "text"
      },
      "ledger_transaction": {
        "type": "Genesis",
        "payload_hex": "text"
      },
      "receipt": {
        "status": "Succeeded",
        "fee_summary": {
          "execution_cost_units_consumed": 0,
          "finalization_cost_units_consumed": 0,
          "xrd_total_execution_cost": "text",
          "xrd_total_finalization_cost": "text",
          "xrd_total_royalty_cost": "text",
          "xrd_total_storage_cost": "text",
          "xrd_total_tipping_cost": "text"
        },
        "costing_parameters": {
          "execution_cost_unit_price": "text",
          "execution_cost_unit_limit": 0,
          "execution_cost_unit_loan": 0,
          "finalization_cost_unit_price": "text",
          "finalization_cost_unit_limit": 0,
          "xrd_usd_price": "text",
          "xrd_storage_price": "text",
          "xrd_archive_storage_price": "text",
          "tip_percentage": 0
        },
        "fee_source": {
          "from_vaults": [
            {
              "vault_entity": {
                "entity_type": "GlobalPackage",
                "is_global": false,
                "entity_address": "text"
              },
              "xrd_amount": "text"
            }
          ]
        },
        "fee_destination": {
          "to_proposer": "text",
          "to_validator_set": "text",
          "to_burn": "text",
          "to_royalty_recipients": [
            {
              "royalty_recipient": {
                "entity_type": "GlobalPackage",
                "is_global": false,
                "entity_address": "text"
              },
              "xrd_amount": "text"
            }
          ]
        },
        "state_updates": {
          "deleted_partitions": [
            {
              "entity_type": "GlobalPackage",
              "entity_address": "text",
              "entity_module": "TypeInfo",
              "partition_kind": "Field",
              "partition_number": 0
            }
          ],
          "created_substates": [
            {
              "substate_id": {
                "entity_type": "GlobalPackage",
                "entity_address": "text",
                "entity_module": "TypeInfo",
                "partition_kind": "Field",
                "partition_number": 0,
                "substate_type": "BootLoaderModuleFieldVmBoot",
                "substate_key": {
                  "key_type": "Field",
                  "db_sort_key_hex": "text"
                }
              },
              "value": {
                "substate_hex": "text",
                "substate_data_hash": "text",
                "substate_data": {
                  "substate_type": "BootLoaderModuleFieldVmBoot",
                  "is_locked": false
                }
              },
              "system_structure": {
                "type": "SystemField"
              }
            }
          ],
          "updated_substates": [
            {
              "substate_id": {
                "entity_type": "GlobalPackage",
                "entity_address": "text",
                "entity_module": "TypeInfo",
                "partition_kind": "Field",
                "partition_number": 0,
                "substate_type": "BootLoaderModuleFieldVmBoot",
                "substate_key": {
                  "key_type": "Field",
                  "db_sort_key_hex": "text"
                }
              },
              "new_value": {
                "substate_hex": "text",
                "substate_data_hash": "text",
                "substate_data": {
                  "substate_type": "BootLoaderModuleFieldVmBoot",
                  "is_locked": false
                }
              },
              "previous_value": {
                "substate_hex": "text",
                "substate_data_hash": "text",
                "substate_data": {
                  "substate_type": "BootLoaderModuleFieldVmBoot",
                  "is_locked": false
                }
              },
              "system_structure": {
                "type": "SystemField"
              }
            }
          ],
          "deleted_substates": [
            {
              "substate_id": {
                "entity_type": "GlobalPackage",
                "entity_address": "text",
                "entity_module": "TypeInfo",
                "partition_kind": "Field",
                "partition_number": 0,
                "substate_type": "BootLoaderModuleFieldVmBoot",
                "substate_key": {
                  "key_type": "Field",
                  "db_sort_key_hex": "text"
                }
              },
              "previous_value": {
                "substate_hex": "text",
                "substate_data_hash": "text",
                "substate_data": {
                  "substate_type": "BootLoaderModuleFieldVmBoot",
                  "is_locked": false
                }
              },
              "system_structure": {
                "type": "SystemField"
              }
            }
          ],
          "new_global_entities": [
            {
              "entity_type": "GlobalPackage",
              "is_global": false,
              "entity_address": "text"
            }
          ]
        },
        "events": [
          {
            "type": {
              "emitter": {
                "type": "Function"
              },
              "type_reference": {
                "full_type_id": {
                  "entity_address": "text",
                  "schema_hash": "text",
                  "local_type_id": {
                    "kind": "WellKnown",
                    "id": 0,
                    "as_sbor": {
                      "hex": "text"
                    }
                  }
                }
              },
              "name": "text"
            },
            "data": {
              "hex": "text"
            }
          }
        ],
        "next_epoch": {
          "epoch": 0,
          "validators": [
            {
              "address": "text",
              "key": {
                "key_type": "EcdsaSecp256k1",
                "key_hex": "text"
              },
              "stake": "text"
            }
          ],
          "significant_protocol_update_readiness": [
            {
              "readiness_signal_name": "text",
              "signalled_stake": "text"
            }
          ]
        },
        "output": [
          {
            "hex": "text"
          }
        ],
        "error_message": "text"
      },
      "balance_changes": {
        "fungible_entity_balance_changes": [
          {
            "entity_address": "text",
            "fee_balance_change": {
              "resource_address": "text",
              "balance_change": "text"
            },
            "fee_balance_changes": [
              {
                "type": "FeePayment",
                "resource_address": "text",
                "balance_change": "text"
              }
            ],
            "non_fee_balance_changes": [
              {
                "resource_address": "text",
                "balance_change": "text"
              }
            ]
          }
        ],
        "non_fungible_entity_balance_changes": [
          {
            "entity_address": "text",
            "resource_address": "text",
            "added": [
              "text"
            ],
            "removed": [
              "text"
            ]
          }
        ]
      },
      "proposer_timestamp_ms": 0
    }
  ],
  "proofs": [
    {
      "ledger_header": {
        "epoch": 0,
        "round": 0,
        "state_version": 0,
        "hashes": {
          "state_tree_hash": "text",
          "transaction_tree_hash": "text",
          "receipt_tree_hash": "text"
        },
        "consensus_parent_round_timestamp_ms": 0,
        "proposer_timestamp_ms": 0,
        "next_epoch": {
          "epoch": 0,
          "validators": [
            {
              "address": "text",
              "key": {
                "key_type": "EcdsaSecp256k1",
                "key_hex": "text"
              },
              "stake": "text"
            }
          ],
          "significant_protocol_update_readiness": [
            {
              "readiness_signal_name": "text",
              "signalled_stake": "text"
            }
          ]
        },
        "next_protocol_version": "text"
      },
      "origin": {
        "type": "Genesis"
      }
    }
  ]
}