Preview

Transaction Preview

Preview a transaction against the latest network state, and returns the preview receipt.

POSThttps://xrd.nownodes.io/core/transaction/preview

Body

application/json

network*NetworkIdentifier (string)

The logical name of the network

Example: "{{network}}"

at_ledger_stateLedgerStateSelector (object)

An optional specification of a historical ledger state at which to execute the request. The "historical state" feature (see the db.historical_substate_values.enable flag) must be enabled on the Node, and the requested point in history must be recent enough (in accordance with the Node's configured state_hash_tree.state_version_history_length).

manifest*string

A text-representation of a transaction manifest

blobs_hexarray of string

An array of hex-encoded blob data (optional)

start_epoch_inclusive*integer (int64)

An integer between 0 and 10^10, marking the epoch at which the transaction starts being valid

end_epoch_exclusive*integer (int64)

An integer between 0 and 10^10, marking the epoch at which the transaction is no longer valid

notary_public_keyPublicKey (object)

notary_is_signatoryboolean

Whether the notary should count as a signatory (optional, default false)

tip_percentage*integer (int32)

An integer between 0 and 65535, giving the validator tip as a percentage amount. A value of 1 corresponds to 1% of the fee.

nonce*integer (int64)

An integer between 0 and 2^32 - 1, chosen to allow a unique intent to be created (to enable submitting an otherwise identical/duplicate intent).

signer_public_keys*array of PublicKey (object)

A list of public keys to be used as transaction signers

messageTransactionMessage (object)

flags*object

Response

200400500

Transaction preview response

Body

application/json

at_ledger_state*LedgerStateSummary (object)

encoded_receipt*string

The hex-sbor-encoded receipt

receipt*TransactionReceipt (object)

The transaction execution receipt

instruction_resource_changes*array of InstructionResourceChanges (object)

logs*array of object

Request

JavaScriptCurlPython

const response = await fetch('https://xrd.nownodes.io/core/transaction/preview', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "network": "{{network}}",
      "manifest": "text",
      "start_epoch_inclusive": 0,
      "end_epoch_exclusive": 0,
      "tip_percentage": 0,
      "nonce": 0,
      "signer_public_keys": [
        {
          "key_type": "EcdsaSecp256k1"
        }
      ],
      "flags": {
        "use_free_credit": false,
        "assume_all_signature_proofs": false,
        "skip_epoch_check": false
      }
    }),
});
const data = await response.json();

Response

200400500

{
  "at_ledger_state": {
    "state_version": 0,
    "header_summary": {
      "epoch_round": {
        "epoch": 0,
        "round": 0
      },
      "ledger_hashes": {
        "state_tree_hash": "text",
        "transaction_tree_hash": "text",
        "receipt_tree_hash": "text"
      },
      "proposer_timestamp": {
        "unix_timestamp_ms": 0,
        "date_time": "text"
      }
    }
  },
  "encoded_receipt": "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"
  },
  "instruction_resource_changes": [
    {
      "index": 0,
      "resource_changes": [
        {
          "resource_address": "text",
          "component_entity": {
            "entity_type": "GlobalPackage",
            "is_global": false,
            "entity_address": "text"
          },
          "vault_entity": {
            "entity_type": "GlobalPackage",
            "is_global": false,
            "entity_address": "text"
          },
          "amount": "text"
        }
      ]
    }
  ],
  "logs": [
    {
      "level": "text",
      "message": "text"
    }
  ]
}