Enum Error 

#[non_exhaustive]
pub enum Error {
    Store(StoreError),
    Codec(Error),
    Cert(Error),
    Noc(NocError),
    Signer(String),
    Snapshot(String),
    Driver(DriverError),
    Transport(Error),
    NotCommissioned(String),
    ControllerStopped,
    InteractionModel(ImError),
    Operational(String),
    Trust(String),
    SetupCode(String),
    NoTrust,
    CommissioningWindowRejected(u8),
    WouldRemoveSelf,
    OperationalCredentialsRejected(u8),
    AclWouldLockOut,
    GroupCommandRejected(u8),
    GroupNotProvisioned(u16),
}

Errors surfaced by the controller’s persistence and identity layer.

#[non_exhaustive] so later sub-phases can add networked variants (e.g. SessionLost, DeviceUnreachable) without a breaking change.

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.

Store(StoreError)

The backing ControllerStore failed.

Codec(Error)

TLV encode/decode of the snapshot blob failed.

Cert(Error)

A certificate failed to parse or serialize.

Noc(NocError)

NOC/RCAC issuance failed.

Signer(String)

A signing key could not be generated or reconstructed.

Snapshot(String)

The persisted snapshot was structurally invalid or an unknown version.

Driver(DriverError)

CASE session establishment failed, or a driver operation errored.

Transport(Error)

A transport / session-manager (framing, MRP) operation failed.

NotCommissioned(String)

No fabric exists, or the requested node/fabric is not addressable.

ControllerStopped

The owning controller task has stopped (channel closed).

InteractionModel(ImError)

An Interaction-Model request/response failed to build or parse.

Operational(String)

An operational-path failure with a human-readable detail — a key derivation (operational IPK / compressed fabric id), a transport/session send or decode, a request timeout, or a subscription liveness timeout.

Trust(String)

Attestation trust material could not be loaded.

SetupCode(String)

The setup code (QR / manual) could not be parsed.

NoTrust

No attestation trust configured; commissioning cannot verify the device.

CommissioningWindowRejected(u8)

An AdministratorCommissioning command returned a non-success IM status (e.g. 0x02 Busy, 0x03 PAKEParameterError, 0x04 WindowNotOpen reported as a cluster status). The raw IM status byte is preserved.

WouldRemoveSelf

Refused to remove the controller’s own fabric (would sever the CASE session and orphan persisted device state). No force override exists.

OperationalCredentialsRejected(u8)

An OperationalCredentials command returned a non-success NodeOperationalCertStatusEnum (e.g. 7 InvalidFabricIndex). Raw code preserved.

AclWouldLockOut

Refused an ACL write that would strip our own administrative access (no Administer/CASE entry covering our commissioner node id). Prevents orphaning the device. Checked before any bytes are sent.

GroupCommandRejected(u8)

A Groups / GroupKeyManagement command returned a non-success status (e.g. ResourceExhausted from MaxGroupsPerFabric). Raw status preserved.

GroupNotProvisioned(u16)

A group send (invoke_group) named a key_set_id that has not been provisioned on the controller’s fabric (no matching GroupKeySetConfig in group_keys). Call MatterController::create_group first to mint and persist the key set.

Implementations

impl Error

pub fn network_feature_unsupported(&self) -> Option<NetworkKind>

If this error is the device rejecting the supplied network-credential type — e.g. Thread credentials handed to a Wi-Fi-only device (NetworkCommissioning::FeatureMap lacks the needed bit) — returns which network type the credentials required. Use this to route to a different credential type instead of substring-matching the rendered message.

Returns None for every other error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: DriverError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ImError> for Error

fn from(source: ImError) -> Self

Converts to this type from the input type.

impl From<NocError> for Error

fn from(source: NocError) -> Self

Converts to this type from the input type.

impl From<StoreError> for Error

fn from(source: StoreError) -> Self

Converts to this type from the input type.