Enum AgentError 

#[non_exhaustive]
pub enum AgentError {
    IdentityNotFound {
        did: String,
    },
    AlreadyDelegated {
        alias: String,
    },
    AgentNotFound {
        did: String,
    },
    Revoked {
        did: String,
    },
    OutsideDelegatorScope {
        capability: String,
    },
    CryptoError(AgentError),
    DelegationError(InitError),
}

Errors from agent delegation operations (agents::add and friends).

An agent is a KERI dip-delegated identifier of a root/org identity — the same engine devices use. These errors mirror the device delegation surface.

Usage:

match agents::add(&ctx, &root_alias, &agent_alias, curve) {
    Err(AgentError::AlreadyDelegated { alias }) => { /* key in use */ }
    Err(e) => return Err(e.into()),
    Ok(result) => { /* agent did:keri */ }
}

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.

IdentityNotFound

The delegating (root/org) identity could not be found in storage.

Fields

did: String

The DID (or load context) that was not found.

AlreadyDelegated

A key already exists under the requested agent alias — re-delegating it would clobber an existing agent. Choose a fresh --label/alias.

Fields

alias: String

The keychain alias already in use.

AgentNotFound

No agent delegated by this root matches the given DID (or its key is missing from the keychain).

Fields

did: String

The agent DID that could not be resolved.

Revoked

The agent has been revoked by the delegator and cannot be rotated.

Fields

did: String

The revoked agent’s DID.

OutsideDelegatorScope

The requested agent scope exceeds the delegator’s own scope — a delegate’s authority can only narrow, never widen (subset rule).

Fields

capability: String

The capability that the delegator does not itself hold.

CryptoError(AgentError)

A cryptographic operation failed (e.g. resolving the root’s curve).

DelegationError(InitError)

Authoring or anchoring the delegated agent identifier failed.

Trait Implementations

impl AuthsErrorInfo for AgentError

fn error_code(&self) -> &'static str

Returns a unique error code string for this error variant.

fn suggestion(&self) -> Option<&'static str>

Returns an optional actionable suggestion for resolving the error.

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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<AgentError> for AgentError

fn from(err: AgentError) -> Self

Converts to this type from the input type.