Struct CheckpointSubmission 

pub struct CheckpointSubmission {
    pub checkpoint: Checkpoint,
    pub signer_bitmap: SignerBitmap,
    pub aggregate_signature: Signature,
    pub aggregate_pubkey: PublicKey,
    pub score: u64,
    pub submitter: u32,
    pub submission_height: Option<u32>,
    pub submission_coin: Option<BytesImpl<32>>,
}

Signed checkpoint submission: epoch summary plus validator attestation material (SPEC §2.7, CKP-002).

Field semantics

• checkpoint: The Checkpoint being proposed for L1 anchoring (CKP-001).
• signer_bitmap / aggregate_signature / aggregate_pubkey: Who attested and the aggregated BLS proof over the checkpoint preimage (exact signing protocol is outside this crate; types match ATT-001 / ATT-004 patterns).
• score: Competition score, often populated from Checkpoint::compute_score (CKP-004).
• submitter: Validator index in the epoch set who published this submission (CKP-002 implementation notes).
• submission_height / submission_coin: L1 observation metadata; None until record_submission.

Serialization: Serialize / Deserialize for bincode (SER-001).

Fields

checkpoint: Checkpoint

Epoch summary being submitted.

signer_bitmap: SignerBitmap

Which validators signed this submission (SignerBitmap, ATT-004).

aggregate_signature: Signature

Aggregated BLS signature over the checkpoint commitment.

aggregate_pubkey: PublicKey

Aggregated BLS public key corresponding to aggregate_signature.

score: u64

Off-chain / protocol score used to compare competing submissions (CKP-004).

submitter: u32

Index of the validator who broadcast this submission.

submission_height: Option<u32>

L1 block height where the submission transaction was observed, once recorded (CKP-005).

submission_coin: Option<BytesImpl<32>>

L1 coin ID for the submission transaction, once recorded (CKP-005).

Implementations

impl CheckpointSubmission

pub fn new( checkpoint: Checkpoint, signer_bitmap: SignerBitmap, aggregate_signature: Signature, aggregate_pubkey: PublicKey, score: u64, submitter: u32, ) -> CheckpointSubmission

Build a submission with attestation material but no L1 inclusion data yet (CKP-002).

submission_height / submission_coin: Initialized to None; use Self::record_submission after L1 confirmation (CKP-005).

pub fn hash(&self) -> BytesImpl<32>

Delegates to Checkpoint::hash — canonical epoch-summary identity (CKP-005, HSH-002).

pub fn epoch(&self) -> u64

Epoch number from the wrapped Checkpoint (CKP-005).

pub fn signing_percentage(&self) -> u64

Validator participation as an integer percent 0..=100 — delegates to SignerBitmap::signing_percentage (CKP-005, ATT-004).

pub fn meets_threshold(&self, threshold_pct: u64) -> bool

true iff Self::signing_percentage >= threshold_pct (SignerBitmap::has_threshold, CKP-005).

pub fn record_submission(&mut self, height: u32, coin_id: BytesImpl<32>)

Record L1 inclusion: block height and submission coin id (CKP-005).

Normative: Both fields become Some; Self::is_submitted becomes true because submission_height is set.

pub fn is_submitted(&self) -> bool

true once submission_height is Some (NORMATIVE § CKP-005).

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

Serialize submission (checkpoint + attestation material) to bincode bytes (SER-002).

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

Deserialize a submission from bincode bytes (SER-002).

Trait Implementations

impl Clone for CheckpointSubmission

fn clone(&self) -> CheckpointSubmission

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheckpointSubmission

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CheckpointSubmission

fn deserialize<__D>( __deserializer: __D, ) -> Result<CheckpointSubmission, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CheckpointSubmission

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

where __S: Serializer,

Serialize this value into the given Serde serializer.