eth_getBlockReceipts

Returns the receipts of a block by number or hash.

Parameters (by position)

Block string or string or string required

---

Show Option 1 Block number string

Block number fields

Block string required

Block number

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

---

Show Option 2 Block tag string

Block tag fields

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; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; 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. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Block string required

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; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; 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. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Allowed values: earliest finalized safe latest pending

---

Show Option 3 Block hash string

Block hash fields

Block string required

Block hash

Match pattern: ^0x[0-9a-f]{64}$

---

Result

Receipts information null or array<object>

---

Show Option 1 Not Found (null) null

Not Found (null) fields

Receipts information null

Not Found (null)

---

Show Option 2 Receipts information array

Receipts information fields

Receipts information array<object>

Receipt information

---

Show Receipts information object

Receipts information fields

• type string

  type

  Match pattern: ^0x([0-9a-fA-F]?){1,2}$

  ---

• transactionHash string required

  transaction hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• transactionIndex string required

  transaction index

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

  ---

• blockHash string required

  block hash

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• blockNumber string required

  block number

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

  ---

• from string required

  from

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• to null or string

  Address of the receiver or null in a contract creation transaction.

  ---

  Show Option 1 Contract Creation (null) null

  Contract Creation (null) fields

  Address of the receiver or null in a contract creation transaction.

  to null

  Address of the receiver or null in a contract creation transaction.

  ---

  Show Option 2 Recipient Address string

  Recipient Address fields

  Address of the receiver or null in a contract creation transaction.

  to string

  Address of the receiver or null in a contract creation transaction.

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

• cumulativeGasUsed string required

  The sum of gas used by this transaction and all preceding transactions in the same block.

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

  ---

• gasUsed string required

  The amount of gas used for this specific transaction alone.

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

  ---

• blobGasUsed string

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

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

  ---

• contractAddress string or null

  The contract address created, if the transaction was a contract creation, otherwise null.

  ---

  Show Option 1 hex encoded address string

  hex encoded address fields

  The contract address created, if the transaction was a contract creation, otherwise null.

  contractAddress string

  The contract address created, if the transaction was a contract creation, otherwise null.

  Match pattern: ^0x[0-9a-fA-F]{40}$

  ---

  Show Option 2 Null null

  Null fields

  The contract address created, if the transaction was a contract creation, otherwise null.

  contractAddress null

  The contract address created, if the transaction was a contract creation, otherwise null.

  ---

• logs array<object> required

  log

  ---

  Show logs object

  logs fields

  • removed boolean

    removed

    ---

  • logIndex string

    log index

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

    ---

  • transactionIndex string

    transaction index

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

    ---

  • transactionHash string required

    transaction hash

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • blockHash string

    block hash

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • blockNumber string

    block number

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

    ---

  • blockTimestamp string

    block timestamp

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

    ---

  • address string

    address

    Match pattern: ^0x[0-9a-fA-F]{40}$

    ---

  • data string

    data

    Match pattern: ^0x[0-9a-f]*$

    ---

  • topics array<string>

    32 hex encoded bytes

    Match pattern: ^0x[0-9a-f]{64}$

    ---

  • additionalProperties false

    ---

• logsBloom string required

  logs bloom

  Match pattern: ^0x[0-9a-f]{512}$

  ---

• root string

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

  Match pattern: ^0x[0-9a-f]{64}$

  ---

• status string

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

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

  ---

• effectiveGasPrice string required

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

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

  ---

• blobGasPrice string

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

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

  ---

• additionalProperties false

  ---

Examples

eth_getBlockReceipts example

Request

{
  "params": [
    "latest"
  ]
}

Response

[
  {
    "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
    "blockNumber": "0x6f55",
    "contractAddress": null,
    "cumulativeGasUsed": "0x18c36",
    "from": "0x22896bfc68814bfd855b1a167255ee497006e730",
    "gasUsed": "0x18c36",
    "blobGasUsed": "0x20000",
    "effectiveGasPrice": "0x9502f907",
    "blobGasPrice": "0x32",
    "logs": [
      {
        "address": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350",
        "topics": [
          "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
          "0x4be29e0e4eb91f98f709d98803cba271592782e293b84a625e025cbb40197ba8",
          "0x000000000000000000000000835281a2563db4ebf1b626172e085dc406bfc7d2",
          "0x00000000000000000000000022896bfc68814bfd855b1a167255ee497006e730"
        ],
        "data": "0x",
        "blockNumber": "0x6f55",
        "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975",
        "transactionIndex": "0x0",
        "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
        "logIndex": "0x0",
        "removed": false
      }
    ],
    "logsBloom": "0x00000004000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000080020000000000000200010000000000000000000001000000800000000000000000000000000000000000000000000000000000100100000000000000000000008000000000000000000000000000000002000000000000000000000",
    "status": "0x1",
    "to": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350",
    "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975",
    "transactionIndex": "0x0",
    "type": "0x0"
  },
  {
    "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
    "blockNumber": "0x6f55",
    "contractAddress": null,
    "cumulativeGasUsed": "0x1de3e",
    "from": "0x712e3a792c974b3e3dbe41229ad4290791c75a82",
    "gasUsed": "0x5208",
    "blobGasUsed": "0x20000",
    "effectiveGasPrice": "0x9502f907",
    "blobGasPrice": "0x32",
    "logs": [],
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "status": "0x1",
    "to": "0xd42e2b1c14d02f1df5369a9827cb8e6f3f75f338",
    "transactionHash": "0xefb83b4e3f1c317e8da0f8e2fbb2fe964f34ee184466032aeecac79f20eacaf6",
    "transactionIndex": "0x1",
    "type": "0x2"
  }
]

Request

Server URL:

{ "jsonrpc": "2.0", "method": "eth_getBlockReceipts", "params": [ "latest" ], "id": 1 }