Enum CheckpointError 

pub enum CheckpointError {
    InvalidData(String),
    NotFound(u64),
    Invalid(String),
    ScoreNotHigher {
        current: u64,
        submitted: u64,
    },
    EpochMismatch {
        expected: u64,
        got: u64,
    },
    AlreadyFinalized,
    NotStarted,
}

Checkpoint lifecycle failures: submission, scoring, epoch alignment, and finalization (ERR-003).

Design: Checkpoints aggregate L2 state for an epoch and bridge to L1; errors here are orthogonal to per-block BlockError (ERR-003 implementation notes).

Usage: Serialization failures should map to CheckpointError::InvalidData (SER-002); validation layers return structured variants (ScoreNotHigher, EpochMismatch, etc.) per checkpoint NORMATIVE.

Derivation: Debug + Clone + thiserror::Error — same ergonomics as BlockError (SPEC §4.2).

Variants

InvalidData(String)

Bincode or field-level parse failure; also used for generic “bad checkpoint bytes” (SER NORMATIVE).

NotFound(u64)

No checkpoint record for the given epoch (sync / indexer gap).

Invalid(String)

Checkpoint failed semantic validation (Merkle root, signature set, etc.).

ScoreNotHigher

New submission does not beat the incumbent score (ERR-003 notes).

Fields

current: u64

submitted: u64

EpochMismatch

Submission epoch does not match the expected collecting epoch.

Fields

expected: u64

got: u64

AlreadyFinalized

Checkpoint already committed; immutable (ERR-003 notes).

NotStarted

Finalize or query called before the epoch checkpoint process began.

Trait Implementations

impl Clone for CheckpointError

fn clone(&self) -> CheckpointError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CheckpointError

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

Formats the value using the given formatter.

impl Display for CheckpointError

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

Formats the value using the given formatter.

impl Error for CheckpointError

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.