6 #if defined(HAVE_CONFIG_H)
7 #include <config/bitcoin-config.h>
82 #include <boost/signals2/signal.hpp>
85 #include <chronik-cpp/chronik.h>
100 #include <condition_variable>
104 #include <functional>
136 #define MIN_CORE_FILEDESCRIPTORS 0
138 #define MIN_CORE_FILEDESCRIPTORS 150
164 std::strerror(errno)));
205 node.connman->Interrupt();
217 static Mutex g_shutdown_mutex;
218 TRY_LOCK(g_shutdown_mutex, lock_shutdown);
219 if (!lock_shutdown) {
222 LogPrintf(
"%s: In progress...\n", __func__);
231 node.mempool->AddTransactionsUpdated(1);
238 for (
const auto &client :
node.chain_clients) {
259 node.connman->Stop();
266 if (
node.scheduler) {
267 node.scheduler->stop();
269 if (
node.chainman &&
node.chainman->m_load_block.joinable()) {
270 node.chainman->m_load_block.join();
276 node.peerman.reset();
280 node.connman.reset();
282 node.addrman.reset();
284 if (
node.mempool &&
node.mempool->GetLoadTried() &&
294 if (chainstate->CanFlushToDisk()) {
295 chainstate->ForceFlushStateToDisk();
329 if (chainstate->CanFlushToDisk()) {
330 chainstate->ForceFlushStateToDisk();
331 chainstate->ResetCoinsViews();
335 for (
const auto &client :
node.chain_clients) {
347 node.chain_clients.clear();
351 node.mempool.reset();
352 node.chainman.reset();
353 node.scheduler.reset();
357 LogPrintf(
"%s: Unable to remove PID file: File does not exist\n",
360 }
catch (
const fs::filesystem_error &e) {
361 LogPrintf(
"%s: Unable to remove PID file: %s\n", __func__,
382 static BOOL WINAPI consoleCtrlHandler(DWORD dwCtrlType) {
393 sigemptyset(&sa.sa_mask);
395 sigaction(signal, &sa, NULL);
420 argsman.
AddArg(
"-help-debug",
421 "Print help message with debugging options and exit",
false,
426 const auto defaultBaseParams =
428 const auto testnetBaseParams =
430 const auto regtestBaseParams =
433 const auto testnetChainParams =
435 const auto regtestChainParams =
439 std::vector<std::string> hidden_args = {
444 "-automaticunparking",
445 "-replayprotectionactivationtime",
447 "-chronikallowpause",
449 "-allowselfsignedrootcertificates",
454 "-rootcertificates=<file>",
458 "-leekuanyewactivationtime",
468 #if defined(HAVE_SYSTEM)
470 "-alertnotify=<cmd>",
471 "Execute command when a relevant alert is received or we see "
472 "a really long fork (%s in cmd is replaced by message)",
476 "-assumevalid=<hex>",
478 "If this block is in the chain assume that it and its ancestors "
479 "are valid and potentially skip their script verification (0 to "
480 "verify all, default: %s, testnet: %s)",
481 defaultChainParams->GetConsensus().defaultAssumeValid.GetHex(),
482 testnetChainParams->GetConsensus().defaultAssumeValid.GetHex()),
484 argsman.
AddArg(
"-blocksdir=<dir>",
485 "Specify directory to hold blocks subdirectory for *.dat "
486 "files (default: <datadir>)",
488 argsman.
AddArg(
"-fastprune",
489 "Use smaller block files and lower minimum prune height for "
493 #if defined(HAVE_SYSTEM)
494 argsman.
AddArg(
"-blocknotify=<cmd>",
495 "Execute command when the best block changes (%s in cmd is "
496 "replaced by block hash)",
499 argsman.
AddArg(
"-blockreconstructionextratxn=<n>",
500 strprintf(
"Extra transactions to keep in memory for compact "
501 "block reconstructions (default: %u)",
506 strprintf(
"Whether to reject transactions from network peers. "
507 "Automatic broadcast and rebroadcast of any transactions "
508 "from inbound peers is disabled, unless the peer has the "
509 "'forcerelay' permission. RPC transactions are"
510 " not affected. (default: %u)",
513 argsman.
AddArg(
"-coinstatsindex",
514 strprintf(
"Maintain coinstats index used by the "
515 "gettxoutsetinfo RPC (default: %u)",
520 strprintf(
"Specify path to read-only configuration file. Relative "
521 "paths will be prefixed by datadir location. (default: %s)",
524 argsman.
AddArg(
"-datadir=<dir>",
"Specify data directory",
528 strprintf(
"Maximum database write batch size in bytes (default: %u)",
534 strprintf(
"Set database cache size in MiB (%d to %d, default: %d)",
538 "-includeconf=<file>",
539 "Specify additional configuration file, relative to the -datadir path "
540 "(only useable from configuration file, not command line)",
542 argsman.
AddArg(
"-loadblock=<file>",
543 "Imports blocks from external file on startup",
545 argsman.
AddArg(
"-maxmempool=<n>",
546 strprintf(
"Keep the transaction memory pool below <n> "
547 "megabytes (default: %u)",
550 argsman.
AddArg(
"-maxorphantx=<n>",
551 strprintf(
"Keep at most <n> unconnectable transactions in "
552 "memory (default: %u)",
555 argsman.
AddArg(
"-mempoolexpiry=<n>",
556 strprintf(
"Do not keep transactions in the mempool longer "
557 "than <n> hours (default: %u)",
561 "-minimumchainwork=<hex>",
563 "Minimum work assumed to exist on a valid chain in hex "
564 "(default: %s, testnet: %s)",
565 defaultChainParams->GetConsensus().nMinimumChainWork.GetHex(),
566 testnetChainParams->GetConsensus().nMinimumChainWork.GetHex()),
571 strprintf(
"Set the number of script verification threads (%u to %d, 0 "
572 "= auto, <0 = leave that many cores free, default: %d)",
576 argsman.
AddArg(
"-persistmempool",
577 strprintf(
"Whether to save the mempool on shutdown and load "
578 "on restart (default: %u)",
583 strprintf(
"Specify pid file. Relative paths will be prefixed "
584 "by a net-specific datadir location. (default: %s)",
589 strprintf(
"Reduce storage requirements by enabling pruning (deleting) "
590 "of old blocks. This allows the pruneblockchain RPC to be "
591 "called to delete specific blocks, and enables automatic "
592 "pruning of old blocks if a target size in MiB is provided. "
593 "This mode is incompatible with -txindex, -coinstatsindex "
594 "and -rescan. Warning: Reverting this setting requires "
595 "re-downloading the entire blockchain. (default: 0 = disable "
596 "pruning blocks, 1 = allow manual pruning via RPC, >=%u = "
597 "automatically prune block files to stay under the specified "
598 "target size in MiB)",
602 "-reindex-chainstate",
603 "Rebuild chain state from the currently indexed blocks. When "
604 "in pruning mode or if blocks on disk might be corrupted, use "
605 "full -reindex instead.",
609 "Rebuild chain state and block index from the blk*.dat files on disk",
614 "Specify path to dynamic settings data file. Can be disabled with "
615 "-nosettings. File is written at runtime and not meant to be "
616 "edited by users (use %s instead for custom settings). Relative "
617 "paths will be prefixed by datadir location. (default: %s)",
621 argsman.
AddArg(
"-startupnotify=<cmd>",
"Execute command on startup.",
627 "Create new files with system default permissions, instead of umask "
628 "077 (only effective with disabled wallet functionality)",
631 hidden_args.emplace_back(
"-sysperms");
633 argsman.
AddArg(
"-txindex",
634 strprintf(
"Maintain a full transaction index, used by the "
635 "getrawtransaction rpc call (default: %d)",
641 strprintf(
"Enable the Chronik indexer, which can be read via a "
642 "dedicated HTTP/Protobuf interface (default: %d)",
646 "-chronikbind=<addr>[:port]",
648 "Bind the Chronik indexer to the given address to listen for "
649 "HTTP/Protobuf connections to access the index. Unlike the "
650 "JSON-RPC, it's ok to have this publicly exposed on the internet. "
651 "This option can be specified multiple times (default: %s; default "
652 "port: %u, testnet: %u, regtest: %u)",
653 Join(chronik::DEFAULT_BINDS,
", "),
654 defaultBaseParams->ChronikPort(), testnetBaseParams->ChronikPort(),
655 regtestBaseParams->ChronikPort()),
658 argsman.
AddArg(
"-chroniktokenindex",
659 "Enable token indexing in Chronik (default: 1)",
661 argsman.
AddArg(
"-chronikreindex",
662 "Reindex the Chronik indexer from genesis, but leave the "
663 "other indexes untouched",
666 "-chroniktxnumcachebuckets",
668 "Tuning param of the TxNumCache, specifies how many buckets "
669 "to use on the belt. Caution against setting this too high, "
670 "it may slow down indexing. Set to 0 to disable. (default: %d)",
671 chronik::DEFAULT_TX_NUM_CACHE_BUCKETS),
674 "-chroniktxnumcachebucketsize",
676 "Tuning param of the TxNumCache, specifies the size of each bucket "
677 "on the belt. Unlike the number of buckets, this may be increased "
678 "without much danger of slowing the indexer down. The total cache "
679 "size will be `num_buckets * bucket_size * 40B`, so by default the "
680 "cache will require %dkB of memory. (default: %d)",
681 chronik::DEFAULT_TX_NUM_CACHE_BUCKETS *
682 chronik::DEFAULT_TX_NUM_CACHE_BUCKET_SIZE * 40 / 1000,
683 chronik::DEFAULT_TX_NUM_CACHE_BUCKET_SIZE),
685 argsman.
AddArg(
"-chronikperfstats",
686 "Output some performance statistics (e.g. num cache hits, "
687 "seconds spent) into a <datadir>/perf folder. (default: 0)",
691 "-blockfilterindex=<type>",
692 strprintf(
"Maintain an index of compact filters by block "
693 "(default: %s, values: %s).",
695 " If <type> is not supplied or if <type> = 1, indexes for "
696 "all known types are enabled.",
700 "Use Cash Address for destination encoding instead of base58 "
701 "(activate by default on Jan, 14)",
706 "Add a node to connect to and attempt to keep the connection "
707 "open (see the `addnode` RPC command help for more info)",
710 argsman.
AddArg(
"-asmap=<file>",
711 strprintf(
"Specify asn mapping used for bucketing of the "
712 "peers (default: %s). Relative paths will be "
713 "prefixed by the net-specific datadir location.",
716 argsman.
AddArg(
"-bantime=<n>",
717 strprintf(
"Default duration (in seconds) of manually "
718 "configured bans (default: %u)",
722 "-bind=<addr>[:<port>][=onion]",
723 strprintf(
"Bind to given address and always listen on it (default: "
724 "0.0.0.0). Use [host]:port notation for IPv6. Append =onion "
725 "to tag any incoming connections to that address and port as "
726 "incoming Tor connections (default: 127.0.0.1:%u=onion, "
727 "testnet: 127.0.0.1:%u=onion, regtest: 127.0.0.1:%u=onion)",
728 defaultBaseParams->OnionServiceTargetPort(),
729 testnetBaseParams->OnionServiceTargetPort(),
730 regtestBaseParams->OnionServiceTargetPort()),
735 "Connect only to the specified node(s); -connect=0 disables automatic "
736 "connections (the rules for this peer are the same as for -addnode)",
741 "Discover own IP addresses (default: 1 when listening and no "
742 "-externalip or -proxy)",
745 strprintf(
"Allow DNS lookups for -addnode, -seednode and "
746 "-connect (default: %d)",
752 "Query for peer addresses via DNS lookup, if low on addresses "
753 "(default: %u unless -connect used)",
756 argsman.
AddArg(
"-externalip=<ip>",
"Specify your own public address",
761 "Allow fixed seeds if DNS seeds don't provide peers (default: %u)",
767 "Always query for peer addresses via DNS lookup (default: %d)",
770 argsman.
AddArg(
"-overridednsseed",
771 "If set, only use the specified DNS seed when "
772 "querying for peer addresses via DNS lookup.",
776 "Accept connections from outside (default: 1 if no -proxy or -connect)",
780 strprintf(
"Automatically create Tor onion service (default: %d)",
784 "-maxconnections=<n>",
785 strprintf(
"Maintain at most <n> connections to peers. The effective "
786 "limit depends on system limitations and might be lower than "
787 "the specified value (default: %u)",
790 argsman.
AddArg(
"-maxreceivebuffer=<n>",
791 strprintf(
"Maximum per-connection receive buffer, <n>*1000 "
792 "bytes (default: %u)",
796 "-maxsendbuffer=<n>",
798 "Maximum per-connection send buffer, <n>*1000 bytes (default: %u)",
802 "-maxtimeadjustment",
803 strprintf(
"Maximum allowed median peer time offset adjustment. Local "
804 "perspective of time may be influenced by peers forward or "
805 "backward by this amount. (default: %u seconds)",
808 argsman.
AddArg(
"-onion=<ip:port>",
809 strprintf(
"Use separate SOCKS5 proxy to reach peers via Tor "
810 "onion services (default: %s)",
813 argsman.
AddArg(
"-i2psam=<ip:port>",
814 "I2P SAM proxy to reach I2P peers and accept I2P "
815 "connections (default: none)",
818 "-i2pacceptincoming",
819 "If set and -i2psam is also set then incoming I2P connections are "
820 "accepted via the SAM proxy. If this is not set but -i2psam is set "
821 "then only outgoing connections will be made to the I2P network. "
822 "Ignored if -i2psam is not set. Listening for incoming I2P connections "
823 "is done through the SAM proxy, not by binding to a local address and "
829 "Make outgoing connections only through network <net> (" +
831 "). Incoming connections are not affected by this option. This "
832 "option can be specified multiple times to allow multiple "
833 "networks. Warning: if it is used with non-onion networks "
834 "and the -onion or -proxy option is set, then outbound onion "
835 "connections will still be made; use -noonion or -onion=0 to "
836 "disable outbound onion connections in this case",
838 argsman.
AddArg(
"-peerbloomfilters",
839 strprintf(
"Support filtering of blocks and transaction with "
840 "bloom filters (default: %d)",
846 "Serve compact block filters to peers per BIP 157 (default: %u)",
849 argsman.
AddArg(
"-permitbaremultisig",
850 strprintf(
"Relay non-P2SH multisig (default: %d)",
856 argsman.
AddArg(
"-port=<port>",
857 strprintf(
"Listen for connections on <port>. Nodes not "
858 "using the default ports (default: %u, "
859 "testnet: %u, regtest: %u) are unlikely to get "
860 "incoming connections. Not relevant for I2P (see "
862 defaultChainParams->GetDefaultPort(),
863 testnetChainParams->GetDefaultPort(),
864 regtestChainParams->GetDefaultPort()),
867 argsman.
AddArg(
"-proxy=<ip:port>",
"Connect through SOCKS5 proxy",
871 strprintf(
"Randomize credentials for every proxy connection. "
872 "This enables Tor stream isolation (default: %d)",
877 "Connect to a node to retrieve peer addresses, and disconnect",
881 "Enable all P2P network activity (default: 1). Can be changed "
882 "by the setnetworkactive RPC command",
884 argsman.
AddArg(
"-timeout=<n>",
885 strprintf(
"Specify connection timeout in milliseconds "
886 "(minimum: 1, default: %d)",
891 strprintf(
"Specify p2p connection timeout in seconds. This option "
892 "determines the amount of time a peer may be inactive before "
893 "the connection to it is dropped. (minimum: 1, default: %d)",
897 "-torcontrol=<ip>:<port>",
899 "Tor control port to use if onion listening enabled (default: %s)",
902 argsman.
AddArg(
"-torpassword=<pass>",
903 "Tor control port password (default: empty)",
909 "Use UPnP to map the listening port (default: 1 when "
910 "listening and no -proxy)",
915 strprintf(
"Use UPnP to map the listening port (default: %u)", 0),
919 hidden_args.emplace_back(
"-upnp");
924 strprintf(
"Use NAT-PMP to map the listening port (default: %s)",
928 hidden_args.emplace_back(
"-natpmp");
931 "-whitebind=<[permissions@]addr>",
932 "Bind to the given address and add permission flags to the peers "
934 "Use [host]:port notation for IPv6. Allowed permissions: " +
937 "Specify multiple permissions separated by commas (default: "
938 "download,noban,mempool,relay). Can be specified multiple times.",
941 argsman.
AddArg(
"-whitelist=<[permissions@]IP address or network>",
942 "Add permission flags to the peers connecting from the "
943 "given IP address (e.g. 1.2.3.4) or CIDR-notated network "
944 "(e.g. 1.2.3.0/24). "
945 "Uses the same permissions as -whitebind. Can be specified "
949 "-maxuploadtarget=<n>",
950 strprintf(
"Tries to keep outbound traffic under the given target (in "
951 "MiB per 24h). Limit does not apply to peers with 'download' "
952 "permission. 0 = no limit (default: %d)",
959 argsman.
AddArg(
"-zmqpubhashblock=<address>",
960 "Enable publish hash block in <address>",
962 argsman.
AddArg(
"-zmqpubhashtx=<address>",
963 "Enable publish hash transaction in <address>",
965 argsman.
AddArg(
"-zmqpubrawblock=<address>",
966 "Enable publish raw block in <address>",
968 argsman.
AddArg(
"-zmqpubrawtx=<address>",
969 "Enable publish raw transaction in <address>",
971 argsman.
AddArg(
"-zmqpubsequence=<address>",
972 "Enable publish hash block and tx sequence in <address>",
975 "-zmqpubhashblockhwm=<n>",
976 strprintf(
"Set publish hash block outbound message high water "
977 "mark (default: %d)",
981 "-zmqpubhashtxhwm=<n>",
982 strprintf(
"Set publish hash transaction outbound message high "
983 "water mark (default: %d)",
987 "-zmqpubrawblockhwm=<n>",
988 strprintf(
"Set publish raw block outbound message high water "
989 "mark (default: %d)",
993 "-zmqpubrawtxhwm=<n>",
994 strprintf(
"Set publish raw transaction outbound message high "
995 "water mark (default: %d)",
998 argsman.
AddArg(
"-zmqpubsequencehwm=<n>",
999 strprintf(
"Set publish hash sequence message high water mark"
1004 hidden_args.emplace_back(
"-zmqpubhashblock=<address>");
1005 hidden_args.emplace_back(
"-zmqpubhashtx=<address>");
1006 hidden_args.emplace_back(
"-zmqpubrawblock=<address>");
1007 hidden_args.emplace_back(
"-zmqpubrawtx=<address>");
1008 hidden_args.emplace_back(
"-zmqpubsequence=<n>");
1009 hidden_args.emplace_back(
"-zmqpubhashblockhwm=<n>");
1010 hidden_args.emplace_back(
"-zmqpubhashtxhwm=<n>");
1011 hidden_args.emplace_back(
"-zmqpubrawblockhwm=<n>");
1012 hidden_args.emplace_back(
"-zmqpubrawtxhwm=<n>");
1013 hidden_args.emplace_back(
"-zmqpubsequencehwm=<n>");
1018 strprintf(
"How many blocks to check at startup (default: %u, 0 = all)",
1022 argsman.
AddArg(
"-checklevel=<n>",
1023 strprintf(
"How thorough the block verification of "
1024 "-checkblocks is: %s (0-4, default: %u)",
1028 argsman.
AddArg(
"-checkblockindex",
1029 strprintf(
"Do a consistency check for the block tree, "
1030 "chainstate, and other validation data structures "
1031 "occasionally. (default: %u, regtest: %u)",
1032 defaultChainParams->DefaultConsistencyChecks(),
1033 regtestChainParams->DefaultConsistencyChecks()),
1036 argsman.
AddArg(
"-checkaddrman=<n>",
1037 strprintf(
"Run addrman consistency checks every <n> "
1038 "operations. Use 0 to disable. (default: %u)",
1043 "-checkmempool=<n>",
1044 strprintf(
"Run mempool consistency checks every <n> transactions. Use "
1045 "0 to disable. (default: %u, regtest: %u)",
1046 defaultChainParams->DefaultConsistencyChecks(),
1047 regtestChainParams->DefaultConsistencyChecks()),
1050 argsman.
AddArg(
"-checkpoints",
1051 strprintf(
"Only accept block chain matching built-in "
1052 "checkpoints (default: %d)",
1056 argsman.
AddArg(
"-deprecatedrpc=<method>",
1057 "Allows deprecated RPC method(s) to be used",
1061 "-stopafterblockimport",
1062 strprintf(
"Stop running after importing blocks from disk (default: %d)",
1066 argsman.
AddArg(
"-stopatheight",
1067 strprintf(
"Stop running after reaching the given height in "
1068 "the main chain (default: %u)",
1072 argsman.
AddArg(
"-addrmantest",
"Allows to test address relay on localhost",
1075 argsman.
AddArg(
"-capturemessages",
"Capture all P2P messages to disk",
1078 argsman.
AddArg(
"-mocktime=<n>",
1084 "-maxsigcachesize=<n>",
1085 strprintf(
"Limit size of signature cache to <n> MiB (default: %u)",
1090 "-maxscriptcachesize=<n>",
1091 strprintf(
"Limit size of script cache to <n> MiB (default: %u)",
1095 argsman.
AddArg(
"-maxtipage=<n>",
1096 strprintf(
"Maximum tip age in seconds to consider node in "
1097 "initial block download (default: %u)",
1102 argsman.
AddArg(
"-uacomment=<cmt>",
1103 "Append comment to the user agent string",
1105 argsman.
AddArg(
"-uaclientname=<clientname>",
"Set user agent client name",
1107 argsman.
AddArg(
"-uaclientversion=<clientversion>",
1116 "Relay and mine \"non-standard\" transactions (%sdefault: %u)",
1117 "testnet/regtest only; ", defaultChainParams->RequireStandard()),
1120 argsman.
AddArg(
"-excessiveblocksize=<n>",
1121 strprintf(
"Do not accept blocks larger than this limit, in "
1122 "bytes (default: %d)",
1128 "-dustrelayfee=<amt>",
1129 strprintf(
"Fee rate (in %s/kB) used to define dust, the value of an "
1130 "output such that it will cost about 1/3 of its value in "
1131 "fees at this fee rate to spend it. (default: %s)",
1137 "-bytespersigcheck",
1138 strprintf(
"Equivalent bytes per sigCheck in transactions for relay and "
1139 "mining (default: %u).",
1144 strprintf(
"DEPRECATED: Equivalent bytes per sigCheck in transactions "
1145 "for relay and mining (default: %u). This has been "
1146 "deprecated since v0.26.8 and will be removed in the future, "
1147 "please use -bytespersigcheck instead.",
1152 strprintf(
"Relay and mine data carrier transactions (default: %d)",
1157 strprintf(
"Maximum size of data in data carrier transactions "
1158 "we relay and mine (default: %u)",
1162 "-minrelaytxfee=<amt>",
1163 strprintf(
"Fees (in %s/kB) smaller than this are rejected for "
1164 "relaying, mining and transaction creation (default: %s)",
1169 strprintf(
"Add 'relay' permission to whitelisted inbound peers "
1170 "with default permissions. This will accept relayed "
1171 "transactions even when not relaying transactions "
1176 "-whitelistforcerelay",
1177 strprintf(
"Add 'forcerelay' permission to whitelisted inbound peers"
1178 " with default permissions. This will relay transactions "
1179 "even if the transactions were already in the mempool "
1184 argsman.
AddArg(
"-blockmaxsize=<n>",
1185 strprintf(
"Set maximum block size in bytes (default: %d)",
1189 "-blockmintxfee=<amt>",
1190 strprintf(
"Set lowest fee rate (in %s/kB) for transactions to "
1191 "be included in block creation. (default: %s)",
1195 argsman.
AddArg(
"-blockversion=<n>",
1196 "Override block version to test forking scenarios",
1200 argsman.
AddArg(
"-server",
"Accept command line and JSON-RPC commands",
1203 strprintf(
"Accept public REST requests (default: %d)",
1207 "-rpcbind=<addr>[:port]",
1208 "Bind to given address to listen for JSON-RPC connections. Do not "
1209 "expose the RPC server to untrusted networks such as the public "
1210 "internet! This option is ignored unless -rpcallowip is also passed. "
1211 "Port is optional and overrides -rpcport. Use [host]:port notation "
1212 "for IPv6. This option can be specified multiple times (default: "
1213 "127.0.0.1 and ::1 i.e., localhost)",
1218 "-rpccookiefile=<loc>",
1219 "Location of the auth cookie. Relative paths will be prefixed "
1220 "by a net-specific datadir location. (default: data dir)",
1222 argsman.
AddArg(
"-rpcuser=<user>",
"Username for JSON-RPC connections",
1225 argsman.
AddArg(
"-rpcpassword=<pw>",
"Password for JSON-RPC connections",
1229 "-rpcwhitelist=<whitelist>",
1230 "Set a whitelist to filter incoming RPC calls for a specific user. The "
1231 "field <whitelist> comes in the format: <USERNAME>:<rpc 1>,<rpc "
1232 "2>,...,<rpc n>. If multiple whitelists are set for a given user, they "
1233 "are set-intersected. See -rpcwhitelistdefault documentation for "
1234 "information on default whitelist behavior.",
1237 "-rpcwhitelistdefault",
1238 "Sets default behavior for rpc whitelisting. Unless "
1239 "rpcwhitelistdefault is set to 0, if any -rpcwhitelist is set, the rpc "
1240 "server acts as if all rpc users are subject to "
1241 "empty-unless-otherwise-specified whitelists. If rpcwhitelistdefault "
1242 "is set to 1 and no -rpcwhitelist is set, rpc server acts as if all "
1243 "rpc users are subject to empty whitelists.",
1246 "-rpcauth=<userpw>",
1247 "Username and HMAC-SHA-256 hashed password for JSON-RPC connections. "
1248 "The field <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. A "
1249 "canonical python script is included in share/rpcauth. The client then "
1250 "connects normally using the rpcuser=<USERNAME>/rpcpassword=<PASSWORD> "
1251 "pair of arguments. This option can be specified multiple times",
1253 argsman.
AddArg(
"-rpcport=<port>",
1254 strprintf(
"Listen for JSON-RPC connections on <port> "
1255 "(default: %u, testnet: %u, regtest: %u)",
1256 defaultBaseParams->RPCPort(),
1257 testnetBaseParams->RPCPort(),
1258 regtestBaseParams->RPCPort()),
1263 "Allow JSON-RPC connections from specified source. Valid for "
1264 "<ip> are a single IP (e.g. 1.2.3.4), a network/netmask (e.g. "
1265 "1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). "
1266 "This option can be specified multiple times",
1271 "Set the number of threads to service RPC calls (default: %d)",
1275 "-rpccorsdomain=value",
1276 "Domain from which to accept cross origin requests (browser enforced)",
1279 argsman.
AddArg(
"-rpcworkqueue=<n>",
1280 strprintf(
"Set the depth of the work queue to service RPC "
1281 "calls (default: %d)",
1285 argsman.
AddArg(
"-rpcservertimeout=<n>",
1286 strprintf(
"Timeout during HTTP requests (default: %d)",
1292 argsman.
AddArg(
"-daemon",
1293 strprintf(
"Run in the background as a daemon and accept "
1294 "commands (default: %d)",
1297 argsman.
AddArg(
"-daemonwait",
1298 strprintf(
"Wait for initialization to be finished before "
1299 "exiting. This implies -daemon (default: %d)",
1303 hidden_args.emplace_back(
"-daemon");
1304 hidden_args.emplace_back(
"-daemonwait");
1308 argsman.
AddArg(
"-avalanche",
1309 strprintf(
"Enable the avalanche feature (default: %u)",
1313 "-avalanchestakingrewards",
1314 strprintf(
"Enable the avalanche staking rewards feature (default: %u, "
1315 "testnet: %u, regtest: %u)",
1316 defaultChainParams->GetConsensus().enableStakingRewards,
1317 testnetChainParams->GetConsensus().enableStakingRewards,
1318 regtestChainParams->GetConsensus().enableStakingRewards),
1320 argsman.
AddArg(
"-avalancheconflictingproofcooldown",
1321 strprintf(
"Mandatory cooldown before a proof conflicting "
1322 "with an already registered one can be considered "
1323 "in seconds (default: %u)",
1326 argsman.
AddArg(
"-avalanchepeerreplacementcooldown",
1327 strprintf(
"Mandatory cooldown before a peer can be replaced "
1328 "in seconds (default: %u)",
1332 "-avaminquorumstake",
1334 "Minimum amount of known stake for a usable quorum (default: %s)",
1338 "-avaminquorumconnectedstakeratio",
1339 strprintf(
"Minimum proportion of known stake we"
1340 " need nodes for to have a usable quorum (default: %s)",
1344 "-avaminavaproofsnodecount",
1345 strprintf(
"Minimum number of node that needs to send us an avaproofs"
1346 " message before we consider we have a usable quorum"
1351 "-avastalevotethreshold",
1352 strprintf(
"Number of avalanche votes before a voted item goes stale "
1353 "when voting confidence is low (default: %u)",
1357 "-avastalevotefactor",
1359 "Factor affecting the number of avalanche votes before a voted "
1360 "item goes stale when voting confidence is high (default: %u)",
1363 argsman.
AddArg(
"-avacooldown",
1364 strprintf(
"Mandatory cooldown between two avapoll in "
1365 "milliseconds (default: %u)",
1370 strprintf(
"Avalanche query timeout in milliseconds (default: %u)",
1375 "Avalanche proof delegation to the master key used by this node "
1376 "(default: none). Should be used in conjunction with -avaproof and "
1379 argsman.
AddArg(
"-avaproof",
1380 "Avalanche proof to be used by this node (default: none)",
1383 "-avaproofstakeutxoconfirmations",
1385 "Minimum number of confirmations before a stake utxo is mature"
1386 " enough to be included into a proof. Utxos in the mempool are not "
1387 "accepted (i.e this value must be greater than 0) (default: %s)",
1390 argsman.
AddArg(
"-avaproofstakeutxodustthreshold",
1391 strprintf(
"Minimum value each stake utxo must have to be "
1392 "considered valid (default: %s)",
1395 argsman.
AddArg(
"-avamasterkey",
1396 "Master key associated with the proof. If a proof is "
1397 "required, this is mandatory.",
1400 argsman.
AddArg(
"-avasessionkey",
"Avalanche session key (default: random)",
1404 "-maxavalancheoutbound",
1406 "Set the maximum number of avalanche outbound peers to connect to. "
1407 "Note that this option takes precedence over the -maxconnections "
1408 "option (default: %u).",
1413 strprintf(
"Whether to save the avalanche peers upon shutdown and load "
1414 "them upon startup (default: %u).",
1418 hidden_args.emplace_back(
"-avalanchepreconsensus");
1425 const std::string URL_SOURCE_CODE =
1426 "<https://github.com/Bitcoin-ABC/bitcoin-abc>";
1427 const std::string URL_WEBSITE =
"<https://www.bitcoinabc.org>";
1433 strprintf(
_(
"Please contribute if you find %s useful. "
1434 "Visit %s for further information about the software.")
1436 PACKAGE_NAME, URL_WEBSITE) +
1438 strprintf(
_(
"The source code is available from %s.").translated,
1440 "\n" +
"\n" +
_(
"This is experimental software.").
translated +
"\n" +
1441 strprintf(
_(
"Distributed under the MIT software license, see the "
1442 "accompanying file %s or %s")
1444 "COPYING",
"<https://opensource.org/licenses/MIT>") +
1446 strprintf(
_(
"This product includes software developed by the "
1447 "OpenSSL Project for use in the OpenSSL Toolkit %s and "
1448 "cryptographic software written by Eric Young and UPnP "
1449 "software written by Thomas Bernard.")
1451 "<https://www.openssl.org>") +
1460 if (pBlockIndex !=
nullptr) {
1470 static void StartupNotify(
const ArgsManager &args) {
1471 std::string cmd = args.
GetArg(
"-startupnotify",
"");
1473 std::thread t(runCommand, cmd);
1511 "%s: parameter interaction: -bind set -> setting -listen=1\n",
1517 LogPrintf(
"%s: parameter interaction: -whitebind set -> setting "
1527 LogPrintf(
"%s: parameter interaction: -connect set -> setting "
1532 LogPrintf(
"%s: parameter interaction: -connect set -> setting "
1543 "%s: parameter interaction: -proxy set -> setting -listen=0\n",
1551 "%s: parameter interaction: -proxy set -> setting -upnp=0\n",
1556 "%s: parameter interaction: -proxy set -> setting -natpmp=0\n",
1561 LogPrintf(
"%s: parameter interaction: -proxy set -> setting "
1572 "%s: parameter interaction: -listen=0 -> setting -upnp=0\n",
1577 "%s: parameter interaction: -listen=0 -> setting -natpmp=0\n",
1582 "%s: parameter interaction: -listen=0 -> setting -discover=0\n",
1586 LogPrintf(
"%s: parameter interaction: -listen=0 -> setting "
1591 LogPrintf(
"%s: parameter interaction: -listen=0 -> setting "
1592 "-i2pacceptincoming=0\n",
1597 if (args.
IsArgSet(
"-externalip")) {
1600 LogPrintf(
"%s: parameter interaction: -externalip set -> setting "
1609 LogPrintf(
"%s: parameter interaction: -blocksonly=1 -> setting "
1610 "-whitelistrelay=0\n",
1619 LogPrintf(
"%s: parameter interaction: -whitelistforcerelay=1 -> "
1620 "setting -whitelistrelay=1\n",
1627 const bool fAvalanche =
1646 int nMaxConnections;
1647 int nUserMaxConnections;
1650 int64_t peer_connect_timeout;
1651 std::set<BlockFilterType> g_enabled_filter_types;
1659 std::set_new_handler(std::terminate);
1660 LogPrintf(
"Error: Out of memory. Terminating.\n");
1670 _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
1671 _CrtSetReportFile(_CRT_WARN, CreateFileA(
"NUL", GENERIC_WRITE, 0,
nullptr,
1672 OPEN_EXISTING, 0, 0));
1674 _set_abort_behavior(0, _WRITE_ABORT_MSG | _CALL_REPORTFAULT);
1678 SetProcessDEPPolicy(PROCESS_DEP_ENABLE);
1682 Untranslated(
"Initializing wait-for-shutdown state failed."));
1703 signal(SIGPIPE, SIG_IGN);
1705 SetConsoleCtrlHandler(consoleCtrlHandler,
true);
1725 errors +=
strprintf(
_(
"Config setting for %s only applied on %s "
1726 "network when in [%s] section.") +
1728 arg, network, network);
1731 if (!errors.
empty()) {
1739 _(
"Section [%s] is not recognized.") +
1741 section.m_file, section.m_line, section.m_name);
1744 if (!warnings.
empty()) {
1750 strprintf(
_(
"Specified blocks directory \"%s\" does not exist."),
1751 args.
GetArg(
"-blocksdir",
"")));
1755 std::string blockfilterindex_value =
1757 if (blockfilterindex_value ==
"" || blockfilterindex_value ==
"1") {
1759 }
else if (blockfilterindex_value !=
"0") {
1760 const std::vector<std::string> names =
1761 args.
GetArgs(
"-blockfilterindex");
1762 for (
const auto &
name : names) {
1768 g_enabled_filter_types.insert(filter_type);
1777 _(
"Cannot set -peerblockfilters without -blockfilterindex."));
1786 return InitError(
_(
"Prune mode is incompatible with -txindex."));
1790 _(
"Prune mode is incompatible with -coinstatsindex."));
1793 return InitError(
_(
"Prune mode is incompatible with -chronik."));
1799 args.
GetArgs(
"-bind").size() + args.
GetArgs(
"-whitebind").size();
1802 "Cannot set -bind or -whitebind together with -listen=0"));
1806 int nBind = std::max(nUserBind,
size_t(1));
1807 nUserMaxConnections =
1809 nMaxConnections = std::max(nUserMaxConnections, 0);
1812 const int maxAvalancheOutbound = args.
GetIntArg(
1815 nMaxConnections = std::max(maxAvalancheOutbound, nMaxConnections);
1817 LogPrintf(
"Increasing -maxconnections from %d to %d to comply with "
1818 "-maxavalancheoutbound\n",
1819 nUserMaxConnections, nMaxConnections);
1831 int fd_max = FD_SETSIZE;
1833 nMaxConnections = std::max(
1834 std::min<int>(nMaxConnections,
1839 return InitError(
_(
"Not enough file descriptors available."));
1845 if (nMaxConnections < nUserMaxConnections) {
1849 LogPrintf(
"Reducing -maxconnections from %d to %d, because of system "
1851 nUserMaxConnections, nMaxConnections);
1862 LogPrintf(
"Checkpoints will be verified.\n");
1864 LogPrintf(
"Skipping checkpoint verification.\n");
1868 args.
GetArg(
"-assumevalid",
1871 if (args.
IsArgSet(
"-minimumchainwork")) {
1872 const std::string minChainWorkStr =
1873 args.
GetArg(
"-minimumchainwork",
"");
1877 "Invalid non-hex (%s) minimum chain work value specified"),
1887 const int64_t nProposedExcessiveBlockSize =
1889 if (nProposedExcessiveBlockSize <= 0 ||
1892 _(
"Excessive block size must be > 1,000,000 bytes (1MB)"));
1896 const int64_t nProposedMaxGeneratedBlockSize =
1898 if (nProposedMaxGeneratedBlockSize <= 0) {
1899 return InitError(
_(
"Max generated block size must be greater than 0"));
1901 if (uint64_t(nProposedMaxGeneratedBlockSize) > config.
GetMaxBlockSize()) {
1902 return InitError(
_(
"Max generated block size (blockmaxsize) cannot "
1903 "exceed the excessive block size "
1904 "(excessiveblocksize)"));
1909 int64_t nPruneArg = args.
GetIntArg(
"-prune", 0);
1910 if (nPruneArg < 0) {
1912 _(
"Prune cannot be configured with a negative value."));
1915 if (nPruneArg == 1) {
1922 strprintf(
_(
"Prune configured below the minimum of %d MiB. "
1923 "Please use a higher number."),
1934 peer_connect_timeout =
1936 if (peer_connect_timeout <= 0) {
1938 "peertimeout cannot be configured with a negative value."));
1944 if (args.
IsArgSet(
"-blockmintxfee")) {
1948 args.
GetArg(
"-blockmintxfee",
"")));
1970 if (args.
IsArgSet(
"-proxy") && args.
GetArg(
"-proxy",
"").empty()) {
1972 "No proxy server specified. Use -proxy=<ip> or -proxy=<ip:port>."));
1976 const int64_t stakeUtxoMinConfirmations =
1977 args.
GetIntArg(
"-avaproofstakeutxoconfirmations",
1981 stakeUtxoMinConfirmations !=
1983 return InitError(
_(
"Avalanche stake UTXO minimum confirmations can "
1984 "only be set on test chains."));
1987 if (stakeUtxoMinConfirmations <= 0) {
1988 return InitError(
_(
"Avalanche stake UTXO minimum confirmations must be "
1989 "a positive integer."));
1992 if (args.
IsArgSet(
"-avaproofstakeutxodustthreshold")) {
1995 args.
GetArg(
"-avaproofstakeutxodustthreshold",
""), amount);
1998 "avaproofstakeutxodustthreshold",
1999 args.
GetArg(
"-avaproofstakeutxodustthreshold",
"")));
2004 return InitError(
_(
"Avalanche stake UTXO dust threshold can "
2005 "only be set on test chains."));
2012 return InitError(
_(
"Running a staking node requires accepting "
2013 "inbound connections. Please enable -listen."));
2016 return InitError(
_(
"Running a staking node behind a proxy is not "
2017 "supported. Please disable -proxy."));
2020 return InitError(
_(
"Running a staking node behind I2P is not "
2021 "supported. Please disable -i2psam."));
2025 _(
"Restricting the outbound network is not supported when "
2026 "running a staking node. Please disable -onlynet."));
2038 _(
"Cannot write to data directory '%s'; check permissions."),
2043 "%s. %s is probably already running."),
2057 _(
"Initialization sanity check failed. %s is shutting down."),
2106 LogPrintf(
"Using at most %i automatic connections (%i file descriptors "
2108 nMaxConnections, nFD);
2112 !args.
GetPathArg(
"-datadir").is_absolute()) {
2113 LogPrintf(
"Warning: relative datadir option '%s' specified, which will "
2114 "be interpreted relative to the current working directory "
2115 "'%s'. This is fragile, because if bitcoin is started in the "
2116 "future from a different location, it will be unable to "
2117 "locate the current data files. There could also be data "
2118 "loss if bitcoin is started while in a temporary "
2120 args.
GetArg(
"-datadir",
""),
2129 _(
"Unable to allocate memory for -maxsigcachesize: '%s' MiB"),
2134 validation_cache_sizes.script_execution_cache_bytes)) {
2136 _(
"Unable to allocate memory for -maxscriptcachesize: '%s' MiB"),
2142 if (script_threads <= 0) {
2150 script_threads = std::max(script_threads - 1, 0);
2155 LogPrintf(
"Script verification uses %d additional threads\n",
2157 if (script_threads >= 1) {
2162 node.scheduler = std::make_unique<CScheduler>();
2165 node.scheduler->m_service_thread =
2167 [&] {
node.scheduler->serviceQueue(); });
2170 node.scheduler->scheduleEvery(
2175 std::chrono::minutes{1});
2184 for (
const auto &client :
node.chain_clients) {
2185 client->registerRpcs();
2201 _(
"Unable to start HTTP server. See debug log for details."));
2206 for (
const auto &client :
node.chain_clients) {
2207 if (!client->verify()) {
2227 std::vector<bool> asmap;
2231 if (!asmap_path.is_absolute()) {
2240 if (asmap.size() == 0) {
2246 LogPrintf(
"Using asmap version %s for IP bucketing\n",
2249 LogPrintf(
"Using /16 prefix for IP bucketing\n");
2252 uiInterface.InitMessage(
_(
"Loading P2P addresses...").translated);
2253 auto addrman{
LoadAddrman(chainparams, asmap, args)};
2257 node.addrman = std::move(*addrman);
2261 node.banman = std::make_unique<BanMan>(
2265 node.connman = std::make_unique<CConnman>(
2266 config, GetRand<uint64_t>(), GetRand<uint64_t>(), *
node.addrman,
2270 std::vector<std::string> uacomments;
2271 for (
const std::string &cmt : args.
GetArgs(
"-uacomment")) {
2274 _(
"User Agent comment (%s) contains unsafe characters."), cmt));
2276 uacomments.push_back(cmt);
2279 const std::string client_version =
2283 _(
"-uaclientname (%s) contains invalid characters."), client_name));
2285 if (client_version !=
2288 strprintf(
_(
"-uaclientversion (%s) contains invalid characters."),
2291 const std::string strSubVersion =
2295 _(
"Total length of network version string (%i) exceeds maximum "
2296 "length (%i). Reduce the number or size of uacomments."),
2301 std::set<enum Network> nets;
2302 for (
const std::string &snet : args.
GetArgs(
"-onlynet")) {
2306 _(
"Unknown network specified in -onlynet: '%s'"), snet));
2310 for (
int n = 0; n <
NET_MAX; n++) {
2312 if (!nets.count(net)) {
2322 bool proxyRandomize =
2327 std::string proxyArg = args.
GetArg(
"-proxy",
"");
2329 if (proxyArg !=
"" && proxyArg !=
"0") {
2333 _(
"Invalid -proxy address or hostname: '%s'"), proxyArg));
2339 _(
"Invalid -proxy address or hostname: '%s'"), proxyArg));
2355 std::string onionArg = args.
GetArg(
"-onion",
"");
2356 if (onionArg !=
"") {
2357 if (onionArg ==
"0") {
2364 _(
"Invalid -onion address or hostname: '%s'"), onionArg));
2369 _(
"Invalid -onion address or hostname: '%s'"), onionArg));
2376 for (
const std::string &strAddr : args.
GetArgs(
"-externalip")) {
2397 bool fReindexChainState = args.
GetBoolArg(
"-reindex-chainstate",
false);
2404 LogPrintf(
"* Using %.1f MiB for block index database\n",
2407 LogPrintf(
"* Using %.1f MiB for transaction index database\n",
2408 cache_sizes.
tx_index * (1.0 / 1024 / 1024));
2411 LogPrintf(
"* Using %.1f MiB for %s block filter index database\n",
2415 LogPrintf(
"* Using %.1f MiB for chain state database\n",
2416 cache_sizes.
coins_db * (1.0 / 1024 / 1024));
2427 mempool_opts.check_ratio =
2428 std::clamp<int>(mempool_opts.check_ratio, 0, 1'000'000);
2434 int64_t nMempoolSizeMin = 101 * 1000 * 40;
2435 if (mempool_opts.max_size_bytes < 0 ||
2437 mempool_opts.max_size_bytes < nMempoolSizeMin)) {
2439 std::ceil(nMempoolSizeMin / 1000000.0)));
2441 LogPrintf(
"* Using %.1f MiB for in-memory UTXO set (plus up to %.1f MiB of "
2442 "unused mempool space)\n",
2443 cache_sizes.
coins * (1.0 / 1024 / 1024),
2444 mempool_opts.max_size_bytes * (1.0 / 1024 / 1024));
2447 node.mempool = std::make_unique<CTxMemPool>(mempool_opts);
2453 node.chainman = std::make_unique<ChainstateManager>(chainman_opts);
2469 _(
"Error reading from database, shutting down."),
"",
2473 uiInterface.InitMessage(
_(
"Loading block index...").translated);
2475 const int64_t load_block_index_start_time =
GetTimeMillis();
2476 auto catch_exceptions = [](
auto &&f) {
2479 }
catch (
const std::exception &e) {
2482 _(
"Error opening block database"));
2485 auto [status,
error] = catch_exceptions(
2491 LogPrintf(
"Prune: pruned datadir may not have more than %d "
2492 "blocks; only checking available blocks\n",
2495 std::tie(status,
error) = catch_exceptions(
2515 _(
"Do you want to rebuild the block database now?"),
2516 error.original +
".\nPlease restart with -reindex or "
2517 "-reindex-chainstate to recover.",
2525 LogPrintf(
"Aborted block database rebuild. Exiting.\n");
2539 LogPrintf(
"Shutdown requested. Exiting.\n");
2547 *
node.connman, *
node.addrman,
node.banman.get(), chainman,
2558 args, *
node.chain,
node.connman.get(), chainman,
node.mempool.get(),
2559 *
node.scheduler, avalancheError);
2581 if (!
g_txindex->Start(chainman.ActiveChainstate())) {
2586 for (
const auto &filter_type : g_enabled_filter_types) {
2590 ->Start(chainman.ActiveChainstate())) {
2605 const bool fReindexChronik =
2607 if (!chronik::Start(config,
node, fReindexChronik)) {
2614 for (
const auto &client :
node.chain_clients) {
2615 if (!client->load()) {
2625 LogPrintf(
"Unsetting NODE_NETWORK on prune mode\n");
2630 uiInterface.InitMessage(
_(
"Pruning blockstore...").translated);
2631 chainstate->PruneAndFlush();
2639 strprintf(
_(
"Error: Disk space is low for %s"),
2645 strprintf(
_(
"Error: Disk space is low for %s"),
2653 boost::signals2::connection block_notify_genesis_wait_connection;
2656 block_notify_genesis_wait_connection =
2663 #if defined(HAVE_SYSTEM)
2664 const std::string block_notify = args.
GetArg(
"-blocknotify",
"");
2665 if (!block_notify.empty()) {
2666 uiInterface.NotifyBlockTip_connect([block_notify](
2672 std::string command = block_notify;
2674 std::thread t(runCommand, command);
2681 std::vector<fs::path> vImportFiles;
2682 for (
const std::string &strFile : args.
GetArgs(
"-loadblock")) {
2702 block_notify_genesis_wait_connection.disconnect();
2711 int chain_active_height;
2727 if (tip_info && chainman.m_best_header) {
2729 tip_info->
header_time = chainman.m_best_header->GetBlockTime();
2732 LogPrintf(
"nBestHeight = %d\n", chain_active_height);
2734 node.peerman->SetBestHeight(chain_active_height);
2746 ? args.
GetIntArg(
"-maxavalancheoutbound",
2776 const uint16_t default_bind_port =
static_cast<uint16_t
>(
2779 const auto BadPortWarning = [](
const char *
prefix, uint16_t port) {
2780 return strprintf(
_(
"%s request to listen on port %u. This port is "
2781 "considered \"bad\" and "
2782 "thus it is unlikely that any Bitcoin ABC peers "
2783 "connect to it. See "
2784 "doc/p2p-bad-ports.md for details and a full list."),
2788 for (
const std::string &bind_arg : args.
GetArgs(
"-bind")) {
2790 const size_t index = bind_arg.rfind(
'=');
2791 if (index == std::string::npos) {
2792 if (
Lookup(bind_arg, bind_addr, default_bind_port,
2794 connOptions.
vBinds.push_back(bind_addr);
2801 const std::string network_type = bind_arg.substr(index + 1);
2802 if (network_type ==
"onion") {
2803 const std::string truncated_bind_arg =
2804 bind_arg.substr(0, index);
2805 if (
Lookup(truncated_bind_arg, bind_addr,
2806 BaseParams().OnionServiceTargetPort(),
false)) {
2815 for (
const std::string &strBind : args.
GetArgs(
"-whitebind")) {
2827 args.
GetArgs(
"-bind").empty() && args.
GetArgs(
"-whitebind").empty();
2832 const uint16_t port_arg = args.
GetIntArg(
"-port", 0);
2840 onion_service_target = connOptions.
onion_binds.front();
2843 connOptions.
onion_binds.push_back(onion_service_target);
2849 _(
"More than one onion bind address is provided. Using %s "
2850 "for the automatically created Tor onion service."),
2862 for (
const auto &net : args.
GetArgs(
"-whitelist")) {
2876 const auto connect = args.
GetArgs(
"-connect");
2877 if (connect.size() != 1 || connect[0] !=
"0") {
2882 const std::string &i2psam_arg = args.
GetArg(
"-i2psam",
"");
2883 if (!i2psam_arg.empty()) {
2887 _(
"Invalid -i2psam address or hostname: '%s'"), i2psam_arg));
2898 if (!
node.connman->Start(*
node.scheduler, connOptions)) {
2918 for (
const auto &client :
node.chain_clients) {
2919 client->start(*
node.scheduler);
2923 node.scheduler->scheduleEvery(
2931 node.peerman->StartScheduledTasks(*
node.scheduler);
2938 StartupNotify(args);
util::Result< std::unique_ptr< AddrMan > > LoadAddrman(const CChainParams &chainparams, const std::vector< bool > &asmap, const ArgsManager &args)
Returns an error string on failure.
static constexpr int32_t DEFAULT_ADDRMAN_CONSISTENCY_CHECKS
Default for -checkaddrman.
arith_uint256 UintToArith256(const uint256 &a)
std::vector< bool > DecodeAsmap(fs::path path)
Read asmap from provided binary file.
bool isAvalancheEnabled(const ArgsManager &argsman)
static constexpr bool DEFAULT_PERSIST_AVAPEERS
Default for -persistavapeers.
static constexpr double AVALANCHE_DEFAULT_MIN_QUORUM_CONNECTED_STAKE_RATIO
Default minimum percentage of stake-weighted peers we must have a node for to constitute a usable quo...
static constexpr size_t AVALANCHE_DEFAULT_PEER_REPLACEMENT_COOLDOWN
Peer replacement cooldown time default value in seconds.
static constexpr double AVALANCHE_DEFAULT_MIN_AVAPROOFS_NODE_COUNT
Default minimum number of nodes that sent us an avaproofs message before we can consider our quorum s...
static constexpr Amount AVALANCHE_DEFAULT_MIN_QUORUM_STAKE
Default minimum cumulative stake of all known peers that constitutes a usable quorum.
static constexpr size_t AVALANCHE_DEFAULT_CONFLICTING_PROOF_COOLDOWN
Conflicting proofs cooldown time default value in seconds.
static constexpr bool AVALANCHE_DEFAULT_ENABLED
Is avalanche enabled by default.
std::unique_ptr< avalanche::Processor > g_avalanche
Global avalanche instance.
static constexpr size_t AVALANCHE_DEFAULT_COOLDOWN
Avalanche default cooldown in milliseconds.
static constexpr unsigned int DEFAULT_MISBEHAVING_BANTIME
static constexpr std::chrono::minutes DUMP_BANS_INTERVAL
void RPCNotifyBlockChange(const CBlockIndex *pindex)
Callback for when block tip changed.
const std::string & BlockFilterTypeName(BlockFilterType filter_type)
Get the human-readable name for a filter type.
const std::string & ListBlockFilterTypes()
Get a comma-separated list of known filter type names.
bool BlockFilterTypeByName(const std::string &name, BlockFilterType &filter_type)
Find a filter type by its human-readable name.
const std::set< BlockFilterType > & AllBlockFilterTypes()
Get a list of known filter types.
void DestroyAllBlockFilterIndexes()
Destroy all open block filter indexes.
BlockFilterIndex * GetBlockFilterIndex(BlockFilterType filter_type)
Get a block filter index by type.
void ForEachBlockFilterIndex(std::function< void(BlockFilterIndex &)> fn)
Iterate over all running block filter indexes, invoking fn on each.
bool InitBlockFilterIndex(BlockFilterType filter_type, size_t n_cache_size, bool f_memory, bool f_wipe)
Initialize a block filter index for the given type if one does not already exist.
static const char *const DEFAULT_BLOCKFILTERINDEX
const CChainParams & Params()
Return the currently selected parameters.
std::unique_ptr< CChainParams > CreateChainParams(const std::string &chain)
Creates and returns a std::unique_ptr<CChainParams> of the chosen chain.
const CBaseChainParams & BaseParams()
Return the currently selected parameters.
void SetupChainParamsBaseOptions(ArgsManager &argsman)
Set the arguments for chainparams.
std::unique_ptr< CBaseChainParams > CreateBaseChainParams(const std::string &chain)
Port numbers for incoming Tor connections (8334, 18334, 38334, 18445) have been chosen arbitrarily to...
#define Assert(val)
Identity function.
const std::set< std::string > GetUnsuitableSectionOnlyArgs() const
Log warnings for options in m_section_only_args when they are specified in the default section but no...
const fs::path & GetBlocksDirPath() const
Get blocks directory path.
std::vector< std::string > GetArgs(const std::string &strArg) const
Return a vector of strings of the given argument.
bool IsArgSet(const std::string &strArg) const
Return true if the given argument has been manually set.
const fs::path & GetDataDirNet() const
Get data directory path with appended network identifier.
int64_t GetIntArg(const std::string &strArg, int64_t nDefault) const
Return integer argument or default value.
std::string GetArg(const std::string &strArg, const std::string &strDefault) const
Return string argument or default value.
bool SoftSetBoolArg(const std::string &strArg, bool fValue)
Set a boolean argument if it doesn't already have a value.
bool GetBoolArg(const std::string &strArg, bool fDefault) const
Return boolean argument or default value.
void AddHiddenArgs(const std::vector< std::string > &args)
Add many hidden arguments.
void AddArg(const std::string &name, const std::string &help, unsigned int flags, const OptionsCategory &cat)
Add argument.
fs::path GetPathArg(std::string arg, const fs::path &default_value={}) const
Return path argument or default value.
const std::list< SectionInfo > GetUnrecognizedSections() const
Log warnings for unrecognized section names in the config file.
std::string GetChainName() const
Looks for -regtest, -testnet and returns the appropriate BIP70 chain name.
std::atomic< bool > m_reopen_file
void Stop()
Stops the instance from staying in sync with blockchain updates.
BlockFilterIndex is used to store and retrieve block filters, hashes, and headers for a range of bloc...
static const std::string REGTEST
static const std::string TESTNET
static const std::string MAIN
BIP70 chain name strings (main, test or regtest)
The block chain is a tree shaped structure starting with the genesis block at the root,...
int64_t GetBlockTime() const
BlockHash GetBlockHash() const
CBlockIndex * Tip() const
Returns the index entry for the tip of this chain, or nullptr if none.
int Height() const
Return the maximal height in the chain.
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
bool DefaultConsistencyChecks() const
Default value for -checkmempool and -checkblockindex argument.
const ChainTxData & TxData() const
bool IsTestChain() const
If this chain is exclusively used for testing.
const Consensus::Params & GetConsensus() const
uint16_t GetDefaultPort() const
const CBlock & GenesisBlock() const
void UnregisterBackgroundSignalScheduler()
Unregister a CScheduler to give callbacks which should run in the background - these callbacks will n...
void RegisterBackgroundSignalScheduler(CScheduler &scheduler)
Register a CScheduler to give callbacks which should run in the background (may only be called once)
void FlushBackgroundCallbacks()
Call any remaining callbacks on the calling thread.
A combination of a network address (CNetAddr) and a (TCP) port.
std::string ToStringIPPort() const
static const int DEFAULT_ZMQ_SNDHWM
static CZMQNotificationInterface * Create()
Chainstate stores and provides an API to update our local knowledge of the current best chain.
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
CChain & ActiveChain() const EXCLUSIVE_LOCKS_REQUIRED(GetMutex())
const CChainParams & GetParams() const
node::BlockMap & BlockIndex() EXCLUSIVE_LOCKS_REQUIRED(
RecursiveMutex & GetMutex() const LOCK_RETURNED(
Alias for cs_main.
CBlockIndex * ActiveTip() const EXCLUSIVE_LOCKS_REQUIRED(GetMutex())
Chainstate &InitializeChainstate(CTxMemPool *mempool) EXCLUSIVE_LOCKS_REQUIRED(std::vector< Chainstate * GetAll)()
Instantiate a new chainstate.
node::BlockManager m_blockman
A single BlockManager instance is shared across each constructed chainstate to avoid duplicating bloc...
virtual uint64_t GetMaxBlockSize() const =0
virtual const CChainParams & GetChainParams() const =0
virtual bool SetMaxBlockSize(uint64_t maxBlockSize)=0
virtual void SetCashAddrEncoding(bool)=0
Different type to mark Mutex at global scope.
static bool TryParse(const std::string &str, NetWhitebindPermissions &output, bilingual_str &error)
static bool TryParse(const std::string &str, NetWhitelistPermissions &output, bilingual_str &error)
static std::unique_ptr< PeerManager > make(CConnman &connman, AddrMan &addrman, BanMan *banman, ChainstateManager &chainman, CTxMemPool &pool, bool ignore_incoming_txs)
Class for registering and managing all RPC calls.
virtual void AddWalletOptions(ArgsManager &argsman) const =0
Get wallet help string.
virtual void Construct(node::NodeContext &node) const =0
Add wallets that should be opened to list of chain clients.
virtual bool ParameterInteraction() const =0
Check wallet parameter interaction.
static std::unique_ptr< Processor > MakeProcessor(const ArgsManager &argsman, interfaces::Chain &chain, CConnman *connman, ChainstateManager &chainman, CTxMemPool *mempoolIn, CScheduler &scheduler, bilingual_str &error)
std::string ToString() const
std::string GetHex() const
Path class wrapper to block calls to the fs::path(std::string) implicit constructor and the fs::path:...
bool IsPruneMode() const
Whether running in -prune mode.
bool m_have_pruned
True if any block files have ever been pruned.
std::string FormatVersion(int nVersion)
std::string FormatUserAgent(const std::string &name, const std::string &version, const std::vector< std::string > &comments)
Format the subversion field according to BIP 14 spec.
static constexpr int CLIENT_VERSION
bitcoind-res.rc includes this file, but it cannot cope with real c++ code.
const std::string CLIENT_NAME
std::unique_ptr< CoinStatsIndex > g_coin_stats_index
The global UTXO set hash object.
static constexpr bool DEFAULT_COINSTATSINDEX
static const uint64_t DEFAULT_MAX_BLOCK_SIZE
Default setting for maximum allowed size for a block, in bytes.
RecursiveMutex cs_main
Mutex to guard access to validation specific variables, such as reading or changing the chainstate.
void SetupCurrencyUnitOptions(ArgsManager &argsman)
bilingual_str AmountErrMsg(const std::string &optname, const std::string &strValue)
bilingual_str ResolveErrMsg(const std::string &optname, const std::string &strBind)
uint256 SerializeHash(const T &obj, int nType=SER_GETHASH, int nVersion=PROTOCOL_VERSION)
Compute the 256-bit hash of an object's serialization.
void InterruptHTTPRPC()
Interrupt HTTP RPC subsystem.
void StopHTTPRPC()
Stop HTTP RPC subsystem.
bool StartHTTPRPC(HTTPRPCRequestProcessor &httpRPCRequestProcessor)
Start HTTP RPC subsystem.
void StartREST(const std::any &context)
Start HTTP REST subsystem.
void StopREST()
Stop HTTP REST subsystem.
void InterruptREST()
Interrupt RPC REST subsystem.
void InterruptHTTPServer()
Interrupt HTTP server threads.
void StartHTTPServer()
Start HTTP server.
void StopHTTPServer()
Stop HTTP server.
bool InitHTTPServer(Config &config)
Initialize HTTP server.
static const int DEFAULT_HTTP_SERVER_TIMEOUT
static const int DEFAULT_HTTP_WORKQUEUE
static const int DEFAULT_HTTP_THREADS
Common init functions shared by bitcoin-node, bitcoin-wallet, etc.
static const char * BITCOIN_PID_FILENAME
The PID file facilities.
static bool CreatePidFile(const ArgsManager &args)
static const bool DEFAULT_PROXYRANDOMIZE
void Interrupt(NodeContext &node)
Interrupt threads.
void InitLogging(const ArgsManager &args)
Initialize global loggers.
bool AppInitLockDataDirectory()
Lock bitcoin data directory.
void SetupServerArgs(NodeContext &node)
Register all arguments with the ArgsManager.
static bool AppInitServers(Config &config, HTTPRPCRequestProcessor &httpRPCRequestProcessor, NodeContext &node)
#define MIN_CORE_FILEDESCRIPTORS
void Shutdown(NodeContext &node)
static void HandleSIGTERM(int)
Signal handlers are very limited in what they are allowed to do.
static GlobalMutex g_genesis_wait_mutex
static void OnRPCStarted()
static void HandleSIGHUP(int)
static fs::path GetPidFile(const ArgsManager &args)
static std::condition_variable g_genesis_wait_cv
bool AppInitMain(Config &config, RPCServer &rpcServer, HTTPRPCRequestProcessor &httpRPCRequestProcessor, NodeContext &node, interfaces::BlockAndHeaderTipInfo *tip_info)
Bitcoin main initialization.
static constexpr bool DEFAULT_CHRONIK
bool AppInitBasicSetup(const ArgsManager &args)
Initialize bitcoin: Basic context setup.
bool AppInitSanityChecks()
Initialization sanity checks: ecc init, sanity checks, dir lock.
bool AppInitInterfaces(NodeContext &node)
Initialize node and wallet interface pointers.
static const char * DEFAULT_ASMAP_FILENAME
void InitParameterInteraction(ArgsManager &args)
Parameter interaction: change current parameters depending on various rules.
static void BlockNotifyGenesisWait(const CBlockIndex *pBlockIndex)
static void OnRPCStopped()
static bool LockDataDirectory(bool probeOnly)
static void registerSignalHandler(int signal, void(*handler)(int))
std::string LicenseInfo()
Returns licensing information (for -version)
bool AppInitParameterInteraction(Config &config, const ArgsManager &args)
Initialization: parameter interaction.
static const bool DEFAULT_REST_ENABLE
static boost::signals2::connection rpc_notify_block_change_connection
static void new_handler_terminate()
static constexpr bool DEFAULT_DAEMON
Default value for -daemon option.
static constexpr bool DEFAULT_DAEMONWAIT
Default value for -daemonwait option.
BCLog::Logger & LogInstance()
#define LogPrint(category,...)
void StartMapPort(bool use_upnp, bool use_natpmp)
static constexpr bool DEFAULT_NATPMP
static constexpr bool DEFAULT_UPNP
std::optional< bilingual_str > ApplyArgsManOptions(const ArgsManager &argsman, const CChainParams &chainparams, MemPoolOptions &mempool_opts)
Overlay the options set in argsman on top of corresponding members in mempool_opts.
static constexpr unsigned int DEFAULT_MAX_MEMPOOL_SIZE_MB
Default for -maxmempool, maximum megabytes of mempool memory usage.
static constexpr unsigned int DEFAULT_MEMPOOL_EXPIRY_HOURS
Default for -mempoolexpiry, expiration time for mempool transactions in hours.
std::string FormatMoney(const Amount amt)
Do not use these functions to represent or parse monetary amounts to or from JSON but use AmountFromV...
bool ParseMoney(const std::string &money_string, Amount &nRet)
Parse an amount denoted in full coins.
void OnStarted(std::function< void()> slot)
void OnStopped(std::function< void()> slot)
static constexpr Amount PROOF_DUST_THRESHOLD
Minimum amount per utxo.
static auto quoted(const std::string &s)
static bool exists(const path &p)
static std::string PathToString(const path &path)
Convert path object to byte string.
static path PathFromString(const std::string &string)
Convert byte string to path object.
std::string get_filesystem_error_message(const fs::filesystem_error &e)
void AddLoggingArgs(ArgsManager &argsman)
void SetLoggingCategories(const ArgsManager &args)
bool SanityChecks()
Ensure a usable environment with all necessary library support.
bool StartLogging(const ArgsManager &args)
void SetLoggingOptions(const ArgsManager &args)
std::unique_ptr< Chain > MakeChain(node::NodeContext &node, const CChainParams ¶ms)
Return implementation of Chain interface.
bool DumpMempool(const CTxMemPool &pool, const fs::path &dump_path, FopenFn mockable_fopen_function, bool skip_file_commit)
@ FAILURE_INCOMPATIBLE_DB
@ FAILURE_INSUFFICIENT_DBCACHE
const CBlockIndex *GetFirstStoredBlock(const CBlockIndex *start_block) EXCLUSIVE_LOCKS_REQUIRED(voi CleanupBlockRevFiles)()
Find the first block that is not pruned.
CacheSizes CalculateCacheSizes(const ArgsManager &args, size_t n_indexes)
fs::path MempoolPath(const ArgsManager &argsman)
void ApplyArgsManOptions(const ArgsManager &argsman, ValidationCacheSizes &cache_sizes)
bool ShouldPersistMempool(const ArgsManager &argsman)
static constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT
ChainstateLoadResult LoadChainstate(ChainstateManager &chainman, const CacheSizes &cache_sizes, const ChainstateLoadOptions &options)
This sequence can have 4 types of outcomes:
ChainstateLoadResult VerifyLoadedChainstate(ChainstateManager &chainman, const ChainstateLoadOptions &options)
void ThreadImport(const Config &config, ChainstateManager &chainman, std::vector< fs::path > vImportFiles, const ArgsManager &args, const fs::path &mempool_path)
static constexpr bool DEFAULT_PERSIST_MEMPOOL
Default for -persistmempool, indicating whether the node should attempt to automatically load the mem...
std::atomic_bool fReindex
bilingual_str ErrorString(const Result< T > &result)
void TraceThread(const char *thread_name, std::function< void()> thread_func)
A wrapper for do-something-once thread functions.
void ThreadRename(std::string &&)
Rename a thread both in terms of an internal (in-memory) name as well as its system thread name.
void SetReachable(enum Network net, bool reachable)
Mark a network as reachable or unreachable (no automatic connects to it)
bool AddLocal(const CService &addr, int nScore)
void Discover()
Look up IP addresses from all interfaces on the machine and add them to the list of local addresses t...
static const unsigned int DEFAULT_MAX_PEER_CONNECTIONS
The maximum number of peer connections to maintain.
static const unsigned int MAX_SUBVERSION_LENGTH
Maximum length of the user agent string in version message.
static const int MAX_ADDNODE_CONNECTIONS
Maximum number of addnode outgoing nodes.
static const size_t DEFAULT_MAXSENDBUFFER
static const int NUM_FDS_MESSAGE_CAPTURE
Number of file descriptors required for message capture.
static const bool DEFAULT_BLOCKSONLY
Default for blocks only.
static const bool DEFAULT_WHITELISTFORCERELAY
Default for -whitelistforcerelay.
static const bool DEFAULT_FORCEDNSSEED
static const bool DEFAULT_WHITELISTRELAY
Default for -whitelistrelay.
static constexpr uint64_t DEFAULT_MAX_UPLOAD_TARGET
The default for -maxuploadtarget.
static const size_t DEFAULT_MAXRECEIVEBUFFER
static const int DEFAULT_MAX_AVALANCHE_OUTBOUND_CONNECTIONS
Maximum number of avalanche enabled outgoing connections by default.
static const bool DEFAULT_FIXEDSEEDS
static const int MAX_FEELER_CONNECTIONS
Maximum number of feeler connections.
static const bool DEFAULT_LISTEN
-listen default
static const int64_t DEFAULT_PEER_CONNECT_TIMEOUT
-peertimeout default
static const bool DEFAULT_DNSSEED
static const int MAX_OUTBOUND_FULL_RELAY_CONNECTIONS
Maximum number of automatic outgoing nodes over which we'll relay everything (blocks,...
static const int MAX_BLOCK_RELAY_ONLY_CONNECTIONS
Maximum number of block-relay-only outgoing connections.
const std::vector< std::string > NET_PERMISSIONS_DOC
static const unsigned int DEFAULT_BLOCK_RECONSTRUCTION_EXTRA_TXN
Default number of orphan+recently-replaced txn to keep around for block reconstruction.
static const unsigned int DEFAULT_MAX_ORPHAN_TRANSACTIONS
Default for -maxorphantx, maximum number of orphan transactions kept in memory.
static const bool DEFAULT_PEERBLOCKFILTERS
@ NET_MAX
Dummy value to indicate the number of NET_* constants.
@ NET_ONION
TOR (v2 or v3)
@ NET_UNROUTABLE
Addresses from these networks are not publicly routable on the global Internet.
enum Network ParseNetwork(const std::string &net_in)
bool Lookup(const std::string &name, std::vector< CService > &vAddr, uint16_t portDefault, bool fAllowLookup, unsigned int nMaxSolutions, DNSLookupFn dns_lookup_function)
Resolve a service string to its corresponding service.
std::vector< std::string > GetNetworkNames(bool append_unroutable)
Return a vector of publicly routable Network names; optionally append NET_UNROUTABLE.
bool SetNameProxy(const proxyType &addrProxy)
Set the name proxy to use for all connections to nodes specified by a hostname.
bool IsBadPort(uint16_t port)
Determine if a port is "bad" from the perspective of attempting to connect to a node on that port.
bool SetProxy(enum Network net, const proxyType &addrProxy)
static const int DEFAULT_NAME_LOOKUP
-dns default
static const int DEFAULT_CONNECT_TIMEOUT
-timeout default
uint32_t nBytesPerSigCheck
static constexpr uint64_t DEFAULT_MAX_GENERATED_BLOCK_SIZE
Default for -blockmaxsize, which controls the maximum size of block the mining code will create.
static constexpr Amount DUST_RELAY_TX_FEE(1000 *SATOSHI)
Min feerate for defining dust.
static constexpr bool DEFAULT_PERMIT_BAREMULTISIG
Default for -permitbaremultisig.
static constexpr Amount DEFAULT_MIN_RELAY_TX_FEE_PER_KB(1000 *SATOSHI)
Default for -minrelaytxfee, minimum relay fee for transactions.
static constexpr unsigned int DEFAULT_BYTES_PER_SIGCHECK
Default for -bytespersigcheck .
static constexpr Amount DEFAULT_BLOCK_MIN_TX_FEE_PER_KB(1000 *SATOSHI)
Default for -blockmintxfee, which sets the minimum feerate for a transaction in blocks created by min...
static constexpr std::chrono::milliseconds AVALANCHE_DEFAULT_QUERY_TIMEOUT
How long before we consider that a query timed out.
static constexpr int AVALANCHE_DEFAULT_STAKE_UTXO_CONFIRMATIONS
Minimum number of confirmations before a stake utxo is mature enough to be included into a proof.
ServiceFlags
nServices flags.
void RandAddPeriodic() noexcept
Gather entropy from various expensive sources, and feed them to the PRNG state.
static void RegisterAllRPCCommands(const Config &config, RPCServer &rpcServer, CRPCTable &rpcTable)
Register all context-sensitive RPC commands.
bool(* handler)(Config &config, const std::any &context, HTTPRequest *req, const std::string &strReq)
const std::string UNIX_EPOCH_TIME
String used to describe UNIX epoch time in documentation, factored out to a constant for consistency.
bool InitScriptExecutionCache(size_t max_size_bytes)
Initializes the script-execution cache.
static constexpr size_t DEFAULT_MAX_SCRIPT_CACHE_BYTES
void SetRPCWarmupFinished()
Mark warmup as done.
void SetRPCWarmupStatus(const std::string &newStatus)
Set the RPC warmup status.
void RpcInterruptionPoint()
Throw JSONRPCError if RPC is not running.
bool ShutdownRequested()
Returns true if a shutdown is requested, false otherwise.
bool InitShutdownState()
Initialize shutdown state.
void StartShutdown()
Request shutdown of the application.
void AbortShutdown()
Clear shutdown flag.
bool InitSignatureCache(size_t max_size_bytes)
static constexpr size_t DEFAULT_MAX_SIG_CACHE_BYTES
static const unsigned int MAX_OP_RETURN_RELAY
Default setting for nMaxDatacarrierBytes.
static const bool DEFAULT_ACCEPT_DATACARRIER
std::string SanitizeString(const std::string &str, int rule)
Remove unsafe chars.
bool IsHexNumber(const std::string &str)
Return true if the string is a hex number, optionally prefixed with "0x".
@ SAFE_CHARS_UA_COMMENT
BIP-0014 subset.
void ReplaceAll(std::string &in_out, const std::string &search, const std::string &substitute)
auto Join(const std::vector< T > &list, const BaseType &separator, UnaryOp unary_op) -> decltype(unary_op(list.at(0)))
Join a list of items.
static constexpr Amount zero() noexcept
static BlockHash fromHex(const std::string &str)
int m_max_outbound_block_relay
unsigned int nReceiveFloodSize
int m_max_outbound_full_relay
std::vector< NetWhitebindPermissions > vWhiteBinds
uint64_t nMaxOutboundLimit
std::vector< NetWhitelistPermissions > vWhitelistedRange
CClientUIInterface * uiInterface
int m_max_avalanche_outbound
std::vector< CService > onion_binds
std::vector< std::string > m_specified_outgoing
ServiceFlags nLocalServices
std::vector< std::string > m_added_nodes
int64_t m_peer_connect_timeout
std::vector< CService > vBinds
unsigned int nSendBufferMaxSize
bool m_i2p_accept_incoming
std::vector< std::string > vSeedNodes
bool m_use_addrman_outgoing
std::vector< NetEventsInterface * > m_msgproc
bool bind_on_any
True if the user did not specify -bind= or -whitebind= and thus we should bind on 0....
BlockHash defaultAssumeValid
uint256 nMinimumChainWork
static const Currency & get()
Block and header tip information.
double verification_progress
An options struct for ChainstateManager, more ergonomically referred to as ChainstateManager::Options...
Options struct containing options for constructing a CTxMemPool.
int check_ratio
The ratio used to determine how often sanity checks will run.
bool require_full_verification
std::function< void()> coins_error_cb
std::function< bool()> check_interrupt
NodeContext struct containing references to chain state and connection state.
#define WAIT_LOCK(cs, name)
#define WITH_LOCK(cs, code)
Run code while locking a mutex.
#define TRY_LOCK(cs, name)
void SetupHelpOptions(ArgsManager &args)
Add help options to the args manager.
fs::path AbsPathForConfigVal(const fs::path &path, bool net_specific)
Most paths passed as configuration arguments are treated as relative to the datadir if they are not a...
const char *const BITCOIN_SETTINGS_FILENAME
std::string CopyrightHolders(const std::string &strPrefix)
bool LockDirectory(const fs::path &directory, const std::string lockfile_name, bool probe_only)
bool DirIsWritable(const fs::path &directory)
int RaiseFileDescriptorLimit(int nMinFD)
This function tries to raise the file descriptor limit to the requested number.
bool CheckDiskSpace(const fs::path &dir, uint64_t additional_bytes)
const char *const BITCOIN_CONF_FILENAME
int GetNumCores()
Return the number of cores available on the current system.
bool error(const char *fmt, const Args &...args)
int64_t GetTimeMillis()
Returns the system time (not mockable)
void SetMockTime(int64_t nMockTimeIn)
DEPRECATED Use SetMockTime with chrono type.
NodeClock::time_point GetAdjustedTime()
static const int64_t DEFAULT_MAX_TIME_ADJUSTMENT
CService DefaultOnionServiceTarget()
const std::string DEFAULT_TOR_CONTROL
Default control port.
void InterruptTorControl()
void StartTorControl(CService onion_service_target)
static const bool DEFAULT_LISTEN_ONION
bilingual_str _(const char *psz)
Translation function.
bilingual_str Untranslated(std::string original)
Mark a bilingual_str as untranslated.
util::Result< void > CheckLegacyTxindex(CBlockTreeDB &block_tree_db)
static constexpr int64_t MAX_DB_CACHE_MB
max. -dbcache (MiB)
static constexpr int64_t MIN_DB_CACHE_MB
min. -dbcache (MiB)
static constexpr int64_t DEFAULT_DB_BATCH_SIZE
-dbbatchsize default (bytes)
static constexpr int64_t DEFAULT_DB_CACHE_MB
-dbcache default (MiB)
std::unique_ptr< TxIndex > g_txindex
The global transaction index, used in GetTransaction. May be null.
static constexpr bool DEFAULT_TXINDEX
CClientUIInterface uiInterface
void InitWarning(const bilingual_str &str)
Show warning message.
bool InitError(const bilingual_str &str)
Show error message.
uint256 uint256S(const char *str)
uint256 from const char *.
void StartScriptCheckWorkerThreads(int threads_num)
Run instances of script checking worker threads.
arith_uint256 nMinimumChainWork
Minimum work we will assume exists on some valid chain.
std::condition_variable g_best_block_cv
double GuessVerificationProgress(const ChainTxData &data, const CBlockIndex *pindex)
Guess how far we are in the verification process at the given block index require cs_main if pindex h...
void StopScriptCheckWorkerThreads()
Stop all of the script checking worker threads.
const std::vector< std::string > CHECKLEVEL_DOC
Documentation for argument 'checklevel'.
BlockHash hashAssumeValid
Block hash whose ancestors we will assume to have valid scripts without checking them.
int64_t nMaxTipAge
If the tip is older than this (in seconds), the node is considered to be in initial block download.
static const bool DEFAULT_CHECKPOINTS_ENABLED
static const uint64_t MIN_DISK_SPACE_FOR_BLOCK_FILES
Require that user allocate at least 550 MiB for block & undo files (blk???.dat and rev?...
static const unsigned int DEFAULT_CHECKLEVEL
static const unsigned int MIN_BLOCKS_TO_KEEP
Block files containing a block-height within MIN_BLOCKS_TO_KEEP of ActiveChain().Tip() will not be pr...
static const int MAX_SCRIPTCHECK_THREADS
Maximum number of dedicated script-checking threads allowed.
SynchronizationState
Current sync state passed to tip changed callbacks.
static const int DEFAULT_SCRIPTCHECK_THREADS
-par default (number of script-checking threads, 0 = auto)
static const int64_t DEFAULT_MAX_TIP_AGE
static const signed int DEFAULT_CHECKBLOCKS
static const bool DEFAULT_PEERBLOOMFILTERS
static const int DEFAULT_STOPATHEIGHT
Default for -stopatheight.
CMainSignals & GetMainSignals()
void UnregisterAllValidationInterfaces()
Unregister all subscribers.
void UnregisterValidationInterface(CValidationInterface *callbacks)
Unregister subscriber.
void RegisterValidationInterface(CValidationInterface *callbacks)
Register subscriber.
static constexpr uint32_t AVALANCHE_VOTE_STALE_FACTOR
Scaling factor applied to confidence to determine staleness threshold.
static constexpr uint32_t AVALANCHE_VOTE_STALE_THRESHOLD
Number of votes before a record may be considered as stale.
const WalletInitInterface & g_wallet_init_interface
CZMQNotificationInterface * g_zmq_notification_interface
void RegisterZMQRPCCommands(CRPCTable &t)