Bitcoin Core 29.99.0
P2P Digital Currency
chainparams.h
Go to the documentation of this file.
1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-2021 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_KERNEL_CHAINPARAMS_H
7#define BITCOIN_KERNEL_CHAINPARAMS_H
8
9#include <consensus/params.h>
11#include <primitives/block.h>
12#include <uint256.h>
13#include <util/chaintype.h>
14#include <util/hash_type.h>
15#include <util/vector.h>
16
17#include <cstdint>
18#include <iterator>
19#include <memory>
20#include <optional>
21#include <string>
22#include <unordered_map>
23#include <utility>
24#include <vector>
25
26struct AssumeutxoHash : public BaseHash<uint256> {
27 explicit AssumeutxoHash(const uint256& hash) : BaseHash(hash) {}
28};
29
36 int height;
37
40
46
50};
51
59 int64_t nTime;
60 uint64_t tx_count;
61 double dTxRate;
62};
63
69{
70public:
77
79 };
80
81 const Consensus::Params& GetConsensus() const { return consensus; }
83 uint16_t GetDefaultPort() const { return nDefaultPort; }
84 std::vector<int> GetAvailableSnapshotHeights() const;
85
86 const CBlock& GenesisBlock() const { return genesis; }
90 bool IsTestChain() const { return m_chain_type != ChainType::MAIN; }
92 bool IsMockableChain() const { return m_is_mockable_chain; }
93 uint64_t PruneAfterHeight() const { return nPruneAfterHeight; }
101 std::string GetChainTypeString() const { return ChainTypeToString(m_chain_type); }
105 const std::vector<std::string>& DNSSeeds() const { return vSeeds; }
106 const std::vector<unsigned char>& Base58Prefix(Base58Type type) const { return base58Prefixes[type]; }
107 const std::string& Bech32HRP() const { return bech32_hrp; }
108 const std::vector<uint8_t>& FixedSeeds() const { return vFixedSeeds; }
109
110 std::optional<AssumeutxoData> AssumeutxoForHeight(int height) const
111 {
112 return FindFirst(m_assumeutxo_data, [&](const auto& d) { return d.height == height; });
113 }
114 std::optional<AssumeutxoData> AssumeutxoForBlockhash(const uint256& blockhash) const
115 {
116 return FindFirst(m_assumeutxo_data, [&](const auto& d) { return d.blockhash == blockhash; });
117 }
118
119 const ChainTxData& TxData() const { return chainTxData; }
120
125 std::optional<std::vector<uint8_t>> challenge{};
126 std::optional<std::vector<std::string>> seeds{};
127 };
128
133 int64_t start_time;
134 int64_t timeout;
136 };
137
142 std::unordered_map<Consensus::DeploymentPos, VersionBitsParameters> version_bits_parameters{};
143 std::unordered_map<Consensus::BuriedDeployment, int> activation_heights{};
144 bool fastprune{false};
145 bool enforce_bip94{false};
146 };
147
148 static std::unique_ptr<const CChainParams> RegTest(const RegTestOptions& options);
149 static std::unique_ptr<const CChainParams> SigNet(const SigNetOptions& options);
150 static std::unique_ptr<const CChainParams> Main();
151 static std::unique_ptr<const CChainParams> TestNet();
152 static std::unique_ptr<const CChainParams> TestNet4();
153
154protected:
155 CChainParams() = default;
156
159 uint16_t nDefaultPort;
163 std::vector<std::string> vSeeds;
164 std::vector<unsigned char> base58Prefixes[MAX_BASE58_TYPES];
165 std::string bech32_hrp;
168 std::vector<uint8_t> vFixedSeeds;
171 std::vector<AssumeutxoData> m_assumeutxo_data;
173};
174
175std::optional<ChainType> GetNetworkForMagic(const MessageStartChars& pchMessageStart);
176
177#endif // BITCOIN_KERNEL_CHAINPARAMS_H
std::string ChainTypeToString(ChainType chain)
Definition: chaintype.cpp:11
ChainType
Definition: chaintype.h:11
Definition: block.h:69
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:69
std::string GetChainTypeString() const
Return the chain type string.
Definition: chainparams.h:101
const MessageStartChars & MessageStart() const
Definition: chainparams.h:82
uint64_t m_assumed_chain_state_size
Definition: chainparams.h:162
MessageStartChars pchMessageStart
Definition: chainparams.h:158
CChainParams()=default
static std::unique_ptr< const CChainParams > Main()
const CBlock & GenesisBlock() const
Definition: chainparams.h:86
std::string bech32_hrp
Definition: chainparams.h:165
bool DefaultConsistencyChecks() const
Default value for -checkmempool and -checkblockindex argument.
Definition: chainparams.h:88
std::vector< int > GetAvailableSnapshotHeights() const
static std::unique_ptr< const CChainParams > RegTest(const RegTestOptions &options)
CBlock genesis
Definition: chainparams.h:167
const std::vector< unsigned char > & Base58Prefix(Base58Type type) const
Definition: chainparams.h:106
uint64_t m_assumed_blockchain_size
Definition: chainparams.h:161
std::vector< uint8_t > vFixedSeeds
Definition: chainparams.h:168
bool IsMockableChain() const
If this chain allows time to be mocked.
Definition: chainparams.h:92
bool fDefaultConsistencyChecks
Definition: chainparams.h:169
const ChainTxData & TxData() const
Definition: chainparams.h:119
static std::unique_ptr< const CChainParams > TestNet()
const Consensus::Params & GetConsensus() const
Definition: chainparams.h:81
std::vector< unsigned char > base58Prefixes[MAX_BASE58_TYPES]
Definition: chainparams.h:164
bool IsTestChain() const
If this chain is exclusively used for testing.
Definition: chainparams.h:90
bool MineBlocksOnDemand() const
Whether it is possible to mine blocks on demand (no retargeting)
Definition: chainparams.h:99
Consensus::Params consensus
Definition: chainparams.h:157
uint16_t GetDefaultPort() const
Definition: chainparams.h:83
std::vector< AssumeutxoData > m_assumeutxo_data
Definition: chainparams.h:171
uint64_t AssumedBlockchainSize() const
Minimum free space (in GB) needed for data directory.
Definition: chainparams.h:95
const std::string & Bech32HRP() const
Definition: chainparams.h:107
std::vector< std::string > vSeeds
Definition: chainparams.h:163
bool m_is_mockable_chain
Definition: chainparams.h:170
static std::unique_ptr< const CChainParams > TestNet4()
std::optional< AssumeutxoData > AssumeutxoForBlockhash(const uint256 &blockhash) const
Definition: chainparams.h:114
ChainType m_chain_type
Definition: chainparams.h:166
uint64_t AssumedChainStateSize() const
Minimum free space (in GB) needed for data directory when pruned; Does not include prune target.
Definition: chainparams.h:97
uint64_t PruneAfterHeight() const
Definition: chainparams.h:93
uint16_t nDefaultPort
Definition: chainparams.h:159
std::optional< AssumeutxoData > AssumeutxoForHeight(int height) const
Definition: chainparams.h:110
ChainType GetChainType() const
Return the chain type.
Definition: chainparams.h:103
static std::unique_ptr< const CChainParams > SigNet(const SigNetOptions &options)
const std::vector< std::string > & DNSSeeds() const
Return the list of hostnames to look up for DNS seeds.
Definition: chainparams.h:105
uint64_t nPruneAfterHeight
Definition: chainparams.h:160
ChainTxData chainTxData
Definition: chainparams.h:172
const std::vector< uint8_t > & FixedSeeds() const
Definition: chainparams.h:108
256-bit opaque blob.
Definition: uint256.h:201
std::optional< ChainType > GetNetworkForMagic(const MessageStartChars &pchMessageStart)
std::array< uint8_t, 4 > MessageStartChars
Holds configuration for use during UTXO snapshot load and validation.
Definition: chainparams.h:35
AssumeutxoHash hash_serialized
The expected hash of the deserialized UTXO set.
Definition: chainparams.h:39
uint64_t m_chain_tx_count
Used to populate the m_chain_tx_count value, which is used during BlockManager::LoadBlockIndex().
Definition: chainparams.h:45
uint256 blockhash
The hash of the base block for this snapshot.
Definition: chainparams.h:49
AssumeutxoHash(const uint256 &hash)
Definition: chainparams.h:27
RegTestOptions holds configurations for creating a regtest CChainParams.
Definition: chainparams.h:141
std::unordered_map< Consensus::DeploymentPos, VersionBitsParameters > version_bits_parameters
Definition: chainparams.h:142
std::unordered_map< Consensus::BuriedDeployment, int > activation_heights
Definition: chainparams.h:143
SigNetOptions holds configurations for creating a signet CChainParams.
Definition: chainparams.h:124
std::optional< std::vector< uint8_t > > challenge
Definition: chainparams.h:125
std::optional< std::vector< std::string > > seeds
Definition: chainparams.h:126
VersionBitsParameters holds activation parameters.
Definition: chainparams.h:132
Holds various statistics on transactions within a chain.
Definition: chainparams.h:58
uint64_t tx_count
total number of transactions between genesis and that timestamp
Definition: chainparams.h:60
double dTxRate
estimated number of transactions per second after that timestamp
Definition: chainparams.h:61
int64_t nTime
UNIX timestamp of last known number of transactions.
Definition: chainparams.h:59
Parameters that influence chain consensus.
Definition: params.h:74
bool fPowNoRetargeting
Definition: params.h:116
std::optional< V > FindFirst(const std::vector< V > &vec, const L fnc)
Definition: vector.h:73