Enum SettlementOutcome 

pub enum SettlementOutcome {
    Accepted {
        schema: String,
        transcript_id: String,
    },
    Skipped {
        schema: String,
        reason: SettlementSkipReason,
    },
    Retryable {
        schema: String,
        reason: SettlementFailureReason,
    },
    Permanent {
        schema: String,
        reason: SettlementFailureReason,
    },
}

Outcome returned by a settlement hook.

Variants

Accepted

The hook accepted the observation and routed it through the existing chio-settle/ops.rs pipeline. The opaque transcript id lets operators correlate the kernel-side observation with the downstream settlement record.

Fields

schema: String

Schema tag (chio.settle.outcome.v1).

transcript_id: String

Stable transcript identifier produced by the ops pipeline.

Skipped

The receipt requires no settlement work.

Fields

schema: String

Schema tag (chio.settle.outcome.v1).

reason: SettlementSkipReason

Closed reason for skipping settlement.

Retryable

The hook rejected the observation with a recoverable failure.

Fields

schema: String

Schema tag (chio.settle.outcome.v1).

reason: SettlementFailureReason

Bounded failure reason carried across retries.

Permanent

The hook rejected the observation permanently.

Fields

schema: String

Schema tag (chio.settle.outcome.v1).

reason: SettlementFailureReason

Bounded failure reason carried into the dead letter.

Implementations

impl SettlementOutcome

pub fn has_supported_schema(&self) -> bool

Return whether this outcome uses the schema understood by this build.

pub fn accepted(transcript_id: impl Into<String>) -> Self

Construct an Accepted outcome with the canonical schema tag.

pub fn skipped(reason: SettlementSkipReason) -> Self

Construct a Skipped outcome with the canonical schema tag.

pub fn retryable(reason: SettlementFailureReason) -> Self

Construct a retryable outcome with the canonical schema tag.

Deterministic failure codes are coerced to Self::Permanent.

pub fn permanent(reason: SettlementFailureReason) -> Self

Construct a Permanent outcome with the canonical schema tag.

pub fn is_retryable(&self) -> bool

Return true for outcomes that the retry policy must replay.

pub fn is_permanent(&self) -> bool

Return true for outcomes that land directly in the dead-letter table without further retries.

Trait Implementations

impl Clone for SettlementOutcome

fn clone(&self) -> SettlementOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SettlementOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SettlementOutcome

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SettlementOutcome

impl PartialEq for SettlementOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SettlementOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SettlementOutcome