Struct polkadot_node_primitives::disputes::DisputeMessage

pub struct DisputeMessage(_);

A dispute initiating/participating message that have been built from signed statements.

And most likely has been constructed correctly. This is used with DisputeDistributionMessage::SendDispute for sending out votes.

NOTE: This is sent over the wire, any changes are a change in protocol and need to be versioned.

Implementations

impl DisputeMessage

pub fn from_signed_statements( valid_statement: SignedDisputeStatement, valid_index: ValidatorIndex, invalid_statement: SignedDisputeStatement, invalid_index: ValidatorIndex, candidate_receipt: CandidateReceipt, session_info: &SessionInfo ) -> Result<Self, Error>

Build a SignedDisputeMessage and check what can be checked.

This function checks that:

• both statements concern the same candidate
• both statements concern the same session
• the invalid statement is indeed an invalid one
• the valid statement is indeed a valid one
• The passed CandidateReceipt has the correct hash (as signed in the statements).
• the given validator indices match with the given ValidatorIds in the statements, given a SessionInfo.

We don’t check whether the given SessionInfo matches the SessionIndex in the statements, because we can’t without doing a runtime query. Nevertheless this smart constructor gives relative strong guarantees that the resulting SignedDisputeStatement is valid and good. Even the passed SessionInfo is most likely right if this function returns Some, because otherwise the passed ValidatorIds in the SessionInfo at their given index would very likely not match the ValidatorIds in the statements.

So in summary, this smart constructor should be smart enough to prevent from almost all programming errors that one could realistically make here.

pub fn candidate_receipt(&self) -> &CandidateReceipt

Read only access to the candidate receipt.

pub fn session_index(&self) -> SessionIndex

Read only access to the SessionIndex.

pub fn invalid_vote(&self) -> &InvalidDisputeVote

Read only access to the invalid vote.

pub fn valid_vote(&self) -> &ValidDisputeVote

Read only access to the valid vote.

Trait Implementations

impl Clone for DisputeMessage

fn clone(&self) -> DisputeMessage

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DisputeMessage

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

Formats the value using the given formatter.

impl From<DisputeMessage> for UncheckedDisputeMessage

fn from(message: DisputeMessage) -> Self

Converts to this type from the input type.