eth_getTransactionReceipt

Returns the receipt for a mined transaction.

Returns the receipt for a mined transaction. Receipts are only available after the transaction has been included in a block.

For preconfirmed transaction receipts before a block is sealed, use a Flashblocks-aware endpoint and see the Flashblocks Behavior section below.

Parameters

transactionHash · string · required

The 32-byte hash of the transaction.

Returns

result · object | null

A transaction receipt object, or null if the transaction is not found or is still pending.

Show Transaction receipt fields

transactionHash · string

32-byte hash of the transaction.

transactionIndex · string

Transaction’s index position in the block.

blockHash · string

32-byte hash of the block this transaction is in.

blockNumber · string

Block number this transaction is in.

from · string

20-byte address of the sender.

to · string

20-byte address of the receiver. null for contract creation transactions.

cumulativeGasUsed · string

Total gas used in the block at the point this transaction was executed.

effectiveGasPrice · string

Actual gas price paid per unit of gas for this transaction.

gasUsed · string

Gas used by this specific transaction.

contractAddress · string | null

The address of the contract created by this transaction, if it was a contract creation. Otherwise null.

logs · array

Array of log objects generated by this transaction.

logsBloom · string

256-byte bloom filter for the logs of this transaction.

status · string

"0x1" for a successful transaction, "0x0" for a failed (reverted) transaction.

type · string

Transaction type: "0x0" (legacy), "0x1" (EIP-2930), "0x2" (EIP-1559).

Flashblocks Behavior

On a Flashblocks-aware endpoint, use "pending" as the block parameter to query preconfirmed state — data available up to 200ms before the next full block is sealed.

Returns the receipt for a preconfirmed transaction before it is included in a finalized block. Only available for transactions already included in a Flashblock.

cURL (preconfirmed state)

curl https://mainnet-preconf.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}'

Example

Request

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

Errors

Code	Message	Description
-32000	transaction indexing is in progress	The node is still indexing transactions. Retry after the node has finished syncing.