nautilus_bybit/websocket/
error.rs

1// -------------------------------------------------------------------------------------------------
2//  Copyright (C) 2015-2025 Nautech Systems Pty Ltd. All rights reserved.
3//  https://nautechsystems.io
4//
5//  Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6//  You may not use this file except in compliance with the License.
7//  You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9//  Unless required by applicable law or agreed to in writing, software
10//  distributed under the License is distributed on an "AS IS" BASIS,
11//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12//  See the License for the specific language governing permissions and
13//  limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16//! Error types for Bybit WebSocket client operations.
17
18use nautilus_network::error::SendError;
19use thiserror::Error;
20
21/// Result alias for Bybit WebSocket operations.
22pub type BybitWsResult<T> = Result<T, BybitWsError>;
23
24/// Error type for Bybit WebSocket client failures.
25#[derive(Debug, Error)]
26pub enum BybitWsError {
27    /// The WebSocket client is not currently connected.
28    #[error("WebSocket not connected")]
29    NotConnected,
30
31    /// Failed to send a message over the WebSocket connection.
32    #[error("WebSocket send error: {0}")]
33    Send(String),
34
35    /// Underlying transport error from the WebSocket implementation.
36    #[error("WebSocket transport error: {0}")]
37    Transport(String),
38
39    /// Failed to parse or serialize JSON payloads.
40    #[error("JSON error: {0}")]
41    Json(String),
42
43    /// Authentication handshake failed or timed out.
44    #[error("Authentication error: {0}")]
45    Authentication(String),
46
47    /// Client-side validation or logic error.
48    #[error("Client error: {0}")]
49    ClientError(String),
50}
51
52impl From<SendError> for BybitWsError {
53    fn from(error: SendError) -> Self {
54        Self::Send(error.to_string())
55    }
56}
57
58impl From<tokio_tungstenite::tungstenite::Error> for BybitWsError {
59    fn from(error: tokio_tungstenite::tungstenite::Error) -> Self {
60        Self::Transport(error.to_string())
61    }
62}
63
64impl From<serde_json::Error> for BybitWsError {
65    fn from(error: serde_json::Error) -> Self {
66        Self::Json(error.to_string())
67    }
68}