Skip to main content

AccountError

Enum AccountError 

Source
#[non_exhaustive]
pub enum AccountError {
Show 19 variants Locked, ProfileNotFound(ProfileIx), DefaultProfileInvariant(String), ProfileAlreadyRegistered(ProfileIx), ProfileIdentityAlreadyRegistered { existing: ProfileIx, did: String, }, ActiveProfileCannotBeHidden(ProfileIx), ProfileEnded(ProfileIx), ProfileEndHeightZero, MintAlreadyInProgress(ProfileIx), MismatchedMintHalves { did_coin_id: Bytes32, store_launched_from: Bytes32, }, MintFeeAboveCeiling { fee: u64, ceiling: u64, }, RegistryInvariant(String), NoActiveProfile, Keystore(String), Auth(String), Spend(String), UserDeclined(String), PolicyDenied(String), PolicyIndeterminate(String),
}
Expand description

Every failure mode surfaced by the dig-account public API.

Fail-closed: any ambiguity in an unlock, signing, or custody path resolves to an error here rather than a silent success.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

Locked

The account (or the requested operation) is locked; unlock first.

§

ProfileNotFound(ProfileIx)

No profile exists at the requested index.

§

DefaultProfileInvariant(String)

The exactly-one-default invariant was violated.

§

ProfileAlreadyRegistered(ProfileIx)

A profile is already recorded at this index.

An anchor is evidence of ONE specific on-chain mint, so re-recording an index would replace a proof with a different proof. The existing entry is left untouched.

§

ProfileIdentityAlreadyRegistered

A profile with this IDENTITY is already recorded, at a different index.

A profile IS its on-chain identity. Two entries claiming one DID would derive different wallet keys and different DEKs from their two indices while presenting as the same person, so the account could receive at an address the identity’s own surfaces never show. The existing entry is left untouched.

Fields

§existing: ProfileIx

The index that already holds this identity.

§did: String

The did:chia:… string both entries claim.

§

ActiveProfileCannotBeHidden(ProfileIx)

The ACTIVE profile cannot be hidden from the host’s lists.

A hidden active profile is a trap: the UI lists nothing while the wallet keeps deriving and receiving at that index. Switch away first, then hide.

§

ProfileEnded(ProfileIx)

The profile has ENDED on chain — both of its singletons were melted — so it cannot be made active, and no host may present it as a live profile.

The entry is deliberately KEPT rather than deleted: its DID string remains the right answer to “what did this account used to be”, and an absence cannot say that a profile ended.

§

ProfileEndHeightZero

A profile end was recorded at height 0, which no on-chain confirmation can produce.

Recording one would let a submission masquerade as a confirmation — the same rule the mint anchors enforce (SPEC.md §2.4).

§

MintAlreadyInProgress(ProfileIx)

A mint is already journalled at this index.

Beginning a second one would re-mint a DID that may already be paid for, orphaning the first (dig_ecosystem#2377). Resume the journalled mint instead.

§

MismatchedMintHalves

The two halves of a mint do not belong to each other: the store was launched from some other DID’s coin.

Each evidence proves only that its OWN coin confirmed, so pairing them is where the relationship is checked. Recording this pair would assert a profile that does not exist. Both ids are public coin ids.

Fields

§did_coin_id: Bytes32

The coin of the DID being recorded.

§store_launched_from: Bytes32

The DID coin the store’s launch actually spent.

§

MintFeeAboveCeiling

A disclosed mint fee is above the mint’s hard ceiling (MAX_MINT_FEE_MOJOS).

The journalled store fee is the amount a resumed phase B is allowed to spend, so an unbounded one turns a restart into a route for handing a wallet coin to a farmer — exactly what the DID half’s ceiling already refuses. Same ceiling, deliberately: a different limit for the second bundle would be a design decision, not a bound.

Fields

§fee: u64

The fee that was disclosed.

§ceiling: u64

The largest fee a mint may pay.

§

RegistryInvariant(String)

A profile registry violated one of its four invariants — usually an edited or corrupt file.

Fail-closed: the registry is not partially loaded, so a host never acts on a half-valid profile list.

§

NoActiveProfile

The account has no active profile, because it has no confirmed profile at all.

This is the pre-mint state of every new account, not a fault: the host’s answer is to run the first-run mint, never to invent an index.

§

Keystore(String)

An underlying keystore operation failed.

§

Auth(String)

Authentication or unlock-policy evaluation rejected the attempt.

§

Spend(String)

A money-path spend operation failed — spend verification, summary derivation, or signing was refused. Fail-closed: the money signer surfaces every rejection here rather than producing a signature it could not fully account for.

§

UserDeclined(String)

The USER declined the spend at the confirm ceremony.

Distinct from PolicyDenied because the two are different facts about different deciders, and a host reports them differently: “you said no” is an ordinary outcome, while “the rules say no” may mean a misconfiguration. Merging them would also make the normative wire mapping (SPEC.md §6.3.1) ambiguous — one crate outcome cannot map to two codes — and collapsing outcomes at a boundary is the defect this crate’s 0.5.0 shape exists to remove.

Terminal: no further ceremony may permit a spend the user has already refused.

§

PolicyDenied(String)

The spend is FORBIDDEN by a structural custody rule — no confirmation ceremony can permit it.

A user’s refusal is NOT this variant; it is UserDeclined. Both are terminal, but they name different deciders and SPEC.md §6.3.1 maps them to different wire codes, so a host must be able to tell them apart.

§The escalatable outcome is deliberately NOT an error

“Not auto-approved, but a human could permit it” is SpendRuling::RequiresConfirmation — an Ok value carrying a PendingApproval — never a variant here. When it WAS an error variant (RequireAuth, removed in 0.5.0), the crate’s only consumer collapsed every Err into one refusal and the confirm ceremony became unreachable for exactly the tiers that exist to require it. Every variant in this enum is now terminal for the spend, so collapsing them can lose detail but can no longer lose a permission.

The canonical structural case is a vault outflow to anything other than the profile’s own hot wallet (#1504: every vault outflow MUST pass through the 24h clawback window, so it may only ever pay the hot wallet).

§

PolicyIndeterminate(String)

The policy COULD NOT BE EVALUATED for this spend — the answer is unknown, not “no”.

Kept separate from PolicyDenied because collapsing “denied by policy” with “could not determine policy” into one refusal loses the only signal that the gate is malfunctioning (an unreadable clock, an undecodable recipient address, a spend whose value is denominated in units no configured limit can bound, a rolling window zero seconds long). Every indeterminate outcome refuses the spend, and none of them is escalatable — the condition must be fixed, not confirmed away.

Trait Implementations§

Source§

impl Debug for AccountError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for AccountError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for AccountError

1.30.0 · Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

Source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

Source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Conv for T

Source§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
Source§

impl<T> FmtForward for T

Source§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
Source§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
Source§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
Source§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
Source§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
Source§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
Source§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
Source§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
Source§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pipe for T
where T: ?Sized,

Source§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
Source§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
Source§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Source§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
Source§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
Source§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
Source§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> Tap for T

Source§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
Source§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
Source§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
Source§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
Source§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
Source§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
Source§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
Source§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
Source§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
Source§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T> TryConv for T

Source§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more