eth_call - Somnia

Example code for the eth_call JSON-RPC method. Complete guide on how to use eth_call JSON-RPC in GetBlock Web3 documentation.

This method executes a new message call immediately without creating a transaction on the blockchain. This is commonly used for reading data from smart contracts, simulating transactions, and querying contract state on the Somnia network.

Parameters

Parameter	Type	Required	Description
transaction	object	Yes	Transaction call object
blockNumber	string	Yes	Block number in hex, or "latest", "earliest", "pending"

Transaction Object

Field	Type	Required	Description
from	string	No	Sender address
to	string	Yes	Contract address
gas	string	No	Gas limit
gasPrice	string	No	Gas price
value	string	No	Value to send
data	string	No	Encoded function call

Returns

Field	Type	Description
result	string	Return data from the call

Request Example

cURL

curl

curl -X POST https://go.getblock.io/<ACCESS-TOKEN>/ \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "method": "eth_call",
  "params": [
    {
      "to": "0xContractAddress",
      "data": "0x70a08231000000000000000000000000742d35cc6634c0532925a3b844bc9e7595f8bb45"
    },
    "latest"
  ]
}'

JavaScript (Axios)

Python

Rust

Response Example

{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "result": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000"
}

Response Parameters

Parameter	Type	Description
result	string	ABI-encoded return value

Use Cases

• Read ERC-20 token balances

• Query contract state

• Simulate transactions before sending

• Get NFT metadata

• Check allowances and approvals

Error Handling

Error Code	Description
-32602	Invalid params - malformed call object
-32603	Internal error - execution reverted
-32000	Execution error - contract revert

SDK Integration

Ethers.js

ethers.js

const { ethers } = require('ethers');

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const erc20Abi = ['function balanceOf(address) view returns (uint256)'];
const contract = new ethers.Contract('0xContractAddress', erc20Abi, provider);

const balance = await contract.balanceOf('0x742d35Cc6634C0532925a3b844Bc9e7595f8bB45');
console.log(ethers.formatEther(balance));

Viem