Bitcoin ABC  0.24.7
P2P Digital Currency
Public Member Functions | Private Member Functions | Private Attributes | List of all members
avalanche::VoteRecord Struct Reference

Vote history. More...

#include <voterecord.h>

Public Member Functions

 VoteRecord (bool accepted)
 
 VoteRecord (const VoteRecord &other)
 Copy semantic. More...
 
bool isAccepted () const
 Vote accounting facilities. More...
 
uint16_t getConfidence () const
 
bool hasFinalized () const
 
bool registerVote (NodeId nodeid, uint32_t error)
 Register a new vote for an item and update confidence accordingly. More...
 
bool registerPoll () const
 Register that a request is being made regarding that item. More...
 
bool shouldPoll () const
 Return if this item is in condition to be polled at the moment. More...
 
void clearInflightRequest (uint8_t count=1)
 Clear count inflight requests. More...
 

Private Member Functions

bool addNodeToQuorum (NodeId nodeid)
 Add the node to the quorum. More...
 

Private Attributes

uint16_t confidence = 0
 
uint8_t votes = 0
 
uint8_t consider = 0
 
std::atomic< uint8_t > inflight {0}
 
const uint32_t seed = 0
 
uint32_t successfulVotes = 0
 
std::array< uint16_t, 8 > nodeFilter {{0, 0, 0, 0, 0, 0, 0, 0}}
 

Detailed Description

Vote history.

Definition at line 29 of file voterecord.h.

Constructor & Destructor Documentation

◆ VoteRecord() [1/2]

avalanche::VoteRecord::VoteRecord ( bool  accepted)
inlineexplicit

Definition at line 52 of file voterecord.h.

◆ VoteRecord() [2/2]

avalanche::VoteRecord::VoteRecord ( const VoteRecord other)
inline

Copy semantic.

Definition at line 57 of file voterecord.h.

Member Function Documentation

◆ addNodeToQuorum()

bool avalanche::VoteRecord::addNodeToQuorum ( NodeId  nodeid)
private

Add the node to the quorum.

Returns true if the node was added, false if the node already was in the quorum.

Check if the node is in the filter.

Add the node which just voted to the filter.

Definition at line 61 of file voterecord.cpp.

Here is the caller graph for this function:

◆ clearInflightRequest()

void avalanche::VoteRecord::clearInflightRequest ( uint8_t  count = 1)
inline

Clear count inflight requests.

Definition at line 94 of file voterecord.h.

Here is the caller graph for this function:

◆ getConfidence()

uint16_t avalanche::VoteRecord::getConfidence ( ) const
inline

Definition at line 68 of file voterecord.h.

Here is the caller graph for this function:

◆ hasFinalized()

bool avalanche::VoteRecord::hasFinalized ( ) const
inline

Definition at line 69 of file voterecord.h.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ isAccepted()

bool avalanche::VoteRecord::isAccepted ( ) const
inline

Vote accounting facilities.

Definition at line 66 of file voterecord.h.

Here is the caller graph for this function:

◆ registerPoll()

bool avalanche::VoteRecord::registerPoll ( ) const

Register that a request is being made regarding that item.

The method is made const so that it can be accessed via a read only view of blockVoteRecords. It's not a problem as it is made thread safe.

Definition at line 92 of file voterecord.cpp.

Here is the caller graph for this function:

◆ registerVote()

bool avalanche::VoteRecord::registerVote ( NodeId  nodeid,
uint32_t  error 
)

Register a new vote for an item and update confidence accordingly.

Returns true if the acceptance or finalization state changed.

The result of the vote is determined from the error code. If the error code is 0, there is no error and therefore the vote is yes. If there is an error, we check the most significant bit to decide if the vote is a no (for instance, the block is invalid) or is the vote inconclusive (for instance, the queried node does not have the block yet).

We compute the number of yes and/or no votes as follow:

votes: 1010 consider: 1100

yes votes: 1000 using votes & consider no votes: 0100 using ~votes & consider

Definition at line 13 of file voterecord.cpp.

Here is the call graph for this function:

◆ shouldPoll()

bool avalanche::VoteRecord::shouldPoll ( ) const
inline

Return if this item is in condition to be polled at the moment.

Definition at line 89 of file voterecord.h.

Here is the caller graph for this function:

Member Data Documentation

◆ confidence

uint16_t avalanche::VoteRecord::confidence = 0
private

Definition at line 33 of file voterecord.h.

◆ consider

uint8_t avalanche::VoteRecord::consider = 0
private

Definition at line 38 of file voterecord.h.

◆ inflight

std::atomic<uint8_t> avalanche::VoteRecord::inflight {0}
mutableprivate

Definition at line 40 of file voterecord.h.

◆ nodeFilter

std::array<uint16_t, 8> avalanche::VoteRecord::nodeFilter {{0, 0, 0, 0, 0, 0, 0, 0}}
private

Definition at line 49 of file voterecord.h.

◆ seed

const uint32_t avalanche::VoteRecord::seed = 0
private

Definition at line 43 of file voterecord.h.

◆ successfulVotes

uint32_t avalanche::VoteRecord::successfulVotes = 0
private

Definition at line 46 of file voterecord.h.

◆ votes

uint8_t avalanche::VoteRecord::votes = 0
private

Definition at line 36 of file voterecord.h.


The documentation for this struct was generated from the following files: