Struct RootBaseline 

pub struct RootBaseline { /* private fields */ }

A persisted map of Address -> B256 storage roots — each tracked account’s last observed on-chain storage root (storageHash from eth_getProof).

Persisted via save / load using the same versioned envelope as the binary state cache (magic bytes + version + bincode payload); an unknown magic, unknown version, or corrupt payload is a cache miss (None), never an error. The persistence location is the caller’s choice — conventionally roots.bin alongside the binary state file (evm_state.bin).

Currency, not completeness

The baseline is compared across time (the root observed now vs. the root observed at the last run), never local-vs-chain. root_unchanged proves the tracked subset did not change since the baseline block — it cannot detect that a slot you should have tracked was missing (spec §6).

Implementations

impl RootBaseline

pub fn insert(&mut self, address: Address, root: B256) -> Option<B256>

Record root as the observed storage root of address, returning the previously recorded root (if any).

pub fn get(&self, address: &Address) -> Option<B256>

The recorded storage root of address, if one was observed.

pub fn len(&self) -> usize

Number of recorded (address, root) entries.

pub fn is_empty(&self) -> bool

true when no roots are recorded.

pub fn save(&self, path: &Path) -> Result<(), PersistenceError>

Persist the baseline to path (conventionally roots.bin next to evm_state.bin).

The on-disk format carries magic bytes and a version number before the bincode payload, matching the binary state cache envelope. Entries are written in address order, so the bytes are deterministic. Returns an error if serialization, parent-directory creation, or writing fails.

pub fn load(path: &Path) -> Option<Self>

Load a baseline from path.

Returns None (rather than erroring) for a missing file, an unreadable file, an unknown magic header, an unknown version, or a corrupt payload — all are cache misses, matching the binary state cache’s handling. A missing file (the normal first-run case) is logged at debug; a read error and any magic/version/decode failure are logged at warn.

Trait Implementations

impl Clone for RootBaseline

fn clone(&self) -> RootBaseline

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RootBaseline

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

Formats the value using the given formatter.

impl Default for RootBaseline

fn default() -> RootBaseline

Returns the “default value” for a type.

impl Eq for RootBaseline

impl PartialEq for RootBaseline

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RootBaseline