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 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 PartialEq for Prevote

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

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

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

This method tests for !=.

impl ServiceMessage for Prevote

const SERVICE_ID: u16

SERVICE_ID: u16 = CONSENSUS

ID of the service this message belongs to.

const MESSAGE_ID: u16

MESSAGE_ID: u16 = 0 + 1 + 1 + 1

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<'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 AsRef<RawMessage> for Prevote

fn as_ref(&self) -> &RawMessage

Performs the conversion.

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.

impl StorageValue for Prevote

Important traits for Vec<u8>

impl Write for Vec<u8>

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 Debug for Prevote

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

Formats the value using the given formatter.

impl ExonumJson for Prevote

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

write deserialized field in buffer on place.

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

serialize field as json::Value

impl ExonumJsonDeserialize for Prevote

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

deserialize json value.

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 VoteMessage for Prevote

fn validator(&self) -> ValidatorId

Return validator if of the message.