Skip to content

eth_getTransactionReceipt

Returns the receipt for a transaction identified by its hash. Returns null while the transaction is still pending or has not yet been mined.

Receipts are only emitted once a transaction is included in a block. To track a transaction beforehand, call base_transactionStatus to confirm it has reached the mempool, or subscribe to newFlashblockTransactions to detect its pre-confirmation inside a Flashblock.

NameTypeRequiredDescription
transactionHashstringYesThe 32-byte transaction hash.

result is the receipt object, or null if the transaction has not been mined.

FieldTypeDescription
transactionHashstring32-byte transaction hash.
transactionIndexstringPosition of the transaction in the block (hex).
blockHashstring32-byte hash of the block containing this transaction.
blockNumberstringBlock number (hex).
fromstring20-byte sender address.
tostring20-byte recipient address. null for contract deployments.
cumulativeGasUsedstringTotal gas used in the block up to and including this transaction (hex).
effectiveGasPricestringActual gas price paid per unit of gas for this transaction (hex).
gasUsedstringGas used by this specific transaction (hex).
contractAddressstring | nullAddress of the deployed contract, or null if the transaction was not a deployment.
logsarrayArray of log objects emitted by this transaction.
logsBloomstring256-byte bloom filter for the logs in this receipt.
typestringTransaction type: "0x0" Legacy, "0x1" Access List, "0x2" EIP-1559, "0x7e" Deposit (L1→L2).
statusstring"0x1" for success, "0x0" for failure (revert).
blobGasUsedstringBlob gas consumed by this transaction (EIP-4844). null for non-blob transactions. Propagated accurately in both finalized and pre-confirmed Flashblock state.
blobGasPricestringBlob gas price at the time of this transaction (EIP-4844). null for non-blob transactions.
CodeMessageDescription
-32000transaction indexing is in progressThe node is still indexing transactions. Retry once the node finishes syncing.

The Flashblocks infrastructure stream surfaces pre-confirmed receipt data inside the metadata.receipts map of each Flashblock payload before the block seals. The abbreviated receipt mirrors the standard receipt shape:

FieldFlashblock metadata.receipts[hash]
typeTransaction type (0x0, 0x1, 0x2, 0x7e)
status"0x1" success / "0x0" failure
cumulativeGasUsedCumulative gas in block to this transaction
logsEmitted log objects
logsBloomBloom filter
transactionIndexIndex in block
{
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],
"id": 1
}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"transactionHash": "0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238",
"transactionIndex": "0x0",
"blockHash": "0x3a4e8c5d7f2b1a6e9d0c4f8b3e7a2d5c8f1b4e7a0d3c6f9b2e5a8d1c4f7b0e3",
"blockNumber": "0x12ced28",
"from": "0xd3CdA913deB6f4967b2Ef66ae97DE114a83bcc01",
"to": "0x4200000000000000000000000000000000000006",
"cumulativeGasUsed": "0x5208",
"effectiveGasPrice": "0x3b9aca00",
"gasUsed": "0x5208",
"contractAddress": null,
"logs": [],
"logsBloom": "0x00000000000000000000000000000000...",
"status": "0x1",
"type": "0x2"
}
}
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}