open-standards/smart-byte/smart-byte-rs/crates/smart-byte-did/src/error.rs
Transaction Science 01d4ad9c7b Ingest batch 2: 9 new crates across openpay / smart-byte / eoc
openpay/ (+3 crates, ~8400 LOC, 162 tests)
  op-iso8583/         ISO 8583 messages for direct acquirer / card-network
                      connectivity. MTIs, primary+secondary bitmaps, full
                      DE catalogue, BCD/ASCII/EBCDIC/LLVAR/LLLVAR codecs,
                      five dialects (Visa Base I, Mastercard MDS, Amex GNS,
                      Discover, JCB), network-management messages
                      (sign-on/echo/cutover), DE 55 EMV TLV.
  op-mobile-wallets/  Apple Pay (ECDH-P256 + AES-256-GCM), Google Pay ECv2
                      (ECDH + HKDF + AES-256-CTR + HMAC), Samsung Pay. PAN
                      never leaves the decryption boundary as a String;
                      lands in VaultRef. No-PAN-leakage assertions per
                      wallet.
  op-routing/         Least-cost routing + MCC-aware routing + intelligent
                      retry / soft-decline recovery. 231-MCC catalogue.
                      Real ISO 8583 DE-39 soft/hard decline taxonomies.

smart-byte/smart-byte-rs/ (+3 crates, ~7100 LOC, 96 tests)
  smart-byte-vc/      W3C Verifiable Credentials 2.0: VCDM, presentations,
                      Data Integrity proofs (eddsa-jcs-2022), VC-JWT,
                      SD-JWT (selective disclosure), Bitstring Status
                      List 2021. Cargo-bridge maps VCs to Smart Byte
                      envelopes with SAID stability.
  smart-byte-did/     W3C DID resolution: did:key (Ed25519/P-256/secp256k1),
                      did:web (HTTPS), did:peer (numalgo 2+4), did:jwk,
                      did:ion (feature-gated stub). DID URL dereferencer.
  smart-byte-pq/      Post-quantum signatures: ML-DSA-44/65/87 (FIPS 204),
                      SLH-DSA across 12 parameter sets (FIPS 205), FN-DSA
                      (draft FIPS 206, feature-gated). Hybrid Ed25519 +
                      ML-DSA pattern for the transition. Secret-key
                      zeroize-on-drop.

eoc/eoc-rs/ (+3 crates, ~6450 LOC, 76 tests)
  eoc-vendor-api/     NeuralBackend implementations: Anthropic, OpenAI,
                      Google, Mistral, Cohere, Groq, Together, Fireworks.
                      SSE streaming. Prompt-caching where supported.
                      Joule estimates per published energy coefficient
                      (12-model curated table).
  eoc-embeddings/     21 embedding models behind one Embedder trait:
                      OpenAI v3 (3), Cohere v3 (3), Voyage (5), Mistral,
                      Jina, plus local ONNX (BGE x3, nomic, mxbai, GTE,
                      E5) behind 'local' feature. Matryoshka-style
                      dimension projection. Per-content-hash cache.
  eoc-route-learned/  RouteLLM-style matrix-factorisation router +
                      multinomial-logreg classifier + LinUCB / Thompson
                      bandits for online learning. LearnedCascade wraps
                      the rule-based cascade with a confidence-threshold
                      skip policy. Synthetic-eval accuracy: MF 0.935,
                      LogReg 0.980.

Quality:
- cargo check across all three workspaces: clean
- cargo clippy --all-targets -- -D warnings on every new crate: clean
- 334 new tests total; all passing
- #![forbid(unsafe_code)] across every new crate
- No unwrap/expect outside #[cfg(test)]

Rust 1.95.0 edition 2024 (inherited via root rust-toolchain.toml).
2026-05-23 18:12:24 -04:00

66 lines
2.3 KiB
Rust

//! Typed errors for DID parsing and resolution.
use thiserror::Error;
/// All DID-side errors collapse to a single typed enum so callers can
/// match on the kind without depending on intermediate crates.
#[derive(Debug, Error)]
pub enum DidError {
/// The DID method requested has no resolver registered in this build.
#[error("DID method not supported: {0}")]
MethodNotSupported(String),
/// DID syntax did not match `did:<method>:<id>`.
#[error("invalid DID identifier: {0}")]
InvalidIdentifier(String),
/// DID URL syntax (path/query/fragment) is malformed.
#[error("invalid DID URL: {0}")]
InvalidDidUrl(String),
/// Resolution succeeded structurally but the document was not found.
#[error("DID document not found: {0}")]
NotFound(String),
/// The decoded payload was not a valid DID document.
#[error("invalid DID document: {0}")]
InvalidDocument(String),
/// Network I/O failure during did:web (or other network-bound) resolution.
#[error("network error: {0}")]
NetworkError(String),
/// Multibase encoding/decoding failed.
#[error("multibase error: {0}")]
Multibase(String),
/// Base64 encoding/decoding failed.
#[error("base64 error: {0}")]
Base64(String),
/// JSON encode/decode failed.
#[error("json error: {0}")]
Json(String),
/// Multicodec prefix did not match a supported key type.
#[error("unsupported key codec: 0x{0:x}")]
UnsupportedKeyCodec(u64),
/// Cryptographic key material was structurally invalid.
#[error("invalid key material: {0}")]
InvalidKey(String),
/// A signature-method/key-type combination was inconsistent.
#[error("signature method mismatch: {0}")]
SignatureMethodMismatch(String),
/// The DID method is recognised but this build only stubs it.
#[error("DID method is stubbed in this build: {0}")]
Stubbed(String),
}
impl From<multibase::Error> for DidError {
fn from(e: multibase::Error) -> Self {
DidError::Multibase(e.to_string())
}
}
impl From<serde_json::Error> for DidError {
fn from(e: serde_json::Error) -> Self {
DidError::Json(e.to_string())
}
}
impl From<base64::DecodeError> for DidError {
fn from(e: base64::DecodeError) -> Self {
DidError::Base64(e.to_string())
}
}