Module crypto::hash

#include <std/crypto/hash.h> source

hash function traits.

std's hash contexts share one streaming shape: feed bytes with update(), then finish() writes the digest. The traits below name it, and code that works over any hash (HMAC, one-shot hashing) is written once against them; each call is resolved at compile time (no dispatch at run time).

Hasher     update + finish + digest_size: Sha1Ctx (sha1.h), Sha256Ctx
           (sha256.h; SHA-256 or SHA-224), Sha512Ctx (sha512.h; SHA-512
           or SHA-384), Hmac<H> (hmac.h)
BlockHash  Hasher + block_size: a hash over fixed-size blocks, as HMAC
           requires — Sha1Ctx, Sha256Ctx, Sha512Ctx

unsigned char d[SHA384_DIGEST_SIZE];
hash_bytes(Sha512Ctx::new_384(), msg, d[..]);      // msg: []const unsigned char
struct Hmac<Sha512Ctx> mac = Hmac::new(Sha512Ctx::new(), key);
mac.update(part1); mac.update(part2); mac.finish(tag[..]);

Traits

Hasher
BlockHash

Functions

hash_bytes The digest of data with a fresh context 'h' (taken by value, so the caller's copy stays fresh): hash_bytes(Sha256Ctx::new(), ...).