# debug_traceBlockByNumber - Etherlink RPC Method

Traces all transactions in a block on Etherlink identified by its block number or tag. This is the most convenient block-tracing method - pass a block number or `"latest"` to get full execution traces of every transaction in that block.

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 block 4,162,737. Mainnet block tracing starts at Bifrost block 4,162,673. Below that height, Dune skips trace RPC.

## 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

- `blockNumber` (`QUANTITY or TAG, required`): Block number in hexadecimal, or latest. Block tracing starts at 4,162,673.
- `tracerConfig` (`Object, required`): The verified configuration is {"tracer":"callTracer","timeout":"119s"}. Timeout enforcement was not verified.

## Request Example

```json
{
  "jsonrpc": "2.0",
  "id": 26,
  "method": "debug_traceBlockByNumber",
  "params": [
    "0x3f84b1",
    {
      "tracer": "callTracer",
      "timeout": "119s"
    }
  ]
}
```

## Response Fields

This method returns no documented fields.

## Successful Response

```json
{
  "jsonrpc": "2.0",
  "result": [
    {
      "txHash": "0x0dc908c545bfefe9fd5b5198e39c1af2b3166e5e556a51f2efd55c4a449fa587",
      "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": 26
}
```

## 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":26,"method":"debug_traceBlockByNumber","params":["0x3f84b1",{"tracer":"callTracer","timeout":"119s"}]}'
```