6#if defined(HAVE_CONFIG_H)
7#include <config/bitcoin-config.h>
91#include <boost/signals2/signal.hpp>
94#include <chronik-cpp/chronik.h>
109#include <condition_variable>
144#define MIN_CORE_FILEDESCRIPTORS 0
146#define MIN_CORE_FILEDESCRIPTORS 150
210 if (
node.avalanche) {
213 node.avalanche->stopEventLoop();
216 node.connman->Interrupt();
228 static Mutex g_shutdown_mutex;
229 TRY_LOCK(g_shutdown_mutex, lock_shutdown);
230 if (!lock_shutdown) {
233 LogPrintf(
"%s: In progress...\n", __func__);
242 node.mempool->AddTransactionsUpdated(1);
249 for (
const auto &client :
node.chain_clients) {
260 if (
node.avalanche) {
261 node.avalanche->stopEventLoop();
270 node.connman->Stop();
277 if (
node.scheduler) {
278 node.scheduler->stop();
280 if (
node.chainman &&
node.chainman->m_thread_load.joinable()) {
281 node.chainman->m_thread_load.join();
287 node.peerman.reset();
290 node.avalanche.reset();
291 node.connman.reset();
293 node.addrman.reset();
295 if (
node.mempool &&
node.mempool->GetLoadTried() &&
305 if (chainstate->CanFlushToDisk()) {
306 chainstate->ForceFlushStateToDisk();
342 if (chainstate->CanFlushToDisk()) {
343 chainstate->ForceFlushStateToDisk();
344 chainstate->ResetCoinsViews();
348 node.chainman->DumpRecentHeadersTime(
node.chainman->m_options.datadir /
351 for (
const auto &client :
node.chain_clients) {
362 node.chain_clients.clear();
366 node.mempool.reset();
367 node.chainman.reset();
368 node.scheduler.reset();
372 LogPrintf(
"%s: Unable to remove PID file: File does not exist\n",
375 }
catch (
const fs::filesystem_error &e) {
376 LogPrintf(
"%s: Unable to remove PID file: %s\n", __func__,
397static BOOL WINAPI consoleCtrlHandler(DWORD dwCtrlType) {
408 sigemptyset(&sa.sa_mask);
410 sigaction(signal, &sa, NULL);
435 argsman.
AddArg(
"-help-debug",
436 "Print help message with debugging options and exit",
false,
445 const auto testnetChainParams =
447 const auto regtestChainParams =
451 std::vector<std::string> hidden_args = {
456 "-automaticunparking",
457 "-replayprotectionactivationtime",
459 "-chronikallowpause",
462 "-allowselfsignedrootcertificates",
467 "-rootcertificates=<file>",
471 "-schumpeteractivationtime",
473 "-shibusawaactivationtime",
483#if defined(HAVE_SYSTEM)
485 "-alertnotify=<cmd>",
486 "Execute command when a relevant alert is received or we see "
487 "a really long fork (%s in cmd is replaced by message)",
491 "-assumevalid=<hex>",
493 "If this block is in the chain assume that it and its ancestors "
494 "are valid and potentially skip their script verification (0 to "
495 "verify all, default: %s, testnet: %s)",
496 defaultChainParams->GetConsensus().defaultAssumeValid.GetHex(),
497 testnetChainParams->GetConsensus().defaultAssumeValid.GetHex()),
499 argsman.
AddArg(
"-blocksdir=<dir>",
500 "Specify directory to hold blocks subdirectory for *.dat "
501 "files (default: <datadir>)",
503 argsman.
AddArg(
"-fastprune",
504 "Use smaller block files and lower minimum prune height for "
508#if defined(HAVE_SYSTEM)
509 argsman.
AddArg(
"-blocknotify=<cmd>",
510 "Execute command when the best block changes (%s in cmd is "
511 "replaced by block hash)",
514 argsman.
AddArg(
"-blockreconstructionextratxn=<n>",
515 strprintf(
"Extra transactions to keep in memory for compact "
516 "block reconstructions (default: %u)",
521 strprintf(
"Whether to reject transactions from network peers. "
522 "Disables automatic broadcast and rebroadcast of "
523 "transactions, unless the source peer has the "
524 "'forcerelay' permission. RPC transactions are"
525 " not affected. (default: %u)",
528 argsman.
AddArg(
"-coinstatsindex",
529 strprintf(
"Maintain coinstats index used by the "
530 "gettxoutsetinfo RPC (default: %u)",
535 strprintf(
"Specify path to read-only configuration file. Relative "
536 "paths will be prefixed by datadir location. (default: %s)",
539 argsman.
AddArg(
"-datadir=<dir>",
"Specify data directory",
543 strprintf(
"Maximum database write batch size in bytes (default: %u)",
549 strprintf(
"Set database cache size in MiB (%d to %d, default: %d)",
553 "-includeconf=<file>",
554 "Specify additional configuration file, relative to the -datadir path "
555 "(only useable from configuration file, not command line)",
557 argsman.
AddArg(
"-allowignoredconf",
558 strprintf(
"For backwards compatibility, treat an unused %s "
559 "file in the datadir as a warning, not an error.",
562 argsman.
AddArg(
"-loadblock=<file>",
563 "Imports blocks from external file on startup",
565 argsman.
AddArg(
"-maxmempool=<n>",
566 strprintf(
"Keep the transaction memory pool below <n> "
567 "megabytes (default: %u)",
570 argsman.
AddArg(
"-maxorphantx=<n>",
571 strprintf(
"Keep at most <n> unconnectable transactions in "
572 "memory (default: %u)",
575 argsman.
AddArg(
"-mempoolexpiry=<n>",
576 strprintf(
"Do not keep transactions in the mempool longer "
577 "than <n> hours (default: %u)",
581 "-minimumchainwork=<hex>",
583 "Minimum work assumed to exist on a valid chain in hex "
584 "(default: %s, testnet: %s)",
585 defaultChainParams->GetConsensus().nMinimumChainWork.GetHex(),
586 testnetChainParams->GetConsensus().nMinimumChainWork.GetHex()),
591 strprintf(
"Set the number of script verification threads (%u to %d, 0 "
592 "= auto, <0 = leave that many cores free, default: %d)",
596 argsman.
AddArg(
"-persistmempool",
597 strprintf(
"Whether to save the mempool on shutdown and load "
598 "on restart (default: %u)",
602 "-persistrecentheaderstime",
604 "Whether the node stores the recent headers reception time to a "
605 "file and load it upon startup. This is intended for mining nodes "
606 "to overestimate the real time target upon restart (default: %u)",
611 strprintf(
"Specify pid file. Relative paths will be prefixed "
612 "by a net-specific datadir location. (default: %s)",
617 strprintf(
"Reduce storage requirements by enabling pruning (deleting) "
618 "of old blocks. This allows the pruneblockchain RPC to be "
619 "called to delete specific blocks and enables automatic "
620 "pruning of old blocks if a target size in MiB is provided. "
621 "This mode is incompatible with -txindex and -rescan. "
622 "Warning: Reverting this setting requires re-downloading the "
623 "entire blockchain. (default: 0 = disable pruning blocks, "
624 "1 = allow manual pruning via RPC, >=%u = automatically "
625 "prune block files to stay under the specified target size "
630 "-reindex-chainstate",
631 "Rebuild chain state from the currently indexed blocks. When "
632 "in pruning mode or if blocks on disk might be corrupted, use "
633 "full -reindex instead.",
637 "Rebuild chain state and block index from the blk*.dat files on disk."
638 " This will also rebuild active optional indexes.",
643 "Specify path to dynamic settings data file. Can be disabled with "
644 "-nosettings. File is written at runtime and not meant to be "
645 "edited by users (use %s instead for custom settings). Relative "
646 "paths will be prefixed by datadir location. (default: %s)",
650 argsman.
AddArg(
"-startupnotify=<cmd>",
"Execute command on startup.",
656 "Create new files with system default permissions, instead of umask "
657 "077 (only effective with disabled wallet functionality)",
660 hidden_args.emplace_back(
"-sysperms");
662 argsman.
AddArg(
"-txindex",
663 strprintf(
"Maintain a full transaction index, used by the "
664 "getrawtransaction rpc call (default: %d)",
670 strprintf(
"Enable the Chronik indexer, which can be read via a "
671 "dedicated HTTP/Protobuf interface (default: %d)",
675 "-chronikbind=<addr>[:port]",
677 "Bind the Chronik indexer to the given address to listen for "
678 "HTTP/Protobuf connections to access the index. Unlike the "
679 "JSON-RPC, it's ok to have this publicly exposed on the internet. "
680 "This option can be specified multiple times (default: %s; default "
681 "port: %u, testnet: %u, regtest: %u)",
682 Join(chronik::DEFAULT_BINDS,
", "),
683 defaultBaseParams->ChronikPort(), testnetBaseParams->ChronikPort(),
684 regtestBaseParams->ChronikPort()),
688 argsman.
AddArg(
"-chroniktokenindex",
689 "Enable token indexing in Chronik (default: 1)",
691 argsman.
AddArg(
"-chroniklokadidindex",
692 "Enable LOKAD ID indexing in Chronik (default: 1)",
694 argsman.
AddArg(
"-chronikreindex",
695 "Reindex the Chronik indexer from genesis, but leave the "
696 "other indexes untouched",
699 "-chroniktxnumcachebuckets",
701 "Tuning param of the TxNumCache, specifies how many buckets "
702 "to use on the belt. Caution against setting this too high, "
703 "it may slow down indexing. Set to 0 to disable. (default: %d)",
704 chronik::DEFAULT_TX_NUM_CACHE_BUCKETS),
708 "-chroniktxnumcachebucketsize",
710 "Tuning param of the TxNumCache, specifies the size of each bucket "
711 "on the belt. Unlike the number of buckets, this may be increased "
712 "without much danger of slowing the indexer down. The total cache "
713 "size will be `num_buckets * bucket_size * 40B`, so by default the "
714 "cache will require %dkB of memory. (default: %d)",
715 chronik::DEFAULT_TX_NUM_CACHE_BUCKETS *
716 chronik::DEFAULT_TX_NUM_CACHE_BUCKET_SIZE * 40 / 1000,
717 chronik::DEFAULT_TX_NUM_CACHE_BUCKET_SIZE),
720 argsman.
AddArg(
"-chronikperfstats",
721 "Output some performance statistics (e.g. num cache hits, "
722 "seconds spent) into a <datadir>/perf folder. (default: 0)",
724 argsman.
AddArg(
"-chronikscripthashindex",
725 "Enable the scripthash index for the Chronik indexer "
726 "(default: 1 if chronikelectrumbind is set, 0 otherwise) ",
729 "-chronikelectrumbind=<addr>[:port][:t|s|w|y]",
731 "Bind the Chronik Electrum interface to the given "
732 "address:port:protocol. If not set, the Electrum interface will "
733 "not start. This option can be specified multiple times. The "
734 "protocol is selected by a single letter, where 't' means TCP, 's' "
735 "means TLS, 'w' means WS and 'y' means WSS. If TLS and/or WSS is "
736 "selected, the certificate chain and private key must both be "
737 "passed (see -chronikelectrumcert and -chronikelectrumprivkey "
738 "(default: disabled; default port: %u, testnet: %u, regtest: %u; "
739 "default protocol: TLS)",
740 defaultBaseParams->ChronikElectrumPort(),
741 testnetBaseParams->ChronikElectrumPort(),
742 regtestBaseParams->ChronikElectrumPort()),
747 "-chronikelectrumcert",
748 "Path to the certificate file to be used by the Chronik Electrum "
749 "server when the TLS protocol is selected. The file should contain "
750 "the whole certificate chain (typically a .pem file). If used the "
751 "-chronikelectrumprivkey must be set as well.",
756 "-chronikelectrumprivkey",
757 "Path to the private key file to be used by the Chronik Electrum "
758 "server when the TLS protocol is selected. If used the "
759 "-chronikelectrumcert must be set as well.",
764 "-chronikelectrumurl",
765 "The URL to advertise to the Electrum peers. This needs to be set to "
766 "the server public URL to instruct the other Electrum peers that they "
767 "don't have to drop the connection. See the 'hosts' key in "
768 "https://electrum-cash-protocol.readthedocs.io/en/latest/"
769 "protocol-methods.html#server.features (default: 127.0.0.1).",
774 "-chronikelectrummaxhistory",
775 strprintf(
"Largest tx history we are willing to serve. (default: %u)",
776 chronik::DEFAULT_ELECTRUM_MAX_HISTORY),
780 "-chronikelectrumdonationaddress",
782 "The server donation address. No checks are done on the server "
783 "side to ensure this is a valid eCash address, it is just relayed "
784 "to clients verbatim as a text string (%u characters maximum).",
785 chronik::MAX_LENGTH_DONATION_ADDRESS),
789 "-chronikelectrumpeersvalidationinterval",
791 "The peers submitted via the Chronik Electrum server.add_peer "
792 "endpoint are periodically checked for validity and are only "
793 "returned after they passed the validation. This option controls "
794 "the interval duration between successive peers validation "
795 "processes in seconds (default: %u). Setting this value to 0 "
796 "disables the peer validation completely.",
797 std::chrono::duration_cast<std::chrono::seconds>(
798 chronik::DEFAULT_ELECTRUM_PEER_VALIDATION_INTERVAL)
804 "-blockfilterindex=<type>",
805 strprintf(
"Maintain an index of compact filters by block "
806 "(default: %s, values: %s).",
808 " If <type> is not supplied or if <type> = 1, indexes for "
809 "all known types are enabled.",
813 "Use Cash Address for destination encoding instead of base58 "
814 "(activate by default on Jan, 14)",
819 "Add a node to connect to and attempt to keep the connection "
820 "open (see the `addnode` RPC command help for more info)",
823 argsman.
AddArg(
"-asmap=<file>",
824 strprintf(
"Specify asn mapping used for bucketing of the "
825 "peers (default: %s). Relative paths will be "
826 "prefixed by the net-specific datadir location.",
829 argsman.
AddArg(
"-bantime=<n>",
830 strprintf(
"Default duration (in seconds) of manually "
831 "configured bans (default: %u)",
835 "-bind=<addr>[:<port>][=onion]",
836 strprintf(
"Bind to given address and always listen on it (default: "
837 "0.0.0.0). Use [host]:port notation for IPv6. Append =onion "
838 "to tag any incoming connections to that address and port as "
839 "incoming Tor connections (default: 127.0.0.1:%u=onion, "
840 "testnet: 127.0.0.1:%u=onion, regtest: 127.0.0.1:%u=onion)",
841 defaultBaseParams->OnionServiceTargetPort(),
842 testnetBaseParams->OnionServiceTargetPort(),
843 regtestBaseParams->OnionServiceTargetPort()),
848 "Connect only to the specified node(s); -connect=0 disables automatic "
849 "connections (the rules for this peer are the same as for -addnode)",
854 "Discover own IP addresses (default: 1 when listening and no "
855 "-externalip or -proxy)",
858 strprintf(
"Allow DNS lookups for -addnode, -seednode and "
859 "-connect (default: %d)",
865 "Query for peer addresses via DNS lookup, if low on addresses "
866 "(default: %u unless -connect used)",
869 argsman.
AddArg(
"-externalip=<ip>",
"Specify your own public address",
874 "Allow fixed seeds if DNS seeds don't provide peers (default: %u)",
880 "Always query for peer addresses via DNS lookup (default: %d)",
883 argsman.
AddArg(
"-overridednsseed",
884 "If set, only use the specified DNS seed when "
885 "querying for peer addresses via DNS lookup.",
889 "Accept connections from outside (default: 1 if no -proxy or -connect)",
893 strprintf(
"Automatically create Tor onion service (default: %d)",
897 "-maxconnections=<n>",
898 strprintf(
"Maintain at most <n> connections to peers. The effective "
899 "limit depends on system limitations and might be lower than "
900 "the specified value (default: %u)",
903 argsman.
AddArg(
"-maxreceivebuffer=<n>",
904 strprintf(
"Maximum per-connection receive buffer, <n>*1000 "
905 "bytes (default: %u)",
909 "-maxsendbuffer=<n>",
911 "Maximum per-connection send buffer, <n>*1000 bytes (default: %u)",
915 "-maxtimeadjustment",
916 strprintf(
"Maximum allowed median peer time offset adjustment. Local "
917 "perspective of time may be influenced by peers forward or "
918 "backward by this amount. (default: %u seconds)",
921 argsman.
AddArg(
"-onion=<ip:port>",
922 strprintf(
"Use separate SOCKS5 proxy to reach peers via Tor "
923 "onion services (default: %s)",
926 argsman.
AddArg(
"-i2psam=<ip:port>",
927 "I2P SAM proxy to reach I2P peers and accept I2P "
928 "connections (default: none)",
931 "-i2pacceptincoming",
932 "If set and -i2psam is also set then incoming I2P connections are "
933 "accepted via the SAM proxy. If this is not set but -i2psam is set "
934 "then only outgoing connections will be made to the I2P network. "
935 "Ignored if -i2psam is not set. Listening for incoming I2P connections "
936 "is done through the SAM proxy, not by binding to a local address and "
942 "Make outgoing connections only through network <net> (" +
944 "). Incoming connections are not affected by this option. This "
945 "option can be specified multiple times to allow multiple "
946 "networks. Warning: if it is used with non-onion networks "
947 "and the -onion or -proxy option is set, then outbound onion "
948 "connections will still be made; use -noonion or -onion=0 to "
949 "disable outbound onion connections in this case",
951 argsman.
AddArg(
"-peerbloomfilters",
952 strprintf(
"Support filtering of blocks and transaction with "
953 "bloom filters (default: %d)",
959 "Serve compact block filters to peers per BIP 157 (default: %u)",
962 argsman.
AddArg(
"-permitbaremultisig",
963 strprintf(
"Relay non-P2SH multisig (default: %d)",
969 argsman.
AddArg(
"-port=<port>",
970 strprintf(
"Listen for connections on <port>. Nodes not "
971 "using the default ports (default: %u, "
972 "testnet: %u, regtest: %u) are unlikely to get "
973 "incoming connections. Not relevant for I2P (see "
975 defaultChainParams->GetDefaultPort(),
976 testnetChainParams->GetDefaultPort(),
977 regtestChainParams->GetDefaultPort()),
980 argsman.
AddArg(
"-proxy=<ip:port>",
"Connect through SOCKS5 proxy",
985 strprintf(
"Randomize credentials for every proxy connection. "
986 "This enables Tor stream isolation (default: %d)",
991 "Connect to a node to retrieve peer addresses, and disconnect",
995 "Enable all P2P network activity (default: 1). Can be changed "
996 "by the setnetworkactive RPC command",
998 argsman.
AddArg(
"-timeout=<n>",
999 strprintf(
"Specify connection timeout in milliseconds "
1000 "(minimum: 1, default: %d)",
1005 strprintf(
"Specify p2p connection timeout in seconds. This option "
1006 "determines the amount of time a peer may be inactive before "
1007 "the connection to it is dropped. (minimum: 1, default: %d)",
1011 "-torcontrol=<ip>:<port>",
1013 "Tor control port to use if onion listening enabled (default: %s)",
1016 argsman.
AddArg(
"-torpassword=<pass>",
1017 "Tor control port password (default: empty)",
1023 "Use UPnP to map the listening port (default: 1 when "
1024 "listening and no -proxy)",
1029 strprintf(
"Use UPnP to map the listening port (default: %u)", 0),
1033 hidden_args.emplace_back(
"-upnp");
1038 strprintf(
"Use NAT-PMP to map the listening port (default: %s)",
1042 hidden_args.emplace_back(
"-natpmp");
1045 "-whitebind=<[permissions@]addr>",
1046 "Bind to the given address and add permission flags to the peers "
1048 "Use [host]:port notation for IPv6. Allowed permissions: " +
1051 "Specify multiple permissions separated by commas (default: "
1052 "download,noban,mempool,relay). Can be specified multiple times.",
1055 argsman.
AddArg(
"-whitelist=<[permissions@]IP address or network>",
1056 "Add permission flags to the peers using the given "
1057 "IP address (e.g. 1.2.3.4) or CIDR-notated network "
1058 "(e.g. 1.2.3.0/24). "
1059 "Uses the same permissions as -whitebind. "
1060 "Additional flags \"in\" and \"out\" control whether "
1061 "permissions apply to incoming connections and/or manual "
1062 "(default: incoming only). "
1063 "Can be specified multiple times.",
1066 "-maxuploadtarget=<n>",
1067 strprintf(
"Tries to keep outbound traffic under the given target (in "
1068 "MiB per 24h). Limit does not apply to peers with 'download' "
1069 "permission. 0 = no limit (default: %d)",
1076 argsman.
AddArg(
"-zmqpubhashblock=<address>",
1077 "Enable publish hash block in <address>",
1079 argsman.
AddArg(
"-zmqpubhashtx=<address>",
1080 "Enable publish hash transaction in <address>",
1082 argsman.
AddArg(
"-zmqpubrawblock=<address>",
1083 "Enable publish raw block in <address>",
1085 argsman.
AddArg(
"-zmqpubrawtx=<address>",
1086 "Enable publish raw transaction in <address>",
1088 argsman.
AddArg(
"-zmqpubsequence=<address>",
1089 "Enable publish hash block and tx sequence in <address>",
1092 "-zmqpubhashblockhwm=<n>",
1093 strprintf(
"Set publish hash block outbound message high water "
1094 "mark (default: %d)",
1098 "-zmqpubhashtxhwm=<n>",
1099 strprintf(
"Set publish hash transaction outbound message high "
1100 "water mark (default: %d)",
1104 "-zmqpubrawblockhwm=<n>",
1105 strprintf(
"Set publish raw block outbound message high water "
1106 "mark (default: %d)",
1110 "-zmqpubrawtxhwm=<n>",
1111 strprintf(
"Set publish raw transaction outbound message high "
1112 "water mark (default: %d)",
1115 argsman.
AddArg(
"-zmqpubsequencehwm=<n>",
1116 strprintf(
"Set publish hash sequence message high water mark"
1121 hidden_args.emplace_back(
"-zmqpubhashblock=<address>");
1122 hidden_args.emplace_back(
"-zmqpubhashtx=<address>");
1123 hidden_args.emplace_back(
"-zmqpubrawblock=<address>");
1124 hidden_args.emplace_back(
"-zmqpubrawtx=<address>");
1125 hidden_args.emplace_back(
"-zmqpubsequence=<n>");
1126 hidden_args.emplace_back(
"-zmqpubhashblockhwm=<n>");
1127 hidden_args.emplace_back(
"-zmqpubhashtxhwm=<n>");
1128 hidden_args.emplace_back(
"-zmqpubrawblockhwm=<n>");
1129 hidden_args.emplace_back(
"-zmqpubrawtxhwm=<n>");
1130 hidden_args.emplace_back(
"-zmqpubsequencehwm=<n>");
1135 strprintf(
"How many blocks to check at startup (default: %u, 0 = all)",
1139 argsman.
AddArg(
"-checklevel=<n>",
1140 strprintf(
"How thorough the block verification of "
1141 "-checkblocks is: %s (0-4, default: %u)",
1145 argsman.
AddArg(
"-checkblockindex",
1146 strprintf(
"Do a consistency check for the block tree, "
1147 "chainstate, and other validation data structures "
1148 "occasionally. (default: %u, regtest: %u)",
1149 defaultChainParams->DefaultConsistencyChecks(),
1150 regtestChainParams->DefaultConsistencyChecks()),
1153 argsman.
AddArg(
"-checkaddrman=<n>",
1154 strprintf(
"Run addrman consistency checks every <n> "
1155 "operations. Use 0 to disable. (default: %u)",
1160 "-checkmempool=<n>",
1161 strprintf(
"Run mempool consistency checks every <n> transactions. Use "
1162 "0 to disable. (default: %u, regtest: %u)",
1163 defaultChainParams->DefaultConsistencyChecks(),
1164 regtestChainParams->DefaultConsistencyChecks()),
1167 argsman.
AddArg(
"-checkpoints",
1168 strprintf(
"Only accept block chain matching built-in "
1169 "checkpoints (default: %d)",
1173 argsman.
AddArg(
"-deprecatedrpc=<method>",
1174 "Allows deprecated RPC method(s) to be used",
1178 "-stopafterblockimport",
1179 strprintf(
"Stop running after importing blocks from disk (default: %d)",
1183 argsman.
AddArg(
"-stopatheight",
1184 strprintf(
"Stop running after reaching the given height in "
1185 "the main chain (default: %u)",
1189 argsman.
AddArg(
"-addrmantest",
"Allows to test address relay on localhost",
1192 argsman.
AddArg(
"-capturemessages",
"Capture all P2P messages to disk",
1195 argsman.
AddArg(
"-mocktime=<n>",
1201 "-maxsigcachesize=<n>",
1202 strprintf(
"Limit size of signature cache to <n> MiB (default: %u)",
1207 "-maxscriptcachesize=<n>",
1208 strprintf(
"Limit size of script cache to <n> MiB (default: %u)",
1212 argsman.
AddArg(
"-maxtipage=<n>",
1213 strprintf(
"Maximum tip age in seconds to consider node in "
1214 "initial block download (default: %u)",
1219 argsman.
AddArg(
"-uacomment=<cmt>",
1220 "Append comment to the user agent string",
1222 argsman.
AddArg(
"-uaclientname=<clientname>",
"Set user agent client name",
1224 argsman.
AddArg(
"-uaclientversion=<clientversion>",
1233 "Relay and mine \"non-standard\" transactions (%sdefault: %u)",
1234 "testnet/regtest only; ", defaultChainParams->RequireStandard()),
1237 argsman.
AddArg(
"-excessiveblocksize=<n>",
1238 strprintf(
"Do not accept blocks larger than this limit, in "
1239 "bytes (default: %d)",
1245 "-dustrelayfee=<amt>",
1246 strprintf(
"Fee rate (in %s/kB) used to define dust, the value of an "
1247 "output such that it will cost about 1/3 of its value in "
1248 "fees at this fee rate to spend it. (default: %s)",
1254 "-bytespersigcheck",
1255 strprintf(
"Equivalent bytes per sigCheck in transactions for relay and "
1256 "mining (default: %u).",
1261 strprintf(
"DEPRECATED: Equivalent bytes per sigCheck in transactions "
1262 "for relay and mining (default: %u). This has been "
1263 "deprecated since v0.26.8 and will be removed in the future, "
1264 "please use -bytespersigcheck instead.",
1269 strprintf(
"Relay and mine data carrier transactions (default: %d)",
1274 strprintf(
"Maximum size of data in data carrier transactions "
1275 "we relay and mine (default: %u)",
1279 "-minrelaytxfee=<amt>",
1280 strprintf(
"Fees (in %s/kB) smaller than this are rejected for "
1281 "relaying, mining and transaction creation (default: %s)",
1286 strprintf(
"Add 'relay' permission to whitelisted peers "
1287 "with default permissions. This will accept relayed "
1288 "transactions even when not relaying transactions "
1293 "-whitelistforcerelay",
1294 strprintf(
"Add 'forcerelay' permission to whitelisted peers "
1295 "with default permissions. This will relay transactions "
1296 "even if the transactions were already in the mempool "
1301 argsman.
AddArg(
"-blockmaxsize=<n>",
1302 strprintf(
"Set maximum block size in bytes (default: %d)",
1306 "-blockmintxfee=<amt>",
1307 strprintf(
"Set lowest fee rate (in %s/kB) for transactions to "
1308 "be included in block creation. (default: %s)",
1311 argsman.
AddArg(
"-simplegbt",
1312 "Use a simplified getblocktemplate output (default: 0)",
1315 argsman.
AddArg(
"-blockversion=<n>",
1316 "Override block version to test forking scenarios",
1320 argsman.
AddArg(
"-server",
"Accept command line and JSON-RPC commands",
1323 strprintf(
"Accept public REST requests (default: %d)",
1327 "-rpcbind=<addr>[:port]",
1328 "Bind to given address to listen for JSON-RPC connections. Do not "
1329 "expose the RPC server to untrusted networks such as the public "
1330 "internet! This option is ignored unless -rpcallowip is also passed. "
1331 "Port is optional and overrides -rpcport. Use [host]:port notation "
1332 "for IPv6. This option can be specified multiple times (default: "
1333 "127.0.0.1 and ::1 i.e., localhost)",
1339 strprintf(
"Throw a non-fatal error at runtime if the documentation for "
1340 "an RPC is incorrect (default: %u)",
1344 "-rpccookiefile=<loc>",
1345 "Location of the auth cookie. Relative paths will be prefixed "
1346 "by a net-specific datadir location. (default: data dir)",
1348 argsman.
AddArg(
"-rpcuser=<user>",
"Username for JSON-RPC connections",
1351 argsman.
AddArg(
"-rpcpassword=<pw>",
"Password for JSON-RPC connections",
1355 "-rpcwhitelist=<whitelist>",
1356 "Set a whitelist to filter incoming RPC calls for a specific user. The "
1357 "field <whitelist> comes in the format: <USERNAME>:<rpc 1>,<rpc "
1358 "2>,...,<rpc n>. If multiple whitelists are set for a given user, they "
1359 "are set-intersected. See -rpcwhitelistdefault documentation for "
1360 "information on default whitelist behavior.",
1363 "-rpcwhitelistdefault",
1364 "Sets default behavior for rpc whitelisting. Unless "
1365 "rpcwhitelistdefault is set to 0, if any -rpcwhitelist is set, the rpc "
1366 "server acts as if all rpc users are subject to "
1367 "empty-unless-otherwise-specified whitelists. If rpcwhitelistdefault "
1368 "is set to 1 and no -rpcwhitelist is set, rpc server acts as if all "
1369 "rpc users are subject to empty whitelists.",
1372 "-rpcauth=<userpw>",
1373 "Username and HMAC-SHA-256 hashed password for JSON-RPC connections. "
1374 "The field <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. A "
1375 "canonical python script is included in share/rpcauth. The client then "
1376 "connects normally using the rpcuser=<USERNAME>/rpcpassword=<PASSWORD> "
1377 "pair of arguments. This option can be specified multiple times",
1379 argsman.
AddArg(
"-rpcport=<port>",
1380 strprintf(
"Listen for JSON-RPC connections on <port> "
1381 "(default: %u, testnet: %u, regtest: %u)",
1382 defaultBaseParams->RPCPort(),
1383 testnetBaseParams->RPCPort(),
1384 regtestBaseParams->RPCPort()),
1389 "Allow JSON-RPC connections from specified source. Valid for "
1390 "<ip> are a single IP (e.g. 1.2.3.4), a network/netmask (e.g. "
1391 "1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). "
1392 "This option can be specified multiple times",
1397 "Set the number of threads to service RPC calls (default: %d)",
1401 "-rpccorsdomain=value",
1402 "Domain from which to accept cross origin requests (browser enforced)",
1405 argsman.
AddArg(
"-rpcworkqueue=<n>",
1406 strprintf(
"Set the depth of the work queue to service RPC "
1407 "calls (default: %d)",
1411 argsman.
AddArg(
"-rpcservertimeout=<n>",
1412 strprintf(
"Timeout during HTTP requests (default: %d)",
1418 argsman.
AddArg(
"-daemon",
1419 strprintf(
"Run in the background as a daemon and accept "
1420 "commands (default: %d)",
1423 argsman.
AddArg(
"-daemonwait",
1424 strprintf(
"Wait for initialization to be finished before "
1425 "exiting. This implies -daemon (default: %d)",
1429 hidden_args.emplace_back(
"-daemon");
1430 hidden_args.emplace_back(
"-daemonwait");
1434 argsman.
AddArg(
"-avalanche",
1435 strprintf(
"Enable the avalanche feature (default: %u)",
1439 "-avalanchestakingrewards",
1440 strprintf(
"Enable the avalanche staking rewards feature (default: %u, "
1441 "testnet: %u, regtest: %u)",
1442 defaultChainParams->GetConsensus().enableStakingRewards,
1443 testnetChainParams->GetConsensus().enableStakingRewards,
1444 regtestChainParams->GetConsensus().enableStakingRewards),
1446 argsman.
AddArg(
"-avalancheconflictingproofcooldown",
1447 strprintf(
"Mandatory cooldown before a proof conflicting "
1448 "with an already registered one can be considered "
1449 "in seconds (default: %u)",
1453 argsman.
AddArg(
"-avalanchepeerreplacementcooldown",
1454 strprintf(
"Mandatory cooldown before a peer can be replaced "
1455 "in seconds (default: %u)",
1460 "-avaminquorumstake",
1462 "Minimum amount of known stake for a usable quorum (default: %s)",
1466 "-avaminquorumconnectedstakeratio",
1467 strprintf(
"Minimum proportion of known stake we"
1468 " need nodes for to have a usable quorum (default: %s). "
1469 "This parameter is parsed with a maximum precision of "
1475 "-avaminavaproofsnodecount",
1476 strprintf(
"Minimum number of node that needs to send us an avaproofs"
1477 " message before we consider we have a usable quorum"
1483 "-avastalevotethreshold",
1484 strprintf(
"Number of avalanche votes before a voted item goes stale "
1485 "when voting confidence is low (default: %u)",
1490 "-avastalevotefactor",
1492 "Factor affecting the number of avalanche votes before a voted "
1493 "item goes stale when voting confidence is high (default: %u)",
1497 argsman.
AddArg(
"-avacooldown",
1498 strprintf(
"Mandatory cooldown between two avapoll in "
1499 "milliseconds (default: %u)",
1504 strprintf(
"Avalanche query timeout in milliseconds (default: %u)",
1509 "Avalanche proof delegation to the master key used by this node "
1510 "(default: none). Should be used in conjunction with -avaproof and "
1513 argsman.
AddArg(
"-avaproof",
1514 "Avalanche proof to be used by this node (default: none)",
1517 "-avaproofstakeutxoconfirmations",
1519 "Minimum number of confirmations before a stake utxo is mature"
1520 " enough to be included into a proof. Utxos in the mempool are not "
1521 "accepted (i.e this value must be greater than 0) (default: %s)",
1525 argsman.
AddArg(
"-avaproofstakeutxodustthreshold",
1526 strprintf(
"Minimum value each stake utxo must have to be "
1527 "considered valid (default: %s)",
1530 argsman.
AddArg(
"-avamasterkey",
1531 "Master key associated with the proof. If a proof is "
1532 "required, this is mandatory.",
1535 argsman.
AddArg(
"-avasessionkey",
"Avalanche session key (default: random)",
1538 argsman.
AddArg(
"-enablertt",
1539 strprintf(
"Whether to enforce Real Time Targeting via "
1540 "Avalanche, default (%u)",
1544 "-maxavalancheoutbound",
1546 "Set the maximum number of avalanche outbound peers to connect to. "
1547 "Note that this option takes precedence over the -maxconnections "
1548 "option (default: %u).",
1554 strprintf(
"Whether to save the avalanche peers upon shutdown and load "
1555 "them upon startup (default: %u).",
1559 hidden_args.emplace_back(
"-avalanchepreconsensus");
1560 hidden_args.emplace_back(
"-avalanchestakingpreconsensus");
1571 if (pBlockIndex !=
nullptr) {
1581static void StartupNotify(
const ArgsManager &args) {
1582 std::string cmd = args.
GetArg(
"-startupnotify",
"");
1584 std::thread t(runCommand, cmd);
1622 "%s: parameter interaction: -bind set -> setting -listen=1\n",
1628 LogPrintf(
"%s: parameter interaction: -whitebind set -> setting "
1638 LogPrintf(
"%s: parameter interaction: -connect set -> setting "
1643 LogPrintf(
"%s: parameter interaction: -connect set -> setting "
1654 "%s: parameter interaction: -proxy set -> setting -listen=0\n",
1662 "%s: parameter interaction: -proxy set -> setting -upnp=0\n",
1667 "%s: parameter interaction: -proxy set -> setting -natpmp=0\n",
1672 LogPrintf(
"%s: parameter interaction: -proxy set -> setting "
1683 "%s: parameter interaction: -listen=0 -> setting -upnp=0\n",
1688 "%s: parameter interaction: -listen=0 -> setting -natpmp=0\n",
1693 "%s: parameter interaction: -listen=0 -> setting -discover=0\n",
1697 LogPrintf(
"%s: parameter interaction: -listen=0 -> setting "
1702 LogPrintf(
"%s: parameter interaction: -listen=0 -> setting "
1703 "-i2pacceptincoming=0\n",
1708 if (args.
IsArgSet(
"-externalip")) {
1711 LogPrintf(
"%s: parameter interaction: -externalip set -> setting "
1720 LogPrintf(
"%s: parameter interaction: -blocksonly=1 -> setting "
1721 "-whitelistrelay=0\n",
1730 LogPrintf(
"%s: parameter interaction: -whitelistforcerelay=1 -> "
1731 "setting -whitelistrelay=1\n",
1738 const bool fAvalanche =
1758int nUserMaxConnections;
1761int64_t peer_connect_timeout;
1762std::set<BlockFilterType> g_enabled_filter_types;
1770 std::set_new_handler(std::terminate);
1771 LogPrintf(
"Error: Out of memory. Terminating.\n");
1781 _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
1782 _CrtSetReportFile(_CRT_WARN, CreateFileA(
"NUL", GENERIC_WRITE, 0,
nullptr,
1783 OPEN_EXISTING, 0, 0));
1785 _set_abort_behavior(0, _WRITE_ABORT_MSG | _CALL_REPORTFAULT);
1789 SetProcessDEPPolicy(PROCESS_DEP_ENABLE);
1793 Untranslated(
"Initializing wait-for-shutdown state failed."));
1814 signal(SIGPIPE, SIG_IGN);
1816 SetConsoleCtrlHandler(consoleCtrlHandler,
true);
1837 strprintf(
_(
"Config setting for %s only applied on %s "
1838 "network when in [%s] section.") +
1843 if (!errors.
empty()) {
1851 _(
"Section [%s] is not recognized.") +
1853 section.m_file, section.m_line, section.m_name);
1856 if (!warnings.
empty()) {
1862 strprintf(
_(
"Specified blocks directory \"%s\" does not exist."),
1863 args.
GetArg(
"-blocksdir",
"")));
1867 std::string blockfilterindex_value =
1869 if (blockfilterindex_value ==
"" || blockfilterindex_value ==
"1") {
1871 }
else if (blockfilterindex_value !=
"0") {
1872 const std::vector<std::string> names =
1873 args.
GetArgs(
"-blockfilterindex");
1874 for (
const auto &
name : names) {
1880 g_enabled_filter_types.insert(filter_type);
1889 _(
"Cannot set -peerblockfilters without -blockfilterindex."));
1897 return InitError(
_(
"Prune mode is incompatible with -txindex."));
1899 if (args.
GetBoolArg(
"-reindex-chainstate",
false)) {
1901 _(
"Prune mode is incompatible with -reindex-chainstate. Use "
1902 "full -reindex instead."));
1905 return InitError(
_(
"Prune mode is incompatible with -chronik."));
1911 args.
GetArgs(
"-bind").size() + args.
GetArgs(
"-whitebind").size();
1914 "Cannot set -bind or -whitebind together with -listen=0"));
1918 int nBind = std::max(nUserBind,
size_t(1));
1919 nUserMaxConnections =
1921 nMaxConnections = std::max(nUserMaxConnections, 0);
1924 const int maxAvalancheOutbound = args.
GetIntArg(
1926 const bool fAvalanche =
1928 if (fAvalanche && maxAvalancheOutbound > nMaxConnections) {
1929 nMaxConnections = std::max(maxAvalancheOutbound, nMaxConnections);
1931 LogPrintf(
"Increasing -maxconnections from %d to %d to comply with "
1932 "-maxavalancheoutbound\n",
1933 nUserMaxConnections, nMaxConnections);
1945 int fd_max = FD_SETSIZE;
1947 nMaxConnections = std::max(
1948 std::min<int>(nMaxConnections,
1953 return InitError(
_(
"Not enough file descriptors available."));
1959 if (nMaxConnections < nUserMaxConnections) {
1963 LogPrintf(
"Reducing -maxconnections from %d to %d, because of system "
1965 nUserMaxConnections, nMaxConnections);
1973 const int64_t nProposedExcessiveBlockSize =
1975 if (nProposedExcessiveBlockSize <= 0 ||
1978 _(
"Excessive block size must be > 1,000,000 bytes (1MB)"));
1982 const int64_t nProposedMaxGeneratedBlockSize =
1984 if (nProposedMaxGeneratedBlockSize <= 0) {
1985 return InitError(
_(
"Max generated block size must be greater than 0"));
1987 if (uint64_t(nProposedMaxGeneratedBlockSize) > config.
GetMaxBlockSize()) {
1988 return InitError(
_(
"Max generated block size (blockmaxsize) cannot "
1989 "exceed the excessive block size "
1990 "(excessiveblocksize)"));
1998 peer_connect_timeout =
2000 if (peer_connect_timeout <= 0) {
2002 "peertimeout cannot be configured with a negative value."));
2008 if (args.
IsArgSet(
"-blockmintxfee")) {
2012 args.
GetArg(
"-blockmintxfee",
"")));
2033 const int64_t stakeUtxoMinConfirmations =
2034 args.
GetIntArg(
"-avaproofstakeutxoconfirmations",
2038 stakeUtxoMinConfirmations !=
2040 return InitError(
_(
"Avalanche stake UTXO minimum confirmations can "
2041 "only be set on test chains."));
2044 if (stakeUtxoMinConfirmations <= 0) {
2045 return InitError(
_(
"Avalanche stake UTXO minimum confirmations must be "
2046 "a positive integer."));
2049 if (args.
IsArgSet(
"-avaproofstakeutxodustthreshold")) {
2052 args.
GetArg(
"-avaproofstakeutxodustthreshold",
""), amount);
2055 "avaproofstakeutxodustthreshold",
2056 args.
GetArg(
"-avaproofstakeutxodustthreshold",
"")));
2061 return InitError(
_(
"Avalanche stake UTXO dust threshold can "
2062 "only be set on test chains."));
2067 if (fAvalanche && args.
IsArgSet(
"-avaproof")) {
2069 return InitError(
_(
"Running a staking node requires accepting "
2070 "inbound connections. Please enable -listen."));
2073 return InitError(
_(
"Running a staking node behind a proxy is not "
2074 "supported. Please disable -proxy."));
2077 return InitError(
_(
"Running a staking node behind I2P is not "
2078 "supported. Please disable -i2psam."));
2082 _(
"Restricting the outbound network is not supported when "
2083 "running a staking node. Please disable -onlynet."));
2093 .notifications = notifications,
2098 BlockManager::Options blockman_opts_dummy{
2099 .chainparams = chainman_opts_dummy.config.GetChainParams(),
2115 _(
"Cannot write to data directory '%s'; check permissions."),
2120 "%s. %s is probably already running."),
2132 _(
"Initialization sanity check failed. %s is shutting down."),
2181 LogPrintf(
"Using at most %i automatic connections (%i file descriptors "
2183 nMaxConnections, nFD);
2187 !args.
GetPathArg(
"-datadir").is_absolute()) {
2188 LogPrintf(
"Warning: relative datadir option '%s' specified, which will "
2189 "be interpreted relative to the current working directory "
2190 "'%s'. This is fragile, because if bitcoin is started in the "
2191 "future from a different location, it will be unable to "
2192 "locate the current data files. There could also be data "
2193 "loss if bitcoin is started while in a temporary "
2195 args.
GetArg(
"-datadir",
""),
2204 _(
"Unable to allocate memory for -maxsigcachesize: '%s' MiB"),
2209 validation_cache_sizes.script_execution_cache_bytes)) {
2211 _(
"Unable to allocate memory for -maxscriptcachesize: '%s' MiB"),
2217 if (script_threads <= 0) {
2225 script_threads = std::max(script_threads - 1, 0);
2230 LogPrintf(
"Script verification uses %d additional threads\n",
2232 if (script_threads >= 1) {
2237 node.scheduler = std::make_unique<CScheduler>();
2240 node.scheduler->m_service_thread =
2242 [&] {
node.scheduler->serviceQueue(); });
2245 node.scheduler->scheduleEvery(
2250 std::chrono::minutes{1});
2259 for (
const auto &client :
node.chain_clients) {
2260 client->registerRpcs();
2276 _(
"Unable to start HTTP server. See debug log for details."));
2281 for (
const auto &client :
node.chain_clients) {
2282 if (!client->verify()) {
2302 std::vector<bool> asmap;
2306 if (!asmap_path.is_absolute()) {
2315 if (asmap.size() == 0) {
2321 LogPrintf(
"Using asmap version %s for IP bucketing\n",
2324 LogPrintf(
"Using /16 prefix for IP bucketing\n");
2327 uiInterface.InitMessage(
_(
"Loading P2P addresses...").translated);
2328 auto addrman{
LoadAddrman(chainparams, asmap, args)};
2332 node.addrman = std::move(*addrman);
2336 node.banman = std::make_unique<BanMan>(
2340 node.connman = std::make_unique<CConnman>(
2341 config, GetRand<uint64_t>(), GetRand<uint64_t>(), *
node.addrman,
2345 std::vector<std::string> uacomments;
2346 for (
const std::string &cmt : args.
GetArgs(
"-uacomment")) {
2349 _(
"User Agent comment (%s) contains unsafe characters."), cmt));
2351 uacomments.push_back(cmt);
2354 const std::string client_version =
2358 _(
"-uaclientname (%s) contains invalid characters."), client_name));
2360 if (client_version !=
2363 strprintf(
_(
"-uaclientversion (%s) contains invalid characters."),
2366 const std::string strSubVersion =
2370 _(
"Total length of network version string (%i) exceeds maximum "
2371 "length (%i). Reduce the number or size of uacomments."),
2376 std::set<enum Network> nets;
2377 for (
const std::string &snet : args.
GetArgs(
"-onlynet")) {
2381 _(
"Unknown network specified in -onlynet: '%s'"), snet));
2385 for (
int n = 0; n <
NET_MAX; n++) {
2387 if (!nets.count(net)) {
2397 bool proxyRandomize =
2402 std::string proxyArg = args.
GetArg(
"-proxy",
"");
2404 if (proxyArg !=
"" && proxyArg !=
"0") {
2408 _(
"Invalid -proxy address or hostname: '%s'"), proxyArg));
2414 _(
"Invalid -proxy address or hostname: '%s'"), proxyArg));
2430 std::string onionArg = args.
GetArg(
"-onion",
"");
2431 if (onionArg !=
"") {
2432 if (onionArg ==
"0") {
2439 _(
"Invalid -onion address or hostname: '%s'"), onionArg));
2444 _(
"Invalid -onion address or hostname: '%s'"), onionArg));
2451 for (
const std::string &strAddr : args.
GetArgs(
"-externalip")) {
2465 return chainman->m_blockman.ReadBlockFromDisk(block, index);
2475 node.notifications = std::make_unique<KernelNotifications>();
2477 bool fReindexChainState = args.
GetBoolArg(
"-reindex-chainstate",
false);
2483 .notifications = *
node.notifications,
2488 if (chainman_opts.checkpoints_enabled) {
2489 LogPrintf(
"Checkpoints will be verified.\n");
2491 LogPrintf(
"Skipping checkpoint verification.\n");
2494 BlockManager::Options blockman_opts{
2495 .chainparams = chainman_opts.config.GetChainParams(),
2506 LogPrintf(
"* Using %.1f MiB for block index database\n",
2509 LogPrintf(
"* Using %.1f MiB for transaction index database\n",
2510 cache_sizes.
tx_index * (1.0 / 1024 / 1024));
2513 LogPrintf(
"* Using %.1f MiB for %s block filter index database\n",
2517 LogPrintf(
"* Using %.1f MiB for chain state database\n",
2518 cache_sizes.
coins_db * (1.0 / 1024 / 1024));
2529 mempool_opts.check_ratio =
2530 std::clamp<int>(mempool_opts.check_ratio, 0, 1'000'000);
2536 int64_t nMempoolSizeMin = 101 * 1000 * 40;
2537 if (mempool_opts.max_size_bytes < 0 ||
2539 mempool_opts.max_size_bytes < nMempoolSizeMin)) {
2541 std::ceil(nMempoolSizeMin / 1000000.0)));
2543 LogPrintf(
"* Using %.1f MiB for in-memory UTXO set (plus up to %.1f MiB of "
2544 "unused mempool space)\n",
2545 cache_sizes.
coins * (1.0 / 1024 / 1024),
2546 mempool_opts.max_size_bytes * (1.0 / 1024 / 1024));
2549 node.mempool = std::make_unique<CTxMemPool>(config, mempool_opts);
2552 std::make_unique<ChainstateManager>(chainman_opts, blockman_opts);
2559 if (!
node.chainman->m_blockman.IsPruneMode()) {
2560 LogPrintf(
"[snapshot] re-enabling NODE_NETWORK services\n");
2564 LogPrintf(
"[snapshot] restarting indexes\n");
2570 for (
auto *index :
node.indexes) {
2573 if (!(index->Init() && index->StartBackgroundSync())) {
2574 LogPrintf(
"[snapshot] WARNING failed to restart index %s "
2575 "on snapshot chain\n",
2594 _(
"Error reading from database, shutting down."),
"",
2598 uiInterface.InitMessage(
_(
"Loading block index...").translated);
2600 const int64_t load_block_index_start_time =
GetTimeMillis();
2601 auto catch_exceptions = [](
auto &&f) {
2604 }
catch (
const std::exception &e) {
2607 _(
"Error opening block database"));
2610 auto [status,
error] = catch_exceptions(
2616 LogWarning(
"pruned datadir may not have more than %d "
2617 "blocks; only checking available blocks\n",
2620 std::tie(status,
error) = catch_exceptions(
2624 node.chainman->m_options.datadir /
2644 _(
"Do you want to rebuild the block database now?"),
2645 error.original +
".\nPlease restart with -reindex or "
2646 "-reindex-chainstate to recover.",
2654 LogPrintf(
"Aborted block database rebuild. Exiting.\n");
2668 LogPrintf(
"Shutdown requested. Exiting.\n");
2678 args, *
node.chain,
node.connman.get(), chainman,
node.mempool.get(),
2679 *
node.scheduler, avalancheError);
2680 if (!
node.avalanche) {
2685 if (
node.avalanche->isAvalancheServiceAvailable()) {
2695 node.banman.get(), chainman, *
node.mempool,
2696 node.avalanche.get(), peerman_opts);
2719 for (
const auto &filter_type : g_enabled_filter_types) {
2734 for (
auto index :
node.indexes) {
2735 if (!index->Init()) {
2740 const bool background_sync_in_progress{
WITH_LOCK(
2744 if (background_sync_in_progress) {
2746 _(
"Assumeutxo is incompatible with -chronik. Wait for "
2747 "background sync to complete before enabling Chronik."));
2750 const bool fReindexChronik =
2752 if (!chronik::Start(args, config,
node, fReindexChronik)) {
2759 for (
const auto &client :
node.chain_clients) {
2760 if (!client->load()) {
2773 uiInterface.InitMessage(
_(
"Pruning blockstore...").translated);
2774 chainstate->PruneAndFlush();
2780 if (!background_sync_in_progress) {
2781 LogPrintf(
"Setting NODE_NETWORK on non-prune mode\n");
2784 LogPrintf(
"Running node in NODE_NETWORK_LIMITED mode until "
2785 "snapshot background sync completes\n");
2792 strprintf(
_(
"Error: Disk space is low for %s"),
2798 strprintf(
_(
"Error: Disk space is low for %s"),
2806 boost::signals2::connection block_notify_genesis_wait_connection;
2809 block_notify_genesis_wait_connection =
2816#if defined(HAVE_SYSTEM)
2817 const std::string block_notify = args.
GetArg(
"-blocknotify",
"");
2818 if (!block_notify.empty()) {
2819 uiInterface.NotifyBlockTip_connect([block_notify](
2825 std::string command = block_notify;
2827 std::thread t(runCommand, command);
2834 std::vector<fs::path> vImportFiles;
2835 for (
const std::string &strFile : args.
GetArgs(
"-loadblock")) {
2847 _(
"Failed to start indexes, shutting down..");
2869 block_notify_genesis_wait_connection.disconnect();
2878 int chain_active_height;
2894 if (tip_info && chainman.m_best_header) {
2896 tip_info->
header_time = chainman.m_best_header->GetBlockTime();
2899 LogPrintf(
"nBestHeight = %d\n", chain_active_height);
2901 node.peerman->SetBestHeight(chain_active_height);
2913 ? args.
GetIntArg(
"-maxavalancheoutbound",
2928 if (
node.avalanche) {
2947 const uint16_t default_bind_port =
static_cast<uint16_t
>(
2950 const auto BadPortWarning = [](
const char *
prefix, uint16_t port) {
2951 return strprintf(
_(
"%s request to listen on port %u. This port is "
2952 "considered \"bad\" and "
2953 "thus it is unlikely that any Bitcoin ABC peers "
2954 "connect to it. See "
2955 "doc/p2p-bad-ports.md for details and a full list."),
2959 for (
const std::string &bind_arg : args.
GetArgs(
"-bind")) {
2961 const size_t index = bind_arg.rfind(
'=');
2962 if (index == std::string::npos) {
2963 if (
Lookup(bind_arg, bind_addr, default_bind_port,
2965 connOptions.
vBinds.push_back(bind_addr);
2972 const std::string network_type = bind_arg.substr(index + 1);
2973 if (network_type ==
"onion") {
2974 const std::string truncated_bind_arg =
2975 bind_arg.substr(0, index);
2976 if (
Lookup(truncated_bind_arg, bind_addr,
2977 BaseParams().OnionServiceTargetPort(),
false)) {
2986 for (
const std::string &strBind : args.
GetArgs(
"-whitebind")) {
2998 args.
GetArgs(
"-bind").empty() && args.
GetArgs(
"-whitebind").empty();
3003 const uint16_t port_arg = args.
GetIntArg(
"-port", 0);
3011 onion_service_target = connOptions.
onion_binds.front();
3012 }
else if (!connOptions.
vBinds.empty()) {
3013 onion_service_target = connOptions.
vBinds.front();
3016 connOptions.
onion_binds.push_back(onion_service_target);
3022 _(
"More than one onion bind address is provided. Using %s "
3023 "for the automatically created Tor onion service."),
3035 for (
const auto &net : args.
GetArgs(
"-whitelist")) {
3040 connection_direction,
error)) {
3056 const auto connect = args.
GetArgs(
"-connect");
3057 if (connect.size() != 1 || connect[0] !=
"0") {
3062 const std::string &i2psam_arg = args.
GetArg(
"-i2psam",
"");
3063 if (!i2psam_arg.empty()) {
3067 _(
"Invalid -i2psam address or hostname: '%s'"), i2psam_arg));
3078 if (!
node.connman->Start(*
node.scheduler, connOptions)) {
3098 for (
const auto &client :
node.chain_clients) {
3099 client->start(*
node.scheduler);
3103 node.scheduler->scheduleEvery(
3111 if (
node.avalanche) {
3112 node.avalanche->startEventLoop(*
node.scheduler);
3116 node.peerman->StartScheduledTasks(*
node.scheduler);
3120 StartupNotify(args);
3131 std::optional<const CBlockIndex *> indexes_start_block;
3132 std::string older_index_name;
3138 for (
auto index :
node.indexes) {
3149 if (!index_chain.
Contains(pindex)) {
3150 pindex = index_chain.
FindFork(pindex);
3153 if (!indexes_start_block || !pindex ||
3154 pindex->
nHeight < indexes_start_block.value()->nHeight) {
3155 indexes_start_block = pindex;
3156 older_index_name = summary.
name;
3165 if (indexes_start_block) {
3167 const CBlockIndex *start_block = *indexes_start_block;
3171 if (!chainman.
m_blockman.CheckBlockDataAvailability(
3172 *index_chain.
Tip(), *
Assert(start_block))) {
3174 Untranslated(
"%s best block of the index goes beyond pruned "
3175 "data. Please disable the index or reindex (which "
3176 "will download the whole blockchain again)"),
3182 for (
auto index :
node.indexes) {
3183 if (!index->StartBackgroundSync()) {
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::set< BlockFilterType > & AllBlockFilterTypes()
Get a list of known filter types.
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.
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(std::function< std::unique_ptr< interfaces::Chain >()> make_chain, 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 ChainType 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.
std::unique_ptr< CBaseChainParams > CreateBaseChainParams(const ChainType chain)
Port numbers for incoming Tor connections (8334, 18334, 38334, 18445) have been chosen arbitrarily to...
void SetupChainParamsBaseOptions(ArgsManager &argsman)
Set the arguments for chainparams.
static constexpr bool DEFAULT_CHECKPOINTS_ENABLED
static constexpr auto DEFAULT_MAX_TIP_AGE
static constexpr bool DEFAULT_STORE_RECENT_HEADERS_TIME
std::string ChainTypeToString(ChainType chain)
#define Assert(val)
Identity function.
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...
std::list< SectionInfo > GetUnrecognizedSections() const
Log warnings for unrecognized section names in the config file.
@ ALLOW_ANY
disable validation
@ DISALLOW_NEGATION
unimplemented, draft implementation in #16545
@ DISALLOW_ELISION
disallow -foo syntax that doesn't assign any value
ChainType GetChainType() const
Looks for -regtest, -testnet and returns the appropriate BIP70 chain name.
std::vector< std::string > GetArgs(const std::string &strArg) const
Return a vector of strings of the given argument.
fs::path GetDataDirNet() const
Get data directory path with appended network identifier.
bool IsArgSet(const std::string &strArg) const
Return true if the given argument has been manually set.
int64_t GetIntArg(const std::string &strArg, int64_t nDefault) const
Return integer argument or default value.
fs::path GetBlocksDirPath() const
Get blocks directory path.
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.
std::atomic< bool > m_reopen_file
void Stop()
Stops the instance from staying in sync with blockchain updates.
bool BlockUntilSyncedToCurrentChain() const LOCKS_EXCLUDED(void Interrupt()
Blocks the current thread until the index is caught up to the current state of the block chain.
BlockFilterIndex is used to store and retrieve block filters, hashes, and headers for a range of bloc...
The block chain is a tree shaped structure starting with the genesis block at the root,...
int64_t GetBlockTime() const
BlockHash GetBlockHash() const
int nHeight
height of the entry in the chain. The genesis block has height 0
An in-memory indexed chain of blocks.
CBlockIndex * Tip() const
Returns the index entry for the tip of this chain, or nullptr if none.
CBlockIndex * Genesis() const
Returns the index entry for the genesis block of this chain, or nullptr if none.
int Height() const
Return the maximal height in the chain.
const CBlockIndex * FindFork(const CBlockIndex *pindex) const
Find the last common block between this chain and a block index entry.
bool Contains(const CBlockIndex *pindex) const
Efficiently check whether a block is present in this chain.
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
const CBlock & GenesisBlock() const
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
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.
CChain m_chain
The current chain of blockheaders we consult and build on.
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
node::BlockMap & BlockIndex() EXCLUSIVE_LOCKS_REQUIRED(
SnapshotCompletionResult MaybeCompleteSnapshotValidation(std::function< void(bilingual_str)> shutdown_fnc=[](bilingual_str msg) { AbortNode(msg.original, msg);}) EXCLUSIVE_LOCKS_REQUIRED(const CBlockIndex *GetSnapshotBaseBlock() const EXCLUSIVE_LOCKS_REQUIRED(Chainstate ActiveChainstate)() const
Once the background validation chainstate has reached the height which is the base of the UTXO snapsh...
std::thread m_thread_load
RecursiveMutex & GetMutex() const LOCK_RETURNED(
Alias for cs_main.
CBlockIndex * ActiveTip() const EXCLUSIVE_LOCKS_REQUIRED(GetMutex())
bool BackgroundSyncInProgress() const EXCLUSIVE_LOCKS_REQUIRED(GetMutex())
The state of a background sync (for net processing)
std::function< void()> snapshot_download_completed
Function to restart active indexes; set dynamically to avoid a circular dependency on base/index....
const CChainParams & GetParams() const
CChain & ActiveChain() 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, ConnectionDirection &output_connection_direction, 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...
bool CheckBlockDataAvailability(const CBlockIndex &upper_block LIFETIMEBOUND, const CBlockIndex &lower_block LIFETIMEBOUND) EXCLUSIVE_LOCKS_REQUIRED(const CBlockIndex *GetFirstBlock(const CBlockIndex &upper_block LIFETIMEBOUND, std::function< bool(BlockStatus)> status_test, const CBlockIndex *lower_block=nullptr) const EXCLUSIVE_LOCKS_REQUIRED(boo m_have_pruned)
Check if all blocks in the [upper_block, lower_block] range have data available.
CBlockIndex * LookupBlockIndex(const BlockHash &hash) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
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 StartIndexBackgroundSync(NodeContext &node)
Validates requirements to run the indexes and spawns each index initial sync thread.
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()
bool AppInitSanityChecks(const kernel::Context &kernel)
Initialization sanity checks.
static const std::string HEADERS_TIME_FILE_NAME
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 StartLogging(const ArgsManager &args)
void SetLoggingLevel(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)
util::Result< void > SanityChecks(const Context &)
Ensure a usable environment with all necessary library support.
@ 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)
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
void ImportBlocks(ChainstateManager &chainman, avalanche::Processor *const avalanche, std::vector< fs::path > vImportFiles)
void ApplyArgsManOptions(const ArgsManager &args, const Config &config, BlockFitter::Options &options)
Apply options from ArgsManager to BlockFitter options.
bilingual_str ErrorString(const Result< T > &result)
void TraceThread(std::string_view 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_FORCEDNSSEED
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 bool DEFAULT_WHITELISTFORCERELAY
Default for -whitelistforcerelay.
static const bool DEFAULT_WHITELISTRELAY
Default for -whitelistrelay.
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.
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)
std::vector< std::string > GetNetworkNames(bool append_unroutable)
Return a vector of publicly routable Network names; optionally append NET_UNROUTABLE.
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
static constexpr bool DEFAULT_ENABLE_RTT
Default for -enablertt.
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 AbortNode(const std::string &strMessage, bilingual_str user_message)
Abort with a message.
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
@ 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
A BlockHash is a unqiue identifier for a block.
int m_max_outbound_block_relay
unsigned int nReceiveFloodSize
int m_max_outbound_full_relay
std::vector< NetWhitebindPermissions > vWhiteBinds
uint64_t nMaxOutboundLimit
CClientUIInterface * uiInterface
std::vector< NetWhitelistPermissions > vWhitelistedRangeIncoming
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 whitelist_forcerelay
bool bind_on_any
True if the user did not specify -bind= or -whitebind= and thus we should bind on 0....
std::vector< NetWhitelistPermissions > vWhitelistedRangeOutgoing
static const Currency & get()
BlockHash best_block_hash
Block and header tip information.
double verification_progress
An options struct for ChainstateManager, more ergonomically referred to as ChainstateManager::Options...
Context struct holding the kernel library's logically global state, and passed to external libbitcoin...
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.
std::string SanitizeString(std::string_view str, int rule)
Remove unsafe chars.
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.
void SyncWithValidationInterfaceQueue()
This is a synonym for the following, which asserts certain locks are not held: std::promise<void> pro...
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)