Enum ExoError 

pub enum ExoError {
    Identity(String),
    Consent(String),
    Governance(String),
    Authority(String),
    KernelDenied(String),
    KernelEscalated(String),
    Crypto(String),
    InvalidDid(String),
    Serialization(String),
}

Errors that can be produced by the SDK.

Each variant corresponds to a subsystem of the SDK. Callers should prefer matching on the variant over parsing the display string, which is intended for human consumption only.

Variants

Identity(String)

An identity-related operation failed.

Returned when DID derivation, key handling, or identity reconstruction encounters an unexpected condition. In practice the SDK derives DIDs deterministically, so this variant is rarely observed — it is reserved for future identity flows that could validate or reject caller-supplied material.

Consent(String)

A consent/bailment-related operation failed.

Returned by crate::consent::BailmentBuilder::build when required fields are missing (no scope, no duration) or invalid (empty scope, zero-hour duration).

Governance(String)

A governance-related operation failed.

Returned by crate::governance::DecisionBuilder::build for an empty title, and by crate::governance::Decision::cast_vote when the same voter tries to cast a second vote.

Authority(String)

An authority-chain operation failed.

Returned by crate::authority::AuthorityChainBuilder::build for any topology violation: an empty chain, a break in the grantor/grantee sequence between consecutive links, or a terminal mismatch.

KernelDenied(String)

The kernel denied an action.

Reserved for flows that want to surface a kernel denial as a Result error rather than a KernelVerdict::Denied value. The SDK’s crate::kernel::ConstitutionalKernel::adjudicate returns a verdict directly; this variant exists so higher-level wrappers can lift it into the error channel if they prefer.

KernelEscalated(String)

The kernel escalated an action for review.

Counterpart to ExoError::KernelDenied for the escalation outcome.

Crypto(String)

A cryptographic operation failed.

Reserved for future crypto flows that could fail (e.g. signature parsing of untrusted input). The current BLAKE3 and Ed25519 wrappers in crate::crypto are infallible.

InvalidDid(String)

A provided DID string is not valid.

Returned when the SDK derives a DID whose method-specific string fails exo_core::Did validation. In practice BLAKE3-derived hex always satisfies the rules, so this variant is effectively unreachable; it is retained for completeness.

Serialization(String)

Serialization or deserialization failed.

Reserved for higher-level SDK flows that marshal wire payloads. The primitive Serialize/Deserialize implementations on SDK types use serde_json::Error directly; this variant lets downstream wrappers homogenise their error channel.

Trait Implementations

impl Debug for ExoError

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

Formats the value using the given formatter.

impl Display for ExoError

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

Formats the value using the given formatter.

impl Error for ExoError

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.