Struct CheckpointCompetition 

pub struct CheckpointCompetition {
    pub epoch: u64,
    pub submissions: Vec<CheckpointSubmission>,
    pub status: CompetitionStatus,
    pub current_winner: Option<usize>,
}

Per-epoch checkpoint competition, collecting submissions and selecting a winner.

Spec ref: SPEC §3.9 / CKP-001.

Fields

epoch: u64

Epoch this competition belongs to.

submissions: Vec<CheckpointSubmission>

All checkpoint submissions received.

status: CompetitionStatus

Current competition state.

current_winner: Option<usize>

Index into submissions of the current leader, if any.

Implementations

impl CheckpointCompetition

pub fn new(epoch: u64) -> Self

Creates a new competition for epoch in Pending state with no submissions.

pub fn is_finalized(&self) -> bool

True when the competition has reached the Finalized variant.

pub fn start(&mut self) -> Result<(), CheckpointCompetitionError>

Transitions Pending → Collecting.

Returns Err(NotStarted) if already past Pending. (Reusing NotStarted as the generic “wrong-lifecycle-state” error; specific variants may be refined in later tightening.)

pub fn submit( &mut self, submission: CheckpointSubmission, ) -> Result<bool, CheckpointCompetitionError>

Records a checkpoint submission and, if its score beats the current leader, transitions status to WinnerSelected (or updates the existing one).

Returns true when the submission became the new leader.

Errors:

• NotStarted — status is Pending
• AlreadyFinalized — status is Finalized / Failed
• EpochMismatch — submission.epoch != self.epoch
• ScoreNotHigher — score does not exceed current leader

pub fn finalize( &mut self, l1_height: u32, ) -> Result<Bytes32, CheckpointCompetitionError>

Transitions WinnerSelected → Finalized { winner_hash, l1_height }.

Returns the winning checkpoint hash.

pub fn fail(&mut self) -> Result<(), CheckpointCompetitionError>

Transitions to Failed (terminal). Legal from Collecting or WinnerSelected.

pub fn winner(&self) -> Option<&CheckpointSubmission>

Returns the winning checkpoint submission, if one has been selected.

pub fn to_bytes(&self) -> Vec<u8>

Serializes with bincode. Infallible for well-formed structs.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, EpochError>

Deserializes from bincode bytes, returning EpochError::InvalidData on failure.

Trait Implementations

impl Clone for CheckpointCompetition

fn clone(&self) -> CheckpointCompetition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheckpointCompetition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CheckpointCompetition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CheckpointCompetition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.