Struct AshError 

pub struct AshError { /* private fields */ }

Main error type for ASH operations.

Error messages are designed to be safe for logging and client responses. They never contain sensitive data like payloads, proofs, or canonical strings.

Two-Layer Error Model

• Wire layer (code / http_status / message): Conformance-locked. These values are tested by the 134-vector conformance suite and must not change.
• Diagnostic layer (reason / details): Internal only. Provides granular classification for logging and debugging without affecting wire behavior.

Implementations

impl AshError

pub fn new(code: AshErrorCode, message: impl Into<String>) -> Self

Create a new AshError with General reason (backward compatible).

pub fn with_reason( code: AshErrorCode, reason: InternalReason, message: impl Into<String>, ) -> Self

Create a new AshError with a specific internal reason.

pub fn with_detail(self, key: &'static str, value: impl Into<String>) -> Self

Add a diagnostic detail (builder pattern). Must not contain secrets.

pub fn code(&self) -> AshErrorCode

Get the error code.

pub fn message(&self) -> &str

Get the error message.

pub fn http_status(&self) -> u16

Get the recommended HTTP status code.

pub fn reason(&self) -> InternalReason

Get the internal diagnostic reason.

pub fn details(&self) -> Option<&BTreeMap<&'static str, String>>

Get the diagnostic details (if any).

pub fn retryable(&self) -> bool

Whether this error is retryable.

Delegates to AshErrorCode::retryable(). SDKs can pass this through to clients without implementing their own retry logic.

impl AshError

Convenience functions for creating common errors.

pub fn ctx_not_found() -> Self

Context not found.

pub fn ctx_expired() -> Self

Context expired.

pub fn ctx_already_used() -> Self

Context already used (replay detected).

pub fn binding_mismatch() -> Self

Binding mismatch.

pub fn proof_missing() -> Self

Proof missing.

pub fn proof_invalid() -> Self

Proof invalid.

pub fn canonicalization_error() -> Self

Canonicalization error.

PT-002: Uses a fixed message to prevent caller-provided data from leaking into error messages. All canonicalization failures produce the same generic message regardless of the specific failure reason.

Trait Implementations

impl Clone for AshError

fn clone(&self) -> AshError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AshError

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

Formats the value using the given formatter.

impl Display for AshError

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

Formats the value using the given formatter.

impl Error for AshError

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.