Enum DigestAlgorithm 

#[non_exhaustive]
pub enum DigestAlgorithm {
    Blake3Untagged,
    Blake3Keyed {
        key: [u8; 32],
    },
    Blake3DomainSeparated {
        context: String,
    },
    Sha256,
}

Digest algorithm variant.

Explicit enum so the algorithm choice is a named governance decision rather than an implicit default. Blake3Untagged is the plain blake3::hash pattern; keyed and domain-separated variants carry their differentiating input so two uses with different keys or contexts cannot accidentally collide on a digest.

Sha256 is declared but not yet wired in this crate; requesting it returns JcsError::UnsupportedAlgorithm. The variant exists so receipt schemas and policy packs can reference it without waiting for the implementation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Blake3Untagged

BLAKE3 plain hash(canonical_bytes).

Blake3Keyed

BLAKE3 keyed with a 32-byte key: keyed_hash(key, canonical_bytes).

Fields

key: [u8; 32]

Domain key. Value is load-bearing for the digest; choose it once per receipt domain and never reuse across unrelated domains.

Blake3DomainSeparated

BLAKE3 domain-separated via derive_key(context, canonical_bytes). The context string is the domain identifier (must be a compile-time constant in user code — BLAKE3 semantics require it to be globally unique per domain).

Fields

context: String

Domain context string.

Sha256

SHA-256 over canonical bytes. Declared in the API but not yet wired.

Implementations

impl DigestAlgorithm

pub const fn name(&self) -> &'static str

Short stable name suitable for use in receipt schemas and logs.

Trait Implementations

impl Clone for DigestAlgorithm

fn clone(&self) -> DigestAlgorithm

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DigestAlgorithm

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

Formats the value using the given formatter.

impl PartialEq for DigestAlgorithm

fn eq(&self, other: &DigestAlgorithm) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DigestAlgorithm

impl StructuralPartialEq for DigestAlgorithm