Enum DbError 

pub enum DbError {
    Message(String),
    WriteDependencyConflict {
        writes: Vec<WriteId>,
    },
    ReplayRetirementCutNotPrefix,
    ReadOnlyWriteTransaction,
    Sqlite(Error),
    ExpectedSchema(&'static Error),
    Serde(Error),
    Protocol(Box<StoreProtocolError>),
    RemoteObject(Box<RemoteObjectRecordError>),
    AudiencePackage(Box<AudiencePackageError>),
    ObjectHash(InvalidObjectHash),
    BlobLocator(BlobLocatorError),
    CircleId(CircleIdError),
    RowRoutingKey(RowRoutingKeyError),
    CirclePartitionControl(CirclePartitionControlError),
    Gate(GateError),
    Storage(StorageError),
    BlobPath(PathTokenError),
    Io(Error),
    File(FileError),
    LocalBlobRemoval(LocalBlobRemovalError),
    CachedLocatorRemoval(CachedLocatorRemovalError),
    IntRange(TryFromIntError),
    ParseInt(ParseIntError),
    Utf8(FromUtf8Error),
    Utf8Slice(Utf8Error),
    BlobDecl(BlobDeclError),
    ChangesetIdentity(ChangesetIdentityError),
    Changeset(ChangesetError),
    AuthorStreamId(AuthorStreamIdParseError),
    RowBlobRef(RowBlobRefError),
    WriteRetraction(Box<WriteRetractionError>),
    RotationGate(RotationGateError),
    Encryption(EncryptionError),
    SnapshotImage(Box<SnapshotImageError>),
    PayloadStore(Box<PayloadStoreError>),
    PayloadCleanupFailed {
        operation: Box<DbError>,
        cleanup: Box<DbError>,
    },
    ChangeCaptureFailed {
        operation: Box<DbError>,
        capture: Box<DbError>,
    },
    FromSql(FromSqlError),
    BlobOpeningAuthority(BlobOpeningAuthorityError),
    OwnerPromotionJournal(Box<OwnerPromotionJournalError>),
    CircleJournal(Box<CircleJournalError>),
    SyncRoutingContract(SyncRoutingContractError),
    RowIdentity(RowIdentityError),
    PreparedCommit(Box<PreparedCommitError>),
    CircleState(Box<CircleStateError>),
    DeviceExclusionJournal(Box<StoreDeviceExclusionJournalError>),
    StoreReclaimJournal(Box<StoreReclaimJournalError>),
    CommitNewFile(CommitNewFileError),
    AudienceBlobStaging(Box<dyn Error + Send + Sync + 'static>),
    AudienceBlobRollbackFailed {
        operation: Box<DbError>,
        rollback: StagedBlobRollbackFailures,
    },
    StagedBlobRollback(StagedBlobRollbackFailures),
    BlobMoveRequiresMaterialization {
        table: String,
        row_id: String,
        column: String,
        row_stamp: String,
        reason: Box<DbError>,
    },
    UnparseableOutboxAttemptTime {
        entry_id: i64,
        value: String,
        source: ParseError,
    },
    Context {
        context: String,
        source: Box<DbError>,
    },
    StoreRootHashMissing,
    ExcludedDeviceMustReset {
        circle_id: CircleId,
        close_id: CircleEpochCloseId,
    },
}

An error from the owned database.

Variants

Message(String)

WriteDependencyConflict

Fields

writes: Vec<WriteId>

ReplayRetirementCutNotPrefix

ReadOnlyWriteTransaction

Sqlite(Error)

ExpectedSchema(&'static Error)

Serde(Error)

A JSON column’s bytes did not read back as the value they encode, or a value would not encode. Every synced-protocol column is stored as JSON, so this is the shape of every column-level decode failure.

Protocol(Box<StoreProtocolError>)

Durable bytes failed the Store protocol’s own validation — a hash that does not match, a signature that does not verify, an object in the wrong slot. The database read them back intact; the protocol refused them.

RemoteObject(Box<RemoteObjectRecordError>)

AudiencePackage(Box<AudiencePackageError>)

ObjectHash(InvalidObjectHash)

BlobLocator(BlobLocatorError)

CircleId(CircleIdError)

RowRoutingKey(RowRoutingKeyError)

CirclePartitionControl(CirclePartitionControlError)

Gate(GateError)

Storage(StorageError)

BlobPath(PathTokenError)

Io(Error)

File(FileError)

LocalBlobRemoval(LocalBlobRemovalError)

CachedLocatorRemoval(CachedLocatorRemovalError)

IntRange(TryFromIntError)

A stored integer column did not fit the type the schema says it holds.

ParseInt(ParseIntError)

Utf8(FromUtf8Error)

Utf8Slice(Utf8Error)

BlobDecl(BlobDeclError)

ChangesetIdentity(ChangesetIdentityError)

Changeset(ChangesetError)

AuthorStreamId(AuthorStreamIdParseError)

RowBlobRef(RowBlobRefError)

WriteRetraction(Box<WriteRetractionError>)

RotationGate(RotationGateError)

Encryption(EncryptionError)

SnapshotImage(Box<SnapshotImageError>)

PayloadStore(Box<PayloadStoreError>)

PayloadCleanupFailed

Fields

operation: Box<DbError>

cleanup: Box<DbError>

ChangeCaptureFailed

Fields

operation: Box<DbError>

capture: Box<DbError>

FromSql(FromSqlError)

BlobOpeningAuthority(BlobOpeningAuthorityError)

OwnerPromotionJournal(Box<OwnerPromotionJournalError>)

CircleJournal(Box<CircleJournalError>)

SyncRoutingContract(SyncRoutingContractError)

RowIdentity(RowIdentityError)

PreparedCommit(Box<PreparedCommitError>)

CircleState(Box<CircleStateError>)

DeviceExclusionJournal(Box<StoreDeviceExclusionJournalError>)

StoreReclaimJournal(Box<StoreReclaimJournalError>)

CommitNewFile(CommitNewFileError)

AudienceBlobStaging(Box<dyn Error + Send + Sync + 'static>)

Staging a write’s audience-move blobs failed. The implementation of AudienceBlobMoveStaging is injected from above, so its failure is carried as an opaque source rather than named here.

AudienceBlobRollbackFailed

Staging a write’s audience-move blobs failed AND rolling the staged files back failed, so those files are left on disk. Carries both failures rather than reporting one and describing the other.

Fields

operation: Box<DbError>

rollback: StagedBlobRollbackFailures

StagedBlobRollback(StagedBlobRollbackFailures)

BlobMoveRequiresMaterialization

An audience move needs its blob materialized locally and it is not — the row’s bytes are absent, stale, or refuse their declared identity. Names the row so the caller can act on it.

Fields

table: String

row_id: String

column: String

row_stamp: String

reason: Box<DbError>

UnparseableOutboxAttemptTime

A queued outbox entry’s last_attempt_at is not an RFC 3339 timestamp, so whether the entry is still inside its retry backoff cannot be decided. Names the entry so the caller can act on that row.

Fields

entry_id: i64

value: String

source: ParseError

Context

A DbError with the operation that produced it named in front of it. Carries the cause as a DbError so callers keep matching on it after it crosses the layer that added the description.

Fields

context: String

source: Box<DbError>

StoreRootHashMissing

ExcludedDeviceMustReset

The local device was excluded from a Circle epoch close and has not yet reset its projection from the successor bootstrap, so it cannot publish into the Circle. Stays matchable at the publication boundary rather than flattening into a message.

Fields

circle_id: CircleId

close_id: CircleEpochCloseId

Implementations

impl DbError

pub fn context( context: impl Into<String>, source: impl Into<DbError>, ) -> DbError

Name the operation source failed in without flattening it: the cause stays a DbError the caller can still match on.

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

fn from(source: AudiencePackageError) -> Self

Converts to this type from the input type.

impl From<AuthorStreamIdParseError> for DbError

fn from(source: AuthorStreamIdParseError) -> Self

Converts to this type from the input type.

impl From<BlobDeclError> for DbError

fn from(source: BlobDeclError) -> Self

Converts to this type from the input type.

impl From<BlobLocatorError> for DbError

fn from(source: BlobLocatorError) -> Self

Converts to this type from the input type.

impl From<BlobOpeningAuthorityError> for DbError

fn from(source: BlobOpeningAuthorityError) -> Self

Converts to this type from the input type.

impl From<CachedLocatorRemovalError> for DbError

fn from(source: CachedLocatorRemovalError) -> Self

Converts to this type from the input type.

impl From<ChangesetError> for DbError

fn from(source: ChangesetError) -> Self

Converts to this type from the input type.

impl From<ChangesetIdentityError> for DbError

fn from(source: ChangesetIdentityError) -> Self

Converts to this type from the input type.

impl From<CircleIdError> for DbError

fn from(source: CircleIdError) -> Self

Converts to this type from the input type.

impl From<CircleJournalError> for DbError

fn from(source: CircleJournalError) -> Self

Converts to this type from the input type.

impl From<CirclePartitionControlError> for DbError

fn from(source: CirclePartitionControlError) -> Self

Converts to this type from the input type.

impl From<CircleStateError> for DbError

fn from(source: CircleStateError) -> Self

Converts to this type from the input type.

impl From<CommitNewFileError> for DbError

fn from(source: CommitNewFileError) -> Self

Converts to this type from the input type.

impl From<DbError> for CovenMigrationError

fn from(source: DbError) -> Self

Converts to this type from the input type.

impl From<DbError> for DeviceJoinJournalError

fn from(source: DbError) -> Self

Converts to this type from the input type.

impl<E> From<DbError> for HostWriteError<E>

fn from(value: DbError) -> Self

Converts to this type from the input type.

impl From<DbError> for OpenError

fn from(source: DbError) -> Self

Converts to this type from the input type.

impl From<DbError> for SnapshotImageError

fn from(error: DbError) -> Self

Converts to this type from the input type.

impl From<EncryptionError> for DbError

fn from(source: EncryptionError) -> Self

Converts to this type from the input type.

impl From<Error> for DbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FileError> for DbError

fn from(source: FileError) -> Self

Converts to this type from the input type.

impl From<FromSqlError> for DbError

fn from(source: FromSqlError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for DbError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<GateError> for DbError

fn from(source: GateError) -> Self

Converts to this type from the input type.

impl From<InvalidObjectHash> for DbError

fn from(source: InvalidObjectHash) -> Self

Converts to this type from the input type.

impl From<LocalBlobRemovalError> for DbError

fn from(source: LocalBlobRemovalError) -> Self

Converts to this type from the input type.

impl From<OwnerPromotionJournalError> for DbError

fn from(source: OwnerPromotionJournalError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for DbError

fn from(source: ParseIntError) -> Self

Converts to this type from the input type.

impl From<PathTokenError> for DbError

fn from(source: PathTokenError) -> Self

Converts to this type from the input type.

impl From<PayloadStoreError> for DbError

fn from(source: PayloadStoreError) -> Self

Converts to this type from the input type.

impl From<PreparedCommitError> for DbError

fn from(source: PreparedCommitError) -> Self

Converts to this type from the input type.

impl From<RemoteObjectRecordError> for DbError

fn from(source: RemoteObjectRecordError) -> Self

Converts to this type from the input type.

impl From<RotationGateError> for DbError

fn from(source: RotationGateError) -> Self

Converts to this type from the input type.

impl From<RowBlobRefError> for DbError

fn from(source: RowBlobRefError) -> Self

Converts to this type from the input type.

impl From<RowIdentityError> for DbError

fn from(source: RowIdentityError) -> Self

Converts to this type from the input type.

impl From<RowRoutingKeyError> for DbError

fn from(source: RowRoutingKeyError) -> Self

Converts to this type from the input type.

impl From<SnapshotImageError> for DbError

fn from(source: SnapshotImageError) -> Self

Converts to this type from the input type.

impl From<StorageError> for DbError

fn from(source: StorageError) -> Self

Converts to this type from the input type.

impl From<StoreDeviceExclusionJournalError> for DbError

fn from(source: StoreDeviceExclusionJournalError) -> Self

Converts to this type from the input type.

impl From<StoreProtocolError> for DbError

fn from(source: StoreProtocolError) -> Self

Converts to this type from the input type.

impl From<StoreReclaimJournalError> for DbError

fn from(source: StoreReclaimJournalError) -> Self

Converts to this type from the input type.

impl From<SyncRoutingContractError> for DbError

fn from(source: SyncRoutingContractError) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for DbError

fn from(source: TryFromIntError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for DbError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.

impl From<WriteRetractionError> for DbError

fn from(source: WriteRetractionError) -> Self

Converts to this type from the input type.