Enum OastError 

#[non_exhaustive]
pub enum OastError {
    EmptyAssessmentId,
    AssessmentIdTooLong {
        actual: usize,
        maximum: usize,
    },
    InvalidAssessmentId,
    ZeroOpaqueId,
    ZeroLifetime,
    LifetimeTooLong {
        actual: u64,
        maximum: u64,
    },
    ZeroPollBudget,
    PollBudgetTooLarge {
        actual: u16,
        maximum: u16,
    },
    ZeroAuthorityLimit,
    AuthorityLimitTooLarge,
    EmptyProtocolSet,
    RegistrationCapacityExhausted,
    TokenAlreadyRegistered,
    VerificationBindingTooLarge,
    LifetimeGrantExceeded {
        requested: u64,
        maximum: u64,
    },
    PollGrantExceeded {
        requested: u16,
        maximum: u16,
    },
    ExpiryOverflow,
    BindingMismatch,
    CorrelationMismatch,
    ProtocolNotAllowed {
        protocol: OastEventProtocol,
    },
    ClockRegressed {
        previous: OastMonotonicTime,
        current: OastMonotonicTime,
    },
    Expired {
        expires_at: OastMonotonicTime,
    },
    Cancelled,
    PollBudgetExhausted,
    PollEventLimitExceeded {
        maximum: u16,
    },
    UniqueEventLimitExceeded {
        maximum: u16,
    },
    EventKeyProtocolConflict,
}

Validation and state-transition failures for OAST correlation.

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.

EmptyAssessmentId

The assessment identity was empty.

AssessmentIdTooLong

The assessment identity exceeded its bound.

Fields

actual: usize

Supplied byte length.

maximum: usize

Maximum byte length.

InvalidAssessmentId

The assessment identity contained a disallowed byte.

ZeroOpaqueId

An opaque 32-byte value used the reserved all-zero sentinel.

ZeroLifetime

The lifetime was zero.

LifetimeTooLong

The lifetime exceeded the hard foundation bound.

Fields

actual: u64

Requested milliseconds.

maximum: u64

Maximum milliseconds.

ZeroPollBudget

The poll budget was zero.

PollBudgetTooLarge

The poll budget exceeded the hard foundation bound.

Fields

actual: u16

Requested polls.

maximum: u16

Maximum polls.

ZeroAuthorityLimit

At least one authority limit was zero.

AuthorityLimitTooLarge

One authority limit exceeded its hard foundation bound.

EmptyProtocolSet

No callback protocol was allowed.

RegistrationCapacityExhausted

The authority epoch reached its registration limit.

TokenAlreadyRegistered

The token had already been consumed in this authority epoch.

VerificationBindingTooLarge

A verification-case identity component exceeded the OAST binding bound.

LifetimeGrantExceeded

The requested lifetime exceeded the authority grant.

Fields

requested: u64

Requested milliseconds.

maximum: u64

Granted maximum milliseconds.

PollGrantExceeded

The requested poll budget exceeded the authority grant.

Fields

requested: u16

Requested polls.

maximum: u16

Granted maximum polls.

ExpiryOverflow

Adding lifetime to the issued time overflowed.

BindingMismatch

Assessment or verification-case identity did not match exactly.

CorrelationMismatch

A callback was routed with another correlation identity.

ProtocolNotAllowed

A callback used a protocol outside the registration grant.

Fields

protocol: OastEventProtocol

Rejected protocol.

ClockRegressed

The injected monotonic time moved backwards.

Fields

previous: OastMonotonicTime

Last accepted time.

current: OastMonotonicTime

Regressed time.

Expired

The correlation is expired.

Fields

expires_at: OastMonotonicTime

Exclusive expiry boundary.

Cancelled

The correlation was cancelled.

PollBudgetExhausted

Every poll in the grant was spent.

PollEventLimitExceeded

A staged poll exceeded its event bound.

Fields

maximum: u16

Maximum events in one poll.

UniqueEventLimitExceeded

Atomic completion would exceed the registration unique-event bound.

Fields

maximum: u16

Maximum unique event keys.

EventKeyProtocolConflict

One event key was observed under two distinct protocol families.

Trait Implementations

impl Clone for OastError

fn clone(&self) -> OastError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OastError

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

Formats the value using the given formatter.

impl Display for OastError

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

Formats the value using the given formatter.

impl Eq for OastError

impl Error for OastError

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 OastError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OastError