Struct FoundryArtifact 

pub struct FoundryArtifact {
    pub path: PathBuf,
    pub creation_code: Bytes,
}

A Foundry JSON artifact with decoded creation bytecode.

Fields

path: PathBuf

Path the artifact was loaded from.

creation_code: Bytes

Creation bytecode from bytecode.object.

Implementations

impl FoundryArtifact

pub fn load(path: impl AsRef<Path>) -> Result<Self>

Load a Foundry JSON artifact from disk.

Supports the standard Foundry shape: { "bytecode": { "object": "0x..." } }.

The legacy direct string shape { "bytecode": "0x..." } is also accepted to make tests and generated artifacts easier to reuse.

Errors

Returns an error if the file cannot be read, is not valid JSON, lacks a usable bytecode/bytecode.object field, or contains bytecode that is empty, not valid hex, or still has unresolved library placeholders (see load_foundry_creation_code).

pub fn init_code(&self, constructor_args: impl AsRef<[u8]>) -> Bytes

Build init code by appending ABI-encoded constructor arguments to the artifact’s creation bytecode.

pub fn deploy( &self, cache: &mut EvmCache, deployer: Address, constructor_args: impl AsRef<[u8]>, ) -> Result<Address>

Deploy this artifact into the forked EVM and return the temporary deployed address.

constructor_args must already be ABI encoded. Use encode_constructor_args for ordinary Solidity constructor tuples.

Errors

Returns an error if the CREATE transaction reverts or halts, or if the deployment otherwise fails to produce a deployed address (see EvmCache::deploy_contract).

Panics

Like any method that may fetch missing state, this must run on a multi-thread tokio runtime; deploying on a current-thread runtime panics when the fork DB attempts a synchronous RPC fetch.

pub fn etch( &self, cache: &mut EvmCache, target: Address, deployer: Address, constructor_args: impl AsRef<[u8]>, ) -> Result<EtchedContract>

Deploy this artifact and copy its runtime bytecode to target.

This is equivalent to a simulation-friendly vm.etch for contracts with constructor-initialized immutables: the temporary deployment computes the final runtime bytecode, and target keeps its existing storage, balance, and nonce. target must already have non-empty runtime bytecode.

On any error the cache is restored to its pre-deploy snapshot, so a failed etch leaves no partial deployment behind.

Errors

Returns an error if target is missing or has no runtime bytecode, if the deployment reverts or halts (see Self::deploy), or if copying the runtime bytecode to target fails.

Panics

Must run on a multi-thread tokio runtime; the underlying deployment panics on a current-thread runtime when the fork DB attempts a synchronous RPC fetch.

pub fn etch_or_create( &self, cache: &mut EvmCache, target: Address, deployer: Address, constructor_args: impl AsRef<[u8]>, ) -> Result<EtchedContract>

Deploy this artifact and copy its runtime bytecode to target, creating a default target account when it does not already exist.

Use this only for synthetic simulation addresses where there is no storage, balance, or nonce to preserve.

On any error the cache is restored to its pre-deploy snapshot, so a failed etch leaves no synthetic target account behind.

Errors

Returns an error if the deployment reverts or halts (see Self::deploy), or if copying the runtime bytecode to target fails (for example when the deployed contract has empty runtime bytecode).

Panics

Must run on a multi-thread tokio runtime; the underlying deployment panics on a current-thread runtime when the fork DB attempts a synchronous RPC fetch.

Trait Implementations

impl Clone for FoundryArtifact

fn clone(&self) -> FoundryArtifact

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FoundryArtifact

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

Formats the value using the given formatter.