Enum SdkError 

pub enum SdkError {
    Connection {
        description: String,
    },
    Protocol {
        description: String,
    },
    Serialization {
        description: String,
    },
    TypeValidation {
        description: String,
    },
    Backpressure {
        reason: String,
    },
    Conversation {
        conversation_id: String,
        description: String,
    },
    Store {
        description: String,
    },
}

Error taxonomy returned by the Rust SDK API surface.

The SDK keeps application code independent from transport, protocol framing, and core implementation error types. Concrete embedded and remote adapters map their internal failures into these variants.

Clone is derived so a failure can be both RETAINED and RETURNED at the same seam. A store failure that bricks a participant handle is exactly that shape: the error travels to the caller of the failing operation, while a copy stays behind as the reason every later call reports RemoteParticipantError::StateUnavailable. Without it the cause is observable exactly once and only by whoever happened to make the failing call.

Variants

Connection

Establishing, keeping, or recovering a client connection failed.

Fields

description: String

Human-readable context from the failing connection operation.

Protocol

Encoding, decoding, or interpreting SDK-internal protocol state failed.

Fields

description: String

Human-readable protocol failure context.

Serialization

Serialising an outbound value or deserialising an inbound value failed.

Fields

description: String

Human-readable serialization failure context.

TypeValidation

A typed message did not satisfy the schema declared for its channel.

Fields

description: String

Human-readable type-validation context.

Backpressure

A publish operation encountered application-visible backpressure.

Fields

reason: String

Human-readable pressure reason.

Conversation

A conversation operation failed.

Fields

conversation_id: String

Application-visible conversation identifier.

description: String

Human-readable conversation failure context.

Store

Persisted subscription or recovery state could not be read or written.

Fields

description: String

Human-readable store failure context.

Trait Implementations

impl Clone for SdkError

fn clone(&self) -> SdkError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SdkError

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

Formats the value using the given formatter.

impl Display for SdkError

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

Formats the value using the given formatter.

impl Eq for SdkError

impl Error for SdkError

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 PartialEq for SdkError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SdkError