This page is a placeholder. All examples on this page are currently AI-generated and are not correct. This documentation will be completed in the future with accurate, tested examples.

Block Methods

8 methods for querying block data, receipts, and transaction counts.

Overview

Block methods provide access to block headers, full blocks, transaction receipts, and metadata. Use these methods to query blockchain state at specific block heights or hashes.

Methods

eth_blockNumber

Get the most recent block number.Returns: Quantity

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const blockNumber = await provider.request(Rpc.Eth.BlockNumberRequest());

console.log('Current block:', blockNumber);

eth_getBlockByNumber

Get block by number with full transactions or hashes.Parameters:

Parameter	Type	Description
`blockTag`	`BlockTag`	Block to query (`'latest'`, `'earliest'`, `'pending'`, or block number)
`fullTransactions`	`boolean`	`true` for full tx objects, `false` for hashes only

Returns: Block

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });

// Get latest block with full transaction objects
const block = await provider.request(Rpc.Eth.GetBlockByNumberRequest('latest', true));

console.log('Block number:', block.number);
console.log('Transaction count:', block.transactions.length);

eth_getBlockByHash

Get block by hash with full transactions or hashes.Parameters:

Parameter	Type	Description
`blockHash`	`Hash`	Block hash to query
`fullTransactions`	`boolean`	`true` for full tx objects, `false` for hashes only

Returns: Block

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';
import { Keccak256 } from '@tevm/voltaire/Keccak256';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const blockHash = Keccak256.from('0x...');

const block = await provider.request(Rpc.Eth.GetBlockByHashRequest(blockHash, false));

console.log('Block:', block);

eth_getBlockReceipts

Get all transaction receipts for a block.Parameters:

Parameter	Type	Description
`blockTag`	`BlockTag`	Block to query

Returns: TransactionReceipt[]

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const receipts = await provider.request(Rpc.Eth.GetBlockReceiptsRequest('latest'));

console.log('Receipts:', receipts.length);
receipts.forEach((receipt, i) => {
  console.log(`TX ${i} status:`, receipt.status);
});

eth_getBlockTransactionCountByHash

Get transaction count in a block by hash.Parameters:

Parameter	Type	Description
`blockHash`	`Hash`	Block hash to query

Returns: Quantity

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';
import { Keccak256 } from '@tevm/voltaire/Keccak256';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const blockHash = Keccak256.from('0x...');

const count = await provider.request(Rpc.Eth.GetBlockTransactionCountByHashRequest(blockHash));

console.log('Transaction count:', count);

eth_getBlockTransactionCountByNumber

Get transaction count in a block by number.Parameters:

Parameter	Type	Description
`blockTag`	`BlockTag`	Block to query

Returns: Quantity

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const count = await provider.request(Rpc.Eth.GetBlockTransactionCountByNumberRequest('latest'));

console.log('Transaction count:', count);

eth_getUncleCountByBlockHash

Get uncle count for a block by hash.Parameters:

Parameter	Type	Description
`blockHash`	`Hash`	Block hash to query

Returns: Quantity

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';
import { Keccak256 } from '@tevm/voltaire/Keccak256';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const blockHash = Keccak256.from('0x...');

const count = await provider.request(Rpc.Eth.GetUncleCountByBlockHashRequest(blockHash));

console.log('Uncle count:', count);

Uncle blocks were removed in Ethereum’s transition to Proof of Stake (The Merge). This method returns 0 for post-merge blocks.

eth_getUncleCountByBlockNumber

Get uncle count for a block by number.Parameters:

Parameter	Type	Description
`blockTag`	`BlockTag`	Block to query

Returns: Quantity

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });
const count = await provider.request(Rpc.Eth.GetUncleCountByBlockNumberRequest('latest'));

console.log('Uncle count:', count);

Uncle blocks were removed in Ethereum’s transition to Proof of Stake (The Merge). This method returns 0 for post-merge blocks.

Usage Patterns

Get Latest Block with Transactions

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });

const block = await provider.request(Rpc.Eth.GetBlockByNumberRequest('latest', true));

console.log('Block:', block.number);
console.log('Gas used:', block.gasUsed);
console.log('Transactions:', block.transactions.length);

// Get receipts for all transactions
const receipts = await provider.request(Rpc.Eth.GetBlockReceiptsRequest('latest'));
const gasUsedTotal = receipts.reduce(
  (sum, r) => sum + BigInt(r.gasUsed),
  0n
);
console.log('Total gas used:', gasUsedTotal);

Query Historical Block

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';
import * as Quantity from '@tevm/voltaire/primitives/Quantity';

const provider = new Provider({ url: 'https://mainnet.infura.io' });

// Query specific block number
const blockNumber = Quantity(18000000n);
const block = await provider.request(Rpc.Eth.GetBlockByNumberRequest(blockNumber, false));

console.log('Timestamp:', block.timestamp);
console.log('Miner:', block.miner);

// Get transaction count
const txCount = await provider.request(Rpc.Eth.GetBlockTransactionCountByNumberRequest(blockNumber));
console.log('Transactions:', txCount);

Check Block Finality

import { Provider } from '@tevm/voltaire/provider';
import * as Rpc from '@tevm/voltaire/jsonrpc';

const provider = new Provider({ url: 'https://mainnet.infura.io' });

// Get latest and finalized blocks
const [latest, finalized] = await Promise.all([
  provider.request(Rpc.Eth.GetBlockByNumberRequest('latest', false)),
  provider.request(Rpc.Eth.GetBlockByNumberRequest('finalized', false))
]);

const latestNum = BigInt(latest.number);
const finalizedNum = BigInt(finalized.number);
const confirmations = latestNum - finalizedNum;

console.log('Latest block:', latestNum);
console.log('Finalized block:', finalizedNum);
console.log('Blocks until finalized:', confirmations);

eth Methods - All eth namespace methods
Transaction Methods - Transaction queries and submission
State Methods - Account and storage queries
Block JSON-RPC Types - Block type definitions

Overview

Getting Started

Core Concepts

Skills

JSONRPCProvider

Contract

Primitives

Cryptography

EVM

Utils

Guides

Examples

Swift

Zig

Developer Documentation

Generated API (TypeDoc)

Block Methods

Block Methods

Overview

Methods

Usage Patterns

Get Latest Block with Transactions

Query Historical Block

Check Block Finality

​Block Methods

​Overview

​Methods

​Usage Patterns

​Get Latest Block with Transactions

​Query Historical Block

​Check Block Finality

​Related

Block Methods

Overview

Methods

Usage Patterns

Get Latest Block with Transactions

Query Historical Block

Check Block Finality

Related