Bitcoin Core 29.99.0
P2P Digital Currency
params.h
Go to the documentation of this file.
1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-2022 The Bitcoin Core developers
3// Distributed under the MIT software license, see the accompanying
4// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6#ifndef BITCOIN_CONSENSUS_PARAMS_H
7#define BITCOIN_CONSENSUS_PARAMS_H
8
9#include <uint256.h>
10
11#include <array>
12#include <chrono>
13#include <limits>
14#include <map>
15#include <vector>
16
17namespace Consensus {
18
23enum BuriedDeployment : int16_t {
24 // buried deployments get negative values to avoid overlap with DeploymentPos
25 DEPLOYMENT_HEIGHTINCB = std::numeric_limits<int16_t>::min(),
30};
31constexpr bool ValidDeployment(BuriedDeployment dep) { return dep <= DEPLOYMENT_SEGWIT; }
32
33enum DeploymentPos : uint16_t {
35 DEPLOYMENT_TAPROOT, // Deployment of Schnorr/Taproot (BIPs 340-342)
36 // NOTE: Also add new deployments to VersionBitsDeploymentInfo in deploymentinfo.cpp
38};
39constexpr bool ValidDeployment(DeploymentPos dep) { return dep < MAX_VERSION_BITS_DEPLOYMENTS; }
40
46 int bit{28};
57 uint32_t period{2016};
63 uint32_t threshold{1916};
64
66 static constexpr int64_t NO_TIMEOUT = std::numeric_limits<int64_t>::max();
67
72 static constexpr int64_t ALWAYS_ACTIVE = -1;
73
77 static constexpr int64_t NEVER_ACTIVE = -2;
78};
79
83struct Params {
92 std::map<uint256, uint32_t> script_flag_exceptions;
109 std::array<BIP9Deployment,MAX_VERSION_BITS_DEPLOYMENTS> vDeployments;
121 std::chrono::seconds PowTargetSpacing() const
122 {
123 return std::chrono::seconds{nPowTargetSpacing};
124 }
130
135 bool signet_blocks{false};
136 std::vector<uint8_t> signet_challenge;
137
139 {
140 switch (dep) {
142 return BIP34Height;
143 case DEPLOYMENT_CLTV:
144 return BIP65Height;
146 return BIP66Height;
147 case DEPLOYMENT_CSV:
148 return CSVHeight;
150 return SegwitHeight;
151 } // no default case, so the compiler can warn about missing cases
152 return std::numeric_limits<int>::max();
153 }
154};
155
156} // namespace Consensus
157
158#endif // BITCOIN_CONSENSUS_PARAMS_H
256-bit opaque blob.
Definition: uint256.h:196
Transaction validation functions.
constexpr bool ValidDeployment(BuriedDeployment dep)
Definition: params.h:31
DeploymentPos
Definition: params.h:33
@ DEPLOYMENT_TAPROOT
Definition: params.h:35
@ DEPLOYMENT_TESTDUMMY
Definition: params.h:34
@ MAX_VERSION_BITS_DEPLOYMENTS
Definition: params.h:37
BuriedDeployment
A buried deployment is one where the height of the activation has been hardcoded into the client impl...
Definition: params.h:23
@ DEPLOYMENT_DERSIG
Definition: params.h:27
@ DEPLOYMENT_CSV
Definition: params.h:28
@ DEPLOYMENT_SEGWIT
Definition: params.h:29
@ DEPLOYMENT_HEIGHTINCB
Definition: params.h:25
@ DEPLOYMENT_CLTV
Definition: params.h:26
Struct for each individual consensus rule change using BIP9.
Definition: params.h:44
int min_activation_height
If lock in occurs, delay activation until at least this block height.
Definition: params.h:55
int bit
Bit position to select the particular bit in nVersion.
Definition: params.h:46
static constexpr int64_t ALWAYS_ACTIVE
Special value for nStartTime indicating that the deployment is always active.
Definition: params.h:72
static constexpr int64_t NEVER_ACTIVE
Special value for nStartTime indicating that the deployment is never active.
Definition: params.h:77
uint32_t period
Period of blocks to check signalling in (usually retarget period, ie params.DifficultyAdjustmentInter...
Definition: params.h:57
uint32_t threshold
Minimum blocks including miner confirmation of the total of 2016 blocks in a retargeting period,...
Definition: params.h:63
int64_t nTimeout
Timeout/expiry MedianTime for the deployment attempt.
Definition: params.h:50
static constexpr int64_t NO_TIMEOUT
Constant for nTimeout very far in the future.
Definition: params.h:66
int64_t nStartTime
Start MedianTime for version bits miner confirmation.
Definition: params.h:48
Parameters that influence chain consensus.
Definition: params.h:83
bool enforce_BIP94
Enforce BIP94 timewarp attack mitigation.
Definition: params.h:117
int BIP65Height
Block height at which BIP65 becomes active.
Definition: params.h:97
int CSVHeight
Block height at which CSV (BIP68, BIP112 and BIP113) becomes active.
Definition: params.h:101
uint256 BIP34Hash
Definition: params.h:95
uint256 defaultAssumeValid
By default assume that the signatures in ancestors of this block are valid.
Definition: params.h:129
std::map< uint256, uint32_t > script_flag_exceptions
Hashes of blocks that.
Definition: params.h:92
std::vector< uint8_t > signet_challenge
Definition: params.h:136
int64_t DifficultyAdjustmentInterval() const
Definition: params.h:125
bool signet_blocks
If true, witness commitments contain a payload equal to a Bitcoin Script solution to the signet chall...
Definition: params.h:135
int SegwitHeight
Block height at which Segwit (BIP141, BIP143 and BIP147) becomes active.
Definition: params.h:105
int BIP34Height
Block height and hash at which BIP34 becomes active.
Definition: params.h:94
int nSubsidyHalvingInterval
Definition: params.h:85
uint256 hashGenesisBlock
Definition: params.h:84
int MinBIP9WarningHeight
Don't warn about unknown BIP 9 activations below this height.
Definition: params.h:108
bool fPowNoRetargeting
Definition: params.h:118
uint256 nMinimumChainWork
The best chain should have at least this much work.
Definition: params.h:127
int64_t nPowTargetTimespan
Definition: params.h:120
int BIP66Height
Block height at which BIP66 becomes active.
Definition: params.h:99
uint256 powLimit
Proof of work parameters.
Definition: params.h:111
int DeploymentHeight(BuriedDeployment dep) const
Definition: params.h:138
std::array< BIP9Deployment, MAX_VERSION_BITS_DEPLOYMENTS > vDeployments
Definition: params.h:109
int64_t nPowTargetSpacing
Definition: params.h:119
std::chrono::seconds PowTargetSpacing() const
Definition: params.h:121
bool fPowAllowMinDifficultyBlocks
Definition: params.h:112