eth_getBlockByNumber - Zetachain RPC Method
Retrieve complete block data by block number on Zetachain. Perfect for cross-chain dApp developers, Bitcoin DeFi builders, and teams requiring native multi-chain interoperability building on the universal omnichain blockchain enabling cross-chain smart contracts across 50+ chains including Bitcoin.
Returns information about a block by block number on Zetachain.
Why Zetachain? Build on the universal omnichain blockchain enabling cross-chain smart contracts across 50+ chains including Bitcoin with native Bitcoin support, 50+ chain interoperability via UNISON, no bridging required, and partnerships with Curve and SushiSwap.
Use Cases
The eth_getBlockByNumber method is essential for:
- Block explorers - Display complete block information
- Transaction indexers - Process all transactions in a block
- Analytics platforms - Analyze blockchain data for omnichain DeFi, native Bitcoin smart contracts, cross-chain asset management, and unified liquidity aggregation
- Timestamp verification - Get block timestamps for time-based logic
Request Parameters
Block number in hex, or "latest", "earliest", "pending", "safe", "finalized"
If true, returns full transaction objects; if false, returns transaction hashes
Response Body
Block number
32-byte block hash
32-byte parent block hash
Unix timestamp
Total gas used by all transactions
Maximum gas allowed in block
Array of transaction objects or hashes
Base fee per gas (EIP-1559)
Code Examples
curl -X POST https://api-zetachain-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": ["latest", false],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | Invalid block number or parameter format |
| -32000 | Block not found | Block does not exist |
Related Methods
eth_blockNumber- Get latest block numbereth_getBlockByHash- Get block by hasheth_getTransactionByHash- Get transaction details
eth_blockNumber
Get the current block height on Zetachain. Essential for syncing dApps, monitoring transaction confirmations, and blockchain state tracking.
eth_getBlockByHash
Retrieve complete block data by block hash on Zetachain. Essential for cross-chain dApp developers, Bitcoin DeFi builders, and teams requiring native multi-chain interoperability building on the universal omnichain blockchain enabling cross-chain smart contracts across 50+ chains including Bitcoin.