qnsp 0.2.0

Official Rust SDK for the QNSP Quantum-Native Security Platform — post-quantum cryptography (ML-KEM, ML-DSA, SLH-DSA, Falcon via liboqs), PQC-encrypted vault, KMS, and immutable audit trails.
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

//! Typed error hierarchy for the QNSP Rust SDK.

use thiserror::Error;

/// Root error type for the SDK.
#[derive(Debug, Error)]
pub enum Error {
    /// DNS, TLS, timeout, or connection failure reaching QNSP.
    #[error("{0}")]
    Network(NetworkError),

    /// API key rejected at activation.
    #[error("{0}")]
    Auth(AuthError),

    /// A service returned 4xx/5xx with a structured body.
    #[error("{0}")]
    Api(ApiError),

    /// Webhook signature, replay, or shape failure.
    #[error("{0}")]
    Webhook(WebhookError),
}

#[derive(Debug, Error)]
#[error("qnsp: network error on {op} {url}: {cause}")]
pub struct NetworkError {
    pub op: String,
    pub url: String,
    pub cause: String,
}

#[derive(Debug, Error)]
#[error("qnsp: auth error{}: {message}", code.as_ref().map(|c| format!(" ({c})")).unwrap_or_default())]
pub struct AuthError {
    pub code: Option<String>,
    pub message: String,
}

#[derive(Debug, Error)]
#[error("qnsp: api error {status_code}{}: {message}", code.as_ref().map(|c| format!(" {c}")).unwrap_or_default())]
pub struct ApiError {
    pub status_code: u16,
    pub code: Option<String>,
    pub message: String,
    pub body: Option<serde_json::Value>,
}

#[derive(Debug, Error)]
#[error("qnsp: webhook error: {reason}")]
pub struct WebhookError {
    pub reason: String,
}

impl From<NetworkError> for Error {
    fn from(e: NetworkError) -> Self { Error::Network(e) }
}
impl From<AuthError> for Error {
    fn from(e: AuthError) -> Self { Error::Auth(e) }
}
impl From<ApiError> for Error {
    fn from(e: ApiError) -> Self { Error::Api(e) }
}
impl From<WebhookError> for Error {
    fn from(e: WebhookError) -> Self { Error::Webhook(e) }
}