Enum DidError 

pub enum DidError {
    Driver(DriverError),
    Signer(String),
    Parse(String),
    NotDid,
    InvalidDidString(String),
    InvalidRecovery(String),
    MissingLineage,
    MissingHint,
    Chain(String),
    NoIdentitySingleton,
    NotASingleton,
    NotDidRooted,
    LauncherMismatch,
    LineageTooDeep,
}

Everything that can go wrong while building or parsing a DID spend.

The variants split into two families: errors delegated to the chia-wallet-sdk driver/signer (wrapped verbatim so the underlying cause is never lost), and DID-domain errors this crate raises itself (parse/hydration/codec guards, all fail-closed per SPEC §5).

Variants

Driver(DriverError)

A chia-wallet-sdk driver operation failed (puzzle currying, spend construction, CLVM evaluation). The wrapped DriverError carries the precise cause.

Signer(String)

The signing calculator failed to derive the required signatures from the coin spends (invalid puzzle/solution, an infinity public key in an AGG_SIG condition). The message is the underlying signer error rendered as a string, so this crate does not leak the signer’s error type into its public surface.

Parse(String)

A coin/puzzle/solution could not be parsed as the expected shape.

NotDid

The supplied puzzle parsed successfully but is not a DID singleton.

InvalidDidString(String)

A did:chia:1… string was malformed or failed bech32m decoding.

InvalidRecovery(String)

A recovery operation supplied an inconsistent recovery configuration (list hash / required verifications mismatch).

MissingLineage

Hydration could not establish the lineage proof required to spend the DID (SPEC §5, fail-closed).

MissingHint

A parsed DID coin was missing the owner hint memo required to recreate its child (SPEC §5, fail-closed).

Chain(String)

A chain-level precondition was violated (e.g. a supplied coin does not match the expected launcher). The string states the specific violation. Also carries a crate::resolve::ChainSource read error verbatim — a failed read NEVER degrades to “assume owned” (SPEC §5, fail-closed).

NoIdentitySingleton

The DID’s identity singleton has no current on-chain coin — it was never launched, or has been melted, so there is no lineage to root a coin against (SPEC §5, fail-closed).

NotASingleton

The coin under proof could not be authenticated as a genuine singleton: its parent-spend chain does not resolve to a singleton launcher (an ordinary payment/change coin, or a pay-to coin that merely wears a singleton puzzle hash without a genuine recreation parent spend). SPEC §5.

NotDidRooted

The coin authenticates as a genuine singleton, but neither IS the DID singleton nor was launched from a coin in the DID singleton’s lineage — it is not rooted in the DID’s identity (SPEC §5).

LauncherMismatch

The DID’s current tip authenticated as a genuine singleton, but its GENUINE launcher (walked from the parent-spend chain) is not the launcher that was requested. This is the money-critical guard for crate::resolve_xch_address: a dishonest crate::ChainSource can echo an attacker DID’s tip for a victim launcher, and the curried launcher_id on that tip is attacker-chosen, so only the parent-walk-authenticated launcher may be trusted. Resolving an address from a mismatched launcher would pay the wrong recipient, so this fails closed (SPEC §5).

LineageTooDeep

The parent-spend walk exceeded crate::resolve::MAX_LINEAGE_DEPTH — a DoS guard against an unbounded (possibly adversarial) lineage. The proof fails closed rather than walk forever.

Trait Implementations

impl Debug for DidError

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

Formats the value using the given formatter.

impl Display for DidError

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

Formats the value using the given formatter.

impl Error for DidError

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<DriverError> for DidError

fn from(source: DriverError) -> Self

Converts to this type from the input type.