Struct phron_finality::data_io::proposal::UnvalidatedPhronProposal

pub struct UnvalidatedPhronProposal {
    pub branch: Vec<BlockHash>,
    pub number: BlockNumber,
}

Represents a proposal we obtain from another node. Note that since the proposal might come from a malicious node there is no guarantee that the block hashes in the proposal correspond to real blocks and even if they do then they could not match the provided number. Moreover, the block number in the proposal might be completely arbitrary and hence we perform initial validation of the block number and the branch length before we transform it into a safer PhronProposal type that guarantees we will not fail on any integer over- or underflows. We expect that honest nodes create UnvalidatedPhronProposal {branch: [h_0, h_1, …, h_n], number: num} objects that represent an ascending sequence of blocks b_0, b_1, …, b_n satisfying the following conditions: 1) hash(b_i) = h_i for i = 0, 1, …, n, 2) parent(b_{i+1}) = b_i for i = 0, 1, …, (n-1), 3) height(b_n) = num, 4) The parent of b_0 has been finalized (prior to creating this PhronData). Such an UnvalidatedPhronProposal object should be thought of as a proposal for block b_n to be finalized. We refer for to DataProvider for a precise description of honest nodes’ algorithm of creating proposals.

Fields

branch: Vec<BlockHash>

number: BlockNumber

Implementations

impl UnvalidatedPhronProposal

pub(crate) fn new(branch: Vec<BlockHash>, block_number: BlockNumber) -> Self

pub(crate) fn validate_bounds( &self, session_boundaries: &SessionBoundaries ) -> Result<PhronProposal, ValidationError>

Trait Implementations

impl Clone for UnvalidatedPhronProposal

fn clone(&self) -> UnvalidatedPhronProposal

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UnvalidatedPhronProposal

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

Formats the value using the given formatter.

impl Decode for UnvalidatedPhronProposal

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self> ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Encode for UnvalidatedPhronProposal

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl Hash for UnvalidatedPhronProposal

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for UnvalidatedPhronProposal

fn eq(&self, other: &UnvalidatedPhronProposal) -> 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 EncodeLike for UnvalidatedPhronProposal

impl Eq for UnvalidatedPhronProposal

impl StructuralPartialEq for UnvalidatedPhronProposal