Scroll · eth

eth_getBlockReceipts

Returns the receipts of a block by number or hash.

Parameters

Block required

Schema

{
  "title": "Block number, tag, or block hash",
  "anyOf": [
    {
      "type": "string",
      "title": "Block number",
      "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
    },
    {
      "type": "string",
      "title": "Block tag",
      "description": "`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",
      "enum": [
        "earliest",
        "finalized",
        "safe",
        "latest",
        "pending"
      ]
    },
    {
      "type": "string",
      "title": "Block hash",
      "pattern": "^0x[0-9a-f]{64}$"
    }
  ]
}

Result

Receipts information

Schema

{
  "oneOf": [
    {
      "type": "null",
      "title": "Not Found (null)"
    },
    {
      "type": "array",
      "title": "Receipts information",
      "items": {
        "type": "object",
        "title": "Receipt information",
        "properties": {
          "blobGasPrice": {
            "type": "string",
            "title": "blob gas price",
            "description": "The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "blobGasUsed": {
            "type": "string",
            "title": "blob gas used",
            "description": "The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "blockHash": {
            "type": "string",
            "title": "block hash",
            "pattern": "^0x[0-9a-f]{64}$"
          },
          "blockNumber": {
            "type": "string",
            "title": "block number",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "contractAddress": {
            "title": "contract address",
            "description": "The contract address created, if the transaction was a contract creation, otherwise null.",
            "oneOf": [
              {
                "type": "string",
                "title": "hex encoded address",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              },
              {
                "type": "null",
                "title": "Null"
              }
            ]
          },
          "cumulativeGasUsed": {
            "type": "string",
            "title": "cumulative gas used",
            "description": "The sum of gas used by this transaction and all preceding transactions in the same block.",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "effectiveGasPrice": {
            "type": "string",
            "title": "effective gas price",
            "description": "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(0|[1-9a-f][0-9a-f]*)$"
          },
          "from": {
            "type": "string",
            "title": "from",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "gasUsed": {
            "type": "string",
            "title": "gas used",
            "description": "The amount of gas used for this specific transaction alone.",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "logs": {
            "type": "array",
            "title": "logs",
            "items": {
              "type": "object",
              "title": "log",
              "properties": {
                "address": {
                  "type": "string",
                  "title": "address",
                  "pattern": "^0x[0-9a-fA-F]{40}$"
                },
                "blockHash": {
                  "type": "string",
                  "title": "block hash",
                  "pattern": "^0x[0-9a-f]{64}$"
                },
                "blockNumber": {
                  "type": "string",
                  "title": "block number",
                  "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
                },
                "blockTimestamp": {
                  "type": "string",
                  "title": "block timestamp",
                  "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
                },
                "data": {
                  "type": "string",
                  "title": "data",
                  "pattern": "^0x[0-9a-f]*$"
                },
                "logIndex": {
                  "type": "string",
                  "title": "log index",
                  "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
                },
                "removed": {
                  "type": "boolean",
                  "title": "removed"
                },
                "topics": {
                  "type": "array",
                  "title": "topics",
                  "items": {
                    "type": "string",
                    "title": "32 hex encoded bytes",
                    "pattern": "^0x[0-9a-f]{64}$"
                  }
                },
                "transactionHash": {
                  "type": "string",
                  "title": "transaction hash",
                  "pattern": "^0x[0-9a-f]{64}$"
                },
                "transactionIndex": {
                  "type": "string",
                  "title": "transaction index",
                  "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
                }
              },
              "required": [
                "transactionHash"
              ]
            }
          },
          "logsBloom": {
            "type": "string",
            "title": "logs bloom",
            "pattern": "^0x[0-9a-f]{512}$"
          },
          "root": {
            "type": "string",
            "title": "state root",
            "description": "The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.",
            "pattern": "^0x[0-9a-f]{64}$"
          },
          "status": {
            "type": "string",
            "title": "status",
            "description": "Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "to": {
            "title": "to",
            "description": "Address of the receiver or null in a contract creation transaction.",
            "oneOf": [
              {
                "type": "null",
                "title": "Contract Creation (null)"
              },
              {
                "type": "string",
                "title": "Recipient Address",
                "pattern": "^0x[0-9a-fA-F]{40}$"
              }
            ]
          },
          "transactionHash": {
            "type": "string",
            "title": "transaction hash",
            "pattern": "^0x[0-9a-f]{64}$"
          },
          "transactionIndex": {
            "type": "string",
            "title": "transaction index",
            "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$"
          },
          "type": {
            "type": "string",
            "title": "type",
            "pattern": "^0x[0-9a-f]{1,2}$"
          }
        },
        "required": [
          "blockHash",
          "blockNumber",
          "from",
          "cumulativeGasUsed",
          "gasUsed",
          "logs",
          "logsBloom",
          "transactionHash",
          "transactionIndex",
          "effectiveGasPrice"
        ]
      }
    }
  ]
}

Example request

Endpoint: https://your-scroll-node.azxa.io

JSON-RPC

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

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "blobGasPrice": "0x32",
      "blobGasUsed": "0x20000",
      "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
      "blockNumber": "0x6f55",
      "contractAddress": null,
      "cumulativeGasUsed": "0x18c36",
      "effectiveGasPrice": "0x9502f907",
      "from": "0x22896bfc68814bfd855b1a167255ee497006e730",
      "gasUsed": "0x18c36",
      "logs": [
        {
          "address": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350",
          "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
          "blockNumber": "0x6f55",
          "data": "0x",
          "logIndex": "0x0",
          "removed": false,
          "topics": [
            "…",
            "…",
            "…",
            "…"
          ],
          "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975",
          "transactionIndex": "0x0"
        }
      ],
      "logsBloom": "0x000000040000000000000000000000000000000000000000000000000000000000008000000000…00000000000000000000",
      "status": "0x1",
      "to": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350",
      "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975",
      "transactionIndex": "0x0",
      "type": "0x0"
    },
    {
      "blobGasPrice": "0x32",
      "blobGasUsed": "0x20000",
      "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
      "blockNumber": "0x6f55",
      "contractAddress": null,
      "cumulativeGasUsed": "0x1de3e",
      "effectiveGasPrice": "0x9502f907",
      "from": "0x712e3a792c974b3e3dbe41229ad4290791c75a82",
      "gasUsed": "0x5208",
      "logs": [],
      "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000…00000000000000000000",
      "status": "0x1",
      "to": "0xd42e2b1c14d02f1df5369a9827cb8e6f3f75f338",
      "transactionHash": "0xefb83b4e3f1c317e8da0f8e2fbb2fe964f34ee184466032aeecac79f20eacaf6",
      "transactionIndex": "0x1",
      "type": "0x2"
    }
  ]
}

Test fixture

Fixture: get-block-receipts-0

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

cURL

curl -X POST https://your-scroll-node.azxa.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockReceipts","params":["latest"]}'