Struct AttestedBlock 

pub struct AttestedBlock {
    pub block: L2Block,
    pub signer_bitmap: SignerBitmap,
    pub aggregate_signature: Signature,
    pub receipts: ReceiptList,
    pub status: BlockStatus,
}

L2 block wrapped with attestation state: who signed, aggregate BLS signature, receipts, lifecycle status.

Fields (NORMATIVE ATT-001): See ATT-001 table.

Fields

block: L2Block

Underlying L2 block (header hash is canonical block id via L2Block::hash).

signer_bitmap: SignerBitmap

Which validators have attested (bit-packed, sized by epoch validator set).

aggregate_signature: Signature

Rolling aggregate BLS signature over attester contributions; starts as the proposer signature.

receipts: ReceiptList

Execution receipts for spends in this block (ReceiptList; fleshed out in RCP-003/004).

status: BlockStatus

Attestation / finality pipeline state (BlockStatus).

Implementations

impl AttestedBlock

pub fn new(block: L2Block, validator_count: u32, receipts: ReceiptList) -> Self

Build an attested wrapper: empty bitmap, BlockStatus::Pending, aggregate sig = proposer’s signature.

Invariants (ATT-001):

• Self::signer_bitmap is SignerBitmap::new(validator_count) → zero signers.
• Self::status is BlockStatus::Pending.
• Self::aggregate_signature is a clone of L2Block::proposer_signature.
• Self::block and Self::receipts move in from the caller.

Panics: If validator_count > MAX_VALIDATORS — same cap as crate::SignerBitmap::new.

pub fn signing_percentage(&self) -> u64

Integer signing progress 0..=100 — thin wrapper over SignerBitmap::signing_percentage.

ATT-002: Keeps quorum logic on one type (SignerBitmap math in ATT-004) while exposing a stable AttestedBlock surface for consensus code (NORMATIVE § ATT-002).

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

true iff Self::signing_percentage >= threshold_pct (soft-finality / stake-threshold gate).

ATT-002: Delegates to SignerBitmap::has_threshold so boundary behavior matches ATT-004 tests (integer division, validator_count == 0 → 0%).

pub fn hash(&self) -> Bytes32

Block identity: SHA-256 header preimage hash (L2Block::hash, HSH-001 / SPEC §2.3).

ATT-002 / NORMATIVE: MUST equal self.block.hash() so attested and raw blocks share one id in indices, checkpoints, and P2P — no second hash domain for the attestation wrapper.

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

Serialize attested block (inner L2Block + bitmap + signatures + receipts + status) to bincode (SER-002).

Infallible: Mirrors L2Block::to_bytes — struct must encode; panics only on invariant violation.

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

Deserialize from bincode bytes (SER-002).

Trait Implementations

impl Clone for AttestedBlock

fn clone(&self) -> AttestedBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttestedBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AttestedBlock

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AttestedBlock

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

where __S: Serializer,

Serialize this value into the given Serde serializer.