Executes a message call without creating a transaction.
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.
Since Denim, Base produces a canonical block every 200ms and Flashblocks are retired. The "pending" tag is still accepted, but it no longer returns Flashblocks preconfirmation state. Use "latest" for the newest canonical state. See Migrate From Flashblocks.
Parameters
object
required
The transaction call object.
Show Transaction Fields
string
Address the call is sent from. Optional; defaults to the zero address.
string
required
Address the call is directed to.
string
Gas provided for the call as a hexadecimal integer. Defaults to a high limit if omitted.
string
Gas price in wei as a hexadecimal integer. For legacy transactions. Optional.
string
EIP-1559 maximum total fee per gas. Optional.
string
EIP-1559 maximum priority fee per gas. Optional.
string
Value transferred in wei as a hexadecimal integer. Optional.
string
ABI-encoded call data: the 4-byte function selector followed by encoded arguments. Optional.
string
required
Block number in hex, or "latest", "pending", "safe", "finalized", "earliest".
Returns
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.