rscrypto 0.1.0

Rust crypto with zero default deps: BLAKE3, Ed25519/X25519, hashes, MACs, KDFs, AEADs, and checksums with SIMD/ASM acceleration.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! Core cryptographic traits for rscrypto.
//!
//! This module provides the foundational traits that all rscrypto implementations
//! conform to. It is `no_std` compatible and has zero dependencies.
//!
//! # Trait Hierarchy
//!
//! | Trait | Purpose | Examples |
//! |-------|---------|----------|
//! | `Aead` | Authenticated encryption with associated data | XChaCha20-Poly1305 |
//! | [`Checksum`] | Non-cryptographic checksums | CRC32, CRC64 |
//! | [`ChecksumCombine`] | Parallel checksum combination | CRC with O(log n) combine |
//! | [`Digest`] | Cryptographic digests | BLAKE3, SHA-2 |
//! | [`Mac`] | Message authentication codes | HMAC-SHA256 |
//! | [`Xof`] | Extendable-output functions | BLAKE3 XOF |
//! | [`FastHash`] | Fast non-cryptographic hashes (**NOT CRYPTO**) | XXH3, rapidhash |
//!
//! These traits deliberately share a small set of repeated patterns:
//! streaming `new`/`update`/`finalize`/`reset` for stateful algorithms,
//! one-shot helpers for in-memory inputs, and opaque verification failures.
//!
//! # Error Types
//!
//! - [`VerificationError`] - Opaque error for MAC/AEAD/signature verification
//!
//! # Fallibility Discipline
//!
//! This module denies `unwrap`, `expect`, and indexing in non-test code to ensure
//! all error paths are handled explicitly.
#[cfg(any(
  feature = "aes-gcm",
  feature = "aes-gcm-siv",
  feature = "chacha20poly1305",
  feature = "xchacha20poly1305",
  feature = "aegis256",
  feature = "ascon-aead"
))]
mod aead;
mod checksum;
pub mod ct;
mod digest;
pub mod error;
mod fast_hash;
#[cfg(feature = "std")]
pub mod io;
mod mac;
mod xof;

#[cfg(any(
  feature = "aes-gcm",
  feature = "aes-gcm-siv",
  feature = "chacha20poly1305",
  feature = "xchacha20poly1305",
  feature = "aegis256",
  feature = "ascon-aead"
))]
pub use aead::Aead;
pub use checksum::{Checksum, ChecksumCombine};
pub use ct::ConstantTimeEq;
pub use digest::Digest;
pub use error::VerificationError;
pub use fast_hash::FastHash;
pub use mac::Mac;
pub use xof::Xof;