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
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". Use "pending" on a Flashblocks endpoint to call against pre-confirmed state.
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.