Struct StatePageRetentionLedger 

pub struct StatePageRetentionLedger {
    pub format_version: u32,
    pub gc_epoch: u64,
    pub handles: BTreeMap<String, StatePageRetentionHandle>,
    pub committed_roots: BTreeMap<String, BTreeSet<String>>,
}

Persistable host-side mark/sweep interlock for content-addressed state pages. Preparing, verifying, or durably enqueueing a root protects every declared reachable page across process restart. A committed root takes over that lease atomically before the transient handle may disappear.

Fields

format_version: u32

gc_epoch: u64

handles: BTreeMap<String, StatePageRetentionHandle>

committed_roots: BTreeMap<String, BTreeSet<String>>

Implementations

impl StatePageRetentionLedger

pub fn prepare( &mut self, delta: &PreparedStateDelta, provider: &dyn StatePageProvider, ) -> Result<String, CanwuError>

pub fn verify( &mut self, handle_id: &str, provider: &dyn StatePageProvider, ) -> Result<(), CanwuError>

pub fn mark_durable_ingress( &mut self, handle_id: &str, ) -> Result<(), CanwuError>

pub fn commit(&mut self, handle_id: &str) -> Result<(), CanwuError>

pub fn abandon(&mut self, handle_id: &str) -> Result<(), CanwuError>

pub fn release_committed_root(&mut self, root: &str) -> Result<(), CanwuError>

pub fn begin_gc_epoch(&mut self) -> Result<u64, CanwuError>

pub fn reachable_page_ids(&self) -> BTreeSet<String>

pub fn sweep_candidates( &self, all_page_ids: impl IntoIterator<Item = String>, ) -> BTreeSet<String>

pub fn validate(&self) -> Result<(), CanwuError>

Trait Implementations

impl Clone for StatePageRetentionLedger

fn clone(&self) -> StatePageRetentionLedger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StatePageRetentionLedger

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

Formats the value using the given formatter.

impl Default for StatePageRetentionLedger

fn default() -> StatePageRetentionLedger

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StatePageRetentionLedger

fn deserialize<__D>( __deserializer: __D, ) -> Result<StatePageRetentionLedger, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for StatePageRetentionLedger

impl PartialEq for StatePageRetentionLedger

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for StatePageRetentionLedger

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for StatePageRetentionLedger