Struct HmacSm3 

pub struct HmacSm3 { /* private fields */ }

Streaming HMAC-SM3 (v0.3 W5).

Construct with new(&key), feed message chunks via update, finalize with finalize (32-byte tag) or verify (constant- time compare against an expected tag).

Equivalent to hmac_sm3 for the same (key, message) byte sequence — chunking does not affect the output.

Zeroization

The keyed inner / outer Sm3 states (the SM3 compression state after absorbing K' XOR ipad / K' XOR opad) hold key-derived material. They are wiped at the field layer by Sm3’s own Drop impl (v0.23): whenever an HmacSm3 — or the Sm3 values moved out of it by HmacSm3::finalize — is dropped, the compression state + input buffer are scrubbed. There is no impl Drop for HmacSm3 (and there must not be: finalize(self) moves the inner/outer fields out of self, which a Drop impl would forbid). Construction-time intermediates (K', K' XOR ipad, K' XOR opad) are zeroized inside HmacSm3::new after they are folded into the keyed states. The 32-byte tag returned by HmacSm3::finalize is the public output and is not wiped.

Implementations

impl HmacSm3

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

Construct a new keyed HMAC-SM3 instance.

key may be any length; the standard RFC 2104 hash-first reduction applies for key.len() > 64. Both intermediate K' / K' XOR ipad / K' XOR opad buffers are zeroized after the inner/outer SM3 instances absorb them.

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

Absorb message bytes into the inner hash.

pub fn finalize(self) -> [u8; 32]

Consume the instance and produce the 32-byte MAC tag.

self.inner is finalized (by value) into the inner digest and self.outer is moved out, fed the inner digest, and finalized. Both keyed Sm3 values are scrubbed by Sm3’s Drop impl (v0.23) when they go out of scope here; the returned tag is the public output.

pub fn verify(self, expected: &[u8; 32]) -> bool

Constant-time verify a candidate tag against the finalized HMAC. Returns true on match.

Trait Implementations

impl FixedOutput for HmacSm3

fn finalize_into(self, out: &mut Output<Self>)

Consume value and write result into provided array.

fn finalize_fixed(self) -> Array<u8, Self::OutputSize>

Retrieve result and consume the hasher instance.

impl KeyInit for HmacSm3

fn new(key: &Key<Self>) -> Self

Create new value from fixed size key.

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

Create new value from variable size key.

impl KeySizeUser for HmacSm3

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

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.

impl MacMarker for HmacSm3

impl OutputSizeUser for HmacSm3

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

Size of the output in bytes.

fn output_size() -> usize

Return output size in bytes.

impl Reset for HmacSm3

fn reset(&mut self)

Reset state to its initial value.

impl Update for HmacSm3

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.