eth_createAccessList

Generates an access list for a transaction.

Params

(2)

1. Transaction (required)

type

string

Match pattern:

^0x([0-9a-fA-F]?){1,2}$

nonce

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

from

string

Match pattern:

^0x[0-9a-fA-F]{40}$

gas

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

value

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

input

string

Match pattern:

^0x[0-9a-f]*$

gasPrice

string

The gas price willing to be paid by the sender in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

maxPriorityFeePerGas

string

Maximum fee per gas the sender is willing to pay to miners in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

maxFeePerGas

string

The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

maxFeePerBlobGas

string

The maximum total fee per gas the sender is willing to pay for blob gas in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

accessList

array[Access list entry]

EIP-2930 access list

address

string

required

Match pattern:

^0x[0-9a-fA-F]{40}$

storageKeys

array[string]

required

Match pattern:

^0x[0-9a-f]{64}$

blobVersionedHashes

array[string]

List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.

Match pattern:

^0x[0-9a-f]{64}$

blobs

array[string]

Raw blob data.

Match pattern:

^0x[0-9a-f]*$

chainId

string

Chain ID that this transaction is valid on.

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

authorizationList

array[object]

EIP-7702 authorization list

chainId

string

required

Chain ID on which this transaction is valid

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

nonce

string

required

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

address

string

required

Match pattern:

^0x[0-9a-fA-F]{40}$

yParity

string

required

The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature

Match pattern:

^0x([0-9a-fA-F]?){1,2}$

string

required

Match pattern:

^0x(0|[1-9a-f][0-9a-f]{0,63})$

string

required

Match pattern:

^0x(0|[1-9a-f][0-9a-f]{0,63})$

2. Block

Block number

(one of)

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

Result

(Gas used)

accessList

array[Access list entry]

address

string

required

Match pattern:

^0x[0-9a-fA-F]{40}$

storageKeys

array[string]

required

Match pattern:

^0x[0-9a-f]{64}$

error

string

gasUsed

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

Example

Request

await window.ethereum.request({
  "method": "eth_createAccessList",
  "params": [
    {
      "from": "0xaea8f8f781326bfe6a7683c2bd48dd6aa4d3ba63",
      "data": "0x608060806080608155"
    },
    "latest"
  ]
});

Result

{
  "accessList": [
    {
      "address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150",
      "storageKeys": [
        "0x0000000000000000000000000000000000000000000000000000000000000081"
      ]
    }
  ],
  "gasUsed": "0x125f8"
}