TriportRPC
DashboardDocs

debug_traceTransaction

POSThttps://triport.io/rpc/bsc

Trace one transaction.

BNB Smart Chainbsc:rpcbsc_read_rpc_heavy - 15 / 20 / 100 / 250 RPS (free / basic / pro / business) (default, unmeasured); enterprise unlimited

debug_traceTransaction replays one BNB Smart Chain transaction in the selected debug tracer and returns a trace frame describing its execution.

Use it to inspect internal calls, input and output data, or gas consumption for a known transaction hash when a receipt only reports the final outcome. The optional tracer object selects the tracer, timeout, and tracer-specific configuration.

Unlike debug_traceBlockByNumber, this method targets one transaction rather than a whole block. It is best-effort because the pool currently has a single public source with a shared quota and no SLA.

Parameters

JSON-RPC params is a positional array: [transactionHash, options?].

transactionHashstring (32-byte hex hash)required
The 32-byte hash of the transaction to query.
optionsobjectoptional
Optional debug tracer settings; see the object fields below.
timeoutstringoptional
Positive duration ending in ms, s, or m.
tracerstringoptional
Upstream tracer name, such as the fixture's callTracer.
tracerConfigobjectoptional
Tracer-specific configuration passed to the upstream tracer.

Response

The response below is the checked fixture for this method; it is reproduced without changing its fields or values.

resultobject
Top-level trace frame.
result.typestring
Trace frame type.
result.fromstring
Caller address.
result.tostring
Destination address.
result.gasstring
Gas supplied as a hex quantity.
result.gasUsedstring
Gas consumed as a hex quantity.
result.inputstring
Input byte data.
result.outputstring
Output byte data.
result.valuestring
Transferred value when supplied.
result.callsarray<object>
Nested trace frames when supplied.

Errors

Errors use the standard JSON-RPC error envelope. See BSC errors for network-specific classification and the linked shared reference.

CodeMeaningWhen it happens
-32602Invalid paramsA required positional parameter is missing or a value does not match the OpenRPC schema.
429Trace source quotaThe one best-effort trace/debug source has exhausted its shared upstream quota.
401UnauthorizedThe x-token API key is missing or invalid.
429Rate limitedThe request exceeds the configured category RPS for the caller's tier.

Examples

JavaScript (fetch)

const response = await fetch("https://triport.io/rpc/bsc", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "debug_traceTransaction",
    "params": [
      "0x0000000000000000000000000000000000000000000000000000000000000000",
      {
        "tracer": "callTracer"
      }
    ]
  }),
});


const payload = await response.json();
console.log(payload.result);

Notes

  • Trace/debug service is best-effort through a single public source with a shared quota and no SLA; a quota failure does not imply that the method was removed from the catalog.
  • The BSC categories use configured defaults of 15 / 20 / 100 / 250 RPS; they are marked unmeasured in the tier matrix.
  • Related methods: debug_traceBlockByNumber, trace_block, eth_getTransactionReceipt.