Preview

Preview Transaction

post

Preview 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.

For V2 transactions (and beyond) the /preview-v2 endpoint should be used instead.

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

Body

manifeststringRequired

A text-representation of a transaction manifest

blobs_hexstring[]Optional

An array of hex-encoded blob data, if referenced by the manifest.

start_epoch_inclusiveinteger · int64 · max: 10000000000Optional

An integer between 0 and 10^10, marking the epoch at which the transaction startsbeing valid. If omitted, the current epoch will be used.

end_epoch_exclusiveinteger · int64 · max: 10000000000Optional

An integer between 0 and 10^10, marking the epoch at which the transaction is no longer valid. If omitted, a maximum epoch (relative to the start_epoch_inclusive) will be used.

notary_is_signatorybooleanOptional

Whether the notary should be used as a signer (optional). If not provided, this defaults to false.

tip_percentageinteger · int32 · max: 65535Optional

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

nonceinteger · int64Optional

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). If not provided, this defaults to 0.

messageobjectOptional

An optional transaction message. Only affects the costing. This type is defined in the Core API as TransactionMessage. See the Core API documentation for more details.

Responses

200

Successful Preview

application/json

4XX

Client-originated request error

application/json

post

HTTPcURLJavaScriptPython

POST /transaction/preview HTTP/1.1
Host: xrd-gateway.nownodes.io
Content-Type: application/json
Accept: */*
Content-Length: 434

{
  "opt_ins": {
    "radix_engine_toolkit_receipt": false
  },
  "manifest": "text",
  "blobs_hex": [
    "text"
  ],
  "start_epoch_inclusive": 1,
  "end_epoch_exclusive": 1,
  "notary_public_key": {
    "key_type": "EcdsaSecp256k1"
  },
  "notary_is_signatory": true,
  "tip_percentage": 1,
  "nonce": 1,
  "signer_public_keys": [
    {
      "key_type": "EcdsaSecp256k1"
    }
  ],
  "message": {},
  "flags": {
    "use_free_credit": false,
    "assume_all_signature_proofs": false,
    "skip_epoch_check": false,
    "disable_auth_checks": false
  }
}

{
  "radix_engine_toolkit_receipt": {},
  "receipt": {},
  "resource_changes": [
    {}
  ],
  "logs": [
    {
      "level": "text",
      "message": "text"
    }
  ]
}