Status

Get Transaction Status

Shares the node's knowledge of any payloads associated with the given intent hash. Generally there will be a single payload for a given intent, but it's theoretically possible there may be multiple. This knowledge is summarised into a status for the intent. This summarised status in the response is likely sufficient for most clients.

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

Body

application/json

network*NetworkIdentifier (string)

The logical name of the network

Example: "{{network}}"

intent_hash*IntentHashInput (string)

The intent hash for a user transaction, also known as the transaction id. This hash identifies the core content "intent" of the transaction. Each intent can only be committed once. This hash gets signed by any signatories on the transaction, to create the signed intent. Either hex or Bech32m-encoded strings are supported.

Response

200400500

Transaction status response

Body

application/json

intent_status*TransactionIntentStatus (enum)

The status of the transaction intent, as determined by the node. FateUncertain or FateUncertainButLikelyRejection mean that it's still possible that a payload containing the transaction

CommittedSuccessCommittedFailurePermanentRejectionInMempoolNotSeenFateUncertainFateUncertainButLikelyRejection

status_description*string

An explanation as to why the intent status is resolved as it is.

invalid_from_epochinteger (int64)

An integer between 0 and 10^10, marking the epoch from which the transaction will no longer be valid, and be permanently rejected. Only present if the intent status is InMempool or Unknown and we know about a payload.

known_payloads*array of TransactionPayloadDetails (object)

Request

JavaScriptCurlPython

const response = await fetch('https://xrd.nownodes.io/core/transaction/status', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "network": "{{network}}",
      "intent_hash": "text"
    }),
});
const data = await response.json();

Response

200400500

{
  "intent_status": "CommittedSuccess",
  "status_description": "text",
  "invalid_from_epoch": 0,
  "known_payloads": [
    {
      "payload_hash": "text",
      "payload_hash_bech32m": "text",
      "state_version": 0,
      "status": "CommittedSuccess",
      "error_message": "text"
    }
  ]
}