Struct 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], ) -> GenericArray<u8, <Poly1305 as BlockSizeUser>::BlockSize>

Compute unpadded Poly1305 for the given input data.

The main use case for this is XSalsa20Poly1305.

Trait Implementations

impl BlockSizeUser for Poly1305

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

Size of the block in bytes.

fn block_size() -> usize

Return block size in bytes.

impl Clone for Poly1305

fn clone(&self) -> Poly1305

Returns a duplicate 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 KeyInit for Poly1305

fn new(key: &GenericArray<u8, <Poly1305 as KeySizeUser>::KeySize>) -> Poly1305

Initialize Poly1305 with the given key

fn new_from_slice(key: &[u8]) -> Result<Self, InvalidLength>

Create new value from variable size key.

fn generate_key( rng: impl CryptoRng + RngCore, ) -> GenericArray<u8, Self::KeySize>

Generate random key using the provided CryptoRng.

impl KeySizeUser for Poly1305

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

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.

impl UniversalHash for Poly1305

fn finalize(self) -> GenericArray<u8, <Poly1305 as BlockSizeUser>::BlockSize>

Get the hashed output

fn update_with_backend( &mut self, f: impl UhfClosure<BlockSize = <Poly1305 as BlockSizeUser>::BlockSize>, )

Update hash function state using the provided rank-2 closure.

fn update(&mut self, blocks: &[GenericArray<u8, Self::BlockSize>])

Update hash function state with the provided block.

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) -> GenericArray<u8, Self::BlockSize>

where Self: Clone + Reset,

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

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

Verify the UniversalHash of the processed input matches a given expected value.