Docs
Supported ChainsLineaJSON-RPC APIDebug Methods

debug_traceTransaction - Linea RPC Method

Trace a transaction execution on Linea. Requires archive node for debugging enterprise DeFi (Aave, Renzo), institutional cross-border payments via SWIFT pilots, and zkEVM-native applications.

Traces a transaction execution on Linea by transaction hash.

Archive Node Required

This method requires an archive node. It is not available on full nodes.

Use Cases

  • Transaction debugging - Understand exactly what happened
  • Failure analysis - Find where and why a transaction reverted
  • Gas optimization - Analyze gas usage for enterprise DeFi (Aave, Renzo), institutional cross-border payments via SWIFT pilots, and zkEVM-native applications

Request Parameters

Request
txHashDATA

32-byte transaction hash

tracerConfigObject

Tracer configuration

Response Body

Response
typestring

Call type (CALL, DELEGATECALL, STATICCALL, CREATE, CREATE2)

fromstring

Sender address

tostring

Receiver address

gasstring

Gas provided for the call (hex)

gasUsedstring

Gas consumed by the call (hex)

inputstring

Call data (hex)

outputstring

Return data (hex), present on success

valuestring

Value transferred in wei (hex)

errorstring

Revert reason, present on failure

callsarray

Nested internal calls

Tracer Options

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

Code Examples

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