Skip to main content
Tempo API method that returns execution traces for all transactions in a block. This provides detailed call-level traces using the Parity/OpenEthereum trace format.

​
Parameters

  • blockParameter — the block number (hex) or tag (latest, earliest, pending)

​
Response

  • result — array of trace objects for all transactions in the block:
    • action — the action object:
      • from — sender address
      • to — recipient address
      • callType — type of call (call, delegatecall, staticcall, etc.)
      • gas — gas provided
      • input — call data
      • value — value transferred
    • blockHash — hash of the block
    • blockNumber — block number
    • result — the result object:
      • gasUsed — gas consumed
      • output — return data
    • subtraces — number of child traces
    • traceAddress — position in the trace tree
    • transactionHash — hash of the transaction
    • transactionPosition — index of the transaction in the block
    • type — trace type (call, create, suicide, reward)

​
trace_block 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("trace_block", [blockNumber]);

    console.log(`Block has ${traces.length} traces`);

    // Group traces by transaction
    const txTraces = {};
    for (const trace of traces) {
      const txHash = trace.transactionHash;
      if (!txTraces[txHash]) {
        txTraces[txHash] = [];
      }
      txTraces[txHash].push(trace);
    }

    console.log(`Across ${Object.keys(txTraces).length} transactions`);

    for (const [txHash, txTrace] of Object.entries(txTraces)) {
      console.log(`\nTx: ${txHash}`);
      for (const trace of txTrace) {
        const indent = "  ".repeat(trace.traceAddress.length);
        console.log(`${indent}${trace.action.callType}: ${trace.action.from} -> ${trace.action.to}`);
      }
    }
  };

traceBlock("latest");