Skip to main content

eth_createAccessList

Generates an access list for a transaction.

Parameters (by position)​

Transaction object required

Transaction object generic to all types

Show Transaction object

Transaction fields​

  • type string

    type

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

  • nonce string

    nonce

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

  • to null or string

    Show Option 1 Contract Creation (null) null

    Contract Creation (null) fields​

    to null

    Contract Creation (null)

    Show Option 2 Address string

    Address fields​

    to string

    Address

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

  • from string

    from address

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

  • gas string

    gas limit

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

  • value string

    value

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

  • input string

    input data

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

    EIP-2930 access list

    Show accessList object

    accessList fields​

    EIP-2930 access list

    • address string required

      hex encoded address

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

    • storageKeys array<string> required

      32 byte hex value

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

    • additionalProperties false

  • 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

    Show authorizationList object

    authorizationList fields​

    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

      nonce

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

    • address string required

      hex encoded address

      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}$

    • r string required

      r

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

    • s string required

      s

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

    • additionalProperties true

  • additionalProperties false

Block string or string

Show Option 1 Block number string

Block number fields​

Block string

Block number

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

Show Option 2 Block tag string

Block tag fields​

earliest: The lowest numbered block the client has available; finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Block string

earliest: The lowest numbered block the client has available; finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Allowed values: earliest finalized safe latest pending

Result​

Gas used object

Access list result

Show Gas used object

Gas used fields​

  • accessList array<object>

    Access list entry

    Show accessList object

    accessList fields​

    • address string required

      hex encoded address

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

    • storageKeys array<string> required

      32 byte hex value

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

    • additionalProperties false

  • error string

    error

  • gasUsed string

    Gas used

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

  • additionalProperties false

Examples​

eth_createAccessList example

Request​

{
  "params": [
    {
      "from": "0xaea8f8f781326bfe6a7683c2bd48dd6aa4d3ba63",
      "data": "0x608060806080608155"
    },
    "latest"
  ]
}

Response​

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