Struct SecureRandom 

pub struct SecureRandom { /* private fields */ }

Cryptographically secure random number generator

This generator uses multiple entropy sources and a cryptographically secure PRNG to provide high-quality random numbers suitable for security applications.

Implementations

impl SecureRandom

pub fn new() -> Self

Create a new cryptographically secure RNG

Uses multiple entropy sources including:

• System time (nanoseconds since UNIX epoch)
• Process ID
• Thread ID
• Hash combining all sources

pub fn from_seed(seed: [u8; 32]) -> Self

Create a secure RNG from a provided seed

Warning

Using a predictable seed defeats the purpose of cryptographic security. This method should only be used for testing or when the seed comes from a high-entropy source.

pub fn sample<D, T>(&mut self, distribution: D) -> T

where D: Distribution<T>,

Generate a cryptographically secure random value

pub fn random_bytes(&mut self, count: usize) -> Vec<u8>

Generate cryptographically secure random bytes

This is suitable for generating keys, nonces, and other cryptographic material.

pub fn generate_key(&mut self, length: usize) -> Vec<u8>

Generate a cryptographically secure random key

Alias for random_bytes with more descriptive naming for key generation.

pub fn generate_nonce(&mut self, length: usize) -> Vec<u8>

Generate a cryptographically secure random nonce

Nonces should be unique for each use. This generates random bytes suitable for use as a nonce in cryptographic protocols.

pub fn random_f64(&mut self) -> f64

Generate a cryptographically secure random float in [0, 1)

pub fn random_f32(&mut self) -> f32

Generate a cryptographically secure random float in [0, 1) as f32

pub fn random_range<T>(&mut self, min: T, max: T) -> T

where T: SampleUniform + PartialOrd + Copy,

Generate cryptographically secure random integers in a range

pub fn random_bool(&mut self) -> bool

Generate a cryptographically secure random boolean

pub fn random_bool_with_probability(&mut self, p: f64) -> bool

Generate a cryptographically secure random boolean with given probability

pub fn random_alphanumeric(&mut self, length: usize) -> String

Generate cryptographically secure random alphanumeric string

Useful for generating random passwords, tokens, or identifiers.

pub fn random_hex(&mut self, byte_length: usize) -> String

Generate cryptographically secure random hex string

Useful for generating random hex-encoded keys or identifiers.

pub fn random_uuid(&mut self) -> String

Generate cryptographically secure UUID v4

Generates a random UUID suitable for use as a unique identifier.

pub fn rng_mut(&mut self) -> &mut Random<StdRng>

Access the underlying RNG for advanced operations

Trait Implementations

impl Default for SecureRandom

fn default() -> Self

Returns the “default value” for a type.