Struct PolyvalGeneric 

pub struct PolyvalGeneric<const N: usize = { FieldElement::DEFAULT_PARALLELISM }> { /* private fields */ }

POLYVAL: GHASH-like universal hash over GF(2^128).

Parameterized on a constant that determines how many blocks to process at once: higher numbers use more memory, and require more time to re-key, but process data significantly faster.

(This constant is not used when acceleration is not enabled.)

Implementations

impl<const N: usize> PolyvalGeneric<N>

pub fn new(h: &Key) -> Self

Initialize POLYVAL with the given H field element.

pub fn new_with_init_block(h: &Key, init_block: u128) -> Self

Initialize POLYVAL with the given H field element and initial block.

Trait Implementations

impl<const N: usize> BlockSizeUser for PolyvalGeneric<N>

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<const N: usize> Clone for PolyvalGeneric<N>

fn clone(&self) -> PolyvalGeneric<N>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<const N: usize> Drop for PolyvalGeneric<N>

Available on crate feature zeroize only.

fn drop(&mut self)

Executes the destructor for this type.

impl<const N: usize> KeyInit for PolyvalGeneric<N>

fn new(h: &Key) -> Self

Create new value from fixed size key.

fn weak_key_test(_key: &Array<u8, Self::KeySize>) -> Result<(), WeakKeyError>

Check if the key might be considered weak.

fn new_checked(key: &Array<u8, Self::KeySize>) -> Result<Self, WeakKeyError>

Create new value from fixed size key after checking it for weakness.

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

Create new value from variable size key.

impl<const N: usize> KeySizeUser for PolyvalGeneric<N>

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

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.

impl<const N: usize> ParBlocksSizeUser for PolyvalGeneric<N>

where U<N>: ArraySize, Const<N>: ToUInt,

type ParBlocksSize = <Const<N> as ToUInt>::Output

Number of blocks which can be processed in parallel.

impl<const N: usize> Reset for PolyvalGeneric<N>

fn reset(&mut self)

Reset state to its initial value.

impl<const N: usize> UhfBackend for PolyvalGeneric<N>

where U<N>: ArraySize, Const<N>: ToUInt,

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

Process single block.

fn proc_par_blocks(&mut self, blocks: &ParBlocks<Self>)

Process several blocks in parallel.

fn blocks_needed_to_align(&self) -> usize

Returns the number of blocks that should be passed to Self::proc_block before Self::proc_par_blocks can be used efficiently. This is always less than Self::ParBlocksSize.

impl<const N: usize> UniversalHash for PolyvalGeneric<N>

where U<N>: ArraySize, Const<N>: ToUInt,

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

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

fn finalize(self) -> Tag

Retrieve result and consume hasher instance.

fn update(&mut self, blocks: &[Array<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) -> Array<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: &Array<u8, Self::BlockSize>) -> Result<(), Error>

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