Skip to content

New docs: Document eth_getStorageValues JSON-RPC method #2014

@alexandratran

Description

@alexandratran

What docs should be added?

Document the new eth_getStorageValues JSON-RPC method added in besu-eth/besu#10259.

This method is a batched version of eth_getStorageAt. It reads multiple storage slots across one or more accounts in a single call.

Suggested docs updates:

  • Add eth_getStorageValues to docs/public-networks/reference/api/index.md, near eth_getStorageAt.
  • Include parameters:
    • A storage slots request object that maps each 20-byte address to an array of storage slot keys.
    • A block parameter that accepts a hex block number, a block hash, or supported block tags such as latest.
  • Document the result as an object mapping each address to an array of hex storage values in the same order as the requested slots.
  • Document limits and important behavior verified in the PR:
    • Maximum total storage slots per request is 1024 across all addresses.
    • Empty requests return -32602 with empty request.
    • Requests over the slot limit return -32602 with too many slots (max 1024).
    • Unknown accounts return zero values for requested slots.
    • If the world state can't be opened, Besu returns WORLD_STATE_UNAVAILABLE.
  • Update the block parameter page's list of methods that support a blockHash parameter to include eth_getStorageValues.

Content type

  • Reference

Location

Source links

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions