chain_getBlockHash - Enjin RPC Method
Get block hash by number on Enjin. Essential for converting block numbers to hashes, historical queries, and blockchain navigation on the purpose-built NFT blockchain with protocol-level minting and $100M Metaverse Fund.
Returns the block hash for a given block number on Enjin. This is the primary method for converting block numbers into block hashes, which are required by most other chain RPC methods.
Why Enjin? Build on the purpose-built NFT blockchain with protocol-level minting and $100M Metaverse Fund with NFT functions at protocol level, Fuel Tanks for subsidized fees, 700-1000 TPS, 6-second finality, and ERC-1155 standard pioneer.
When to Use This Method
chain_getBlockHash is fundamental for game developers, NFT creators, and enterprises building cross-chain digital assets:
- Historical Queries — Convert block numbers to hashes for state queries at specific heights on Enjin
- Block Navigation — Navigate the blockchain history for high-volume NFT minting (2,000+ per tx), gaming assets, and cross-chain NFT transfers via Paratoken standard
- Data Indexing — Build block number-to-hash mappings for indexers and explorers
- Cross-Reference — Translate block numbers from events or logs into hashes for detailed lookups
Code Examples
Common Use Cases
1. Block Range Iterator
Iterate over a range of blocks on Enjin for indexing:
async function iterateBlocks(api, startBlock, endBlock) {
for (let num = startBlock; num <= endBlock; num++) {
const hash = await api.rpc.chain.getBlockHash(num);
const block = await api.rpc.chain.getBlock(hash);
console.log(`Block #${num}: ${block.block.extrinsics.length} extrinsics`);
}
}2. Historical State Query
Query Enjin state at a specific block height:
async function getBalanceAtBlock(api, address, blockNumber) {
const blockHash = await api.rpc.chain.getBlockHash(blockNumber);
const apiAt = await api.at(blockHash);
const account = await apiAt.query.system.account(address);
return {
blockNumber,
free: account.data.free.toString(),
reserved: account.data.reserved.toString()
};
}3. Genesis Hash Verification
Verify you are connected to the correct Enjin network:
async function verifyNetwork(api, expectedGenesisHash) {
const genesisHash = await api.rpc.chain.getBlockHash(0);
if (genesisHash.toHex() !== expectedGenesisHash) {
throw new Error(`Wrong network! Expected ${expectedGenesisHash}, got ${genesisHash.toHex()}`);
}
console.log('Connected to correct network');
}Error Handling
| Error Code | Description | Solution |
|---|---|---|
| -32602 | Invalid params | Block number must be a non-negative integer |
| -32603 | Internal error | Node may be syncing or block not yet available — retry with backoff |
| -32601 | Method not found | Verify the node supports this RPC method |
| -32005 | Rate limit exceeded | Implement client-side rate limiting |
Related Methods
chain_getBlock— Get full block data by hashchain_getHeader— Get block header by hashchain_getFinalizedHead— Get the latest finalized block hash
chain_getBlock
Retrieve block data by hash on Enjin. Essential for accessing block headers and extrinsics on the purpose-built NFT blockchain with protocol-level minting and $100M Metaverse Fund.
chain_getFinalizedHead
Get the finalized block hash on Enjin. Essential for confirmed state queries, exchange integrations, and applications requiring irreversible finality on the purpose-built NFT blockchain with protocol-level minting and $100M Metaverse Fund.