eth_getBlockByHash

Returns information about a block by hash on Bittensor.

Why Bittensor? Build on the decentralized AI network with $3.9B+ market cap powering 80+ AI subnets with Yuma Consensus for AI model evaluation, subnet-based specialization, dual Substrate+EVM support, and incentivized AI compute marketplace.

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 decentralized AI inference, subnet-specific AI models, TAO staking, and cross-subnet AI collaboration
• 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": [
    "0x2f0555cc76fc2840a25a6f3a0f0e6d0b1a6dd2e0cecc9e4c2e9e6f3a8d2e5c1b",
    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-bittensor-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x2f0555cc76fc2840a25a6f3a0f0e6d0b1a6dd2e0cecc9e4c2e9e6f3a8d2e5c1b",
      false
    ],
    "id": 1
  }'

JavaScript

import { JsonRpcProvider } from 'ethers';

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

const blockHash = '0x2f0555cc76fc2840a25a6f3a0f0e6d0b1a6dd2e0cecc9e4c2e9e6f3a8d2e5c1b';
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-bittensor-mainnet.n.dwellir.com/YOUR_API_KEY'))

block_hash = '0x2f0555cc76fc2840a25a6f3a0f0e6d0b1a6dd2e0cecc9e4c2e9e6f3a8d2e5c1b'
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-bittensor-mainnet.n.dwellir.com/YOUR_API_KEY")
    if err != nil {
        log.Fatal(err)
    }

    blockHash := common.HexToHash("0x2f0555cc76fc2840a25a6f3a0f0e6d0b1a6dd2e0cecc9e4c2e9e6f3a8d2e5c1b")
    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