eth_getBlockByNumber - Monad

Example code for the eth_getBlockByNumber JSON-RPC method. Complete guide on how to use eth_getBlockByNumber JSON-RPC in GetBlock Web3 documentation.

This method returns information about a block by block number.

Parameters

Parameter	Type	Required	Description
blockNumber	string	Yes	Block number in hex, or "latest", "earliest", "pending", "safe", "finalized".
fullTransactions	boolean	Yes	If true, returns full transaction objects; if false, returns only transaction hashes.

Request

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": "getblock.io"
}'

Axios

Request

Rust

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "number": "0x1b4",
        "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
        "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
        "nonce": "0x0000000000000000",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "logsBloom": "0x00000000000000000000000000000000...",
        "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
        "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "miner": "0x0000000000000000000000000000000000000000",
        "difficulty": "0x0",
        "totalDifficulty": "0x0",
        "extraData": "0x",
        "size": "0x220",
        "gasLimit": "0x1c9c380",
        "gasUsed": "0x0",
        "timestamp": "0x65a1c2b4",
        "transactions": [],
        "uncles": [],
        "baseFeePerGas": "0x7"
    }
}

Response Parameters

Field	Type	Description
number	string	Block number in hex.
hash	string	32-byte hash of the block.
parentHash	string	32-byte hash of the parent block.
nonce	string	8-byte proof-of-work nonce (always 0 for Monad PoS).
sha3Uncles	string	SHA3 of uncles data.
logsBloom	string	256-byte bloom filter for logs.
transactionsRoot	string	Root of the transaction trie.
stateRoot	string	Root of the state trie.
receiptsRoot	string	Root of the receipts trie.
miner	string	Address of the block producer.
difficulty	string	Difficulty (0 for PoS).
totalDifficulty	string	Total difficulty of the chain.
extraData	string	Extra data field.
size	string	Size of the block in bytes.
gasLimit	string	Maximum gas allowed in the block.
gasUsed	string	Total gas used by transactions.
timestamp	string	Unix timestamp of the block.
transactions	array	Array of transaction hashes or objects.
baseFeePerGas	string	Base fee per gas (EIP-1559).

Use Case

The eth_getBlockByNumber method is essential for:

• Building block explorers

• Analyzing blockchain data

• Tracking block production on Monad's fast chain

• Transaction confirmation verification

• Historical data analysis

• Real-time block monitoring

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS-TOKEN.
-32602	Invalid params	Invalid block number format.
-32000	Resource not found	Block not found.

Web3 Integration

Ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');
const block = await provider.getBlock('latest');
console.log('Block:', block.number, 'Hash:', block.hash);

Viem