🔵 Base
eth_getBlockByHash

eth_getBlockByHash RPC Method

The eth_getBlockByHash method retrieves information about a specific block by its hash on the Base mainnet.

Need RPC API keys?

Get 12.5M archival requests for free today.

GET STARTED FOR FREE

Parameters

1. blockHash (required)

  • Type: String (32 bytes)
  • The hash of the block you want to query.

2. fullTransactions (required)

  • Type: Boolean
  • true: Returns full transaction objects.
  • false: Returns only transaction hashes.
params: [
  "0xc529628a946ecf86acfaff0251aeae15ca2563c5aaf7b4872609b84f6f396c99",
  false
]

Returns

Returns a block object if found, or null otherwise.

Block Object Properties

  • number: Block number, or null if pending.
  • hash: Block hash, or null if pending.
  • parentHash: Parent block hash.
  • nonce: Proof-of-work nonce, or null if pending.
  • difficulty: Difficulty for this block (hex string).
  • totalDifficulty: Total chain difficulty at this block (hex string).
  • logsBloom: Bloom filter for logs, or null if pending.
  • sha3Uncles: SHA3 of the block’s uncles data.
  • extraData: Extra data field.
  • timestamp: Unix timestamp.
  • size: Size of the block (in bytes).
  • miner: Miner address.
  • transactionsRoot: Root of the transaction trie.
  • stateRoot: Root of the state trie.
  • receiptsRoot: Root of receipts trie.
  • uncles: Array of uncle block hashes.
  • transactions: Array of transaction hashes or objects depending on fullTransactions.
  • gasUsed: Total gas used (hex).
  • gasLimit: Gas limit (hex).
  • mixHash: 256-bit hash (hex).
  • baseFeePerGas: (optional) Base fee per gas (hex).

Request

POST https://base-mainnet.chainnodes.org/YOUR-API-KEY

Example

💡

Confusing? Ask blockchain developers in Chainnodes Telegram Chat (opens in a new tab)

curl https://base-mainnet.chainnodes.org/YOUR-API-KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xc529628a946ecf86acfaff0251aeae15ca2563c5aaf7b4872609b84f6f396c99", false],"id":1}'

Example Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1029c88",
    "hash": "0xc529628a946ecf86acfaff0251aeae15ca2563c5aaf7b4872609b84f6f396c99",
    "parentHash": "0x38c03b0813aa479e8c0f1316828ed3729f1e100387a5372e1ecd4eee00d3c7e8",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x...",
    "transactionsRoot": "0x6f7b725bc43c2a3ad666751059041d722a17b9d69cf9f23e3a73af3a54c01eb7",
    "stateRoot": "0x30fcd7b38a90d1482006c66b9d630ece06a6d7405572e97ca4e1b0f2202744d7",
    "receiptsRoot": "0xf29158cb7989375414c130a7e335808026fdc9f8b9b6670f9d67e29154e103d3",
    "miner": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
    "difficulty": "0x0",
    "totalDifficulty": "0xc70d815d562d3cfa955",
    "extraData": "0x6265617665726275696c642e6f7267",
    "size": "0x28abc",
    "gasLimit": "0x1c9c380",
    "gasUsed": "0xdf19ac",
    "timestamp": "0x642709eb",
    "transactions": [
      "0xb19f38ce6f75b23a0d4b25f1ebb876dffb5041ece000628366a66420f5d80c36",
      "... more hashes ..."
    ],
    "uncles": [],
    "mixHash": "0x33ca51f80eee8c8a39ab58b9b04291f1064df288a346921b567f3d6200a1c8df",
    "baseFeePerGas": "0x6f664d776"
  }
}

Base chain API Documentation by CHAINNODES is based on Erigon node client. Contact us if you are interested in specific methods that are only available on geth, besu, Nethermind or reth

eth_getBlockTransactionCountByHasheth_getBlockByNumber