Struct poly1305::Poly1305

pub struct Poly1305 { /* private fields */ }

The Poly1305 universal hash function.

Note that Poly1305 is not a traditional MAC and is single-use only (a.k.a. “one-time authenticator”).

For this reason it doesn’t impl the crypto_mac::Mac trait.

Implementations

impl Poly1305

pub fn compute_unpadded(self, data: &[u8]) -> Tag

Compute unpadded Poly1305 for the given input data.

The main use case for this is XSalsa20Poly1305.

Trait Implementations

impl Clone for Poly1305

fn clone(&self) -> Poly1305

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Poly1305

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

Formats the value using the given formatter.

impl NewUniversalHash for Poly1305

fn new(key: &Key) -> Poly1305

Initialize Poly1305 with the given key

type KeySize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>

Size of the key for the universal hash function.

impl UniversalHash for Poly1305

fn update(&mut self, block: &Block)

Input data into the Poly1305 universal hash function

fn reset(&mut self)

Reset internal state

fn finalize(self) -> Tag

Get the hashed output

type BlockSize = UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>

Size of the inputs to and outputs from the universal hash function

fn update_padded(&mut self, data: &[u8])

Input data into the universal hash function. If the length of the data is not a multiple of the block size, the remaining data is padded with zeroes up to the BlockSize.

fn finalize_reset(&mut self) -> Output<Self>

Obtain the Output of a UniversalHash computation and reset it back to its initial state.

fn verify(self, other: &GenericArray<u8, Self::BlockSize>) -> Result<(), Error>

Verify the UniversalHash of the processed input matches a given Output. This is useful when constructing Message Authentication Codes (MACs) from universal hash functions.