Struct Keyring 

pub struct Keyring { /* private fields */ }

Verification keyring: key id → public key. Old receipts stay verifiable after rotation as long as their key remains in the ring.

Implementations

impl Keyring

pub fn new() -> Self

Empty ring.

pub fn add_key_bytes(&mut self, bytes: &[u8; 32]) -> Result<String, KeyError>

Add a key by raw public bytes; returns its derived key id.

If the derived id already exists with a different public key, refuses silently overwriting it and returns KeyMismatch — otherwise an attacker who found a 128-bit collision could substitute their key for an honest signer’s.

pub fn add_signer(&mut self, signer: &dyn Signer) -> Result<String, KeyError>

Add the public half of a signer.

pub fn verify( &self, key_id: &str, msg: &[u8], sig: &[u8], ) -> Result<(), KeyError>

Verify sig over msg with the key identified by key_id.

pub fn len(&self) -> usize

Number of keys in the ring.

pub fn is_empty(&self) -> bool

True if the ring holds no keys.

Trait Implementations

impl Clone for Keyring

fn clone(&self) -> Keyring

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Keyring

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

Formats the value using the given formatter.

impl Default for Keyring

fn default() -> Keyring

Returns the “default value” for a type.