Enum RuntimeError 

#[non_exhaustive]
pub enum RuntimeError {
    UnknownOperation {
        name: String,
    },
    MissingHandler {
        name: String,
    },
    Handler {
        name: String,
        code: String,
        message: String,
    },
    Denied {
        name: String,
        code: String,
        message: String,
    },
    ReceiptSink {
        name: String,
        message: String,
        caused_by_handler: Option<ReceiptSinkHandlerCause>,
    },
    StatusSink {
        name: String,
        message: String,
        caused_by_handler: Option<ReceiptSinkHandlerCause>,
    },
}

Error returned by synchronous operation dispatch.

#[non_exhaustive] so the wire-error vocabulary can grow (e.g. rate-limit, auth, schema-mismatch variants) without breaking downstream matches that translate RuntimeError into transport- layer error codes.

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.

UnknownOperation

The requested operation name is not known to the runtime.

Fields

name: String

Requested operation name.

MissingHandler

The operation descriptor exists, but no handler is available.

Fields

name: String

Requested operation name.

Handler

The handler rejected the invocation.

Fields

name: String

Operation name being handled.

code: String

Handler-supplied error class.

message: String

Handler-supplied error message.

Denied

Runtime policy denied the invocation. Admission guards and observed effect-row enforcement both record a Denied receipt before returning this variant.

Fields

name: String

Operation name that was denied.

code: String

Guard-supplied denial class.

message: String

Guard-supplied denial message.

ReceiptSink

The configured receipt sink rejected a runtime-emitted receipt.

Fields

name: String

Operation name whose receipt could not be recorded.

message: String

Sink error message.

caused_by_handler: Option<ReceiptSinkHandlerCause>

Handler failure that preceded this sink failure, when present.

StatusSink

The configured operation-status sink rejected a runtime-emitted fact.

Fields

name: String

Operation name whose status fact could not be recorded.

message: String

Sink error message.

caused_by_handler: Option<ReceiptSinkHandlerCause>

Handler failure that preceded this sink failure, when present.

Implementations

impl RuntimeError

pub fn unknown_operation(name: impl Into<String>) -> Self

Build an unknown-operation error.

pub fn missing_handler(name: impl Into<String>) -> Self

Build a missing-handler error.

pub fn handler( name: impl Into<String>, code: impl Into<String>, message: impl Into<String>, ) -> Self

Build a handler error with an operation name and message.

pub fn denied( name: impl Into<String>, code: impl Into<String>, message: impl Into<String>, ) -> Self

Build an admission-denied error with an operation name, class, and message.

pub fn receipt_sink(name: impl Into<String>, message: impl Into<String>) -> Self

Build a receipt-sink error with an operation name and message.

pub fn receipt_sink_after_handler_failure( name: impl Into<String>, message: impl Into<String>, cause: ReceiptSinkHandlerCause, ) -> Self

Build a receipt-sink error after a handler failure.

pub fn status_sink(name: impl Into<String>, message: impl Into<String>) -> Self

Build a status-sink error with an operation name and message.

pub fn status_sink_after_handler_failure( name: impl Into<String>, message: impl Into<String>, cause: ReceiptSinkHandlerCause, ) -> Self

Build a status-sink error after a handler failure.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Eq for RuntimeError

impl Error for RuntimeError

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 RuntimeError

fn eq(&self, other: &RuntimeError) -> 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 StructuralPartialEq for RuntimeError