Struct PreStateArgs 

pub struct PreStateArgs {
    pub fork: bool,
    pub fork_block: Option<u64>,
    pub prestate: Option<PathBuf>,
    pub block_hashes: Vec<String>,
    pub sender_balance: Option<String>,
    pub faucet: Vec<String>,
    pub balance: Vec<String>,
    pub storage: Vec<String>,
}

Pre-execution state configuration arguments

Fields

fork: bool

Fork state from a remote RPC endpoint.

fork_block: Option<u64>

Block number of the state (post-block state) to fork from. If not specified, the latest block is used. Only used if fork is true.

prestate: Option<PathBuf>

JSON file with prestate (genesis) config. This overrides the state in the forked remote state (if applicable).

block_hashes: Vec<String>

History block hashes to serve BLOCKHASH opcode. This overrides the block hashes in the forked remote state (if applicable). Each entry should be in the format block_number:block_hash (can be repeated).

sender_balance: Option<String>

Balance to allocate to the sender account. VALUE can be: plain number (wei), or number with suffix (ether, gwei, wei). Examples: --sender.balance 1ether, --sender.balance 1000000000000000000 If not specified, sender balance is not set (fallback to prestate if specified, otherwise 0)

faucet: Vec<String>

Add ether to specified addresses. Each entry format: ADDRESS+=VALUE VALUE can be: plain number (wei), or number with suffix (ether, gwei, wei). Examples: --faucet 0x1234+=100ether, --faucet 0x5678+=1000000gwei Can be repeated for multiple addresses.

balance: Vec<String>

Override balance for specified addresses. Each entry format: ADDRESS=VALUE VALUE can be: plain number (wei), or number with suffix (ether, gwei, wei). Examples: --balance 0x1234=100ether

storage: Vec<String>

Override storage slots. Each entry format: ADDRESS:SLOT=VALUE SLOT and VALUE are U256 (hex or decimal). Examples: --storage 0x1234:0x0=0x1

Implementations

impl PreStateArgs

pub fn parse_block_hashes(&self) -> Result<HashMap<u64, B256>>

Parse block hashes from CLI arguments.

Each entry should be in the format block_number:block_hash.

pub fn parse_faucet(&self) -> Result<Vec<(Address, U256)>>

Parse faucet entries from CLI arguments.

Each entry should be in the format ADDRESS+=VALUE. VALUE can be: plain number (wei), or number with suffix (ether, gwei, wei).

pub fn parse_balance(&self) -> Result<Vec<(Address, U256)>>

Parse balance override entries from CLI arguments.

Each entry should be in the format ADDRESS=VALUE. VALUE can be: plain number (wei), or number with suffix (ether, gwei, wei).

pub fn parse_storage(&self) -> Result<Vec<(Address, U256, U256)>>

Parse storage override entries from CLI arguments.

Each entry should be in the format ADDRESS:SLOT=VALUE. SLOT and VALUE are U256 (hex or decimal).

pub fn load_prestate(&self, sender: &Address) -> Result<EvmState>

Load prestate as EvmState from file if provided

pub async fn create_initial_state( &self, sender: &Address, rpc_args: &RpcArgs, ) -> Result<(EvmeState<Optimism, OpProvider>, RpcCacheStore)>

Build the initial execution state and the clean-exit RPC cache store.

Fork mode (self.fork == true) builds a forked state at self.fork_block via rpc_args.build_provider() and returns the caller-owned RpcCacheStore for persist-on-exit. Non-fork mode builds an empty local state, ignores rpc_args, and returns a no-op store. Either way the call site persists unconditionally.

Trait Implementations

impl Args for PreStateArgs

fn group_id() -> Option<Id>

Report the 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 Clone for PreStateArgs

fn clone(&self) -> PreStateArgs

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CommandFactory for PreStateArgs

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 PreStateArgs

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

Formats the value using the given formatter.

impl FromArgMatches for PreStateArgs

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 PreStateArgs

fn parse() -> Self

Parse from std::env::args_os(), 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 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 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.