Coverage Report

Created: 2026-06-16 16:41

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/tmp/bitcoin/src/kernel/chainparams.cpp
Line
Count
Source
1
// Copyright (c) 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
#include <kernel/chainparams.h>
7
8
#include <chainparamsseeds.h>
9
#include <consensus/amount.h>
10
#include <consensus/merkle.h>
11
#include <consensus/params.h>
12
#include <crypto/hex_base.h>
13
#include <hash.h>
14
#include <kernel/messagestartchars.h>
15
#include <primitives/block.h>
16
#include <primitives/transaction.h>
17
#include <script/interpreter.h>
18
#include <script/script.h>
19
#include <script/verify_flags.h>
20
#include <uint256.h>
21
#include <util/chaintype.h>
22
#include <util/log.h>
23
#include <util/strencodings.h>
24
25
#include <algorithm>
26
#include <array>
27
#include <cassert>
28
#include <cstdint>
29
#include <cstring>
30
#include <iterator>
31
#include <map>
32
#include <span>
33
#include <utility>
34
35
using namespace util::hex_literals;
36
37
static CBlock CreateGenesisBlock(const char* pszTimestamp, const CScript& genesisOutputScript, uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
38
11.8k
{
39
11.8k
    CMutableTransaction txNew;
40
11.8k
    txNew.version = 1;
41
11.8k
    txNew.vin.resize(1);
42
11.8k
    txNew.vout.resize(1);
43
11.8k
    txNew.vin[0].scriptSig = CScript() << 486604799 << CScriptNum(4) << std::vector<unsigned char>((const unsigned char*)pszTimestamp, (const unsigned char*)pszTimestamp + strlen(pszTimestamp));
44
11.8k
    txNew.vout[0].nValue = genesisReward;
45
11.8k
    txNew.vout[0].scriptPubKey = genesisOutputScript;
46
47
11.8k
    CBlock genesis;
48
11.8k
    genesis.nTime    = nTime;
49
11.8k
    genesis.nBits    = nBits;
50
11.8k
    genesis.nNonce   = nNonce;
51
11.8k
    genesis.nVersion = nVersion;
52
11.8k
    genesis.vtx.push_back(MakeTransactionRef(std::move(txNew)));
53
11.8k
    genesis.hashPrevBlock.SetNull();
54
11.8k
    genesis.hashMerkleRoot = BlockMerkleRoot(genesis);
55
11.8k
    return genesis;
56
11.8k
}
57
58
/**
59
 * Build the genesis block. Note that the output of its generation
60
 * transaction cannot be spent since it did not originally exist in the
61
 * database.
62
 *
63
 * CBlock(hash=000000000019d6, ver=1, hashPrevBlock=00000000000000, hashMerkleRoot=4a5e1e, nTime=1231006505, nBits=1d00ffff, nNonce=2083236893, vtx=1)
64
 *   CTransaction(hash=4a5e1e, ver=1, vin.size=1, vout.size=1, nLockTime=0)
65
 *     CTxIn(COutPoint(000000, -1), coinbase 04ffff001d0104455468652054696d65732030332f4a616e2f32303039204368616e63656c6c6f72206f6e206272696e6b206f66207365636f6e64206261696c6f757420666f722062616e6b73)
66
 *     CTxOut(nValue=50.00000000, scriptPubKey=0x5F1DF16B2B704C8A578D0B)
67
 *   vMerkleTree: 4a5e1e
68
 */
69
static CBlock CreateGenesisBlock(uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
70
9.96k
{
71
9.96k
    const char* pszTimestamp = "The Times 03/Jan/2009 Chancellor on brink of second bailout for banks";
72
9.96k
    const CScript genesisOutputScript = CScript() << "04678afdb0fe5548271967f1a67130b7105cd6a828e03909a67962e0ea1f61deb649f6bc3f4cef38c4f35504e51ec112de5c384df7ba0b8d578a4c702b6bf11d5f"_hex << OP_CHECKSIG;
73
9.96k
    return CreateGenesisBlock(pszTimestamp, genesisOutputScript, nTime, nNonce, nBits, nVersion, genesisReward);
74
9.96k
}
75
76
void CChainParams::ApplyDeploymentOptions(const DeploymentOptions& opts)
77
11.8k
{
78
11.8k
    for (const auto& [dep, height] : opts.activation_heights) {
79
31
        switch (dep) {
80
15
        case Consensus::BuriedDeployment::DEPLOYMENT_SEGWIT:
81
15
            consensus.SegwitHeight = int{height};
82
15
            break;
83
3
        case Consensus::BuriedDeployment::DEPLOYMENT_HEIGHTINCB:
84
3
            consensus.BIP34Height = int{height};
85
3
            break;
86
5
        case Consensus::BuriedDeployment::DEPLOYMENT_DERSIG:
87
5
            consensus.BIP66Height = int{height};
88
5
            break;
89
3
        case Consensus::BuriedDeployment::DEPLOYMENT_CLTV:
90
3
            consensus.BIP65Height = int{height};
91
3
            break;
92
5
        case Consensus::BuriedDeployment::DEPLOYMENT_CSV:
93
5
            consensus.CSVHeight = int{height};
94
5
            break;
95
31
        }
96
31
    }
97
98
11.8k
    for (const auto& [deployment_pos, version_bits_params] : opts.version_bits_parameters) {
99
2
        consensus.vDeployments[deployment_pos].nStartTime = version_bits_params.start_time;
100
2
        consensus.vDeployments[deployment_pos].nTimeout = version_bits_params.timeout;
101
2
        consensus.vDeployments[deployment_pos].min_activation_height = version_bits_params.min_activation_height;
102
2
    }
103
11.8k
}
104
105
/**
106
 * Main network on which people trade goods and services.
107
 */
108
class CMainParams : public CChainParams {
109
public:
110
2.71k
    CMainParams(const MainNetOptions& opts) {
111
2.71k
        m_chain_type = ChainType::MAIN;
112
2.71k
        consensus.signet_blocks = false;
113
2.71k
        consensus.signet_challenge.clear();
114
2.71k
        consensus.nSubsidyHalvingInterval = 210000;
115
2.71k
        consensus.script_flag_exceptions.emplace( // BIP16 exception
116
2.71k
            uint256{"00000000000002dc756eebf4f49723ed8d30cc28a5f108eb94b1ba88ac4f9c22"}, SCRIPT_VERIFY_NONE);
117
2.71k
        consensus.script_flag_exceptions.emplace( // Taproot exception
118
2.71k
            uint256{"0000000000000000000f14c35b2d841e986ab5441de8c585d5ffe55ea1e395ad"}, SCRIPT_VERIFY_P2SH | SCRIPT_VERIFY_WITNESS);
119
2.71k
        consensus.BIP34Height = 227931;
120
2.71k
        consensus.BIP34Hash = uint256{"000000000000024b89b42a942fe0d9fea3bb44ab7bd1b19115dd6a759c0808b8"};
121
2.71k
        consensus.BIP65Height = 388381; // 000000000000000004c2b624ed5d7756c508d90fd0da2c7c679febfa6c4735f0
122
2.71k
        consensus.BIP66Height = 363725; // 00000000000000000379eaa19dce8c9b722d46ae6a57c2f1a988119488b50931
123
2.71k
        consensus.CSVHeight = 419328; // 000000000000000004a1b34462cb8aeebd5799177f7a29cf28f2d1961716b5b5
124
2.71k
        consensus.SegwitHeight = 481824; // 0000000000000000001c8018d9cb3b742ef25114f27563e3fc4a1902167f9893
125
2.71k
        consensus.MinBIP9WarningHeight = 711648; // taproot activation height + miner confirmation window
126
2.71k
        consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
127
2.71k
        consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
128
2.71k
        consensus.nPowTargetSpacing = 10 * 60;
129
2.71k
        consensus.fPowAllowMinDifficultyBlocks = false;
130
2.71k
        consensus.enforce_BIP94 = false;
131
2.71k
        consensus.fPowNoRetargeting = false;
132
2.71k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
133
2.71k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nStartTime = Consensus::BIP9Deployment::NEVER_ACTIVE;
134
2.71k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
135
2.71k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
136
2.71k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1815; // 90%
137
2.71k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
138
139
2.71k
        ApplyDeploymentOptions(opts.dep_opts);
140
141
2.71k
        consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000001128750f82f4c366153a3a030"};
142
2.71k
        consensus.defaultAssumeValid = uint256{"00000000000000000000ccebd6d74d9194d8dcdc1d177c478e094bfad51ba5ac"}; // 938343
143
144
        /**
145
         * The message start string is designed to be unlikely to occur in normal data.
146
         * The characters are rarely used upper ASCII, not valid as UTF-8, and produce
147
         * a large 32-bit integer with any alignment.
148
         */
149
2.71k
        pchMessageStart[0] = 0xf9;
150
2.71k
        pchMessageStart[1] = 0xbe;
151
2.71k
        pchMessageStart[2] = 0xb4;
152
2.71k
        pchMessageStart[3] = 0xd9;
153
2.71k
        nDefaultPort = 8333;
154
2.71k
        nPruneAfterHeight = 100000;
155
2.71k
        m_assumed_blockchain_size = 856;
156
2.71k
        m_assumed_chain_state_size = 14;
157
158
2.71k
        genesis = CreateGenesisBlock(1231006505, 2083236893, 0x1d00ffff, 1, 50 * COIN);
159
2.71k
        consensus.hashGenesisBlock = genesis.GetHash();
160
2.71k
        assert(consensus.hashGenesisBlock == uint256{"000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"});
161
2.71k
        assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
162
163
        // Note that of those which support the service bits prefix, most only support a subset of
164
        // possible options.
165
        // This is fine at runtime as we'll fall back to using them as an addrfetch if they don't support the
166
        // service bits we want, but we should get them updated to support all service bits wanted by any
167
        // release ASAP to avoid it where possible.
168
2.71k
        vSeeds.emplace_back("seed.bitcoin.sipa.be."); // Pieter Wuille, only supports x1, x5, x9, and xd
169
2.71k
        vSeeds.emplace_back("dnsseed.bluematt.me."); // Matt Corallo, only supports x9
170
2.71k
        vSeeds.emplace_back("seed.bitcoin.jonasschnelli.ch."); // Jonas Schnelli, only supports x1, x5, x9, and xd
171
2.71k
        vSeeds.emplace_back("seed.btc.petertodd.net."); // Peter Todd, only supports x1, x5, x9, and xd
172
2.71k
        vSeeds.emplace_back("seed.bitcoin.sprovoost.nl."); // Sjors Provoost
173
2.71k
        vSeeds.emplace_back("dnsseed.emzy.de."); // Stephan Oeste
174
2.71k
        vSeeds.emplace_back("seed.bitcoin.wiz.biz."); // Jason Maurice
175
2.71k
        vSeeds.emplace_back("seed.mainnet.achownodes.xyz."); // Ava Chow, only supports x1, x5, x9, x49, x809, x849, xd, x400, x404, x408, x448, xc08, xc48, x40c
176
177
2.71k
        base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,0);
178
2.71k
        base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,5);
179
2.71k
        base58Prefixes[SECRET_KEY] =     std::vector<unsigned char>(1,128);
180
2.71k
        base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x88, 0xB2, 0x1E};
181
2.71k
        base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x88, 0xAD, 0xE4};
182
183
2.71k
        bech32_hrp = "bc";
184
185
2.71k
        vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_main), std::end(chainparams_seed_main));
186
187
2.71k
        fDefaultConsistencyChecks = false;
188
2.71k
        m_is_mockable_chain = false;
189
190
2.71k
        m_assumeutxo_data = {
191
2.71k
            {
192
2.71k
                .height = 840'000,
193
2.71k
                .hash_serialized = AssumeutxoHash{uint256{"a2a5521b1b5ab65f67818e5e8eccabb7171a517f9e2382208f77687310768f96"}},
194
2.71k
                .m_chain_tx_count = 991032194,
195
2.71k
                .blockhash = uint256{"0000000000000000000320283a032748cef8227873ff4872689bf23f1cda83a5"},
196
2.71k
            },
197
2.71k
            {
198
2.71k
                .height = 880'000,
199
2.71k
                .hash_serialized = AssumeutxoHash{uint256{"dbd190983eaf433ef7c15f78a278ae42c00ef52e0fd2a54953782175fbadcea9"}},
200
2.71k
                .m_chain_tx_count = 1145604538,
201
2.71k
                .blockhash = uint256{"000000000000000000010b17283c3c400507969a9c2afd1dcf2082ec5cca2880"},
202
2.71k
            },
203
2.71k
            {
204
2.71k
                .height = 910'000,
205
2.71k
                .hash_serialized = AssumeutxoHash{uint256{"4daf8a17b4902498c5787966a2b51c613acdab5df5db73f196fa59a4da2f1568"}},
206
2.71k
                .m_chain_tx_count = 1226586151,
207
2.71k
                .blockhash = uint256{"0000000000000000000108970acb9522ffd516eae17acddcb1bd16469194a821"},
208
2.71k
            },
209
2.71k
            {
210
2.71k
                .height = 935'000,
211
2.71k
                .hash_serialized = AssumeutxoHash{uint256{"e4b90ef9eae834f56c4b64d2d50143cee10ad87994c614d7d04125e2a6025050"}},
212
2.71k
                .m_chain_tx_count = 1305397408,
213
2.71k
                .blockhash = uint256{"0000000000000000000147034958af1652b2b91bba607beacc5e72a56f0fb5ee"},
214
2.71k
            }
215
2.71k
        };
216
217
2.71k
        chainTxData = ChainTxData{
218
            // Data from RPC: getchaintxstats 4096 00000000000000000000ccebd6d74d9194d8dcdc1d177c478e094bfad51ba5ac
219
2.71k
            .nTime    = 1772055173,
220
2.71k
            .tx_count = 1315805869,
221
2.71k
            .dTxRate  = 5.40111006496122,
222
2.71k
        };
223
224
        // Generated by headerssync-params.py on 2026-02-25.
225
2.71k
        m_headers_sync_params = HeadersSyncParams{
226
2.71k
            .commitment_period = 641,
227
2.71k
            .redownload_buffer_size = 15218, // 15218/641 = ~23.7 commitments
228
2.71k
        };
229
2.71k
    }
230
};
231
232
/**
233
 * Testnet (v3): public test network which is reset from time to time.
234
 */
235
class CTestNetParams : public CChainParams {
236
public:
237
1.96k
    CTestNetParams(const TestNetOptions& opts) {
238
1.96k
        m_chain_type = ChainType::TESTNET;
239
1.96k
        consensus.signet_blocks = false;
240
1.96k
        consensus.signet_challenge.clear();
241
1.96k
        consensus.nSubsidyHalvingInterval = 210000;
242
1.96k
        consensus.script_flag_exceptions.emplace( // BIP16 exception
243
1.96k
            uint256{"00000000dd30457c001f4095d208cc1296b0eed002427aa599874af7a432b105"}, SCRIPT_VERIFY_NONE);
244
1.96k
        consensus.BIP34Height = 21111;
245
1.96k
        consensus.BIP34Hash = uint256{"0000000023b3a96d3484e5abb3755c413e7d41500f8e2a5c3f0dd01299cd8ef8"};
246
1.96k
        consensus.BIP65Height = 581885; // 00000000007f6655f22f98e72ed80d8b06dc761d5da09df0fa1dc4be4f861eb6
247
1.96k
        consensus.BIP66Height = 330776; // 000000002104c8c45e99a8853285a3b592602a3ccde2b832481da85e9e4ba182
248
1.96k
        consensus.CSVHeight = 770112; // 00000000025e930139bac5c6c31a403776da130831ab85be56578f3fa75369bb
249
1.96k
        consensus.SegwitHeight = 834624; // 00000000002b980fcd729daaa248fd9316a5200e9b367f4ff2c42453e84201ca
250
1.96k
        consensus.MinBIP9WarningHeight = 2013984; // taproot activation height + miner confirmation window
251
1.96k
        consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
252
1.96k
        consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
253
1.96k
        consensus.nPowTargetSpacing = 10 * 60;
254
1.96k
        consensus.fPowAllowMinDifficultyBlocks = true;
255
1.96k
        consensus.enforce_BIP94 = false;
256
1.96k
        consensus.fPowNoRetargeting = false;
257
1.96k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
258
1.96k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nStartTime = Consensus::BIP9Deployment::NEVER_ACTIVE;
259
1.96k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
260
1.96k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
261
1.96k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1512; // 75%
262
1.96k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
263
264
1.96k
        ApplyDeploymentOptions(opts.dep_opts);
265
266
1.96k
        consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000000000017dde1c649f3708d14b6"};
267
1.96k
        consensus.defaultAssumeValid = uint256{"000000007a61e4230b28ac5cb6b5e5a0130de37ac1faf2f8987d2fa6505b67f4"}; // 4842348
268
269
1.96k
        pchMessageStart[0] = 0x0b;
270
1.96k
        pchMessageStart[1] = 0x11;
271
1.96k
        pchMessageStart[2] = 0x09;
272
1.96k
        pchMessageStart[3] = 0x07;
273
1.96k
        nDefaultPort = 18333;
274
1.96k
        nPruneAfterHeight = 1000;
275
1.96k
        m_assumed_blockchain_size = 245;
276
1.96k
        m_assumed_chain_state_size = 19;
277
278
1.96k
        genesis = CreateGenesisBlock(1296688602, 414098458, 0x1d00ffff, 1, 50 * COIN);
279
1.96k
        consensus.hashGenesisBlock = genesis.GetHash();
280
1.96k
        assert(consensus.hashGenesisBlock == uint256{"000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943"});
281
1.96k
        assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
282
283
1.96k
        vFixedSeeds.clear();
284
1.96k
        vSeeds.clear();
285
        // nodes with support for servicebits filtering should be at the top
286
1.96k
        vSeeds.emplace_back("testnet-seed.bitcoin.jonasschnelli.ch.");
287
1.96k
        vSeeds.emplace_back("seed.tbtc.petertodd.net.");
288
1.96k
        vSeeds.emplace_back("seed.testnet.bitcoin.sprovoost.nl.");
289
1.96k
        vSeeds.emplace_back("testnet-seed.bluematt.me."); // Just a static list of stable node(s), only supports x9
290
1.96k
        vSeeds.emplace_back("seed.testnet.achownodes.xyz."); // Ava Chow, only supports x1, x5, x9, x49, x809, x849, xd, x400, x404, x408, x448, xc08, xc48, x40c
291
292
1.96k
        base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
293
1.96k
        base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
294
1.96k
        base58Prefixes[SECRET_KEY] =     std::vector<unsigned char>(1,239);
295
1.96k
        base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
296
1.96k
        base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
297
298
1.96k
        bech32_hrp = "tb";
299
300
1.96k
        vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_test), std::end(chainparams_seed_test));
301
302
1.96k
        fDefaultConsistencyChecks = false;
303
1.96k
        m_is_mockable_chain = false;
304
305
1.96k
        m_assumeutxo_data = {
306
1.96k
            {
307
1.96k
                .height = 2'500'000,
308
1.96k
                .hash_serialized = AssumeutxoHash{uint256{"f841584909f68e47897952345234e37fcd9128cd818f41ee6c3ca68db8071be7"}},
309
1.96k
                .m_chain_tx_count = 66484552,
310
1.96k
                .blockhash = uint256{"0000000000000093bcb68c03a9a168ae252572d348a2eaeba2cdf9231d73206f"},
311
1.96k
            },
312
1.96k
            {
313
1.96k
                .height = 4'840'000,
314
1.96k
                .hash_serialized = AssumeutxoHash{uint256{"ce6bb677bb2ee9789c4a1c9d73e6683c53fc20e8fdbedbdaaf468982a0c8db2a"}},
315
1.96k
                .m_chain_tx_count = 536078574,
316
1.96k
                .blockhash = uint256{"00000000000000f4971a7fb37fbdff89315b69a2e1920c467654a382f0d64786"},
317
1.96k
            }
318
1.96k
        };
319
320
1.96k
        chainTxData = ChainTxData{
321
            // Data from RPC: getchaintxstats 4096 000000007a61e4230b28ac5cb6b5e5a0130de37ac1faf2f8987d2fa6505b67f4
322
1.96k
            .nTime    = 1772051651,
323
1.96k
            .tx_count = 536108416,
324
1.96k
            .dTxRate  = 0.02691479016257117,
325
1.96k
        };
326
327
        // Generated by headerssync-params.py on 2026-02-25.
328
1.96k
        m_headers_sync_params = HeadersSyncParams{
329
1.96k
            .commitment_period = 673,
330
1.96k
            .redownload_buffer_size = 14460, // 14460/673 = ~21.5 commitments
331
1.96k
        };
332
1.96k
    }
333
};
334
335
/**
336
 * Testnet (v4): public test network which is reset from time to time.
337
 */
338
class CTestNet4Params : public CChainParams {
339
public:
340
1.93k
    CTestNet4Params(const TestNetOptions& opts) {
341
1.93k
        m_chain_type = ChainType::TESTNET4;
342
1.93k
        consensus.signet_blocks = false;
343
1.93k
        consensus.signet_challenge.clear();
344
1.93k
        consensus.nSubsidyHalvingInterval = 210000;
345
1.93k
        consensus.BIP34Height = 1;
346
1.93k
        consensus.BIP34Hash = uint256{};
347
1.93k
        consensus.BIP65Height = 1;
348
1.93k
        consensus.BIP66Height = 1;
349
1.93k
        consensus.CSVHeight = 1;
350
1.93k
        consensus.SegwitHeight = 1;
351
1.93k
        consensus.MinBIP9WarningHeight = 0;
352
1.93k
        consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
353
1.93k
        consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
354
1.93k
        consensus.nPowTargetSpacing = 10 * 60;
355
1.93k
        consensus.fPowAllowMinDifficultyBlocks = true;
356
1.93k
        consensus.enforce_BIP94 = true;
357
1.93k
        consensus.fPowNoRetargeting = false;
358
359
1.93k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
360
1.93k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nStartTime = Consensus::BIP9Deployment::NEVER_ACTIVE;
361
1.93k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
362
1.93k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
363
1.93k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1512; // 75%
364
1.93k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
365
366
1.93k
        ApplyDeploymentOptions(opts.dep_opts);
367
368
1.93k
        consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000000000009a0fe15d0177d086304"};
369
1.93k
        consensus.defaultAssumeValid = uint256{"0000000002368b1e4ee27e2e85676ae6f9f9e69579b29093e9a82c170bf7cf8a"}; // 123613
370
371
1.93k
        pchMessageStart[0] = 0x1c;
372
1.93k
        pchMessageStart[1] = 0x16;
373
1.93k
        pchMessageStart[2] = 0x3f;
374
1.93k
        pchMessageStart[3] = 0x28;
375
1.93k
        nDefaultPort = 48333;
376
1.93k
        nPruneAfterHeight = 1000;
377
1.93k
        m_assumed_blockchain_size = 31;
378
1.93k
        m_assumed_chain_state_size = 2;
379
380
1.93k
        const char* testnet4_genesis_msg = "03/May/2024 000000000000000000001ebd58c244970b3aa9d783bb001011fbe8ea8e98e00e";
381
1.93k
        const CScript testnet4_genesis_script = CScript() << "000000000000000000000000000000000000000000000000000000000000000000"_hex << OP_CHECKSIG;
382
1.93k
        genesis = CreateGenesisBlock(testnet4_genesis_msg,
383
1.93k
                testnet4_genesis_script,
384
1.93k
                1714777860,
385
1.93k
                393743547,
386
1.93k
                0x1d00ffff,
387
1.93k
                1,
388
1.93k
                50 * COIN);
389
1.93k
        consensus.hashGenesisBlock = genesis.GetHash();
390
1.93k
        assert(consensus.hashGenesisBlock == uint256{"00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043"});
391
1.93k
        assert(genesis.hashMerkleRoot == uint256{"7aa0a7ae1e223414cb807e40cd57e667b718e42aaf9306db9102fe28912b7b4e"});
392
393
1.93k
        vFixedSeeds.clear();
394
1.93k
        vSeeds.clear();
395
        // nodes with support for servicebits filtering should be at the top
396
1.93k
        vSeeds.emplace_back("seed.testnet4.bitcoin.sprovoost.nl."); // Sjors Provoost
397
1.93k
        vSeeds.emplace_back("seed.testnet4.wiz.biz."); // Jason Maurice
398
399
1.93k
        base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
400
1.93k
        base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
401
1.93k
        base58Prefixes[SECRET_KEY] =     std::vector<unsigned char>(1,239);
402
1.93k
        base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
403
1.93k
        base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
404
405
1.93k
        bech32_hrp = "tb";
406
407
1.93k
        vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_testnet4), std::end(chainparams_seed_testnet4));
408
409
1.93k
        fDefaultConsistencyChecks = false;
410
1.93k
        m_is_mockable_chain = false;
411
412
1.93k
        m_assumeutxo_data = {
413
1.93k
            {
414
1.93k
                .height = 90'000,
415
1.93k
                .hash_serialized = AssumeutxoHash{uint256{"784fb5e98241de66fdd429f4392155c9e7db5c017148e66e8fdbc95746f8b9b5"}},
416
1.93k
                .m_chain_tx_count = 11347043,
417
1.93k
                .blockhash = uint256{"0000000002ebe8bcda020e0dd6ccfbdfac531d2f6a81457191b99fc2df2dbe3b"},
418
1.93k
            },
419
1.93k
            {
420
1.93k
                .height = 120'000,
421
1.93k
                .hash_serialized = AssumeutxoHash{uint256{"10b05d05ad468d0971162e1b222a4aa66caca89da2bb2a93f8f37fb29c4794b0"}},
422
1.93k
                .m_chain_tx_count = 14141057,
423
1.93k
                .blockhash = uint256{"000000000bd2317e51b3c5794981c35ba894ce27d3e772d5c39ecd9cbce01dc8"},
424
1.93k
            }
425
1.93k
        };
426
427
1.93k
        chainTxData = ChainTxData{
428
            // Data from RPC: getchaintxstats 4096 0000000002368b1e4ee27e2e85676ae6f9f9e69579b29093e9a82c170bf7cf8a
429
1.93k
            .nTime    = 1772013387,
430
1.93k
            .tx_count = 14191421,
431
1.93k
            .dTxRate  = 0.01848579579528412,
432
1.93k
        };
433
434
        // Generated by headerssync-params.py on 2026-02-25.
435
1.93k
        m_headers_sync_params = HeadersSyncParams{
436
1.93k
            .commitment_period = 606,
437
1.93k
            .redownload_buffer_size = 16092, // 16092/606 = ~26.6 commitments
438
1.93k
        };
439
1.93k
    }
440
};
441
442
/**
443
 * Signet: test network with an additional consensus parameter (see BIP325).
444
 */
445
class SigNetParams : public CChainParams {
446
public:
447
    explicit SigNetParams(const SigNetOptions& options)
448
2.01k
    {
449
2.01k
        std::vector<uint8_t> bin;
450
2.01k
        vFixedSeeds.clear();
451
2.01k
        vSeeds.clear();
452
453
2.01k
        if (!options.challenge) {
454
2.00k
            bin = "512103ad5e0edad18cb1f0fc0d28a3d4f1f3e445640337489abb10404f2d1e086be430210359ef5021964fe22d6f8e05b2463c9540ce96883fe3b278760f048f5189f2e6c452ae"_hex_v_u8;
455
2.00k
            vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_signet), std::end(chainparams_seed_signet));
456
2.00k
            vSeeds.emplace_back("seed.signet.bitcoin.sprovoost.nl.");
457
2.00k
            vSeeds.emplace_back("seed.signet.achownodes.xyz."); // Ava Chow, only supports x1, x5, x9, x49, x809, x849, xd, x400, x404, x408, x448, xc08, xc48, x40c
458
459
2.00k
            consensus.nMinimumChainWork = uint256{"00000000000000000000000000000000000000000000000000000b463ea0a4b8"};
460
2.00k
            consensus.defaultAssumeValid = uint256{"00000008414aab61092ef93f1aacc54cf9e9f16af29ddad493b908a01ff5c329"}; // 293175
461
2.00k
            m_assumed_blockchain_size = 24;
462
2.00k
            m_assumed_chain_state_size = 4;
463
2.00k
            chainTxData = ChainTxData{
464
                // Data from RPC: getchaintxstats 4096 00000008414aab61092ef93f1aacc54cf9e9f16af29ddad493b908a01ff5c329
465
2.00k
                .nTime    = 1772055248,
466
2.00k
                .tx_count = 28676833,
467
2.00k
                .dTxRate  = 0.06736623436338929,
468
2.00k
            };
469
2.00k
        } else {
470
10
            bin = *options.challenge;
471
10
            consensus.nMinimumChainWork = uint256{};
472
10
            consensus.defaultAssumeValid = uint256{};
473
10
            m_assumed_blockchain_size = 0;
474
10
            m_assumed_chain_state_size = 0;
475
10
            chainTxData = ChainTxData{
476
10
                0,
477
10
                0,
478
10
                0,
479
10
            };
480
10
            LogInfo("Signet with challenge %s", HexStr(bin));
481
10
        }
482
483
2.01k
        if (options.seeds) {
484
0
            vSeeds = *options.seeds;
485
0
        }
486
487
2.01k
        m_chain_type = ChainType::SIGNET;
488
2.01k
        consensus.signet_blocks = true;
489
2.01k
        consensus.signet_challenge.assign(bin.begin(), bin.end());
490
2.01k
        consensus.nSubsidyHalvingInterval = 210000;
491
2.01k
        consensus.BIP34Height = 1;
492
2.01k
        consensus.BIP34Hash = uint256{};
493
2.01k
        consensus.BIP65Height = 1;
494
2.01k
        consensus.BIP66Height = 1;
495
2.01k
        consensus.CSVHeight = 1;
496
2.01k
        consensus.SegwitHeight = 1;
497
2.01k
        consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
498
2.01k
        consensus.nPowTargetSpacing = 10 * 60;
499
2.01k
        consensus.fPowAllowMinDifficultyBlocks = false;
500
2.01k
        consensus.enforce_BIP94 = false;
501
2.01k
        consensus.fPowNoRetargeting = false;
502
2.01k
        consensus.MinBIP9WarningHeight = 0;
503
2.01k
        consensus.powLimit = uint256{"00000377ae000000000000000000000000000000000000000000000000000000"};
504
2.01k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
505
2.01k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nStartTime = Consensus::BIP9Deployment::NEVER_ACTIVE;
506
2.01k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
507
2.01k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
508
2.01k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1815; // 90%
509
2.01k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
510
511
2.01k
        ApplyDeploymentOptions(options.dep_opts);
512
513
        // message start is defined as the first 4 bytes of the sha256d of the block script
514
2.01k
        HashWriter h{};
515
2.01k
        h << consensus.signet_challenge;
516
2.01k
        uint256 hash = h.GetHash();
517
2.01k
        std::copy_n(hash.begin(), 4, pchMessageStart.begin());
518
519
2.01k
        nDefaultPort = 38333;
520
2.01k
        nPruneAfterHeight = 1000;
521
522
2.01k
        genesis = CreateGenesisBlock(1598918400, 52613770, 0x1e0377ae, 1, 50 * COIN);
523
2.01k
        consensus.hashGenesisBlock = genesis.GetHash();
524
2.01k
        assert(consensus.hashGenesisBlock == uint256{"00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6"});
525
2.01k
        assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
526
527
2.01k
        m_assumeutxo_data = {
528
2.01k
            {
529
2.01k
                .height = 160'000,
530
2.01k
                .hash_serialized = AssumeutxoHash{uint256{"fe0a44309b74d6b5883d246cb419c6221bcccf0b308c9b59b7d70783dbdf928a"}},
531
2.01k
                .m_chain_tx_count = 2289496,
532
2.01k
                .blockhash = uint256{"0000003ca3c99aff040f2563c2ad8f8ec88bd0fd6b8f0895cfaf1ef90353a62c"},
533
2.01k
            },
534
2.01k
            {
535
2.01k
                .height = 290'000,
536
2.01k
                .hash_serialized = AssumeutxoHash{uint256{"97267e000b4b876800167e71b9123f1529d13b14308abec2888bbd2160d14545"}},
537
2.01k
                .m_chain_tx_count = 28547497,
538
2.01k
                .blockhash = uint256{"0000000577f2741bb30cd9d39d6d71b023afbeb9764f6260786a97969d5c9ac0"},
539
2.01k
            }
540
2.01k
        };
541
542
2.01k
        base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
543
2.01k
        base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
544
2.01k
        base58Prefixes[SECRET_KEY] =     std::vector<unsigned char>(1,239);
545
2.01k
        base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
546
2.01k
        base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
547
548
2.01k
        bech32_hrp = "tb";
549
550
2.01k
        fDefaultConsistencyChecks = false;
551
2.01k
        m_is_mockable_chain = false;
552
553
        // Generated by headerssync-params.py on 2026-02-25.
554
2.01k
        m_headers_sync_params = HeadersSyncParams{
555
2.01k
            .commitment_period = 620,
556
2.01k
            .redownload_buffer_size = 15724, // 15724/620 = ~25.4 commitments
557
2.01k
        };
558
2.01k
    }
559
};
560
561
/**
562
 * Regression test: intended for private networks only. Has minimal difficulty to ensure that
563
 * blocks can be found instantly.
564
 */
565
class CRegTestParams : public CChainParams
566
{
567
public:
568
    explicit CRegTestParams(const RegTestOptions& opts)
569
3.27k
    {
570
3.27k
        m_chain_type = ChainType::REGTEST;
571
3.27k
        consensus.signet_blocks = false;
572
3.27k
        consensus.signet_challenge.clear();
573
3.27k
        consensus.nSubsidyHalvingInterval = 150;
574
3.27k
        consensus.BIP34Height = 1; // Always active unless overridden
575
3.27k
        consensus.BIP34Hash = uint256();
576
3.27k
        consensus.BIP65Height = 1;  // Always active unless overridden
577
3.27k
        consensus.BIP66Height = 1;  // Always active unless overridden
578
3.27k
        consensus.CSVHeight = 1;    // Always active unless overridden
579
3.27k
        consensus.SegwitHeight = 0; // Always active unless overridden
580
3.27k
        consensus.MinBIP9WarningHeight = 0;
581
3.27k
        consensus.powLimit = uint256{"7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
582
3.27k
        consensus.nPowTargetTimespan = 24 * 60 * 60; // one day
583
3.27k
        consensus.nPowTargetSpacing = 10 * 60;
584
3.27k
        consensus.fPowAllowMinDifficultyBlocks = true;
585
3.27k
        consensus.enforce_BIP94 = opts.enforce_bip94;
586
3.27k
        consensus.fPowNoRetargeting = true;
587
588
3.27k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
589
3.27k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nStartTime = 0;
590
3.27k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
591
3.27k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
592
3.27k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 108; // 75%
593
3.27k
        consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 144; // Faster than normal for regtest (144 instead of 2016)
594
595
3.27k
        consensus.nMinimumChainWork = uint256{};
596
3.27k
        consensus.defaultAssumeValid = uint256{};
597
598
3.27k
        pchMessageStart[0] = 0xfa;
599
3.27k
        pchMessageStart[1] = 0xbf;
600
3.27k
        pchMessageStart[2] = 0xb5;
601
3.27k
        pchMessageStart[3] = 0xda;
602
3.27k
        nDefaultPort = 18444;
603
3.27k
        nPruneAfterHeight = opts.fastprune ? 100 : 1000;
604
3.27k
        m_assumed_blockchain_size = 0;
605
3.27k
        m_assumed_chain_state_size = 0;
606
607
3.27k
        ApplyDeploymentOptions(opts.dep_opts);
608
609
3.27k
        genesis = CreateGenesisBlock(1296688602, 2, 0x207fffff, 1, 50 * COIN);
610
3.27k
        consensus.hashGenesisBlock = genesis.GetHash();
611
3.27k
        assert(consensus.hashGenesisBlock == uint256{"0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206"});
612
3.27k
        assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
613
614
3.27k
        vFixedSeeds.clear(); //!< Regtest mode doesn't have any fixed seeds.
615
3.27k
        vSeeds.clear();
616
3.27k
        vSeeds.emplace_back("dummySeed.invalid.");
617
618
3.27k
        fDefaultConsistencyChecks = true;
619
3.27k
        m_is_mockable_chain = true;
620
621
3.27k
        m_assumeutxo_data = {
622
3.27k
            {   // For use by unit tests
623
3.27k
                .height = 110,
624
3.27k
                .hash_serialized = AssumeutxoHash{uint256{"86e9a1205b418b16dde3a18a78c730e30137e28466bda5dbf6b33ab8fc05447c"}},
625
3.27k
                .m_chain_tx_count = 111,
626
3.27k
                .blockhash = uint256{"135eec25a6fb277884e5824e7aa7d052c4868161c99a5122170b5266f86c273d"},
627
3.27k
            },
628
3.27k
            {
629
                // For use by fuzz target src/test/fuzz/utxo_snapshot.cpp
630
3.27k
                .height = 200,
631
3.27k
                .hash_serialized = AssumeutxoHash{uint256{"17dcc016d188d16068907cdeb38b75691a118d43053b8cd6a25969419381d13a"}},
632
3.27k
                .m_chain_tx_count = 201,
633
3.27k
                .blockhash = uint256{"385901ccbd69dff6bbd00065d01fb8a9e464dede7cfe0372443884f9b1dcf6b9"},
634
3.27k
            },
635
3.27k
            {
636
                // For use by test/functional/feature_assumeutxo.py and test/functional/tool_bitcoin_chainstate.py
637
3.27k
                .height = 299,
638
3.27k
                .hash_serialized = AssumeutxoHash{uint256{"106b2c56233e378a824cf0d5ff2be42ed32c72f1605c9be288d00942908a40ac"}},
639
3.27k
                .m_chain_tx_count = 334,
640
3.27k
                .blockhash = uint256{"0c552ced4721c249a389eb9b08cb8da261cd46f0e7b5f9d064d48f3113406853"},
641
3.27k
            },
642
3.27k
        };
643
644
3.27k
        chainTxData = ChainTxData{
645
3.27k
            .nTime = 0,
646
3.27k
            .tx_count = 0,
647
3.27k
            .dTxRate = 0.001, // Set a non-zero rate to make it testable
648
3.27k
        };
649
650
3.27k
        base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
651
3.27k
        base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
652
3.27k
        base58Prefixes[SECRET_KEY] =     std::vector<unsigned char>(1,239);
653
3.27k
        base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
654
3.27k
        base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
655
656
3.27k
        bech32_hrp = "bcrt";
657
658
        // Copied from Testnet4.
659
3.27k
        m_headers_sync_params = HeadersSyncParams{
660
3.27k
            .commitment_period = 275,
661
3.27k
            .redownload_buffer_size = 7017, // 7017/275 = ~25.5 commitments
662
3.27k
        };
663
3.27k
    }
664
};
665
666
std::unique_ptr<const CChainParams> CChainParams::SigNet(const SigNetOptions& options)
667
2.01k
{
668
2.01k
    return std::make_unique<const SigNetParams>(options);
669
2.01k
}
670
671
std::unique_ptr<const CChainParams> CChainParams::RegTest(const RegTestOptions& options)
672
3.27k
{
673
3.27k
    return std::make_unique<const CRegTestParams>(options);
674
3.27k
}
675
676
std::unique_ptr<const CChainParams> CChainParams::Main(const MainNetOptions& options)
677
2.71k
{
678
2.71k
    return std::make_unique<const CMainParams>(options);
679
2.71k
}
680
681
std::unique_ptr<const CChainParams> CChainParams::TestNet(const TestNetOptions& options)
682
1.96k
{
683
1.96k
    return std::make_unique<const CTestNetParams>(options);
684
1.96k
}
685
686
std::unique_ptr<const CChainParams> CChainParams::TestNet4(const TestNetOptions& options)
687
1.93k
{
688
1.93k
    return std::make_unique<const CTestNet4Params>(options);
689
1.93k
}
690
691
std::vector<int> CChainParams::GetAvailableSnapshotHeights() const
692
15
{
693
15
    std::vector<int> heights;
694
15
    heights.reserve(m_assumeutxo_data.size());
695
696
45
    for (const auto& data : m_assumeutxo_data) {
697
45
        heights.emplace_back(data.height);
698
45
    }
699
15
    return heights;
700
15
}
701
702
std::optional<ChainType> GetNetworkForMagic(const MessageStartChars& message)
703
8
{
704
8
    const auto mainnet_msg = CChainParams::Main()->MessageStart();
705
8
    const auto testnet_msg = CChainParams::TestNet()->MessageStart();
706
8
    const auto testnet4_msg = CChainParams::TestNet4()->MessageStart();
707
8
    const auto regtest_msg = CChainParams::RegTest()->MessageStart();
708
8
    const auto signet_msg = CChainParams::SigNet()->MessageStart();
709
710
8
    if (std::ranges::equal(message, mainnet_msg)) {
711
1
        return ChainType::MAIN;
712
7
    } else if (std::ranges::equal(message, testnet_msg)) {
713
0
        return ChainType::TESTNET;
714
7
    } else if (std::ranges::equal(message, testnet4_msg)) {
715
1
        return ChainType::TESTNET4;
716
6
    } else if (std::ranges::equal(message, regtest_msg)) {
717
3
        return ChainType::REGTEST;
718
3
    } else if (std::ranges::equal(message, signet_msg)) {
719
1
        return ChainType::SIGNET;
720
1
    }
721
2
    return std::nullopt;
722
8
}