Struct TupleHash128 

pub struct TupleHash128 { /* private fields */ }

SP 800-185 TupleHash128: hashes a sequence of strings unambiguously.

Hashing a || b cannot distinguish ("abc", "d") from ("ab", "cd"), and a protocol that concatenates fields before hashing them has a forgery waiting in it. TupleHash length-prefixes every element, so distinct tuples always hash distinctly.

Implementations

impl TupleHash128

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

Start a TupleHash with a customization string.

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

Add one element of the tuple.

Each element is length-prefixed, which is the entire point: see the type documentation.

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

Finish with a fixed-length output, binding the length in.

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

Finish in XOF mode, where the output is a stream.

pub fn hash(custom: &[u8], elements: &[&[u8]], out: &mut [u8])

One-shot over a slice of elements.

pub fn hash_xof(custom: &[u8], elements: &[&[u8]], out: &mut [u8])

One-shot in XOF mode.

Trait Implementations

impl Algorithm for TupleHash128

const ID: &'static str = "tuplehash128"

Stable ontology identifier for this algorithm.

const NAME: &'static str = "TupleHash128"

Human-facing display name (for example "SHA-256").

impl Clone for TupleHash128

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl SelfTest for TupleHash128

fn self_test() -> Result<()>

The property TupleHash exists for: two different tuples that concatenate to the same bytes must hash differently.