DOCUMENTATION
import SigDescription from "./sig-descriptionx"; import WalletOptions from "../../reference/common/wallet-optionsx"; import RpcOptions from "../../reference/common/rpc-optionsx"; import EtherscanOptions from "../../reference/common/etherscan-optionsx"; import CommonOptions from "./common-optionsx";
cast call
NAME
cast-call - Perform a call on an account without publishing a transaction.
SYNOPSIS
cast call
[options] to sig [args...]
DESCRIPTION
Perform a call on an account without publishing a transaction.
The destination (to) can be an ENS name or an address.
<SigDescription />OPTIONS
--trace
Prints traces for the transaction.
--debug
Opens an interactive debugger with the transaction. Needs --trace
.
--labels <address:label>
Labels to apply to the traces, with the format address:label
. Needs --trace
.
--evm-version
The EVM version to use. Needs --trace
.
--data
data
Allows setting the data field directly without providing
sig [args…].
Data needs to be in hexadecimal format.
Query Options
-B
block
--block
block
The block height you want to query at.
Can be a block number, or any of the tags: earliest
, finalized
, safe
, latest
or pending
.
EXAMPLES
-
Call
balanceOf(address)
on the WETH contract:cast call 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \ "balanceOf(address)(uint256)" 0x...
-
Call
tokenURI(uint256)(string)
on the Tubby Cats NFT contract:export CONTRACT=0xca7ca7bcc765f77339be2d648ba53ce9c8a262bd export TOKEN_ID=19938 cast call $CONTRACT "tokenURI(uint256)(string)" $TOKEN_ID
-
Call
getAmountsOut(uint,address[])
on the Uniswap v2 router contract:cast call 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D \ "getAmountsOut(uint,address[])" 1 "[0x6b...0f,0xc0...c2]"