eth_createAccessList

eth_createAccessList JSON-RPC reference for MegaETH.

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.

Examples

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

Capture date: July 24, 2026

Outcome: success

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

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

Sources

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