Tac

Tac

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)

See also

• eth_getTransactionByHash - Get the complete transaction data using its unique hash
• eth_getLogs - Search for event logs based on address and topic filters

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