Bitcoin Core 31.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-present 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
10#include <uint256.h>
11
12#include <array>
13#include <chrono>
14#include <limits>
15#include <map>
16#include <vector>
17
18namespace Consensus {
19
25enum BuriedDeployment : int16_t {
26 // buried deployments get negative values to avoid overlap with DeploymentPos
27 DEPLOYMENT_HEIGHTINCB = std::numeric_limits<int16_t>::min(),
31 // SCRIPT_VERIFY_WITNESS is enforced from genesis, but the check for downloading
32 // missing witness data is not. BIP 147 also relies on hardcoded activation height.
34};
35constexpr bool ValidDeployment(BuriedDeployment dep) { return dep <= DEPLOYMENT_SEGWIT; }
36
37enum DeploymentPos : uint16_t {
39 // NOTE: Also add new deployments to VersionBitsDeploymentInfo in deploymentinfo.cpp
40 // Removing an entry may require bumping MinBIP9WarningHeight.
42};
43constexpr bool ValidDeployment(DeploymentPos dep) { return dep < MAX_VERSION_BITS_DEPLOYMENTS; }
44
50 int bit{28};
61 uint32_t period{2016};
67 uint32_t threshold{1916};
68
70 static constexpr int64_t NO_TIMEOUT = std::numeric_limits<int64_t>::max();
71
76 static constexpr int64_t ALWAYS_ACTIVE = -1;
77
81 static constexpr int64_t NEVER_ACTIVE = -2;
82};
83
87struct Params {
96 std::map<uint256, script_verify_flags> script_flag_exceptions;
113 std::array<BIP9Deployment,MAX_VERSION_BITS_DEPLOYMENTS> vDeployments;
125 std::chrono::seconds PowTargetSpacing() const
126 {
127 return std::chrono::seconds{nPowTargetSpacing};
128 }
134
139 bool signet_blocks{false};
140 std::vector<uint8_t> signet_challenge;
141
143 {
144 switch (dep) {
146 return BIP34Height;
147 case DEPLOYMENT_CLTV:
148 return BIP65Height;
150 return BIP66Height;
151 case DEPLOYMENT_CSV:
152 return CSVHeight;
154 return SegwitHeight;
155 } // no default case, so the compiler can warn about missing cases
156 return std::numeric_limits<int>::max();
157 }
158};
159
160} // namespace Consensus
161
162#endif // BITCOIN_CONSENSUS_PARAMS_H
256-bit opaque blob.
Definition: uint256.h:196
Transaction validation functions.
constexpr bool ValidDeployment(BuriedDeployment dep)
Definition: params.h:35
DeploymentPos
Definition: params.h:37
@ DEPLOYMENT_TESTDUMMY
Definition: params.h:38
@ MAX_VERSION_BITS_DEPLOYMENTS
Definition: params.h:41
BuriedDeployment
A buried deployment is one where the height of the activation has been hardcoded into the client impl...
Definition: params.h:25
@ DEPLOYMENT_DERSIG
Definition: params.h:29
@ DEPLOYMENT_CSV
Definition: params.h:30
@ DEPLOYMENT_SEGWIT
Definition: params.h:33
@ DEPLOYMENT_HEIGHTINCB
Definition: params.h:27
@ DEPLOYMENT_CLTV
Definition: params.h:28
Struct for each individual consensus rule change using BIP9.
Definition: params.h:48
int min_activation_height
If lock in occurs, delay activation until at least this block height.
Definition: params.h:59
int bit
Bit position to select the particular bit in nVersion.
Definition: params.h:50
static constexpr int64_t ALWAYS_ACTIVE
Special value for nStartTime indicating that the deployment is always active.
Definition: params.h:76
static constexpr int64_t NEVER_ACTIVE
Special value for nStartTime indicating that the deployment is never active.
Definition: params.h:81
uint32_t period
Period of blocks to check signalling in (usually retarget period, ie params.DifficultyAdjustmentInter...
Definition: params.h:61
uint32_t threshold
Minimum blocks including miner confirmation of the total of 2016 blocks in a retargeting period,...
Definition: params.h:67
int64_t nTimeout
Timeout/expiry MedianTime for the deployment attempt.
Definition: params.h:54
static constexpr int64_t NO_TIMEOUT
Constant for nTimeout very far in the future.
Definition: params.h:70
int64_t nStartTime
Start MedianTime for version bits miner confirmation.
Definition: params.h:52
Parameters that influence chain consensus.
Definition: params.h:87
bool enforce_BIP94
Enforce BIP94 timewarp attack mitigation.
Definition: params.h:121
int BIP65Height
Block height at which BIP65 becomes active.
Definition: params.h:101
int CSVHeight
Block height at which CSV (BIP68, BIP112 and BIP113) becomes active.
Definition: params.h:105
uint256 BIP34Hash
Definition: params.h:99
uint256 defaultAssumeValid
By default assume that the signatures in ancestors of this block are valid.
Definition: params.h:133
std::vector< uint8_t > signet_challenge
Definition: params.h:140
int64_t DifficultyAdjustmentInterval() const
Definition: params.h:129
bool signet_blocks
If true, witness commitments contain a payload equal to a Bitcoin Script solution to the signet chall...
Definition: params.h:139
int SegwitHeight
Block height at which Segwit (BIP141, BIP143 and BIP147) becomes active.
Definition: params.h:109
int BIP34Height
Block height and hash at which BIP34 becomes active.
Definition: params.h:98
int nSubsidyHalvingInterval
Definition: params.h:89
std::map< uint256, script_verify_flags > script_flag_exceptions
Hashes of blocks that.
Definition: params.h:96
uint256 hashGenesisBlock
Definition: params.h:88
int MinBIP9WarningHeight
Don't warn about unknown BIP 9 activations below this height.
Definition: params.h:112
bool fPowNoRetargeting
Definition: params.h:122
uint256 nMinimumChainWork
The best chain should have at least this much work.
Definition: params.h:131
int64_t nPowTargetTimespan
Definition: params.h:124
int BIP66Height
Block height at which BIP66 becomes active.
Definition: params.h:103
uint256 powLimit
Proof of work parameters.
Definition: params.h:115
int DeploymentHeight(BuriedDeployment dep) const
Definition: params.h:142
std::array< BIP9Deployment, MAX_VERSION_BITS_DEPLOYMENTS > vDeployments
Definition: params.h:113
int64_t nPowTargetSpacing
Definition: params.h:123
std::chrono::seconds PowTargetSpacing() const
Definition: params.h:125
bool fPowAllowMinDifficultyBlocks
Definition: params.h:116