Struct HardwareRng 

pub struct HardwareRng { /* private fields */ }

Hardware-accelerated Random Number Generator

This RNG uses RDRAND/RDSEED instructions when available, providing significant performance improvements over software-based RNGs.

For scenarios requiring the highest entropy quality, RDSEED is used for seeding, while RDRAND handles bulk random data generation.

Example

use ciphern::random::HardwareRng;

let rng = HardwareRng::new().expect("Failed to create HardwareRng");
let mut bytes = [0u8; 32];
rng.fill(&mut bytes);

Implementations

impl HardwareRng

pub fn new() -> Result<Self>

Create a new HardwareRng instance.

If hardware RNG (RDRAND) is available, it will be used for random number generation. Otherwise, falls back to ChaCha20Rng seeded via the OS entropy source.

Errors

Returns CryptoError::InsufficientEntropy if no entropy source is available.

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

Fill the destination buffer with random bytes.

Uses hardware RDRAND when available, otherwise uses software CSPRNG.

Trait Implementations

impl Clone for HardwareRng

fn clone(&self) -> HardwareRng

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for HardwareRng

fn default() -> Self

Returns the “default value” for a type.

impl RngCore for HardwareRng

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

fn fill_bytes(&mut self, dest: &mut [u8])

Fill dest with random data.

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

Fill dest entirely with random data.

impl CryptoRng for HardwareRng