trace_filter | Tempo

Tempo API method that returns execution traces matching specific filter criteria. This is useful for finding all interactions with a specific contract or address across multiple blocks.

Parameters

• filterObject — the filter object:
  • fromBlock — (optional) starting block number (hex)
  • toBlock — (optional) ending block number (hex)
  • fromAddress — (optional) array of sender addresses to filter
  • toAddress — (optional) array of recipient addresses to filter
  • after — (optional) offset for pagination
  • count — (optional) maximum number of traces to return

Response

• result — array of trace objects matching the filter:
  • action — the action object:
    • from — sender address
    • to — recipient address
    • callType — type of call
    • gas — gas provided
    • input — call data
    • value — value transferred
  • blockHash — hash of the block
  • blockNumber — block number
  • result — the result object
  • subtraces — number of child traces
  • traceAddress — position in the trace tree
  • transactionHash — hash of the transaction
  • transactionPosition — index in the block
  • type — trace type

trace_filter code examples

The following example finds all calls to the pathUSD token contract:

ethers.js

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

// pathUSD token address
const PATHUSD = "0x20c0000000000000000000000000000000000000";

const traceFilter = async () => {
    const currentBlock = await provider.getBlockNumber();
    const fromBlock = "0x" + (currentBlock - 1000).toString(16);
    const toBlock = "0x" + currentBlock.toString(16);

    const traces = await provider.send("trace_filter", [{
      fromBlock: fromBlock,
      toBlock: toBlock,
      toAddress: [PATHUSD],
      count: 20
    }]);

    console.log(`Found ${traces.length} traces to pathUSD`);

    for (const trace of traces) {
      console.log(`Block ${trace.blockNumber}: ${trace.action.from} -> ${trace.action.to}`);
      console.log(`  Call type: ${trace.action.callType}`);
      console.log(`  Tx: ${trace.transactionHash}`);
    }
  };

traceFilter();