enfinitos-sdk-auditor 0.0.1

EnfinitOS Auditor / Verifier SDK (Rust) — cryptographic verification library that regulators, auditors, courts, and third parties use to verify signed proof packs issued by EnfinitOS without trusting the vendor. Offline-by-default; verifies Ed25519 signatures, walks the proof hash chain, re-projects metering, and re-computes settlement reconciliation.
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//! Typed error envelope. Mirrors the TS/Py shape: audit failures stay
//! inside the report; operational errors raise this type.

use crate::types::AuditReasonCode;
use thiserror::Error;

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum AuditorErrorCode {
    InvalidInput,
    KeysUnavailable,
    KeysMalformed,
    PlatformResponse,
    Internal,
}

impl AuditorErrorCode {
    pub fn as_str(&self) -> &'static str {
        match self {
            AuditorErrorCode::InvalidInput => "INVALID_INPUT",
            AuditorErrorCode::KeysUnavailable => "KEYS_UNAVAILABLE",
            AuditorErrorCode::KeysMalformed => "KEYS_MALFORMED",
            AuditorErrorCode::PlatformResponse => "PLATFORM_RESPONSE",
            AuditorErrorCode::Internal => "INTERNAL",
        }
    }
}

/// Raised only for operational failures the SDK could not reduce to a
/// structured AuditReport step.
#[derive(Debug, Error)]
#[error("{message}")]
pub struct AuditorError {
    pub code: AuditorErrorCode,
    pub message: String,
    pub reason: Option<AuditReasonCode>,
    pub detail: Option<serde_json::Value>,
}

impl AuditorError {
    pub fn invalid_input(message: impl Into<String>) -> Self {
        Self {
            code: AuditorErrorCode::InvalidInput,
            message: message.into(),
            reason: None,
            detail: None,
        }
    }

    pub fn with_reason(mut self, reason: AuditReasonCode) -> Self {
        self.reason = Some(reason);
        self
    }

    pub fn with_detail(mut self, detail: serde_json::Value) -> Self {
        self.detail = Some(detail);
        self
    }

    pub fn keys_malformed(message: impl Into<String>) -> Self {
        Self {
            code: AuditorErrorCode::KeysMalformed,
            message: message.into(),
            reason: None,
            detail: None,
        }
    }

    pub fn keys_unavailable(message: impl Into<String>) -> Self {
        Self {
            code: AuditorErrorCode::KeysUnavailable,
            message: message.into(),
            reason: None,
            detail: None,
        }
    }

    pub fn platform_response(message: impl Into<String>) -> Self {
        Self {
            code: AuditorErrorCode::PlatformResponse,
            message: message.into(),
            reason: None,
            detail: None,
        }
    }

    pub fn internal(message: impl Into<String>) -> Self {
        Self {
            code: AuditorErrorCode::Internal,
            message: message.into(),
            reason: None,
            detail: None,
        }
    }
}

impl From<serde_json::Error> for AuditorError {
    fn from(e: serde_json::Error) -> Self {
        AuditorError::invalid_input(format!("JSON parse error: {e}"))
    }
}