> For the complete documentation index, see [llms.txt](https://docs.megaeth.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.megaeth.com/developer-docs/rpc/reference/eth_createaccesslist.md).

# eth\_createAccessList

## Summary

Generates an access list for a transaction.

The public MegaETH endpoint supports this method. The standard, node, and gateway layers below identify behavior that differs from a generic Ethereum endpoint.

## Parameters

**`transaction`** object **REQUIRED**

Transaction to simulate.

* **`from`** Address

  Caller.
* **`to`** Address

  Target; `null` for contract-creation simulation.
* **`value`** Quantity

  Wei value sent.
* **`input`** Data

  Calldata; prefer over `data`.
* **`gas`** Quantity

  Gas cap.
* **`gasPrice`** Quantity

  Legacy gas price; do not combine with EIP-1559 fields.
* **`maxFeePerGas`** Quantity

  EIP-1559 max fee.
* **`maxPriorityFeePerGas`** Quantity

  EIP-1559 priority fee.
* **`nonce`** Quantity

  Caller nonce override.
* **`accessList`** array

  EIP-2930 access list; each entry: `{ "address": Address, "storageKeys": [Bytes32] }`.

***

**`block`** string

Hex block number or tag (`latest`, `safe`, `finalized`, `earliest`, `pending`). The default is `"latest"`.

***

**`stateOverride`** object

Per-address state overrides for this simulation.

Object keyed by address. Each value:

* **`balance`** Quantity

  Override the account balance.
* **`nonce`** Quantity

  Override the account nonce.
* **`code`** Data

  Override the account bytecode.
* **`state`** object

  Replace full storage (slot → value); mutually exclusive with `stateDiff`.
* **`stateDiff`** object

  Patch individual storage slots; mutually exclusive with `state`.
* **`movePrecompileToAddress`** Address

  Move a precompile to the specified address before `code` is applied.

## Result

* **`accessList`** array

  Generated EIP-2930 access list; each entry: `{ "address": Address, "storageKeys": [Bytes32] }`.
* **`gasUsed`** Quantity

  Gas with the generated access list applied.
* **`error`** string

  Execution error when the call reverts; may coexist with `accessList` and `gasUsed`.

## Comparison with Ethereum Standard JSON-RPC

### Ethereum Standard

The canonical Ethereum method uses the parameter and result contract documented above, including the stated `null`, `false`, or zero-value semantics where applicable.

### MegaETH Node Behavior

The node executes the call in access-list collection mode and returns both the accessed addresses and storage keys and the resulting gas usage.

### MegaETH Public Gateway

The gateway routes the method to the compute pool without response caching and permits a 1.5 MiB single-request body. Unlike `eth_call`, gateway source does not add the separate 60,000,000 compute-gas override to this method.

## Errors

The `| Scope |` column distinguishes method failures from gateway policy errors.

| Code     | Scope            | Message              | When it happens                                              |
| -------- | ---------------- | -------------------- | ------------------------------------------------------------ |
| `-32602` | Request          | Invalid params       | Malformed transaction object or block selector               |
| `-32000` | Method           | Server error         | Pre-execution check failed (e.g. intrinsic gas too low)      |
| `-32003` | Method           | Transaction rejected | Sender cannot cover gas and value in the selected state      |
| `-32005` | Transport/policy | Rate limit exceeded  | The caller exceeds the public gateway's compute read budget. |
| `-32099` | Transport/policy | Payload too large    | The request body exceeds the 1.5 MiB public endpoint limit.  |

See also [Error Codes](/developer-docs/rpc/error-codes.md).

## Examples

Endpoint: `https://mainnet.megaeth.com/rpc`

Capture date: July 24, 2026

Outcome: success

```json
{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "eth_createAccessList",
  "params": [
    {
      "to": "0x1111111111111111111111111111111111111111",
      "input": "0x"
    },
    "latest"
  ]
}
```

```json
{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "accessList": [],
    "gasUsed": "0xea60"
  }
}
```

## Sources

* Spec: `git@github.com:ethereum/execution-apis.git @ d24f58b56dcd16ab0f0c70ec609bcc1c42750b51: src/eth/execute.yaml`
* Code: `git@github.com:megaeth-labs/mega-reth.git @ ab60376631228edab3a6df180f295280bad26e93: crates/megaeth/rpc/src/eth/api.rs`
* Code: `git@github.com:megaeth-labs/mega-rpc.git @ 06aa35aa95d569c227cc25d2aa12834eb0458aa0: workers/src/spec/methods.ts`
* Probe: MegaETH Mainnet public endpoint, July 24, 2026


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.megaeth.com/developer-docs/rpc/reference/eth_createaccesslist.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.