Enum WebSocketErrorKind 

#[non_exhaustive]
pub enum WebSocketErrorKind {
    Protocol,
    Capacity,
    Utf8,
    Tls,
    Io,
    Http(u16),
    Other,
}

Coarse-grained classification of the source of a MarketDataError.

Returned by MarketDataError::source_kind so downstream code can branch on the category of failure (network glitch vs SDK / protocol bug vs auth vs caller-side validation) without pattern-matching every variant or string-matching the embedded msg.

The enum is #[non_exhaustive] so future variants can be added in a minor release without breaking exhaustive matches. Refined classification of a MarketDataError::WebSocketError.

Mirrors tungstenite::Error’s own categorization without leaking the upstream dependency type. Returned by pattern-matching the structured kind field on the variant.

The enum is #[non_exhaustive] so future tungstenite releases or new error sources can add variants without breaking exhaustive matches.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Protocol

Protocol-level violation: malformed frame, illegal state transition, reserved bits set. Never retryable — indicates an SDK / version mismatch or a server-side bug.

Capacity

Frame exceeded the configured max_message_size / max_frame_size. Never retryable; the producer is misbehaving.

Utf8

UTF-8 decoding failed on a text frame. Never retryable; the producer emitted invalid bytes.

Tls

TLS / certificate failure during the WebSocket handshake. Treated as authentication-adjacent — never retryable without operator action.

Io

Transport IO failure: connection reset, EOF, write error, etc. Retryable with backoff.

Http(u16)

HTTP error during the WebSocket upgrade. u16 is the status code.

Status code mapping

Authoritative grid for monitor / incident-classifier code that branches on WebSocketErrorKind::Http(_). MarketDataError::source_kind and MarketDataError::is_retryable honour this exact mapping; the #[cfg(test)] http_mapping_consistency module in this file pins the doc-vs-impl contract so silent drift fails CI.

Status range	ErrorKind	is_retryable
401, 403	Auth	false
429	RateLimit	true
500..=599	Network	true
other 4xx (e.g. 404)	Client	false
anything else	Client	false

Auth and Client failures are non-retryable because the upstream rejection will not change between attempts; RateLimit and 5xx retry with the configured backoff. Other 4xx codes (including 404) surface as Client rather than Network because the server has stated, conclusively, that the request is wrong.

Other

Anything tungstenite adds in the future, or an error we can’t classify. Retryable (conservative default).

Trait Implementations

impl Clone for WebSocketErrorKind

fn clone(&self) -> WebSocketErrorKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WebSocketErrorKind

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

Formats the value using the given formatter.

impl Hash for WebSocketErrorKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WebSocketErrorKind

fn eq(&self, other: &WebSocketErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for WebSocketErrorKind

impl Eq for WebSocketErrorKind

impl StructuralPartialEq for WebSocketErrorKind