Struct DynamicRng 

pub struct DynamicRng(/* private fields */);

Heap-allocated cryptographically secure random bytes.

This is a newtype over Dynamic<Vec<u8>> for semantic clarity. Like FixedRng, guarantees freshness via RNG construction.

Requires the “rand” feature.

Examples

use secure_gate::random::DynamicRng;
let random = DynamicRng::generate(64);
assert_eq!(random.len(), 64);

Implementations

impl DynamicRng

pub fn generate(len: usize) -> Self

Generate fresh random bytes of the specified length.

Panics if the RNG fails.

Example

use secure_gate::random::DynamicRng;
let random = DynamicRng::generate(128);

pub fn try_generate(len: usize) -> Result<Self, OsError>

Try to generate fresh random bytes of the specified length.

Returns an error if the RNG fails.

Example

use secure_gate::random::DynamicRng;
let random: Result<DynamicRng, rand::rand_core::OsError> = DynamicRng::try_generate(64);
assert!(random.is_ok());

pub fn expose_secret(&self) -> &[u8]

Expose the random bytes for read-only access.

pub const fn len(&self) -> usize

Returns the length in bytes.

pub const fn is_empty(&self) -> bool

Returns true if empty.

pub fn into_inner(self) -> Dynamic<Vec<u8>>

Consume and return the inner Dynamic<Vec<u8>>.

Trait Implementations

impl Debug for DynamicRng

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

Formats the value using the given formatter.

impl From<DynamicRng> for Dynamic<Vec<u8>>

fn from(rng: DynamicRng) -> Self

Convert a DynamicRng to Dynamic, transferring ownership.

This preserves all security guarantees. The DynamicRng type ensures the value came from secure RNG, and this conversion transfers that value to Dynamic without exposing bytes.

Example

use secure_gate::{Dynamic, random::DynamicRng};
let random: Dynamic<Vec<u8>> = DynamicRng::generate(64).into();