Enum DbError 

pub enum DbError {
    Store(StoreError),
    Record(RecordError),
    Migration(MigrationError),
    Materialized(MaterializedError),
    Security(SecurityError),
    Authority(AuthorityError),
    Invitation(InvitationError),
    Commit(CommitCodecError),
    MigrationCodec(MigrationCodecError),
    RandomnessUnavailable,
    SequenceExhausted,
    EmptyTransaction,
    HandlesOpen,
    InvalidQuery(RecordError),
    InvalidCursor(String),
    Blob(BlobError),
    InvalidSnapshot(String),
    UnauthorizedDevice,
    RebaseRequired(CommitId),
    StaleEpoch {
        handle: u64,
        active: u64,
    },
    InvitationAlreadyUsed,
    UnknownRecordSchema(CollectionId),
    SchemaMigrationRequired {
        collection_id: CollectionId,
        stored_version: u32,
        requested_version: u32,
    },
    SchemaMigrationFrozen(CollectionId),
    InvalidRemoteCommit(String),
    Network(String),
    Operation(String),
}

An embedded database operation failure.

Variants

Store(StoreError)

Durable metadata or blob storage failed.

Record(RecordError)

A typed record failed schema or codec validation.

Migration(MigrationError)

A registered schema migration was invalid or its deterministic transform failed.

Materialized(MaterializedError)

A prepared materialization violated storage bounds.

Security(SecurityError)

Commit encryption, signing or key-provider access failed.

Authority(AuthorityError)

A capability, invitation, or domain-control object failed validation.

Invitation(InvitationError)

A targeted online or offline invitation failed validation or decryption.

Commit(CommitCodecError)

A bounded canonical commit object could not be constructed.

MigrationCodec(MigrationCodecError)

A canonical migration stage or activation was invalid.

RandomnessUnavailable

The operating-system cryptographic random source failed.

SequenceExhausted

The local author sequence exhausted its durable range.

EmptyTransaction

A transaction without operations cannot create a commit.

HandlesOpen

Collection or transaction handles still reference the database during close.

InvalidQuery(RecordError)

A query predicate could not encode its value.

InvalidCursor(String)

An opaque pagination cursor was malformed, modified, stale, or used with another query.

Blob(BlobError)

Encrypted blob import, manifest validation or streaming setup failed.

InvalidSnapshot(String)

A snapshot failed canonical, signature, domain or state-root validation.

UnauthorizedDevice

A network-authenticated device is not authorized for this domain operation.

RebaseRequired(CommitId)

A commit authored behind a signed epoch cut must be explicitly rebased by the application.

StaleEpoch

A domain handle predates the durable control epoch and must be reopened.

Fields

handle: u64

active: u64

InvitationAlreadyUsed

A one-time offline invitation ticket was already imported by this device.

UnknownRecordSchema(CollectionId)

A remote commit targets a typed collection not registered by this process.

SchemaMigrationRequired

A newer schema was used without traversing the registered migration chain.

Fields

collection_id: CollectionId

Stable collection requiring migration.

stored_version: u32

Highest durable schema version.

requested_version: u32

Schema version requested by the write.

SchemaMigrationFrozen(CollectionId)

Incompatible activation siblings froze a collection pending explicit recovery.

InvalidRemoteCommit(String)

A remote commit header, operation, or materialization disagreed about its target.

Network(String)

Endpoint, QUIC, control-frame, or immutable transfer failed.

Operation(String)

Verification, repair, backup, or restore failed without overwriting a good copy.

Trait Implementations

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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<AuthorityError> for DbError

fn from(source: AuthorityError) -> Self

Converts to this type from the input type.

impl From<BlobError> for DbError

fn from(source: BlobError) -> Self

Converts to this type from the input type.

impl From<CommitCodecError> for DbError

fn from(source: CommitCodecError) -> Self

Converts to this type from the input type.

impl From<InvitationError> for DbError

fn from(source: InvitationError) -> Self

Converts to this type from the input type.

impl From<MaterializedError> for DbError

fn from(source: MaterializedError) -> Self

Converts to this type from the input type.

impl From<MigrationCodecError> for DbError

fn from(source: MigrationCodecError) -> Self

Converts to this type from the input type.

impl From<MigrationError> for DbError

fn from(source: MigrationError) -> Self

Converts to this type from the input type.

impl From<RecordError> for DbError

fn from(source: RecordError) -> Self

Converts to this type from the input type.

impl From<SecurityError> for DbError

fn from(source: SecurityError) -> Self

Converts to this type from the input type.

impl From<StoreError> for DbError

fn from(source: StoreError) -> Self

Converts to this type from the input type.