Enum BootstrapError 

pub enum BootstrapError {
    Cancelled,
    JoinRequestSent,
    NoUnfinishedJoin(StoreId),
    RestoreRegistered,
    NoUnfinishedRestore(StoreId),
    NoUnfinishedReplacement(StoreId),
    Code(CodeError),
    Directory(BootstrapDirectoryError),
    Store(CovenError),
    DeviceLocked {
        path: PathBuf,
    },
    Sync(SyncError),
    OAuth(OAuthError),
    SecureStorage(KeyError),
    Cleanup {
        operation: Box<BootstrapError>,
        cleanup: Box<BootstrapError>,
    },
    Published {
        handle: CovenHandle,
        source: Box<BootstrapError>,
    },
    Shutdown(Shutdown),
    Bug(Bug),
}

Opening a new installation failed. A join’s unpublished work, and a recorded restore’s, remain for an explicit retry unless the call was cancelled or the invite was settled; a restore before its record removes its own.

Variants

Cancelled

Cancellation removes unpublished local data and leaves final custody alone.

JoinRequestSent

Cancelling a join after its request may have been sent. The join stays unfinished and resumable; it ends only by approval, decline or expiry (§13.2).

NoUnfinishedJoin(StoreId)

No join is under way for this store on this device: none was started here, or it has ended.

RestoreRegistered

Cancelling a restore once its device may be registered. The restore stays unfinished and listed, and only finishes (§13.1).

NoUnfinishedRestore(StoreId)

No restore is under way for this store on this device: none recorded itself here, or it has ended.

NoUnfinishedReplacement(StoreId)

No replacement of this device’s installation of the store is under way past its record: none recorded itself, or it has finished.

Code(CodeError)

The code cannot be used for this operation.

Directory(BootstrapDirectoryError)

Preparing, publishing or removing the unpublished directory failed.

Store(CovenError)

Opening the database failed.

DeviceLocked

The device is locked, and the protection class the app chose keeps the installation’s files closed until it unlocks (api.md E1). A join’s unfinished installation stays for the retry, and a recorded restore’s; a restore before its record removes its own. The app waits for the unlock and calls again.

Fields

path: PathBuf

The first protected file the lock refused.

Sync(SyncError)

Provider admission, signed membership or snapshot loading failed.

OAuth(OAuthError)

Provider sign-in failed.

SecureStorage(KeyError)

Final custody could not be read or written.

Cleanup

Cleanup failed too; retry can inspect both failures.

Fields

operation: Box<BootstrapError>

The initial failure.

cleanup: Box<BootstrapError>

Its cleanup failure.

Published

The loaded store is published; confirming durability or final cleanup failed. Custody remains committed and the handle retains session-only keys.

Fields

handle: CovenHandle

The open store, including its session-only custody.

source: Box<BootstrapError>

Failure after publication.

Shutdown(Shutdown)

The call’s runtime is shutting down and dropped its keychain work before it started, so nothing changed (E15).

Bug(Bug)

The call’s work panicked: a bug, which the caller reports (E15).

Trait Implementations

impl CarriesBug for BootstrapError

fn bug(&self) -> Option<&Bug>

The bug this error carries, itself or through the failure it keeps.

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

fn from(error: BootstrapDirectoryError) -> Self

Converts to this type from the input type.

impl From<Bug> for BootstrapError

fn from(source: Bug) -> Self

Converts to this type from the input type.

impl From<CodeError> for BootstrapError

fn from(source: CodeError) -> Self

Converts to this type from the input type.

impl From<CovenError> for BootstrapError

fn from(error: CovenError) -> Self

Converts to this type from the input type.

impl From<DbError> for BootstrapError

A database call’s or opening’s failure is the store’s.

fn from(error: DbError) -> Self

Converts to this type from the input type.

impl From<FileError> for BootstrapError

fn from(error: FileError) -> Self

Converts to this type from the input type.

impl From<KeyError> for BootstrapError

fn from(error: KeyError) -> Self

Converts to this type from the input type.

impl From<OAuthError> for BootstrapError

fn from(error: OAuthError) -> Self

Converts to this type from the input type.

impl From<OpenError> for BootstrapError

fn from(error: OpenError) -> Self

Converts to this type from the input type.

impl From<Shutdown> for BootstrapError

fn from(source: Shutdown) -> Self

Converts to this type from the input type.

impl From<StoreLockError> for BootstrapError

fn from(error: StoreLockError) -> Self

Converts to this type from the input type.

impl From<SyncError> for BootstrapError

A code sync refuses is refused as the call’s own code: a join’s, as a restore’s.

fn from(error: SyncError) -> Self

Converts to this type from the input type.

impl From<TaskFailed> for BootstrapError

fn from(failed: TaskFailed) -> Self

Converts to this type from the input type.