Enum ProxyError 

pub enum ProxyError {
    WebSocket(String),
    AuthenticationFailed(String),
    DestinationNotFound(IdentityFingerprint),
    Serialization(Error),
    ConnectionClosed,
    InvalidMessage(String),
    Io(Error),
    NotConnected,
    AlreadyConnected,
    AuthenticationTimeout,
    ChannelSendFailed,
}

Errors that can occur during proxy client or server operations.

Variants

WebSocket(String)

WebSocket connection or communication error.

Occurs when the underlying WebSocket connection fails, including network errors, protocol violations, or connection drops.

Example

WebSocket error: Connection refused (os error 61)

AuthenticationFailed(String)

Client authentication failed.

Occurs when:

• The client’s signature verification fails
• The challenge response is invalid
• The authentication handshake times out

Example

Authentication failed: Invalid signature

DestinationNotFound(IdentityFingerprint)

Attempted to send a message to a client that is not connected.

Occurs when sending a message to a fingerprint that:

• Never connected to the proxy
• Has disconnected
• Does not exist

Example

Destination not found: IdentityFingerprint("abc123...")

Serialization(Error)

Failed to serialize or deserialize a message.

Occurs when JSON encoding/decoding fails, usually due to:

• Corrupted message data
• Protocol version mismatch
• Invalid message format

ConnectionClosed

The WebSocket connection has been closed.

Occurs when attempting operations on a closed connection, either due to:

• Normal disconnection
• Network failure
• Server shutdown

InvalidMessage(String)

Received a message that violates the protocol.

Occurs when:

• A message is received in the wrong protocol phase
• Required authentication is missing
• Message format is invalid

Example

Invalid message: Cannot send messages before authentication

Io(Error)

Underlying I/O operation failed.

Occurs during file operations, socket operations, or other I/O tasks.

NotConnected

Attempted an operation that requires an active connection.

Occurs when calling methods like send_to() before calling connect().

AlreadyConnected

Attempted to connect when already connected.

Occurs when calling connect() multiple times without disconnecting.

AuthenticationTimeout

Authentication handshake did not complete within the timeout period.

Occurs when the client fails to respond to the authentication challenge in time. Default timeout is implementation-defined.

ChannelSendFailed

Failed to send a message through an internal channel.

Occurs when internal message passing fails, usually because:

• The receiving end has been dropped
• The channel is closed

This typically indicates a programming error or resource cleanup issue.

Trait Implementations

impl Debug for ProxyError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for ProxyError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for ProxyError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ProxyError

fn from(source: Error) -> ProxyError

Converts to this type from the input type.

impl From<Error> for ProxyError

fn from(source: Error) -> ProxyError

Converts to this type from the input type.