Struct StorageRetentionPolicy 

pub struct StorageRetentionPolicy { /* private fields */ }

Tick-based storage retention policy with built-in entry tracking.

Maintains a set of blocks (entries) and evaluates configurable rules against them. Rules are sorted by descending priority. Pinned entries are always kept regardless of rules.

Implementations

impl StorageRetentionPolicy

pub fn new() -> Self

Creates a new, empty retention policy at tick 0.

pub fn add_rule(&mut self, rule: TickRetentionRule)

Adds a rule, maintaining descending priority order. If a rule with the same name already exists it is replaced.

pub fn remove_rule(&mut self, name: &str) -> bool

Removes the rule with the given name. Returns true if a rule was found and removed.

pub fn add_entry(&mut self, block_cid: &str, size_bytes: u64, created_tick: u64)

Registers a new block entry at the given creation tick.

pub fn pin(&mut self, block_cid: &str) -> bool

Pins a block, protecting it from deletion/archival. Returns true if the entry was found and pinned.

pub fn unpin(&mut self, block_cid: &str) -> bool

Unpins a block, allowing retention rules to apply. Returns true if the entry was found and unpinned.

pub fn evaluate(&self, block_cid: &str) -> TickRetentionAction

Evaluates retention rules against a single block.

Pinned blocks always return Keep. Rules are evaluated in descending priority order; the first matching rule wins. If no rule matches, the default is Keep.

pub fn enforce(&mut self) -> Vec<(String, TickRetentionAction)>

Evaluates all entries and enforces the policy.

Entries marked for deletion are removed from the internal store. Returns a list of (cid, action) pairs for entries that received Archive or Delete actions.

pub fn access(&mut self, block_cid: &str)

Updates the last_accessed_tick of the given entry to the current tick.

pub fn tick(&mut self)

Advances the internal clock by one tick.

pub fn entry_count(&self) -> usize

Returns the number of entries currently tracked.

pub fn total_size_bytes(&self) -> u64

Returns the total size in bytes of all tracked entries.

pub fn stats(&self) -> RetentionPolicyStats

Returns aggregate statistics about this policy.

pub fn current_tick(&self) -> u64

Returns the current tick value.

Trait Implementations

impl Default for StorageRetentionPolicy

fn default() -> Self

Returns the “default value” for a type.