> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# debug_* and trace_*

> Opcode-level execution traces and Parity-style call traces on GoldRush JSON-RPC.

The `debug_*` and `trace_*` namespaces give you opcode-level visibility into transaction execution. They're used by block explorers, security tools, MEV searchers, and indexers that need internal-call data.

Both namespaces are served from `https://rpc.goldrushdata.com/v1/{chain}`.

> [!NOTE]
>
> **Looking for a wallet's internal transaction history?** These methods are **per-transaction and per-block primitives**, not a wallet-history endpoint. Reconstructing one address's internal transfers from raw traces means scanning a block range twice with `trace_filter` (once by `fromAddress`, once by `toAddress`) - and on chains where `trace_filter` isn't available (e.g. OP-stack L2s) falling back to `debug_traceBlockByNumber` block-by-block. For decoded, wallet-level internal transfers across chains with no client-side call-tree walking, use the Foundational API's [`with-internal` param](https://goldrush.dev/docs/resources/traces-support) instead.

## debug\_\* methods (Geth-style)

| Method | Summary | Rate |
| - | - | -: |
| [`debug_traceTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/debug-tracetransaction) | Step-by-step EVM trace of a mined transaction. | 0.015 |
| [`debug_traceCall`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/debug-tracecall) | Trace an `eth_call` without producing a transaction. | 0.015 |
| [`debug_traceBlockByHash`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/debug-traceblockbyhash) | Trace every transaction in a block (by hash). | 0.015 |
| [`debug_traceBlockByNumber`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/debug-traceblockbynumber) | Trace every transaction in a block (by number). | 0.015 |

All four accept a tracer config:

```json theme={null}
{
  "tracer": "callTracer",
  "tracerConfig": { "withLog": true },
  "timeout": "30s"
}
```

Common tracer values: `callTracer` (call graph), `prestateTracer` (state diff), `4byteTracer` (4-byte selector frequency), or omit for the default opcode-level trace.

## trace\_\* methods (Parity-style)

| Method | Summary | Rate |
| - | - | -: |
| [`trace_transaction`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-transaction) | Parity trace of a mined transaction. | 0.015 |
| [`trace_block`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-block) | Parity traces of every transaction in a block. | 0.015 |
| [`trace_filter`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-filter) | Parity traces matching a filter (sender, recipient, range). | 0.015 |
| [`trace_call`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-call) | Parity trace of an `eth_call`. | 0.015 |
| [`trace_callMany`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-callmany) | Parity traces for a sequence of calls executed in order. | 0.015 |
| [`trace_rawTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-rawtransaction) | Parity trace of a signed, unmined raw transaction. | 0.015 |
| [`trace_replayTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-replaytransaction) | Replay a mined transaction and return traces, vmTrace, and state diff. | 0.015 |
| [`trace_replayBlockTransactions`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-replayblocktransactions) | Replay every transaction in a block with selectable trace outputs. | 0.015 |
| [`trace_get`](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-get) | Fetch a specific sub-trace from a mined transaction by index path. | 0.015 |

`trace_*` is the canonical Erigon/Parity format. Prefer it when integrating with tooling that expects Erigon traces (e.g. block-explorer pipelines).

## Per-chain availability

Trace and debug support depends on what the upstream node software exposes. Erigon and Reth both expose `trace_*` natively, while Geth-based upstreams expose `debug_*`. GoldRush surfaces whichever is available, and falls back to a normalized translation where one namespace is missing.

| Chain | `debug_*` | `trace_*` | Archive depth |
| - | :-: | :-: | - |
| Ethereum (`eth-mainnet`) | ✅ | ✅ | Genesis |
| Polygon (`matic-mainnet`) | ✅ | ✅ | Genesis |
| BNB Smart Chain (`bsc-mainnet`) | ✅ | ✅ | Genesis |
| Arbitrum (`arbitrum-mainnet`) | ✅ | ✅ | Nitro genesis |
| Base (`base-mainnet`) | ✅ | ✅ | Genesis |
| HyperEVM (`hyperevm-mainnet`) | ✅ | ✅ | Genesis |
| MegaETH (`megaeth-mainnet`) | ⚠️ rolling | ⚠️ rolling | Last 30 days |
| Monad (`monad-mainnet`) | ⚠️ rolling | ⚠️ rolling | Last 30 days |
| Tempo (`tempo-mainnet`) | ⚠️ rolling | ⚠️ rolling | Last 7 days |

⚠️ "Rolling" means the upstream archive window slides forward over time. For deeper history on these chains, contact GoldRush support to discuss dedicated archive nodes.

## Solana

Solana does not expose the `debug_*` or `trace_*` namespaces; they are EVM-specific. For transaction introspection on Solana, use:

| Goal | Solana method |
| - | - |
| Inspect a confirmed transaction's logs, balances, and compute units | [`getTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/solana/gettransaction) |
| Dry-run a transaction and read its logs and state changes before sending | [`simulateTransaction`](https://goldrush.dev/docs/api-reference/json-rpc/solana/simulatetransaction) |
| Stream logs for a program or account in real time | [`logsSubscribe`](https://goldrush.dev/docs/api-reference/json-rpc/solana/logssubscribe) |

`simulateTransaction` is the closest analogue to `debug_traceCall` / `trace_call`: it returns the program logs, the error (if any), compute units consumed, and optionally post-simulation account state, without broadcasting the transaction.

## Pricing

`debug_*` and `trace_*` are heavier than standard `eth_*` reads. See [pricing](https://goldrush.dev/docs/goldrush-json-rpc/pricing.md) for full rates.

> [card] [debug\_traceTransaction](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/debug-tracetransaction.md)
>
> Most-used debug method.

> [card] [trace\_transaction](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/trace-transaction.md)
>
> Parity-style equivalent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.