Struct exonum::messages::Precommit

pub struct Precommit { /* fields omitted */ }

Pre-commit for a proposal.

Validation

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

Processing

Pre-commit is added to the list of known pre-commits. If a proposal is unknown to the node, ProposeRequest is sent in reply. If round number from the message is bigger than a node's "locked round", then a node replies with PrevotesRequest. If there are unknown transactions, then TransactionsRequest is sent in reply. If a validator receives +2/3 precommits for the same proposal with the same block_hash, then block is executed and Status is broadcast.

Generation

A node broadcasts Precommit in response to Prevote if there are +2/3 pre-votes and no unknown transactions.

Methods

impl Precommit

pub fn new(
    validator: ValidatorId,
    height: Height,
    round: Round,
    propose_hash: &Hash,
    block_hash: &Hash,
    time: SystemTime,
    secret_key: &SecretKey
) -> Precommit

Creates message and signs it.

pub fn new_with_signature(
    validator: ValidatorId,
    height: Height,
    round: Round,
    propose_hash: &Hash,
    block_hash: &Hash,
    time: SystemTime,
    signature: &Signature
) -> Precommit

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 block_hash(&self) -> &Hash

Hash of the new block.

pub fn time(&self) -> SystemTime

Time of the Precommit.

Trait Implementations

impl Clone for Precommit

fn clone(&self) -> Precommit

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for Precommit

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

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

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

This method tests for !=.

impl ServiceMessage for Precommit

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 + 1

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

impl Message for Precommit

fn from_raw(raw: RawMessage) -> Result<Precommit, 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 Precommit

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 Precommit

fn as_ref(&self) -> &RawMessage

Performs the conversion.

impl FromHex for Precommit

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 Precommit

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 Precommit

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

Formats the value using the given formatter.

impl ExonumJson for Precommit

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 Precommit

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

deserialize json value.

impl<'de> Deserialize<'de> for Precommit

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

Deserialize this value from the given Serde deserializer.

impl Serialize for Precommit

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 Precommit

fn validator(&self) -> ValidatorId

Return validator if of the message.