Struct RawCallResult 

pub struct RawCallResult<FEN = EthEvmNetwork>
where
    FEN: FoundryEvmNetwork,
{

    pub exit_reason: Option<InstructionResult>,
    pub execution_cancelled: bool,
    pub reverted: bool,
    pub has_state_snapshot_failure: bool,
    pub result: Bytes,
    pub gas_used: u64,
    pub gas_refunded: u64,
    pub stipend: u64,
    pub logs: Vec<Log>,
    pub labels: HashMap<Address, String, FbBuildHasher<20>>,
    pub traces: Option<SparsedTraceArena>,
    pub debug_bytecodes: HashMap<Address, Bytes, FbBuildHasher<20>>,
    pub line_coverage: Option<HitMaps>,
    pub edge_coverage: Option<EdgeCoverage>,
    pub evm_cmp_values: Option<Vec<CmpOperands>>,
    pub observed_calls: Vec<ObservedCall>,
    pub sancov_coverage: Option<Vec<u8>>,
    pub sancov_cmp_values: Option<Vec<CmpSample>>,
    pub transactions: Option<VecDeque<BroadcastableTransaction<<FEN as FoundryEvmNetwork>::Network>>>,
    pub state_changeset: HashMap<Address, Account, FbBuildHasher<20>>,
    pub evm_env: EvmEnv<<<FEN as FoundryEvmNetwork>::EvmFactory as EvmFactory>::Spec, <<FEN as FoundryEvmNetwork>::EvmFactory as EvmFactory>::BlockEnv>,
    pub tx_env: <<FEN as FoundryEvmNetwork>::EvmFactory as EvmFactory>::Tx,
    pub cheatcodes: Option<Box<Cheatcodes<FEN>>>,
    pub out: Option<Output>,
    pub fork_block_number: Option<u64>,
    pub chisel_state: Option<(Vec<Uint<256, 4>>, Vec<u8>)>,
    pub reverter: Option<Address>,
    pub skip_payloads: Vec<Bytes>,
}

The result of a raw call.

Fields

exit_reason: Option<InstructionResult>

The status of the call

execution_cancelled: bool

Whether the call was halted by the execution cancellation inspector.

reverted: bool

Whether the call reverted or not

has_state_snapshot_failure: bool

Whether the call includes a snapshot failure

This is tracked separately from revert because a snapshot failure can occur without a revert, since assert failures are stored in a global variable (ds-test legacy)

result: Bytes

The raw result of the call.

gas_used: u64

The gas used for the call

gas_refunded: u64

Refunded gas

stipend: u64

The initial gas stipend for the transaction

logs: Vec<Log>

The logs emitted during the call

labels: HashMap<Address, String, FbBuildHasher<20>>

The labels assigned to addresses during the call

traces: Option<SparsedTraceArena>

The traces of the call

debug_bytecodes: HashMap<Address, Bytes, FbBuildHasher<20>>

Runtime bytecodes for contracts seen in the trace, used by debug source mapping.

line_coverage: Option<HitMaps>

The line coverage info collected during the call

edge_coverage: Option<EdgeCoverage>

The edge coverage info collected during the call

evm_cmp_values: Option<Vec<CmpOperands>>

EVM comparison operands collected during the call.

observed_calls: Vec<ObservedCall>

Observed sub-calls collected during the call.

sancov_coverage: Option<Vec<u8>>

Sancov edge coverage from instrumented native Rust crates (e.g. precompiles). Tracked separately from EVM edge coverage to avoid ID-space collisions.

sancov_cmp_values: Option<Vec<CmpSample>>

Comparison operands captured via sancov trace-cmp callbacks.

transactions: Option<VecDeque<BroadcastableTransaction<<FEN as FoundryEvmNetwork>::Network>>>

Scripted transactions generated from this call

state_changeset: HashMap<Address, Account, FbBuildHasher<20>>

The changeset of the state.

evm_env: EvmEnv<<<FEN as FoundryEvmNetwork>::EvmFactory as EvmFactory>::Spec, <<FEN as FoundryEvmNetwork>::EvmFactory as EvmFactory>::BlockEnv>

The EvmEnv after the call

tx_env: <<FEN as FoundryEvmNetwork>::EvmFactory as EvmFactory>::Tx

The TxEnv after the call

cheatcodes: Option<Box<Cheatcodes<FEN>>>

The cheatcode states after execution

out: Option<Output>

The raw output of the execution

fork_block_number: Option<u64>

The active fork’s block number after execution, if any.

chisel_state: Option<(Vec<Uint<256, 4>>, Vec<u8>)>

The chisel state

reverter: Option<Address>

skip_payloads: Vec<Bytes>

Revert payloads minted by the skip cheatcode during this call.

Moved out of the cheatcode state on conversion since commit moves that state back into the executor before results are classified.

Implementations

impl<FEN> RawCallResult<FEN>

where FEN: FoundryEvmNetwork,

pub fn from_evm_result( r: Result<RawCallResult<FEN>, EvmError<FEN>>, ) -> Result<(RawCallResult<FEN>, Option<String>), Report>

Unpacks an EVM result.

pub fn skip_reason(&self) -> Option<SkipReason>

Returns the skip reason if this call reverted with a genuine vm.skip payload.

The revert data must byte-equal a payload recorded by the skip cheatcode during this call; a matching FOUNDRY::SKIP prefix alone (user-crafted revert data) does not count.

pub fn into_evm_error(self, rd: Option<&RevertDecoder>) -> EvmError<FEN>

Converts the result of the call into an EvmError.

pub const fn into_execution_error(self, reason: String) -> ExecutionErr<FEN>

Converts the result of the call into an ExecutionErr.

pub fn into_result( self, rd: Option<&RevertDecoder>, ) -> Result<RawCallResult<FEN>, EvmError<FEN>>

Returns an EvmError if the call failed, otherwise returns self.

pub fn into_decoded_result( self, func: &Function, rd: Option<&RevertDecoder>, ) -> Result<CallResult<DynSolValue, FEN>, EvmError<FEN>>

Decodes the result of the call with the given function.

pub fn transactions( &self, ) -> Option<&VecDeque<BroadcastableTransaction<<FEN as FoundryEvmNetwork>::Network>>>

Returns the transactions generated from this call.

pub fn merge_edge_coverage( &mut self, history_map: &mut Vec<u8>, edge_indices: &mut EdgeIndexMap, ) -> (bool, bool)

Update provided history map with edge coverage info collected during this call.

pub fn merge_sancov_coverage( &mut self, history_map: &mut Vec<u8>, ) -> (bool, bool)

Update provided history map with sancov coverage info collected during this call. Uses AFL-style hitcount binning.

pub fn merge_all_coverage( &mut self, evm_history: &mut Vec<u8>, evm_edge_indices: &mut EdgeIndexMap, sancov_history: &mut Vec<u8>, ) -> (bool, bool)

Merge both EVM and sancov coverage into their respective history maps. Returns (new_coverage, is_edge) — true if either domain produced new coverage.

Trait Implementations

impl<FEN> Debug for RawCallResult<FEN>

where FEN: Debug + FoundryEvmNetwork, <FEN as FoundryEvmNetwork>::Network: Debug,

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

Formats the value using the given formatter.

impl<FEN> Default for RawCallResult<FEN>

where FEN: FoundryEvmNetwork,

fn default() -> RawCallResult<FEN>

Returns the “default value” for a type.

impl<FEN> From<DeployResult<FEN>> for RawCallResult<FEN>

where FEN: FoundryEvmNetwork,

fn from(d: DeployResult<FEN>) -> RawCallResult<FEN>

Converts to this type from the input type.

impl<FEN> From<RawCallResult<FEN>> for TraceResult

where FEN: FoundryEvmNetwork,

fn from(result: RawCallResult<FEN>) -> TraceResult

Converts to this type from the input type.

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.