chaincraft_rust/
error.rs

1//! Error types for the Chaincraft library
2
3use std::net::SocketAddr;
4use thiserror::Error;
5
6/// Result type alias for Chaincraft operations
7pub type Result<T> = std::result::Result<T, ChaincraftError>;
8
9/// Main error type for Chaincraft operations
10#[derive(Error, Debug)]
11pub enum ChaincraftError {
12    /// Network-related errors
13    #[error("Network error: {0}")]
14    Network(#[from] NetworkError),
15
16    /// Cryptographic errors
17    #[error("Cryptographic error: {0}")]
18    Crypto(#[from] CryptoError),
19
20    /// Storage-related errors
21    #[error("Storage error: {0}")]
22    Storage(#[from] StorageError),
23
24    /// Serialization errors
25    #[error("Serialization error: {0}")]
26    Serialization(#[from] SerializationError),
27
28    /// Validation errors
29    #[error("Validation error: {0}")]
30    Validation(String),
31
32    /// Consensus-related errors
33    #[error("Consensus error: {0}")]
34    Consensus(String),
35
36    /// Configuration errors
37    #[error("Configuration error: {0}")]
38    Config(String),
39
40    /// Generic IO errors
41    #[error("IO error: {0}")]
42    Io(#[from] std::io::Error),
43
44    /// Generic errors with message
45    #[error("{0}")]
46    Generic(String),
47}
48
49/// Network-specific error types
50#[derive(Error, Debug)]
51pub enum NetworkError {
52    /// Failed to bind to socket
53    #[error("Failed to bind to {addr}: {source}")]
54    BindFailed {
55        addr: SocketAddr,
56        source: std::io::Error,
57    },
58
59    /// Failed to connect to peer
60    #[error("Failed to connect to {addr}: {source}")]
61    ConnectionFailed {
62        addr: SocketAddr,
63        source: std::io::Error,
64    },
65
66    /// Peer is banned
67    #[error("Peer {addr} is banned until {expires_at}")]
68    PeerBanned {
69        addr: SocketAddr,
70        expires_at: chrono::DateTime<chrono::Utc>,
71    },
72
73    /// Message too large
74    #[error("Message size {size} exceeds maximum {max_size}")]
75    MessageTooLarge { size: usize, max_size: usize },
76
77    /// Invalid message format
78    #[error("Invalid message format: {reason}")]
79    InvalidMessage { reason: String },
80
81    /// Timeout occurred
82    #[error("Operation timed out after {duration:?}")]
83    Timeout { duration: std::time::Duration },
84
85    /// No peers available
86    #[error("No peers available for operation")]
87    NoPeersAvailable,
88}
89
90/// Cryptographic error types
91#[derive(Error, Debug)]
92pub enum CryptoError {
93    /// Invalid signature
94    #[error("Invalid signature")]
95    InvalidSignature,
96
97    /// Invalid public key
98    #[error("Invalid public key: {reason}")]
99    InvalidPublicKey { reason: String },
100
101    /// Invalid private key
102    #[error("Invalid private key: {reason}")]
103    InvalidPrivateKey { reason: String },
104
105    /// Hash verification failed
106    #[error("Hash verification failed")]
107    HashVerificationFailed,
108
109    /// Proof of work verification failed
110    #[error("Proof of work verification failed")]
111    ProofOfWorkFailed,
112
113    /// VRF verification failed
114    #[error("VRF verification failed")]
115    VrfVerificationFailed,
116
117    /// VDF verification failed
118    #[error("VDF verification failed")]
119    VdfVerificationFailed,
120
121    /// VDF error (solve/verify)
122    #[error("VDF error: {reason}")]
123    VdfError { reason: String },
124
125    /// Key generation failed
126    #[error("Key generation failed: {reason}")]
127    KeyGenerationFailed { reason: String },
128
129    /// Encryption failed
130    #[error("Encryption failed: {reason}")]
131    EncryptionFailed { reason: String },
132
133    /// Decryption failed
134    #[error("Decryption failed: {reason}")]
135    DecryptionFailed { reason: String },
136}
137
138/// Storage-related error types
139#[derive(Error, Debug)]
140pub enum StorageError {
141    /// Database operation failed
142    #[error("Database operation failed: {reason}")]
143    DatabaseOperation { reason: String },
144
145    /// Key not found
146    #[error("Key not found: {key}")]
147    KeyNotFound { key: String },
148
149    /// Serialization failed
150    #[error("Failed to serialize data: {reason}")]
151    SerializationFailed { reason: String },
152
153    /// Deserialization failed
154    #[error("Failed to deserialize data: {reason}")]
155    DeserializationFailed { reason: String },
156
157    /// Database corruption detected
158    #[error("Database corruption detected: {reason}")]
159    Corruption { reason: String },
160
161    /// Database is read-only
162    #[error("Attempted to write to read-only database")]
163    ReadOnly,
164
165    /// Transaction failed
166    #[error("Transaction failed: {reason}")]
167    TransactionFailed { reason: String },
168}
169
170/// Serialization error types
171#[derive(Error, Debug)]
172pub enum SerializationError {
173    /// JSON serialization error
174    #[error("JSON error: {0}")]
175    Json(#[from] serde_json::Error),
176
177    /// Binary serialization error
178    #[error("Binary serialization error: {0}")]
179    Binary(#[from] bincode::Error),
180
181    /// Invalid message format
182    #[error("Invalid message format: expected {expected}, got {actual}")]
183    InvalidFormat { expected: String, actual: String },
184
185    /// Missing required field
186    #[error("Missing required field: {field}")]
187    MissingField { field: String },
188
189    /// Field validation failed
190    #[error("Field validation failed for {field}: {reason}")]
191    FieldValidation { field: String, reason: String },
192}
193
194impl ChaincraftError {
195    /// Create a validation error
196    pub fn validation<T: Into<String>>(msg: T) -> Self {
197        ChaincraftError::Validation(msg.into())
198    }
199
200    /// Create a consensus error
201    pub fn consensus<T: Into<String>>(msg: T) -> Self {
202        ChaincraftError::Consensus(msg.into())
203    }
204
205    /// Create a configuration error
206    pub fn config<T: Into<String>>(msg: T) -> Self {
207        ChaincraftError::Config(msg.into())
208    }
209
210    /// Create a generic error
211    pub fn generic<T: Into<String>>(msg: T) -> Self {
212        ChaincraftError::Generic(msg.into())
213    }
214}
215
216impl From<serde_json::Error> for ChaincraftError {
217    fn from(err: serde_json::Error) -> Self {
218        ChaincraftError::Serialization(SerializationError::Json(err))
219    }
220}
chaincraft_rust/error.rs

chaincraft_rust/
error.rs
