Struct TupleHashXof

pub struct TupleHashXof<X> { /* private fields */ }

A cryptographic hash over a set of strings such that each string is unambiguously encoded.

For example, the TupleHash of ("abc", "d") will produce a different hash value than the TupleHash of ("ab", "cd").

Warning

TupleHash is only defined for cSHAKE128 and cSHAKE256. Using this with a different XOF might have worse security properties.

Implementations

impl<X: Xof> TupleHashXof<X>

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

Creates a TupleHash with the customization string s.

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

Writes the string s to the hash.

pub fn finalize_xof(self) -> TupleHashXofReader<X::Reader>

Returns a variable-size output.

Trait Implementations

impl<X: Clone> Clone for TupleHashXof<X>

fn clone(&self) -> TupleHashXof<X>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<X: Debug> Debug for TupleHashXof<X>

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

Formats the value using the given formatter.

impl<X: Default> Default for TupleHashXof<X>

fn default() -> TupleHashXof<X>

Returns the “default value” for a type.

impl<X: Xof> ExtendableOutput for TupleHashXof<X>

Available on crate feature rust-crypto only.

type Reader = TupleHashXofReader<<X as Xof>::Reader>

Reader

fn finalize_xof(self) -> Self::Reader

Retrieve XOF reader and consume hasher instance.

fn finalize_xof_into(self, out: &mut [u8])

Finalize XOF and write result into out.

fn digest_xof(input: impl AsRef<[u8]>, output: &mut [u8])

where Self: Default,

Compute hash of data and write it into output.

fn finalize_boxed(self, output_size: usize) -> Box<[u8]>

Retrieve result into a boxed slice of the specified size and consume the hasher.

impl<X: Xof> Update for TupleHashXof<X>

Available on crate feature rust-crypto only.

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<X: Xof> Xof for TupleHashXof<X>

type Reader = TupleHashXofReader<<X as Xof>::Reader>

Reads output bytes.

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

Creates a new XOF with the customization string s.

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

Updates the running hash with data.

fn finalize_xof(self) -> Self::Reader

Returns the output of the XOF.

fn finalize_xof_into(self, out: &mut [u8])

Writes the XOF output to out.

impl<X: Xof> HashMarker for TupleHashXof<X>

Available on crate feature rust-crypto only.