TransactionGetReceipt

TransactionGetReceiptQuery

Get the receipt of a transaction, given its transaction ID. Once a transaction reaches consensus, then information about whether it succeeded or failed will be available until the end of the receipt period. Before and after the receipt period, and for a transaction that was never submitted, the receipt is unknown. This query is free (the payment field is left empty). No State proof is available for this response

Field
Type
Description

header

Standard info sent from client to node, including the signed payment, and what kind of response is requested (cost, state proof, both, or neither).

transactionID

The ID of the transaction for which the receipt is requested.

includeDuplicates

bool

Whether receipts of processing duplicate transactions should be returned along with the receipt of processing the first consensus transaction with the given id whose status was neither INVALID_NODE_ACCOUNT nor INVALID_PAYER_SIGNATURE; or, if no such receipt exists, the receipt of processing the first transaction to reach consensus with the given transaction id.

include_child_receipts

bool

Whether the response should include the receipts of any child transactions spawned by the top-level transaction with the given transactionID.

TransactionGetReceiptResponse

Response when the client sends the node TransactionGetReceiptQuery. If it created a new entity (account, file, or smart contract instance) then one of the three ID fields will be filled in with the ID of the new entity. Sometimes a single transaction will create more than one new entity, such as when a new contract instance is created, and this also creates the new account that it owned by that instance. No State proof is available for this response

Field
Type
Description

header

Standard response from node to client, including the requested fields: cost, or state proof, or both, or neither

receipt

The receipt, indicating it reached consensus (and whether it succeeded or failed) or is currently unknown (because it hasn't reached consensus yet, or the transaction has expired already), and including the ID of any new account/file/instance created by that transaction.

duplicateTransactionReceipts

The receipts of processing all transactions with the given id, in consensus time order.

child_transaction_receipts

The receipts (if any) of all child transactions spawned by the transaction with the given top-level id, in consensus order. Always empty if the top-level status is UNKNOWN.

Last updated