Struct Nonce 

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

A client-generated 64-byte nonce.

Zeroized on drop: the nonce is the one value this client generates itself that carries any unpredictability, so it is scrubbed as defense-in-depth even though the protocol does not treat it as a secret in the classic sense (see the crate-level security notes).

Implementations

impl Nonce

pub const fn new(bytes: [u8; 64]) -> Self

Wraps caller-supplied nonce bytes.

This is the no_std-safe constructor: a bare-metal caller supplies its own entropy (e.g. from a hardware RNG) rather than relying on an OS random source.

pub const fn as_bytes(&self) -> &[u8; 64]

Returns the nonce’s raw bytes.

pub fn random() -> Result<Self, Error>

Generates a nonce using the active crypto backend’s random source.

Errors

Returns crate::Error::RandomUnavailable if the OS random source is unavailable.

Trait Implementations

impl Debug for Nonce

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

Formats the value using the given formatter.

impl Drop for Nonce

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Zeroize for Nonce

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.