Skip to main content

eth_getBlockAccessList

Returns the block access list for a given block.

Parameters (by position)​

Block string or string or string required

Show Option 1 Block number string

Block number fields​

Block string required

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 required

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

Show Option 3 Block hash string

Block hash fields​

Block string required

Block hash

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

Result​

Block access list null or array<object>

Show Option 1 Not Found (null) null

Not Found (null) fields​

Block access list null

Not Found (null)

Show Option 2 Block access list array

Block access list fields​

Block access list array<object>

Account access

Show Block access list object

Block access list fields​

  • address string required

    hex encoded address

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

  • balanceChanges array<object>

    Balance change

    Show balanceChanges object

    balanceChanges fields​

    • index string required

      hex encoded 64 bit unsigned integer

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

    • value string required

      hex encoded 256 bit unsigned integer

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

    • additionalProperties false

  • codeChanges array<object>

    Code change

    Show codeChanges object

    codeChanges fields​

    • code string required

      hex encoded bytes

      Match pattern: ^0x[0-9a-f]*$

    • index string required

      hex encoded 64 bit unsigned integer

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

    • additionalProperties false

  • nonceChanges array<object>

    Nonce change

    Show nonceChanges object

    nonceChanges fields​

    • index string required

      hex encoded 64 bit unsigned integer

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

    • value string required

      hex encoded 64 bit unsigned integer

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

    • additionalProperties false

  • storageChanges array<object>

    Slot changes

    Show storageChanges object

    storageChanges fields​

    • changes array<object> required

      Storage change

      Show changes object

      changes fields​

      • index string required

        hex encoded 64 bit unsigned integer

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

      • value string required

        32 byte hex value

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

      • additionalProperties false

    • key string required

      32 byte hex value

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

    • additionalProperties false

  • storageReads array<string>

    32 byte hex value

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

  • additionalProperties false

Errors​

Error code: 4444

  • code

    4444

  • message

    Pruned history unavailable

Error code: 4445

  • code

    4445

  • message

    Block access list not available for pre-Amsterdam blocks

Examples​

eth_getBlockAccessList example

Request​

{
  "params": [
    "latest"
  ]
}

Response​

[
  {
    "address": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    "balanceChanges": [
      {
        "index": "0x0",
        "value": "0x56bc75e2d63100000"
      },
      {
        "index": "0x1",
        "value": "0x56bc75e2d63000000"
      }
    ],
    "codeChanges": [],
    "nonceChanges": [
      {
        "index": "0x0",
        "value": "0x0"
      },
      {
        "index": "0x1",
        "value": "0x1"
      }
    ],
    "storageChanges": [
      {
        "changes": [
          {
            "index": "0x0",
            "value": "0x0000000000000000000000000000000000000000000000000000000000000000"
          },
          {
            "index": "0x1",
            "value": "0x0000000000000000000000000000000000000000000000000000000000000100"
          }
        ],
        "key": "0x0000000000000000000000000000000000000000000000000000000000000000"
      }
    ],
    "storageReads": []
  }
]
Request