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, ExposeSecret};
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 into_inner(self) -> Dynamic<Vec<u8>>

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

impl DynamicRandom

pub fn to_hex(&self) -> HexString

Borrowing encode (original random remains usable).

pub fn into_hex(self) -> HexString

Consuming encode (raw random bytes zeroized immediately).

impl DynamicRandom

pub fn to_base64url(&self) -> Base64String

Borrowing encode (original random remains usable).

pub fn into_base64url(self) -> Base64String

Consuming encode (raw random bytes zeroized immediately).

impl DynamicRandom

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

Borrowing encode (original random remains usable).

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

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

Consuming encode (raw random bytes zeroized immediately).

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

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 ExposeSecret for DynamicRandom

Available on crate feature rand only.

Implementation for DynamicRandom - read-only access.

Random wrappers only provide read-only access to prevent invalidation of the randomly generated secret. The Inner type is [u8] (slice) for compatibility with SecureRandom trait bounds.

type Inner = [u8]

The inner secret type being exposed.

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

Expose the secret for read-only access.

fn len(&self) -> usize

Returns the length of the secret.

fn is_empty(&self) -> bool

Returns true if the secret is empty.

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();

impl SecureRandom for DynamicRandom

Available on crate feature rand only.