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<&ConsensusSignature>

pub fn vrf_proof(&self) -> Option<&ConsensusVRFProof>

pub fn vrf_nonce(&self) -> Option<u64>

pub fn set_vrf_nonce_and_proof( &mut self, vrf_nonce_and_proof: (u64, ConsensusVRFProof) )

pub fn timestamp_usecs(&self) -> u64

pub fn gen_block_info( &self, executed_state_id: HashValue, version: Version, next_epoch_state: Option<EpochState>, pivot: Option<PivotBlockDecision> ) -> 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) -> 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 ) -> 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: ConsensusSignature, vrf_nonce_and_proof: Option<(u64, ConsensusVRFProof)> ) -> 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.

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 From<&Block> for BlockMetadata

fn from(block: &Block) -> Self

Converts to this type from the input type.

impl From<BlockUnchecked> for Block

fn from(b: BlockUnchecked) -> Self

Converts to this type from the input type.

impl PartialEq 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: &Rhs) -> bool

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

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 StructuralPartialEq for Block