debug_traceTransaction - Tempo RPC Method
Trace a transaction execution on Tempo. Requires archive node for debugging merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.
Tempo RPC endpoint: endpoint URLs, plans and pricing.
Traces a transaction execution on Tempo by transaction hash.
Archive Node Required
This method requires an archive node. It is not available on full nodes.
When to Use This Method
- Analyze transaction execution step-by-step - Trace every opcode and internal call in a completed transaction for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications
- Debug failed transactions - Pinpoint the exact opcode and call depth where a transaction reverted on Tempo
- 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 Practices
- 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
onlyTopCallorcallTracerto limit output size - Store traces off-chain for analysis rather than querying repeatedly
{
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": ["0x50b1857dce8dbe401e09610534de81655bc508c6765eb30ecefe24148c515c28", {"tracer": "callTracer"}],
"id": 1
}Tracer Options
{}- Default opcode tracer (verbose){ tracer: "callTracer" }- Call tree tracer{ tracer: "prestateTracer" }- Pre-state tracer
Code Examples
Related Methods
debug_traceCall- Trace without executingdebug_traceBlockByNumber- Trace entire block
debug_traceCall
Simulate a call on Tempo with debug_traceCall and get opcode, callTracer or prestateTracer output at any block, without sending a transaction.
trace_block
Get traces for all transactions in a block on Tempo. Requires archive node for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.