6 #if defined(HAVE_CONFIG_H)
7 #include <config/bitcoin-config.h>
88 #include <boost/signals2/signal.hpp>
91 #include <chronik-cpp/chronik.h>
103 #include <sys/stat.h>
106 #include <condition_variable>
110 #include <functional>
141 #define MIN_CORE_FILEDESCRIPTORS 0
143 #define MIN_CORE_FILEDESCRIPTORS 150
205 if (
node.avalanche) {
208 node.avalanche->stopEventLoop();
211 node.connman->Interrupt();
223 static Mutex g_shutdown_mutex;
224 TRY_LOCK(g_shutdown_mutex, lock_shutdown);
225 if (!lock_shutdown) {
228 LogPrintf(
"%s: In progress...\n", __func__);
237 node.mempool->AddTransactionsUpdated(1);
244 for (
const auto &client :
node.chain_clients) {
255 if (
node.avalanche) {
256 node.avalanche->stopEventLoop();
265 node.connman->Stop();
272 if (
node.scheduler) {
273 node.scheduler->stop();
275 if (
node.chainman &&
node.chainman->m_load_block.joinable()) {
276 node.chainman->m_load_block.join();
282 node.peerman.reset();
285 node.avalanche.reset();
286 node.connman.reset();
288 node.addrman.reset();
290 if (
node.mempool &&
node.mempool->GetLoadTried() &&
300 if (chainstate->CanFlushToDisk()) {
301 chainstate->ForceFlushStateToDisk();
337 if (chainstate->CanFlushToDisk()) {
338 chainstate->ForceFlushStateToDisk();
339 chainstate->ResetCoinsViews();
343 for (
const auto &client :
node.chain_clients) {
354 node.chain_clients.clear();
358 node.mempool.reset();
359 node.chainman.reset();
360 node.scheduler.reset();
364 LogPrintf(
"%s: Unable to remove PID file: File does not exist\n",
367 }
catch (
const fs::filesystem_error &e) {
368 LogPrintf(
"%s: Unable to remove PID file: %s\n", __func__,
389 static BOOL WINAPI consoleCtrlHandler(DWORD dwCtrlType) {
400 sigemptyset(&sa.sa_mask);
402 sigaction(signal, &sa, NULL);
427 argsman.
AddArg(
"-help-debug",
428 "Print help message with debugging options and exit",
false,
433 const auto defaultBaseParams =
435 const auto testnetBaseParams =
437 const auto regtestBaseParams =
439 const auto defaultChainParams =
441 const auto testnetChainParams =
443 const auto regtestChainParams =
447 std::vector<std::string> hidden_args = {
452 "-automaticunparking",
453 "-replayprotectionactivationtime",
455 "-chronikallowpause",
458 "-allowselfsignedrootcertificates",
463 "-rootcertificates=<file>",
467 "-augustoactivationtime",
477 #if defined(HAVE_SYSTEM)
479 "-alertnotify=<cmd>",
480 "Execute command when a relevant alert is received or we see "
481 "a really long fork (%s in cmd is replaced by message)",
485 "-assumevalid=<hex>",
487 "If this block is in the chain assume that it and its ancestors "
488 "are valid and potentially skip their script verification (0 to "
489 "verify all, default: %s, testnet: %s)",
490 defaultChainParams->GetConsensus().defaultAssumeValid.GetHex(),
491 testnetChainParams->GetConsensus().defaultAssumeValid.GetHex()),
493 argsman.
AddArg(
"-blocksdir=<dir>",
494 "Specify directory to hold blocks subdirectory for *.dat "
495 "files (default: <datadir>)",
497 argsman.
AddArg(
"-fastprune",
498 "Use smaller block files and lower minimum prune height for "
502 #if defined(HAVE_SYSTEM)
503 argsman.
AddArg(
"-blocknotify=<cmd>",
504 "Execute command when the best block changes (%s in cmd is "
505 "replaced by block hash)",
508 argsman.
AddArg(
"-blockreconstructionextratxn=<n>",
509 strprintf(
"Extra transactions to keep in memory for compact "
510 "block reconstructions (default: %u)",
515 strprintf(
"Whether to reject transactions from network peers. "
516 "Automatic broadcast and rebroadcast of any transactions "
517 "from inbound peers is disabled, unless the peer has the "
518 "'forcerelay' permission. RPC transactions are"
519 " not affected. (default: %u)",
522 argsman.
AddArg(
"-coinstatsindex",
523 strprintf(
"Maintain coinstats index used by the "
524 "gettxoutsetinfo RPC (default: %u)",
529 strprintf(
"Specify path to read-only configuration file. Relative "
530 "paths will be prefixed by datadir location. (default: %s)",
533 argsman.
AddArg(
"-datadir=<dir>",
"Specify data directory",
537 strprintf(
"Maximum database write batch size in bytes (default: %u)",
543 strprintf(
"Set database cache size in MiB (%d to %d, default: %d)",
547 "-includeconf=<file>",
548 "Specify additional configuration file, relative to the -datadir path "
549 "(only useable from configuration file, not command line)",
551 argsman.
AddArg(
"-loadblock=<file>",
552 "Imports blocks from external file on startup",
554 argsman.
AddArg(
"-maxmempool=<n>",
555 strprintf(
"Keep the transaction memory pool below <n> "
556 "megabytes (default: %u)",
559 argsman.
AddArg(
"-maxorphantx=<n>",
560 strprintf(
"Keep at most <n> unconnectable transactions in "
561 "memory (default: %u)",
564 argsman.
AddArg(
"-mempoolexpiry=<n>",
565 strprintf(
"Do not keep transactions in the mempool longer "
566 "than <n> hours (default: %u)",
570 "-minimumchainwork=<hex>",
572 "Minimum work assumed to exist on a valid chain in hex "
573 "(default: %s, testnet: %s)",
574 defaultChainParams->GetConsensus().nMinimumChainWork.GetHex(),
575 testnetChainParams->GetConsensus().nMinimumChainWork.GetHex()),
580 strprintf(
"Set the number of script verification threads (%u to %d, 0 "
581 "= auto, <0 = leave that many cores free, default: %d)",
585 argsman.
AddArg(
"-persistmempool",
586 strprintf(
"Whether to save the mempool on shutdown and load "
587 "on restart (default: %u)",
592 strprintf(
"Specify pid file. Relative paths will be prefixed "
593 "by a net-specific datadir location. (default: %s)",
598 strprintf(
"Reduce storage requirements by enabling pruning (deleting) "
599 "of old blocks. This allows the pruneblockchain RPC to be "
600 "called to delete specific blocks, and enables automatic "
601 "pruning of old blocks if a target size in MiB is provided. "
602 "This mode is incompatible with -txindex, -coinstatsindex "
603 "and -rescan. Warning: Reverting this setting requires "
604 "re-downloading the entire blockchain. (default: 0 = disable "
605 "pruning blocks, 1 = allow manual pruning via RPC, >=%u = "
606 "automatically prune block files to stay under the specified "
607 "target size in MiB)",
611 "-reindex-chainstate",
612 "Rebuild chain state from the currently indexed blocks. When "
613 "in pruning mode or if blocks on disk might be corrupted, use "
614 "full -reindex instead.",
618 "Rebuild chain state and block index from the blk*.dat files on disk",
623 "Specify path to dynamic settings data file. Can be disabled with "
624 "-nosettings. File is written at runtime and not meant to be "
625 "edited by users (use %s instead for custom settings). Relative "
626 "paths will be prefixed by datadir location. (default: %s)",
630 argsman.
AddArg(
"-startupnotify=<cmd>",
"Execute command on startup.",
636 "Create new files with system default permissions, instead of umask "
637 "077 (only effective with disabled wallet functionality)",
640 hidden_args.emplace_back(
"-sysperms");
642 argsman.
AddArg(
"-txindex",
643 strprintf(
"Maintain a full transaction index, used by the "
644 "getrawtransaction rpc call (default: %d)",
650 strprintf(
"Enable the Chronik indexer, which can be read via a "
651 "dedicated HTTP/Protobuf interface (default: %d)",
655 "-chronikbind=<addr>[:port]",
657 "Bind the Chronik indexer to the given address to listen for "
658 "HTTP/Protobuf connections to access the index. Unlike the "
659 "JSON-RPC, it's ok to have this publicly exposed on the internet. "
660 "This option can be specified multiple times (default: %s; default "
661 "port: %u, testnet: %u, regtest: %u)",
662 Join(chronik::DEFAULT_BINDS,
", "),
663 defaultBaseParams->ChronikPort(), testnetBaseParams->ChronikPort(),
664 regtestBaseParams->ChronikPort()),
667 argsman.
AddArg(
"-chroniktokenindex",
668 "Enable token indexing in Chronik (default: 1)",
670 argsman.
AddArg(
"-chroniklokadidindex",
671 "Enable LOKAD ID indexing in Chronik (default: 1)",
673 argsman.
AddArg(
"-chronikreindex",
674 "Reindex the Chronik indexer from genesis, but leave the "
675 "other indexes untouched",
678 "-chroniktxnumcachebuckets",
680 "Tuning param of the TxNumCache, specifies how many buckets "
681 "to use on the belt. Caution against setting this too high, "
682 "it may slow down indexing. Set to 0 to disable. (default: %d)",
683 chronik::DEFAULT_TX_NUM_CACHE_BUCKETS),
686 "-chroniktxnumcachebucketsize",
688 "Tuning param of the TxNumCache, specifies the size of each bucket "
689 "on the belt. Unlike the number of buckets, this may be increased "
690 "without much danger of slowing the indexer down. The total cache "
691 "size will be `num_buckets * bucket_size * 40B`, so by default the "
692 "cache will require %dkB of memory. (default: %d)",
693 chronik::DEFAULT_TX_NUM_CACHE_BUCKETS *
694 chronik::DEFAULT_TX_NUM_CACHE_BUCKET_SIZE * 40 / 1000,
695 chronik::DEFAULT_TX_NUM_CACHE_BUCKET_SIZE),
697 argsman.
AddArg(
"-chronikperfstats",
698 "Output some performance statistics (e.g. num cache hits, "
699 "seconds spent) into a <datadir>/perf folder. (default: 0)",
703 "-blockfilterindex=<type>",
704 strprintf(
"Maintain an index of compact filters by block "
705 "(default: %s, values: %s).",
707 " If <type> is not supplied or if <type> = 1, indexes for "
708 "all known types are enabled.",
712 "Use Cash Address for destination encoding instead of base58 "
713 "(activate by default on Jan, 14)",
718 "Add a node to connect to and attempt to keep the connection "
719 "open (see the `addnode` RPC command help for more info)",
722 argsman.
AddArg(
"-asmap=<file>",
723 strprintf(
"Specify asn mapping used for bucketing of the "
724 "peers (default: %s). Relative paths will be "
725 "prefixed by the net-specific datadir location.",
728 argsman.
AddArg(
"-bantime=<n>",
729 strprintf(
"Default duration (in seconds) of manually "
730 "configured bans (default: %u)",
734 "-bind=<addr>[:<port>][=onion]",
735 strprintf(
"Bind to given address and always listen on it (default: "
736 "0.0.0.0). Use [host]:port notation for IPv6. Append =onion "
737 "to tag any incoming connections to that address and port as "
738 "incoming Tor connections (default: 127.0.0.1:%u=onion, "
739 "testnet: 127.0.0.1:%u=onion, regtest: 127.0.0.1:%u=onion)",
740 defaultBaseParams->OnionServiceTargetPort(),
741 testnetBaseParams->OnionServiceTargetPort(),
742 regtestBaseParams->OnionServiceTargetPort()),
747 "Connect only to the specified node(s); -connect=0 disables automatic "
748 "connections (the rules for this peer are the same as for -addnode)",
753 "Discover own IP addresses (default: 1 when listening and no "
754 "-externalip or -proxy)",
757 strprintf(
"Allow DNS lookups for -addnode, -seednode and "
758 "-connect (default: %d)",
764 "Query for peer addresses via DNS lookup, if low on addresses "
765 "(default: %u unless -connect used)",
768 argsman.
AddArg(
"-externalip=<ip>",
"Specify your own public address",
773 "Allow fixed seeds if DNS seeds don't provide peers (default: %u)",
779 "Always query for peer addresses via DNS lookup (default: %d)",
782 argsman.
AddArg(
"-overridednsseed",
783 "If set, only use the specified DNS seed when "
784 "querying for peer addresses via DNS lookup.",
788 "Accept connections from outside (default: 1 if no -proxy or -connect)",
792 strprintf(
"Automatically create Tor onion service (default: %d)",
796 "-maxconnections=<n>",
797 strprintf(
"Maintain at most <n> connections to peers. The effective "
798 "limit depends on system limitations and might be lower than "
799 "the specified value (default: %u)",
802 argsman.
AddArg(
"-maxreceivebuffer=<n>",
803 strprintf(
"Maximum per-connection receive buffer, <n>*1000 "
804 "bytes (default: %u)",
808 "-maxsendbuffer=<n>",
810 "Maximum per-connection send buffer, <n>*1000 bytes (default: %u)",
814 "-maxtimeadjustment",
815 strprintf(
"Maximum allowed median peer time offset adjustment. Local "
816 "perspective of time may be influenced by peers forward or "
817 "backward by this amount. (default: %u seconds)",
820 argsman.
AddArg(
"-onion=<ip:port>",
821 strprintf(
"Use separate SOCKS5 proxy to reach peers via Tor "
822 "onion services (default: %s)",
825 argsman.
AddArg(
"-i2psam=<ip:port>",
826 "I2P SAM proxy to reach I2P peers and accept I2P "
827 "connections (default: none)",
830 "-i2pacceptincoming",
831 "If set and -i2psam is also set then incoming I2P connections are "
832 "accepted via the SAM proxy. If this is not set but -i2psam is set "
833 "then only outgoing connections will be made to the I2P network. "
834 "Ignored if -i2psam is not set. Listening for incoming I2P connections "
835 "is done through the SAM proxy, not by binding to a local address and "
841 "Make outgoing connections only through network <net> (" +
843 "). Incoming connections are not affected by this option. This "
844 "option can be specified multiple times to allow multiple "
845 "networks. Warning: if it is used with non-onion networks "
846 "and the -onion or -proxy option is set, then outbound onion "
847 "connections will still be made; use -noonion or -onion=0 to "
848 "disable outbound onion connections in this case",
850 argsman.
AddArg(
"-peerbloomfilters",
851 strprintf(
"Support filtering of blocks and transaction with "
852 "bloom filters (default: %d)",
858 "Serve compact block filters to peers per BIP 157 (default: %u)",
861 argsman.
AddArg(
"-permitbaremultisig",
862 strprintf(
"Relay non-P2SH multisig (default: %d)",
868 argsman.
AddArg(
"-port=<port>",
869 strprintf(
"Listen for connections on <port>. Nodes not "
870 "using the default ports (default: %u, "
871 "testnet: %u, regtest: %u) are unlikely to get "
872 "incoming connections. Not relevant for I2P (see "
874 defaultChainParams->GetDefaultPort(),
875 testnetChainParams->GetDefaultPort(),
876 regtestChainParams->GetDefaultPort()),
879 argsman.
AddArg(
"-proxy=<ip:port>",
"Connect through SOCKS5 proxy",
883 strprintf(
"Randomize credentials for every proxy connection. "
884 "This enables Tor stream isolation (default: %d)",
889 "Connect to a node to retrieve peer addresses, and disconnect",
893 "Enable all P2P network activity (default: 1). Can be changed "
894 "by the setnetworkactive RPC command",
896 argsman.
AddArg(
"-timeout=<n>",
897 strprintf(
"Specify connection timeout in milliseconds "
898 "(minimum: 1, default: %d)",
903 strprintf(
"Specify p2p connection timeout in seconds. This option "
904 "determines the amount of time a peer may be inactive before "
905 "the connection to it is dropped. (minimum: 1, default: %d)",
909 "-torcontrol=<ip>:<port>",
911 "Tor control port to use if onion listening enabled (default: %s)",
914 argsman.
AddArg(
"-torpassword=<pass>",
915 "Tor control port password (default: empty)",
921 "Use UPnP to map the listening port (default: 1 when "
922 "listening and no -proxy)",
927 strprintf(
"Use UPnP to map the listening port (default: %u)", 0),
931 hidden_args.emplace_back(
"-upnp");
936 strprintf(
"Use NAT-PMP to map the listening port (default: %s)",
940 hidden_args.emplace_back(
"-natpmp");
943 "-whitebind=<[permissions@]addr>",
944 "Bind to the given address and add permission flags to the peers "
946 "Use [host]:port notation for IPv6. Allowed permissions: " +
949 "Specify multiple permissions separated by commas (default: "
950 "download,noban,mempool,relay). Can be specified multiple times.",
953 argsman.
AddArg(
"-whitelist=<[permissions@]IP address or network>",
954 "Add permission flags to the peers connecting from the "
955 "given IP address (e.g. 1.2.3.4) or CIDR-notated network "
956 "(e.g. 1.2.3.0/24). "
957 "Uses the same permissions as -whitebind. Can be specified "
961 "-maxuploadtarget=<n>",
962 strprintf(
"Tries to keep outbound traffic under the given target (in "
963 "MiB per 24h). Limit does not apply to peers with 'download' "
964 "permission. 0 = no limit (default: %d)",
971 argsman.
AddArg(
"-zmqpubhashblock=<address>",
972 "Enable publish hash block in <address>",
974 argsman.
AddArg(
"-zmqpubhashtx=<address>",
975 "Enable publish hash transaction in <address>",
977 argsman.
AddArg(
"-zmqpubrawblock=<address>",
978 "Enable publish raw block in <address>",
980 argsman.
AddArg(
"-zmqpubrawtx=<address>",
981 "Enable publish raw transaction in <address>",
983 argsman.
AddArg(
"-zmqpubsequence=<address>",
984 "Enable publish hash block and tx sequence in <address>",
987 "-zmqpubhashblockhwm=<n>",
988 strprintf(
"Set publish hash block outbound message high water "
989 "mark (default: %d)",
993 "-zmqpubhashtxhwm=<n>",
994 strprintf(
"Set publish hash transaction outbound message high "
995 "water mark (default: %d)",
999 "-zmqpubrawblockhwm=<n>",
1000 strprintf(
"Set publish raw block outbound message high water "
1001 "mark (default: %d)",
1005 "-zmqpubrawtxhwm=<n>",
1006 strprintf(
"Set publish raw transaction outbound message high "
1007 "water mark (default: %d)",
1010 argsman.
AddArg(
"-zmqpubsequencehwm=<n>",
1011 strprintf(
"Set publish hash sequence message high water mark"
1016 hidden_args.emplace_back(
"-zmqpubhashblock=<address>");
1017 hidden_args.emplace_back(
"-zmqpubhashtx=<address>");
1018 hidden_args.emplace_back(
"-zmqpubrawblock=<address>");
1019 hidden_args.emplace_back(
"-zmqpubrawtx=<address>");
1020 hidden_args.emplace_back(
"-zmqpubsequence=<n>");
1021 hidden_args.emplace_back(
"-zmqpubhashblockhwm=<n>");
1022 hidden_args.emplace_back(
"-zmqpubhashtxhwm=<n>");
1023 hidden_args.emplace_back(
"-zmqpubrawblockhwm=<n>");
1024 hidden_args.emplace_back(
"-zmqpubrawtxhwm=<n>");
1025 hidden_args.emplace_back(
"-zmqpubsequencehwm=<n>");
1030 strprintf(
"How many blocks to check at startup (default: %u, 0 = all)",
1034 argsman.
AddArg(
"-checklevel=<n>",
1035 strprintf(
"How thorough the block verification of "
1036 "-checkblocks is: %s (0-4, default: %u)",
1040 argsman.
AddArg(
"-checkblockindex",
1041 strprintf(
"Do a consistency check for the block tree, "
1042 "chainstate, and other validation data structures "
1043 "occasionally. (default: %u, regtest: %u)",
1044 defaultChainParams->DefaultConsistencyChecks(),
1045 regtestChainParams->DefaultConsistencyChecks()),
1048 argsman.
AddArg(
"-checkaddrman=<n>",
1049 strprintf(
"Run addrman consistency checks every <n> "
1050 "operations. Use 0 to disable. (default: %u)",
1055 "-checkmempool=<n>",
1056 strprintf(
"Run mempool consistency checks every <n> transactions. Use "
1057 "0 to disable. (default: %u, regtest: %u)",
1058 defaultChainParams->DefaultConsistencyChecks(),
1059 regtestChainParams->DefaultConsistencyChecks()),
1062 argsman.
AddArg(
"-checkpoints",
1063 strprintf(
"Only accept block chain matching built-in "
1064 "checkpoints (default: %d)",
1068 argsman.
AddArg(
"-deprecatedrpc=<method>",
1069 "Allows deprecated RPC method(s) to be used",
1073 "-stopafterblockimport",
1074 strprintf(
"Stop running after importing blocks from disk (default: %d)",
1078 argsman.
AddArg(
"-stopatheight",
1079 strprintf(
"Stop running after reaching the given height in "
1080 "the main chain (default: %u)",
1084 argsman.
AddArg(
"-addrmantest",
"Allows to test address relay on localhost",
1087 argsman.
AddArg(
"-capturemessages",
"Capture all P2P messages to disk",
1090 argsman.
AddArg(
"-mocktime=<n>",
1096 "-maxsigcachesize=<n>",
1097 strprintf(
"Limit size of signature cache to <n> MiB (default: %u)",
1102 "-maxscriptcachesize=<n>",
1103 strprintf(
"Limit size of script cache to <n> MiB (default: %u)",
1107 argsman.
AddArg(
"-maxtipage=<n>",
1108 strprintf(
"Maximum tip age in seconds to consider node in "
1109 "initial block download (default: %u)",
1114 argsman.
AddArg(
"-uacomment=<cmt>",
1115 "Append comment to the user agent string",
1117 argsman.
AddArg(
"-uaclientname=<clientname>",
"Set user agent client name",
1119 argsman.
AddArg(
"-uaclientversion=<clientversion>",
1128 "Relay and mine \"non-standard\" transactions (%sdefault: %u)",
1129 "testnet/regtest only; ", defaultChainParams->RequireStandard()),
1132 argsman.
AddArg(
"-excessiveblocksize=<n>",
1133 strprintf(
"Do not accept blocks larger than this limit, in "
1134 "bytes (default: %d)",
1140 "-dustrelayfee=<amt>",
1141 strprintf(
"Fee rate (in %s/kB) used to define dust, the value of an "
1142 "output such that it will cost about 1/3 of its value in "
1143 "fees at this fee rate to spend it. (default: %s)",
1149 "-bytespersigcheck",
1150 strprintf(
"Equivalent bytes per sigCheck in transactions for relay and "
1151 "mining (default: %u).",
1156 strprintf(
"DEPRECATED: Equivalent bytes per sigCheck in transactions "
1157 "for relay and mining (default: %u). This has been "
1158 "deprecated since v0.26.8 and will be removed in the future, "
1159 "please use -bytespersigcheck instead.",
1164 strprintf(
"Relay and mine data carrier transactions (default: %d)",
1169 strprintf(
"Maximum size of data in data carrier transactions "
1170 "we relay and mine (default: %u)",
1174 "-minrelaytxfee=<amt>",
1175 strprintf(
"Fees (in %s/kB) smaller than this are rejected for "
1176 "relaying, mining and transaction creation (default: %s)",
1181 strprintf(
"Add 'relay' permission to whitelisted inbound peers "
1182 "with default permissions. This will accept relayed "
1183 "transactions even when not relaying transactions "
1188 "-whitelistforcerelay",
1189 strprintf(
"Add 'forcerelay' permission to whitelisted inbound peers"
1190 " with default permissions. This will relay transactions "
1191 "even if the transactions were already in the mempool "
1196 argsman.
AddArg(
"-blockmaxsize=<n>",
1197 strprintf(
"Set maximum block size in bytes (default: %d)",
1201 "-blockmintxfee=<amt>",
1202 strprintf(
"Set lowest fee rate (in %s/kB) for transactions to "
1203 "be included in block creation. (default: %s)",
1207 argsman.
AddArg(
"-blockversion=<n>",
1208 "Override block version to test forking scenarios",
1212 argsman.
AddArg(
"-server",
"Accept command line and JSON-RPC commands",
1215 strprintf(
"Accept public REST requests (default: %d)",
1219 "-rpcbind=<addr>[:port]",
1220 "Bind to given address to listen for JSON-RPC connections. Do not "
1221 "expose the RPC server to untrusted networks such as the public "
1222 "internet! This option is ignored unless -rpcallowip is also passed. "
1223 "Port is optional and overrides -rpcport. Use [host]:port notation "
1224 "for IPv6. This option can be specified multiple times (default: "
1225 "127.0.0.1 and ::1 i.e., localhost)",
1231 strprintf(
"Throw a non-fatal error at runtime if the documentation for "
1232 "an RPC is incorrect (default: %u)",
1236 "-rpccookiefile=<loc>",
1237 "Location of the auth cookie. Relative paths will be prefixed "
1238 "by a net-specific datadir location. (default: data dir)",
1240 argsman.
AddArg(
"-rpcuser=<user>",
"Username for JSON-RPC connections",
1243 argsman.
AddArg(
"-rpcpassword=<pw>",
"Password for JSON-RPC connections",
1247 "-rpcwhitelist=<whitelist>",
1248 "Set a whitelist to filter incoming RPC calls for a specific user. The "
1249 "field <whitelist> comes in the format: <USERNAME>:<rpc 1>,<rpc "
1250 "2>,...,<rpc n>. If multiple whitelists are set for a given user, they "
1251 "are set-intersected. See -rpcwhitelistdefault documentation for "
1252 "information on default whitelist behavior.",
1255 "-rpcwhitelistdefault",
1256 "Sets default behavior for rpc whitelisting. Unless "
1257 "rpcwhitelistdefault is set to 0, if any -rpcwhitelist is set, the rpc "
1258 "server acts as if all rpc users are subject to "
1259 "empty-unless-otherwise-specified whitelists. If rpcwhitelistdefault "
1260 "is set to 1 and no -rpcwhitelist is set, rpc server acts as if all "
1261 "rpc users are subject to empty whitelists.",
1264 "-rpcauth=<userpw>",
1265 "Username and HMAC-SHA-256 hashed password for JSON-RPC connections. "
1266 "The field <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. A "
1267 "canonical python script is included in share/rpcauth. The client then "
1268 "connects normally using the rpcuser=<USERNAME>/rpcpassword=<PASSWORD> "
1269 "pair of arguments. This option can be specified multiple times",
1271 argsman.
AddArg(
"-rpcport=<port>",
1272 strprintf(
"Listen for JSON-RPC connections on <port> "
1273 "(default: %u, testnet: %u, regtest: %u)",
1274 defaultBaseParams->RPCPort(),
1275 testnetBaseParams->RPCPort(),
1276 regtestBaseParams->RPCPort()),
1281 "Allow JSON-RPC connections from specified source. Valid for "
1282 "<ip> are a single IP (e.g. 1.2.3.4), a network/netmask (e.g. "
1283 "1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). "
1284 "This option can be specified multiple times",
1289 "Set the number of threads to service RPC calls (default: %d)",
1293 "-rpccorsdomain=value",
1294 "Domain from which to accept cross origin requests (browser enforced)",
1297 argsman.
AddArg(
"-rpcworkqueue=<n>",
1298 strprintf(
"Set the depth of the work queue to service RPC "
1299 "calls (default: %d)",
1303 argsman.
AddArg(
"-rpcservertimeout=<n>",
1304 strprintf(
"Timeout during HTTP requests (default: %d)",
1310 argsman.
AddArg(
"-daemon",
1311 strprintf(
"Run in the background as a daemon and accept "
1312 "commands (default: %d)",
1315 argsman.
AddArg(
"-daemonwait",
1316 strprintf(
"Wait for initialization to be finished before "
1317 "exiting. This implies -daemon (default: %d)",
1321 hidden_args.emplace_back(
"-daemon");
1322 hidden_args.emplace_back(
"-daemonwait");
1326 argsman.
AddArg(
"-avalanche",
1327 strprintf(
"Enable the avalanche feature (default: %u)",
1331 "-avalanchestakingrewards",
1332 strprintf(
"Enable the avalanche staking rewards feature (default: %u, "
1333 "testnet: %u, regtest: %u)",
1334 defaultChainParams->GetConsensus().enableStakingRewards,
1335 testnetChainParams->GetConsensus().enableStakingRewards,
1336 regtestChainParams->GetConsensus().enableStakingRewards),
1338 argsman.
AddArg(
"-avalancheconflictingproofcooldown",
1339 strprintf(
"Mandatory cooldown before a proof conflicting "
1340 "with an already registered one can be considered "
1341 "in seconds (default: %u)",
1344 argsman.
AddArg(
"-avalanchepeerreplacementcooldown",
1345 strprintf(
"Mandatory cooldown before a peer can be replaced "
1346 "in seconds (default: %u)",
1350 "-avaminquorumstake",
1352 "Minimum amount of known stake for a usable quorum (default: %s)",
1356 "-avaminquorumconnectedstakeratio",
1357 strprintf(
"Minimum proportion of known stake we"
1358 " need nodes for to have a usable quorum (default: %s)",
1362 "-avaminavaproofsnodecount",
1363 strprintf(
"Minimum number of node that needs to send us an avaproofs"
1364 " message before we consider we have a usable quorum"
1369 "-avastalevotethreshold",
1370 strprintf(
"Number of avalanche votes before a voted item goes stale "
1371 "when voting confidence is low (default: %u)",
1375 "-avastalevotefactor",
1377 "Factor affecting the number of avalanche votes before a voted "
1378 "item goes stale when voting confidence is high (default: %u)",
1381 argsman.
AddArg(
"-avacooldown",
1382 strprintf(
"Mandatory cooldown between two avapoll in "
1383 "milliseconds (default: %u)",
1388 strprintf(
"Avalanche query timeout in milliseconds (default: %u)",
1393 "Avalanche proof delegation to the master key used by this node "
1394 "(default: none). Should be used in conjunction with -avaproof and "
1397 argsman.
AddArg(
"-avaproof",
1398 "Avalanche proof to be used by this node (default: none)",
1401 "-avaproofstakeutxoconfirmations",
1403 "Minimum number of confirmations before a stake utxo is mature"
1404 " enough to be included into a proof. Utxos in the mempool are not "
1405 "accepted (i.e this value must be greater than 0) (default: %s)",
1408 argsman.
AddArg(
"-avaproofstakeutxodustthreshold",
1409 strprintf(
"Minimum value each stake utxo must have to be "
1410 "considered valid (default: %s)",
1413 argsman.
AddArg(
"-avamasterkey",
1414 "Master key associated with the proof. If a proof is "
1415 "required, this is mandatory.",
1418 argsman.
AddArg(
"-avasessionkey",
"Avalanche session key (default: random)",
1422 "-maxavalancheoutbound",
1424 "Set the maximum number of avalanche outbound peers to connect to. "
1425 "Note that this option takes precedence over the -maxconnections "
1426 "option (default: %u).",
1431 strprintf(
"Whether to save the avalanche peers upon shutdown and load "
1432 "them upon startup (default: %u).",
1436 hidden_args.emplace_back(
"-avalanchepreconsensus");
1447 if (pBlockIndex !=
nullptr) {
1457 static void StartupNotify(
const ArgsManager &args) {
1458 std::string cmd = args.
GetArg(
"-startupnotify",
"");
1460 std::thread t(runCommand, cmd);
1498 "%s: parameter interaction: -bind set -> setting -listen=1\n",
1504 LogPrintf(
"%s: parameter interaction: -whitebind set -> setting "
1514 LogPrintf(
"%s: parameter interaction: -connect set -> setting "
1519 LogPrintf(
"%s: parameter interaction: -connect set -> setting "
1530 "%s: parameter interaction: -proxy set -> setting -listen=0\n",
1538 "%s: parameter interaction: -proxy set -> setting -upnp=0\n",
1543 "%s: parameter interaction: -proxy set -> setting -natpmp=0\n",
1548 LogPrintf(
"%s: parameter interaction: -proxy set -> setting "
1559 "%s: parameter interaction: -listen=0 -> setting -upnp=0\n",
1564 "%s: parameter interaction: -listen=0 -> setting -natpmp=0\n",
1569 "%s: parameter interaction: -listen=0 -> setting -discover=0\n",
1573 LogPrintf(
"%s: parameter interaction: -listen=0 -> setting "
1578 LogPrintf(
"%s: parameter interaction: -listen=0 -> setting "
1579 "-i2pacceptincoming=0\n",
1584 if (args.
IsArgSet(
"-externalip")) {
1587 LogPrintf(
"%s: parameter interaction: -externalip set -> setting "
1596 LogPrintf(
"%s: parameter interaction: -blocksonly=1 -> setting "
1597 "-whitelistrelay=0\n",
1606 LogPrintf(
"%s: parameter interaction: -whitelistforcerelay=1 -> "
1607 "setting -whitelistrelay=1\n",
1614 const bool fAvalanche =
1633 int nMaxConnections;
1634 int nUserMaxConnections;
1637 int64_t peer_connect_timeout;
1638 std::set<BlockFilterType> g_enabled_filter_types;
1646 std::set_new_handler(std::terminate);
1647 LogPrintf(
"Error: Out of memory. Terminating.\n");
1657 _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
1658 _CrtSetReportFile(_CRT_WARN, CreateFileA(
"NUL", GENERIC_WRITE, 0,
nullptr,
1659 OPEN_EXISTING, 0, 0));
1661 _set_abort_behavior(0, _WRITE_ABORT_MSG | _CALL_REPORTFAULT);
1665 SetProcessDEPPolicy(PROCESS_DEP_ENABLE);
1669 Untranslated(
"Initializing wait-for-shutdown state failed."));
1690 signal(SIGPIPE, SIG_IGN);
1692 SetConsoleCtrlHandler(consoleCtrlHandler,
true);
1712 errors +=
strprintf(
_(
"Config setting for %s only applied on %s "
1713 "network when in [%s] section.") +
1715 arg, network, network);
1718 if (!errors.
empty()) {
1726 _(
"Section [%s] is not recognized.") +
1728 section.m_file, section.m_line, section.m_name);
1731 if (!warnings.
empty()) {
1737 strprintf(
_(
"Specified blocks directory \"%s\" does not exist."),
1738 args.
GetArg(
"-blocksdir",
"")));
1742 std::string blockfilterindex_value =
1744 if (blockfilterindex_value ==
"" || blockfilterindex_value ==
"1") {
1746 }
else if (blockfilterindex_value !=
"0") {
1747 const std::vector<std::string> names =
1748 args.
GetArgs(
"-blockfilterindex");
1749 for (
const auto &
name : names) {
1755 g_enabled_filter_types.insert(filter_type);
1764 _(
"Cannot set -peerblockfilters without -blockfilterindex."));
1773 return InitError(
_(
"Prune mode is incompatible with -txindex."));
1777 _(
"Prune mode is incompatible with -coinstatsindex."));
1780 return InitError(
_(
"Prune mode is incompatible with -chronik."));
1786 args.
GetArgs(
"-bind").size() + args.
GetArgs(
"-whitebind").size();
1789 "Cannot set -bind or -whitebind together with -listen=0"));
1793 int nBind = std::max(nUserBind,
size_t(1));
1794 nUserMaxConnections =
1796 nMaxConnections = std::max(nUserMaxConnections, 0);
1799 const int maxAvalancheOutbound = args.
GetIntArg(
1801 const bool fAvalanche =
1803 if (fAvalanche && maxAvalancheOutbound > nMaxConnections) {
1804 nMaxConnections = std::max(maxAvalancheOutbound, nMaxConnections);
1806 LogPrintf(
"Increasing -maxconnections from %d to %d to comply with "
1807 "-maxavalancheoutbound\n",
1808 nUserMaxConnections, nMaxConnections);
1820 int fd_max = FD_SETSIZE;
1822 nMaxConnections = std::max(
1823 std::min<int>(nMaxConnections,
1828 return InitError(
_(
"Not enough file descriptors available."));
1834 if (nMaxConnections < nUserMaxConnections) {
1838 LogPrintf(
"Reducing -maxconnections from %d to %d, because of system "
1840 nUserMaxConnections, nMaxConnections);
1847 const int64_t nProposedExcessiveBlockSize =
1849 if (nProposedExcessiveBlockSize <= 0 ||
1852 _(
"Excessive block size must be > 1,000,000 bytes (1MB)"));
1856 const int64_t nProposedMaxGeneratedBlockSize =
1858 if (nProposedMaxGeneratedBlockSize <= 0) {
1859 return InitError(
_(
"Max generated block size must be greater than 0"));
1861 if (uint64_t(nProposedMaxGeneratedBlockSize) > config.
GetMaxBlockSize()) {
1862 return InitError(
_(
"Max generated block size (blockmaxsize) cannot "
1863 "exceed the excessive block size "
1864 "(excessiveblocksize)"));
1872 peer_connect_timeout =
1874 if (peer_connect_timeout <= 0) {
1876 "peertimeout cannot be configured with a negative value."));
1882 if (args.
IsArgSet(
"-blockmintxfee")) {
1886 args.
GetArg(
"-blockmintxfee",
"")));
1906 if (args.
IsArgSet(
"-proxy") && args.
GetArg(
"-proxy",
"").empty()) {
1908 "No proxy server specified. Use -proxy=<ip> or -proxy=<ip:port>."));
1912 const int64_t stakeUtxoMinConfirmations =
1913 args.
GetIntArg(
"-avaproofstakeutxoconfirmations",
1917 stakeUtxoMinConfirmations !=
1919 return InitError(
_(
"Avalanche stake UTXO minimum confirmations can "
1920 "only be set on test chains."));
1923 if (stakeUtxoMinConfirmations <= 0) {
1924 return InitError(
_(
"Avalanche stake UTXO minimum confirmations must be "
1925 "a positive integer."));
1928 if (args.
IsArgSet(
"-avaproofstakeutxodustthreshold")) {
1931 args.
GetArg(
"-avaproofstakeutxodustthreshold",
""), amount);
1934 "avaproofstakeutxodustthreshold",
1935 args.
GetArg(
"-avaproofstakeutxodustthreshold",
"")));
1940 return InitError(
_(
"Avalanche stake UTXO dust threshold can "
1941 "only be set on test chains."));
1946 if (fAvalanche && args.
IsArgSet(
"-avaproof")) {
1948 return InitError(
_(
"Running a staking node requires accepting "
1949 "inbound connections. Please enable -listen."));
1952 return InitError(
_(
"Running a staking node behind a proxy is not "
1953 "supported. Please disable -proxy."));
1956 return InitError(
_(
"Running a staking node behind I2P is not "
1957 "supported. Please disable -i2psam."));
1961 _(
"Restricting the outbound network is not supported when "
1962 "running a staking node. Please disable -onlynet."));
1972 .notifications = notifications,
1977 BlockManager::Options blockman_opts_dummy{
1978 .chainparams = chainman_opts_dummy.config.GetChainParams(),
1994 _(
"Cannot write to data directory '%s'; check permissions."),
1999 "%s. %s is probably already running."),
2013 _(
"Initialization sanity check failed. %s is shutting down."),
2062 LogPrintf(
"Using at most %i automatic connections (%i file descriptors "
2064 nMaxConnections, nFD);
2068 !args.
GetPathArg(
"-datadir").is_absolute()) {
2069 LogPrintf(
"Warning: relative datadir option '%s' specified, which will "
2070 "be interpreted relative to the current working directory "
2071 "'%s'. This is fragile, because if bitcoin is started in the "
2072 "future from a different location, it will be unable to "
2073 "locate the current data files. There could also be data "
2074 "loss if bitcoin is started while in a temporary "
2076 args.
GetArg(
"-datadir",
""),
2085 _(
"Unable to allocate memory for -maxsigcachesize: '%s' MiB"),
2090 validation_cache_sizes.script_execution_cache_bytes)) {
2092 _(
"Unable to allocate memory for -maxscriptcachesize: '%s' MiB"),
2098 if (script_threads <= 0) {
2106 script_threads = std::max(script_threads - 1, 0);
2111 LogPrintf(
"Script verification uses %d additional threads\n",
2113 if (script_threads >= 1) {
2118 node.scheduler = std::make_unique<CScheduler>();
2121 node.scheduler->m_service_thread =
2123 [&] {
node.scheduler->serviceQueue(); });
2126 node.scheduler->scheduleEvery(
2131 std::chrono::minutes{1});
2140 for (
const auto &client :
node.chain_clients) {
2141 client->registerRpcs();
2157 _(
"Unable to start HTTP server. See debug log for details."));
2162 for (
const auto &client :
node.chain_clients) {
2163 if (!client->verify()) {
2183 std::vector<bool> asmap;
2187 if (!asmap_path.is_absolute()) {
2196 if (asmap.size() == 0) {
2202 LogPrintf(
"Using asmap version %s for IP bucketing\n",
2205 LogPrintf(
"Using /16 prefix for IP bucketing\n");
2208 uiInterface.InitMessage(
_(
"Loading P2P addresses...").translated);
2209 auto addrman{
LoadAddrman(chainparams, asmap, args)};
2213 node.addrman = std::move(*addrman);
2217 node.banman = std::make_unique<BanMan>(
2221 node.connman = std::make_unique<CConnman>(
2222 config, GetRand<uint64_t>(), GetRand<uint64_t>(), *
node.addrman,
2226 std::vector<std::string> uacomments;
2227 for (
const std::string &cmt : args.
GetArgs(
"-uacomment")) {
2230 _(
"User Agent comment (%s) contains unsafe characters."), cmt));
2232 uacomments.push_back(cmt);
2235 const std::string client_version =
2239 _(
"-uaclientname (%s) contains invalid characters."), client_name));
2241 if (client_version !=
2244 strprintf(
_(
"-uaclientversion (%s) contains invalid characters."),
2247 const std::string strSubVersion =
2251 _(
"Total length of network version string (%i) exceeds maximum "
2252 "length (%i). Reduce the number or size of uacomments."),
2257 std::set<enum Network> nets;
2258 for (
const std::string &snet : args.
GetArgs(
"-onlynet")) {
2262 _(
"Unknown network specified in -onlynet: '%s'"), snet));
2266 for (
int n = 0; n <
NET_MAX; n++) {
2268 if (!nets.count(net)) {
2278 bool proxyRandomize =
2283 std::string proxyArg = args.
GetArg(
"-proxy",
"");
2285 if (proxyArg !=
"" && proxyArg !=
"0") {
2289 _(
"Invalid -proxy address or hostname: '%s'"), proxyArg));
2295 _(
"Invalid -proxy address or hostname: '%s'"), proxyArg));
2311 std::string onionArg = args.
GetArg(
"-onion",
"");
2312 if (onionArg !=
"") {
2313 if (onionArg ==
"0") {
2320 _(
"Invalid -onion address or hostname: '%s'"), onionArg));
2325 _(
"Invalid -onion address or hostname: '%s'"), onionArg));
2332 for (
const std::string &strAddr : args.
GetArgs(
"-externalip")) {
2346 return chainman->m_blockman.ReadBlockFromDisk(block, index);
2356 node.notifications = std::make_unique<KernelNotifications>();
2358 bool fReindexChainState = args.
GetBoolArg(
"-reindex-chainstate",
false);
2364 .notifications = *
node.notifications,
2369 if (chainman_opts.checkpoints_enabled) {
2370 LogPrintf(
"Checkpoints will be verified.\n");
2372 LogPrintf(
"Skipping checkpoint verification.\n");
2375 BlockManager::Options blockman_opts{
2376 .chainparams = chainman_opts.config.GetChainParams(),
2387 LogPrintf(
"* Using %.1f MiB for block index database\n",
2390 LogPrintf(
"* Using %.1f MiB for transaction index database\n",
2391 cache_sizes.
tx_index * (1.0 / 1024 / 1024));
2394 LogPrintf(
"* Using %.1f MiB for %s block filter index database\n",
2398 LogPrintf(
"* Using %.1f MiB for chain state database\n",
2399 cache_sizes.
coins_db * (1.0 / 1024 / 1024));
2410 mempool_opts.check_ratio =
2411 std::clamp<int>(mempool_opts.check_ratio, 0, 1'000'000);
2417 int64_t nMempoolSizeMin = 101 * 1000 * 40;
2418 if (mempool_opts.max_size_bytes < 0 ||
2420 mempool_opts.max_size_bytes < nMempoolSizeMin)) {
2422 std::ceil(nMempoolSizeMin / 1000000.0)));
2424 LogPrintf(
"* Using %.1f MiB for in-memory UTXO set (plus up to %.1f MiB of "
2425 "unused mempool space)\n",
2426 cache_sizes.
coins * (1.0 / 1024 / 1024),
2427 mempool_opts.max_size_bytes * (1.0 / 1024 / 1024));
2430 node.mempool = std::make_unique<CTxMemPool>(mempool_opts);
2433 std::make_unique<ChainstateManager>(chainman_opts, blockman_opts);
2449 _(
"Error reading from database, shutting down."),
"",
2453 uiInterface.InitMessage(
_(
"Loading block index...").translated);
2455 const int64_t load_block_index_start_time =
GetTimeMillis();
2456 auto catch_exceptions = [](
auto &&f) {
2459 }
catch (
const std::exception &e) {
2462 _(
"Error opening block database"));
2465 auto [status,
error] = catch_exceptions(
2471 LogPrintf(
"Prune: pruned datadir may not have more than %d "
2472 "blocks; only checking available blocks\n",
2475 std::tie(status,
error) = catch_exceptions(
2496 _(
"Do you want to rebuild the block database now?"),
2497 error.original +
".\nPlease restart with -reindex or "
2498 "-reindex-chainstate to recover.",
2506 LogPrintf(
"Aborted block database rebuild. Exiting.\n");
2520 LogPrintf(
"Shutdown requested. Exiting.\n");
2530 args, *
node.chain,
node.connman.get(), chainman,
node.mempool.get(),
2531 *
node.scheduler, avalancheError);
2532 if (!
node.avalanche) {
2537 if (
node.avalanche->isAvalancheServiceAvailable()) {
2547 node.banman.get(), chainman, *
node.mempool,
2548 node.avalanche.get(), peerman_opts);
2566 if (!
g_txindex->Start(chainman.ActiveChainstate())) {
2571 for (
const auto &filter_type : g_enabled_filter_types) {
2575 ->Start(chainman.ActiveChainstate())) {
2590 const bool fReindexChronik =
2592 if (!chronik::Start(args, config,
node, fReindexChronik)) {
2599 for (
const auto &client :
node.chain_clients) {
2600 if (!client->load()) {
2610 LogPrintf(
"Unsetting NODE_NETWORK on prune mode\n");
2615 uiInterface.InitMessage(
_(
"Pruning blockstore...").translated);
2616 chainstate->PruneAndFlush();
2624 strprintf(
_(
"Error: Disk space is low for %s"),
2630 strprintf(
_(
"Error: Disk space is low for %s"),
2638 boost::signals2::connection block_notify_genesis_wait_connection;
2641 block_notify_genesis_wait_connection =
2648 #if defined(HAVE_SYSTEM)
2649 const std::string block_notify = args.
GetArg(
"-blocknotify",
"");
2650 if (!block_notify.empty()) {
2651 uiInterface.NotifyBlockTip_connect([block_notify](
2657 std::string command = block_notify;
2659 std::thread t(runCommand, command);
2666 std::vector<fs::path> vImportFiles;
2667 for (
const std::string &strFile : args.
GetArgs(
"-loadblock")) {
2688 block_notify_genesis_wait_connection.disconnect();
2697 int chain_active_height;
2713 if (tip_info && chainman.m_best_header) {
2715 tip_info->
header_time = chainman.m_best_header->GetBlockTime();
2718 LogPrintf(
"nBestHeight = %d\n", chain_active_height);
2720 node.peerman->SetBestHeight(chain_active_height);
2732 ? args.
GetIntArg(
"-maxavalancheoutbound",
2747 if (
node.avalanche) {
2762 const uint16_t default_bind_port =
static_cast<uint16_t
>(
2765 const auto BadPortWarning = [](
const char *
prefix, uint16_t port) {
2766 return strprintf(
_(
"%s request to listen on port %u. This port is "
2767 "considered \"bad\" and "
2768 "thus it is unlikely that any Bitcoin ABC peers "
2769 "connect to it. See "
2770 "doc/p2p-bad-ports.md for details and a full list."),
2774 for (
const std::string &bind_arg : args.
GetArgs(
"-bind")) {
2776 const size_t index = bind_arg.rfind(
'=');
2777 if (index == std::string::npos) {
2778 if (
Lookup(bind_arg, bind_addr, default_bind_port,
2780 connOptions.
vBinds.push_back(bind_addr);
2787 const std::string network_type = bind_arg.substr(index + 1);
2788 if (network_type ==
"onion") {
2789 const std::string truncated_bind_arg =
2790 bind_arg.substr(0, index);
2791 if (
Lookup(truncated_bind_arg, bind_addr,
2792 BaseParams().OnionServiceTargetPort(),
false)) {
2801 for (
const std::string &strBind : args.
GetArgs(
"-whitebind")) {
2813 args.
GetArgs(
"-bind").empty() && args.
GetArgs(
"-whitebind").empty();
2818 const uint16_t port_arg = args.
GetIntArg(
"-port", 0);
2826 onion_service_target = connOptions.
onion_binds.front();
2829 connOptions.
onion_binds.push_back(onion_service_target);
2835 _(
"More than one onion bind address is provided. Using %s "
2836 "for the automatically created Tor onion service."),
2848 for (
const auto &net : args.
GetArgs(
"-whitelist")) {
2862 const auto connect = args.
GetArgs(
"-connect");
2863 if (connect.size() != 1 || connect[0] !=
"0") {
2868 const std::string &i2psam_arg = args.
GetArg(
"-i2psam",
"");
2869 if (!i2psam_arg.empty()) {
2873 _(
"Invalid -i2psam address or hostname: '%s'"), i2psam_arg));
2884 if (!
node.connman->Start(*
node.scheduler, connOptions)) {
2904 for (
const auto &client :
node.chain_clients) {
2905 client->start(*
node.scheduler);
2909 node.scheduler->scheduleEvery(
2917 if (
node.avalanche) {
2918 node.avalanche->startEventLoop(*
node.scheduler);
2922 node.peerman->StartScheduledTasks(*
node.scheduler);
2926 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.
void SetupHelpOptions(ArgsManager &args)
Add help options to the args manager.
const char *const BITCOIN_SETTINGS_FILENAME
const char *const BITCOIN_CONF_FILENAME
fs::path AbsPathForConfigVal(const ArgsManager &args, const fs::path &path, bool net_specific=true)
Most paths passed as configuration arguments are treated as relative to the datadir if they are not a...
std::vector< bool > DecodeAsmap(fs::path path)
Read asmap from provided binary file.
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.
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
std::unique_ptr< const CChainParams > CreateChainParams(const ArgsManager &args, const std::string &chain)
Creates and returns a std::unique_ptr<CChainParams> of the chosen chain.
const CChainParams & Params()
Return the currently selected parameters.
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...
static constexpr bool DEFAULT_CHECKPOINTS_ENABLED
static constexpr auto DEFAULT_MAX_TIP_AGE
#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.
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 std::unique_ptr< CZMQNotificationInterface > Create(std::function< bool(CBlock &, const CBlockIndex &)> get_block_by_index)
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.
A writer stream (for serialization) that computes a 256-bit hash.
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, avalanche::Processor *const avalanche, Options opts)
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:...
Maintains a tree of blocks (stored in m_block_index) which is consulted to determine where the most-w...
const CBlockIndex *GetFirstStoredBlock(const CBlockIndex &start_block) EXCLUSIVE_LOCKS_REQUIRED(bool m_have_pruned
Find the first block that is not pruned.
bool IsPruneMode() const
Whether running in -prune mode.
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)
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)
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))
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()
bool error(const char *fmt, const Args &...args)
#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.
static constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT
bool DumpMempool(const CTxMemPool &pool, const fs::path &dump_path, FopenFn mockable_fopen_function, bool skip_file_commit)
@ FAILURE_INCOMPATIBLE_DB
@ FAILURE_FATAL
Fatal error which should not prompt to reindex.
@ FAILURE
Generic failure which reindexing may fix.
@ FAILURE_INSUFFICIENT_DBCACHE
CacheSizes CalculateCacheSizes(const ArgsManager &args, size_t n_indexes)
fs::path MempoolPath(const ArgsManager &argsman)
bool ShouldPersistMempool(const ArgsManager &argsman)
void ThreadImport(ChainstateManager &chainman, avalanche::Processor *const avalanche, std::vector< fs::path > vImportFiles, const fs::path &mempool_path)
std::optional< bilingual_str > ApplyArgsManOptions(const ArgsManager &args, BlockManager::Options &opts)
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)
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 uint32_t DEFAULT_BLOCK_RECONSTRUCTION_EXTRA_TXN
Default number of non-mempool transactions to keep around for block reconstruction.
static const uint32_t 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.
static constexpr bool DEFAULT_RPC_DOC_CHECK
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.
@ 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
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....
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)
std::string SysErrorString(int err)
Return system error string from errno value.
int GetNumCores()
Return the number of cores available on the current system.
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.
void StartScriptCheckWorkerThreads(int threads_num)
Run instances of script checking worker threads.
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'.
static constexpr int DEFAULT_CHECKLEVEL
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 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 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
std::unique_ptr< CZMQNotificationInterface > g_zmq_notification_interface
void RegisterZMQRPCCommands(CRPCTable &t)