aion_client/error

Shared caller-side SDK error taxonomy.

Types

Error

Closed error taxonomy from the language-neutral client contract.

pub type Error {
  NotFound
  AlreadyExists
  QueryFailed
  QueryTimeout
  Cancelled
  Unavailable
  Unauthenticated
  NamespaceDenied(detail: String)
  InvalidArgument
  Server(detail: String)
}

Constructors

```
NotFound
```
```
AlreadyExists
```
```
QueryFailed
```
```
QueryTimeout
```
```
Cancelled
```
```
Unavailable
```
```
Unauthenticated
```
```
NamespaceDenied(detail: String)
```
The caller’s credential was accepted, but the caller has no grant for the requested namespace. Workflow-level invisibility (a nonexistent or foreign-owned workflow) surfaces as NotFound, never as this variant, so cross-namespace existence is not leaked. Distinct from Unauthenticated (credential failure) and from InvalidArgument; not retryable until grants or the request change. Carries the server’s detail message.
```
InvalidArgument
```
```
Server(detail: String)
```

AW wire error codes that can be decoded by transports before mapping them to the closed caller-side taxonomy. Mirrors the ten codes of the wire error enum in crates/aion-proto/proto/common.proto exactly; WireUnknown preserves any code this SDK does not recognise.

pub type WireErrorCode {
  WireNotFound
  WireNamespaceDenied
  WireSequenceConflict
  WireUnknownQuery
  WireQueryTimeout
  WireNotRunning
  WireLagged
  WireInvalidInput
  WireBackend
  WireQueryFailed
  WireUnknown(code: String)
}

Constructors

```
WireNotFound
```
```
WireNamespaceDenied
```
```
WireSequenceConflict
```
```
WireUnknownQuery
```
```
WireQueryTimeout
```
```
WireNotRunning
```
```
WireLagged
```
```
WireInvalidInput
```
```
WireBackend
```
```
WireQueryFailed
```
```
WireUnknown(code: String)
```

Values

from_http_status

</>

pub fn from_http_status(status: Int, detail: String) -> Error

Map HTTP status codes used by aion-server into the shared taxonomy. aion-server returns 401 exclusively for credential failure and 403 exclusively for namespace denial. Gateway statuses 502/503/504 signal transient unreachability and map to the retryable Unavailable; 500 and any unrecognised status are server faults.

from_wire

</>

pub fn from_wire(code: WireErrorCode, detail: String) -> Error

Map an AW wire error code into the shared client taxonomy.

WireSequenceConflict is the server’s internal double-writer-bug signal (a single-writer invariant violation), never an idempotency outcome, so it surfaces as Server rather than AlreadyExists.

transport_failure

</>

pub fn transport_failure() -> Error

Transport, DNS, TLS, socket, and transient stream failures are retryable availability failures in the contract.