JSON-RPC Reference

eth_getBlockReceipts

Returns all transaction receipts for a given block. The receipts contain information about the execution of transactions including logs and gas used. ⚡ Compute Units: [200 CU](https://docs.conduit.xyz/rpc-nodes/information/compute-units)

Request

This endpoint expects an object.
blockIdentifierenum or stringRequired
Block number, block hash, or one of "latest", "earliest", "pending", "finalized", "safe"

Response

Array of transaction receipt objects for the block, or null if the block is unknown.

transactionHashstringformat: "^0x[0-9a-fA-F]{64}$"
transactionIndexstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
blockHashstringformat: "^0x[0-9a-fA-F]{64}$"
blockNumberstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
fromstringformat: "^0x[0-9a-fA-F]{40}$"
cumulativeGasUsedstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
The sum of gas used by this transaction and all preceding transactions in the same block.
gasUsedstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
The amount of gas used for this specific transaction alone.
logslist of objects
logsBloomstringformat: "^0x[0-9a-fA-F]{512}$"
effectiveGasPricestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

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).

typestringformat: "^0x[0-9a-fA-F]{1,2}$"
tostring or nullformat: "^0x[0-9a-fA-F]{40}$"
Address of the receiver or null in a contract creation transaction.
blobGasUsedstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.

contractAddressstring or nullformat: "^0x[0-9a-fA-F]{40}$"
The contract address created, if the transaction was a contract creation, otherwise null.
rootstringformat: "^0x[0-9a-fA-F]{64}$"

The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.

statusstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.

blobGasPricestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

The actual value per gas deducted from the sender’s account for blob gas. Only specified for blob transactions as defined by EIP-4844.

l1Feestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. Total L1 data-availability fee paid for this transaction, in wei.

l1GasUsedstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. L1 gas used to post this transaction’s data to L1 calldata or blobs.

l1GasPricestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. L1 base fee at the time this transaction was posted, in wei.

l1FeeScalarstring

OP-Stack only. Scalar applied to L1 fee. Used by pre-Ecotone fee model; superseded by l1BaseFeeScalar / l1BlobBaseFeeScalar post-Ecotone.

l1BaseFeeScalarstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. Post-Ecotone scalar applied to the L1 base fee component.

l1BlobBaseFeestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. L1 blob base fee at the time this transaction was posted, in wei.

l1BlobBaseFeeScalarstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. Post-Ecotone scalar applied to the L1 blob base fee component.

daFootprintGasScalarstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. Data-availability footprint scalar (used by some OP-Stack chains for DA pricing).

depositNoncestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. Present on deposit transactions (type 0x7e). Sequencer-assigned monotonic nonce for the deposit.

depositReceiptVersionstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

OP-Stack only. Present on deposit transactions (type 0x7e). Version of the deposit receipt format.