Enum BootstrapError 

pub enum BootstrapError {
    CloudHome(CloudHomeError),
    Encryption(EncryptionError),
    Invite(Box<InviteError>),
    Snapshot(SnapshotError),
    Pull(PullError),
    StorePull(StorePullError),
    StoreRegistration(StoreRegistrationError),
    DeviceJoin(DeviceJoinError),
    Storage(StorageError),
    Config(ConfigError),
    Key(KeyError),
    Io(Error),
    InvalidCode(String),
    StoreExists(String),
    TornBootstrapCleanup {
        store_id: String,
        failures: String,
    },
    Provider(String),
    Membership(String),
    WritePolicyMismatch {
        expected: WritePolicy,
        actual: WritePolicy,
    },
    SerialCoordinationUnavailable {
        provider: CloudProvider,
    },
    ExactSlotsUnavailable {
        provider: CloudProvider,
    },
    Database(String),
    InvalidSigningKey(String),
    Cancelled,
    Cleanup {
        cleanup: String,
        cause: Box<BootstrapError>,
    },
}

Why joining or restoring a store failed. Both are the same operation — bootstrap a store from the cloud — differing only in their entry data (an invite that wraps the store key vs a restore code that carries the bucket credentials), so they share one error shape rather than two that duplicate most of their variants and then have to map between each other.

Variants

CloudHome(CloudHomeError)

Encryption(EncryptionError)

Invite(Box<InviteError>)

Snapshot(SnapshotError)

Pull(PullError)

StorePull(StorePullError)

StoreRegistration(StoreRegistrationError)

DeviceJoin(DeviceJoinError)

Storage(StorageError)

Config(ConfigError)

Key(KeyError)

Io(Error)

InvalidCode(String)

StoreExists(String)

TornBootstrapCleanup

A hard crash left a store directory with no saved config, and clearing that torn-bootstrap residue before retrying failed — so the retry can’t proceed over the leftover directory or keyring entries.

Fields

store_id: String

failures: String

Provider(String)

Membership(String)

WritePolicyMismatch

Fields

expected: WritePolicy

actual: WritePolicy

SerialCoordinationUnavailable

Fields

provider: CloudProvider

ExactSlotsUnavailable

Fields

provider: CloudProvider

Database(String)

InvalidSigningKey(String)

Cancelled

The caller’s cancel signal fired at a phase boundary, so the join or restore stopped before saving the store. This returns through the same failure-cleanup path a real error takes — removing the partly-created store directory and any per-store keyring entries written so far — so a cancelled bootstrap leaves no residue in either place.

Cleanup

Bootstrap failed AND cleaning up what it had durably written also failed. Both are carried: cause is the original bootstrap failure that triggered the cleanup, cleanup is why the cleanup itself failed — the cause is preserved as a value, not flattened into a string.

Fields

cleanup: String

cause: Box<BootstrapError>

Trait Implementations

impl Debug for BootstrapError

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

Formats the value using the given formatter.

impl Display for BootstrapError

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

Formats the value using the given formatter.

impl Error for BootstrapError

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<CloudHomeError> for BootstrapError

fn from(source: CloudHomeError) -> Self

Converts to this type from the input type.

impl From<ConfigError> for BootstrapError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<DeviceJoinError> for BootstrapError

fn from(source: DeviceJoinError) -> Self

Converts to this type from the input type.

impl From<EncryptionError> for BootstrapError

fn from(source: EncryptionError) -> Self

Converts to this type from the input type.

impl From<Error> for BootstrapError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InviteError> for BootstrapError

fn from(error: InviteError) -> Self

Converts to this type from the input type.

impl From<KeyError> for BootstrapError

fn from(source: KeyError) -> Self

Converts to this type from the input type.

impl From<PullError> for BootstrapError

fn from(source: PullError) -> Self

Converts to this type from the input type.

impl From<SnapshotError> for BootstrapError

fn from(source: SnapshotError) -> Self

Converts to this type from the input type.

impl From<StorageError> for BootstrapError

fn from(source: StorageError) -> Self

Converts to this type from the input type.

impl From<StorePullError> for BootstrapError

fn from(source: StorePullError) -> Self

Converts to this type from the input type.

impl From<StoreRegistrationError> for BootstrapError

fn from(source: StoreRegistrationError) -> Self

Converts to this type from the input type.