Skip to main content
EVM

eth_getBlockReceipts

Summary: Get block receipts by block number

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.

Parameters

block anyOf
required

Block number, block hash, or string tag.

Block number string

Block number in hexadecimal.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Block tag enum

See the default block parameter.

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

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Customize request
Request
curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": [],
"id": 1
}'