Bitcoin ABC 0.30.12
P2P Digital Currency
chainparams.h
Go to the documentation of this file.
1// Copyright (c) 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>
10#include <netaddress.h>
11#include <primitives/block.h>
12#include <protocol.h>
13#include <uint256.h>
14#include <util/hash_type.h>
15#include <util/vector.h>
16
17#include <cstdint>
18#include <iterator>
19#include <map>
20#include <memory>
21#include <optional>
22#include <string>
23#include <unordered_map>
24#include <utility>
25#include <vector>
26
27struct SeedSpec6 {
28 uint8_t addr[16];
29 uint16_t port;
30};
31
32typedef std::map<int, BlockHash> MapCheckpoints;
33
36};
37
38struct AssumeutxoHash : public BaseHash<uint256> {
39 explicit AssumeutxoHash(const uint256 &hash) : BaseHash(hash) {}
40};
41
48 int height;
49
52
59 unsigned int nChainTx;
60
64};
65
73 int64_t nTime;
74 int64_t nTxCount;
75 double dTxRate;
76};
77
86public:
93
95 };
96
97 const Consensus::Params &GetConsensus() const { return consensus; }
100 uint16_t GetDefaultPort() const { return nDefaultPort; }
101 uint16_t GetDefaultPort(Network net) const {
102 return net == NET_I2P ? I2P_SAM31_PORT : GetDefaultPort();
103 }
104 uint16_t GetDefaultPort(const std::string &addr) const {
105 CNetAddr a;
106 return a.SetSpecial(addr) ? GetDefaultPort(a.GetNetwork())
107 : GetDefaultPort();
108 }
109
110 const CBlock &GenesisBlock() const { return genesis; }
114 bool RequireStandard() const { return fRequireStandard; }
116 bool IsTestChain() const { return m_is_test_chain; }
118 bool IsMockableChain() const { return m_is_mockable_chain; }
119 uint64_t PruneAfterHeight() const { return nPruneAfterHeight; }
126 uint64_t AssumedChainStateSize() const {
128 }
132 std::string NetworkIDString() const { return strNetworkID; }
134 const std::vector<uint8_t> &Base58Prefix(Base58Type type) const {
135 return base58Prefixes[type];
136 }
137 const std::string &CashAddrPrefix() const { return cashaddrPrefix; }
138 const std::vector<SeedSpec6> &FixedSeeds() const { return vFixedSeeds; }
139 const CCheckpointData &Checkpoints() const { return checkpointData; }
140
141 std::optional<AssumeutxoData> AssumeutxoForHeight(int height) const {
143 [&](const auto &d) { return d.height == height; });
144 }
145 std::optional<AssumeutxoData>
146 AssumeutxoForBlockhash(const BlockHash &blockhash) const {
147 return FindFirst(m_assumeutxo_data, [&](const auto &d) {
148 return d.blockhash == blockhash;
149 });
150 }
151
152 const ChainTxData &TxData() const { return chainTxData; }
153
155 bool ecash{true};
156 bool fastprune{false};
157 };
158
159 static std::unique_ptr<const CChainParams>
160 RegTest(const ChainOptions &options);
161 static std::unique_ptr<const CChainParams>
162 Main(const ChainOptions &options);
163 static std::unique_ptr<const CChainParams>
164 TestNet(const ChainOptions &options);
165
166protected:
168
172 uint16_t nDefaultPort;
176 std::vector<std::string> vSeeds;
177 std::vector<uint8_t> base58Prefixes[MAX_BASE58_TYPES];
178 std::string cashaddrPrefix;
179 std::string strNetworkID;
181 std::vector<SeedSpec6> vFixedSeeds;
187 std::vector<AssumeutxoData> m_assumeutxo_data;
189
190 friend const std::vector<std::string>
191 GetRandomizedDNSSeeds(const CChainParams &params);
192};
193
194const CCheckpointData &CheckpointData(const std::string &chain);
195
196#endif // BITCOIN_KERNEL_CHAINPARAMS_H
Definition: block.h:60
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:85
uint64_t m_assumed_chain_state_size
Definition: chainparams.h:175
const CBlock & GenesisBlock() const
Definition: chainparams.h:110
bool DefaultConsistencyChecks() const
Default value for -checkmempool and -checkblockindex argument.
Definition: chainparams.h:112
const CMessageHeader::MessageMagic & NetMagic() const
Definition: chainparams.h:99
const CMessageHeader::MessageMagic & DiskMagic() const
Definition: chainparams.h:98
const std::vector< SeedSpec6 > & FixedSeeds() const
Definition: chainparams.h:138
bool m_is_test_chain
Definition: chainparams.h:184
std::string NetworkIDString() const
Return the BIP70 network string (main, test or regtest)
Definition: chainparams.h:132
CBlock genesis
Definition: chainparams.h:180
uint16_t GetDefaultPort(const std::string &addr) const
Definition: chainparams.h:104
bool RequireStandard() const
Policy: Filter transactions that do not match well-defined patterns.
Definition: chainparams.h:114
const std::vector< uint8_t > & Base58Prefix(Base58Type type) const
Return the list of hostnames to look up for DNS seeds.
Definition: chainparams.h:134
uint64_t m_assumed_blockchain_size
Definition: chainparams.h:174
bool IsMockableChain() const
If this chain allows time to be mocked.
Definition: chainparams.h:118
CMessageHeader::MessageMagic netMagic
Definition: chainparams.h:171
std::vector< uint8_t > base58Prefixes[MAX_BASE58_TYPES]
Definition: chainparams.h:177
bool fDefaultConsistencyChecks
Definition: chainparams.h:182
std::vector< SeedSpec6 > vFixedSeeds
Definition: chainparams.h:181
const ChainTxData & TxData() const
Definition: chainparams.h:152
std::optional< AssumeutxoData > AssumeutxoForBlockhash(const BlockHash &blockhash) const
Definition: chainparams.h:146
std::string strNetworkID
Definition: chainparams.h:179
friend const std::vector< std::string > GetRandomizedDNSSeeds(const CChainParams &params)
Return the list of hostnames to look up for DNS seeds.
Definition: dnsseeds.cpp:11
const Consensus::Params & GetConsensus() const
Definition: chainparams.h:97
bool IsTestChain() const
If this chain is exclusively used for testing.
Definition: chainparams.h:116
bool MineBlocksOnDemand() const
Whether it is possible to mine blocks on demand (no retargeting)
Definition: chainparams.h:130
Consensus::Params consensus
Definition: chainparams.h:169
static std::unique_ptr< const CChainParams > TestNet(const ChainOptions &options)
uint16_t GetDefaultPort() const
Definition: chainparams.h:100
static std::unique_ptr< const CChainParams > RegTest(const ChainOptions &options)
std::vector< AssumeutxoData > m_assumeutxo_data
Definition: chainparams.h:187
const std::string & CashAddrPrefix() const
Definition: chainparams.h:137
uint64_t AssumedBlockchainSize() const
Minimum free space (in GB) needed for data directory.
Definition: chainparams.h:121
bool fRequireStandard
Definition: chainparams.h:183
std::string cashaddrPrefix
Definition: chainparams.h:178
std::vector< std::string > vSeeds
Definition: chainparams.h:176
bool m_is_mockable_chain
Definition: chainparams.h:185
CMessageHeader::MessageMagic diskMagic
Definition: chainparams.h:170
static std::unique_ptr< const CChainParams > Main(const ChainOptions &options)
uint64_t AssumedChainStateSize() const
Minimum free space (in GB) needed for data directory when pruned; Does not include prune target.
Definition: chainparams.h:126
uint64_t PruneAfterHeight() const
Definition: chainparams.h:119
CCheckpointData checkpointData
Definition: chainparams.h:186
uint16_t nDefaultPort
Definition: chainparams.h:172
std::optional< AssumeutxoData > AssumeutxoForHeight(int height) const
Definition: chainparams.h:141
const CCheckpointData & Checkpoints() const
Definition: chainparams.h:139
uint64_t nPruneAfterHeight
Definition: chainparams.h:173
ChainTxData chainTxData
Definition: chainparams.h:188
uint16_t GetDefaultPort(Network net) const
Definition: chainparams.h:101
std::array< uint8_t, MESSAGE_START_SIZE > MessageMagic
Definition: protocol.h:46
Network address.
Definition: netaddress.h:121
bool SetSpecial(const std::string &addr)
Parse a Tor or I2P address and set this object to it.
Definition: netaddress.cpp:227
enum Network GetNetwork() const
Definition: netaddress.cpp:549
256-bit opaque blob.
Definition: uint256.h:129
std::map< int, BlockHash > MapCheckpoints
Definition: chainparams.h:32
const CCheckpointData & CheckpointData(const std::string &chain)
static constexpr uint16_t I2P_SAM31_PORT
SAM 3.1 and earlier do not support specifying ports and force the port to 0.
Definition: netaddress.h:116
Network
A network type.
Definition: netaddress.h:44
@ NET_I2P
I2P.
Definition: netaddress.h:59
Holds configuration for use during UTXO snapshot load and validation.
Definition: chainparams.h:47
AssumeutxoHash hash_serialized
The expected hash of the deserialized UTXO set.
Definition: chainparams.h:51
BlockHash blockhash
The hash of the base block for this snapshot.
Definition: chainparams.h:63
unsigned int nChainTx
Used to populate the nChainTx value, which is used during BlockManager::LoadBlockIndex().
Definition: chainparams.h:59
AssumeutxoHash(const uint256 &hash)
Definition: chainparams.h:39
A BlockHash is a unqiue identifier for a block.
Definition: blockhash.h:13
MapCheckpoints mapCheckpoints
Definition: chainparams.h:35
Holds various statistics on transactions within a chain.
Definition: chainparams.h:72
double dTxRate
Definition: chainparams.h:75
int64_t nTime
Definition: chainparams.h:73
int64_t nTxCount
Definition: chainparams.h:74
Parameters that influence chain consensus.
Definition: params.h:34
bool fPowNoRetargeting
Definition: params.h:76
uint16_t port
Definition: chainparams.h:29
uint8_t addr[16]
Definition: chainparams.h:28
std::optional< V > FindFirst(const std::vector< V > &vec, const L fnc)
Definition: vector.h:52