Struct StreamPoly1305 

pub struct StreamPoly1305 { /* private fields */ }

Available on crate feature allow-non-fips only.

Represents an ongoing streaming MAC computation, allowing incremental updates.

Example

use wolf_crypto::{mac::{Poly1305, poly1305::Key}, aead::Tag};

let key: Key = [42u8; 32].into();
let tag = Poly1305::new(key.as_ref())
    .update(b"chunk1")?
    .update(b"chunk2")?
    .update(b"chunk3")?
    .finalize();

Implementations

impl StreamPoly1305

pub fn update(self, input: &[u8]) -> Result<Self, Self>

Updates the streaming MAC computation with additional input.

Arguments

• input - A byte slice representing the additional data to include.

Errors

The length of the input was greater than u32::MAX.

Example

use wolf_crypto::{mac::{Poly1305, poly1305::Key}, aead::Tag};

let key: Key = [42u8; 32].into();

let tag = Poly1305::new(key.as_ref())
    .update(b"chunk1")?
    .update(b"chunk2")?
    .update(b"chunk3")?
    .finalize();

pub fn finalize(self) -> Tag

Finalizes the streaming MAC computation and returns the resulting Tag.

Returns

The associated authentication Tag.

Example

use wolf_crypto::{mac::{Poly1305, poly1305::Key}, aead::Tag};

let key: Key = [42u8; 32].into();

let tag = Poly1305::new(key.as_ref())
    .update(b"chunk1")?
    .update(b"chunk2")?
    .update(b"chunk3")?
    .finalize();

pub fn finalize_no_padding(self) -> Tag

Finalizes the constant-time streaming MAC computation and returns the resulting Tag.

Note

It is far more common in practice to use to pad the finalize method. This is only here for XSalsa20Poly1305.

Returns

The associated authentication Tag representing all updates and the total length of the updates.

Example

use wolf_crypto::{mac::{Poly1305, poly1305::Key}, aead::Tag};

let key: Key = [42u8; 32].into();
let tag = Poly1305::new(key.as_ref())
    .update(b"chunk1").unwrap()
    .update(b"chunk2").unwrap()
    .finalize_no_padding();

Trait Implementations

impl Debug for StreamPoly1305

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

Formats the value using the given formatter.

impl From<StreamPoly1305> for Unspecified

fn from(value: StreamPoly1305) -> Self

Converts to this type from the input type.