eth_getBlockByNumber - SEI

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

Returns information about a block on the Sei network by its number. Can include full transaction objects or just transaction hashes.

Parameters

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

Request

cURL

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

JavaScript (axios)

Python (requests)

Rust (reqwest)

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "number": "0x4B8F2A1",
        "hash": "0x9a5e2b3c...",
        "parentHash": "0x8b4d1a2b...",
        "timestamp": "0x65f4a1b2",
        "gasLimit": "0x1c9c380",
        "gasUsed": "0x5208",
        "transactions": [...]
    }
}

Response Parameters

Field	Type	Description
number	string	The block number
hash	string	The block hash
parentHash	string	Hash of the parent block
timestamp	string	Unix timestamp of the block
gasLimit	string	Maximum gas allowed in the block
gasUsed	string	Total gas used by all transactions
transactions	array	Array of transaction objects or hashes

Use Case

The eth_getBlockByNumber method is essential for:

• Blockchain developers building applications on Sei

• Wallet applications requiring network data

• Analytics platforms tracking Sei network activity

• DeFi protocols integrating with Sei's parallelized EVM

Error Handling

Common errors when using this method:

Error Code	Message	Description
-32700	Parse error	Invalid JSON
-32600	Invalid Request	JSON is not a valid request object
-32601	Method not found	Method does not exist
-32602	Invalid params	Invalid method parameters
-32603	Internal error	Internal JSON-RPC error
-32000	Invalid input	Generic input error
-32500	Cross-VM error	Error in cross-VM operation (Sei-specific)

Web3 Integration

Ethers.js

ethers-example.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

// Using ethers provider methods
const result = await provider.send('eth_getBlockByNumber', ["latest", true]);
console.log(result);

Viem