Docs
Supported ChainsZetachainJSON-RPC APIDebug Methods

debug_traceTransaction - Zetachain RPC Method

Trace a transaction execution on Zetachain. Requires archive node for debugging omnichain DeFi, native Bitcoin smart contracts, cross-chain asset management, and unified liquidity aggregation.

Traces a transaction execution on Zetachain 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 omnichain DeFi, native Bitcoin smart contracts, cross-chain asset management, and unified liquidity aggregation

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-zetachain-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceTransaction",
    "params": ["0x44a31ba6329490702fae6ac42f21801b18792c422004578cc5a83723e50c8b51", {"tracer": "callTracer"}],
    "id": 1
  }'