eth_getBlockByHash

Returns information about a block by hash on zkSync Era.

Why zkSync? Build on Matter Labs' flagship zkEVM powering the Elastic Network of interoperable hyperchains with ZK Stack modular framework, hyperchain interoperability, native account abstraction, and $1.9B in tokenized real-world assets.

Use Cases

The eth_getBlockByHash method is essential for:

• Block verification - Verify block data using its unique hash
• Chain reorganization handling - Track blocks during reorgs
• Cross-chain bridges - Verify block finality for RWA tokenization ($1.9B, 25% market share), hyperchain deployment via ZK Stack, and cross-chain DeFi
• Deterministic queries - Get consistent block data regardless of chain state

Parameters

Parameter	Type	Required	Description
blockHash	DATA	Yes	32-byte block hash
fullTransactions	Boolean	Yes	If true, returns full transaction objects; if false, returns transaction hashes

Request

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

Returns

Returns the same block object as eth_getBlockByNumber, or null if no block is found.

Field	Type	Description
number	QUANTITY	Block number
hash	DATA	32-byte block hash
parentHash	DATA	32-byte parent block hash
timestamp	QUANTITY	Unix timestamp
gasUsed	QUANTITY	Total gas used
transactions	Array	Transaction objects or hashes

Code Examples

cURL

curl -X POST https://api-zksync-era-mainnet-full.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      false
    ],
    "id": 1
  }'

JavaScript

import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-zksync-era-mainnet-full.n.dwellir.com/YOUR_API_KEY');

const blockHash = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef';
const block = await provider.getBlock(blockHash);

console.log('Block number:', block.number);
console.log('Timestamp:', new Date(block.timestamp * 1000));

Python

from web3 import Web3

w3 = Web3(Web3.HTTPProvider('https://api-zksync-era-mainnet-full.n.dwellir.com/YOUR_API_KEY'))

block_hash = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
block = w3.eth.get_block(block_hash)

print(f'Block number: {block.number}')
print(f'Timestamp: {block.timestamp}')

Go

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/ethclient"
)

func main() {
    client, err := ethclient.Dial("https://api-zksync-era-mainnet-full.n.dwellir.com/YOUR_API_KEY")
    if err != nil {
        log.Fatal(err)
    }

    blockHash := common.HexToHash("0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef")
    block, err := client.BlockByHash(context.Background(), blockHash)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Block number: %d\n", block.Number().Uint64())
}

Error Handling

Error Code	Message	Description
-32602	Invalid params	Invalid block hash format
-32000	Block not found	Block with this hash does not exist

Related Methods

• eth_getBlockByNumber - Get block by number
• eth_blockNumber - Get latest block number