TransactionGetReceipt
Last updated
Last updated
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 |
---|---|---|
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 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.
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
repeated TransactionReceipt
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.