Skip to main content
EVM

eth_call

Summary: Execute a new message call

This request executes a new message call without creating a transaction on the blockchain. It allows you to invoke a contract function locally to interact with smart contracts and query data without modifying the blockchain state or consuming gas. eth_call is ideal for retrieving data, simulating transactions, or testing contract interactions.

Parameters

transaction object
required

Transaction object generic to all Linea-supported transactions. All transaction call object parameters are optional.

type enum

The transaction type as introduced in EIP-2718, in hexadecimal. Use:

  • 0x00 for LegacyTxType
  • 0x01 for AccessListTxType (EIP-2930)
  • 0x02 for DynamicFeeTxType (EIP-1559)

Enum:
"0x00"
"0x01"
"0x02"
nonce string

Account nonce; counter for the number of transactions sent from the account; for replay protection.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

to oneOf

Address of the action receiver.

Contract Creation (null) null

Contract Creation (null)

Address string

Hex-encoded address.

Pattern: ^0x[0-9a-fA-F]{40}$

from string

Address of the sender.

Pattern: ^0x[0-9a-fA-F]{40}$

gas string

Gas provided by the sender. eth_call consumes zero gas, but this schema supports other executions that might need this parameter. eth_estimateGas ignores this value.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

value string

Value to transfer in wei.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

input string

Input data; alternative term for data.

Pattern: ^0x[0-9a-f]*$

gasPrice string

The gas price the sender is willing to pay in wei. Used only in non-EIP-1559 transactions.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$
Default: 0x0

maxPriorityFeePerGas string

Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in EIP-1559 transactions. If used, must specify maxFeePerGas.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

maxFeePerGas string

Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in EIP-1559 transactions. If used, must specify maxPriorityFeePerGas.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

accessList array

EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.

object

Access list entry.

address string

Hex-encoded address.

Pattern: ^0x[0-9a-fA-F]{40}$

storageKeys array

string

32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

chainId string

Chain ID that this transaction is valid on.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

block anyOf

Block number, block hash, or string tag.

Block number string

Block number in hexadecimal.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Block tag enum

See the default block parameter.

  • earliest: The lowest numbered block the client has available.
  • latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
  • pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool.

Enum:
"earliest"
"latest"
"pending"
Block hash string

32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

Returns

Note that, an execution reverted message suggests that the transaction would fail on-chain or that the contract logic has conditions that aren't met when simulating the transaction.
eth_callResponse string

Note that, an execution reverted message suggests that the transaction would fail on-chain or that the contract logic has conditions that aren't met when simulating the transaction.

Pattern: ^0x[0-9a-f]*$

Customize request
Parameter
Value
enum
  • 0x00
  • 0x01
  • 0x02
string
0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f
oneOf
  • Contract Creation (null)
  • Address
string
string
string
string
string
string
string
[]
array
string
0x980a20
anyOf
  • Block number
  • Block tag
  • Block hash
Request
curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{"to":"0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f","input":"0x18160ddd"},"0x980a20"],
    "id": 1
  }'
Example response
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x00000000000000000000000000000000000000000000070083c753e38b19336e"
}