commonware_storage/qmdb/sync/
error.rs

1//! Shared sync error types that can be used across different database implementations.
2
3use crate::{mmr::Location, qmdb::sync::Target};
4use commonware_cryptography::Digest;
5
6#[derive(Debug, thiserror::Error)]
7pub enum EngineError<D: Digest> {
8    /// Hash mismatch after sync
9    #[error("root digest mismatch - expected {expected:?}, got {actual:?}")]
10    RootMismatch { expected: D, actual: D },
11    /// Invalid target parameters
12    #[error("invalid bounds: lower bound {lower_bound_pos} > upper bound {upper_bound_pos}")]
13    InvalidTarget {
14        lower_bound_pos: Location,
15        upper_bound_pos: Location,
16    },
17    /// Invalid client state
18    #[error("invalid client state")]
19    InvalidState,
20    /// Sync target root unchanged
21    #[error("sync target root unchanged")]
22    SyncTargetRootUnchanged,
23    /// Sync target moved backward
24    #[error("sync target moved backward: {old:?} -> {new:?}")]
25    SyncTargetMovedBackward { old: Target<D>, new: Target<D> },
26    /// Sync already completed
27    #[error("sync already completed")]
28    AlreadyComplete,
29    /// Sync stalled - no pending fetches
30    #[error("sync stalled - no pending fetches")]
31    SyncStalled,
32    /// Error extracting pinned nodes
33    #[error("error extracting pinned nodes: {0}")]
34    PinnedNodes(String),
35}
36
37/// Errors that can occur during database synchronization.
38#[derive(Debug, thiserror::Error)]
39pub enum Error<U, D>
40where
41    U: std::error::Error + Send + 'static,
42    D: Digest,
43{
44    /// Database error
45    #[error("database error: {0}")]
46    Database(crate::qmdb::Error),
47
48    /// Resolver error
49    #[error("resolver error: {0:?}")]
50    Resolver(U),
51
52    /// Engine error
53    #[error("engine error: {0}")]
54    Engine(EngineError<D>),
55}
56
57impl<T, U, D> From<T> for Error<U, D>
58where
59    U: std::error::Error + Send + 'static,
60    D: Digest,
61    T: Into<crate::qmdb::Error>,
62{
63    fn from(err: T) -> Self {
64        Self::Database(err.into())
65    }
66}
commonware_storage/qmdb/sync/error.rs

commonware_storage/qmdb/sync/
error.rs
