Struct EntropyPool 

pub struct EntropyPool { /* private fields */ }

A pre-warmed pool of EntropySnapshot values for low-latency draws.

The pool spawns a background thread that continuously generates snapshots via entropy::gather() and refills the pool whenever it falls below a watermark (50% of capacity). Draws are nearly instant (mutex lock + pop).

If the pool is temporarily exhausted, draw() falls back to a synchronous entropy::gather() call so correctness is never compromised.

Implementations

impl EntropyPool

pub fn new(capacity: usize) -> Result<Self>

Create a new pool that holds up to capacity pre-generated snapshots.

Blocks until at least 8 snapshots (or capacity, whichever is smaller) are ready. The background refill thread starts immediately.

Panics

If capacity is 0.

pub fn draw(&self) -> Result<EntropySnapshot>

Draw a single EntropySnapshot from the pool.

If the pool has snapshots ready, this is a fast mutex-pop (~ns). If the pool is exhausted, falls back to synchronous entropy::gather().

pub fn len(&self) -> usize

Number of snapshots currently available (approximate).

pub fn is_empty(&self) -> bool

Returns true if the pool currently has no snapshots.

Trait Implementations

impl Drop for EntropyPool

fn drop(&mut self)

Executes the destructor for this type.