Struct BlockProposal 

pub struct BlockProposal {
    pub content: ProposalContent,
    pub signature: AccountSignature,
    pub original_proposal: Option<OriginalProposal>,
}

An authenticated proposal for a new block.

Fields

content: ProposalContent

The signed content of the proposal: the proposed block, the round, and any execution outcome from a previous round.

signature: AccountSignature

The proposer’s signature over content.

original_proposal: Option<OriginalProposal>

The earlier proposal being retried, if this proposal is a retry in a later round.

Implementations

impl BlockProposal

pub async fn new_initial<S: Signer + ?Sized>( owner: AccountOwner, round: Round, block: ProposedBlock, signer: &S, ) -> Result<Self, S::Error>

Creates a new block proposal, signed by the given owner.

pub async fn new_retry_fast<S: Signer + ?Sized>( owner: AccountOwner, round: Round, old_proposal: BlockProposal, signer: &S, ) -> Result<Self, S::Error>

Creates a proposal that retries a fast-round proposal in a later round.

pub async fn new_retry_regular<S: Signer>( owner: AccountOwner, round: Round, validated_block_certificate: ValidatedBlockCertificate, signer: &S, ) -> Result<Self, S::Error>

Creates a proposal that retries a validated block from an earlier round.

pub fn owner(&self) -> AccountOwner

Returns the AccountOwner that proposed the block.

pub fn check_signature(&self) -> Result<(), CryptoError>

Verifies the signature on this proposal.

pub fn required_blob_ids(&self) -> impl Iterator<Item = BlobId> + '_

Returns the IDs of the blobs that must be available to validate this proposal.

pub fn expected_blob_ids(&self) -> impl Iterator<Item = BlobId> + '_

Returns the IDs of the blobs that are required or created by this proposal.

pub fn check_invariants(&self) -> Result<(), &'static str>

Checks that the original proposal, if present, matches the new one and has a higher round.

Trait Implementations

impl Allocative for BlockProposal

fn visit<'allocative_a, 'allocative_b: 'allocative_a>( &self, visitor: &'allocative_a mut Visitor<'allocative_b>, )

impl Clone for BlockProposal

fn clone(&self) -> BlockProposal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlockProposal

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BlockProposal

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for BlockProposal

fn eq(&self, other: &BlockProposal) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for BlockProposal

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BlockProposal

impl StructuralPartialEq for BlockProposal