Struct RequestVerifyVoteExtension 

pub struct RequestVerifyVoteExtension {
    pub hash: Vec<u8>,
    pub validator_pro_tx_hash: Vec<u8>,
    pub height: i64,
    pub round: i32,
    pub vote_extensions: Vec<ExtendVoteExtension>,
}

Verify the vote extension

Usage

• RequestVerifyVoteExtension.vote_extension can be an empty byte array. The Application’s interpretation of it should be that the Application running at the process that sent the vote chose not to extend it. Tenderdash will always call RequestVerifyVoteExtension, even for 0 length vote extensions.
• If ResponseVerifyVoteExtension.status is REJECT, Tenderdash will reject the whole received vote. See the Requirements section to understand the potential liveness implications of this.
• The implementation of VerifyVoteExtension MUST be deterministic. Moreover, the value of ResponseVerifyVoteExtension.status MUST exclusively depend on the parameters passed in the call to RequestVerifyVoteExtension, and the last committed Application state (see Requirements section).
• Moreover, application implementers SHOULD always set ResponseVerifyVoteExtension.status to ACCEPT, unless they really know what the potential liveness implications of returning REJECT are.

When does Tenderdash call it?

When a validator p is in Tenderdash consensus round r, height h, state prevote (TODO discuss: I think I must remove the state from this condition, but not sure), and p receives a Precommit message for round r, height h from q:

1. If the Precommit message does not contain a vote extensions with a valid signature, Tenderdash discards the message as invalid.

• a 0-length vote extensions is valid as long as its accompanying signature is also valid.

2. Else, p’s Tenderdash calls RequestVerifyVoteExtension.
3. The Application returns accept or reject via ResponseVerifyVoteExtension.status.
4. If the Application returns

• accept, p’s Tenderdash will keep the received vote, together with its corresponding vote extension in its internal data structures. It will be used to populate the ExtendedCommitInfo structure in calls to RequestPrepareProposal, in rounds of height h + 1 where p is the proposer.
• reject, p’s Tenderdash will deem the Precommit message invalid and discard it.

Fields

hash: Vec<u8>

The header hash of the propsed block that the vote extensions refers to.

validator_pro_tx_hash: Vec<u8>

ProTxHash of the validator that signed the extensions.

height: i64

Height of the block (for sanity check).

round: i32

// Round number for the block.

vote_extensions: Vec<ExtendVoteExtension>

Application-specific information signed by Tenderdash. Can have 0 length.

Trait Implementations

impl Clone for RequestVerifyVoteExtension

fn clone(&self) -> RequestVerifyVoteExtension

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestVerifyVoteExtension

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

Formats the value using the given formatter.

impl Default for RequestVerifyVoteExtension

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RequestVerifyVoteExtension

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<RequestVerifyVoteExtension> for Value

fn from(value: RequestVerifyVoteExtension) -> Self

Converts to this type from the input type.

impl Message for RequestVerifyVoteExtension

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 RequestVerifyVoteExtension

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RequestVerifyVoteExtension