Struct RpcArgs 

pub struct RpcArgs {
    pub rpc_url: Option<String>,
    pub capture_file: Option<PathBuf>,
    pub replay_file: Option<PathBuf>,
    pub cache_size: u32,
    pub cache_dir: Option<PathBuf>,
    pub no_cache_file: bool,
    pub clear_cache: bool,
    pub max_retries: u32,
    pub backoff_ms: u64,
    pub compute_units_per_sec: u64,
}

Configuration for building an RPC provider.

Fields

rpc_url: Option<String>

RPC URL. Required for networked operation (replay, run –fork, tx –fork).

capture_file: Option<PathBuf>

Capture JSON-RPC responses to a single file for later offline replay. Requires --rpc. If the file already exists, its entries are loaded and merged; missing entries are fetched via the RPC endpoint and persisted on clean exit. Cannot be used with –rpc.replay-file, –rpc.cache-dir, –rpc.clear-cache, –rpc.no-cache-file, or –rpc.cache-size.

replay_file: Option<PathBuf>

Replay from a previously captured JSON-RPC fixture file (offline). Cannot be used with --rpc. Any RPC miss is a hard error; the file is never written. Cannot be used with –rpc.capture-file, –rpc.cache-dir, –rpc.clear-cache, –rpc.no-cache-file, or –rpc.cache-size.

cache_size: u32

Maximum number of items to keep in the in-memory RPC LRU cache. Set to 0 to disable the cache layer entirely.

cache_dir: Option<PathBuf>

Directory for per-chain RPC cache files.

Each chain’s cache is stored as {cache_dir}/rpc-cache-{chain_id}.json. Different chains cannot share a file, so cross-chain contamination is impossible by construction.

Defaults to the platform cache directory ($XDG_CACHE_HOME/mega-evme/rpc on Linux, ~/Library/Caches/mega-evme/rpc on macOS). Pass --rpc.no-cache-file to disable on-disk persistence entirely.

no_cache_file: bool

Disable on-disk cache persistence. The in-memory LRU cache still applies — use --rpc.cache-size 0 to disable that too.

clear_cache: bool

Delete the current chain’s cache file before loading it. Recovery path for a polluted or corrupt cache file. If the unlink itself fails (e.g. insufficient permissions), mega-evme aborts rather than silently reloading the stale file.

max_retries: u32

Maximum number of times the transport layer will retry a failing RPC request. Retries trigger on HTTP 429 / 503, JSON-RPC rate-limit error responses, and transport failures surfaced as TransportErrorKind::Custom (connection refused, DNS failure, TLS handshake, etc.). Set to 0 to disable retries entirely.

backoff_ms: u64

Fixed sleep duration, in milliseconds, inserted between retry attempts unless the server supplies its own backoff hint. This layer does not perform exponential backoff.

compute_units_per_sec: u64

Compute units per second budget passed to the retry layer’s rate-limit accounting.

Implementations

impl RpcArgs

pub async fn build_provider(&self) -> Result<BuildProviderOutput>

Build an RPC provider using --rpc <URL> with the standard --rpc.cache-dir path.

Used by replay (online), run --fork, and tx --fork. Requires rpc_url to be Some — callers validate this before calling. For offline replay and capture mode, use Self::build_replay_provider and Self::build_capture_provider.

pub async fn build_replay_provider(&self) -> Result<BuildProviderOutput>

Build the provider in replay mode (--rpc.replay-file without --rpc).

Loads the envelope’s transport-level cache and builds the provider over [ReplayTransport], which serves cached responses directly and returns a descriptive error on cache miss. No CacheLayer is used — all caching is at the transport level so every RPC method is covered.

pub async fn build_capture_provider(&self) -> Result<BuildProviderOutput>

Build the provider in capture mode (--rpc.capture-file + --rpc).

If the capture file already exists, its entries are loaded into the transport- level cache. Missing entries are fetched via the HTTP transport (with retry), cached in-memory, and persisted as an envelope on clean exit. No CacheLayer is used — all caching is at the transport level so every RPC method is covered.

Trait Implementations

impl Args for RpcArgs

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 RpcArgs

fn clone(&self) -> RpcArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for RpcArgs

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 RpcArgs

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

Formats the value using the given formatter.

impl FromArgMatches for RpcArgs

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 RpcArgs

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.