Enum SdkError 

pub enum SdkError {
    Unauthenticated,
    Unauthorized {
        permission: String,
    },
    ControllerRequired {
        holder: Option<String>,
        expires_at_ms: Option<u64>,
    },
    LeaseExpired,
    InvalidArgument {
        operation: SdkOperation,
        message: String,
    },
    NotFound {
        operation: SdkOperation,
        message: String,
    },
    UnsupportedAction(&'static str),
    UnsupportedOperation(String),
    ReplayGap(u64),
    Closed,
    Transport(String),
    UnknownRequest(u64),
    InvalidResponse(String),
    Submit(RuntimeSubmitError),
    Execution {
        operation: SdkOperation,
        message: String,
    },
}

Typed failure returned by every SDK adapter and compatibility projection.

Variants

Unauthenticated

A runtime operation was attempted without authenticated client state.

Unauthorized

The authenticated client lacks a required runtime permission.

Fields

permission: String

Stable permission spelling.

ControllerRequired

Mutation requires the controller lease. When another client owns it, its opaque identity and deadline are included for deterministic retry.

Fields

holder: Option<String>

Current controller, when known.

expires_at_ms: Option<u64>

Current controller deadline, when known.

LeaseExpired

This client previously controlled the runtime but its lease expired.

InvalidArgument

Input did not satisfy an operation contract.

Fields

operation: SdkOperation

Operation being decoded.

message: String

Validation detail.

NotFound

A stable identity was not found.

Fields

operation: SdkOperation

Operation being executed.

message: String

Lookup detail.

UnsupportedAction(&'static str)

The active adapter does not implement the requested action.

UnsupportedOperation(String)

The requested catalog operation is absent or has no typed route.

ReplayGap(u64)

A slow consumer fell behind the bounded live-event channel.

Closed

The runtime closed its event stream.

Transport(String)

An authenticated remote transport failed or returned an invalid value.

UnknownRequest(u64)

No live request exists for the supplied response id.

InvalidResponse(String)

The response kind or value does not match the pending request.

Submit(RuntimeSubmitError)

The canonical runtime rejected or failed a turn.

Execution

A session/runtime implementation failed after validation.

Fields

operation: SdkOperation

Operation being executed.

message: String

Implementation detail.

Implementations

impl SdkError

pub fn new( code: SdkErrorCode, operation: SdkOperation, message: impl Into<String>, ) -> Self

Construct a typed failure for an SDK operation.

pub fn unsupported(operation: SdkOperation) -> Self

Construct a named unsupported-action failure.

pub fn code(&self) -> SdkErrorCode

Stable machine-readable category.

pub fn operation(&self) -> Option<SdkOperation>

Operation associated with this failure when it is unambiguous.

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 From<RuntimeSubmitError> for SdkError

fn from(source: RuntimeSubmitError) -> Self

Converts to this type from the input type.

impl From<SdkError> for Error

fn from(source: SdkError) -> Self

Converts to this type from the input type.

impl PartialEq for SdkError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SdkError