debug_traceBlockByHash

Traces all transactions in a block on Ethereum by block hash.

Archive Node Required

This method requires an archive node. It is not available on full nodes.

Parameters

Parameter	Type	Required	Description
blockHash	DATA	Yes	32-byte block hash
tracerConfig	Object	No	Tracer configuration

Request

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": ["0x4e3a3754410177e6937ef1f84bba68ea139e8d1a2258c5f85db9f1cd715a1bdd", {"tracer": "callTracer"}],
  "id": 1
}

Code Examples

cURL

curl -X POST https://api-ethereum-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByHash",
    "params": ["0x4e3a3754410177e6937ef1f84bba68ea139e8d1a2258c5f85db9f1cd715a1bdd", {"tracer": "callTracer"}],
    "id": 1
  }'

JavaScript

import { JsonRpcProvider } from 'ethers';

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

const blockHash = '0x4e3a3754410177e6937ef1f84bba68ea139e8d1a2258c5f85db9f1cd715a1bdd';
const traces = await provider.send('debug_traceBlockByHash', [blockHash, { tracer: 'callTracer' }]);
console.log('Transaction traces:', traces.length);

Related Methods

• debug_traceBlockByNumber - Trace by number
• debug_traceTransaction - Trace single transaction