Enum EngineError 

#[non_exhaustive]
pub enum EngineError {
    InvalidRuntimeSession,
    LockPoisoned,
    GenerationExhausted,
    InvalidAuthorityTransition,
    AuthorityNotReady,
    StaleRuntimeGeneration,
    StaleGatewaySelection,
    ResponseAttemptMismatch,
    UnsuccessfulDnsResponse,
    ExpectedTlsaQuery,
    MissingTransportIdentity,
    InvalidTransportIdentity,
    ProxyTargetNotSeparated,
    InvalidCompletionContext,
    ResponseEvidenceMismatch,
    OriginSniMismatch,
    MissingHnsAuthority,
    ValidationTimeMismatch,
    HnsNetworkMismatch,
    ChainAnchorMismatch,
    LegacyCompletionNotBridgeable,
    CompletionNotCurrent,
    CompletionExpired,
    CompletionNotYetValid,
    MissingIcannEvidence,
    UnexpectedIcannEvidence,
    Wire(Error),
    Dane(DaneError),
    Policy(PolicyError),
    Status(StatusError),
    Gateway(GatewayError),
}

Facade failure.

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.

InvalidRuntimeSession

Runtime session uses the forbidden all-zero sentinel.

LockPoisoned

Internal lock was poisoned by a caller panic.

GenerationExhausted

Runtime or event generation cannot advance.

InvalidAuthorityTransition

Authority state transition is invalid.

AuthorityNotReady

Local authority prerequisites are not ready.

StaleRuntimeGeneration

Work belongs to an older runtime generation.

StaleGatewaySelection

Gateway selection belongs to an older policy generation.

ResponseAttemptMismatch

Parsed response belongs to another attempt.

UnsuccessfulDnsResponse

A TLSA response carried a nonzero DNS response code.

ExpectedTlsaQuery

Completion was attempted for a query other than class-IN TLSA.

MissingTransportIdentity

An intermediary path omitted its required identity.

InvalidTransportIdentity

An intermediary identity is empty or exceeds its bound.

ProxyTargetNotSeparated

ODoH proxy and target identities are not distinct.

InvalidCompletionContext

Completion context conflicts with the admitted transport.

ResponseEvidenceMismatch

Locally validated TLSA evidence does not match the terminal response.

OriginSniMismatch

Actual origin SNI differs from the original TLSA base domain.

MissingHnsAuthority

Resolver evidence was not rooted in a current verified HNS resource.

ValidationTimeMismatch

DNSSEC/certificate time differs from the HNS authority validation time.

HnsNetworkMismatch

Resolver evidence belongs to another Handshake network.

ChainAnchorMismatch

Caller-supplied provenance conflicts with the derived HNS anchor.

LegacyCompletionNotBridgeable

Legacy prerequisite completion has no engine-verified origin binding.

CompletionNotCurrent

Completion is no longer the engine’s latest current-generation result.

CompletionExpired

Completion’s chain-currency validity window elapsed.

CompletionNotYetValid

Completion predates the beginning of its chain-currency validity window.

MissingIcannEvidence

ICANN selection or root failure omitted explicit validation evidence.

UnexpectedIcannEvidence

ICANN evidence was supplied without ICANN selection or root failure.

Wire(Error)

DNS wire failure.

Dane(DaneError)

Local TLSA/DANE matching failure.

Policy(PolicyError)

Policy failure.

Status(StatusError)

Shared observability snapshot failed invariant checks.

Gateway(GatewayError)

Fail-closed transport gateway rejected its bounds or lifecycle.

Trait Implementations

impl Debug for EngineError

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

Formats the value using the given formatter.

impl Display for EngineError

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

Formats the value using the given formatter.

impl Error for EngineError

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<DaneError> for EngineError

fn from(value: DaneError) -> Self

Converts to this type from the input type.

impl From<Error> for EngineError

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<PolicyError> for EngineError

fn from(value: PolicyError) -> Self

Converts to this type from the input type.