Bitcoin Core 32.99.0
P2P Digital Currency
chainparams.cpp
Go to the documentation of this file.
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
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>
14#include <kernel/signet.h>
15#include <primitives/block.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
35using namespace util::hex_literals;
36
37static CBlock CreateGenesisBlock(const char* pszTimestamp, const CScript& genesisOutputScript, uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
38{
40 txNew.version = 1;
41 txNew.vin.resize(1);
42 txNew.vout.resize(1);
43 txNew.vin[0].scriptSig = CScript() << 486604799 << CScriptNum(4) << std::vector<unsigned char>((const unsigned char*)pszTimestamp, (const unsigned char*)pszTimestamp + strlen(pszTimestamp));
44 txNew.vout[0].nValue = genesisReward;
45 txNew.vout[0].scriptPubKey = genesisOutputScript;
46
47 CBlock genesis;
48 genesis.nTime = nTime;
49 genesis.nBits = nBits;
50 genesis.nNonce = nNonce;
51 genesis.nVersion = nVersion;
52 genesis.vtx.push_back(MakeTransactionRef(std::move(txNew)));
53 genesis.hashPrevBlock.SetNull();
54 genesis.hashMerkleRoot = BlockMerkleRoot(genesis);
55 return genesis;
56}
57
69static CBlock CreateGenesisBlock(uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
70{
71 const char* pszTimestamp = "The Times 03/Jan/2009 Chancellor on brink of second bailout for banks";
72 const CScript genesisOutputScript = CScript() << "04678afdb0fe5548271967f1a67130b7105cd6a828e03909a67962e0ea1f61deb649f6bc3f4cef38c4f35504e51ec112de5c384df7ba0b8d578a4c702b6bf11d5f"_hex << OP_CHECKSIG;
73 return CreateGenesisBlock(pszTimestamp, genesisOutputScript, nTime, nNonce, nBits, nVersion, genesisReward);
74}
75
77{
78 for (const auto& [dep, height] : opts.activation_heights) {
79 switch (dep) {
81 consensus.SegwitHeight = int{height};
82 break;
84 consensus.BIP34Height = int{height};
85 break;
87 consensus.BIP66Height = int{height};
88 break;
90 consensus.BIP65Height = int{height};
91 break;
93 consensus.CSVHeight = int{height};
94 break;
95 }
96 }
97
98 for (const auto& [deployment_pos, version_bits_params] : opts.version_bits_parameters) {
99 consensus.vDeployments[deployment_pos].nStartTime = version_bits_params.start_time;
100 consensus.vDeployments[deployment_pos].nTimeout = version_bits_params.timeout;
101 consensus.vDeployments[deployment_pos].min_activation_height = version_bits_params.min_activation_height;
102 }
103}
104
108class CMainParams : public CChainParams {
109public:
112 consensus.signet_blocks = false;
115 consensus.script_flag_exceptions.emplace( // BIP16 exception
116 uint256{"00000000000002dc756eebf4f49723ed8d30cc28a5f108eb94b1ba88ac4f9c22"}, SCRIPT_VERIFY_NONE);
117 consensus.script_flag_exceptions.emplace( // Taproot exception
118 uint256{"0000000000000000000f14c35b2d841e986ab5441de8c585d5ffe55ea1e395ad"}, SCRIPT_VERIFY_P2SH | SCRIPT_VERIFY_WITNESS);
119 consensus.BIP34Height = 227931;
120 consensus.BIP34Hash = uint256{"000000000000024b89b42a942fe0d9fea3bb44ab7bd1b19115dd6a759c0808b8"};
121 consensus.BIP65Height = 388381; // 000000000000000004c2b624ed5d7756c508d90fd0da2c7c679febfa6c4735f0
122 consensus.BIP66Height = 363725; // 00000000000000000379eaa19dce8c9b722d46ae6a57c2f1a988119488b50931
123 consensus.CSVHeight = 419328; // 000000000000000004a1b34462cb8aeebd5799177f7a29cf28f2d1961716b5b5
124 consensus.SegwitHeight = 481824; // 0000000000000000001c8018d9cb3b742ef25114f27563e3fc4a1902167f9893
125 consensus.MinBIP9WarningHeight = 711648; // taproot activation height + miner confirmation window
126 consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
127 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
130 consensus.enforce_BIP94 = false;
135 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
138
140
141 consensus.nMinimumChainWork = uint256{"000000000000000000000000000000000000000145ec036acc5ba740052af1a0"};
142 consensus.defaultAssumeValid = uint256{"00000000000000000000748969ec33043c0e52a763c6dd5193861f559f2c72e3"}; // 966143
143
149 pchMessageStart[0] = 0xf9;
150 pchMessageStart[1] = 0xbe;
151 pchMessageStart[2] = 0xb4;
152 pchMessageStart[3] = 0xd9;
153 nDefaultPort = 8333;
154 nPruneAfterHeight = 100000;
157
158 genesis = CreateGenesisBlock(1231006505, 2083236893, 0x1d00ffff, 1, 50 * COIN);
160 assert(consensus.hashGenesisBlock == uint256{"000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"});
161 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 vSeeds.emplace_back("dnsseed.bluematt.me."); // Matt Corallo, only supports x9
169 vSeeds.emplace_back("seed.bitcoin.jonasschnelli.ch."); // Jonas Schnelli, only supports x1, x5, x9, and xd
170 vSeeds.emplace_back("seed.btc.petertodd.net."); // Peter Todd, only supports x1, x5, x9, and xd
171 vSeeds.emplace_back("seed.bitcoin.sprovoost.nl."); // Sjors Provoost
172 vSeeds.emplace_back("dnsseed.emzy.de."); // Stephan Oeste
173 vSeeds.emplace_back("seed.bitcoin.wiz.biz."); // Jason Maurice
174 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
175
176 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,0);
177 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,5);
178 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,128);
179 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x88, 0xB2, 0x1E};
180 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x88, 0xAD, 0xE4};
181
182 bech32_hrp = "bc";
183
184 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_main), std::end(chainparams_seed_main));
185
187 m_is_mockable_chain = false;
188
190 {
191 .height = 840'000,
192 .hash_serialized = AssumeutxoHash{uint256{"a2a5521b1b5ab65f67818e5e8eccabb7171a517f9e2382208f77687310768f96"}},
193 .m_chain_tx_count = 991032194,
194 .blockhash = uint256{"0000000000000000000320283a032748cef8227873ff4872689bf23f1cda83a5"},
195 },
196 {
197 .height = 880'000,
198 .hash_serialized = AssumeutxoHash{uint256{"dbd190983eaf433ef7c15f78a278ae42c00ef52e0fd2a54953782175fbadcea9"}},
199 .m_chain_tx_count = 1145604538,
200 .blockhash = uint256{"000000000000000000010b17283c3c400507969a9c2afd1dcf2082ec5cca2880"},
201 },
202 {
203 .height = 910'000,
204 .hash_serialized = AssumeutxoHash{uint256{"4daf8a17b4902498c5787966a2b51c613acdab5df5db73f196fa59a4da2f1568"}},
205 .m_chain_tx_count = 1226586151,
206 .blockhash = uint256{"0000000000000000000108970acb9522ffd516eae17acddcb1bd16469194a821"},
207 },
208 {
209 .height = 935'000,
210 .hash_serialized = AssumeutxoHash{uint256{"e4b90ef9eae834f56c4b64d2d50143cee10ad87994c614d7d04125e2a6025050"}},
211 .m_chain_tx_count = 1305397408,
212 .blockhash = uint256{"0000000000000000000147034958af1652b2b91bba607beacc5e72a56f0fb5ee"},
213 },
214 {
215 .height = 965'000,
216 .hash_serialized = AssumeutxoHash{uint256{"4a8d794337118c0c615b574f817c7306c687584a537184b8d233df42bf477ec2"}},
217 .m_chain_tx_count = 1429611231,
218 .blockhash = uint256{"00000000000000000001595977e6000ce56129f5c9b4073e31ccc30b90b97da9"},
219 }
220 };
221
223 // Data from RPC: getchaintxstats 4096 00000000000000000000748969ec33043c0e52a763c6dd5193861f559f2c72e3
224 .nTime = 1788925573,
225 .tx_count = 1434982600,
226 .dTxRate = 7.851784479579372,
227 };
228
229 // Generated by headerssync-params.py on 2026-09-08.
231 .commitment_period = 649,
232 .redownload_buffer_size = 15400, // 15400/649 = ~23.7 commitments
233 };
234 }
235};
236
241public:
244 consensus.signet_blocks = false;
247 consensus.script_flag_exceptions.emplace( // BIP16 exception
248 uint256{"00000000dd30457c001f4095d208cc1296b0eed002427aa599874af7a432b105"}, SCRIPT_VERIFY_NONE);
249 consensus.BIP34Height = 21111;
250 consensus.BIP34Hash = uint256{"0000000023b3a96d3484e5abb3755c413e7d41500f8e2a5c3f0dd01299cd8ef8"};
251 consensus.BIP65Height = 581885; // 00000000007f6655f22f98e72ed80d8b06dc761d5da09df0fa1dc4be4f861eb6
252 consensus.BIP66Height = 330776; // 000000002104c8c45e99a8853285a3b592602a3ccde2b832481da85e9e4ba182
253 consensus.CSVHeight = 770112; // 00000000025e930139bac5c6c31a403776da130831ab85be56578f3fa75369bb
254 consensus.SegwitHeight = 834624; // 00000000002b980fcd729daaa248fd9316a5200e9b367f4ff2c42453e84201ca
255 consensus.MinBIP9WarningHeight = 2013984; // taproot activation height + miner confirmation window
256 consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
257 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
260 consensus.enforce_BIP94 = false;
265 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
268
270
271 consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000000000017f49f702147f10c0eb6"};
272 consensus.defaultAssumeValid = uint256{"00000000b318a3703d14a844c55ef507f4c2fc8f8766e24271fd43c180c51637"}; // 5128859
273
274 pchMessageStart[0] = 0x0b;
275 pchMessageStart[1] = 0x11;
276 pchMessageStart[2] = 0x09;
277 pchMessageStart[3] = 0x07;
278 nDefaultPort = 18333;
279 nPruneAfterHeight = 1000;
282
283 genesis = CreateGenesisBlock(1296688602, 414098458, 0x1d00ffff, 1, 50 * COIN);
285 assert(consensus.hashGenesisBlock == uint256{"000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943"});
286 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
287
288 vFixedSeeds.clear();
289 vSeeds.clear();
290 // nodes with support for servicebits filtering should be at the top
291 vSeeds.emplace_back("testnet-seed.bitcoin.jonasschnelli.ch.");
292 vSeeds.emplace_back("seed.tbtc.petertodd.net.");
293 vSeeds.emplace_back("testnet-seed.bluematt.me."); // Just a static list of stable node(s), only supports x9
294 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
295
296 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
297 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
298 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
299 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
300 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
301
302 bech32_hrp = "tb";
303
304 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_test), std::end(chainparams_seed_test));
305
307 m_is_mockable_chain = false;
308
310 {
311 .height = 2'500'000,
312 .hash_serialized = AssumeutxoHash{uint256{"f841584909f68e47897952345234e37fcd9128cd818f41ee6c3ca68db8071be7"}},
313 .m_chain_tx_count = 66484552,
314 .blockhash = uint256{"0000000000000093bcb68c03a9a168ae252572d348a2eaeba2cdf9231d73206f"},
315 },
316 {
317 .height = 4'840'000,
318 .hash_serialized = AssumeutxoHash{uint256{"ce6bb677bb2ee9789c4a1c9d73e6683c53fc20e8fdbedbdaaf468982a0c8db2a"}},
319 .m_chain_tx_count = 536078574,
320 .blockhash = uint256{"00000000000000f4971a7fb37fbdff89315b69a2e1920c467654a382f0d64786"},
321 },
322 {
323 .height = 5'125'000,
324 .hash_serialized = AssumeutxoHash{uint256{"d05430f34c9b7dd7eb98c0718cdf03782bcce8273847557d68ac2efc1365d4b8"}},
325 .m_chain_tx_count = 536708663,
326 .blockhash = uint256{"00000000000009ad1946e21cb4f1a6323ee99c89017b59d5166472672b868133"},
327 }
328 };
329
331 // Data from RPC: getchaintxstats 4096 00000000b318a3703d14a844c55ef507f4c2fc8f8766e24271fd43c180c51637
332 .nTime = 1788932318,
333 .tx_count = 536748780,
334 .dTxRate = 0.02306697351149596,
335 };
336
337 // Generated by headerssync-params.py on 2026-09-08.
339 .commitment_period = 682,
340 .redownload_buffer_size = 14613, // 14613/682 = ~21.4 commitments
341 };
342 }
343};
344
349public:
352 consensus.signet_blocks = false;
362 consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
363 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
368
372 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
375
377
378 consensus.nMinimumChainWork = uint256{"000000000000000000000000000000000000000000000e346a558455ade8eca9"};
379 consensus.defaultAssumeValid = uint256{"0000000021df65b91665a342e26ceb05e54826ad7d8fcd40316230058fa3b865"}; // 151604
380
381 pchMessageStart[0] = 0x1c;
382 pchMessageStart[1] = 0x16;
383 pchMessageStart[2] = 0x3f;
384 pchMessageStart[3] = 0x28;
385 nDefaultPort = 48333;
386 nPruneAfterHeight = 1000;
389
390 const char* testnet4_genesis_msg = "03/May/2024 000000000000000000001ebd58c244970b3aa9d783bb001011fbe8ea8e98e00e";
391 const CScript testnet4_genesis_script = CScript() << "000000000000000000000000000000000000000000000000000000000000000000"_hex << OP_CHECKSIG;
392 genesis = CreateGenesisBlock(testnet4_genesis_msg,
393 testnet4_genesis_script,
394 1714777860,
395 393743547,
396 0x1d00ffff,
397 1,
398 50 * COIN);
400 assert(consensus.hashGenesisBlock == uint256{"00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043"});
401 assert(genesis.hashMerkleRoot == uint256{"7aa0a7ae1e223414cb807e40cd57e667b718e42aaf9306db9102fe28912b7b4e"});
402
403 vFixedSeeds.clear();
404 vSeeds.clear();
405 // nodes with support for servicebits filtering should be at the top
406 vSeeds.emplace_back("seed.testnet4.bitcoin.sprovoost.nl."); // Sjors Provoost
407 vSeeds.emplace_back("seed.testnet4.wiz.biz."); // Jason Maurice
408
409 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
410 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
411 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
412 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
413 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
414
415 bech32_hrp = "tb";
416
417 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_testnet4), std::end(chainparams_seed_testnet4));
418
420 m_is_mockable_chain = false;
421
423 {
424 .height = 90'000,
425 .hash_serialized = AssumeutxoHash{uint256{"784fb5e98241de66fdd429f4392155c9e7db5c017148e66e8fdbc95746f8b9b5"}},
426 .m_chain_tx_count = 11347043,
427 .blockhash = uint256{"0000000002ebe8bcda020e0dd6ccfbdfac531d2f6a81457191b99fc2df2dbe3b"},
428 },
429 {
430 .height = 120'000,
431 .hash_serialized = AssumeutxoHash{uint256{"10b05d05ad468d0971162e1b222a4aa66caca89da2bb2a93f8f37fb29c4794b0"}},
432 .m_chain_tx_count = 14141057,
433 .blockhash = uint256{"000000000bd2317e51b3c5794981c35ba894ce27d3e772d5c39ecd9cbce01dc8"},
434 },
435 {
436 .height = 150'000,
437 .hash_serialized = AssumeutxoHash{uint256{"ca068cae50679d7c947454bbe4f0e6aeec1fbe2c6c2735a08bb988623649f950"}},
438 .m_chain_tx_count = 14810011,
439 .blockhash = uint256{"0000000000d9877342754dea8ec1eb24631517d38e3443c370465ee53a8b7434"},
440 }
441 };
442
444 // Data from RPC: getchaintxstats 4096 0000000021df65b91665a342e26ceb05e54826ad7d8fcd40316230058fa3b865
445 .nTime = 1788932739,
446 .tx_count = 14825119,
447 .dTxRate = 0.1148250171344748,
448 };
449
450 // Generated by headerssync-params.py on 2026-09-08.
452 .commitment_period = 616,
453 .redownload_buffer_size = 16199, // 16199/616 = ~26.3 commitments
454 };
455 }
456};
457
462public:
463 explicit SigNetParams(const SigNetOptions& options)
464 {
465 std::vector<uint8_t> bin;
466 vFixedSeeds.clear();
467 vSeeds.clear();
468
469 if (!options.challenge) {
471 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_signet), std::end(chainparams_seed_signet));
472 vSeeds.emplace_back("seed.signet.bitcoin.sprovoost.nl.");
473 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
474
475 consensus.nMinimumChainWork = uint256{"00000000000000000000000000000000000000000000000000001090e9dc1520"};
476 consensus.defaultAssumeValid = uint256{"00000002a5e0ba0498f1e9f4591af0b66b63c654665efe65206fd0ae7bbaf923"}; // 321295
480 // Data from RPC: getchaintxstats 4096 00000002a5e0ba0498f1e9f4591af0b66b63c654665efe65206fd0ae7bbaf923
481 .nTime = 1788925860,
482 .tx_count = 32273793,
483 .dTxRate = 0.3977566114505673,
484 };
485 } else {
486 bin = *options.challenge;
492 0,
493 0,
494 0,
495 };
496 LogInfo("Signet with challenge %s", HexStr(bin));
497 }
498
499 if (options.seeds) {
500 vSeeds = *options.seeds;
501 }
502
505 consensus.signet_challenge.assign(bin.begin(), bin.end());
513 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
516 consensus.enforce_BIP94 = false;
519 consensus.powLimit = uint256{"00000377ae000000000000000000000000000000000000000000000000000000"};
523 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
526
528
530
531 nDefaultPort = 38333;
532 nPruneAfterHeight = 1000;
533
534 genesis = CreateGenesisBlock(1598918400, 52613770, 0x1e0377ae, 1, 50 * COIN);
536 assert(consensus.hashGenesisBlock == uint256{"00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6"});
537 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
538
540 {
541 .height = 160'000,
542 .hash_serialized = AssumeutxoHash{uint256{"fe0a44309b74d6b5883d246cb419c6221bcccf0b308c9b59b7d70783dbdf928a"}},
543 .m_chain_tx_count = 2289496,
544 .blockhash = uint256{"0000003ca3c99aff040f2563c2ad8f8ec88bd0fd6b8f0895cfaf1ef90353a62c"},
545 },
546 {
547 .height = 290'000,
548 .hash_serialized = AssumeutxoHash{uint256{"97267e000b4b876800167e71b9123f1529d13b14308abec2888bbd2160d14545"}},
549 .m_chain_tx_count = 28547497,
550 .blockhash = uint256{"0000000577f2741bb30cd9d39d6d71b023afbeb9764f6260786a97969d5c9ac0"},
551 },
552 {
553 .height = 320'000,
554 .hash_serialized = AssumeutxoHash{uint256{"1aaf72ecb376cc16957fbb8d5d406bfd6e3165510e2fc83879b6d14cd20b4462"}},
555 .m_chain_tx_count = 32079110,
556 .blockhash = uint256{"0000000740ae66b284da84387dcfa14d7b1385b0bad482005ba4e770ea6c4b95"},
557 }
558 };
559
560 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
561 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
562 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
563 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
564 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
565
566 bech32_hrp = "tb";
567
569 m_is_mockable_chain = false;
570
571 // Generated by headerssync-params.py on 2026-09-08.
573 .commitment_period = 629,
574 .redownload_buffer_size = 15885, // 15885/629 = ~25.3 commitments
575 };
576 }
577};
578
584{
585public:
586 explicit CRegTestParams(const RegTestOptions& opts)
587 {
589 consensus.signet_blocks = false;
592 consensus.BIP34Height = 1; // Always active unless overridden
594 consensus.BIP65Height = 1; // Always active unless overridden
595 consensus.BIP66Height = 1; // Always active unless overridden
596 consensus.CSVHeight = 1; // Always active unless overridden
597 consensus.SegwitHeight = 0; // Always active unless overridden
599 consensus.powLimit = uint256{"7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
600 consensus.nPowTargetTimespan = 24 * 60 * 60; // one day
605
609 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
611 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 144; // Faster than normal for regtest (144 instead of 2016)
612
615
616 pchMessageStart[0] = 0xfa;
617 pchMessageStart[1] = 0xbf;
618 pchMessageStart[2] = 0xb5;
619 pchMessageStart[3] = 0xda;
620 nDefaultPort = 18444;
621 nPruneAfterHeight = opts.fastprune ? 100 : 1000;
624
626
627 genesis = CreateGenesisBlock(1296688602, 2, 0x207fffff, 1, 50 * COIN);
629 assert(consensus.hashGenesisBlock == uint256{"0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206"});
630 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
631
632 vFixedSeeds.clear();
633 vSeeds.clear();
634 vSeeds.emplace_back("dummySeed.invalid.");
635
637 m_is_mockable_chain = true;
638
640 { // For use by unit tests
641 .height = 110,
642 .hash_serialized = AssumeutxoHash{uint256{"86e9a1205b418b16dde3a18a78c730e30137e28466bda5dbf6b33ab8fc05447c"}},
643 .m_chain_tx_count = 111,
644 .blockhash = uint256{"135eec25a6fb277884e5824e7aa7d052c4868161c99a5122170b5266f86c273d"},
645 },
646 {
647 // For use by fuzz target src/test/fuzz/utxo_snapshot.cpp
648 .height = 200,
649 .hash_serialized = AssumeutxoHash{uint256{"17dcc016d188d16068907cdeb38b75691a118d43053b8cd6a25969419381d13a"}},
650 .m_chain_tx_count = 201,
651 .blockhash = uint256{"385901ccbd69dff6bbd00065d01fb8a9e464dede7cfe0372443884f9b1dcf6b9"},
652 },
653 {
654 // For use by test/functional/feature_assumeutxo.py and test/functional/tool_bitcoin_chainstate.py
655 .height = 299,
656 .hash_serialized = AssumeutxoHash{uint256{"106b2c56233e378a824cf0d5ff2be42ed32c72f1605c9be288d00942908a40ac"}},
657 .m_chain_tx_count = 334,
658 .blockhash = uint256{"0c552ced4721c249a389eb9b08cb8da261cd46f0e7b5f9d064d48f3113406853"},
659 },
660 };
661
663 .nTime = 0,
664 .tx_count = 0,
665 .dTxRate = 0.001, // Set a non-zero rate to make it testable
666 };
667
668 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
669 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
670 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
671 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
672 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
673
674 bech32_hrp = "bcrt";
675
676 // Copied from Testnet4.
678 .commitment_period = 275,
679 .redownload_buffer_size = 7017, // 7017/275 = ~25.5 commitments
680 };
681 }
682};
683
684std::unique_ptr<const CChainParams> CChainParams::SigNet(const SigNetOptions& options)
685{
686 return std::make_unique<const SigNetParams>(options);
687}
688
689std::unique_ptr<const CChainParams> CChainParams::RegTest(const RegTestOptions& options)
690{
691 return std::make_unique<const CRegTestParams>(options);
692}
693
694std::unique_ptr<const CChainParams> CChainParams::Main(const MainNetOptions& options)
695{
696 return std::make_unique<const CMainParams>(options);
697}
698
699std::unique_ptr<const CChainParams> CChainParams::TestNet(const TestNetOptions& options)
700{
701 return std::make_unique<const CTestNetParams>(options);
702}
703
704std::unique_ptr<const CChainParams> CChainParams::TestNet4(const TestNetOptions& options)
705{
706 return std::make_unique<const CTestNet4Params>(options);
707}
708
710{
711 std::vector<int> heights;
712 heights.reserve(m_assumeutxo_data.size());
713
714 for (const auto& data : m_assumeutxo_data) {
715 heights.emplace_back(data.height);
716 }
717 return heights;
718}
719
720std::optional<ChainType> GetNetworkForMagic(const MessageStartChars& message)
721{
722 const auto mainnet_msg = CChainParams::Main()->MessageStart();
723 const auto testnet_msg = CChainParams::TestNet()->MessageStart();
724 const auto testnet4_msg = CChainParams::TestNet4()->MessageStart();
725 const auto regtest_msg = CChainParams::RegTest()->MessageStart();
726 const auto signet_msg = CChainParams::SigNet()->MessageStart();
727
728 if (std::ranges::equal(message, mainnet_msg)) {
729 return ChainType::MAIN;
730 } else if (std::ranges::equal(message, testnet_msg)) {
731 return ChainType::TESTNET;
732 } else if (std::ranges::equal(message, testnet4_msg)) {
733 return ChainType::TESTNET4;
734 } else if (std::ranges::equal(message, regtest_msg)) {
735 return ChainType::REGTEST;
736 } else if (std::ranges::equal(message, signet_msg)) {
737 return ChainType::SIGNET;
738 }
739 return std::nullopt;
740}
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
constexpr CAmount COIN
The amount of satoshis in one BTC.
Definition: amount.h:15
constexpr uint8_t chainparams_seed_main[]
List of fixed seed nodes for the bitcoin network AUTOGENERATED by contrib/seeds/generate-seeds....
constexpr uint8_t chainparams_seed_test[]
constexpr uint8_t chainparams_seed_testnet4[]
constexpr uint8_t chainparams_seed_signet[]
uint32_t nNonce
Definition: block.h:35
uint32_t nBits
Definition: block.h:34
uint32_t nTime
Definition: block.h:33
int32_t nVersion
Definition: block.h:30
uint256 hashPrevBlock
Definition: block.h:31
uint256 hashMerkleRoot
Definition: block.h:32
uint256 GetHash() const
Definition: block.cpp:14
Definition: block.h:74
std::vector< CTransactionRef > vtx
Definition: block.h:77
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:77
static std::unique_ptr< const CChainParams > TestNet4()
Definition: chainparams.h:179
uint64_t m_assumed_chain_state_size
Definition: chainparams.h:189
MessageStartChars pchMessageStart
Definition: chainparams.h:185
static std::unique_ptr< const CChainParams > Main()
Definition: chainparams.h:175
std::string bech32_hrp
Definition: chainparams.h:192
std::vector< int > GetAvailableSnapshotHeights() const
void ApplyDeploymentOptions(const DeploymentOptions &opts)
Definition: chainparams.cpp:76
CBlock genesis
Definition: chainparams.h:194
uint64_t m_assumed_blockchain_size
Definition: chainparams.h:188
std::vector< uint8_t > vFixedSeeds
Definition: chainparams.h:195
bool fDefaultConsistencyChecks
Definition: chainparams.h:196
HeadersSyncParams m_headers_sync_params
Definition: chainparams.h:200
std::vector< unsigned char > base58Prefixes[MAX_BASE58_TYPES]
Definition: chainparams.h:191
Consensus::Params consensus
Definition: chainparams.h:184
static std::unique_ptr< const CChainParams > TestNet()
Definition: chainparams.h:177
std::vector< AssumeutxoData > m_assumeutxo_data
Definition: chainparams.h:198
static std::unique_ptr< const CChainParams > SigNet()
Definition: chainparams.h:173
std::vector< std::string > vSeeds
Definition: chainparams.h:190
bool m_is_mockable_chain
Definition: chainparams.h:197
static std::unique_ptr< const CChainParams > RegTest()
Definition: chainparams.h:171
ChainType m_chain_type
Definition: chainparams.h:193
uint16_t nDefaultPort
Definition: chainparams.h:186
uint64_t nPruneAfterHeight
Definition: chainparams.h:187
ChainTxData chainTxData
Definition: chainparams.h:199
Main network on which people trade goods and services.
CMainParams(const MainNetOptions &opts)
Regression test: intended for private networks only.
CRegTestParams(const RegTestOptions &opts)
Serialized script, used inside transaction inputs and outputs.
Definition: script.h:406
Testnet (v4): public test network which is reset from time to time.
CTestNet4Params(const TestNetOptions &opts)
Testnet (v3): public test network which is reset from time to time.
CTestNetParams(const TestNetOptions &opts)
Signet: test network with an additional consensus parameter (see BIP325).
SigNetParams(const SigNetOptions &options)
constexpr void SetNull()
Definition: uint256.h:57
256-bit opaque blob.
Definition: uint256.h:196
static const PrecomputedData data
Precomputed COutPoint and CCoins values.
uint256 BlockMerkleRoot(const CBlock &block, bool *mutated)
Definition: merkle.cpp:76
std::string HexStr(const std::span< const uint8_t > s)
Convert a span of bytes to a lower-case hexadecimal string.
Definition: hex_base.cpp:30
constexpr script_verify_flags SCRIPT_VERIFY_NONE
Script verification flags.
Definition: interpreter.h:48
static CBlock CreateGenesisBlock(const char *pszTimestamp, const CScript &genesisOutputScript, uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount &genesisReward)
Definition: chainparams.cpp:37
std::optional< ChainType > GetNetworkForMagic(const MessageStartChars &message)
#define LogInfo(...)
Definition: log.h:125
std::array< uint8_t, 4 > MessageStartChars
@ DEPLOYMENT_TESTDUMMY
Definition: params.h:39
@ DEPLOYMENT_DERSIG
Definition: params.h:30
@ DEPLOYMENT_CSV
Definition: params.h:31
@ DEPLOYMENT_SEGWIT
Definition: params.h:34
@ DEPLOYMENT_HEIGHTINCB
Definition: params.h:28
@ DEPLOYMENT_CLTV
Definition: params.h:29
MessageStartChars GetSignetMessageStart(const std::vector< uint8_t > &signet_challenge)
Return the message start bytes for a signet: the first four bytes of the double-SHA256 hash of the se...
Definition: signet.h:27
const std::vector< uint8_t > SIGNET_DEFAULT_CHALLENGE
Definition: signet.h:20
""_hex is a compile-time user-defined literal returning a std::array<std::byte>, equivalent to ParseH...
Definition: strencodings.h:386
static CTransactionRef MakeTransactionRef(Tx &&txIn)
Definition: transaction.h:418
@ OP_CHECKSIG
Definition: script.h:191
std::unordered_map< Consensus::BuriedDeployment, int > activation_heights
Definition: chainparams.h:141
std::unordered_map< Consensus::DeploymentPos, VersionBitsParameters > version_bits_parameters
Definition: chainparams.h:140
DeploymentOptions dep_opts
Definition: chainparams.h:163
RegTestOptions holds configurations for creating a regtest CChainParams.
Definition: chainparams.h:156
DeploymentOptions dep_opts
Definition: chainparams.h:157
SigNetOptions holds configurations for creating a signet CChainParams.
Definition: chainparams.h:147
DeploymentOptions dep_opts
Definition: chainparams.h:148
std::optional< std::vector< uint8_t > > challenge
Definition: chainparams.h:149
std::optional< std::vector< std::string > > seeds
Definition: chainparams.h:150
DeploymentOptions dep_opts
Definition: chainparams.h:167
A mutable version of CTransaction.
Definition: transaction.h:372
std::vector< CTxOut > vout
Definition: transaction.h:374
std::vector< CTxIn > vin
Definition: transaction.h:373
Holds various statistics on transactions within a chain.
Definition: chainparams.h:57
int64_t nTime
UNIX timestamp of last known number of transactions.
Definition: chainparams.h:58
static constexpr int64_t NEVER_ACTIVE
Special value for nStartTime indicating that the deployment is never active.
Definition: params.h:82
static constexpr int64_t NO_TIMEOUT
Constant for nTimeout very far in the future.
Definition: params.h:71
bool enforce_BIP94
Enforce BIP94 timewarp attack mitigation.
Definition: params.h:122
int BIP65Height
Block height at which BIP65 becomes active.
Definition: params.h:102
int CSVHeight
Block height at which CSV (BIP68, BIP112 and BIP113) becomes active.
Definition: params.h:106
uint256 BIP34Hash
Definition: params.h:100
uint256 defaultAssumeValid
By default assume that the signatures in ancestors of this block are valid.
Definition: params.h:134
std::vector< uint8_t > signet_challenge
Definition: params.h:141
bool signet_blocks
If true, witness commitments contain a payload equal to a Bitcoin Script solution to the signet chall...
Definition: params.h:140
int SegwitHeight
Block height at which Segwit (BIP141, BIP143 and BIP147) becomes active.
Definition: params.h:110
int BIP34Height
Block height and hash at which BIP34 becomes active.
Definition: params.h:99
int nSubsidyHalvingInterval
Definition: params.h:90
std::map< uint256, script_verify_flags > script_flag_exceptions
Hashes of blocks that.
Definition: params.h:97
uint256 hashGenesisBlock
Definition: params.h:89
int MinBIP9WarningHeight
Don't warn about unknown BIP 9 activations below this height.
Definition: params.h:113
bool fPowNoRetargeting
Definition: params.h:123
uint256 nMinimumChainWork
The best chain should have at least this much work.
Definition: params.h:132
int64_t nPowTargetTimespan
Definition: params.h:125
int BIP66Height
Block height at which BIP66 becomes active.
Definition: params.h:104
uint256 powLimit
Proof of work parameters.
Definition: params.h:116
std::array< BIP9Deployment, MAX_VERSION_BITS_DEPLOYMENTS > vDeployments
Definition: params.h:114
int64_t nPowTargetSpacing
Definition: params.h:124
bool fPowAllowMinDifficultyBlocks
Definition: params.h:117
Configuration for headers sync memory usage.
Definition: chainparams.h:64
size_t commitment_period
Distance in blocks between header commitments.
Definition: chainparams.h:66
assert(!tx.IsCoinBase())