Preview

Preview Transaction

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

post

/transaction/preview

Header parameters

api-keystringrequired

Body

opt_insobject

A set of flags to configure the response of the transaction preview.

manifeststringrequired

A text-representation of a transaction manifest

blobs_hexstring[]

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

start_epoch_inclusiveinteger int64required

An integer between 0 and 10^10, marking the epoch at which the transaction starts being valid. If omitted, the current epoch will be used (taking into account the at_ledger_state, if specified).

end_epoch_exclusiveinteger int64required

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_public_keyobject

notary_is_signatoryboolean

Whether the notary should count as a signatory (defaults to false).

tip_percentageinteger int32required

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

nonceinteger int64required

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_keysobject[]required

A list of public keys to be used as transaction signers

messageobject

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.

flagsobjectrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://xrd-gateway.nownodes.io/transaction/preview' \
  --header 'api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{"opt_ins":{"radix_engine_toolkit_receipt":false},"manifest":"text","blobs_hex":[null],"start_epoch_inclusive":1,"end_epoch_exclusive":1,"notary_public_key":{"key_type":"EcdsaSecp256k1"},"tip_percentage":1,"nonce":1,"signer_public_keys":[{"key_type":"EcdsaSecp256k1"}],"message":{},"flags":{"use_free_credit":true,"assume_all_signature_proofs":true,"skip_epoch_check":true}}'

200

4XX

200

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

Successful Preview