eth_getTransactionReceipt

eth_getTransactionReceipt returns the execution receipt for a transaction that has already been included in an OP Mainnet block — the canonical OP Stack rollup (chain ID 10, 0xa) that settles to Ethereum L1 and pays gas in ETH. Given a transaction hash, it reports whether execution succeeded or reverted, how much gas was burned, the effective gas price paid, and every log the transaction emitted. Because OP Mainnet produces a fresh block roughly every 2 seconds from its single sequencer, receipts become available quickly after submission. Send the request to https://optimism.therpc.io/YOUR_API_KEY.

Use cases

• Confirm whether a transaction succeeded or reverted once it lands in an OP Mainnet block by reading the status field (0x1 success, 0x0 revert).
• Extract the emitted logs to update application state — for example, picking up Transfer events from an ERC-20 or a Swap from a Velodrome pool.
• Retrieve the address of a freshly deployed contract through the contractAddress field, which is non-null only for deployment transactions.
• Calculate the exact L2 execution fee paid as gasUsed * effectiveGasPrice (note that OP Stack also charges a separate L1 data fee for posting the transaction to Ethereum).

Parameters

Response

Example request

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getTransactionReceipt",
7    "params": ["0x0000000000000000000000000000000000000000000000000000000000000000"],
8    "id": 1
9  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• A still-pending transaction returns null. Poll until you get a non-null receipt rather than assuming it is ready; on OP Mainnet's ~2s blocks this is usually only a brief wait, but never treat the first null as a failure.
• status: "0x0" means the transaction was included in a block but reverted — gas was still consumed and the L1 data fee still applies, so the sender pays even though no state change stuck.
• For bulk ingestion (for example, indexing every receipt in a block), eth_getBlockReceipts returns them all in a single call and is far more efficient than one eth_getTransactionReceipt per transaction.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• eth_getTransactionByHash
• eth_getBlockReceipts
• eth_getLogs

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":[""]}'