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 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 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 KeyInit for Poly1305

fn new(key: &Key) -> Poly1305

Initialize Poly1305 with the given key

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

Create new value from variable size key.

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) -> Tag

Get the hashed output

fn update_with_backend(
    &mut self,
    f: impl UhfClosure<BlockSize = Self::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.