eth_call

🚧

Note that the interactive example in this page will not work, due to the fact that eth_call is used to modify the state of the blockchain, it is not possible to duplicate the same request.

Description

Executes a new message call immediately without creating a transaction on the block chain. Often used for executing read-only smart contract functions, for example the balanceOf for an ERC-20 contract.

Parameters

1. Object - The transaction call object
   • from: DATA, 20 Bytes - (optional) The address the transaction is sent from.
   • to: DATA, 20 Bytes - The address the transaction is directed to.
   • gas: QUANTITY - (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
   • gasPrice: QUANTITY - (optional) Integer of the gasPrice used for each paid gas
   • value: QUANTITY - (optional) Integer of the value sent with this transaction
   • input: DATA - (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI in the Solidity documentation.
2. QUANTITY|TAG - integer block number, or the string "latest", "earliest" or "pending", see the default block parameter.

Returns

DATA - the return value of executed contract.