Bitcoin ABC 0.26.3
P2P Digital Currency
Loading...
Searching...
No Matches
stakecontendercache.h
Go to the documentation of this file.
1// Copyright (c) 2024 The Bitcoin developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#ifndef BITCOIN_AVALANCHE_STAKECONTENDERCACHE_H
6#define BITCOIN_AVALANCHE_STAKECONTENDERCACHE_H
7
8#include <avalanche/proof.h>
11#include <script/script.h>
12#include <util/hasher.h>
13
14#include <boost/multi_index/hashed_index.hpp>
15#include <boost/multi_index/member.hpp>
16#include <boost/multi_index/ordered_index.hpp>
17#include <boost/multi_index_container.hpp>
18
19#include <vector>
20
21namespace avalanche {
22
23class PeerManager;
24
27 // Set according to avalanche acceptance
28 ACCEPTED = (1 << 0),
29 // If set, this contender should be in the stake winner set
30 IN_WINNER_SET = (1 << 1),
31};
32
62
73
80
82struct by_prevblockhash;
83struct by_blockheight;
84
85namespace bmi = boost::multi_index;
86
92
93 using ContenderSet = boost::multi_index_container<
95 bmi::indexed_by<
96 // index by stake contender id
97 bmi::hashed_unique<bmi::tag<by_stakecontenderid>,
99 // index by prevblockhash
100 bmi::hashed_non_unique<
101 bmi::tag<by_prevblockhash>,
105 // index by block height
106 bmi::ordered_non_unique<
107 bmi::tag<by_blockheight>,
108 bmi::member<StakeContenderCacheEntry, int,
110
112
113 using ManualWinnersSet = boost::multi_index_container<
115 bmi::indexed_by<
116 // index by prevblockhash
117 bmi::hashed_unique<bmi::tag<by_prevblockhash>,
118 bmi::member<ManualWinners, BlockHash,
121 // index by block height
122 bmi::ordered_unique<
123 bmi::tag<by_blockheight>,
124 bmi::member<ManualWinners, int, &ManualWinners::blockheight>>>>;
125
127
128public:
130
131 void cleanup(const int requestedMinHeight);
132
136 bool isEmpty() const {
137 return (contenders.size() + manualWinners.size()) == 0;
138 }
139
143 bool add(const CBlockIndex *pindex, const ProofRef &proof,
145
150
155 bool setWinners(const CBlockIndex *pindex,
156 const std::vector<CScript> &payoutScripts);
157
165
173
177 bool getWinners(const BlockHash &prevblockhash,
178 std::vector<CScript> &payouts) const;
179};
180
181} // namespace avalanche
182
183#endif // BITCOIN_AVALANCHE_STAKECONTENDERCACHE_H
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition blockindex.h:25
Serialized script, used inside transaction inputs and outputs.
Definition script.h:424
Cache to track stake contenders for recent blocks.
bool invalidate(const StakeContenderId &contenderId)
bool accept(const StakeContenderId &contenderId)
Helpers to set avalanche state of a contender.
void cleanup(const int requestedMinHeight)
bool reject(const StakeContenderId &contenderId)
bool setWinners(const CBlockIndex *pindex, const std::vector< CScript > &payoutScripts)
Set proof(s) that should be treated as winners (already finalized).
bool add(const CBlockIndex *pindex, const ProofRef &proof, uint8_t status=StakeContenderStatus::UNKNOWN)
Add a proof to consider in staking rewards pre-consensus.
boost::multi_index_container< StakeContenderCacheEntry, bmi::indexed_by< bmi::hashed_unique< bmi::tag< by_stakecontenderid >, stakecontenderid_index, SaltedUint256Hasher >, bmi::hashed_non_unique< bmi::tag< by_prevblockhash >, bmi::member< StakeContenderCacheEntry, BlockHash, &StakeContenderCacheEntry::prevblockhash >, SaltedUint256Hasher >, bmi::ordered_non_unique< bmi::tag< by_blockheight >, bmi::member< StakeContenderCacheEntry, int, &StakeContenderCacheEntry::blockheight > > > > ContenderSet
int getVoteStatus(const StakeContenderId &contenderId, BlockHash &prevblockhashout) const
Get contender acceptance state for avalanche voting.
boost::multi_index_container< ManualWinners, bmi::indexed_by< bmi::hashed_unique< bmi::tag< by_prevblockhash >, bmi::member< ManualWinners, BlockHash, &ManualWinners::prevblockhash >, SaltedUint256Hasher >, bmi::ordered_unique< bmi::tag< by_blockheight >, bmi::member< ManualWinners, int, &ManualWinners::blockheight > > > > ManualWinnersSet
bool finalize(const StakeContenderId &contenderId)
bool getWinners(const BlockHash &prevblockhash, std::vector< CScript > &payouts) const
Get payout scripts of the winning proofs.
void promoteToBlock(const CBlockIndex *activeTip, PeerManager &pm)
Promote cache entries to a the active chain tip.
T GetRand(T nMax=std::numeric_limits< T >::max()) noexcept
Generate a uniform random integer of type T in the range [0..nMax) nMax defaults to std::numeric_limi...
Definition random.h:85
A BlockHash is a unqiue identifier for a block.
Definition blockhash.h:13
ManualWinners(const BlockHash &_prevblockhash, int _blockheight, const std::vector< CScript > &_payoutScripts)
std::vector< CScript > payoutScripts
bool isAccepted() const
CScript payoutScriptPubkey
BlockHash prevblockhash
bool isInWinnerSet() const
uint32_t score
uint8_t status
ProofId proofid
int blockheight
double computeRewardRank() const
StakeContenderCacheEntry(const BlockHash &_prevblockhash, int _blockheight, const ProofId &_proofid, uint8_t _status, const CScript &_payoutScriptPubkey, uint32_t _score)
StakeContenderId getStakeContenderId() const
StakeContenderIds are unique for each block to ensure that the peer polling for their acceptance has ...
double ComputeProofRewardRank(uint32_t proofScore)
To make sure the selection is properly weighted according to the proof score, we normalize the conten...
result_type operator()(const StakeContenderCacheEntry &entry) const