debug_traceTransaction - Plasma RPC Method

Traces a transaction execution on Plasma by transaction hash.

When to Use This MethodCopy Anchor Link

• Analyze transaction execution step-by-step - Trace every opcode and internal call in a completed transaction for stablecoin transfers, payment apps, and wallets that need 1 second confirmation
• Debug failed transactions - Pinpoint the exact opcode and call depth where a transaction reverted on Plasma
• Examine internal call traces - Follow the full call tree including delegate calls and contract creations
• Gas usage profiling - Measure gas consumption per opcode to identify optimization opportunities

Best PracticesCopy Anchor Link

• Requires archive node access; not available on standard full nodes
• Traces can be very large for complex transactions with many internal calls
• Use tracer options like onlyTopCall or callTracer to limit output size
• Store traces off-chain for analysis rather than querying repeatedly

{
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": ["0xb7db21f5fcc47ea4f33c75deebf128eb8aaecaece720d3503e8752ec29df3e0f", {"tracer": "callTracer"}],
  "id": 1
}

Tracer OptionsCopy Anchor Link

• {} - Default opcode tracer (verbose)
• { tracer: "callTracer" } - Call tree tracer
• { tracer: "prestateTracer" } - Pre-state tracer

Code ExamplesCopy Anchor Link

curl -X POST https://api-plasma-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceTransaction",
    "params": ["0xb7db21f5fcc47ea4f33c75deebf128eb8aaecaece720d3503e8752ec29df3e0f", {"tracer": "callTracer"}],
    "id": 1
  }'

Related MethodsCopy Anchor Link

• debug_traceCall - Trace without executing
• debug_traceBlockByNumber - Trace entire block