eth_getTransactionReceipt

The eth_getTransactionReceipt method returns the receipt of a transaction, which contains critical information about transaction execution results, including success or failure, gas used, generated events (logs), and deployed contract addresses. The receipt is only available for transactions that have been included in a block.

Use Cases

Verifying transaction success or failure
Monitoring gas consumption
Contract deployment verification
Event/log extraction
Transfer confirmation
Smart contract state change verification
Transaction fee calculation
Transaction finality confirmation

Method Details

This method returns the transaction receipt object using the transaction's unique hash.

Response Example

1{
2	"jsonrpc": "2.0",
3	"id": 1,
4	"result": {
5		"blockHash": "0x5f35e7deaad2ff7a25c46b7df81a5d834f6c2725e49e868402f6958e979aaa5a",
6		"blockNumber": "0x1197fa5",
7		"contractAddress": null,
8		"cumulativeGasUsed": "0x2eac11",
9		"effectiveGasPrice": "0xb4c7a080",
10		"from": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
11		"gasUsed": "0x860a",
12		"logs": [
13			{
14				"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
15				"topics": [
16					"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
17					"0x00000000000000000000000095222290dd7278aa3ddd389cc1e1d165cc4bafe5",
18					"0x00000000000000000000000088e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
19				],
20				"data": "0x00000000000000000000000000000000000000000000000000000000007a1200",
21				"blockNumber": "0x1197fa5",
22				"transactionHash": "0xbb3a336e3f823ec18197f1e13ee875700f08f03e2cab75f0d0b118dabb44cba0",
23				"transactionIndex": "0xdb",
24				"blockHash": "0x5f35e7deaad2ff7a25c46b7df81a5d834f6c2725e49e868402f6958e979aaa5a",
25				"logIndex": "0x133",
26				"removed": false
27			}
28		],
29		"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000",
30		"status": "0x1",
31		"to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
32		"transactionHash": "0xbb3a336e3f823ec18197f1e13ee875700f08f03e2cab75f0d0b118dabb44cba0",
33		"transactionIndex": "0xdb",
34		"type": "0x2"
35	}
36}

Understanding Status Codes

0x1: Transaction succeeded
0x0: Transaction failed (reverted)

Key Fields in Transaction Receipts

status: Indicates transaction success or failure
contractAddress: Contains the address of a newly deployed contract (null for regular transactions)
gasUsed: Amount of gas actually consumed by the transaction
logs: Events emitted during transaction execution
effectiveGasPrice: The actual price paid per unit of gas

Common Event Signatures

ERC20 Transfer: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
ERC20 Approval: 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925
ERC721 Transfer: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef (same as ERC20)

Important Notes

Transaction receipts are only available for transactions that have been included in a block
The receipt provides the definitive status of a transaction (success or failure)
For contract deployments, the new contract address is included in the receipt
Event logs can be used to track state changes triggered by the transaction
Gas used in the receipt provides the actual gas consumption (useful for fee calculation)