Enum ResolutionReason 

pub enum ResolutionReason {
    None,
    StatusCodeOutOfRange,
    LatencyExceeded,
    SchemaValidationFailed,
    RequiredFieldsMissing,
    BodyTooShort,
    HashMismatch,
    EvidenceUnavailable,
    GeneralRejection,
    Custom(u16),
}

Resolution reason for oracle verdicts.

Follows Solana’s ProgramError::Custom(u32) pattern: well-known variants for cross-oracle interoperability, plus Custom(u16) for domain-specific codes that each oracle defines independently.

On-chain encoding (u16): 0 = None (default for approvals) 1-255 = Standard well-known reasons (interoperable across all oracles) 256+ = Custom oracle-specific codes (meaning defined by each oracle)

For Oracle Developers

Use standard variants when your rejection reason maps to a well-known category. Use Custom(code) for domain-specific reasons:

use sla_escrow_api::resolution::ResolutionReason;

// Standard: any oracle can emit this
let reason = ResolutionReason::LatencyExceeded;

// Custom: only your oracle defines what 1001 means
let reason = ResolutionReason::Custom(1001);

Variants

None

No reason — used for approvals or when no specific reason applies.

StatusCodeOutOfRange

HTTP status code fell outside the SLA-specified range.

LatencyExceeded

Response latency exceeded the SLA threshold.

SchemaValidationFailed

Response body failed JSON Schema validation.

RequiredFieldsMissing

One or more required fields were missing from the response.

BodyTooShort

Response body was shorter than the minimum length.

HashMismatch

Delivery evidence hash did not match the on-chain commitment.

EvidenceUnavailable

Off-chain evidence could not be fetched or was unavailable.

GeneralRejection

General/unspecified rejection (catch-all for standard rejections).

Custom(u16)

Oracle-specific reason code. Each oracle defines its own code meanings. Values should be >= CUSTOM_REASON_BASE (256).

Implementations

impl ResolutionReason

pub fn is_standard(&self) -> bool

Returns true if this is a standard (well-known) reason code.

pub fn is_custom(&self) -> bool

Returns true if this is a custom oracle-specific reason code.

pub fn code(&self) -> u16

Returns the raw u16 code.

Trait Implementations

impl Clone for ResolutionReason

fn clone(&self) -> ResolutionReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolutionReason

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

Formats the value using the given formatter.

impl Display for ResolutionReason

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

Formats the value using the given formatter.

impl From<ResolutionReason> for u16

fn from(reason: ResolutionReason) -> u16

Converts to this type from the input type.

impl From<u16> for ResolutionReason

fn from(code: u16) -> Self

Converts to this type from the input type.

impl PartialEq for ResolutionReason

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

impl Eq for ResolutionReason

impl StructuralPartialEq for ResolutionReason