Struct consensus_types::block::Block

pub struct Block { /* private fields */ }

Block has the core data of a consensus block that should be persistent when necessary. Each block must know the id of its parent and keep the QuorurmCertificate to that parent.

Implementations

impl Block

pub fn author(&self) -> Option<Author>

pub fn epoch(&self) -> u64

pub fn id(&self) -> HashValue

pub fn parent_id(&self) -> HashValue

pub fn payload(&self) -> Option<&Payload>

pub fn quorum_cert(&self) -> &QuorumCert

pub fn round(&self) -> Round

pub fn signature(&self) -> Option<&Signature>

pub fn timestamp_usecs(&self) -> u64

pub fn gen_block_info(
    &self,
    executed_state_id: HashValue,
    version: Version,
    next_epoch_state: Option<EpochState>
) -> BlockInfo

pub fn block_data(&self) -> &BlockData

pub fn is_genesis_block(&self) -> bool

pub fn is_nil_block(&self) -> bool

pub fn make_genesis_block_from_ledger_info(ledger_info: &LedgerInfo) -> Self

Construct new genesis block for next epoch deterministically from the end-epoch LedgerInfo We carry over most fields except round and block id

pub fn new_nil(
    round: Round,
    quorum_cert: QuorumCert,
    failed_authors: Vec<(Round, Author)>
) -> Self

The NIL blocks are special: they’re not carrying any real payload and are generated independently by different validators just to fill in the round with some QC.

pub fn new_proposal(
    payload: Payload,
    round: Round,
    timestamp_usecs: u64,
    quorum_cert: QuorumCert,
    validator_signer: &ValidatorSigner,
    failed_authors: Vec<(Round, Author)>
) -> Self

pub fn new_proposal_from_block_data(
    block_data: BlockData,
    validator_signer: &ValidatorSigner
) -> Self

pub fn new_proposal_from_block_data_and_signature(
    block_data: BlockData,
    signature: Signature
) -> Self

pub fn validate_signature(&self, validator: &ValidatorVerifier) -> Result<()>

Verifies that the proposal and the QC are correctly signed. If this is the genesis block, we skip these checks.

pub fn verify_well_formed(&self) -> Result<()>

Makes sure that the proposal makes sense, independently of the current state. If this is the genesis block, we skip these checks.

pub fn transactions_to_execute(
    &self,
    validators: &[AccountAddress]
) -> Vec<Transaction>

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Block

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for Block

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

Formats the value using the given formatter.

impl PartialEq<Block> for Block

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Serialize for Block

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 Block

impl StructuralEq for Block

impl StructuralPartialEq for Block