Enum SettlementHookError 

pub enum SettlementHookError {
    InvalidObservation(String),
    Transient(String),
    Permanent(String),
    Pipeline(SettlementError),
}

Errors that may surface from a SettlementHook. All variants are fail-closed: the paired observer runtime preserves their typed disposition for durable routing, while the dispatch path is never rolled back.

Variants

InvalidObservation(String)

The supplied observation was malformed.

Transient(String)

The downstream settlement pipeline reported a transient error. Implementations SHOULD prefer SettlementOutcome::Retryable over surfacing this variant; it is provided for hooks that cannot classify the failure synchronously.

Permanent(String)

The downstream settlement pipeline reported a permanent error.

Pipeline(SettlementError)

A lower-level SettlementError surfaced from the ops pipeline.

Implementations

impl SettlementHookError

pub fn classification( &self, ) -> (SettlementFailureClass, SettlementFailureReason)

Return the retry disposition and bounded reason for this error.

Trait Implementations

impl Debug for SettlementHookError

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

Formats the value using the given formatter.

impl Display for SettlementHookError

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

Formats the value using the given formatter.

impl Error for SettlementHookError

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<SettlementError> for SettlementHookError

fn from(source: SettlementError) -> Self

Converts to this type from the input type.