Struct StepSnapshot 

pub struct StepSnapshot {
    pub stack: Vec<Word>,
    pub memory: Option<Bytes>,
    pub storage: Arc<BTreeMap<String, String>>,
    pub storage_diff: BTreeMap<String, StorageChange>,
    pub transient_storage: BTreeMap<String, String>,
    pub return_data: Option<Arc<str>>,
}

The machine state one step captured.

memory and storage are shared: a backend building steps hands the previous step’s value on unchanged, so a trace holds one copy of memory per change rather than one per step. Reads see plain values through Deref; a step that changes them gets its own.

Memory is held as bytes. Trace files spell it as one unprefixed lowercase hex string, and serialization writes and reads that spelling, so the bytes are only a change in how a step holds memory, not in what a file says.

Fields

stack: Vec<Word>

memory: Option<Bytes>

Memory as bytes. A Bytes clone shares the buffer, which is how consecutive steps hold one copy of unchanged memory.

storage: Arc<BTreeMap<String, String>>

storage_diff: BTreeMap<String, StorageChange>

transient_storage: BTreeMap<String, String>

The transient slots this step read or wrote, with their value after it.

return_data: Option<Arc<str>>

The return data buffer before this step, as unprefixed hex; None when empty.

Implementations

impl StepSnapshot

pub fn new( stack: Vec<Word>, memory: Option<Bytes>, storage: BTreeMap<String, String>, storage_diff: BTreeMap<String, StorageChange>, ) -> Self

A snapshot that owns its values, for a backend or a test building one from parts.

pub fn with_transient_storage( self, transient_storage: BTreeMap<String, String>, ) -> Self

The same snapshot with transient_storage set.

pub fn with_return_data(self, return_data: Option<String>) -> Self

The same snapshot with return_data set; empty data is stored as None.

pub fn is_empty(&self) -> bool

Trait Implementations

impl Clone for StepSnapshot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepSnapshot

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

Formats the value using the given formatter.

impl Default for StepSnapshot

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StepSnapshot

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for StepSnapshot

impl PartialEq for StepSnapshot

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for StepSnapshot

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for StepSnapshot