Struct exonum::messages::Prevote

pub struct Prevote { /* fields omitted */ }

Pre-vote for a new block.

Validation

A node panics if it has already sent a different Prevote for the same round.

Processing

Pre-vote is added to the list of known votes for the same proposal. If locked_round number from the message is bigger than in a node state, then a node replies with PrevotesRequest. If there are unknown transactions in the propose specified by propose_hash, TransactionsRequest is sent in reply. Otherwise if all transactions are known and there are +2/3 pre-votes, then a node is locked to that proposal and Precommit is broadcast.

Generation

A node broadcasts Prevote in response to Propose when it has received all the transactions.

Methods

impl Prevote

pub fn new(     validator: ValidatorId,     height: Height,     round: Round,     propose_hash: &Hash,     locked_round: Round,     secret_key: &SecretKey ) -> Prevote

Creates message and signs it.

pub fn new_with_signature(     validator: ValidatorId,     height: Height,     round: Round,     propose_hash: &Hash,     locked_round: Round,     signature: &Signature ) -> Prevote

Creates message and appends existing signature.

pub fn to_hex(&self) -> String

Returns the hex representation of the binary data. Lower case letters are used (e.g. f9b4ca).

pub fn validator(&self) -> ValidatorId

The validator id.

pub fn height(&self) -> Height

The height to which the message is related.

pub fn round(&self) -> Round

The round to which the message is related.

pub fn propose_hash(&self) -> &Hash

Hash of the corresponding Propose.

pub fn locked_round(&self) -> Round

Locked round.

Trait Implementations

impl ExonumJson for Prevote

fn deserialize_field<B>(     value: &Value,     buffer: &mut B,     from: Offset,     to: Offset ) -> Result<(), Box<dyn Error>> where     B: WriteBufferWrapper,

write deserialized field in buffer on place.

fn serialize_field(&self) -> Result<Value, Box<dyn Error + Send + Sync>>

serialize field as json::Value

impl ExonumJsonDeserialize for Prevote

fn deserialize(value: &Value) -> Result<Self, Box<dyn Error>>

deserialize json value.

impl<'a> SegmentField<'a> for Prevote

fn item_size() -> Offset

size of item fixed part that this Field collect.

fn count(&self) -> Offset

count of items in collection

fn extend_buffer(&self, buffer: &mut Vec<u8>)

extend buffer with this collection

unsafe fn from_buffer(buffer: &'a [u8], from: Offset, count: Offset) -> Self

create collection from buffer

fn check_data(     buffer: &'a [u8],     from: CheckedOffset,     count: CheckedOffset,     latest_segment: CheckedOffset ) -> Result

check collection data

impl ServiceMessage for Prevote

const SERVICE_ID: u16

ID of the service this message belongs to.

const MESSAGE_ID: u16

ID of the message itself. Should be unique within a service.

impl Message for Prevote

fn from_raw(raw: RawMessage) -> Result<Prevote, Error>

Converts the raw message into the specific one.

fn raw(&self) -> &RawMessage

Returns raw message.

fn verify_signature(&self, pub_key: &PublicKey) -> bool

Verifies the message using given public key.

impl VoteMessage for Prevote

fn validator(&self) -> ValidatorId

Return validator if of the message.

impl StorageValue for Prevote

fn into_bytes(self) -> Vec<u8>

Serialize a value into a vector of bytes.

fn from_bytes(value: Cow<[u8]>) -> Self

Deserialize a value from bytes.

impl PartialEq<Prevote> for Prevote

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

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

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

This method tests for !=.

impl AsRef<RawMessage> for Prevote

fn as_ref(&self) -> &RawMessage

Performs the conversion.

impl Clone for Prevote

fn clone(&self) -> Prevote

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Prevote

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Prevote

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

Deserialize this value from the given Serde deserializer.

impl Serialize for Prevote

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where     S: Serializer,

Serialize this value into the given Serde serializer.

impl FromHex for Prevote

type Error = Error

fn from_hex<T: AsRef<[u8]>>(hex: T) -> Result<Self, Self::Error>

Creates an instance of type Self from the given hex string, or fails with a custom error type.