Struct EntropyPool 

pub struct EntropyPool { /* private fields */ }

Thread-safe multi-source entropy pool.

Implementations

impl EntropyPool

pub fn new(seed: Option<&[u8]>) -> Self

Create an empty pool.

pub fn auto() -> Self

Create a pool with all available sources on this machine.

pub fn add_source(&mut self, source: Box<dyn EntropySource>, weight: f64)

Register an entropy source.

pub fn source_count(&self) -> usize

Number of registered sources.

pub fn collect_all(&self) -> usize

Collect entropy from every registered source in parallel.

Uses a 10s collection timeout per cycle. Slow sources are skipped and temporarily backed off to keep callers responsive.

pub fn collect_all_parallel(&self, timeout_secs: f64) -> usize

Collect entropy from all sources in parallel using detached worker threads.

Slow or hung sources are skipped after timeout_secs. Timed-out sources enter a backoff window to avoid thread buildup on repeated calls.

pub fn collect_all_parallel_n( &self, timeout_secs: f64, n_samples: usize, ) -> usize

Collect entropy from all sources in parallel using detached worker threads.

• timeout_secs: max wall-clock time to wait for a collection cycle.
• n_samples: samples requested from each source in this cycle.

Slow or hung sources are skipped after timeout_secs. Timed-out sources enter a backoff window to avoid thread buildup on repeated calls.

pub fn collect_enabled(&self, enabled_names: &[String]) -> usize

Collect entropy only from sources whose names are in the given list. Uses parallel threads. Collects 1000 samples per source.

pub fn collect_enabled_n( &self, enabled_names: &[String], n_samples: usize, ) -> usize

Collect n_samples of entropy from sources whose names are in the list. Smaller n_samples values are faster — use this for interactive/TUI contexts.

pub fn get_raw_bytes(&self, n_bytes: usize) -> Vec<u8>

Return up to n_bytes of raw, unconditioned entropy (XOR-combined only).

No SHA-256, no DRBG, no whitening. Preserves the raw hardware noise signal for researchers studying actual device entropy characteristics.

If sources cannot provide enough bytes after several collection rounds, this returns the available bytes rather than blocking indefinitely.

pub fn get_random_bytes(&self, n_bytes: usize) -> Vec<u8>

Return n_bytes of conditioned random output.

pub fn get_bytes(&self, n_bytes: usize, mode: ConditioningMode) -> Vec<u8>

Return n_bytes of entropy with the specified conditioning mode.

• Raw: XOR-combined source bytes, no whitening
• VonNeumann: debiased but structure-preserving
• Sha256: full cryptographic conditioning (default)

pub fn health_report(&self) -> HealthReport

Health report as structured data.

pub fn print_health(&self)

Pretty-print health report.

pub fn get_source_bytes( &self, source_name: &str, n_bytes: usize, mode: ConditioningMode, ) -> Option<Vec<u8>>

Collect entropy from a single named source and return conditioned bytes.

Returns None if the source name doesn’t match any registered source.

pub fn get_source_raw_bytes( &self, source_name: &str, n_samples: usize, ) -> Option<Vec<u8>>

Collect raw bytes from a single named source.

Returns None if no source matches the name.

pub fn source_names(&self) -> Vec<String>

List all registered source names.

pub fn source_infos(&self) -> Vec<SourceInfoSnapshot>

Get source info for each registered source.