Skip to main content

eth_getStorageValues

Returns the values of multiple storage slots for multiple accounts in a single request.

Parameters (by position)​

Requests object required

Storage requests

Show Requests object

Requests fields​

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​

Values object

Storage values

Show Values object

Values fields​

Examples​

eth_getStorageValues example

Request​

{
  "params": [
    {
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": [
        "0x0000000000000000000000000000000000000000000000000000000000000003"
      ],
      "0xdAC17F958D2ee523a2206206994597C13D831ec7": [
        "0x0000000000000000000000000000000000000000000000000000000000000002",
        "0x0000000000000000000000000000000000000000000000000000000000000006"
      ]
    },
    "latest"
  ]
}

Response​

{
  "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": [
    "0x0000000000000000000000000000000000000000000000000000000000000001"
  ],
  "0xdAC17F958D2ee523a2206206994597C13D831ec7": [
    "0x00000000000000000000000000000000000000000000000000000000000f4240",
    "0x0000000000000000000000000000000000000000000000000000000000000012"
  ]
}
Request