Skip to main content
POST
trace_block
curl --request POST \
  --url https://rpc.testnet.tempo.xyz/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "trace_block",
  "params": [
    "latest"
  ],
  "id": 1
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": [
    {}
  ]
}
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");

Body

application/json
​
jsonrpc
string
default:2.0
​
method
string
default:trace_block
​
params
any[]

Block number (hex) or tag

​
id
integer
default:1

Response

200 - application/json

Block traces

​
jsonrpc
string
​
id
integer
​
result
object[]

Array of trace objects for all transactions in the block