Struct DynamicRandom 

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

Heap-allocated cryptographically secure random bytes with encoding methods.

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

Requires the rand feature.

Supports direct encoding to Hex, Base64, Bech32, and Bech32m via convenience methods.

Examples

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

Implementations

impl DynamicRandom

pub fn generate(len: usize) -> Self

Generate fresh random bytes of the specified length.

Panics if the RNG fails.

Example

use secure_gate::random::DynamicRandom;
let random = DynamicRandom::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::DynamicRandom;
let random: Result<DynamicRandom, rand::rand_core::OsError> = DynamicRandom::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>>.

impl DynamicRandom

pub fn into_base64(self) -> Base64String

Consume self and return the random bytes as a validated base64 string.

The raw bytes are zeroized immediately after encoding.

impl DynamicRandom

pub fn to_base64(&self) -> Base64String

Borrow and encode the random bytes as a validated base64 string (allocates).

The original secret remains intact and usable.

impl DynamicRandom

pub fn try_into_bech32( self, hrp: &str, ) -> Result<Bech32String, Bech32EncodingError>

Consume self and return the random bytes as a validated Bech32 string with the specified HRP.

The raw bytes are zeroized immediately after encoding (via drop of self).

Errors

Returns an error if the HRP is invalid.

pub fn try_into_bech32m( self, hrp: &str, ) -> Result<Bech32String, Bech32EncodingError>

Consume self and return the random bytes as a validated Bech32m string with the specified HRP.

The raw bytes are zeroized immediately after encoding (via drop of self).

Errors

Returns an error if the HRP is invalid.

impl DynamicRandom

pub fn try_to_bech32( &self, hrp: &str, ) -> Result<Bech32String, Bech32EncodingError>

Borrow and encode the random bytes as a validated Bech32 string with the specified HRP (allocates).

The original secret remains intact and usable.

Errors

Returns an error if the HRP is invalid.

pub fn try_to_bech32m( &self, hrp: &str, ) -> Result<Bech32String, Bech32EncodingError>

Borrow and encode the random bytes as a validated Bech32m string with the specified HRP (allocates).

The original secret remains intact and usable.

Errors

Returns an error if the HRP is invalid.

impl DynamicRandom

pub fn into_hex(self) -> HexString

Consume self and return the random bytes as a validated hex string.

The raw bytes are zeroized immediately after encoding.

impl DynamicRandom

pub fn to_hex(&self) -> HexString

Borrow and encode the random bytes as a validated lowercase hex string (allocates).

The original secret remains intact and usable.

Trait Implementations

impl Debug for DynamicRandom

Debug implementation (always redacted).

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

Formats the value using the given formatter.

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

fn from(rng: DynamicRandom) -> Self

Convert a DynamicRandom to Dynamic, transferring ownership.

This preserves all security guarantees. The DynamicRandom 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::DynamicRandom};
let random: Dynamic<Vec<u8>> = DynamicRandom::generate(64).into();