Enum DoorError 

pub enum DoorError {
    Unknown(ActionAddress),
    MissingArgument(ActionAddress),
    UnexpectedArgument(ActionAddress),
    InvalidArguments(String),
    Unavailable {
        code: String,
        reason: String,
    },
    ConfirmationRequired,
    UnregisteredType(String),
    Failed(String),
}

Why an address could not be performed. Unknown deliberately covers both “no such address” and “not offered to you”, so a caller can’t map what it may not reach by probing for a different error.

Variants

Unknown(ActionAddress)

Nothing in the tree carries this address.

MissingArgument(ActionAddress)

The action takes text and none was supplied.

UnexpectedArgument(ActionAddress)

The action takes nothing and an argument was supplied. Refused, not dropped — a silently ignored argument leaves the caller believing it asked for something it didn’t get.

InvalidArguments(String)

Typed arguments failed the action’s declared schema.

Unavailable

The address exists and is intentionally advertised, but its current precondition is not satisfied.

Fields

code: String

reason: String

ConfirmationRequired

The action contract requires an explicit confirmation step that this invocation did not carry.

UnregisteredType(String)

The app never registered a decoder for the action’s type, so the door can’t prove what it would run. Fail-closed: a refusal, not a best-effort apply.

Failed(String)

The action ran and failed.

Implementations

impl DoorError

pub fn decoding(error: ActionError) -> DoorError

Why an encoded action could not be turned back into one: no decoder for its type, or a payload the registered decoder does not read (the code that encoded it and the code decoding it disagree). The second is a fault of its own and says so; reporting it as an unknown type sends whoever reads it looking for a registration that is there.

pub fn code(&self) -> &'static str

Stable machine-readable code, distinguishing “I addressed this wrongly” from “it ran and could not do its job”.

Trait Implementations

impl Clone for DoorError

fn clone(&self) -> DoorError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DoorError

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

Formats the value using the given formatter.

impl Display for DoorError

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

Formats the value using the given formatter.

impl Error for DoorError

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 PartialEq for DoorError

fn eq(&self, other: &DoorError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DoorError

impl StructuralPartialEq for DoorError