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) -> Self

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

Formats the value using the given formatter.

impl Default for StatePageRetentionLedger

fn default() -> Self

Returns the “default value” for a type.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for StatePageRetentionLedger

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for StatePageRetentionLedger