## cast call Perform a call on an account without publishing a transaction :::terminal ```bash $ cast call --help ``` ````txt Usage: cast call [OPTIONS] [TO] [SIG] [ARGS]... [COMMAND] Commands: --create ignores the address field and simulates creating a contract help Print this message or the help of the given subcommand(s) Arguments: [TO] The destination of the transaction [SIG] The signature of the function to call [ARGS]... The arguments of the function to call Options: --data Raw hex-encoded data for the transaction. Used instead of \[SIG\] and \[ARGS\] --trace Forks the remote rpc, executes the transaction locally and prints a trace --disable-labels Disables the labels in the traces. Can only be set with `--trace` --debug Opens an interactive debugger. Can only be used with `--trace` --decode-internal Identify internal functions in traces. This will trace internal functions and decode stack parameters. Parameters stored in memory (such as bytes or arrays) are currently decoded only when a single function is matched, similarly to `--debug`, for performance reasons. --labels Labels to apply to the traces; format: `address:label`. Can only be used with `--trace` --evm-version The EVM Version to use. Can only be used with `--trace` -b, --block The block height to query at. Can also be the tags earliest, finalized, safe, latest, or pending. -h, --help Print help (see a summary with '-h') -j, --threads Number of threads to use. Specifying 0 defaults to the number of logical cores [aliases: --jobs] Transaction options: --gas-limit Gas limit for the transaction [env: ETH_GAS_LIMIT=] --gas-price Gas price for legacy transactions, or max fee per gas for EIP1559 transactions, either specified in wei, or as a string with a unit type. Examples: 1ether, 10gwei, 0.01ether [env: ETH_GAS_PRICE=] --priority-gas-price Max priority fee per gas for EIP1559 transactions [env: ETH_PRIORITY_GAS_PRICE=] --value Ether to send in the transaction, either specified in wei, or as a string with a unit type. Examples: 1ether, 10gwei, 0.01ether --nonce Nonce for the transaction --legacy Send a legacy transaction instead of an EIP1559 transaction. This is automatically enabled for common networks without EIP1559. --blob Send a blob transaction using EIP-7594 (PeerDAS) format. Note: Use with `--eip4844` for the legacy EIP-4844 format. --eip4844 Send a blob transaction using EIP-4844 (legacy) format instead of EIP-7594. Must be used with `--blob` --blob-gas-price Gas price for EIP-7594/EIP-4844 blob transaction [env: ETH_BLOB_GAS_PRICE=] --auth EIP-7702 authorization list. Can be either a hex-encoded signed authorization or an address. --access-list [] EIP-2930 access list. Accepts either a JSON-encoded access list or an empty value to create the access list via an RPC call to `eth_createAccessList`. To retrieve only the access list portion, use the `cast access-list` command. Tempo: --tempo.fee-token Fee token address for Tempo transactions. When set, builds a Tempo (type 0x76) transaction that pays gas fees in the specified token. If this is not set, the fee token is chosen according to network rules. See the Tempo docs for more information. --tempo.expires Opt into TIP-1009 expiring-nonce mode with a validity window. Convenience flag that combines `--tempo.expiring-nonce` with a relative `--tempo.valid-before`. Sets nonce_key = U256::MAX, nonce = 0, and valid_before = now + seconds. Maximum value is 30 seconds. The transaction must be mined before the deadline or it becomes permanently invalid, giving safe retry semantics: retries produce a fresh tx hash and the old tx can never land late. --tempo.nonce-key Nonce key for Tempo parallelizable nonces. When set, builds a Tempo (type 0x76) transaction with the specified nonce key, allowing multiple transactions with the same nonce but different keys to be executed in parallel. If not set, the protocol nonce key (0) will be used. For more information see [https://docs.tempo.xyz/protocol/transactions/spec-tempo-transaction#parallelizable-nonces](https://docs.tempo.xyz/protocol/transactions/spec-tempo-transaction#parallelizable-nonces). --tempo.lane Named nonce lane for Tempo parallelizable nonces. Resolves a friendly lane name (e.g. `deploy`, `payments`) to a `nonce_key` via a shared lanes file (default: `tempo.lanes.toml` at the project root). The lanes file is a TOML map of `name = ` entries, e.g.: ```toml deploy = 1 ops = 2 payments = 3 ``` Mutually exclusive with `--tempo.nonce-key`. --tempo.lanes-file Path to the Tempo lanes file used by `--tempo.lane`. Defaults to `tempo.lanes.toml` at the project root. --tempo.sponsor
Sponsor (fee payer) address for Tempo sponsored transactions --tempo.sponsor-signer Sign Tempo sponsor digests in-band with the given signer URI. Supported forms include `env://VAR`, `keystore://PATH`, `account://NAME`, `ledger://`, `trezor://`, `aws://`, `gcp://`, `turnkey://`, and `private-key://KEY`. --tempo.sponsor-sig Sponsor (fee payer) signature for Tempo sponsored transactions. The sponsor signs the `fee_payer_signature_hash` to commit to paying gas fees on behalf of the sender. Provide as a hex-encoded signature. --tempo.print-sponsor-hash Print the sponsor signature hash and exit. Computes the `fee_payer_signature_hash` for the transaction so that a sponsor knows what hash to sign. The transaction is not sent. --tempo.key-id Access key ID for Tempo Keychain signature transactions. Used during gas estimation to override the key_id that would normally be recovered from the signature. --tempo.expiring-nonce Enable expiring nonce mode for Tempo transactions. Sets nonce to 0 and nonce_key to U256::MAX, enabling time-bounded transaction validity via `--tempo.valid-before` and `--tempo.valid-after`. --tempo.valid-before Upper bound timestamp for Tempo expiring nonce transactions. The transaction is only valid before this unix timestamp. Requires `--tempo.expiring-nonce`. --tempo.valid-after Lower bound timestamp for Tempo expiring nonce transactions. The transaction is only valid after this unix timestamp. Requires `--tempo.expiring-nonce`. Rpc options: -r, --rpc-url The RPC endpoint [aliases: --fork-url] -k, --insecure Allow insecure RPC connections (accept invalid HTTPS certificates). When the provider's inner runtime transport variant is HTTP, this configures the reqwest client to accept invalid certificates. --rpc-timeout Timeout for the RPC request in seconds. The specified timeout will be used to override the default timeout for RPC requests. Default value: 45 [env: ETH_RPC_TIMEOUT=] --no-proxy Disable automatic proxy detection. Use this in sandboxed environments (e.g., Cursor IDE sandbox, macOS App Sandbox) where system proxy detection causes crashes. When enabled, HTTP_PROXY/HTTPS_PROXY environment variables and system proxy settings will be ignored. --compute-units-per-second Sets the number of assumed available compute units per second for this provider. default value: 330 See also [https://docs.alchemy.com/reference/compute-units#what-are-cups-compute-units-per-second](https://docs.alchemy.com/reference/compute-units#what-are-cups-compute-units-per-second) --no-rpc-rate-limit Disables rate limiting for this node's provider. See also [https://docs.alchemy.com/reference/compute-units#what-are-cups-compute-units-per-second](https://docs.alchemy.com/reference/compute-units#what-are-cups-compute-units-per-second) [aliases: --no-rate-limit] --flashbots Use the Flashbots RPC URL with fast mode ([https://rpc.flashbots.net/fast](https://rpc.flashbots.net/fast)). This shares the transaction privately with all registered builders. See: [https://docs.flashbots.net/flashbots-protect/quick-start#faster-transactions](https://docs.flashbots.net/flashbots-protect/quick-start#faster-transactions) --jwt-secret JWT Secret for the RPC endpoint. The JWT secret will be used to create a JWT for a RPC. For example, the following can be used to simulate a CL `engine_forkchoiceUpdated` call: cast rpc --jwt-secret engine_forkchoiceUpdatedV2 '["0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc", "0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc", "0x6bb38c26db65749ab6e472080a3d20a2f35776494e72016d1e339593f21c59bc"]' [env: ETH_RPC_JWT_SECRET=] --rpc-headers Specify custom headers for RPC requests [env: ETH_RPC_HEADERS=] --curl Print the equivalent curl command instead of making the RPC request Wallet options - raw: -f, --from
The sender account [env: ETH_FROM=] -i, --interactive Open an interactive prompt to enter your private key --private-key Use the provided private key --mnemonic Use the mnemonic phrase of mnemonic file at the specified path --mnemonic-passphrase Use a BIP39 passphrase for the mnemonic --mnemonic-derivation-path The wallet derivation path. Works with both --mnemonic-path and hardware wallets. --mnemonic-index Use the private key from the given mnemonic index. Used with --mnemonic-path. [default: 0] -c, --chain [env: CHAIN=] --with-local-artifacts Use current project artifacts for trace decoding [aliases: --la] --override-balance Override the accounts balance. Format: "address:balance,address:balance" --override-nonce Override the accounts nonce. Format: "address:nonce,address:nonce" --override-code Override the accounts code. Format: "address:code,address:code" --override-state Override the accounts state and replace the current state entirely with the new one. Format: "address:slot:value,address:slot:value" --override-state-diff Override the accounts state specific slots and preserve the rest of the state. Format: "address:slot:value,address:slot:value" --block.time