Enum AshErrorCode 

pub enum AshErrorCode {
    CtxNotFound,
    CtxExpired,
    CtxAlreadyUsed,
    BindingMismatch,
    ProofMissing,
    ProofInvalid,
    CanonicalizationError,
    ValidationError,
    ModeViolation,
    UnsupportedContentType,
    ScopeMismatch,
    ChainBroken,
    InternalError,
    TimestampInvalid,
    ScopedFieldMissing,
}

Error codes for ASH protocol.

These codes are stable and should not change between versions.

Standard Error Codes (per ASH specification v2.3.4)

Error Code	HTTP Status	Description
ASH_CTX_NOT_FOUND	450	Context ID not found in store
ASH_CTX_EXPIRED	451	Context has expired
ASH_CTX_ALREADY_USED	452	Context was already consumed (replay)
ASH_PROOF_INVALID	460	Proof verification failed
ASH_BINDING_MISMATCH	461	Request endpoint doesn’t match context
ASH_SCOPE_MISMATCH	473	Scope hash mismatch
ASH_CHAIN_BROKEN	474	Chain verification failed
ASH_TIMESTAMP_INVALID	482	Invalid timestamp format
ASH_PROOF_MISSING	483	Required X-ASH-Proof header missing
ASH_SCOPED_FIELD_MISSING	475	Required scoped field missing
ASH_CANONICALIZATION_ERROR	484	Payload cannot be canonicalized
ASH_VALIDATION_ERROR	485	Input validation failure
ASH_MODE_VIOLATION	486	Security mode requirements not met
ASH_UNSUPPORTED_CONTENT_TYPE	415	Content type not supported
ASH_INTERNAL_ERROR	500	Internal server error

Every error code has a unique HTTP status code for unambiguous identification.

Serde Serialization (CR-001)

Error codes serialize with the ASH_ prefix per the ASH specification: CtxNotFound serializes as "ASH_CTX_NOT_FOUND", not "CTX_NOT_FOUND". This ensures cross-SDK interoperability when error codes are transmitted as JSON.

Variants

CtxNotFound

Context not found in store

CtxExpired

Context has expired

CtxAlreadyUsed

Context was already consumed (replay detected)

BindingMismatch

Binding does not match expected endpoint

ProofMissing

Required proof not provided

ProofInvalid

Proof does not match expected value

CanonicalizationError

Payload cannot be canonicalized

ValidationError

General validation error (input validation failures) Spec: ASH_VALIDATION_ERROR (HTTP 485)

ModeViolation

Mode requirements not met

UnsupportedContentType

Content type not supported

ScopeMismatch

Scope hash mismatch (v2.2+)

ChainBroken

Chain verification failed (v2.3+)

InternalError

Internal server error (RNG failure, etc.)

TimestampInvalid

Timestamp validation failed (SEC-005)

ScopedFieldMissing

Required scoped field missing (SEC-006)

Implementations

impl AshErrorCode

pub fn http_status(&self) -> u16

Get the recommended HTTP status code for this error.

v2.3.5: Every error code has a unique HTTP status code for unambiguous identification. ASH-specific errors use the 450-486 range. Standard HTTP codes (415, 500) are used only where a single ASH error maps to a well-known HTTP semantic.

pub fn retryable(&self) -> bool

Whether this error code is retryable.

Retryable errors are transient conditions that may resolve on retry:

• TimestampInvalid — clock skew may resolve after sync
• InternalError — transient server failure

All other errors are permanent (wrong proof, missing fields, etc.) and retrying with the same inputs will always produce the same error.

pub fn as_str(&self) -> &'static str

Get the error code as a string.

Returns the error code string per ASH specification v2.3.4.

Trait Implementations

impl Clone for AshErrorCode

fn clone(&self) -> AshErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AshErrorCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AshErrorCode

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for AshErrorCode

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

Formats the value using the given formatter.

impl Hash for AshErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AshErrorCode

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

CR-001: Custom Serialize implementation to produce spec-compliant ASH_ prefixed strings. #[serde(rename_all = "SCREAMING_SNAKE_CASE")] would produce CTX_NOT_FOUND without the required ASH_ prefix, causing cross-SDK deserialization failures.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Copy for AshErrorCode

impl Eq for AshErrorCode

impl StructuralPartialEq for AshErrorCode