Read Contract

Call read-only contract functions at a selected block without sending a transaction.

# Read Contract

Call read-only contract functions at a selected block without sending a transaction.

**Read Contract** calls a contract's `view` functions. Queries read state only: they do not send a transaction or consume gas.

## Interface

| Area          | Description                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| Function list | Shows `view` functions in the ABI and their selectors.                      |
| Parameters    | Enter addresses, numbers, booleans, or arrays according to the ABI.         |
| Block         | Reads the latest state by default; you can also specify a historical block. |
| Result        | Shows decoded return values and their types.                                |

## Example

> Interactive content: Read Contract walkthrough. Open the online documentation to view it.

<span className="text-text-secondary block text-right text-xs">
  This example uses a local ABI and return values. It does not send requests.
</span>

1. Expand `token0`. It has no parameters, and its result appears directly.
2. Expand `balanceOf` and enter a complete `0x` address for `owner`.
3. Select **Latest Block** to read the current state, or **Custom Block** to enter a block height.
4. Select **Query** and inspect the `uint256` value for `balance` below.

## Notes

* Only `view` functions are available here; state-changing functions cannot be executed.
* Addresses must be 40-digit hexadecimal `0x` addresses. Enter large integers in full.
* Historical-block queries depend on node data. If it is unavailable, try the latest block.

## Next steps

* [Contract Sources](/docs/address/sources)
* [Storage Layout](/docs/address/storage-layout)

Read Contract calls a contract's view functions. Queries read state only: they do not send a transaction or consume gas.

Interface

Area	Description
Function list	Shows `view` functions in the ABI and their selectors.
Parameters	Enter addresses, numbers, booleans, or arrays according to the ABI.
Block	Reads the latest state by default; you can also specify a historical block.
Result	Shows decoded return values and their types.

Example

This example uses a local ABI and return values. It does not send requests.

Expand token0. It has no parameters, and its result appears directly.
Expand balanceOf and enter a complete 0x address for owner.
Select Latest Block to read the current state, or Custom Block to enter a block height.
Select Query and inspect the uint256 value for balance below.

Notes

Only view functions are available here; state-changing functions cannot be executed.
Addresses must be 40-digit hexadecimal 0x addresses. Enter large integers in full.
Historical-block queries depend on node data. If it is unavailable, try the latest block.

Next steps

Contract Sources

Browse verified contract source files and jump between symbol definitions.

Storage Layout

Map state variables to EVM storage slots and decode their values at a selected block.

On this page