Struct OxiRng 

pub struct OxiRng { /* private fields */ }

A ChaCha20 CSPRNG seeded from the OS random source.

Use OxiRng::new to create an instance. The seed is obtained from getrandom::fill which calls /dev/urandom, RtlGenRandom, or arc4random depending on the platform — no C library required.

On Unix platforms, OxiRng automatically reseeds itself if the process PID changes (i.e. after a fork()), preventing parent/child state sharing.

Implementations

impl OxiRng

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

Create a new OxiRng seeded from the OS.

Returns CryptoError::Internal if getrandom fails.

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

Reseed this RNG from OS entropy.

Replaces the internal ChaCha20 state with a fresh 32-byte seed and updates the stored PID to the current process. The free function crate::reseed is kept for backward compatibility.

Returns CryptoError::Rng if getrandom fails.

pub fn fill_exact<const N: usize>( &mut self, dst: &mut [u8; N], ) -> Result<(), CryptoError>

Fill a fixed-size array with cryptographically random bytes.

Trait Implementations

impl Debug for OxiRng

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

Formats the value using the given formatter.

impl Display for OxiRng

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

Formats the value using the given formatter.

impl Rng for OxiRng

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

Fill dst with cryptographically secure random bytes.

impl TryRng for OxiRng

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 OxiRng