chain_getBlockHash

Description#

Retrieves the block hash for a specific block number. When called without parameters, returns the hash of the latest block. This method is commonly used to get block identifiers for historical queries.

Parameters#

Parameter	Type	Required	Description
`blockNumber`	number	No	Block number to get hash for. If omitted, returns latest block hash

Returns#

Field	Type	Description
`result`	string	Hex-encoded block hash

Request Example#

{
  "jsonrpc": "2.0",
  "method": "chain_getBlockHash",
  "params": [1000000],
  "id": 1
}

Response Example#

{
  "jsonrpc": "2.0",
  "result": "0x8a841f44fe2cf9dc006ad8a9d12790b298c2b2da2260ea06ba00512725f2a80e",
  "id": 1
}

Code Examples#

Python
JavaScript

import requests
import json

def get_block_hash(block_number=None):
    url = "https://api-kusama.n.dwellir.com/YOUR_API_KEY/YOUR_API_KEY"
    headers = {
        "Content-Type": "application/json"
    }
    
    params = [block_number] if block_number is not None else []
    
    payload = {
        "jsonrpc": "2.0",
        "method": "chain_getBlockHash",
        "params": params,
        "id": 1
    }
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    return response.json()["result"]

# Get genesis block hash
genesis_hash = get_block_hash(0)
print(f"Genesis block: {genesis_hash}")

const getBlockHash = async (blockNumber = null) => {
  const params = blockNumber !== null ? [blockNumber] : [];
  
  const response = await fetch('https://api-kusama.n.dwellir.com/YOUR_API_KEY/YOUR_API_KEY', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'chain_getBlockHash',
      params: params,
      id: 1
    })
  });
  
  const data = await response.json();
  return data.result;
};

// Get latest block hash
const latestHash = await getBlockHash();
console.log('Latest block hash:', latestHash);

// Get specific block hash
const historicalHash = await getBlockHash(1000000);
console.log('Block 1000000 hash:', historicalHash);

chain_getBlock - Get full block data using hash
state_getStorage - Query state at block
system_health - Check node status