Struct ReseedingRng 

pub struct ReseedingRng { /* private fields */ }

A OxiRng wrapper that automatically reseeds from OS entropy after generating a configurable number of bytes (default: 1 MiB).

This implements a forward-secrecy interval consistent with NIST SP 800-90A §9.2 recommendations. After each reseed the internal byte counter resets.

Observability

Use ReseedingRng::bytes_generated to inspect how many bytes have been produced since the last reseed.

Implementations

impl ReseedingRng

pub fn new() -> Result<Self, CryptoError>

Create a new ReseedingRng with the default 1 MiB reseed threshold.

pub fn with_threshold(threshold: u64) -> Result<Self, CryptoError>

Create a new ReseedingRng with a custom reseed threshold (bytes).

A threshold of 0 would reseed on every call — technically valid but very slow. Reasonable values are 64 KiB to 64 MiB.

pub fn bytes_generated(&self) -> u64

Number of bytes generated since the last reseed.

pub fn reseed_threshold(&self) -> u64

Configured reseed threshold in bytes.

pub fn reseed(&mut self) -> Result<(), CryptoError>

Reseed immediately from OS entropy, regardless of the threshold.

Trait Implementations

impl Debug for ReseedingRng

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

Formats the value using the given formatter.

impl Rng for ReseedingRng

fn fill(&mut self, dst: &mut [u8]) -> Result<(), CryptoError>

Fill dst with cryptographically secure random bytes.

impl TryRng for ReseedingRng

type Error = CryptoError

The type returned in the event of a RNG error.

fn try_next_u32(&mut self) -> Result<u32, Self::Error>

Return the next random u32.

fn try_next_u64(&mut self) -> Result<u64, Self::Error>

Return the next random u64.

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Self::Error>

Fill dst entirely with random data.

impl TryCryptoRng for ReseedingRng