polyc-eventlog 2026.8.1

Append-only conversation event log on a commonware-storage journal.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! Errors surfaced by the event log.

/// Failures from opening, appending to, or replaying an [`crate::EventLog`].
///
/// This is a thin wrapper over the underlying
/// [`commonware_storage::journal::Error`]: every fallible event-log operation
/// delegates to the journal primitive, so the storage error is the only failure
/// mode and is preserved verbatim as the [`Self::Journal`] source.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum EventLogError {
    /// The underlying commonware-storage journal returned an error while
    /// opening, appending, committing, or replaying.
    #[error("event log journal error: {0}")]
    Journal(#[from] commonware_storage::journal::Error),
    /// The durable event-count checkpoint ([`crate::checkpoint`]) failed to
    /// open, read, or sync.
    #[error("event log checkpoint error: {0}")]
    Checkpoint(#[from] commonware_storage::metadata::Error),
    /// A partition's tamper-evidence tree could not be rebuilt, or its root
    /// could not be signed.
    ///
    /// A rewrite reports this rather than proceeding: every root the partition
    /// carried was signed over content the rewrite changes, so a rewrite that
    /// cannot sign a fresh one would leave a partition whose signed history
    /// does not describe what it holds.
    #[error("event log integrity error: {0}")]
    Integrity(#[from] crate::IntegrityError),
}