Inside Bitcoin
Opening the selected file…
Opening the selected file…
The code behind the network, with room to understand it.
Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.
1// Copyright (c) 2010 Satoshi Nakamoto2// Copyright (c) 2009-present The Bitcoin Core developers3// Distributed under the MIT software license, see the accompanying4// file COPYING or http://www.opensource.org/licenses/mit-license.php.6#include <chainparams.h>8#include <chainparamsbase.h>9#include <common/args.h>10#include <consensus/params.h>11#include <deploymentinfo.h>12#include <tinyformat.h>13#include <util/chaintype.h>14#include <util/log.h>15#include <util/strencodings.h>16#include <util/string.h>18#include <cassert>19#include <cstdint>20#include <limits>21#include <stdexcept>22#include <vector>24using util::SplitString;26static void HandleDeploymentArgs(const ArgsManager& args, CChainParams::DeploymentOptions& options)27{28for (const std::string& arg : args.GetArgs("-testactivationheight")) {29const auto found{arg.find('@')};30if (found == std::string::npos) {31throw std::runtime_error(strprintf("Invalid format (%s) for -testactivationheight=name@height.", arg));32}34const auto value{arg.substr(found + 1)};35const auto height{ToIntegral<int32_t>(value)};36if (!height || *height < 0 || *height >= std::numeric_limits<int>::max()) {37throw std::runtime_error(strprintf("Invalid height value (%s) for -testactivationheight=name@height.", arg));38}40const auto deployment_name{arg.substr(0, found)};41if (const auto buried_deployment = GetBuriedDeployment(deployment_name)) {42options.activation_heights[*buried_deployment] = *height;43} else {44throw std::runtime_error(strprintf("Invalid name (%s) for -testactivationheight=name@height.", arg));45}46}48for (const std::string& strDeployment : args.GetArgs("-vbparams")) {49std::vector<std::string> vDeploymentParams = SplitString(strDeployment, ':');50if (vDeploymentParams.size() < 3 || 4 < vDeploymentParams.size()) {51throw std::runtime_error("Version bits parameters malformed, expecting deployment:start:end[:min_activation_height]");52}53CChainParams::VersionBitsParameters vbparams{};54const auto start_time{ToIntegral<int64_t>(vDeploymentParams[1])};55if (!start_time) {56throw std::runtime_error(strprintf("Invalid nStartTime (%s)", vDeploymentParams[1]));57}58vbparams.start_time = *start_time;59const auto timeout{ToIntegral<int64_t>(vDeploymentParams[2])};60if (!timeout) {61throw std::runtime_error(strprintf("Invalid nTimeout (%s)", vDeploymentParams[2]));62}63vbparams.timeout = *timeout;64if (vDeploymentParams.size() >= 4) {65const auto min_activation_height{ToIntegral<int64_t>(vDeploymentParams[3])};66if (!min_activation_height) {67throw std::runtime_error(strprintf("Invalid min_activation_height (%s)", vDeploymentParams[3]));68}69vbparams.min_activation_height = *min_activation_height;70} else {71vbparams.min_activation_height = 0;72}73bool found = false;74for (int j=0; j < (int)Consensus::MAX_VERSION_BITS_DEPLOYMENTS; ++j) {75if (vDeploymentParams[0] == VersionBitsDeploymentInfo[j].name) {76options.version_bits_parameters[Consensus::DeploymentPos(j)] = vbparams;77found = true;78LogInfo("Setting version bits activation parameters for %s to start=%ld, timeout=%ld, min_activation_height=%d",79vDeploymentParams[0], vbparams.start_time, vbparams.timeout, vbparams.min_activation_height);80break;81}82}83if (!found) {84throw std::runtime_error(strprintf("Invalid deployment (%s)", vDeploymentParams[0]));85}86}87}89void ReadMainNetArgs(const ArgsManager& args, CChainParams::MainNetOptions& options)90{91HandleDeploymentArgs(args, options.dep_opts);92}94void ReadTestNetArgs(const ArgsManager& args, CChainParams::TestNetOptions& options)95{96HandleDeploymentArgs(args, options.dep_opts);97}99void ReadSigNetArgs(const ArgsManager& args, CChainParams::SigNetOptions& options)100{101if (!args.GetArgs("-signetseednode").empty()) {102options.seeds.emplace(args.GetArgs("-signetseednode"));103}104if (!args.GetArgs("-signetchallenge").empty()) {105const auto signet_challenge = args.GetArgs("-signetchallenge");106if (signet_challenge.size() != 1) {107throw std::runtime_error("-signetchallenge cannot be multiple values.");108}109const auto val{TryParseHex<uint8_t>(signet_challenge[0])};110if (!val) {111throw std::runtime_error(strprintf("-signetchallenge must be hex, not '%s'.", signet_challenge[0]));112}113options.challenge.emplace(*val);114}115HandleDeploymentArgs(args, options.dep_opts);116}118void ReadRegTestArgs(const ArgsManager& args, CChainParams::RegTestOptions& options)119{120if (auto value = args.GetBoolArg("-fastprune")) options.fastprune = *value;121if (HasTestOption(args, "bip94")) options.enforce_bip94 = true;123HandleDeploymentArgs(args, options.dep_opts);124}126static std::unique_ptr<const CChainParams> globalChainParams;128const CChainParams &Params() {129assert(globalChainParams);130return *globalChainParams;131}133std::unique_ptr<const CChainParams> CreateChainParams(const ArgsManager& args, const ChainType chain)134{135switch (chain) {136case ChainType::MAIN: {137auto opts = CChainParams::MainNetOptions{};138ReadMainNetArgs(args, opts);139return CChainParams::Main(opts);140}141case ChainType::TESTNET: {142auto opts = CChainParams::TestNetOptions{};143ReadTestNetArgs(args, opts);144return CChainParams::TestNet(opts);145}146case ChainType::TESTNET4: {147auto opts = CChainParams::TestNetOptions{};148ReadTestNetArgs(args, opts);149return CChainParams::TestNet4(opts);150}151case ChainType::SIGNET: {152auto opts = CChainParams::SigNetOptions{};153ReadSigNetArgs(args, opts);154return CChainParams::SigNet(opts);155}156case ChainType::REGTEST: {157auto opts = CChainParams::RegTestOptions{};158ReadRegTestArgs(args, opts);159return CChainParams::RegTest(opts);160}161}162assert(false);163}165void SelectParams(const ChainType chain)166{167SelectBaseParams(chain);168globalChainParams = CreateChainParams(gArgs, chain);169}