Struct RequestExtendVote 

pub struct RequestExtendVote {
    pub hash: Vec<u8>,
    pub height: i64,
    pub round: i32,
}

Extends a vote with application-side injection

Usage

• ResponseExtendVote.vote_extensions is optional information that, if present, will be signed by Tenderdash and attached to the Precommit message.
• RequestExtendVote.hash corresponds to the hash of a proposed block that was made available to the application in a previous call to ProcessProposal or PrepareProposal for the current height.
• ResponseExtendVote.vote_extensions will only be attached to a non-nil Precommit message. If Tenderdash is to precommit nil, it will not call RequestExtendVote.
• The Application logic that creates the extensions can be non-deterministic.

When does Tenderdash call it?

When a validator p is in Tenderdash consensus state prevote of round r, height h, in which q is the proposer; and p has received

• the Proposal message v for round r, height h, along with all the block parts, from q,
• Prevote messages from 2f + 1 validators’ voting power for round r, height h, prevoting for the same block id(v),

then p’s Tenderdash locks v and sends a Precommit message in the following way

1. p’s Tenderdash sets lockedValue and validValue to v, and sets lockedRound and validRound to r
2. p’s Tenderdash calls RequestExtendVote with id(v) (RequestExtendVote.hash). The call is synchronous.
3. The Application optionally returns an array of bytes, ResponseExtendVote.extension, which is not interpreted by Tenderdash.
4. p’s Tenderdash includes ResponseExtendVote.extension in a field of type CanonicalVoteExtension, it then populates the other fields in CanonicalVoteExtension, and signs the populated data structure.
5. p’s Tenderdash constructs and signs the CanonicalVote structure.
6. p’s Tenderdash constructs the Precommit message (i.e. Vote structure) using CanonicalVoteExtension and CanonicalVote.
7. p’s Tenderdash broadcasts the Precommit message.

In the cases when p’s Tenderdash is to broadcast precommit nil messages (either 2f+1 prevote nil messages received, or timeoutPrevote triggered), p’s Tenderdash does not call RequestExtendVote and will not include a CanonicalVoteExtension field in the precommit nil message.

Fields

hash: Vec<u8>

The header hash of the proposed block that the vote extensions is to refer to.

height: i64

Height of the proposed block (for sanity check).

round: i32

// Round number for the block.

Trait Implementations

impl Clone for RequestExtendVote

fn clone(&self) -> RequestExtendVote

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestExtendVote

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

Formats the value using the given formatter.

impl Default for RequestExtendVote

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RequestExtendVote

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<RequestExtendVote> for Value

fn from(value: RequestExtendVote) -> Self

Converts to this type from the input type.

impl Hash for RequestExtendVote

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 Message for RequestExtendVote

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

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

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

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

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for RequestExtendVote

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for RequestExtendVote

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 RequestExtendVote

impl StructuralPartialEq for RequestExtendVote