# debug_traceTransaction - Etherlink RPC Method

Traces a transaction execution on Etherlink by transaction hash.

Use callTracer. Mainnet block tracing starts at Bifrost block 4,162,673. The Dune client skips trace RPC below that height. Requests with timeout 119s succeeded; timeout enforcement was not verified.

## When to Use This Method

Read callTracer output for the transaction recorded in block 4,162,737. The captured result contains a CALL and a nested call.

## Best Practices

Keep the recorded block height and address together when reproducing a historical example. Preserve RPC errors instead of replacing them with empty results.

## Request Parameters

- `transactionHash` (`DATA, required`): 32-byte transaction hash.
- `tracerConfig` (`Object, required`): The verified configuration is {"tracer":"callTracer","timeout":"119s"}. Timeout enforcement was not verified.

## Request Example

```json
{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "debug_traceTransaction",
  "params": [
    "0x0dc908c545bfefe9fd5b5198e39c1af2b3166e5e556a51f2efd55c4a449fa587",
    {
      "tracer": "callTracer",
      "timeout": "119s"
    }
  ]
}
```

## Response Fields

- `type` (`string, required`): Call type, such as CALL, DELEGATECALL, or STATICCALL
- `from` (`string, required`): Sender address
- `to` (`string, required`): Receiver address
- `gas` (`string, required`): Gas provided, in hexadecimal
- `gasUsed` (`string, required`): Gas consumed, in hexadecimal
- `input` (`string, required`): Call data
- `output` (`string, required`): Return data
- `value` (`string, required`): Value in wei, in hexadecimal
- `logs` (`array, required`): Logs in this trace entry
- `calls` (`array, required`): Nested calls

## Successful Response

```json
{
  "jsonrpc": "2.0",
  "result": {
    "type": "CALL",
    "from": "0x5d66ec78664f4a0b0929a41270316a6cd4d8bd4b",
    "to": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
    "value": "0x00",
    "gas": "0x099520",
    "gasUsed": "0x02aeca",
    "input": "0xc14c9204000000000000000000000000000000000000000000000000000001930619e2a045544800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004176c0e69c01930619e2a00000002000000109c886e2a7ed5cf552ceb4d68ffb852fc04e0a01055016552a1810caffa1ee52702b8cccd149c9d6a61ad37b759e3f4be464d8cdd01f52c29055d88485e489fe1b45544800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004176c0e69c01930619e2a00000002000000151bfef864077e299879f09ddde98a3bd5e18b0f76038ef2f159fa841e2dbe093317ed9bfb4134f6a064de1c7f66e1f0dd64d13233d3b1907958583168a8ba4631b4254430000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006ce630dfee501930619e2a0000000200000016a56b8ce99eedd20dd230dc9cea28ccb27a83455c5a058750150db945dd08f532e8e0495bf5f2b0f5f72c2f2d898391852363a219b41f964964050720149461e1b4254430000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006ce62febb8d01930619e2a0000000200000010a78ef21ed2dbb7d94f8cbf46be9e4413ad64dc39482d0b9aec50ea48fa64123583775a5f9e065ccfe8867ee34314f0c7d2dfa79c3688d68658be2ea7e567d531c58545a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003db82ea01930619e2a0000000200000013f08d6d551abc925e12f0e394776bf39f6b525cf7da28a2e14389c55ed8e323127743b2c86b02c2860174c2c8182675c40327813d67ee846a0886919ac3e89c31c58545a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003db82ea01930619e2a000000020000001dbecf87431878794f047b813cdada29af88541ce656caa4d95008910970eed91431189604d3f9c4fb3a9bc629bf882171dd1be4e058ca9ea07e43036954bfeb11b00063137333039373432303132303623302e352e3123646174612d7061636b616765732d77726170706572000029000002ed57011e0000",
    "output": "0x",
    "logs": [],
    "calls": [
      {
        "type": "DELEGATECALL",
        "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
        "to": "0xfba31bfb2eb016968bc10726557fe72c1943b803",
        "value": "0x00",
        "gas": "0x09183b",
        "gasUsed": "0x02315b",
        "input": "0xc14c9204000000000000000000000000000000000000000000000000000001930619e2a045544800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004176c0e69c01930619e2a00000002000000109c886e2a7ed5cf552ceb4d68ffb852fc04e0a01055016552a1810caffa1ee52702b8cccd149c9d6a61ad37b759e3f4be464d8cdd01f52c29055d88485e489fe1b45544800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004176c0e69c01930619e2a00000002000000151bfef864077e299879f09ddde98a3bd5e18b0f76038ef2f159fa841e2dbe093317ed9bfb4134f6a064de1c7f66e1f0dd64d13233d3b1907958583168a8ba4631b4254430000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006ce630dfee501930619e2a0000000200000016a56b8ce99eedd20dd230dc9cea28ccb27a83455c5a058750150db945dd08f532e8e0495bf5f2b0f5f72c2f2d898391852363a219b41f964964050720149461e1b4254430000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006ce62febb8d01930619e2a0000000200000010a78ef21ed2dbb7d94f8cbf46be9e4413ad64dc39482d0b9aec50ea48fa64123583775a5f9e065ccfe8867ee34314f0c7d2dfa79c3688d68658be2ea7e567d531c58545a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003db82ea01930619e2a0000000200000013f08d6d551abc925e12f0e394776bf39f6b525cf7da28a2e14389c55ed8e323127743b2c86b02c2860174c2c8182675c40327813d67ee846a0886919ac3e89c31c58545a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003db82ea01930619e2a000000020000001dbecf87431878794f047b813cdada29af88541ce656caa4d95008910970eed91431189604d3f9c4fb3a9bc629bf882171dd1be4e058ca9ea07e43036954bfeb11b00063137333039373432303132303623302e352e3123646174612d7061636b616765732d77726170706572000029000002ed57011e0000",
        "output": "0x",
        "logs": [],
        "calls": [
          {
            "type": "STATICCALL",
            "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
            "to": "0x0000000000000000000000000000000000000001",
            "value": "0x00",
            "gas": "0x08cfdb",
            "gasUsed": "0x0bb8",
            "input": "0x81f89130aced0b895c253b12f57bfe7ac8a511311c25e27e65139c6a4191397d000000000000000000000000000000000000000000000000000000000000001bdbecf87431878794f047b813cdada29af88541ce656caa4d95008910970eed91431189604d3f9c4fb3a9bc629bf882171dd1be4e058ca9ea07e43036954bfeb1",
            "output": "0x0000000000000000000000009c5ae89c4af6aa32ce58588dbaf90d18a855b6de",
            "logs": [],
            "calls": []
          },
          {
            "type": "STATICCALL",
            "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
            "to": "0x0000000000000000000000000000000000000001",
            "value": "0x00",
            "gas": "0x08b1b0",
            "gasUsed": "0x0bb8",
            "input": "0x81f89130aced0b895c253b12f57bfe7ac8a511311c25e27e65139c6a4191397d000000000000000000000000000000000000000000000000000000000000001c3f08d6d551abc925e12f0e394776bf39f6b525cf7da28a2e14389c55ed8e323127743b2c86b02c2860174c2c8182675c40327813d67ee846a0886919ac3e89c3",
            "output": "0x0000000000000000000000008bb8f32df04c8b654987daaed53d6b6091e3b774",
            "logs": [],
            "calls": []
          },
          {
            "type": "STATICCALL",
            "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
            "to": "0x0000000000000000000000000000000000000001",
            "value": "0x00",
            "gas": "0x0893f9",
            "gasUsed": "0x0bb8",
            "input": "0x2fb3f28ee9b92b0a5728fc21b6c7177499e8e2d47b5ad8b86ae0c82fcff93141000000000000000000000000000000000000000000000000000000000000001c0a78ef21ed2dbb7d94f8cbf46be9e4413ad64dc39482d0b9aec50ea48fa64123583775a5f9e065ccfe8867ee34314f0c7d2dfa79c3688d68658be2ea7e567d53",
            "output": "0x00000000000000000000000051ce04be4b3e32572c4ec9135221d0691ba7d202",
            "logs": [],
            "calls": []
          },
          {
            "type": "STATICCALL",
            "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
            "to": "0x0000000000000000000000000000000000000001",
            "value": "0x00",
            "gas": "0x087494",
            "gasUsed": "0x0bb8",
            "input": "0x385b54893657ac03c3b5b25c2890eac2b0d53a0f6bd60976bf10c82c3eccb0d3000000000000000000000000000000000000000000000000000000000000001b6a56b8ce99eedd20dd230dc9cea28ccb27a83455c5a058750150db945dd08f532e8e0495bf5f2b0f5f72c2f2d898391852363a219b41f964964050720149461e",
            "output": "0x000000000000000000000000dd682daec5a90dd295d14da4b0bec9281017b5be",
            "logs": [],
            "calls": []
          },
          {
            "type": "STATICCALL",
            "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
            "to": "0x0000000000000000000000000000000000000001",
            "value": "0x00",
            "gas": "0x085512",
            "gasUsed": "0x0bb8",
            "input": "0x3e5ae81a3e3b16e806e35927ed9a1a3b1dd74acade9faa43f980e89707411fa0000000000000000000000000000000000000000000000000000000000000001b51bfef864077e299879f09ddde98a3bd5e18b0f76038ef2f159fa841e2dbe093317ed9bfb4134f6a064de1c7f66e1f0dd64d13233d3b1907958583168a8ba463",
            "output": "0x0000000000000000000000009c5ae89c4af6aa32ce58588dbaf90d18a855b6de",
            "logs": [],
            "calls": []
          },
          {
            "type": "STATICCALL",
            "from": "0xa2cca359c43839040cf3d230deb1689ab8db2dac",
            "to": "0x0000000000000000000000000000000000000001",
            "value": "0x00",
            "gas": "0x08362d",
            "gasUsed": "0x0bb8",
            "input": "0x3e5ae81a3e3b16e806e35927ed9a1a3b1dd74acade9faa43f980e89707411fa0000000000000000000000000000000000000000000000000000000000000001b09c886e2a7ed5cf552ceb4d68ffb852fc04e0a01055016552a1810caffa1ee52702b8cccd149c9d6a61ad37b759e3f4be464d8cdd01f52c29055d88485e489fe",
            "output": "0x0000000000000000000000008bb8f32df04c8b654987daaed53d6b6091e3b774",
            "logs": [],
            "calls": []
          }
        ]
      }
    ]
  },
  "id": 9
}
```

## Tracer Options

These examples use `callTracer`. The `timeout: 119s` field was accepted. Timeout enforcement and other tracer options were not verified.

## Code Examples

```bash
curl -X POST "https://api-etherlink-mainnet.n.dwellir.com/YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"jsonrpc":"2.0","id":9,"method":"debug_traceTransaction","params":["0x0dc908c545bfefe9fd5b5198e39c1af2b3166e5e556a51f2efd55c4a449fa587",{"tracer":"callTracer","timeout":"119s"}]}'
```