eth_call

Executes a message call without creating a transaction. Use pending on a Flashblocks endpoint to simulate against pre-confirmed state.

Executes a message call immediately without broadcasting a transaction to the network. No gas is consumed on-chain. Used to read contract state or simulate calls.

Flashblocks: Query https://mainnet-preconf.base.org with "pending" to simulate against the current pre-confirmed block state, updated every ~200ms.

eth_call "pending" block context on Flashblocks nodes: Block-context properties (block.number, block.timestamp, block.basefee) may reflect a block several behind tip due to how nodes cache historical Flashblocks. See the FAQ for details.

Parameters

transaction · object · required

The transaction call object.

Show Transaction fields

from · string

Address the call is sent from. Optional; defaults to the zero address.

to · string · required

Address the call is directed to.

gas · string

Gas provided for the call as a hexadecimal integer. Defaults to a high limit if omitted.

gasPrice · string

Gas price in wei as a hexadecimal integer. For legacy transactions. Optional.

maxFeePerGas · string

EIP-1559 maximum total fee per gas. Optional.

maxPriorityFeePerGas · string

EIP-1559 maximum priority fee per gas. Optional.

value · string

Value transferred in wei as a hexadecimal integer. Optional.

data · string

ABI-encoded call data: the 4-byte function selector followed by encoded arguments. Optional.

block · string · required

Block number in hex, or "latest", "pending", "safe", "finalized", "earliest". Use "pending" on a Flashblocks endpoint to call against pre-confirmed state.

Returns

result · string

The return value of the call as a hex-encoded byte array.

Error Codes

Code	Message	Description
-32000	execution reverted	The call reverted. The data field in the error object contains the ABI-encoded revert reason when available.

Example

Standard (latest)

curl https://mainnet.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "data": "0x70a082310000000000000000000000004200000000000000000000000000000000000006"
      },
      "latest"
    ],
    "id": 1
  }'