eth_getBlockByHash

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    true
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    false
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "number": "0x1b4",
    "hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    "parentHash": "0x6c0f2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    "nonce": "0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0e670ec64341...",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": ["0x..."],
    "uncles": []
  }
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": null
}

Defined in the Ethereum JSON-RPC Specification

Returns information about a block by hash.

Parameters

string

required

Hash of a block (32 bytes).

boolean

required

If true, returns the full transaction objects; if false, returns only the hashes of the transactions.

Returns

object

A block object, or null when no block was found.

Show Block object properties

string

The block number. null when its pending block.

string

Hash of the block. null when its pending block.

string

Hash of the parent block.

string

Hash of the generated proof-of-work. null when its pending block.

string

SHA3 of the uncles data in the block.

string

The bloom filter for the logs of the block. null when its pending block.

string

The root of the transaction trie of the block.

string

The root of the final state trie of the block.

string

The root of the receipts trie of the block.

string

The address of the beneficiary to whom the mining rewards were given.

string

Integer of the difficulty for this block.

string

Integer of the total difficulty of the chain until this block.

string

The “extra data” field of this block.

string

Integer the size of this block in bytes.

string

The maximum gas allowed in this block.

string

The total used gas by all transactions in this block.

string

The unix timestamp for when the block was collated.

array

Array of transaction objects, or 32 Bytes transaction hashes depending on the fullTransactionObjects parameter.

array

Array of uncle hashes.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    true
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    false
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "number": "0x1b4",
    "hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    "parentHash": "0x6c0f2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    "nonce": "0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0e670ec64341...",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": ["0x..."],
    "uncles": []
  }
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": null
}

Error Handling

Code	Message	Description
-32602	Invalid block hash	The provided block hash is invalid
4100	Requested method not supported	The method is not supported by the wallet

Setting fullTransactionObjects to true returns complete transaction details, while false returns only transaction hashes for better performance.

eth_getBlockByNumber

eth_getBlockTransactionCountByNumber

Introduction

Quickstart

Guides

Framework Integrations

Reference

More

Basenames

Contribute

Parameters

Returns

Error Handling

​Parameters

​Returns

​Error Handling

Parameters

Returns

Error Handling