Struct Nonce 

pub struct Nonce<const N: usize>(/* private fields */);

A fixed-size cryptographic nonce.

Security

Using a typed wrapper prevents accidentally passing truncated hashes, key fragments, or other byte arrays where a nonce is expected. The const generic parameter enforces size at compile time — Nonce<16> and Nonce<12> are distinct types that cannot be mixed.

Implementations

impl<const N: usize> Nonce<N>

pub const SIZE: usize = N

Size of the nonce in bytes.

pub fn generate() -> Nonce<N>

Generate a cryptographically secure random nonce.

pub fn from_bytes(bytes: &[u8]) -> Option<Nonce<N>>

Parse a nonce from a byte slice.

Returns None if the slice length does not match N.

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

Access the underlying bytes.

Trait Implementations

impl<const N: usize> AsRef<[u8]> for Nonce<N>

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<const N: usize> Clone for Nonce<N>

fn clone(&self) -> Nonce<N>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const N: usize> Debug for Nonce<N>

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

Formats the value using the given formatter.

impl<const N: usize> Display for Nonce<N>

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

Formats the value using the given formatter.

impl<const N: usize> PartialEq for Nonce<N>

fn eq(&self, other: &Nonce<N>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const N: usize> Copy for Nonce<N>

impl<const N: usize> Eq for Nonce<N>

impl<const N: usize> StructuralPartialEq for Nonce<N>