Skip to main content
Tempo API method that returns detailed traces for all transactions in a block specified by block number. This is useful for analyzing all contract interactions within a specific block.

​
Parameters

  • blockNumber — the block number (hex) or tag (latest, earliest, pending)
  • tracerConfig — (optional) tracer configuration object:
    • tracer — tracer type (e.g., callTracer, prestateTracer)
    • timeout — (optional) timeout for the trace
    • tracerConfig — (optional) tracer-specific configuration

​
Response

  • result — array of trace objects, one for each transaction in the block. The format depends on the tracer used.
For callTracer, each trace contains:
  • from — sender address
  • to — recipient address
  • gas — gas provided
  • gasUsed — gas consumed
  • input — call data
  • output — return data
  • calls — nested array of internal calls
  • type — call type (CALL, DELEGATECALL, etc.)

​
debug_traceBlockByNumber code examples

const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

const traceBlock = async (blockNumber) => {
    const traces = await provider.send("debug_traceBlockByNumber", [
      blockNumber,
      { tracer: "callTracer" }
    ]);

    console.log(`Block contains ${traces.length} transaction traces`);
    for (let i = 0; i < traces.length; i++) {
      const trace = traces[i].result;
      console.log(`\nTx ${i}: ${trace.from} -> ${trace.to}`);
      console.log(`  Type: ${trace.type}, Gas Used: ${trace.gasUsed}`);
      if (trace.calls) {
        console.log(`  Internal calls: ${trace.calls.length}`);
      }
    }
  };

traceBlock("latest");