eth_call - Pulsechain RPC Method
Execute smart contract calls without creating transactions on Pulsechain. Essential for reading contract state for low-cost DeFi, staking protocols, and Ethereum-compatible dApps with reduced fees.
Executes a new message call immediately without creating a transaction on Pulsechain. Used for reading smart contract state.
Why Pulsechain? Build on the Ethereum fork L1 with lower gas fees and proof-of-stake consensus with full Ethereum state fork, proof-of-stake consensus, lower gas fees than Ethereum mainnet, and PulseX DEX ecosystem.
Use Cases
The eth_call method is essential for:
- Reading contract state - Query view/pure functions
- Simulating transactions - Test execution without gas costs
- DeFi integrations - Check prices, balances, allowances for low-cost DeFi, staking protocols, and Ethereum-compatible dApps with reduced fees
- Complex queries - Execute multi-step contract logic
Request Parameters
20-byte address executing the call
20-byte contract address
Gas limit for the call
Gas price in wei
Value to send in wei
Encoded function call data
Block number or tag
Response Body
The return value of the executed contract function
Code Examples
# Call ERC20 balanceOf function
curl -X POST https://api-pulse-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_call",
"params": [{
"to": "0xA1077a294dDE1B09bB078844df40758a5D0f9a27",
"data": "0x70a08231000000000000000000000000A1077a294dDE1B09bB078844df40758a5D0f9a27"
}, "latest"],
"id": 1
}'import { JsonRpcProvider, Contract } from 'ethers';
const provider = new JsonRpcProvider('https://api-pulse-mainnet.n.dwellir.com/YOUR_API_KEY');
// ERC20 ABI for common functions
const ERC20_ABI = [
"function balanceOf(address owner) view returns (uint256)",
"function allowance(address owner, address spender) view returns (uint256)",
"function totalSupply() view returns (uint256)",
"function decimals() view returns (uint8)",
"function symbol() view returns (string)"
];
// Read ERC20 token balance
async function getTokenBalance(tokenAddress, walletAddress) {
const contract = new Contract(tokenAddress, ERC20_ABI, provider);
const balance = await contract.balanceOf(walletAddress);
const decimals = await contract.decimals();
const symbol = await contract.symbol();
return {
raw: balance.toString(),
formatted: (Number(balance) / Math.pow(10, decimals)).toFixed(4),
symbol: symbol
};
}
// Direct eth_call
async function directCall(to, data) {
const result = await provider.call({ to, data });
return result;
}from web3 import Web3
w3 = Web3(Web3.HTTPProvider('https://api-pulse-mainnet.n.dwellir.com/YOUR_API_KEY'))
def get_erc20_balance(token_address, wallet_address):
# balanceOf(address) selector
function_signature = "balanceOf(address)"
function_selector = w3.keccak(text=function_signature)[:4].hex()
# Encode address parameter
encoded_address = wallet_address[2:].lower().zfill(64)
data = function_selector + encoded_address
# Make the call
result = w3.eth.call({
'to': token_address,
'data': data
})
return int(result.hex(), 16)
balance = get_erc20_balance(
'0xA1077a294dDE1B09bB078844df40758a5D0f9a27',
'0xA1077a294dDE1B09bB078844df40758a5D0f9a27'
)
print(f'Balance: {balance}')package main
import (
"context"
"fmt"
"log"
"github.com/ethereum/go-ethereum"
"github.com/ethereum/go-ethereum/common"
"github.com/ethereum/go-ethereum/ethclient"
)
func main() {
client, err := ethclient.Dial("https://api-pulse-mainnet.n.dwellir.com/YOUR_API_KEY")
if err != nil {
log.Fatal(err)
}
contractAddress := common.HexToAddress("0xA1077a294dDE1B09bB078844df40758a5D0f9a27")
data := common.FromHex("0x70a08231000000000000000000000000A1077a294dDE1B09bB078844df40758a5D0f9a27")
msg := ethereum.CallMsg{
To: &contractAddress,
Data: data,
}
result, err := client.CallContract(context.Background(), msg, nil)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Result: 0x%x\n", result)
}Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32000 | Execution reverted | Contract function reverted |
| -32602 | Invalid parameters | Invalid data encoding |
| -32015 | VM execution error | Contract logic error |
Related Methods
eth_estimateGas- Estimate gas for transactioneth_sendRawTransaction- Send actual transaction
eth_feeHistory - Pulsechain RPC Method
Get historical gas fee data on Pulsechain. Essential for fee prediction for low-cost DeFi, staking protocols, and Ethereum-compatible dApps with reduced fees.
eth_getLogs - Pulsechain RPC Method
Query event logs on Pulsechain. Essential for indexing low-cost DeFi, staking protocols, and Ethereum-compatible dApps with reduced fees on the Ethereum fork L1 with lower gas fees and proof-of-stake consensus.