Struct CallArgs 

pub struct CallArgs {

    to: Option<NameOrAddress>,
    sig: Option<String>,
    args: Vec<String>,
    data: Option<String>,
    trace: bool,
    disable_labels: bool,
    debug: bool,
    decode_internal: bool,
    labels: Vec<String>,
    evm_version: Option<EvmVersion>,
    block: Option<BlockId>,
    command: Option<CallSubcommands>,
    tx: TransactionOpts,
    eth: EthereumOpts,
    pub with_local_artifacts: bool,
    pub balance_overrides: Option<Vec<String>>,
    pub nonce_overrides: Option<Vec<String>>,
    pub code_overrides: Option<Vec<String>>,
    pub state_overrides: Option<Vec<String>>,
    pub state_diff_overrides: Option<Vec<String>>,
    pub block_time: Option<u64>,
    pub block_number: Option<u64>,
}

CLI arguments for cast call.

State Override Flags

The following flags can be used to override the state for the call:

• --override-balance <address>:<balance> - Override the balance of an account
• --override-nonce <address>:<nonce> - Override the nonce of an account
• --override-code <address>:<code> - Override the code of an account
• --override-state <address>:<slot>:<value> - Override a storage slot of an account

Multiple overrides can be specified for the same account. For example:

cast call 0x... "transfer(address,uint256)" 0x... 100 \
  --override-balance 0x123:0x1234 \
  --override-nonce 0x123:1 \
  --override-code 0x123:0x1234 \
  --override-state 0x123:0x1:0x1234
  --override-state-diff 0x123:0x1:0x1234

Fields

to: Option<NameOrAddress>

The destination of the transaction.

sig: Option<String>

The signature of the function to call.

args: Vec<String>

The arguments of the function to call.

data: Option<String>

Raw hex-encoded data for the transaction. Used instead of [SIG] and [ARGS].

trace: bool

Forks the remote rpc, executes the transaction locally and prints a trace

disable_labels: bool

Disables the labels in the traces. Can only be set with --trace.

debug: bool

Opens an interactive debugger. Can only be used with --trace.

decode_internal: bool

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: Vec<String>

Labels to apply to the traces; format: address:label. Can only be used with --trace.

evm_version: Option<EvmVersion>

The EVM Version to use. Can only be used with --trace.

block: Option<BlockId>

The block height to query at.

Can also be the tags earliest, finalized, safe, latest, or pending.

command: Option<CallSubcommands>

tx: TransactionOpts

eth: EthereumOpts

with_local_artifacts: bool

Use current project artifacts for trace decoding.

balance_overrides: Option<Vec<String>>

Override the accounts balance. Format: “address:balance,address:balance”

nonce_overrides: Option<Vec<String>>

Override the accounts nonce. Format: “address:nonce,address:nonce”

code_overrides: Option<Vec<String>>

Override the accounts code. Format: “address:code,address:code”

state_overrides: Option<Vec<String>>

Override the accounts state and replace the current state entirely with the new one. Format: “address:slot:value,address:slot:value”

state_diff_overrides: Option<Vec<String>>

Override the accounts state specific slots and preserve the rest of the state. Format: “address:slot:value,address:slot:value”

block_time: Option<u64>

Override the block timestamp.

block_number: Option<u64>

Override the block number.

Implementations

impl CallArgs

pub async fn run(self) -> Result<()>

pub fn get_state_overrides(&self) -> Result<Option<StateOverride>>

Parse state overrides from command line arguments.

pub fn get_block_overrides(&self) -> Result<Option<BlockOverrides>>

Parse block overrides from command line arguments.

Trait Implementations

impl Args for CallArgs

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

impl CommandFactory for CallArgs

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for CallArgs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for CallArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for CallArgs

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::exit] on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, [exit][Error::exit] on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, [exit][Error::exit] on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.

impl Provider for CallArgs

fn metadata(&self) -> Metadata

Returns the [Metadata] for this provider, identifying itself and its configuration sources.

fn data(&self) -> Result<Map<Profile, Dict>, Error>

Returns the configuration data.

fn profile(&self) -> Option<Profile>

Optionally returns a profile to set on the Figment this provider is merged into. The profile is only set if self is merged.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1200 bytes