moonpool_transport/
error.rs

1//! Error types for the moonpool messaging layer.
2
3use crate::UID;
4
5/// Errors that can occur in the messaging layer.
6#[derive(Debug, Clone, thiserror::Error)]
7#[non_exhaustive]
8pub enum MessagingError {
9    /// Endpoint not found for the given token.
10    #[error("endpoint not found: {token}")]
11    EndpointNotFound {
12        /// The token that was not found.
13        token: UID,
14    },
15
16    /// Failed to deserialize a message.
17    #[error("deserialization failed: {message}")]
18    DeserializationFailed {
19        /// Details about the deserialization failure.
20        message: String,
21    },
22
23    /// Failed to serialize a message.
24    #[error("serialization failed: {message}")]
25    SerializationFailed {
26        /// Details about the serialization failure.
27        message: String,
28    },
29
30    /// Peer connection error.
31    #[error("peer error: {message}")]
32    PeerError {
33        /// Details about the peer error.
34        message: String,
35    },
36
37    /// Invalid well-known token index.
38    #[error("invalid well-known token: {index} (max: {max})")]
39    InvalidWellKnownToken {
40        /// The invalid token index.
41        index: u32,
42        /// Maximum allowed index.
43        max: usize,
44    },
45
46    /// Invalid state for the requested operation.
47    #[error("invalid state: {message}")]
48    InvalidState {
49        /// Details about the invalid state.
50        message: String,
51    },
52
53    /// Network operation failed.
54    #[error("network error: {message}")]
55    NetworkError {
56        /// Details about the network error.
57        message: String,
58    },
59
60    /// Builder missing required local address.
61    #[error("local_address is required - call .local_address(addr) before .build()")]
62    MissingLocalAddress,
63}
64
65impl From<serde_json::Error> for MessagingError {
66    fn from(err: serde_json::Error) -> Self {
67        MessagingError::DeserializationFailed {
68            message: err.to_string(),
69        }
70    }
71}
72
73impl From<crate::PeerError> for MessagingError {
74    fn from(err: crate::PeerError) -> Self {
75        MessagingError::PeerError {
76            message: err.to_string(),
77        }
78    }
79}
moonpool_transport/error.rs

moonpool_transport/
error.rs
