trace_replayBlockTransactions

trace_replayBlockTransactions replays all transactions in a single block in order, against the state as it existed at that block, and returns one trace result per transaction. Unlike a plain receipt, the result can include the full internal call tree, a step-by-step virtual-machine trace, and the set of state slots each transaction read and wrote.

You choose how much detail to return with the traceTypes array. Request only what you need: vmTrace in particular produces very large payloads (one entry per executed opcode) and is the most expensive mode to compute. For most call-graph analysis, ["trace"] alone is enough.

Use this method for block-level forensics — reconstructing internal transfers, auditing MEV activity, or diffing state across a whole block — when per-transaction calls would be too chatty. This is a pro-tier method; requests authenticated with a lower tier are rejected with -32002.

Positional params array: [block, traceTypes].

Response fields

result is an array with one entry per transaction in the block, in execution order. Each entry contains:

All errors use the shared JSON-RPC error envelope — see errors.md for the full structure and retry guidance.

JavaScript (fetch)

const res = await fetch("https://api.triport.io/v1/eth", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "trace_replayBlockTransactions",
    params: ["0x1387f23", ["trace", "stateDiff"]],
  }),
});


const { result } = await res.json();
console.log(`${result.length} transactions replayed`);

TypeScript SDK (@triport/sdk)

import { Triport } from "@triport/sdk";


const client = new Triport({ apiKey: process.env.TRIPORT_API_KEY! });


const traces = await client.eth.trace.replayBlockTransactions("0x1387f23", [
  "trace",
  "vmTrace",
  "stateDiff",
]);


for (const tx of traces) {
  console.log(tx.transactionHash, tx.trace?.length ?? 0, "frames");
}

Python (triport-sdk)

import os
from triport import Triport


client = Triport(api_key=os.environ["TRIPORT_API_KEY"])


traces = client.eth.trace.replay_block_transactions(
    "0x1387f23",
    ["trace", "state_diff"],
)


for tx in traces:
    print(tx["transactionHash"], len(tx.get("trace") or []), "frames")

• Cost scales with what you ask for. vmTrace emits one record per opcode and can return megabytes for a busy block; request it only when you need opcode-level detail. ["trace"] is the cheapest useful mode.
• Ordering. Results are returned in block execution order, so the array index aligns with each transaction's position in the block.
• Related methods. To replay arbitrary transactions instead of a whole block, see trace_replayTransaction. For a single confirmed transaction's call tree, see trace_transaction. To filter traces across a block range by address, see trace_filter.