Struct PacketKeyRing 

pub struct PacketKeyRing { /* private fields */ }

Bounded packet key lifecycle metadata.

Implementations

impl PacketKeyRing

pub fn new(config: PacketKeyRingConfig) -> Self

Creates an empty key ring.

pub fn with_defaults() -> Self

Creates an empty key ring with default limits.

pub const fn config(&self) -> PacketKeyRingConfig

Returns configuration.

pub fn len(&self) -> usize

Returns key metadata count.

pub fn is_empty(&self) -> bool

Returns whether the ring has no key metadata.

pub const fn stats(&self) -> PacketKeyRingStats

Returns statistics.

pub fn get(&self, key_id: u32) -> Option<PacketKeyDescriptor>

Returns one key descriptor.

pub fn iter(&self) -> impl Iterator<Item = &PacketKeyDescriptor>

Iterates key descriptors in key-id order.

pub fn insert( &mut self, descriptor: PacketKeyDescriptor, ) -> Result<(), PacketKeyRingError>

Inserts a descriptor if capacity and uniqueness allow it.

pub fn insert_active( &mut self, key_id: u32, now: Tick, send_priority: u32, ) -> Result<(), PacketKeyRingError>

Inserts active key metadata.

pub fn activate( &mut self, key_id: u32, activated_at: Tick, ) -> Result<(), PacketKeyRingError>

Marks a key active and send-eligible from activated_at.

pub fn retire( &mut self, key_id: u32, retires_at: Tick, ) -> Result<(), PacketKeyRingError>

Marks a key receive-only for retirement.

pub fn revoke(&mut self, key_id: u32) -> Result<(), PacketKeyRingError>

Marks a key rejected.

pub fn set_expiry( &mut self, key_id: u32, expires_at: Option<Tick>, ) -> Result<(), PacketKeyRingError>

Updates the expiration tick for one key.

pub fn remove_expired(&mut self, now: Tick) -> usize

Removes expired descriptors and returns the removed count.

pub fn select_send_key( &self, now: Tick, ) -> Result<PacketKeyDescriptor, PacketKeyRingError>

Selects the best active key for sending at now.

pub fn accept_key( &self, key_id: u32, now: Tick, ) -> Result<PacketKeyDescriptor, PacketKeyRingError>

Checks that key_id is accepted for receiving at now.

Trait Implementations

impl Clone for PacketKeyRing

fn clone(&self) -> PacketKeyRing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PacketKeyRing

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

Formats the value using the given formatter.

impl Default for PacketKeyRing

fn default() -> Self

Returns the “default value” for a type.