Enum EngineBuildError 

#[non_exhaustive]
pub enum EngineBuildError {
    DataRootIo(Error),
    DataRootLockHeld {
        path: PathBuf,
    },
    HmacKeyMissing,
    AuditChainCorrupted {
        world: String,
        detail: String,
    },
    Storage {
        sqlite_code: Option<i32>,
        detail: String,
    },
}

Errors that can occur while constructing an Engine.

Build failures are setup-time failures: they happen once at EngineBuilder::build and never as part of per-operation runtime errors, which are reported as EngineError.

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.

DataRootIo(Error)

Creating the data_root directory or its writer-lock file failed.

DataRootLockHeld

Another process holds the writer lock on data_root.

Fields

path: PathBuf

The data root that failed to acquire the writer lock.

HmacKeyMissing

EngineBuilder::key was never called.

AuditChainCorrupted

Startup audit verification found a tampered HMAC chain.

Fields

world: String

Canonical name of the world whose chain failed verification.

detail: String

Human-readable failure detail (do not parse).

Storage

Storage layer failure during startup (schema, IO, or quota).

Fields

sqlite_code: Option<i32>

Underlying SQLite extended result code, when available.

detail: String

Human-readable failure detail (do not parse).

Trait Implementations

impl Debug for EngineBuildError

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

Formats the value using the given formatter.