openlibx402-core 0.0.3

Core library for the X402 payment protocol with Solana blockchain integration
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use serde::{Deserialize, Serialize};
use thiserror::Error;

/// Base error type for all X402 operations
#[derive(Debug, Error, Clone, Serialize, Deserialize)]
#[serde(tag = "type", content = "details")]
pub enum X402Error {
    #[error("Payment required: {0}")]
    PaymentRequired(String),

    #[error("Payment expired: {0}")]
    PaymentExpired(String),

    #[error("Insufficient funds: {0}")]
    InsufficientFunds(String),

    #[error("Payment verification failed: {0}")]
    PaymentVerification(String),

    #[error("Transaction broadcast failed: {0}")]
    TransactionBroadcast(String),

    #[error("Invalid payment request: {0}")]
    InvalidPaymentRequest(String),

    #[error("Invalid payment authorization: {0}")]
    InvalidPaymentAuthorization(String),

    #[error("Configuration error: {0}")]
    Configuration(String),

    #[error("Network error: {0}")]
    Network(String),

    #[error("Blockchain error: {0}")]
    Blockchain(String),

    #[error("Serialization error: {0}")]
    Serialization(String),
}

impl X402Error {
    /// Get the error code for this error type
    pub fn code(&self) -> &'static str {
        match self {
            X402Error::PaymentRequired(_) => "PAYMENT_REQUIRED",
            X402Error::PaymentExpired(_) => "PAYMENT_EXPIRED",
            X402Error::InsufficientFunds(_) => "INSUFFICIENT_FUNDS",
            X402Error::PaymentVerification(_) => "PAYMENT_VERIFICATION_FAILED",
            X402Error::TransactionBroadcast(_) => "TRANSACTION_BROADCAST_FAILED",
            X402Error::InvalidPaymentRequest(_) => "INVALID_PAYMENT_REQUEST",
            X402Error::InvalidPaymentAuthorization(_) => "INVALID_PAYMENT_AUTHORIZATION",
            X402Error::Configuration(_) => "CONFIGURATION_ERROR",
            X402Error::Network(_) => "NETWORK_ERROR",
            X402Error::Blockchain(_) => "BLOCKCHAIN_ERROR",
            X402Error::Serialization(_) => "SERIALIZATION_ERROR",
        }
    }

    /// Get the error message
    pub fn message(&self) -> String {
        self.to_string()
    }
}

/// Result type alias for X402 operations
pub type X402Result<T> = Result<T, X402Error>;

// Implement From conversions for common error types
impl From<serde_json::Error> for X402Error {
    fn from(err: serde_json::Error) -> Self {
        X402Error::Serialization(err.to_string())
    }
}

impl From<base64::DecodeError> for X402Error {
    fn from(err: base64::DecodeError) -> Self {
        X402Error::Serialization(format!("Base64 decode error: {}", err))
    }
}

impl From<solana_sdk::signer::SignerError> for X402Error {
    fn from(err: solana_sdk::signer::SignerError) -> Self {
        X402Error::Blockchain(format!("Signer error: {}", err))
    }
}

impl From<solana_client::client_error::ClientError> for X402Error {
    fn from(err: solana_client::client_error::ClientError) -> Self {
        X402Error::Blockchain(format!("Solana client error: {}", err))
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_error_codes() {
        assert_eq!(
            X402Error::PaymentRequired("test".to_string()).code(),
            "PAYMENT_REQUIRED"
        );
        assert_eq!(
            X402Error::PaymentExpired("test".to_string()).code(),
            "PAYMENT_EXPIRED"
        );
        assert_eq!(
            X402Error::InsufficientFunds("test".to_string()).code(),
            "INSUFFICIENT_FUNDS"
        );
    }

    #[test]
    fn test_error_serialization() {
        let error = X402Error::PaymentRequired("Test payment required".to_string());
        let json = serde_json::to_string(&error).unwrap();
        let deserialized: X402Error = serde_json::from_str(&json).unwrap();
        assert_eq!(error.code(), deserialized.code());
    }
}