Struct Nonce

pub struct Nonce { /* private fields */ }

120 bit nonce with a 88 bit tag and 32 bit counter. If the counter exceeds 32 bits, then the nonce is no longer valid and must be refreshed with a new random nonce. It is expected that all 128 bits are given randomly. However, the last 32 counting bits may wrap around to ensure 2^32 counts may be used per nonce.

Implementations

impl Nonce

pub fn new(start_value: [u8; 15]) -> Self

Create a new nonce.

pub fn generate() -> Self

Generate a random nonce.

pub fn increment(&mut self) -> Result<()>

Adds one to the nonce, affecting only the last 32 counting bits. Returns an error iff we’ve exceeded our nonce’s counter capacity, i.e., we’ve incremented 2^32 times. In this case, the Nonce remains unchanged, and all subsequent calls to this method will return an Error.

Trait Implementations

impl Clone for Nonce

fn clone(&self) -> Nonce

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Nonce

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

Formats the value using the given formatter.

impl Deref for Nonce

type Target = [u8; 15]

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.