Struct NonceSequence 

pub struct NonceSequence<const N: usize> { /* private fields */ }

A stateful nonce generator that produces sequentially unique nonces.

Panics

This type does not panic; all errors are returned as CryptoError.

Example

use oxicrypto_aead::nonce_seq::Nonce12;

let prefix = [0u8; 4]; // 4-byte prefix for a 12-byte nonce
let mut seq = Nonce12::new(&prefix).unwrap();
let n0 = seq.generate().unwrap();
let n1 = seq.generate().unwrap();
assert_ne!(n0, n1);

Implementations

impl<const N: usize> NonceSequence<N>

pub fn new(prefix: &[u8]) -> Result<Self, CryptoError>

Create a new NonceSequence with the given prefix.

prefix must be exactly N - 8 bytes long; otherwise CryptoError::InvalidNonce is returned.

The initial counter value is 0.

pub fn generate(&mut self) -> Result<[u8; N], CryptoError>

Return the next nonce and advance the counter.

Errors

Returns CryptoError::Internal if the counter has wrapped around u64::MAX (i.e., 2^64 nonces have been generated).

pub fn count(&self) -> u64

Return the current counter value (number of nonces generated so far).

Trait Implementations

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

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

Formats the value using the given formatter.