eth_blockNumber | Hyperliquid EVM

Documentation Index

Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Parameters

​

Response

​

Response structure

• result — The current block number as a hexadecimal string (e.g., “0x1b4” which equals 436 in decimal)

​

Block number interpretation

• Block numbers are returned in hexadecimal format with “0x” prefix
• Convert to decimal for human-readable block height
• Example: “0x1b4” = 436 in decimal

• Track blockchain progression and new block creation
• Implement block-based polling and event detection
• Verify synchronization status with other nodes
• Calculate block intervals and timing

​

Usage example

​

Basic implementation

// Get current block number
const getCurrentBlockNumber = async () => {
  const response = await fetch('https://hyperliquid-mainnet.core.chainstack.com/YOUR_ENDPOINT/evm', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'eth_blockNumber',
      params: [],
      id: 1
    })
  });
  
  const data = await response.json();
  const blockNumber = parseInt(data.result, 16);
  
  return {
    hex: data.result,
    decimal: blockNumber
  };
};

// Poll for new blocks
const pollForNewBlocks = async (callback) => {
  let lastBlockNumber = 0;
  
  const checkForNewBlock = async () => {
    try {
      const { decimal: currentBlock } = await getCurrentBlockNumber();
      
      if (currentBlock > lastBlockNumber) {
        lastBlockNumber = currentBlock;
        callback(currentBlock);
      }
    } catch (error) {
      console.error('Error checking block number:', error);
    }
  };
  
  // Poll every 2 seconds
  setInterval(checkForNewBlock, 2000);
};

// Usage
pollForNewBlocks((blockNumber) => {
  console.log(`New block: ${blockNumber}`);
});

​

Example request

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm

​

Use cases

• Blockchain monitoring: Monitor blockchain health, synchronization, and block progression
• Event detection: Implement efficient event detection and monitoring systems
• Transaction tracking: Track transaction confirmations and finality status
• Synchronization verification: Verify node synchronization and detect lag issues
• Block-based logic: Implement application logic that depends on block heights
• Performance monitoring: Monitor network performance and block creation times
• Data consistency: Ensure data consistency across blockchain state changes
• Polling optimization: Implement efficient polling mechanisms for blockchain data
• Cache management: Manage cache invalidation and data freshness using block numbers
• Analytics platforms: Build analytics tools that track blockchain metrics over time
• Trading applications: Implement trading logic that depends on block timing
• DeFi protocols: Build DeFi applications with block-aware functionality
• NFT platforms: Track NFT transactions and state changes across blocks
• Gaming applications: Implement blockchain-based gaming with block-dependent mechanics
• Oracle services: Provide block-aware oracle data and timing services
• Cross-chain bridges: Coordinate cross-chain operations using block numbers
• Governance systems: Implement governance mechanisms with block-based voting periods
• Staking protocols: Track staking rewards and penalties across block intervals
• Audit tools: Build audit tools that analyze blockchain state across blocks
• Development frameworks: Create development tools with block-aware debugging
• Testing suites: Implement blockchain testing with block progression simulation
• Load balancers: Distribute load based on node synchronization status
• Health checks: Monitor node health and blockchain connectivity
• Alerting systems: Create alerts based on block progression and timing anomalies