starknet_call

Executes a function call on a Cairo smart contract without creating a transaction on the blockchain.

Parameters

Parameter	Type	Description
request	object	Function call details with contract_address (felt252), entry_point_selector (felt252), and calldata (felt252[])
block_id	string	Block reference: "latest", "l1_accepted", block hash, or block number

Request

{
  "jsonrpc": "2.0",
  "method": "starknet_call",
  "params": [
    {
      "contract_address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
      "entry_point_selector": "0x2e4263afad30923c891518314c3c95dbe830a16874e8abc5777a9a20b54c76e",
      "calldata": ["0x1234567890abcdef1234567890abcdef12345678"]
    },
    "latest"
  ],
  "id": 1
}

Returns

ARRAY - Array of field elements returned by the function call.

Examples

cURL

curl -X POST https://api-starknet-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "starknet_call",
    "params": [
      {
        "contract_address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
        "entry_point_selector": "0x2e4263afad30923c891518314c3c95dbe830a16874e8abc5777a9a20b54c76e",
        "calldata": ["0x1234567890abcdef1234567890abcdef12345678"]
      },
      "latest"
    ],
    "id": 1
  }'

JavaScript

import { RpcProvider } from 'starknet';

const provider = new RpcProvider({
  nodeUrl: 'https://api-starknet-mainnet.n.dwellir.com/YOUR_API_KEY'
});

const result = await provider.callContract({
  contractAddress: '0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7',
  entrypoint: 'balanceOf',
  calldata: ['0x1234567890abcdef1234567890abcdef12345678']
});

Python

from starknet_py.net.full_node_client import FullNodeClient

client = FullNodeClient(
    node_url="https://api-starknet-mainnet.n.dwellir.com/YOUR_API_KEY"
)

result = await client.call_contract(
    call={
        "contract_address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
        "entry_point_selector": "balanceOf",
        "calldata": ["0x1234567890abcdef1234567890abcdef12345678"]
    },
    block_id="latest"
)