ows-pay 1.2.1

Payment client for the Open Wallet Standard (x402)
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

use thiserror::Error;

/// Error codes for programmatic handling.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum PayErrorCode {
    /// HTTP transport error (DNS, TLS, timeout).
    HttpTransport,
    /// Server returned an unexpected HTTP status.
    HttpStatus,
    /// Protocol-level error (malformed 402, bad header encoding).
    ProtocolMalformed,
    /// Could not detect which payment protocol to use.
    ProtocolUnknown,
    /// Wallet not found or inaccessible.
    WalletNotFound,
    /// Key decryption or signing failed.
    SigningFailed,
    /// No supported chain/network in the payment requirements.
    UnsupportedChain,
    /// Discovery API error.
    DiscoveryFailed,
    /// Invalid input (e.g. unsupported HTTP method).
    InvalidInput,
}

#[derive(Debug, Error)]
#[error("[{code:?}] {message}")]
pub struct PayError {
    pub code: PayErrorCode,
    pub message: String,
}

impl PayError {
    pub fn new(code: PayErrorCode, message: impl Into<String>) -> Self {
        Self {
            code,
            message: message.into(),
        }
    }
}

impl From<reqwest::Error> for PayError {
    fn from(e: reqwest::Error) -> Self {
        PayError::new(PayErrorCode::HttpTransport, e.to_string())
    }
}

impl From<serde_json::Error> for PayError {
    fn from(e: serde_json::Error) -> Self {
        PayError::new(PayErrorCode::ProtocolMalformed, format!("json: {e}"))
    }
}