RAradixdlt
Transaction

Preview Transaction V2

Changed on

Previews a transaction against the latest network state, and returns the preview receipt. If the node has enabled it, you may be able to also preview against recent network state.

This endpoint supports V2 transactions (and beyond). If you still need to preview V1 transactions, you should use the /preview endpoint instead.

This endpoint is effectively a proxy towards the Core API /transaction/preview-v2 endpoint. See the Core API documentation for more details.

post/transaction/preview-v2

Request

  • Base URL
    https://mainnet.radixdlt.com
  • URL
    https://mainnet.radixdlt.com/transaction/preview-v2
  • Auth
    none declared

Request body

Example request

{
  "preview_transaction": {
    "type": "Compiled",
    "preview_transaction_hex": "<sample-preview-transaction-hex>"
  },
  "flags": {
    "use_free_credit": true,
    "assume_all_signature_proofs": true,
    "skip_epoch_check": true,
    "disable_auth_checks": true
  },
  "opt_ins": {
    "core_api_receipt": true,
    "radix_engine_toolkit_receipt": true,
    "logs": true
  }
}

Response

Successful Preview

at_ledger_state_versioninteger required

A summarized state of the ledger on top of which the preview was performed.

receiptobject

This is provided unless the core_api_receipt flag is set to false in the opt_ins property of the request.

This type is defined in the Core API as TransactionReceipt. See the Core API documentation for more details.

radix_engine_toolkit_receiptobject

An optional field which is only provided if the radix_engine_toolkit_receipt flag is set to true in the opt_ins property of the request.

This receipt is primarily intended for use with the toolkit and may contain information that is already available in the receipt provided in the receipt field of this response.

A typical client of this API is not expected to use this receipt. The primary clients this receipt is intended for is the Radix wallet or any client that needs to perform execution summaries on their transactions.

Changes