Struct NonceBook 

pub struct NonceBook { /* private fields */ }

Capacity-bounded LRU+TTL store of NonceObservations.

The store reuses the same LruTtlStore primitive the ChallengeMemory uses (T83). That keeps eviction + expiry semantics consistent across both short-horizon stores and satisfies the “no new cache store” requirement.

Example

use stygian_charon::token_lifecycle::{ChallengeClass, NonceBook};
use stygian_charon::vendor_classifier::VendorId;
use std::num::NonZeroUsize;
use std::time::Duration;

let book = NonceBook::with_defaults();
book.record(VendorId::Cloudflare, ChallengeClass::Interstitial, "nonce-1");
assert_eq!(book.observation_count(VendorId::Cloudflare, "nonce-1"), Some(1));

Implementations

impl NonceBook

pub fn new(capacity: NonZeroUsize, ttl: Duration) -> Self

Create a new nonce book with explicit capacity and TTL.

Example

use stygian_charon::token_lifecycle::NonceBook;
use std::num::NonZeroUsize;
use std::time::Duration;

let book = NonceBook::new(NonZeroUsize::new(8).expect("non-zero"), Duration::from_mins(1));
assert!(book.is_empty());

pub fn with_default_ttl(capacity: NonZeroUsize) -> Self

Capacity-bounded NonceBook with DEFAULT_NONCE_TTL.

pub fn with_defaults() -> Self

Capacity-bounded NonceBook with DEFAULT_NONCE_BOOK_CAPACITY and DEFAULT_NONCE_TTL.

Example

use stygian_charon::token_lifecycle::NonceBook;

let book = NonceBook::with_defaults();
assert_eq!(book.ttl(), stygian_charon::token_lifecycle::DEFAULT_NONCE_TTL);

pub const fn ttl(&self) -> Duration

Configured TTL for the backing store.

pub fn record( &self, vendor: VendorId, challenge_class: ChallengeClass, nonce: &str, )

Record an observation for a (vendor, nonce) tuple. The observation count is incremented atomically with the read-modify-write sequence; the LRU recency is not bumped on the read so a high-volume key does not crowd out less common keys.

Example

use stygian_charon::token_lifecycle::{ChallengeClass, NonceBook};
use stygian_charon::vendor_classifier::VendorId;

let book = NonceBook::with_defaults();
book.record(VendorId::PerimeterX, ChallengeClass::IntegrityCheck, "n");
book.record(VendorId::PerimeterX, ChallengeClass::IntegrityCheck, "n");
assert_eq!(book.observation_count(VendorId::PerimeterX, "n"), Some(2));

pub fn observation_count(&self, vendor: VendorId, nonce: &str) -> Option<u32>

Look up the current observation count for a (vendor, nonce) tuple. Returns None when the key is absent or has expired.

Example

use stygian_charon::token_lifecycle::NonceBook;
use stygian_charon::vendor_classifier::VendorId;

let book = NonceBook::with_defaults();
assert!(book.observation_count(VendorId::Unknown, "nope").is_none());

pub fn lookup(&self, vendor: VendorId, nonce: &str) -> Option<NonceObservation>

Look up the full NonceObservation for a (vendor, nonce) tuple.

pub fn len(&self) -> usize

Number of entries currently retained.

pub fn is_empty(&self) -> bool

true when the book has zero entries.

pub fn clear(&self)

Remove all entries.

pub fn invalidate(&self, vendor: VendorId, nonce: &str)

Invalidate a single (vendor, nonce) key.

Trait Implementations

impl Debug for NonceBook

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

Formats the value using the given formatter.