Module utils 

Modules

abi 🔒

allocator 🔒

Abstract global allocator implementation.

cmd 🔒

suggestions 🔒

Helper functions for suggesting alternative values for a possibly erroneous user input.

tempo 🔒

Tempo utilities: fee token parsing and named nonce lanes (2D nonces).

Structs

Git

ResolvedLane

Result of resolving a --tempo.lane <name> argument against a lanes file.

Submodule

Deserialized git submodule status lib/dep output.

Submodules

Deserialized git submodule status output.

TraceResult

A slimmed down return from the executor used for returning minimal trace + gas metering info

Constants

DEFAULT_LANES_FILE

Default name of the lanes file at the project root.

STATIC_FUZZ_SEED

Deterministic fuzzer seed used for gas snapshots and coverage reports.

Statics

SUBMODULE_BRANCH_REGEX

Regex used to parse .gitmodules file and capture the submodule path and branch.

SUBMODULE_STATUS_REGEX

Regex used to parse git submodule status output.

Traits

CommandUtils

Useful extensions to std::process::Command.

FoundryPathExt

Useful extensions to std::path::Path.

LoadConfig

Helpers for loading configuration.

Functions

cache_local_signatures

Traverse the artifacts in the project to generate local signatures and merge them into the cache file.

cache_signatures_from_abis

Traverses all files at folder_path, parses any JSON ABI files found, and caches their function/event/error signatures to the local signatures cache.

common_setup

Common setup for all CLI tools. Does not include tracing subscriber.

did_you_mean

Filters multiple strings from a given list of possible values which are similar to the passed in value v within a certain confidence by least confidence.

enable_paint

Sets the default [yansi] color output condition.

ensure_clean_constructor

Returns error if constructor has arguments.

env_filter 🔒

eta_key

fetch_abi_from_etherscan

Fetches the ABI of a contract from Etherscan.

find_contract_artifacts

Given a Project’s output, finds the contract by path and name and returns its ABI, creation bytecode, and ArtifactId.

get_chain

get_provider

Returns a [RootProvider] instantiated using [Config]’s RPC settings.

get_provider_builder

Returns a [ProviderBuilder] instantiated using [Config] values.

has_batch_support

True if it supports broadcasting in batches.

has_different_gas_calc

True if the network calculates gas costs differently.

init_progress

install_crypto_provider

This force installs the default crypto provider.

load_dotenv

Loads a dotenv file, from the cwd and the project root, ignoring potential failure.

load_lanes

Loads a TOML lanes file from path.

maybe_print_resolved_lane

Prints lane: <name> (nonce_key=<key>, nonce=<n>) to stderr (so it doesn’t pollute stdout for commands like cast mktx whose stdout is meant to be piped), giving visibility into which 2D nonce lane was used.

needs_setup

new_allocator

Creates a new allocator.

now

Returns the current time as a Duration since the Unix epoch.

parse_delay

Parses a Duration from a &str

parse_ether_value

Parses an ether value from a string.

parse_fee_token_address

Parses a fee token address.

parse_function_args

parse_json

Parses a T from a string using serde_json::from_str.

print_traces

read_constructor_args_file

Read contract constructor arguments from the given file.

resolve_lane

Resolves opts.lane against a lanes file and writes the resulting nonce_key to opts.nonce_key. Returns the resolved lane (or None if no --tempo.lane was set).

subscriber

Initializes a tracing Subscriber for logging

Type Aliases

Allocator