Bitcoin Core 31.0.0
P2P Digital Currency
Loading...
Searching...
No Matches
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>
13#include <hash.h>
15#include <primitives/block.h>
17#include <script/interpreter.h>
18#include <script/script.h>
19#include <uint256.h>
20#include <util/chaintype.h>
21#include <util/log.h>
22#include <util/strencodings.h>
23
24#include <algorithm>
25#include <array>
26#include <cassert>
27#include <cstdint>
28#include <cstring>
29#include <iterator>
30#include <map>
31#include <span>
32#include <utility>
33
34using namespace util::hex_literals;
35
36static CBlock CreateGenesisBlock(const char* pszTimestamp, const CScript& genesisOutputScript, uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
37{
39 txNew.version = 1;
40 txNew.vin.resize(1);
41 txNew.vout.resize(1);
42 txNew.vin[0].scriptSig = CScript() << 486604799 << CScriptNum(4) << std::vector<unsigned char>((const unsigned char*)pszTimestamp, (const unsigned char*)pszTimestamp + strlen(pszTimestamp));
43 txNew.vout[0].nValue = genesisReward;
44 txNew.vout[0].scriptPubKey = genesisOutputScript;
45
46 CBlock genesis;
47 genesis.nTime = nTime;
48 genesis.nBits = nBits;
49 genesis.nNonce = nNonce;
50 genesis.nVersion = nVersion;
51 genesis.vtx.push_back(MakeTransactionRef(std::move(txNew)));
52 genesis.hashPrevBlock.SetNull();
53 genesis.hashMerkleRoot = BlockMerkleRoot(genesis);
54 return genesis;
55}
56
68static CBlock CreateGenesisBlock(uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
69{
70 const char* pszTimestamp = "The Times 03/Jan/2009 Chancellor on brink of second bailout for banks";
71 const CScript genesisOutputScript = CScript() << "04678afdb0fe5548271967f1a67130b7105cd6a828e03909a67962e0ea1f61deb649f6bc3f4cef38c4f35504e51ec112de5c384df7ba0b8d578a4c702b6bf11d5f"_hex << OP_CHECKSIG;
72 return CreateGenesisBlock(pszTimestamp, genesisOutputScript, nTime, nNonce, nBits, nVersion, genesisReward);
73}
74
78class CMainParams : public CChainParams {
79public:
82 consensus.signet_blocks = false;
83 consensus.signet_challenge.clear();
84 consensus.nSubsidyHalvingInterval = 210000;
85 consensus.script_flag_exceptions.emplace( // BIP16 exception
86 uint256{"00000000000002dc756eebf4f49723ed8d30cc28a5f108eb94b1ba88ac4f9c22"}, SCRIPT_VERIFY_NONE);
87 consensus.script_flag_exceptions.emplace( // Taproot exception
88 uint256{"0000000000000000000f14c35b2d841e986ab5441de8c585d5ffe55ea1e395ad"}, SCRIPT_VERIFY_P2SH | SCRIPT_VERIFY_WITNESS);
89 consensus.BIP34Height = 227931;
90 consensus.BIP34Hash = uint256{"000000000000024b89b42a942fe0d9fea3bb44ab7bd1b19115dd6a759c0808b8"};
91 consensus.BIP65Height = 388381; // 000000000000000004c2b624ed5d7756c508d90fd0da2c7c679febfa6c4735f0
92 consensus.BIP66Height = 363725; // 00000000000000000379eaa19dce8c9b722d46ae6a57c2f1a988119488b50931
93 consensus.CSVHeight = 419328; // 000000000000000004a1b34462cb8aeebd5799177f7a29cf28f2d1961716b5b5
94 consensus.SegwitHeight = 481824; // 0000000000000000001c8018d9cb3b742ef25114f27563e3fc4a1902167f9893
95 consensus.MinBIP9WarningHeight = 483840; // segwit activation height + miner confirmation window
96 consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
97 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
98 consensus.nPowTargetSpacing = 10 * 60;
99 consensus.fPowAllowMinDifficultyBlocks = false;
100 consensus.enforce_BIP94 = false;
101 consensus.fPowNoRetargeting = false;
102 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
105 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
106 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1815; // 90%
107 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
108
109 // Deployment of Taproot (BIPs 340-342)
110 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].bit = 2;
111 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nStartTime = 1619222400; // April 24th, 2021
112 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nTimeout = 1628640000; // August 11th, 2021
113 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].min_activation_height = 709632; // Approximately November 12th, 2021
114 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].threshold = 1815; // 90%
115 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].period = 2016;
116
117 consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000001128750f82f4c366153a3a030"};
118 consensus.defaultAssumeValid = uint256{"00000000000000000000ccebd6d74d9194d8dcdc1d177c478e094bfad51ba5ac"}; // 938343
119
125 pchMessageStart[0] = 0xf9;
126 pchMessageStart[1] = 0xbe;
127 pchMessageStart[2] = 0xb4;
128 pchMessageStart[3] = 0xd9;
129 nDefaultPort = 8333;
130 nPruneAfterHeight = 100000;
133
134 genesis = CreateGenesisBlock(1231006505, 2083236893, 0x1d00ffff, 1, 50 * COIN);
135 consensus.hashGenesisBlock = genesis.GetHash();
136 assert(consensus.hashGenesisBlock == uint256{"000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"});
137 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
138
139 // Note that of those which support the service bits prefix, most only support a subset of
140 // possible options.
141 // This is fine at runtime as we'll fall back to using them as an addrfetch if they don't support the
142 // service bits we want, but we should get them updated to support all service bits wanted by any
143 // release ASAP to avoid it where possible.
144 vSeeds.emplace_back("seed.bitcoin.sipa.be."); // Pieter Wuille, only supports x1, x5, x9, and xd
145 vSeeds.emplace_back("dnsseed.bluematt.me."); // Matt Corallo, only supports x9
146 vSeeds.emplace_back("seed.bitcoin.jonasschnelli.ch."); // Jonas Schnelli, only supports x1, x5, x9, and xd
147 vSeeds.emplace_back("seed.btc.petertodd.net."); // Peter Todd, only supports x1, x5, x9, and xd
148 vSeeds.emplace_back("seed.bitcoin.sprovoost.nl."); // Sjors Provoost
149 vSeeds.emplace_back("dnsseed.emzy.de."); // Stephan Oeste
150 vSeeds.emplace_back("seed.bitcoin.wiz.biz."); // Jason Maurice
151 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
152
153 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,0);
154 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,5);
155 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,128);
156 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x88, 0xB2, 0x1E};
157 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x88, 0xAD, 0xE4};
158
159 bech32_hrp = "bc";
160
161 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_main), std::end(chainparams_seed_main));
162
164 m_is_mockable_chain = false;
165
167 {
168 .height = 840'000,
169 .hash_serialized = AssumeutxoHash{uint256{"a2a5521b1b5ab65f67818e5e8eccabb7171a517f9e2382208f77687310768f96"}},
170 .m_chain_tx_count = 991032194,
171 .blockhash = uint256{"0000000000000000000320283a032748cef8227873ff4872689bf23f1cda83a5"},
172 },
173 {
174 .height = 880'000,
175 .hash_serialized = AssumeutxoHash{uint256{"dbd190983eaf433ef7c15f78a278ae42c00ef52e0fd2a54953782175fbadcea9"}},
176 .m_chain_tx_count = 1145604538,
177 .blockhash = uint256{"000000000000000000010b17283c3c400507969a9c2afd1dcf2082ec5cca2880"},
178 },
179 {
180 .height = 910'000,
181 .hash_serialized = AssumeutxoHash{uint256{"4daf8a17b4902498c5787966a2b51c613acdab5df5db73f196fa59a4da2f1568"}},
182 .m_chain_tx_count = 1226586151,
183 .blockhash = uint256{"0000000000000000000108970acb9522ffd516eae17acddcb1bd16469194a821"},
184 },
185 {
186 .height = 935'000,
187 .hash_serialized = AssumeutxoHash{uint256{"e4b90ef9eae834f56c4b64d2d50143cee10ad87994c614d7d04125e2a6025050"}},
188 .m_chain_tx_count = 1305397408,
189 .blockhash = uint256{"0000000000000000000147034958af1652b2b91bba607beacc5e72a56f0fb5ee"},
190 }
191 };
192
194 // Data from RPC: getchaintxstats 4096 00000000000000000000ccebd6d74d9194d8dcdc1d177c478e094bfad51ba5ac
195 .nTime = 1772055173,
196 .tx_count = 1315805869,
197 .dTxRate = 5.40111006496122,
198 };
199
200 // Generated by headerssync-params.py on 2026-02-25.
202 .commitment_period = 641,
203 .redownload_buffer_size = 15218, // 15218/641 = ~23.7 commitments
204 };
205 }
206};
207
212public:
215 consensus.signet_blocks = false;
216 consensus.signet_challenge.clear();
217 consensus.nSubsidyHalvingInterval = 210000;
218 consensus.script_flag_exceptions.emplace( // BIP16 exception
219 uint256{"00000000dd30457c001f4095d208cc1296b0eed002427aa599874af7a432b105"}, SCRIPT_VERIFY_NONE);
220 consensus.BIP34Height = 21111;
221 consensus.BIP34Hash = uint256{"0000000023b3a96d3484e5abb3755c413e7d41500f8e2a5c3f0dd01299cd8ef8"};
222 consensus.BIP65Height = 581885; // 00000000007f6655f22f98e72ed80d8b06dc761d5da09df0fa1dc4be4f861eb6
223 consensus.BIP66Height = 330776; // 000000002104c8c45e99a8853285a3b592602a3ccde2b832481da85e9e4ba182
224 consensus.CSVHeight = 770112; // 00000000025e930139bac5c6c31a403776da130831ab85be56578f3fa75369bb
225 consensus.SegwitHeight = 834624; // 00000000002b980fcd729daaa248fd9316a5200e9b367f4ff2c42453e84201ca
226 consensus.MinBIP9WarningHeight = 836640; // segwit activation height + miner confirmation window
227 consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
228 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
229 consensus.nPowTargetSpacing = 10 * 60;
230 consensus.fPowAllowMinDifficultyBlocks = true;
231 consensus.enforce_BIP94 = false;
232 consensus.fPowNoRetargeting = false;
233 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
236 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
237 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1512; // 75%
238 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
239
240 // Deployment of Taproot (BIPs 340-342)
241 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].bit = 2;
242 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nStartTime = 1619222400; // April 24th, 2021
243 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nTimeout = 1628640000; // August 11th, 2021
244 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].min_activation_height = 0; // No activation delay
245 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].threshold = 1512; // 75%
246 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].period = 2016;
247
248 consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000000000017dde1c649f3708d14b6"};
249 consensus.defaultAssumeValid = uint256{"000000007a61e4230b28ac5cb6b5e5a0130de37ac1faf2f8987d2fa6505b67f4"}; // 4842348
250
251 pchMessageStart[0] = 0x0b;
252 pchMessageStart[1] = 0x11;
253 pchMessageStart[2] = 0x09;
254 pchMessageStart[3] = 0x07;
255 nDefaultPort = 18333;
256 nPruneAfterHeight = 1000;
259
260 genesis = CreateGenesisBlock(1296688602, 414098458, 0x1d00ffff, 1, 50 * COIN);
261 consensus.hashGenesisBlock = genesis.GetHash();
262 assert(consensus.hashGenesisBlock == uint256{"000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943"});
263 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
264
265 vFixedSeeds.clear();
266 vSeeds.clear();
267 // nodes with support for servicebits filtering should be at the top
268 vSeeds.emplace_back("testnet-seed.bitcoin.jonasschnelli.ch.");
269 vSeeds.emplace_back("seed.tbtc.petertodd.net.");
270 vSeeds.emplace_back("seed.testnet.bitcoin.sprovoost.nl.");
271 vSeeds.emplace_back("testnet-seed.bluematt.me."); // Just a static list of stable node(s), only supports x9
272 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
273
274 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
275 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
276 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
277 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
278 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
279
280 bech32_hrp = "tb";
281
282 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_test), std::end(chainparams_seed_test));
283
285 m_is_mockable_chain = false;
286
288 {
289 .height = 2'500'000,
290 .hash_serialized = AssumeutxoHash{uint256{"f841584909f68e47897952345234e37fcd9128cd818f41ee6c3ca68db8071be7"}},
291 .m_chain_tx_count = 66484552,
292 .blockhash = uint256{"0000000000000093bcb68c03a9a168ae252572d348a2eaeba2cdf9231d73206f"},
293 },
294 {
295 .height = 4'840'000,
296 .hash_serialized = AssumeutxoHash{uint256{"ce6bb677bb2ee9789c4a1c9d73e6683c53fc20e8fdbedbdaaf468982a0c8db2a"}},
297 .m_chain_tx_count = 536078574,
298 .blockhash = uint256{"00000000000000f4971a7fb37fbdff89315b69a2e1920c467654a382f0d64786"},
299 }
300 };
301
303 // Data from RPC: getchaintxstats 4096 000000007a61e4230b28ac5cb6b5e5a0130de37ac1faf2f8987d2fa6505b67f4
304 .nTime = 1772051651,
305 .tx_count = 536108416,
306 .dTxRate = 0.02691479016257117,
307 };
308
309 // Generated by headerssync-params.py on 2026-02-25.
311 .commitment_period = 673,
312 .redownload_buffer_size = 14460, // 14460/673 = ~21.5 commitments
313 };
314 }
315};
316
321public:
324 consensus.signet_blocks = false;
325 consensus.signet_challenge.clear();
326 consensus.nSubsidyHalvingInterval = 210000;
327 consensus.BIP34Height = 1;
328 consensus.BIP34Hash = uint256{};
329 consensus.BIP65Height = 1;
330 consensus.BIP66Height = 1;
331 consensus.CSVHeight = 1;
332 consensus.SegwitHeight = 1;
333 consensus.MinBIP9WarningHeight = 0;
334 consensus.powLimit = uint256{"00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
335 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
336 consensus.nPowTargetSpacing = 10 * 60;
337 consensus.fPowAllowMinDifficultyBlocks = true;
338 consensus.enforce_BIP94 = true;
339 consensus.fPowNoRetargeting = false;
340
341 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
344 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
345 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1512; // 75%
346 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
347
348 // Deployment of Taproot (BIPs 340-342)
349 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].bit = 2;
352 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].min_activation_height = 0; // No activation delay
353 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].threshold = 1512; // 75%
354 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].period = 2016;
355
356 consensus.nMinimumChainWork = uint256{"0000000000000000000000000000000000000000000009a0fe15d0177d086304"};
357 consensus.defaultAssumeValid = uint256{"0000000002368b1e4ee27e2e85676ae6f9f9e69579b29093e9a82c170bf7cf8a"}; // 123613
358
359 pchMessageStart[0] = 0x1c;
360 pchMessageStart[1] = 0x16;
361 pchMessageStart[2] = 0x3f;
362 pchMessageStart[3] = 0x28;
363 nDefaultPort = 48333;
364 nPruneAfterHeight = 1000;
367
368 const char* testnet4_genesis_msg = "03/May/2024 000000000000000000001ebd58c244970b3aa9d783bb001011fbe8ea8e98e00e";
369 const CScript testnet4_genesis_script = CScript() << "000000000000000000000000000000000000000000000000000000000000000000"_hex << OP_CHECKSIG;
370 genesis = CreateGenesisBlock(testnet4_genesis_msg,
371 testnet4_genesis_script,
372 1714777860,
373 393743547,
374 0x1d00ffff,
375 1,
376 50 * COIN);
377 consensus.hashGenesisBlock = genesis.GetHash();
378 assert(consensus.hashGenesisBlock == uint256{"00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043"});
379 assert(genesis.hashMerkleRoot == uint256{"7aa0a7ae1e223414cb807e40cd57e667b718e42aaf9306db9102fe28912b7b4e"});
380
381 vFixedSeeds.clear();
382 vSeeds.clear();
383 // nodes with support for servicebits filtering should be at the top
384 vSeeds.emplace_back("seed.testnet4.bitcoin.sprovoost.nl."); // Sjors Provoost
385 vSeeds.emplace_back("seed.testnet4.wiz.biz."); // Jason Maurice
386
387 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
388 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
389 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
390 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
391 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
392
393 bech32_hrp = "tb";
394
395 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_testnet4), std::end(chainparams_seed_testnet4));
396
398 m_is_mockable_chain = false;
399
401 {
402 .height = 90'000,
403 .hash_serialized = AssumeutxoHash{uint256{"784fb5e98241de66fdd429f4392155c9e7db5c017148e66e8fdbc95746f8b9b5"}},
404 .m_chain_tx_count = 11347043,
405 .blockhash = uint256{"0000000002ebe8bcda020e0dd6ccfbdfac531d2f6a81457191b99fc2df2dbe3b"},
406 },
407 {
408 .height = 120'000,
409 .hash_serialized = AssumeutxoHash{uint256{"10b05d05ad468d0971162e1b222a4aa66caca89da2bb2a93f8f37fb29c4794b0"}},
410 .m_chain_tx_count = 14141057,
411 .blockhash = uint256{"000000000bd2317e51b3c5794981c35ba894ce27d3e772d5c39ecd9cbce01dc8"},
412 }
413 };
414
416 // Data from RPC: getchaintxstats 4096 0000000002368b1e4ee27e2e85676ae6f9f9e69579b29093e9a82c170bf7cf8a
417 .nTime = 1772013387,
418 .tx_count = 14191421,
419 .dTxRate = 0.01848579579528412,
420 };
421
422 // Generated by headerssync-params.py on 2026-02-25.
424 .commitment_period = 606,
425 .redownload_buffer_size = 16092, // 16092/606 = ~26.6 commitments
426 };
427 }
428};
429
434public:
435 explicit SigNetParams(const SigNetOptions& options)
436 {
437 std::vector<uint8_t> bin;
438 vFixedSeeds.clear();
439 vSeeds.clear();
440
441 if (!options.challenge) {
442 bin = "512103ad5e0edad18cb1f0fc0d28a3d4f1f3e445640337489abb10404f2d1e086be430210359ef5021964fe22d6f8e05b2463c9540ce96883fe3b278760f048f5189f2e6c452ae"_hex_v_u8;
443 vFixedSeeds = std::vector<uint8_t>(std::begin(chainparams_seed_signet), std::end(chainparams_seed_signet));
444 vSeeds.emplace_back("seed.signet.bitcoin.sprovoost.nl.");
445 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
446
447 consensus.nMinimumChainWork = uint256{"00000000000000000000000000000000000000000000000000000b463ea0a4b8"};
448 consensus.defaultAssumeValid = uint256{"00000008414aab61092ef93f1aacc54cf9e9f16af29ddad493b908a01ff5c329"}; // 293175
452 // Data from RPC: getchaintxstats 4096 00000008414aab61092ef93f1aacc54cf9e9f16af29ddad493b908a01ff5c329
453 .nTime = 1772055248,
454 .tx_count = 28676833,
455 .dTxRate = 0.06736623436338929,
456 };
457 } else {
458 bin = *options.challenge;
459 consensus.nMinimumChainWork = uint256{};
460 consensus.defaultAssumeValid = uint256{};
464 0,
465 0,
466 0,
467 };
468 LogInfo("Signet with challenge %s", HexStr(bin));
469 }
470
471 if (options.seeds) {
472 vSeeds = *options.seeds;
473 }
474
476 consensus.signet_blocks = true;
477 consensus.signet_challenge.assign(bin.begin(), bin.end());
478 consensus.nSubsidyHalvingInterval = 210000;
479 consensus.BIP34Height = 1;
480 consensus.BIP34Hash = uint256{};
481 consensus.BIP65Height = 1;
482 consensus.BIP66Height = 1;
483 consensus.CSVHeight = 1;
484 consensus.SegwitHeight = 1;
485 consensus.nPowTargetTimespan = 14 * 24 * 60 * 60; // two weeks
486 consensus.nPowTargetSpacing = 10 * 60;
487 consensus.fPowAllowMinDifficultyBlocks = false;
488 consensus.enforce_BIP94 = false;
489 consensus.fPowNoRetargeting = false;
490 consensus.MinBIP9WarningHeight = 0;
491 consensus.powLimit = uint256{"00000377ae000000000000000000000000000000000000000000000000000000"};
492 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
495 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
496 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 1815; // 90%
497 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 2016;
498
499 // Activation of Taproot (BIPs 340-342)
500 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].bit = 2;
503 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].min_activation_height = 0; // No activation delay
504 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].threshold = 1815; // 90%
505 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].period = 2016;
506
507 // message start is defined as the first 4 bytes of the sha256d of the block script
508 HashWriter h{};
509 h << consensus.signet_challenge;
510 uint256 hash = h.GetHash();
511 std::copy_n(hash.begin(), 4, pchMessageStart.begin());
512
513 nDefaultPort = 38333;
514 nPruneAfterHeight = 1000;
515
516 genesis = CreateGenesisBlock(1598918400, 52613770, 0x1e0377ae, 1, 50 * COIN);
517 consensus.hashGenesisBlock = genesis.GetHash();
518 assert(consensus.hashGenesisBlock == uint256{"00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6"});
519 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
520
522 {
523 .height = 160'000,
524 .hash_serialized = AssumeutxoHash{uint256{"fe0a44309b74d6b5883d246cb419c6221bcccf0b308c9b59b7d70783dbdf928a"}},
525 .m_chain_tx_count = 2289496,
526 .blockhash = uint256{"0000003ca3c99aff040f2563c2ad8f8ec88bd0fd6b8f0895cfaf1ef90353a62c"},
527 },
528 {
529 .height = 290'000,
530 .hash_serialized = AssumeutxoHash{uint256{"97267e000b4b876800167e71b9123f1529d13b14308abec2888bbd2160d14545"}},
531 .m_chain_tx_count = 28547497,
532 .blockhash = uint256{"0000000577f2741bb30cd9d39d6d71b023afbeb9764f6260786a97969d5c9ac0"},
533 }
534 };
535
536 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
537 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
538 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
539 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
540 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
541
542 bech32_hrp = "tb";
543
545 m_is_mockable_chain = false;
546
547 // Generated by headerssync-params.py on 2026-02-25.
549 .commitment_period = 620,
550 .redownload_buffer_size = 15724, // 15724/620 = ~25.4 commitments
551 };
552 }
553};
554
560{
561public:
562 explicit CRegTestParams(const RegTestOptions& opts)
563 {
565 consensus.signet_blocks = false;
566 consensus.signet_challenge.clear();
567 consensus.nSubsidyHalvingInterval = 150;
568 consensus.BIP34Height = 1; // Always active unless overridden
569 consensus.BIP34Hash = uint256();
570 consensus.BIP65Height = 1; // Always active unless overridden
571 consensus.BIP66Height = 1; // Always active unless overridden
572 consensus.CSVHeight = 1; // Always active unless overridden
573 consensus.SegwitHeight = 0; // Always active unless overridden
574 consensus.MinBIP9WarningHeight = 0;
575 consensus.powLimit = uint256{"7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"};
576 consensus.nPowTargetTimespan = 24 * 60 * 60; // one day
577 consensus.nPowTargetSpacing = 10 * 60;
578 consensus.fPowAllowMinDifficultyBlocks = true;
579 consensus.enforce_BIP94 = opts.enforce_bip94;
580 consensus.fPowNoRetargeting = true;
581
582 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].bit = 28;
583 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].nStartTime = 0;
585 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].min_activation_height = 0; // No activation delay
586 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].threshold = 108; // 75%
587 consensus.vDeployments[Consensus::DEPLOYMENT_TESTDUMMY].period = 144; // Faster than normal for regtest (144 instead of 2016)
588
589 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].bit = 2;
592 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].min_activation_height = 0; // No activation delay
593 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].threshold = 108; // 75%
594 consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].period = 144;
595
596 consensus.nMinimumChainWork = uint256{};
597 consensus.defaultAssumeValid = uint256{};
598
599 pchMessageStart[0] = 0xfa;
600 pchMessageStart[1] = 0xbf;
601 pchMessageStart[2] = 0xb5;
602 pchMessageStart[3] = 0xda;
603 nDefaultPort = 18444;
604 nPruneAfterHeight = opts.fastprune ? 100 : 1000;
607
608 for (const auto& [dep, height] : opts.activation_heights) {
609 switch (dep) {
611 consensus.SegwitHeight = int{height};
612 break;
614 consensus.BIP34Height = int{height};
615 break;
617 consensus.BIP66Height = int{height};
618 break;
620 consensus.BIP65Height = int{height};
621 break;
623 consensus.CSVHeight = int{height};
624 break;
625 }
626 }
627
628 for (const auto& [deployment_pos, version_bits_params] : opts.version_bits_parameters) {
629 consensus.vDeployments[deployment_pos].nStartTime = version_bits_params.start_time;
630 consensus.vDeployments[deployment_pos].nTimeout = version_bits_params.timeout;
631 consensus.vDeployments[deployment_pos].min_activation_height = version_bits_params.min_activation_height;
632 }
633
634 genesis = CreateGenesisBlock(1296688602, 2, 0x207fffff, 1, 50 * COIN);
635 consensus.hashGenesisBlock = genesis.GetHash();
636 assert(consensus.hashGenesisBlock == uint256{"0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206"});
637 assert(genesis.hashMerkleRoot == uint256{"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"});
638
639 vFixedSeeds.clear();
640 vSeeds.clear();
641 vSeeds.emplace_back("dummySeed.invalid.");
642
644 m_is_mockable_chain = true;
645
647 { // For use by unit tests
648 .height = 110,
649 .hash_serialized = AssumeutxoHash{uint256{"b952555c8ab81fec46f3d4253b7af256d766ceb39fb7752b9d18cdf4a0141327"}},
650 .m_chain_tx_count = 111,
651 .blockhash = uint256{"6affe030b7965ab538f820a56ef56c8149b7dc1d1c144af57113be080db7c397"},
652 },
653 {
654 // For use by fuzz target src/test/fuzz/utxo_snapshot.cpp
655 .height = 200,
656 .hash_serialized = AssumeutxoHash{uint256{"17dcc016d188d16068907cdeb38b75691a118d43053b8cd6a25969419381d13a"}},
657 .m_chain_tx_count = 201,
658 .blockhash = uint256{"385901ccbd69dff6bbd00065d01fb8a9e464dede7cfe0372443884f9b1dcf6b9"},
659 },
660 {
661 // For use by test/functional/feature_assumeutxo.py and test/functional/tool_bitcoin_chainstate.py
662 .height = 299,
663 .hash_serialized = AssumeutxoHash{uint256{"d2b051ff5e8eef46520350776f4100dd710a63447a8e01d917e92e79751a63e2"}},
664 .m_chain_tx_count = 334,
665 .blockhash = uint256{"7cc695046fec709f8c9394b6f928f81e81fd3ac20977bb68760fa1faa7916ea2"},
666 },
667 };
668
670 .nTime = 0,
671 .tx_count = 0,
672 .dTxRate = 0.001, // Set a non-zero rate to make it testable
673 };
674
675 base58Prefixes[PUBKEY_ADDRESS] = std::vector<unsigned char>(1,111);
676 base58Prefixes[SCRIPT_ADDRESS] = std::vector<unsigned char>(1,196);
677 base58Prefixes[SECRET_KEY] = std::vector<unsigned char>(1,239);
678 base58Prefixes[EXT_PUBLIC_KEY] = {0x04, 0x35, 0x87, 0xCF};
679 base58Prefixes[EXT_SECRET_KEY] = {0x04, 0x35, 0x83, 0x94};
680
681 bech32_hrp = "bcrt";
682
683 // Copied from Testnet4.
685 .commitment_period = 275,
686 .redownload_buffer_size = 7017, // 7017/275 = ~25.5 commitments
687 };
688 }
689};
690
691std::unique_ptr<const CChainParams> CChainParams::SigNet(const SigNetOptions& options)
692{
693 return std::make_unique<const SigNetParams>(options);
694}
695
696std::unique_ptr<const CChainParams> CChainParams::RegTest(const RegTestOptions& options)
697{
698 return std::make_unique<const CRegTestParams>(options);
699}
700
701std::unique_ptr<const CChainParams> CChainParams::Main()
702{
703 return std::make_unique<const CMainParams>();
704}
705
706std::unique_ptr<const CChainParams> CChainParams::TestNet()
707{
708 return std::make_unique<const CTestNetParams>();
709}
710
711std::unique_ptr<const CChainParams> CChainParams::TestNet4()
712{
713 return std::make_unique<const CTestNet4Params>();
714}
715
717{
718 std::vector<int> heights;
719 heights.reserve(m_assumeutxo_data.size());
720
721 for (const auto& data : m_assumeutxo_data) {
722 heights.emplace_back(data.height);
723 }
724 return heights;
725}
726
727std::optional<ChainType> GetNetworkForMagic(const MessageStartChars& message)
728{
729 const auto mainnet_msg = CChainParams::Main()->MessageStart();
730 const auto testnet_msg = CChainParams::TestNet()->MessageStart();
731 const auto testnet4_msg = CChainParams::TestNet4()->MessageStart();
732 const auto regtest_msg = CChainParams::RegTest({})->MessageStart();
733 const auto signet_msg = CChainParams::SigNet({})->MessageStart();
734
735 if (std::ranges::equal(message, mainnet_msg)) {
736 return ChainType::MAIN;
737 } else if (std::ranges::equal(message, testnet_msg)) {
738 return ChainType::TESTNET;
739 } else if (std::ranges::equal(message, testnet4_msg)) {
740 return ChainType::TESTNET4;
741 } else if (std::ranges::equal(message, regtest_msg)) {
742 return ChainType::REGTEST;
743 } else if (std::ranges::equal(message, signet_msg)) {
744 return ChainType::SIGNET;
745 }
746 return std::nullopt;
747}
int64_t CAmount
Amount in satoshis (Can be negative).
Definition amount.h:12
static constexpr CAmount COIN
The amount of satoshis in one BTC.
Definition amount.h:15
static const uint8_t chainparams_seed_test[]
static const uint8_t chainparams_seed_signet[]
static const uint8_t chainparams_seed_main[]
List of fixed seed nodes for the bitcoin network AUTOGENERATED by contrib/seeds/generate-seeds....
static const uint8_t chainparams_seed_testnet4[]
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
Definition block.h:74
std::vector< CTransactionRef > vtx
Definition block.h:77
uint64_t m_assumed_chain_state_size
MessageStartChars pchMessageStart
CChainParams()=default
static std::unique_ptr< const CChainParams > Main()
std::string bech32_hrp
std::vector< int > GetAvailableSnapshotHeights() const
static std::unique_ptr< const CChainParams > RegTest(const RegTestOptions &options)
uint64_t m_assumed_blockchain_size
std::vector< uint8_t > vFixedSeeds
bool fDefaultConsistencyChecks
HeadersSyncParams m_headers_sync_params
static std::unique_ptr< const CChainParams > TestNet()
std::vector< unsigned char > base58Prefixes[MAX_BASE58_TYPES]
Consensus::Params consensus
std::vector< AssumeutxoData > m_assumeutxo_data
std::vector< std::string > vSeeds
bool m_is_mockable_chain
static std::unique_ptr< const CChainParams > TestNet4()
ChainType m_chain_type
uint16_t nDefaultPort
static std::unique_ptr< const CChainParams > SigNet(const SigNetOptions &options)
uint64_t nPruneAfterHeight
ChainTxData chainTxData
CRegTestParams(const RegTestOptions &opts)
Serialized script, used inside transaction inputs and outputs.
Definition script.h:405
A writer stream (for serialization) that computes a 256-bit hash.
Definition hash.h:101
uint256 GetHash()
Compute the double-SHA256 hash of all data written to this object.
Definition hash.h:115
SigNetParams(const SigNetOptions &options)
constexpr unsigned char * begin()
Definition uint256.h:100
constexpr void SetNull()
Definition uint256.h:55
256-bit opaque blob.
Definition uint256.h:195
uint256 BlockMerkleRoot(const CBlock &block, bool *mutated)
Definition merkle.cpp:66
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
static constexpr script_verify_flags SCRIPT_VERIFY_NONE
Script verification flags.
Definition interpreter.h:47
static CBlock CreateGenesisBlock(const char *pszTimestamp, const CScript &genesisOutputScript, uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount &genesisReward)
std::optional< ChainType > GetNetworkForMagic(const MessageStartChars &message)
#define LogInfo(...)
Definition log.h:95
std::array< uint8_t, 4 > MessageStartChars
@ DEPLOYMENT_TAPROOT
Definition params.h:36
@ DEPLOYMENT_TESTDUMMY
Definition params.h:35
@ DEPLOYMENT_DERSIG
Definition params.h:28
@ DEPLOYMENT_CSV
Definition params.h:29
@ DEPLOYMENT_SEGWIT
Definition params.h:30
@ DEPLOYMENT_HEIGHTINCB
Definition params.h:26
@ DEPLOYMENT_CLTV
Definition params.h:27
""_hex is a compile-time user-defined literal returning a std::array<std::byte>, equivalent to ParseH...
static CTransactionRef MakeTransactionRef(Tx &&txIn)
@ OP_CHECKSIG
Definition script.h:190
RegTestOptions holds configurations for creating a regtest CChainParams.
std::unordered_map< Consensus::DeploymentPos, VersionBitsParameters > version_bits_parameters
std::unordered_map< Consensus::BuriedDeployment, int > activation_heights
SigNetOptions holds configurations for creating a signet CChainParams.
std::optional< std::vector< uint8_t > > challenge
std::optional< std::vector< std::string > > seeds
A mutable version of CTransaction.
std::vector< CTxOut > vout
std::vector< CTxIn > vin
Holds various statistics on transactions within a chain.
Definition chainparams.h:57
static constexpr int64_t ALWAYS_ACTIVE
Special value for nStartTime indicating that the deployment is always active.
Definition params.h:73
static constexpr int64_t NEVER_ACTIVE
Special value for nStartTime indicating that the deployment is never active.
Definition params.h:78
static constexpr int64_t NO_TIMEOUT
Constant for nTimeout very far in the future.
Definition params.h:67
Configuration for headers sync memory usage.
Definition chainparams.h:64
assert(!tx.IsCoinBase())