Struct Kmac256 

pub struct Kmac256 { /* private fields */ }

KMAC256 implementation

Implementations

impl Kmac256

pub fn new(key: &[u8], custom: &[u8]) -> Self

Creates a new KMAC instance with the given key and customization string

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

Update with data

pub fn finalize(self, output: &mut [u8]) -> Option<()>

Finalize with specified output length.

output.len() must not exceed MAX_SP800185_FIXED_OUTPUT_BYTES. For longer output, use Self::xof.

Returns None if output.len() is greater than MAX_SP800185_FIXED_OUTPUT_BYTES.

pub fn verify(self, expected: &[u8]) -> Choice

Finalize and compare the MAC to expected in constant time.

The MAC output length is expected.len() (same encoding as Self::finalize with an output buffer of that length). The computed MAC is zeroized before returning.

If expected.len() is greater than MAX_SP800185_FIXED_OUTPUT_BYTES, this returns a failed comparison without allocating (or finalizing with that length), so attacker-controlled lengths cannot force large allocations.

Combine or inspect the result with subtle APIs before branching on validity if control-flow timing is a concern.

pub fn finalize_with_length(self, output_len: usize) -> Option<Vec<u8>>

Finalize with specified output length and return as Vec.

Returns None if output_len is greater than MAX_SP800185_FIXED_OUTPUT_BYTES (no allocation). For longer output, use Self::xof.

pub fn xof(self) -> Kmac256Reader

Returns an XOF reader for variable-length output.

SP 800-185 encodes XOF mode with right_encode(0) (output bit length zero) before squeezing.

This consumes self and finalizes the sponge; you cannot call Self::update afterward on this value.

Trait Implementations

impl AlgorithmName for Kmac256

fn write_alg_name(f: &mut Formatter<'_>) -> Result

Write algorithm name into f.

impl BlockSizeUser for Kmac256

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

Size of the block in bytes.

fn block_size() -> usize

Return block size in bytes.

impl BufferKindUser for Kmac256

type BufferKind = Eager

Block buffer kind over which type operates.

impl Clone for Kmac256

fn clone(&self) -> Kmac256

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CollisionResistance for Kmac256

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

Collision resistance in bytes.

impl Debug for Kmac256

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

Formats the value using the given formatter.

impl Default for Kmac256

fn default() -> Self

Returns the “default value” for a type.

impl HashMarker for Kmac256

impl Reset for Kmac256

fn reset(&mut self)

Reset state to its initial value.

impl SerializableState for Kmac256

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

Size of serialized internal state.

fn serialize(&self) -> SerializedState<Self>

Serialize and return internal state.

fn deserialize( serialized_state: &SerializedState<Self>, ) -> Result<Self, DeserializeStateError>

Create an object from serialized internal state.

impl Update for Kmac256

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

Update state using the provided data.

fn chain(self, data: impl AsRef<[u8]>) -> Self

where Self: Sized,

Digest input data in a chained manner.

impl UpdateCore for Kmac256

fn update_blocks(&mut self, blocks: &[Block<Self>])

Update state using the provided data blocks.

impl ZeroizeOnDrop for Kmac256

Available on crate feature zeroize only.