Enum SetupError 

#[non_exhaustive]
pub enum SetupError {
    IdentityAlreadyExists {
        did: String,
    },
    KeychainUnavailable {
        backend: String,
        reason: String,
    },
    CryptoError(AgentError),
    WeakPassphrase {
        source_name: String,
        reason: String,
    },
    StorageError(SdkStorageError),
    GitConfigError(GitConfigError),
    InvalidSetupConfig(String),
    RegistrationFailed(RegistrationError),
    PlatformVerificationFailed(String),
}

Errors from identity setup operations (developer, CI, agent).

Usage:

match sdk_result {
    Err(SetupError::IdentityAlreadyExists { did }) => { /* reuse or abort */ }
    Err(e) => return Err(e.into()),
    Ok(result) => { /* success */ }
}

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.

IdentityAlreadyExists

An identity already exists at the configured path.

Fields

did: String

The DID of the existing identity.

KeychainUnavailable

The platform keychain is unavailable or inaccessible.

Fields

backend: String

The keychain backend name (e.g. “macOS Keychain”).

reason: String

The reason the keychain is unavailable.

CryptoError(AgentError)

A cryptographic operation failed.

WeakPassphrase

The supplied passphrase fails the strength policy. Carries which input supplied it so the user knows exactly what to fix — vital in --non-interactive runs where there is no prompt fallback.

Fields

source_name: String

The input that supplied the passphrase (e.g. “the AUTHS_PASSPHRASE environment variable”).

reason: String

The policy violation, rendered for display.

StorageError(SdkStorageError)

A storage operation failed.

GitConfigError(GitConfigError)

Setting a git configuration key failed.

InvalidSetupConfig(String)

Setup configuration parameters are invalid.

RegistrationFailed(RegistrationError)

Remote registry registration failed.

PlatformVerificationFailed(String)

Platform identity verification failed.

Trait Implementations

impl AuthsErrorInfo for SetupError

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 SetupError

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

Formats the value using the given formatter.

impl Display for SetupError

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

Formats the value using the given formatter.

impl Error for SetupError

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 SetupError

fn from(err: AgentError) -> Self

Converts to this type from the input type.

impl From<RegistrationError> for SetupError

fn from(err: RegistrationError) -> Self

Converts to this type from the input type.