Bitcoin Core  31.0.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 
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>
15 #include <primitives/block.h>
16 #include <primitives/transaction.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 
34 using namespace util::hex_literals;
35 
36 static CBlock CreateGenesisBlock(const char* pszTimestamp, const CScript& genesisOutputScript, uint32_t nTime, uint32_t nNonce, uint32_t nBits, int32_t nVersion, const CAmount& genesisReward)
37 {
38  CMutableTransaction txNew;
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 
68 static 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 
78 class CMainParams : public CChainParams {
79 public:
81  m_chain_type = ChainType::MAIN;
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;
131  m_assumed_blockchain_size = 856;
132  m_assumed_chain_state_size = 14;
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 
163  fDefaultConsistencyChecks = false;
164  m_is_mockable_chain = false;
165 
166  m_assumeutxo_data = {
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 
193  chainTxData = ChainTxData{
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.
201  m_headers_sync_params = HeadersSyncParams{
202  .commitment_period = 641,
203  .redownload_buffer_size = 15218, // 15218/641 = ~23.7 commitments
204  };
205  }
206 };
207 
211 class CTestNetParams : public CChainParams {
212 public:
214  m_chain_type = ChainType::TESTNET;
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;
257  m_assumed_blockchain_size = 245;
258  m_assumed_chain_state_size = 19;
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 
284  fDefaultConsistencyChecks = false;
285  m_is_mockable_chain = false;
286 
287  m_assumeutxo_data = {
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 
302  chainTxData = ChainTxData{
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.
310  m_headers_sync_params = HeadersSyncParams{
311  .commitment_period = 673,
312  .redownload_buffer_size = 14460, // 14460/673 = ~21.5 commitments
313  };
314  }
315 };
316 
321 public:
323  m_chain_type = ChainType::TESTNET4;
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;
350  consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nStartTime = Consensus::BIP9Deployment::ALWAYS_ACTIVE;
351  consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
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;
365  m_assumed_blockchain_size = 31;
366  m_assumed_chain_state_size = 2;
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 
397  fDefaultConsistencyChecks = false;
398  m_is_mockable_chain = false;
399 
400  m_assumeutxo_data = {
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 
415  chainTxData = ChainTxData{
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.
423  m_headers_sync_params = HeadersSyncParams{
424  .commitment_period = 606,
425  .redownload_buffer_size = 16092, // 16092/606 = ~26.6 commitments
426  };
427  }
428 };
429 
433 class SigNetParams : public CChainParams {
434 public:
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
449  m_assumed_blockchain_size = 24;
450  m_assumed_chain_state_size = 4;
451  chainTxData = ChainTxData{
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{};
461  m_assumed_blockchain_size = 0;
462  m_assumed_chain_state_size = 0;
463  chainTxData = ChainTxData{
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 
475  m_chain_type = ChainType::SIGNET;
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;
501  consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nStartTime = Consensus::BIP9Deployment::ALWAYS_ACTIVE;
502  consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
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 
521  m_assumeutxo_data = {
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 
544  fDefaultConsistencyChecks = false;
545  m_is_mockable_chain = false;
546 
547  // Generated by headerssync-params.py on 2026-02-25.
548  m_headers_sync_params = HeadersSyncParams{
549  .commitment_period = 620,
550  .redownload_buffer_size = 15724, // 15724/620 = ~25.4 commitments
551  };
552  }
553 };
554 
560 {
561 public:
562  explicit CRegTestParams(const RegTestOptions& opts)
563  {
564  m_chain_type = ChainType::REGTEST;
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;
590  consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nStartTime = Consensus::BIP9Deployment::ALWAYS_ACTIVE;
591  consensus.vDeployments[Consensus::DEPLOYMENT_TAPROOT].nTimeout = Consensus::BIP9Deployment::NO_TIMEOUT;
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;
605  m_assumed_blockchain_size = 0;
606  m_assumed_chain_state_size = 0;
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 
643  fDefaultConsistencyChecks = true;
644  m_is_mockable_chain = true;
645 
646  m_assumeutxo_data = {
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 
669  chainTxData = ChainTxData{
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.
684  m_headers_sync_params = HeadersSyncParams{
685  .commitment_period = 275,
686  .redownload_buffer_size = 7017, // 7017/275 = ~25.5 commitments
687  };
688  }
689 };
690 
691 std::unique_ptr<const CChainParams> CChainParams::SigNet(const SigNetOptions& options)
692 {
693  return std::make_unique<const SigNetParams>(options);
694 }
695 
696 std::unique_ptr<const CChainParams> CChainParams::RegTest(const RegTestOptions& options)
697 {
698  return std::make_unique<const CRegTestParams>(options);
699 }
700 
701 std::unique_ptr<const CChainParams> CChainParams::Main()
702 {
703  return std::make_unique<const CMainParams>();
704 }
705 
706 std::unique_ptr<const CChainParams> CChainParams::TestNet()
707 {
708  return std::make_unique<const CTestNetParams>();
709 }
710 
711 std::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 
727 std::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 }
uint32_t nNonce
Definition: block.h:35
static constexpr int64_t NO_TIMEOUT
Constant for nTimeout very far in the future.
Definition: params.h:67
static std::unique_ptr< const CChainParams > TestNet4()
Main network on which people trade goods and services.
Definition: chainparams.cpp:78
assert(!tx.IsCoinBase())
std::unordered_map< Consensus::DeploymentPos, VersionBitsParameters > version_bits_parameters
Definition: chainparams.h:151
Definition: block.h:73
static const uint8_t chainparams_seed_testnet4[]
std::vector< CTxIn > vin
Definition: transaction.h:359
static constexpr int64_t ALWAYS_ACTIVE
Special value for nStartTime indicating that the deployment is always active.
Definition: params.h:73
static const uint8_t chainparams_seed_test[]
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system...
Definition: chainparams.h:76
int64_t nTime
UNIX timestamp of last known number of transactions.
Definition: chainparams.h:58
Testnet (v4): public test network which is reset from time to time.
uint32_t nTime
Definition: block.h:33
static std::unique_ptr< const CChainParams > Main()
static std::unique_ptr< const CChainParams > RegTest(const RegTestOptions &options)
constexpr unsigned char * begin()
Definition: uint256.h:100
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
std::array< uint8_t, 4 > MessageStartChars
Signet: test network with an additional consensus parameter (see BIP325).
std::vector< int > GetAvailableSnapshotHeights() const
static const uint8_t chainparams_seed_main[]
List of fixed seed nodes for the bitcoin network AUTOGENERATED by contrib/seeds/generate-seeds.py.
SigNetParams(const SigNetOptions &options)
uint256 hashMerkleRoot
Definition: block.h:32
static const uint8_t chainparams_seed_signet[]
#define LogInfo(...)
Definition: log.h:95
A writer stream (for serialization) that computes a 256-bit hash.
Definition: hash.h:100
Regression test: intended for private networks only.
uint256 hashPrevBlock
Definition: block.h:31
Holds various statistics on transactions within a chain.
Definition: chainparams.h:57
RegTestOptions holds configurations for creating a regtest CChainParams.
Definition: chainparams.h:150
uint256 BlockMerkleRoot(const CBlock &block, bool *mutated)
Definition: merkle.cpp:66
std::optional< std::vector< std::string > > seeds
Definition: chainparams.h:135
static constexpr int64_t NEVER_ACTIVE
Special value for nStartTime indicating that the deployment is never active.
Definition: params.h:78
size_t commitment_period
Distance in blocks between header commitments.
Definition: chainparams.h:66
""_hex is a compile-time user-defined literal returning a std::array<std::byte>, equivalent to ParseH...
Definition: strencodings.h:400
std::vector< CTxOut > vout
Definition: transaction.h:360
SigNetOptions holds configurations for creating a signet CChainParams.
Definition: chainparams.h:133
static CTransactionRef MakeTransactionRef(Tx &&txIn)
Definition: transaction.h:404
Testnet (v3): public test network which is reset from time to time.
256-bit opaque blob.
Definition: uint256.h:195
std::vector< CTransactionRef > vtx
Definition: block.h:77
std::unordered_map< Consensus::BuriedDeployment, int > activation_heights
Definition: chainparams.h:152
static std::unique_ptr< const CChainParams > SigNet(const SigNetOptions &options)
constexpr void SetNull()
Definition: uint256.h:55
static std::unique_ptr< const CChainParams > TestNet()
Configuration for headers sync memory usage.
Definition: chainparams.h:64
Serialized script, used inside transaction inputs and outputs.
Definition: script.h:404
std::optional< ChainType > GetNetworkForMagic(const MessageStartChars &message)
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:36
A mutable version of CTransaction.
Definition: transaction.h:357
std::optional< std::vector< uint8_t > > challenge
Definition: chainparams.h:134
CRegTestParams(const RegTestOptions &opts)
static constexpr script_verify_flags SCRIPT_VERIFY_NONE
Script verification flags.
Definition: interpreter.h:47
int32_t nVersion
Definition: block.h:30
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
uint32_t nBits
Definition: block.h:34
static constexpr CAmount COIN
The amount of satoshis in one BTC.
Definition: amount.h:15