crates.io CI docs.rs license

evidence

Type-level tags for cryptographic primitives.

evidence wraps cryptographic output (hashes, signatures, ciphertext) with phantom type parameters that track what was processed, which algorithm was used, and how the input was serialized — all at zero runtime cost.

The Problem

Cryptographic code often looks like this:

fn verify_user(user_hash: [u8;32],post_hash: [u8;32]){// Oops! Easy to swap these by accident
ifuser_hash==post_hash{/* ... */}}

These are just byte arrays — the compiler can't help you distinguish a hash of a User from a hash of a Post, or a SHA-256 digest from a Blake3 digest.

The Solution

With evidence, the type system tracks what was hashed/signed and how:

useevidence::digest::{Digest,sha2::Sha256};useevidence::codec::Identity;// These are incompatible types — can't be mixed up
letuser_hash: Digest<User,Sha256,Identity>=Digest::hash(&user);letpost_hash: Digest<Post,Sha256,Identity>=Digest::hash(&post);// Compile error: expected `Digest<User, ...>`, found `Digest<Post, ...>`
// verify_user(post_hash);

This prevents:

• Mixing up digests of different types
• Comparing hashes from different algorithms
• Accessing signed payloads before verification
• Confusing encodings (a CBOR hash != a JSON hash of the same value)

The supported types can be extended without changing this library. That said, contributions of common primitives are always welcome.

Usage

useevidence::{codec::Encode,digest::{Digest,sha2::Sha256}};// Define your codec (or use the built-in Cbor / Json codecs)
enum MyCbor{}impl<T: minicbor::Encode<()>>Encode<T>forMyCbor{type Error=minicbor::encode::Error<core::convert::Infallible>;fn encode(value: &T)-> Result<Vec<u8>,Self::Error>{minicbor::to_vec(value)}}// Now you can hash values
letdigest: Digest<MyData,Sha256,MyCbor>=Digest::hash(&my_data);// Access the raw bytes when needed
letbytes: &[u8]=digest.as_bytes();

Primitives

Hash

Signature

Encryption (AEAD)

MAC

Features

No features are enabled by default.

Cargo.toml

[dependencies]
evidence = { version = "0.1", features = ["sha2"] }
# With signatures
evidence = { version = "0.1", features = ["sha2", "ed25519"] }
# With encryption
evidence = { version = "0.1", features = ["sha2", "chacha20poly1305"] }

MSRV

The minimum supported Rust version is 1.90.

no_std

This crate is #![no_std] compatible. It requires alloc for encoding.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.