/root/bitcoin/src/versionbits.cpp
Line | Count | Source (jump to first uncovered line) |
1 | | // Copyright (c) 2016-2022 The Bitcoin Core 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 | | #include <consensus/params.h> |
6 | | #include <util/check.h> |
7 | | #include <versionbits.h> |
8 | | |
9 | | ThresholdState AbstractThresholdConditionChecker::GetStateFor(const CBlockIndex* pindexPrev, const Consensus::Params& params, ThresholdConditionCache& cache) const |
10 | 0 | { |
11 | 0 | int nPeriod = Period(params); |
12 | 0 | int nThreshold = Threshold(params); |
13 | 0 | int min_activation_height = MinActivationHeight(params); |
14 | 0 | int64_t nTimeStart = BeginTime(params); |
15 | 0 | int64_t nTimeTimeout = EndTime(params); |
16 | | |
17 | | // Check if this deployment is always active. |
18 | 0 | if (nTimeStart == Consensus::BIP9Deployment::ALWAYS_ACTIVE) { |
19 | 0 | return ThresholdState::ACTIVE; |
20 | 0 | } |
21 | | |
22 | | // Check if this deployment is never active. |
23 | 0 | if (nTimeStart == Consensus::BIP9Deployment::NEVER_ACTIVE) { |
24 | 0 | return ThresholdState::FAILED; |
25 | 0 | } |
26 | | |
27 | | // A block's state is always the same as that of the first of its period, so it is computed based on a pindexPrev whose height equals a multiple of nPeriod - 1. |
28 | 0 | if (pindexPrev != nullptr) { |
29 | 0 | pindexPrev = pindexPrev->GetAncestor(pindexPrev->nHeight - ((pindexPrev->nHeight + 1) % nPeriod)); |
30 | 0 | } |
31 | | |
32 | | // Walk backwards in steps of nPeriod to find a pindexPrev whose information is known |
33 | 0 | std::vector<const CBlockIndex*> vToCompute; |
34 | 0 | while (cache.count(pindexPrev) == 0) { |
35 | 0 | if (pindexPrev == nullptr) { |
36 | | // The genesis block is by definition defined. |
37 | 0 | cache[pindexPrev] = ThresholdState::DEFINED; |
38 | 0 | break; |
39 | 0 | } |
40 | 0 | if (pindexPrev->GetMedianTimePast() < nTimeStart) { |
41 | | // Optimization: don't recompute down further, as we know every earlier block will be before the start time |
42 | 0 | cache[pindexPrev] = ThresholdState::DEFINED; |
43 | 0 | break; |
44 | 0 | } |
45 | 0 | vToCompute.push_back(pindexPrev); |
46 | 0 | pindexPrev = pindexPrev->GetAncestor(pindexPrev->nHeight - nPeriod); |
47 | 0 | } |
48 | | |
49 | | // At this point, cache[pindexPrev] is known |
50 | 0 | assert(cache.count(pindexPrev)); |
51 | 0 | ThresholdState state = cache[pindexPrev]; |
52 | | |
53 | | // Now walk forward and compute the state of descendants of pindexPrev |
54 | 0 | while (!vToCompute.empty()) { |
55 | 0 | ThresholdState stateNext = state; |
56 | 0 | pindexPrev = vToCompute.back(); |
57 | 0 | vToCompute.pop_back(); |
58 | |
|
59 | 0 | switch (state) { |
60 | 0 | case ThresholdState::DEFINED: { |
61 | 0 | if (pindexPrev->GetMedianTimePast() >= nTimeStart) { |
62 | 0 | stateNext = ThresholdState::STARTED; |
63 | 0 | } |
64 | 0 | break; |
65 | 0 | } |
66 | 0 | case ThresholdState::STARTED: { |
67 | | // We need to count |
68 | 0 | const CBlockIndex* pindexCount = pindexPrev; |
69 | 0 | int count = 0; |
70 | 0 | for (int i = 0; i < nPeriod; i++) { |
71 | 0 | if (Condition(pindexCount, params)) { |
72 | 0 | count++; |
73 | 0 | } |
74 | 0 | pindexCount = pindexCount->pprev; |
75 | 0 | } |
76 | 0 | if (count >= nThreshold) { |
77 | 0 | stateNext = ThresholdState::LOCKED_IN; |
78 | 0 | } else if (pindexPrev->GetMedianTimePast() >= nTimeTimeout) { |
79 | 0 | stateNext = ThresholdState::FAILED; |
80 | 0 | } |
81 | 0 | break; |
82 | 0 | } |
83 | 0 | case ThresholdState::LOCKED_IN: { |
84 | | // Progresses into ACTIVE provided activation height will have been reached. |
85 | 0 | if (pindexPrev->nHeight + 1 >= min_activation_height) { |
86 | 0 | stateNext = ThresholdState::ACTIVE; |
87 | 0 | } |
88 | 0 | break; |
89 | 0 | } |
90 | 0 | case ThresholdState::FAILED: |
91 | 0 | case ThresholdState::ACTIVE: { |
92 | | // Nothing happens, these are terminal states. |
93 | 0 | break; |
94 | 0 | } |
95 | 0 | } |
96 | 0 | cache[pindexPrev] = state = stateNext; |
97 | 0 | } |
98 | | |
99 | 0 | return state; |
100 | 0 | } |
101 | | |
102 | | BIP9Stats AbstractThresholdConditionChecker::GetStateStatisticsFor(const CBlockIndex* pindex, const Consensus::Params& params, std::vector<bool>* signalling_blocks) const |
103 | 0 | { |
104 | 0 | BIP9Stats stats = {}; |
105 | |
|
106 | 0 | stats.period = Period(params); |
107 | 0 | stats.threshold = Threshold(params); |
108 | |
|
109 | 0 | if (pindex == nullptr) return stats; |
110 | | |
111 | | // Find how many blocks are in the current period |
112 | 0 | int blocks_in_period = 1 + (pindex->nHeight % stats.period); |
113 | | |
114 | | // Reset signalling_blocks |
115 | 0 | if (signalling_blocks) { |
116 | 0 | signalling_blocks->assign(blocks_in_period, false); |
117 | 0 | } |
118 | | |
119 | | // Count from current block to beginning of period |
120 | 0 | int elapsed = 0; |
121 | 0 | int count = 0; |
122 | 0 | const CBlockIndex* currentIndex = pindex; |
123 | 0 | do { |
124 | 0 | ++elapsed; |
125 | 0 | --blocks_in_period; |
126 | 0 | if (Condition(currentIndex, params)) { |
127 | 0 | ++count; |
128 | 0 | if (signalling_blocks) signalling_blocks->at(blocks_in_period) = true; |
129 | 0 | } |
130 | 0 | currentIndex = currentIndex->pprev; |
131 | 0 | } while(blocks_in_period > 0); |
132 | |
|
133 | 0 | stats.elapsed = elapsed; |
134 | 0 | stats.count = count; |
135 | 0 | stats.possible = (stats.period - stats.threshold ) >= (stats.elapsed - count); |
136 | |
|
137 | 0 | return stats; |
138 | 0 | } |
139 | | |
140 | | int AbstractThresholdConditionChecker::GetStateSinceHeightFor(const CBlockIndex* pindexPrev, const Consensus::Params& params, ThresholdConditionCache& cache) const |
141 | 0 | { |
142 | 0 | int64_t start_time = BeginTime(params); |
143 | 0 | if (start_time == Consensus::BIP9Deployment::ALWAYS_ACTIVE || start_time == Consensus::BIP9Deployment::NEVER_ACTIVE) { |
144 | 0 | return 0; |
145 | 0 | } |
146 | | |
147 | 0 | const ThresholdState initialState = GetStateFor(pindexPrev, params, cache); |
148 | | |
149 | | // BIP 9 about state DEFINED: "The genesis block is by definition in this state for each deployment." |
150 | 0 | if (initialState == ThresholdState::DEFINED) { |
151 | 0 | return 0; |
152 | 0 | } |
153 | | |
154 | 0 | const int nPeriod = Period(params); |
155 | | |
156 | | // A block's state is always the same as that of the first of its period, so it is computed based on a pindexPrev whose height equals a multiple of nPeriod - 1. |
157 | | // To ease understanding of the following height calculation, it helps to remember that |
158 | | // right now pindexPrev points to the block prior to the block that we are computing for, thus: |
159 | | // if we are computing for the last block of a period, then pindexPrev points to the second to last block of the period, and |
160 | | // if we are computing for the first block of a period, then pindexPrev points to the last block of the previous period. |
161 | | // The parent of the genesis block is represented by nullptr. |
162 | 0 | pindexPrev = Assert(pindexPrev->GetAncestor(pindexPrev->nHeight - ((pindexPrev->nHeight + 1) % nPeriod))); |
163 | |
|
164 | 0 | const CBlockIndex* previousPeriodParent = pindexPrev->GetAncestor(pindexPrev->nHeight - nPeriod); |
165 | |
|
166 | 0 | while (previousPeriodParent != nullptr && GetStateFor(previousPeriodParent, params, cache) == initialState) { |
167 | 0 | pindexPrev = previousPeriodParent; |
168 | 0 | previousPeriodParent = pindexPrev->GetAncestor(pindexPrev->nHeight - nPeriod); |
169 | 0 | } |
170 | | |
171 | | // Adjust the result because right now we point to the parent block. |
172 | 0 | return pindexPrev->nHeight + 1; |
173 | 0 | } |
174 | | |
175 | | namespace |
176 | | { |
177 | | /** |
178 | | * Class to implement versionbits logic. |
179 | | */ |
180 | | class VersionBitsConditionChecker : public AbstractThresholdConditionChecker { |
181 | | private: |
182 | | const Consensus::DeploymentPos id; |
183 | | |
184 | | protected: |
185 | 0 | int64_t BeginTime(const Consensus::Params& params) const override { return params.vDeployments[id].nStartTime; } |
186 | 0 | int64_t EndTime(const Consensus::Params& params) const override { return params.vDeployments[id].nTimeout; } |
187 | 0 | int MinActivationHeight(const Consensus::Params& params) const override { return params.vDeployments[id].min_activation_height; } |
188 | 0 | int Period(const Consensus::Params& params) const override { return params.nMinerConfirmationWindow; } |
189 | 0 | int Threshold(const Consensus::Params& params) const override { return params.nRuleChangeActivationThreshold; } |
190 | | |
191 | | bool Condition(const CBlockIndex* pindex, const Consensus::Params& params) const override |
192 | 0 | { |
193 | 0 | return (((pindex->nVersion & VERSIONBITS_TOP_MASK) == VERSIONBITS_TOP_BITS) && (pindex->nVersion & Mask(params)) != 0); |
194 | 0 | } |
195 | | |
196 | | public: |
197 | 0 | explicit VersionBitsConditionChecker(Consensus::DeploymentPos id_) : id(id_) {} |
198 | 0 | uint32_t Mask(const Consensus::Params& params) const { return (uint32_t{1}) << params.vDeployments[id].bit; } |
199 | | }; |
200 | | |
201 | | } // namespace |
202 | | |
203 | | ThresholdState VersionBitsCache::State(const CBlockIndex* pindexPrev, const Consensus::Params& params, Consensus::DeploymentPos pos) |
204 | 0 | { |
205 | 0 | LOCK(m_mutex); |
206 | 0 | return VersionBitsConditionChecker(pos).GetStateFor(pindexPrev, params, m_caches[pos]); |
207 | 0 | } |
208 | | |
209 | | BIP9Stats VersionBitsCache::Statistics(const CBlockIndex* pindex, const Consensus::Params& params, Consensus::DeploymentPos pos, std::vector<bool>* signalling_blocks) |
210 | 0 | { |
211 | 0 | return VersionBitsConditionChecker(pos).GetStateStatisticsFor(pindex, params, signalling_blocks); |
212 | 0 | } |
213 | | |
214 | | int VersionBitsCache::StateSinceHeight(const CBlockIndex* pindexPrev, const Consensus::Params& params, Consensus::DeploymentPos pos) |
215 | 0 | { |
216 | 0 | LOCK(m_mutex); |
217 | 0 | return VersionBitsConditionChecker(pos).GetStateSinceHeightFor(pindexPrev, params, m_caches[pos]); |
218 | 0 | } |
219 | | |
220 | | uint32_t VersionBitsCache::Mask(const Consensus::Params& params, Consensus::DeploymentPos pos) |
221 | 0 | { |
222 | 0 | return VersionBitsConditionChecker(pos).Mask(params); |
223 | 0 | } |
224 | | |
225 | | int32_t VersionBitsCache::ComputeBlockVersion(const CBlockIndex* pindexPrev, const Consensus::Params& params) |
226 | 0 | { |
227 | 0 | LOCK(m_mutex); |
228 | 0 | int32_t nVersion = VERSIONBITS_TOP_BITS; |
229 | |
|
230 | 0 | for (int i = 0; i < (int)Consensus::MAX_VERSION_BITS_DEPLOYMENTS; i++) { |
231 | 0 | Consensus::DeploymentPos pos = static_cast<Consensus::DeploymentPos>(i); |
232 | 0 | ThresholdState state = VersionBitsConditionChecker(pos).GetStateFor(pindexPrev, params, m_caches[pos]); |
233 | 0 | if (state == ThresholdState::LOCKED_IN || state == ThresholdState::STARTED) { |
234 | 0 | nVersion |= Mask(params, pos); |
235 | 0 | } |
236 | 0 | } |
237 | |
|
238 | 0 | return nVersion; |
239 | 0 | } |
240 | | |
241 | | void VersionBitsCache::Clear() |
242 | 0 | { |
243 | 0 | LOCK(m_mutex); |
244 | 0 | for (unsigned int d = 0; d < Consensus::MAX_VERSION_BITS_DEPLOYMENTS; d++) { |
245 | 0 | m_caches[d].clear(); |
246 | 0 | } |
247 | 0 | } |