> ## 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_traceBlockByHash on MegaETH

> debug_traceBlockByHash traces every transaction in a block, identified by hash on MegaETH, via GoldRush JSON-RPC.

> [card] 0.015 credits per call

`debug_traceBlockByHash` on **MegaETH**: Traces every transaction in a block, identified by hash.

> [!NOTE]
>
> `debug_traceBlockByHash` requires archive depth. See the [debug & trace matrix](https://goldrush.dev/docs/goldrush-json-rpc/debug-trace.md) for MegaETH archive coverage.

## Endpoint

```
https://rpc.goldrushdata.com/v1/megaeth-mainnet
```

Authenticate with `Authorization: Bearer <GOLDRUSH_API_KEY>`. See [authentication](https://goldrush.dev/docs/goldrush-json-rpc/authentication.md).

## Parameters

| Name | Type | Required | Description | Example |
| - | - | - | - | - |
| `blockHash` | `DATA, 32 bytes` | yes | Hash of the block to trace. | `"0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35"` |
| `options` | `Object` | no | Tracer config. | `{"tracer":"callTracer"}` |

## Returns

`Array<Object>`: Array of per-transaction tracer outputs.

```json theme={null}
[{"result":{"type":"CALL","from":"0x..."}}]
```

## Examples

```bash curl theme={null}
curl https://rpc.goldrushdata.com/v1/megaeth-mainnet \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "debug_traceBlockByHash",
    "params": ["0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", {"tracer":"callTracer"}]
  }'
```

```typescript ethers v6 theme={null}
import { ethers } from "ethers";

const url = "https://rpc.goldrushdata.com/v1/megaeth-mainnet";
const fetchReq = new ethers.FetchRequest(url);
fetchReq.setHeader("Authorization", `Bearer ${process.env.GOLDRUSH_API_KEY}`);

const provider = new ethers.JsonRpcProvider(fetchReq);
const result = await provider.send("debug_traceBlockByHash", ["0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", {"tracer":"callTracer"}]);
console.log(result);
```

```typescript viem theme={null}
import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://rpc.goldrushdata.com/v1/megaeth-mainnet", {
    fetchOptions: {
      headers: {
        Authorization: `Bearer ${process.env.GOLDRUSH_API_KEY}`,
      },
    },
  }),
});

const result = await client.request({
  method: "debug_traceBlockByHash",
  params: ["0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", {"tracer":"callTracer"}],
});
console.log(result);
```

```javascript web3.js theme={null}
import { Web3 } from "web3";

const provider = new Web3.providers.HttpProvider(
  "https://rpc.goldrushdata.com/v1/megaeth-mainnet",
  {
    headers: [
      { name: "Authorization", value: `Bearer ${process.env.GOLDRUSH_API_KEY}` },
    ],
  }
);
const web3 = new Web3(provider);

const result = await web3.currentProvider.request({
  method: "debug_traceBlockByHash",
  params: ["0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", {"tracer":"callTracer"}],
});
console.log(result);
```

```python web3.py theme={null}
from os import environ
from web3 import Web3

w3 = Web3(Web3.HTTPProvider(
    "https://rpc.goldrushdata.com/v1/megaeth-mainnet",
    request_kwargs={
        "headers": {
            "Authorization": f"Bearer {environ['GOLDRUSH_API_KEY']}",
        },
    },
))
result = w3.manager.request_blocking("debug_traceBlockByHash", ["0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", {"tracer":"callTracer"}])
print(result)
```

## Errors

Standard JSON-RPC errors: `-32600` invalid request, `-32601` method not found, `-32602` invalid params.

## Related Debug and trace methods on MegaETH

* [`debug_traceTransaction` on MegaETH](https://goldrush.dev/docs/api-reference/json-rpc/megaeth/debug-tracetransaction)
* [`debug_traceCall` on MegaETH](https://goldrush.dev/docs/api-reference/json-rpc/megaeth/debug-tracecall)
* [`debug_traceBlockByNumber` on MegaETH](https://goldrush.dev/docs/api-reference/json-rpc/megaeth/debug-traceblockbynumber)
* [`trace_transaction` on MegaETH](https://goldrush.dev/docs/api-reference/json-rpc/megaeth/trace-transaction)
* [`trace_block` on MegaETH](https://goldrush.dev/docs/api-reference/json-rpc/megaeth/trace-block)

## Also available on

* [`debug_traceBlockByHash` on Ethereum](https://goldrush.dev/docs/api-reference/json-rpc/ethereum/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on Polygon](https://goldrush.dev/docs/api-reference/json-rpc/polygon/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/bsc/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on Arbitrum](https://goldrush.dev/docs/api-reference/json-rpc/arbitrum/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on Base](https://goldrush.dev/docs/api-reference/json-rpc/base/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on HyperEVM](https://goldrush.dev/docs/api-reference/json-rpc/hyperevm/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on Monad](https://goldrush.dev/docs/api-reference/json-rpc/monad/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on Tempo](https://goldrush.dev/docs/api-reference/json-rpc/tempo/debug-traceblockbyhash)
* [`debug_traceBlockByHash` on Robinhood Chain](https://goldrush.dev/docs/api-reference/json-rpc/robinhood/debug-traceblockbyhash)


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