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.

Parameters

Name	Type	Required	Description
transactionHash	string	Yes	The 32-byte transaction hash.

Returns

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

Field	Type	Description
transactionHash	string	32-byte transaction hash.
transactionIndex	string	Position of the transaction in the block (hex).
blockHash	string	32-byte hash of the block containing this transaction.
blockNumber	string	Block number (hex).
from	string	20-byte sender address.
to	string	20-byte recipient address. null for contract deployments.
cumulativeGasUsed	string	Total gas used in the block up to and including this transaction (hex).
effectiveGasPrice	string	Actual gas price paid per unit of gas for this transaction (hex).
gasUsed	string	Gas used by this specific transaction (hex).
contractAddress	string | null	Address of the deployed contract, or null if the transaction was not a deployment.
logs	array	Array of log objects emitted by this transaction.
logsBloom	string	256-byte bloom filter for the logs in this receipt.
type	string	Transaction type: "0x0" Legacy, "0x1" Access List, "0x2" EIP-1559, "0x7e" Deposit (L1→L2).
status	string	"0x1" for success, "0x0" for failure (revert).
blobGasUsed	string	Blob gas consumed by this transaction (EIP-4844). null for non-blob transactions.
blobGasPrice	string	Blob gas price at the time of this transaction (EIP-4844). null for non-blob transactions.
l1Fee	string	Total L1 data fee paid for this transaction (hex). OP Stack L2 field.
l1GasUsed	string	L1 gas attributed to this transaction’s L1 data portion (hex). OP Stack L2 field.
l1GasPrice	string	L1 gas price at the time of inclusion (hex). OP Stack L2 field.
l1BlobBaseFee	string	L1 blob base fee at the time of inclusion (hex). OP Stack L2 field.
l1BlobBaseFeeScalar	string	Scalar applied to the blob base fee when computing the L1 fee (hex). OP Stack L2 field.
l1BaseFeeScalar	string	Scalar applied to the L1 base fee when computing the L1 fee (hex). OP Stack L2 field.
daFootprintGasScalar	string	Base-specific data-availability footprint scalar (hex).
depositNonce	string	Nonce of the deposit transaction (hex). Present on type 0x7e transactions only.
depositReceiptVersion	string	Deposit receipt format version (hex). Present on type 0x7e transactions only.

Error codes

Code	Message	Description
-32000	transaction indexing is in progress	The node is still indexing transactions. Retry once the node finishes syncing.

Pre-confirmed receipt data

Earlier client versions surfaced abbreviated receipts inside the metadata.receipts map of the Flashblocks infrastructure stream. That field was removed in client version v0.8.0 — metadata now carries only block_number. To obtain receipt data before a block seals, poll this method with the "pending" tag, or subscribe to newFlashblockTransactions with full: true for a real-time stream of pre-confirmed transactions that includes their logs.

Example

Request

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],
  "id": 1
}

Response

{
  "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"
  }
}

Response (not found)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}