This request returns all transaction receipts of the given block identified by block number, hash, or tag. Transaction receipts provide a way to track the success or failure of a transaction (1 if successful and 0 if failed), as well as the amount of gas used and any event logs that might have been produced by a smart contract during the transaction.
earliest: The lowest numbered block the client has available.
finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination.
latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool.
Enum:
"earliest"
"finalized"
"latest"
"pending"
Block hash string
32 byte hex value.
Pattern: ^0x[0-9a-f]{64}$
Returns
Block object, or null when there is no block.
eth_getBlockReceiptsResponse oneOf
array
Not Found (null).
object
required
Receipt information
type enum
The transaction type as introduced in EIP-2718, in hexadecimal. Use:
0x00 for LegacyTxType
0x01 for AccessListTxType (EIP-2930)
0x02 for DynamicFeeTxType (EIP-1559)
Enum:
"0x00"
"0x01"
"0x02"
transactionHash string
The transaction hash in which the call was made.
Pattern: ^0x[0-9a-f]{64}$
transactionIndex string
The position in the block, in hexadecimal.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
blockHash string
Block hash; 32 byte hex identifier for the block derived from the block header.
Pattern: ^0x[0-9a-f]{64}$
blockNumber string
Block number as hex-encoded unsigned integer.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
from string
Address of the sender.
Pattern: ^0x[0-9a-fA-F]{40}$
to oneOf
Address of the receiver or null in a contract creation transaction.
Contract Creation (null) null
Contract Creation (null)
Recipient Address string
Hex-encoded address.
Pattern: ^0x[0-9a-fA-F]{40}$
cumulativeGasUsed string
The sum of gas used by this transaction and all preceding transactions in the same block.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
gasUsed string
The amount of gas used for this specific transaction alone.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
contractAddress oneOf
The contract address created, if the transaction was a contract creation, otherwise null.
Contract address string
Hex-encoded address.
Pattern: ^0x[0-9a-fA-F]{40}$
Null null
Null
logs array
object
required
removed boolean
logIndex string
Hex-encoded unsigned integer.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
transactionIndex string
A hexadecimal of the integer representing the position in the block.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
transactionHash string
The transaction hash in which the call was made.
Pattern: ^0x[0-9a-f]{64}$
blockHash string
Block hash; 32 byte hex identifier for the block derived from the block header.
Pattern: ^0x[0-9a-f]{64}$
blockNumber string
Block number as hex-encoded unsigned integer.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
address string
Hex-encoded address.
Pattern: ^0x[0-9a-fA-F]{40}$
data string
Hex-encoded bytes.
Pattern: ^0x[0-9a-f]*$
topics array
string
32 Hex-encoded bytes.
Pattern: ^0x[0-9a-f]{64}$
logsBloom string
Bloom filter for the block logs; null when block is pending.
Pattern: ^0x[0-9a-f]{512}$
root string
The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.
Pattern: ^0x[0-9a-f]{64}$
status enum
Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.
Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
Enum:
"0x0"
"0x1"
effectiveGasPrice string
The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).