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.

POSThttps://xrd-gateway.nownodes.io/transaction/preview

Header parameters

Body

application/json

opt_insTransactionPreviewOptIns (object)

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

manifest*string

A text-representation of a transaction manifest

blobs_hexarray of string

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

start_epoch_inclusive*integer (int64)

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_exclusive*integer (int64)

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_keyPublicKey (object)

notary_is_signatoryboolean

Whether the notary should count as a signatory (defaults to 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 a 1% 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

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.

flags*object

Response

2004XX

Successful Preview

Body

application/json

encoded_receipt*HexString (string)

Hex-encoded binary blob.

radix_engine_toolkit_receiptobject

An optional field which is only provided if the request_radix_engine_toolkit_receipt flag is set to true when requesting a transaction preview from the API. 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.

receipt*object

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

resource_changes*array of object

logs*array of object

Request

JavaScriptCurlPython

const response = await fetch('https://xrd-gateway.nownodes.io/transaction/preview', {
    method: 'POST',
    headers: {
      "api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "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

2004XX

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