LCOV - code coverage report
Current view: top level - src - init.cpp (source / functions) Hit Total Coverage
Test: fuzz_coverage.info Lines: 249 1115 22.3 %
Date: 2023-11-10 23:46:46 Functions: 3 63 4.8 %
Branches: 556 3704 15.0 %

           Branch data     Line data    Source code
       1                 :            : // Copyright (c) 2009-2010 Satoshi Nakamoto
       2                 :            : // Copyright (c) 2009-2022 The Bitcoin Core developers
       3                 :            : // Distributed under the MIT software license, see the accompanying
       4                 :            : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
       5                 :            : 
       6                 :            : #if defined(HAVE_CONFIG_H)
       7                 :            : #include <config/bitcoin-config.h>
       8                 :            : #endif
       9                 :            : 
      10                 :            : #include <init.h>
      11                 :            : 
      12                 :            : #include <kernel/checks.h>
      13                 :            : #include <kernel/mempool_persist.h>
      14                 :            : #include <kernel/validation_cache_sizes.h>
      15                 :            : 
      16                 :            : #include <addrman.h>
      17         [ +  - ]:          2 : #include <banman.h>
      18         [ +  - ]:          2 : #include <blockfilter.h>
      19                 :            : #include <chain.h>
      20                 :            : #include <chainparams.h>
      21                 :          0 : #include <chainparamsbase.h>
      22                 :            : #include <clientversion.h>
      23                 :            : #include <common/args.h>
      24                 :            : #include <common/system.h>
      25                 :            : #include <consensus/amount.h>
      26                 :            : #include <deploymentstatus.h>
      27                 :          2 : #include <hash.h>
      28                 :            : #include <httprpc.h>
      29                 :            : #include <httpserver.h>
      30                 :            : #include <index/blockfilterindex.h>
      31                 :            : #include <index/coinstatsindex.h>
      32                 :            : #include <index/txindex.h>
      33                 :            : #include <init/common.h>
      34                 :            : #include <interfaces/chain.h>
      35                 :          1 : #include <interfaces/init.h>
      36                 :          1 : #include <interfaces/node.h>
      37                 :            : #include <logging.h>
      38                 :            : #include <mapport.h>
      39                 :          1 : #include <net.h>
      40                 :            : #include <net_permissions.h>
      41                 :          1 : #include <net_processing.h>
      42                 :            : #include <netbase.h>
      43 [ +  - ][ #  # ]:          1 : #include <netgroup.h>
         [ #  # ][ #  # ]
      44         [ #  # ]:          1 : #include <node/blockmanager_args.h>
      45                 :          1 : #include <node/blockstorage.h>
      46         [ #  # ]:          1 : #include <node/caches.h>
      47         [ #  # ]:          0 : #include <node/chainstate.h>
      48                 :            : #include <node/chainstatemanager_args.h>
      49                 :            : #include <node/context.h>
      50                 :            : #include <node/interface_ui.h>
      51                 :            : #include <node/kernel_notifications.h>
      52                 :            : #include <node/mempool_args.h>
      53         [ #  # ]:          0 : #include <node/mempool_persist_args.h>
      54                 :            : #include <node/miner.h>
      55         [ #  # ]:          0 : #include <node/peerman_args.h>
      56                 :            : #include <node/validation_cache_args.h>
      57                 :            : #include <policy/feerate.h>
      58                 :            : #include <policy/fees.h>
      59                 :          0 : #include <policy/fees_args.h>
      60                 :            : #include <policy/policy.h>
      61                 :            : #include <policy/settings.h>
      62                 :            : #include <protocol.h>
      63                 :            : #include <rpc/blockchain.h>
      64                 :            : #include <rpc/register.h>
      65                 :            : #include <rpc/server.h>
      66                 :            : #include <rpc/util.h>
      67                 :            : #include <scheduler.h>
      68                 :            : #include <script/sigcache.h>
      69                 :            : #include <shutdown.h>
      70                 :            : #include <sync.h>
      71                 :            : #include <timedata.h>
      72                 :            : #include <torcontrol.h>
      73                 :            : #include <txdb.h>
      74                 :            : #include <txmempool.h>
      75                 :            : #include <util/asmap.h>
      76                 :            : #include <util/chaintype.h>
      77                 :            : #include <util/check.h>
      78                 :            : #include <util/fs.h>
      79                 :            : #include <util/fs_helpers.h>
      80                 :            : #include <util/moneystr.h>
      81                 :            : #include <util/result.h>
      82                 :            : #include <util/strencodings.h>
      83         [ +  - ]:          2 : #include <util/string.h>
      84                 :            : #include <util/syserror.h>
      85                 :            : #include <util/thread.h>
      86                 :            : #include <util/threadnames.h>
      87                 :            : #include <util/time.h>
      88                 :            : #include <util/translation.h>
      89                 :            : #include <validation.h>
      90                 :            : #include <validationinterface.h>
      91                 :          2 : #include <walletinitinterface.h>
      92                 :            : 
      93                 :            : #include <algorithm>
      94                 :            : #include <condition_variable>
      95                 :            : #include <cstdint>
      96                 :            : #include <cstdio>
      97                 :            : #include <fstream>
      98                 :            : #include <functional>
      99                 :          2 : #include <set>
     100                 :            : #include <string>
     101                 :            : #include <thread>
     102                 :            : #include <vector>
     103                 :            : 
     104                 :            : #ifndef WIN32
     105                 :            : #include <cerrno>
     106                 :            : #include <signal.h>
     107                 :            : #include <sys/stat.h>
     108                 :            : #endif
     109                 :            : 
     110                 :            : #include <boost/signals2/signal.hpp>
     111                 :            : 
     112                 :            : #if ENABLE_ZMQ
     113                 :            : #include <zmq/zmqabstractnotifier.h>
     114                 :            : #include <zmq/zmqnotificationinterface.h>
     115                 :            : #include <zmq/zmqrpc.h>
     116                 :            : #endif
     117                 :            : 
     118                 :            : using kernel::DumpMempool;
     119                 :            : using kernel::LoadMempool;
     120                 :            : using kernel::ValidationCacheSizes;
     121                 :            : 
     122                 :            : using node::ApplyArgsManOptions;
     123                 :            : using node::BlockManager;
     124                 :            : using node::CacheSizes;
     125                 :            : using node::CalculateCacheSizes;
     126                 :            : using node::DEFAULT_PERSIST_MEMPOOL;
     127                 :            : using node::DEFAULT_PRINTPRIORITY;
     128                 :            : using node::DEFAULT_STOPATHEIGHT;
     129                 :            : using node::fReindex;
     130                 :            : using node::KernelNotifications;
     131                 :            : using node::LoadChainstate;
     132                 :            : using node::MempoolPath;
     133                 :            : using node::NodeContext;
     134                 :            : using node::ShouldPersistMempool;
     135                 :            : using node::ImportBlocks;
     136                 :            : using node::VerifyLoadedChainstate;
     137                 :            : 
     138                 :            : static constexpr bool DEFAULT_PROXYRANDOMIZE{true};
     139                 :            : static constexpr bool DEFAULT_REST_ENABLE{false};
     140                 :            : static constexpr bool DEFAULT_I2P_ACCEPT_INCOMING{true};
     141                 :            : static constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT{false};
     142                 :            : 
     143                 :            : #ifdef WIN32
     144                 :            : // Win32 LevelDB doesn't use filedescriptors, and the ones used for
     145                 :            : // accessing block files don't count towards the fd_set size limit
     146                 :            : // anyway.
     147                 :            : #define MIN_CORE_FILEDESCRIPTORS 0
     148                 :            : #else
     149                 :            : #define MIN_CORE_FILEDESCRIPTORS 150
     150                 :            : #endif
     151                 :            : 
     152                 :            : static const char* DEFAULT_ASMAP_FILENAME="ip_asn.map";
     153                 :            : 
     154                 :            : /**
     155                 :            :  * The PID file facilities.
     156                 :            :  */
     157                 :            : static const char* BITCOIN_PID_FILENAME = "bitcoind.pid";
     158                 :            : 
     159                 :          0 : static fs::path GetPidFile(const ArgsManager& args)
     160                 :            : {
     161 [ #  # ][ #  # ]:          0 :     return AbsPathForConfigVal(args, args.GetPathArg("-pid", BITCOIN_PID_FILENAME));
         [ #  # ][ #  # ]
     162                 :          0 : }
     163                 :            : 
     164                 :          0 : [[nodiscard]] static bool CreatePidFile(const ArgsManager& args)
     165                 :            : {
     166         [ #  # ]:          0 :     std::ofstream file{GetPidFile(args)};
     167 [ #  # ][ #  # ]:          0 :     if (file) {
     168                 :            : #ifdef WIN32
     169                 :            :         tfm::format(file, "%d\n", GetCurrentProcessId());
     170                 :            : #else
     171         [ #  # ]:          0 :         tfm::format(file, "%d\n", getpid());
     172                 :            : #endif
     173                 :          0 :         return true;
     174                 :            :     } else {
     175 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Unable to create the PID file '%s': %s"), fs::PathToString(GetPidFile(args)), SysErrorString(errno)));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     176                 :            :     }
     177                 :          0 : }
     178                 :            : 
     179                 :            : //////////////////////////////////////////////////////////////////////////////
     180                 :            : //
     181                 :            : // Shutdown
     182                 :            : //
     183                 :            : 
     184                 :            : //
     185                 :            : // Thread management and startup/shutdown:
     186                 :            : //
     187                 :            : // The network-processing threads are all part of a thread group
     188                 :            : // created by AppInit() or the Qt main() function.
     189                 :            : //
     190                 :            : // A clean exit happens when StartShutdown() or the SIGTERM
     191                 :            : // signal handler sets ShutdownRequested(), which makes main thread's
     192                 :            : // WaitForShutdown() interrupts the thread group.
     193                 :            : // And then, WaitForShutdown() makes all other on-going threads
     194                 :            : // in the thread group join the main thread.
     195                 :            : // Shutdown() is then called to clean up database connections, and stop other
     196                 :            : // threads that should only be stopped after the main network-processing
     197                 :            : // threads have exited.
     198                 :            : //
     199                 :            : // Shutdown for Qt is very similar, only it uses a QTimer to detect
     200                 :            : // ShutdownRequested() getting set, and then does the normal Qt
     201                 :            : // shutdown thing.
     202                 :            : //
     203                 :            : 
     204                 :            : #if HAVE_SYSTEM
     205                 :          0 : static void ShutdownNotify(const ArgsManager& args)
     206                 :            : {
     207                 :          0 :     std::vector<std::thread> threads;
     208 [ #  # ][ #  # ]:          0 :     for (const auto& cmd : args.GetArgs("-shutdownnotify")) {
                 [ #  # ]
     209         [ #  # ]:          0 :         threads.emplace_back(runCommand, cmd);
     210                 :            :     }
     211         [ #  # ]:          0 :     for (auto& t : threads) {
     212         [ #  # ]:          0 :         t.join();
     213                 :            :     }
     214                 :          0 : }
     215                 :            : #endif
     216                 :            : 
     217                 :          0 : void Interrupt(NodeContext& node)
     218                 :            : {
     219                 :            : #if HAVE_SYSTEM
     220                 :          0 :     ShutdownNotify(*node.args);
     221                 :            : #endif
     222                 :          0 :     InterruptHTTPServer();
     223                 :          0 :     InterruptHTTPRPC();
     224                 :          0 :     InterruptRPC();
     225                 :          0 :     InterruptREST();
     226                 :          0 :     InterruptTorControl();
     227                 :          0 :     InterruptMapPort();
     228         [ #  # ]:          0 :     if (node.connman)
     229                 :          0 :         node.connman->Interrupt();
     230         [ #  # ]:          0 :     if (g_txindex) {
     231                 :          0 :         g_txindex->Interrupt();
     232                 :          0 :     }
     233         [ #  # ]:          0 :     ForEachBlockFilterIndex([](BlockFilterIndex& index) { index.Interrupt(); });
     234         [ #  # ]:          0 :     if (g_coin_stats_index) {
     235                 :          0 :         g_coin_stats_index->Interrupt();
     236                 :          0 :     }
     237                 :          0 : }
     238                 :            : 
     239                 :          0 : void Shutdown(NodeContext& node)
     240                 :            : {
     241 [ #  # ][ #  # ]:          0 :     static Mutex g_shutdown_mutex;
     242                 :          0 :     TRY_LOCK(g_shutdown_mutex, lock_shutdown);
     243 [ #  # ][ #  # ]:          0 :     if (!lock_shutdown) return;
     244 [ #  # ][ #  # ]:          0 :     LogPrintf("%s: In progress...\n", __func__);
                 [ #  # ]
     245         [ #  # ]:          0 :     Assert(node.args);
     246                 :            : 
     247                 :            :     /// Note: Shutdown() must be able to handle cases in which initialization failed part of the way,
     248                 :            :     /// for example if the data directory was found to be locked.
     249                 :            :     /// Be sure that anything that writes files or flushes caches only does this if the respective
     250                 :            :     /// module was initialized.
     251 [ #  # ][ #  # ]:          0 :     util::ThreadRename("shutoff");
     252 [ #  # ][ #  # ]:          0 :     if (node.mempool) node.mempool->AddTransactionsUpdated(1);
     253                 :            : 
     254         [ #  # ]:          0 :     StopHTTPRPC();
     255         [ #  # ]:          0 :     StopREST();
     256         [ #  # ]:          0 :     StopRPC();
     257         [ #  # ]:          0 :     StopHTTPServer();
     258         [ #  # ]:          0 :     for (const auto& client : node.chain_clients) {
     259         [ #  # ]:          0 :         client->flush();
     260                 :            :     }
     261         [ #  # ]:          0 :     StopMapPort();
     262                 :            : 
     263                 :            :     // Because these depend on each-other, we make sure that neither can be
     264                 :            :     // using the other before destroying them.
     265 [ #  # ][ #  # ]:          0 :     if (node.peerman) UnregisterValidationInterface(node.peerman.get());
     266 [ #  # ][ #  # ]:          0 :     if (node.connman) node.connman->Stop();
     267                 :            : 
     268         [ #  # ]:          0 :     StopTorControl();
     269                 :            : 
     270                 :            :     // After everything has been shut down, but before things get flushed, stop the
     271                 :            :     // CScheduler/checkqueue, scheduler and load block thread.
     272 [ #  # ][ #  # ]:          0 :     if (node.scheduler) node.scheduler->stop();
     273 [ #  # ][ #  # ]:          0 :     if (node.chainman && node.chainman->m_thread_load.joinable()) node.chainman->m_thread_load.join();
                 [ #  # ]
     274         [ #  # ]:          0 :     StopScriptCheckWorkerThreads();
     275                 :            : 
     276                 :            :     // After the threads that potentially access these pointers have been stopped,
     277                 :            :     // destruct and reset all to nullptr.
     278                 :          0 :     node.peerman.reset();
     279                 :          0 :     node.connman.reset();
     280                 :          0 :     node.banman.reset();
     281                 :          0 :     node.addrman.reset();
     282                 :          0 :     node.netgroupman.reset();
     283                 :            : 
     284 [ #  # ][ #  # ]:          0 :     if (node.mempool && node.mempool->GetLoadTried() && ShouldPersistMempool(*node.args)) {
         [ #  # ][ #  # ]
                 [ #  # ]
     285 [ #  # ][ #  # ]:          0 :         DumpMempool(*node.mempool, MempoolPath(*node.args));
     286                 :          0 :     }
     287                 :            : 
     288                 :            :     // Drop transactions we were still watching, and record fee estimations.
     289 [ #  # ][ #  # ]:          0 :     if (node.fee_estimator) node.fee_estimator->Flush();
     290                 :            : 
     291                 :            :     // FlushStateToDisk generates a ChainStateFlushed callback, which we should avoid missing
     292         [ #  # ]:          0 :     if (node.chainman) {
     293 [ #  # ][ #  # ]:          0 :         LOCK(cs_main);
     294 [ #  # ][ #  # ]:          0 :         for (Chainstate* chainstate : node.chainman->GetAll()) {
     295 [ #  # ][ #  # ]:          0 :             if (chainstate->CanFlushToDisk()) {
     296         [ #  # ]:          0 :                 chainstate->ForceFlushStateToDisk();
     297                 :          0 :             }
     298                 :            :         }
     299                 :          0 :     }
     300                 :            : 
     301                 :            :     // After there are no more peers/RPC left to give us new data which may generate
     302                 :            :     // CValidationInterface callbacks, flush them...
     303 [ #  # ][ #  # ]:          0 :     GetMainSignals().FlushBackgroundCallbacks();
     304                 :            : 
     305                 :            :     // Stop and delete all indexes only after flushing background callbacks.
     306         [ #  # ]:          0 :     if (g_txindex) {
     307         [ #  # ]:          0 :         g_txindex->Stop();
     308                 :          0 :         g_txindex.reset();
     309                 :          0 :     }
     310         [ #  # ]:          0 :     if (g_coin_stats_index) {
     311         [ #  # ]:          0 :         g_coin_stats_index->Stop();
     312                 :          0 :         g_coin_stats_index.reset();
     313                 :          0 :     }
     314         [ #  # ]:          0 :     ForEachBlockFilterIndex([](BlockFilterIndex& index) { index.Stop(); });
     315         [ #  # ]:          0 :     DestroyAllBlockFilterIndexes();
     316                 :            : 
     317                 :            :     // Any future callbacks will be dropped. This should absolutely be safe - if
     318                 :            :     // missing a callback results in an unrecoverable situation, unclean shutdown
     319                 :            :     // would too. The only reason to do the above flushes is to let the wallet catch
     320                 :            :     // up with our current chain to avoid any strange pruning edge cases and make
     321                 :            :     // next startup faster by avoiding rescan.
     322                 :            : 
     323         [ #  # ]:          0 :     if (node.chainman) {
     324 [ #  # ][ #  # ]:          0 :         LOCK(cs_main);
     325 [ #  # ][ #  # ]:          0 :         for (Chainstate* chainstate : node.chainman->GetAll()) {
     326 [ #  # ][ #  # ]:          0 :             if (chainstate->CanFlushToDisk()) {
     327         [ #  # ]:          0 :                 chainstate->ForceFlushStateToDisk();
     328         [ #  # ]:          0 :                 chainstate->ResetCoinsViews();
     329                 :          0 :             }
     330                 :            :         }
     331                 :          0 :     }
     332         [ #  # ]:          0 :     for (const auto& client : node.chain_clients) {
     333         [ #  # ]:          0 :         client->stop();
     334                 :            :     }
     335                 :            : 
     336                 :            : #if ENABLE_ZMQ
     337                 :            :     if (g_zmq_notification_interface) {
     338                 :            :         UnregisterValidationInterface(g_zmq_notification_interface.get());
     339                 :            :         g_zmq_notification_interface.reset();
     340                 :            :     }
     341                 :            : #endif
     342                 :            : 
     343                 :          0 :     node.chain_clients.clear();
     344         [ #  # ]:          0 :     UnregisterAllValidationInterfaces();
     345 [ #  # ][ #  # ]:          0 :     GetMainSignals().UnregisterBackgroundSignalScheduler();
     346                 :          0 :     node.kernel.reset();
     347                 :          0 :     node.mempool.reset();
     348                 :          0 :     node.fee_estimator.reset();
     349                 :          0 :     node.chainman.reset();
     350                 :          0 :     node.scheduler.reset();
     351                 :            : 
     352                 :            :     try {
     353 [ #  # ][ #  # ]:          0 :         if (!fs::remove(GetPidFile(*node.args))) {
                 [ #  # ]
     354 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: Unable to remove PID file: File does not exist\n", __func__);
                 [ #  # ]
     355                 :          0 :         }
     356         [ #  # ]:          0 :     } catch (const fs::filesystem_error& e) {
     357 [ #  # ][ #  # ]:          0 :         LogPrintf("%s: Unable to remove PID file: %s\n", __func__, fsbridge::get_filesystem_error_message(e));
         [ #  # ][ #  # ]
     358 [ #  # ][ #  # ]:          0 :     }
     359                 :            : 
     360 [ #  # ][ #  # ]:          0 :     LogPrintf("%s: done\n", __func__);
                 [ #  # ]
     361         [ #  # ]:          0 : }
     362                 :            : 
     363                 :            : /**
     364                 :            :  * Signal handlers are very limited in what they are allowed to do.
     365                 :            :  * The execution context the handler is invoked in is not guaranteed,
     366                 :            :  * so we restrict handler operations to just touching variables:
     367                 :            :  */
     368                 :            : #ifndef WIN32
     369                 :          0 : static void HandleSIGTERM(int)
     370                 :            : {
     371                 :          0 :     StartShutdown();
     372                 :          0 : }
     373                 :            : 
     374                 :          0 : static void HandleSIGHUP(int)
     375                 :            : {
     376                 :          0 :     LogInstance().m_reopen_file = true;
     377                 :          0 : }
     378                 :            : #else
     379                 :            : static BOOL WINAPI consoleCtrlHandler(DWORD dwCtrlType)
     380                 :            : {
     381                 :            :     StartShutdown();
     382                 :            :     Sleep(INFINITE);
     383                 :            :     return true;
     384                 :            : }
     385                 :            : #endif
     386                 :            : 
     387                 :            : #ifndef WIN32
     388                 :          0 : static void registerSignalHandler(int signal, void(*handler)(int))
     389                 :            : {
     390                 :            :     struct sigaction sa;
     391                 :          0 :     sa.sa_handler = handler;
     392                 :          0 :     sigemptyset(&sa.sa_mask);
     393                 :          0 :     sa.sa_flags = 0;
     394                 :          0 :     sigaction(signal, &sa, nullptr);
     395                 :          0 : }
     396                 :            : #endif
     397                 :            : 
     398                 :          2 : static boost::signals2::connection rpc_notify_block_change_connection;
     399                 :          0 : static void OnRPCStarted()
     400                 :            : {
     401 [ #  # ][ #  # ]:          0 :     rpc_notify_block_change_connection = uiInterface.NotifyBlockTip_connect(std::bind(RPCNotifyBlockChange, std::placeholders::_2));
     402                 :          0 : }
     403                 :            : 
     404                 :          0 : static void OnRPCStopped()
     405                 :            : {
     406                 :          0 :     rpc_notify_block_change_connection.disconnect();
     407                 :          0 :     RPCNotifyBlockChange(nullptr);
     408                 :          0 :     g_best_block_cv.notify_all();
     409 [ #  # ][ #  # ]:          0 :     LogPrint(BCLog::RPC, "RPC stopped.\n");
         [ #  # ][ #  # ]
     410                 :          0 : }
     411                 :            : 
     412                 :          1 : void SetupServerArgs(ArgsManager& argsman)
     413                 :            : {
     414                 :          1 :     SetupHelpOptions(argsman);
     415 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-help-debug", "Print help message with debugging options and exit", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST); // server-only for now
                 [ +  - ]
     416                 :            : 
     417                 :          1 :     init::AddLoggingArgs(argsman);
     418                 :            : 
     419                 :          1 :     const auto defaultBaseParams = CreateBaseChainParams(ChainType::MAIN);
     420         [ +  - ]:          1 :     const auto testnetBaseParams = CreateBaseChainParams(ChainType::TESTNET);
     421         [ +  - ]:          1 :     const auto signetBaseParams = CreateBaseChainParams(ChainType::SIGNET);
     422         [ +  - ]:          1 :     const auto regtestBaseParams = CreateBaseChainParams(ChainType::REGTEST);
     423         [ +  - ]:          1 :     const auto defaultChainParams = CreateChainParams(argsman, ChainType::MAIN);
     424         [ +  - ]:          1 :     const auto testnetChainParams = CreateChainParams(argsman, ChainType::TESTNET);
     425         [ +  - ]:          1 :     const auto signetChainParams = CreateChainParams(argsman, ChainType::SIGNET);
     426         [ +  - ]:          1 :     const auto regtestChainParams = CreateChainParams(argsman, ChainType::REGTEST);
     427                 :            : 
     428                 :            :     // Hidden Options
     429 [ +  - ][ #  # ]:          1 :     std::vector<std::string> hidden_args = {
     430 [ +  - ][ +  - ]:          1 :         "-dbcrashratio", "-forcecompactdb",
     431                 :            :         // GUI args. These will be overwritten by SetupUIArgs for the GUI
     432 [ +  - ][ +  - ]:          1 :         "-choosedatadir", "-lang=<lang>", "-min", "-resetguisettings", "-splash", "-uiplatform"};
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
     433                 :            : 
     434 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-version", "Print version and exit", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     435                 :            : #if HAVE_SYSTEM
     436 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-alertnotify=<cmd>", "Execute command when an alert is raised (%s in cmd is replaced by message)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     437                 :            : #endif
     438 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-assumevalid=<hex>", strprintf("If this block is in the chain assume that it and its ancestors are valid and potentially skip their script verification (0 to verify all, default: %s, testnet: %s, signet: %s)", defaultChainParams->GetConsensus().defaultAssumeValid.GetHex(), testnetChainParams->GetConsensus().defaultAssumeValid.GetHex(), signetChainParams->GetConsensus().defaultAssumeValid.GetHex()), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
                 [ +  - ]
     439 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blocksdir=<dir>", "Specify directory to hold blocks subdirectory for *.dat files (default: <datadir>)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     440 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-fastprune", "Use smaller block files and lower minimum prune height for testing purposes", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     441                 :            : #if HAVE_SYSTEM
     442 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blocknotify=<cmd>", "Execute command when the best block changes (%s in cmd is replaced by block hash)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     443                 :            : #endif
     444 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blockreconstructionextratxn=<n>", strprintf("Extra transactions to keep in memory for compact block reconstructions (default: %u)", DEFAULT_BLOCK_RECONSTRUCTION_EXTRA_TXN), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     445 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blocksonly", strprintf("Whether to reject transactions from network peers. Automatic broadcast and rebroadcast of any transactions from inbound peers is disabled, unless the peer has the 'forcerelay' permission. RPC transactions are not affected. (default: %u)", DEFAULT_BLOCKSONLY), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     446 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-coinstatsindex", strprintf("Maintain coinstats index used by the gettxoutsetinfo RPC (default: %u)", DEFAULT_COINSTATSINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     447 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-conf=<file>", strprintf("Specify path to read-only configuration file. Relative paths will be prefixed by datadir location (only useable from command line, not configuration file) (default: %s)", BITCOIN_CONF_FILENAME), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     448 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-datadir=<dir>", "Specify data directory", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     449 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-dbbatchsize", strprintf("Maximum database write batch size in bytes (default: %u)", nDefaultDbBatchSize), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::OPTIONS);
                 [ +  - ]
     450 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-dbcache=<n>", strprintf("Maximum database cache size <n> MiB (%d to %d, default: %d). In addition, unused mempool memory is shared for this cache (see -maxmempool).", nMinDbCache, nMaxDbCache, nDefaultDbCache), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     451 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-includeconf=<file>", "Specify additional configuration file, relative to the -datadir path (only useable from configuration file, not command line)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     452 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-allowignoredconf", strprintf("For backwards compatibility, treat an unused %s file in the datadir as a warning, not an error.", BITCOIN_CONF_FILENAME), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     453 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-loadblock=<file>", "Imports blocks from external file on startup", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     454 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxmempool=<n>", strprintf("Keep the transaction memory pool below <n> megabytes (default: %u)", DEFAULT_MAX_MEMPOOL_SIZE_MB), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     455 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxorphantx=<n>", strprintf("Keep at most <n> unconnectable transactions in memory (default: %u)", DEFAULT_MAX_ORPHAN_TRANSACTIONS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     456 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-mempoolexpiry=<n>", strprintf("Do not keep transactions in the mempool longer than <n> hours (default: %u)", DEFAULT_MEMPOOL_EXPIRY_HOURS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     457 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-minimumchainwork=<hex>", strprintf("Minimum work assumed to exist on a valid chain in hex (default: %s, testnet: %s, signet: %s)", defaultChainParams->GetConsensus().nMinimumChainWork.GetHex(), testnetChainParams->GetConsensus().nMinimumChainWork.GetHex(), signetChainParams->GetConsensus().nMinimumChainWork.GetHex()), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::OPTIONS);
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
                 [ +  - ]
     458 [ +  - ][ +  - ]:          2 :     argsman.AddArg("-par=<n>", strprintf("Set the number of script verification threads (%u to %d, 0 = auto, <0 = leave that many cores free, default: %d)",
                 [ +  - ]
     459         [ +  - ]:          1 :         -GetNumCores(), MAX_SCRIPTCHECK_THREADS, DEFAULT_SCRIPTCHECK_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
     460 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-persistmempool", strprintf("Whether to save the mempool on shutdown and load on restart (default: %u)", DEFAULT_PERSIST_MEMPOOL), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     461 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-pid=<file>", strprintf("Specify pid file. Relative paths will be prefixed by a net-specific datadir location. (default: %s)", BITCOIN_PID_FILENAME), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     462 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-prune=<n>", strprintf("Reduce storage requirements by enabling pruning (deleting) of old blocks. This allows the pruneblockchain RPC to be called to delete specific blocks and enables automatic pruning of old blocks if a target size in MiB is provided. This mode is incompatible with -txindex. "
                 [ +  - ]
     463                 :            :             "Warning: Reverting this setting requires re-downloading the entire blockchain. "
     464                 :          1 :             "(default: 0 = disable pruning blocks, 1 = allow manual pruning via RPC, >=%u = automatically prune block files to stay under the specified target size in MiB)", MIN_DISK_SPACE_FOR_BLOCK_FILES / 1024 / 1024), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
     465 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-reindex", "If enabled, wipe chain state and block index, and rebuild them from blk*.dat files on disk. Also wipe and rebuild other optional indexes that are active. If an assumeutxo snapshot was loaded, its chainstate will be wiped as well. The snapshot can then be reloaded via RPC.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     466 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-reindex-chainstate", "If enabled, wipe chain state, and rebuild it from blk*.dat files on disk. If an assumeutxo snapshot was loaded, its chainstate will be wiped as well. The snapshot can then be reloaded via RPC.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     467 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-settings=<file>", strprintf("Specify path to dynamic settings data file. Can be disabled with -nosettings. File is written at runtime and not meant to be edited by users (use %s instead for custom settings). Relative paths will be prefixed by datadir location. (default: %s)", BITCOIN_CONF_FILENAME, BITCOIN_SETTINGS_FILENAME), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     468                 :            : #if HAVE_SYSTEM
     469 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-startupnotify=<cmd>", "Execute command on startup.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     470 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-shutdownnotify=<cmd>", "Execute command immediately before beginning shutdown. The need for shutdown may be urgent, so be careful not to delay it long (if the command doesn't require interaction with the server, consider having it fork into the background).", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     471                 :            : #endif
     472 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-txindex", strprintf("Maintain a full transaction index, used by the getrawtransaction rpc call (default: %u)", DEFAULT_TXINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     473 [ +  - ][ +  - ]:          2 :     argsman.AddArg("-blockfilterindex=<type>",
     474 [ +  - ][ +  - ]:          1 :                  strprintf("Maintain an index of compact filters by block (default: %s, values: %s).", DEFAULT_BLOCKFILTERINDEX, ListBlockFilterTypes()) +
                 [ +  - ]
     475                 :            :                  " If <type> is not supplied or if <type> = 1, indexes for all known types are enabled.",
     476                 :          1 :                  ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
     477                 :            : 
     478 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-addnode=<ip>", strprintf("Add a node to connect to and attempt to keep the connection open (see the addnode RPC help for more info). This option can be specified multiple times to add multiple nodes; connections are limited to %u at a time and are counted separately from the -maxconnections limit.", MAX_ADDNODE_CONNECTIONS), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::CONNECTION);
                 [ +  - ]
     479 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-asmap=<file>", strprintf("Specify asn mapping used for bucketing of the peers (default: %s). Relative paths will be prefixed by the net-specific datadir location.", DEFAULT_ASMAP_FILENAME), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     480 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-bantime=<n>", strprintf("Default duration (in seconds) of manually configured bans (default: %u)", DEFAULT_MISBEHAVING_BANTIME), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     481 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-bind=<addr>[:<port>][=onion]", strprintf("Bind to given address and always listen on it (default: 0.0.0.0). Use [host]:port notation for IPv6. Append =onion to tag any incoming connections to that address and port as incoming Tor connections (default: 127.0.0.1:%u=onion, testnet: 127.0.0.1:%u=onion, signet: 127.0.0.1:%u=onion, regtest: 127.0.0.1:%u=onion)", defaultBaseParams->OnionServiceTargetPort(), testnetBaseParams->OnionServiceTargetPort(), signetBaseParams->OnionServiceTargetPort(), regtestBaseParams->OnionServiceTargetPort()), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::CONNECTION);
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
                 [ +  - ]
     482 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-cjdnsreachable", "If set, then this host is configured for CJDNS (connecting to fc00::/8 addresses would lead us to the CJDNS network, see doc/cjdns.md) (default: 0)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     483 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-connect=<ip>", "Connect only to the specified node; -noconnect disables automatic connections (the rules for this peer are the same as for -addnode). This option can be specified multiple times to connect to multiple nodes.", ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::CONNECTION);
                 [ +  - ]
     484 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-discover", "Discover own IP addresses (default: 1 when listening and no -externalip or -proxy)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     485 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-dns", strprintf("Allow DNS lookups for -addnode, -seednode and -connect (default: %u)", DEFAULT_NAME_LOOKUP), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     486 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-dnsseed", strprintf("Query for peer addresses via DNS lookup, if low on addresses (default: %u unless -connect used or -maxconnections=0)", DEFAULT_DNSSEED), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     487 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-externalip=<ip>", "Specify your own public address", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     488 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-fixedseeds", strprintf("Allow fixed seeds if DNS seeds don't provide peers (default: %u)", DEFAULT_FIXEDSEEDS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     489 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-forcednsseed", strprintf("Always query for peer addresses via DNS lookup (default: %u)", DEFAULT_FORCEDNSSEED), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     490 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-listen", strprintf("Accept connections from outside (default: %u if no -proxy, -connect or -maxconnections=0)", DEFAULT_LISTEN), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     491 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-listenonion", strprintf("Automatically create Tor onion service (default: %d)", DEFAULT_LISTEN_ONION), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     492 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxconnections=<n>", strprintf("Maintain at most <n> connections to peers (default: %u). This limit does not apply to connections manually added via -addnode or the addnode RPC, which have a separate limit of %u.", DEFAULT_MAX_PEER_CONNECTIONS, MAX_ADDNODE_CONNECTIONS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     493 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxreceivebuffer=<n>", strprintf("Maximum per-connection receive buffer, <n>*1000 bytes (default: %u)", DEFAULT_MAXRECEIVEBUFFER), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     494 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxsendbuffer=<n>", strprintf("Maximum per-connection memory usage for the send buffer, <n>*1000 bytes (default: %u)", DEFAULT_MAXSENDBUFFER), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     495 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxtimeadjustment", strprintf("Maximum allowed median peer time offset adjustment. Local perspective of time may be influenced by outbound peers forward or backward by this amount (default: %u seconds).", DEFAULT_MAX_TIME_ADJUSTMENT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     496 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxuploadtarget=<n>", strprintf("Tries to keep outbound traffic under the given target per 24h. Limit does not apply to peers with 'download' permission or blocks created within past week. 0 = no limit (default: %s). Optional suffix units [k|K|m|M|g|G|t|T] (default: M). Lowercase is 1000 base while uppercase is 1024 base", DEFAULT_MAX_UPLOAD_TARGET), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     497 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-onion=<ip:port>", "Use separate SOCKS5 proxy to reach peers via Tor onion services, set -noonion to disable (default: -proxy)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     498 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-i2psam=<ip:port>", "I2P SAM proxy to reach I2P peers and accept I2P connections (default: none)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     499 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-i2pacceptincoming", strprintf("Whether to accept inbound I2P connections (default: %i). Ignored if -i2psam is not set. Listening for inbound I2P connections is done through the SAM proxy, not by binding to a local address and port.", DEFAULT_I2P_ACCEPT_INCOMING), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     500 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-onlynet=<net>", "Make automatic outbound connections only to network <net> (" + Join(GetNetworkNames(), ", ") + "). Inbound and manual connections are not affected by this option. It can be specified multiple times to allow multiple networks.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
     501 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-v2transport", strprintf("Support v2 transport (default: %u)", DEFAULT_V2_TRANSPORT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     502 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-peerbloomfilters", strprintf("Support filtering of blocks and transaction with bloom filters (default: %u)", DEFAULT_PEERBLOOMFILTERS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     503 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-peerblockfilters", strprintf("Serve compact block filters to peers per BIP 157 (default: %u)", DEFAULT_PEERBLOCKFILTERS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     504 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-txreconciliation", strprintf("Enable transaction reconciliations per BIP 330 (default: %d)", DEFAULT_TXRECONCILIATION_ENABLE), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::CONNECTION);
                 [ +  - ]
     505                 :            :     // TODO: remove the sentence "Nodes not using ... incoming connections." once the changes from
     506                 :            :     // https://github.com/bitcoin/bitcoin/pull/23542 have become widespread.
     507 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-port=<port>", strprintf("Listen for connections on <port>. Nodes not using the default ports (default: %u, testnet: %u, signet: %u, regtest: %u) are unlikely to get incoming connections. Not relevant for I2P (see doc/i2p.md).", defaultChainParams->GetDefaultPort(), testnetChainParams->GetDefaultPort(), signetChainParams->GetDefaultPort(), regtestChainParams->GetDefaultPort()), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::CONNECTION);
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
                 [ +  - ]
     508 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-proxy=<ip:port>", "Connect through SOCKS5 proxy, set -noproxy to disable (default: disabled)", ArgsManager::ALLOW_ANY | ArgsManager::DISALLOW_ELISION, OptionsCategory::CONNECTION);
                 [ +  - ]
     509 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-proxyrandomize", strprintf("Randomize credentials for every proxy connection. This enables Tor stream isolation (default: %u)", DEFAULT_PROXYRANDOMIZE), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     510 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-seednode=<ip>", "Connect to a node to retrieve peer addresses, and disconnect. This option can be specified multiple times to connect to multiple nodes.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     511 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-networkactive", "Enable all P2P network activity (default: 1). Can be changed by the setnetworkactive RPC command", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     512 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-timeout=<n>", strprintf("Specify socket connection timeout in milliseconds. If an initial attempt to connect is unsuccessful after this amount of time, drop it (minimum: 1, default: %d)", DEFAULT_CONNECT_TIMEOUT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     513 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-peertimeout=<n>", strprintf("Specify a p2p connection timeout delay in seconds. After connecting to a peer, wait this amount of time before considering disconnection based on inactivity (minimum: 1, default: %d)", DEFAULT_PEER_CONNECT_TIMEOUT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::CONNECTION);
                 [ +  - ]
     514 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-torcontrol=<ip>:<port>", strprintf("Tor control host and port to use if onion listening enabled (default: %s). If no port is specified, the default port of %i will be used.", DEFAULT_TOR_CONTROL, DEFAULT_TOR_CONTROL_PORT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
                 [ +  - ]
     515 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-torpassword=<pass>", "Tor control port password (default: empty)", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::CONNECTION);
                 [ +  - ]
     516                 :            : #ifdef USE_UPNP
     517                 :            : #if USE_UPNP
     518                 :            :     argsman.AddArg("-upnp", "Use UPnP to map the listening port (default: 1 when listening and no -proxy)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
     519                 :            : #else
     520                 :            :     argsman.AddArg("-upnp", strprintf("Use UPnP to map the listening port (default: %u)", 0), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
     521                 :            : #endif
     522                 :            : #else
     523         [ +  - ]:          1 :     hidden_args.emplace_back("-upnp");
     524                 :            : #endif
     525                 :            : #ifdef USE_NATPMP
     526                 :            :     argsman.AddArg("-natpmp", strprintf("Use NAT-PMP to map the listening port (default: %s)", DEFAULT_NATPMP ? "1 when listening and no -proxy" : "0"), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
     527                 :            : #else
     528         [ +  - ]:          1 :     hidden_args.emplace_back("-natpmp");
     529                 :            : #endif // USE_NATPMP
     530 [ +  - ][ +  - ]:          2 :     argsman.AddArg("-whitebind=<[permissions@]addr>", "Bind to the given address and add permission flags to the peers connecting to it. "
     531 [ +  - ][ +  - ]:          1 :         "Use [host]:port notation for IPv6. Allowed permissions: " + Join(NET_PERMISSIONS_DOC, ", ") + ". "
                 [ +  - ]
     532                 :          1 :         "Specify multiple permissions separated by commas (default: download,noban,mempool,relay). Can be specified multiple times.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
     533                 :            : 
     534 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-whitelist=<[permissions@]IP address or network>", "Add permission flags to the peers connecting from the given IP address (e.g. 1.2.3.4) or "
                 [ +  - ]
     535                 :            :         "CIDR-notated network (e.g. 1.2.3.0/24). Uses the same permissions as "
     536                 :          1 :         "-whitebind. Can be specified multiple times." , ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
     537                 :            : 
     538         [ +  - ]:          1 :     g_wallet_init_interface.AddWalletOptions(argsman);
     539                 :            : 
     540                 :            : #if ENABLE_ZMQ
     541                 :            :     argsman.AddArg("-zmqpubhashblock=<address>", "Enable publish hash block in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     542                 :            :     argsman.AddArg("-zmqpubhashtx=<address>", "Enable publish hash transaction in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     543                 :            :     argsman.AddArg("-zmqpubrawblock=<address>", "Enable publish raw block in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     544                 :            :     argsman.AddArg("-zmqpubrawtx=<address>", "Enable publish raw transaction in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     545                 :            :     argsman.AddArg("-zmqpubsequence=<address>", "Enable publish hash block and tx sequence in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     546                 :            :     argsman.AddArg("-zmqpubhashblockhwm=<n>", strprintf("Set publish hash block outbound message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     547                 :            :     argsman.AddArg("-zmqpubhashtxhwm=<n>", strprintf("Set publish hash transaction outbound message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     548                 :            :     argsman.AddArg("-zmqpubrawblockhwm=<n>", strprintf("Set publish raw block outbound message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     549                 :            :     argsman.AddArg("-zmqpubrawtxhwm=<n>", strprintf("Set publish raw transaction outbound message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     550                 :            :     argsman.AddArg("-zmqpubsequencehwm=<n>", strprintf("Set publish hash sequence message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
     551                 :            : #else
     552         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubhashblock=<address>");
     553         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubhashtx=<address>");
     554         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubrawblock=<address>");
     555         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubrawtx=<address>");
     556         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubsequence=<n>");
     557         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubhashblockhwm=<n>");
     558         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubhashtxhwm=<n>");
     559         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubrawblockhwm=<n>");
     560         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubrawtxhwm=<n>");
     561         [ +  - ]:          1 :     hidden_args.emplace_back("-zmqpubsequencehwm=<n>");
     562                 :            : #endif
     563                 :            : 
     564 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-checkblocks=<n>", strprintf("How many blocks to check at startup (default: %u, 0 = all)", DEFAULT_CHECKBLOCKS), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     565 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-checklevel=<n>", strprintf("How thorough the block verification of -checkblocks is: %s (0-4, default: %u)", Join(CHECKLEVEL_DOC, ", "), DEFAULT_CHECKLEVEL), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
     566 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-checkblockindex", strprintf("Do a consistency check for the block tree, chainstate, and other validation data structures occasionally. (default: %u, regtest: %u)", defaultChainParams->DefaultConsistencyChecks(), regtestChainParams->DefaultConsistencyChecks()), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
                 [ +  - ]
     567 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-checkaddrman=<n>", strprintf("Run addrman consistency checks every <n> operations. Use 0 to disable. (default: %u)", DEFAULT_ADDRMAN_CONSISTENCY_CHECKS), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     568 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-checkmempool=<n>", strprintf("Run mempool consistency checks every <n> transactions. Use 0 to disable. (default: %u, regtest: %u)", defaultChainParams->DefaultConsistencyChecks(), regtestChainParams->DefaultConsistencyChecks()), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
                 [ +  - ]
     569 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-checkpoints", strprintf("Enable rejection of any forks from the known historical chain until block %s (default: %u)", defaultChainParams->Checkpoints().GetHeight(), DEFAULT_CHECKPOINTS_ENABLED), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
                 [ +  - ]
     570 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-deprecatedrpc=<method>", "Allows deprecated RPC method(s) to be used", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     571 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-stopafterblockimport", strprintf("Stop running after importing blocks from disk (default: %u)", DEFAULT_STOPAFTERBLOCKIMPORT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     572 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-stopatheight", strprintf("Stop running after reaching the given height in the main chain (default: %u)", DEFAULT_STOPATHEIGHT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     573 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-limitancestorcount=<n>", strprintf("Do not accept transactions if number of in-mempool ancestors is <n> or more (default: %u)", DEFAULT_ANCESTOR_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     574 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-limitancestorsize=<n>", strprintf("Do not accept transactions whose size with all in-mempool ancestors exceeds <n> kilobytes (default: %u)", DEFAULT_ANCESTOR_SIZE_LIMIT_KVB), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     575 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-limitdescendantcount=<n>", strprintf("Do not accept transactions if any ancestor would have <n> or more in-mempool descendants (default: %u)", DEFAULT_DESCENDANT_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     576 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-limitdescendantsize=<n>", strprintf("Do not accept transactions if any ancestor would have more than <n> kilobytes of in-mempool descendants (default: %u).", DEFAULT_DESCENDANT_SIZE_LIMIT_KVB), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     577 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-addrmantest", "Allows to test address relay on localhost", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     578 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-capturemessages", "Capture all P2P messages to disk", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     579 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-mocktime=<n>", "Replace actual time with " + UNIX_EPOCH_TIME + " (default: 0)", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
     580 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-maxsigcachesize=<n>", strprintf("Limit sum of signature cache and script execution cache sizes to <n> MiB (default: %u)", DEFAULT_MAX_SIG_CACHE_BYTES >> 20), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     581 [ +  - ][ +  - ]:          2 :     argsman.AddArg("-maxtipage=<n>",
     582         [ +  - ]:          1 :                    strprintf("Maximum tip age in seconds to consider node in initial block download (default: %u)",
     583         [ +  - ]:          1 :                              Ticks<std::chrono::seconds>(DEFAULT_MAX_TIP_AGE)),
     584                 :          1 :                    ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
     585 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-printpriority", strprintf("Log transaction fee rate in " + CURRENCY_UNIT + "/kvB when mining blocks (default: %u)", DEFAULT_PRINTPRIORITY), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
                 [ +  - ]
     586 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-uacomment=<cmt>", "Append comment to the user agent string", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST);
                 [ +  - ]
     587                 :            : 
     588         [ +  - ]:          1 :     SetupChainParamsBaseOptions(argsman);
     589                 :            : 
     590 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-acceptnonstdtxn", strprintf("Relay and mine \"non-standard\" transactions (test networks only; default: %u)", DEFAULT_ACCEPT_NON_STD_TXN), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::NODE_RELAY);
                 [ +  - ]
     591 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-incrementalrelayfee=<amt>", strprintf("Fee rate (in %s/kvB) used to define cost of relay, used for mempool limiting and replacement policy. (default: %s)", CURRENCY_UNIT, FormatMoney(DEFAULT_INCREMENTAL_RELAY_FEE)), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::NODE_RELAY);
         [ +  - ][ +  - ]
     592 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-dustrelayfee=<amt>", strprintf("Fee rate (in %s/kvB) used to define dust, the value of an output such that it will cost more than its value in fees at this fee rate to spend it. (default: %s)", CURRENCY_UNIT, FormatMoney(DUST_RELAY_TX_FEE)), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::NODE_RELAY);
         [ +  - ][ +  - ]
     593 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-acceptstalefeeestimates", strprintf("Read fee estimates even if they are stale (%sdefault: %u) fee estimates are considered stale if they are %s hours old", "regtest only; ", DEFAULT_ACCEPT_STALE_FEE_ESTIMATES, Ticks<std::chrono::hours>(MAX_FILE_AGE)), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
         [ +  - ][ +  - ]
     594 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-bytespersigop", strprintf("Equivalent bytes per sigop in transactions for relay and mining (default: %u)", DEFAULT_BYTES_PER_SIGOP), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
                 [ +  - ]
     595 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-datacarrier", strprintf("Relay and mine data carrier transactions (default: %u)", DEFAULT_ACCEPT_DATACARRIER), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
                 [ +  - ]
     596 [ +  - ][ +  - ]:          2 :     argsman.AddArg("-datacarriersize",
     597         [ +  - ]:          1 :                    strprintf("Relay and mine transactions whose data-carrying raw scriptPubKey "
     598                 :            :                              "is of this size or less (default: %u)",
     599                 :            :                              MAX_OP_RETURN_RELAY),
     600                 :          1 :                    ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
     601 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-mempoolfullrbf", strprintf("Accept transaction replace-by-fee without requiring replaceability signaling (default: %u)", DEFAULT_MEMPOOL_FULL_RBF), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
                 [ +  - ]
     602 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-permitbaremultisig", strprintf("Relay non-P2SH multisig (default: %u)", DEFAULT_PERMIT_BAREMULTISIG), ArgsManager::ALLOW_ANY,
                 [ +  - ]
     603                 :          1 :                    OptionsCategory::NODE_RELAY);
     604 [ +  - ][ +  - ]:          2 :     argsman.AddArg("-minrelaytxfee=<amt>", strprintf("Fees (in %s/kvB) smaller than this are considered zero fee for relaying, mining and transaction creation (default: %s)",
                 [ +  - ]
     605         [ +  - ]:          2 :         CURRENCY_UNIT, FormatMoney(DEFAULT_MIN_RELAY_TX_FEE)), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
     606 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-whitelistforcerelay", strprintf("Add 'forcerelay' permission to whitelisted inbound peers with default permissions. This will relay transactions even if the transactions were already in the mempool. (default: %d)", DEFAULT_WHITELISTFORCERELAY), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
                 [ +  - ]
     607 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-whitelistrelay", strprintf("Add 'relay' permission to whitelisted inbound peers with default permissions. This will accept relayed transactions even when not relaying transactions (default: %d)", DEFAULT_WHITELISTRELAY), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
                 [ +  - ]
     608                 :            : 
     609                 :            : 
     610 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blockmaxweight=<n>", strprintf("Set maximum BIP141 block weight (default: %d)", DEFAULT_BLOCK_MAX_WEIGHT), ArgsManager::ALLOW_ANY, OptionsCategory::BLOCK_CREATION);
                 [ +  - ]
     611 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blockmintxfee=<amt>", strprintf("Set lowest fee rate (in %s/kvB) for transactions to be included in block creation. (default: %s)", CURRENCY_UNIT, FormatMoney(DEFAULT_BLOCK_MIN_TX_FEE)), ArgsManager::ALLOW_ANY, OptionsCategory::BLOCK_CREATION);
         [ +  - ][ +  - ]
     612 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-blockversion=<n>", "Override block version to test forking scenarios", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::BLOCK_CREATION);
                 [ +  - ]
     613                 :            : 
     614 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rest", strprintf("Accept public REST requests (default: %u)", DEFAULT_REST_ENABLE), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     615 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcallowip=<ip>", "Allow JSON-RPC connections from specified source. Valid values for <ip> are a single IP (e.g. 1.2.3.4), a network/netmask (e.g. 1.2.3.4/255.255.255.0), a network/CIDR (e.g. 1.2.3.4/24), all ipv4 (0.0.0.0/0), or all ipv6 (::/0). This option can be specified multiple times", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     616 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcauth=<userpw>", "Username and HMAC-SHA-256 hashed password for JSON-RPC connections. The field <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. A canonical python script is included in share/rpcauth. The client then connects normally using the rpcuser=<USERNAME>/rpcpassword=<PASSWORD> pair of arguments. This option can be specified multiple times", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);
                 [ +  - ]
     617 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcbind=<addr>[:port]", "Bind to given address to listen for JSON-RPC connections. Do not expose the RPC server to untrusted networks such as the public internet! This option is ignored unless -rpcallowip is also passed. Port is optional and overrides -rpcport. Use [host]:port notation for IPv6. This option can be specified multiple times (default: 127.0.0.1 and ::1 i.e., localhost)", ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::RPC);
                 [ +  - ]
     618 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcdoccheck", strprintf("Throw a non-fatal error at runtime if the documentation for an RPC is incorrect (default: %u)", DEFAULT_RPC_DOC_CHECK), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::RPC);
                 [ +  - ]
     619 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpccookiefile=<loc>", "Location of the auth cookie. Relative paths will be prefixed by a net-specific datadir location. (default: data dir)", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     620 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcpassword=<pw>", "Password for JSON-RPC connections", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);
                 [ +  - ]
     621 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcport=<port>", strprintf("Listen for JSON-RPC connections on <port> (default: %u, testnet: %u, signet: %u, regtest: %u)", defaultBaseParams->RPCPort(), testnetBaseParams->RPCPort(), signetBaseParams->RPCPort(), regtestBaseParams->RPCPort()), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::RPC);
         [ +  - ][ +  - ]
         [ +  - ][ +  - ]
                 [ +  - ]
     622 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcserialversion", strprintf("Sets the serialization of raw transaction or block hex returned in non-verbose mode, non-segwit(0) (DEPRECATED) or segwit(1) (default: %d)", DEFAULT_RPC_SERIALIZE_VERSION), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     623 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcservertimeout=<n>", strprintf("Timeout during HTTP requests (default: %d)", DEFAULT_HTTP_SERVER_TIMEOUT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::RPC);
                 [ +  - ]
     624 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcthreads=<n>", strprintf("Set the number of threads to service RPC calls (default: %d)", DEFAULT_HTTP_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     625 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcuser=<user>", "Username for JSON-RPC connections", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);
                 [ +  - ]
     626 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcwhitelist=<whitelist>", "Set a whitelist to filter incoming RPC calls for a specific user. The field <whitelist> comes in the format: <USERNAME>:<rpc 1>,<rpc 2>,...,<rpc n>. If multiple whitelists are set for a given user, they are set-intersected. See -rpcwhitelistdefault documentation for information on default whitelist behavior.", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     627 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcwhitelistdefault", "Sets default behavior for rpc whitelisting. Unless rpcwhitelistdefault is set to 0, if any -rpcwhitelist is set, the rpc server acts as if all rpc users are subject to empty-unless-otherwise-specified whitelists. If rpcwhitelistdefault is set to 1 and no -rpcwhitelist is set, rpc server acts as if all rpc users are subject to empty whitelists.", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     628 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-rpcworkqueue=<n>", strprintf("Set the depth of the work queue to service RPC calls (default: %d)", DEFAULT_HTTP_WORKQUEUE), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::RPC);
                 [ +  - ]
     629 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-server", "Accept command line and JSON-RPC commands", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
                 [ +  - ]
     630                 :            : 
     631                 :            : #if HAVE_DECL_FORK
     632 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-daemon", strprintf("Run in the background as a daemon and accept commands (default: %d)", DEFAULT_DAEMON), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     633 [ +  - ][ +  - ]:          1 :     argsman.AddArg("-daemonwait", strprintf("Wait for initialization to be finished before exiting. This implies -daemon (default: %d)", DEFAULT_DAEMONWAIT), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
                 [ +  - ]
     634                 :            : #else
     635                 :            :     hidden_args.emplace_back("-daemon");
     636                 :            :     hidden_args.emplace_back("-daemonwait");
     637                 :            : #endif
     638                 :            : 
     639                 :            :     // Add the hidden options
     640         [ +  - ]:          1 :     argsman.AddHiddenArgs(hidden_args);
     641                 :          1 : }
     642                 :            : 
     643                 :            : static bool fHaveGenesis = false;
     644                 :            : static GlobalMutex g_genesis_wait_mutex;
     645                 :          2 : static std::condition_variable g_genesis_wait_cv;
     646                 :            : 
     647                 :          0 : static void BlockNotifyGenesisWait(const CBlockIndex* pBlockIndex)
     648                 :            : {
     649         [ #  # ]:          0 :     if (pBlockIndex != nullptr) {
     650                 :            :         {
     651                 :          0 :             LOCK(g_genesis_wait_mutex);
     652                 :          0 :             fHaveGenesis = true;
     653                 :          0 :         }
     654                 :          0 :         g_genesis_wait_cv.notify_all();
     655                 :          0 :     }
     656                 :          0 : }
     657                 :            : 
     658                 :            : #if HAVE_SYSTEM
     659                 :          0 : static void StartupNotify(const ArgsManager& args)
     660                 :            : {
     661 [ #  # ][ #  # ]:          0 :     std::string cmd = args.GetArg("-startupnotify", "");
                 [ #  # ]
     662         [ #  # ]:          0 :     if (!cmd.empty()) {
     663         [ #  # ]:          0 :         std::thread t(runCommand, cmd);
     664         [ #  # ]:          0 :         t.detach(); // thread runs free
     665                 :          0 :     }
     666                 :          0 : }
     667                 :            : #endif
     668                 :            : 
     669                 :          0 : static bool AppInitServers(NodeContext& node)
     670                 :            : {
     671                 :          0 :     const ArgsManager& args = *Assert(node.args);
     672         [ #  # ]:          0 :     RPCServer::OnStarted(&OnRPCStarted);
     673         [ #  # ]:          0 :     RPCServer::OnStopped(&OnRPCStopped);
     674         [ #  # ]:          0 :     if (!InitHTTPServer())
     675                 :          0 :         return false;
     676                 :          0 :     StartRPC();
     677                 :          0 :     node.rpc_interruption_point = RpcInterruptionPoint;
     678 [ #  # ][ #  # ]:          0 :     if (!StartHTTPRPC(&node))
     679                 :          0 :         return false;
     680 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-rest", DEFAULT_REST_ENABLE)) StartREST(&node);
         [ #  # ][ #  # ]
     681                 :          0 :     StartHTTPServer();
     682                 :          0 :     return true;
     683                 :          0 : }
     684                 :            : 
     685                 :            : // Parameter interaction based on rules
     686                 :          0 : void InitParameterInteraction(ArgsManager& args)
     687                 :            : {
     688                 :            :     // when specifying an explicit binding address, you want to listen on it
     689                 :            :     // even when -connect or -proxy is specified
     690 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-bind")) {
                 [ #  # ]
     691 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-listen", true))
                 [ #  # ]
     692 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -bind set -> setting -listen=1\n", __func__);
                 [ #  # ]
     693                 :          0 :     }
     694 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-whitebind")) {
                 [ #  # ]
     695 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-listen", true))
                 [ #  # ]
     696 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -whitebind set -> setting -listen=1\n", __func__);
                 [ #  # ]
     697                 :          0 :     }
     698                 :            : 
     699 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-connect") || args.GetIntArg("-maxconnections", DEFAULT_MAX_PEER_CONNECTIONS) <= 0) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     700                 :            :         // when only connecting to trusted nodes, do not seed via DNS, or listen by default
     701 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-dnsseed", false))
                 [ #  # ]
     702 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -connect or -maxconnections=0 set -> setting -dnsseed=0\n", __func__);
                 [ #  # ]
     703 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-listen", false))
                 [ #  # ]
     704 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -connect or -maxconnections=0 set -> setting -listen=0\n", __func__);
                 [ #  # ]
     705                 :          0 :     }
     706                 :            : 
     707 [ #  # ][ #  # ]:          0 :     std::string proxy_arg = args.GetArg("-proxy", "");
                 [ #  # ]
     708 [ #  # ][ #  # ]:          0 :     if (proxy_arg != "" && proxy_arg != "0") {
         [ #  # ][ #  # ]
     709                 :            :         // to protect privacy, do not listen by default if a default proxy server is specified
     710 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-listen", false))
                 [ #  # ]
     711 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -proxy set -> setting -listen=0\n", __func__);
                 [ #  # ]
     712                 :            :         // to protect privacy, do not map ports when a proxy is set. The user may still specify -listen=1
     713                 :            :         // to listen locally, so don't rely on this happening through -listen below.
     714 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-upnp", false))
                 [ #  # ]
     715 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -proxy set -> setting -upnp=0\n", __func__);
                 [ #  # ]
     716 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-natpmp", false)) {
                 [ #  # ]
     717 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -proxy set -> setting -natpmp=0\n", __func__);
                 [ #  # ]
     718                 :          0 :         }
     719                 :            :         // to protect privacy, do not discover addresses by default
     720 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-discover", false))
                 [ #  # ]
     721 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -proxy set -> setting -discover=0\n", __func__);
                 [ #  # ]
     722                 :          0 :     }
     723                 :            : 
     724 [ #  # ][ #  # ]:          0 :     if (!args.GetBoolArg("-listen", DEFAULT_LISTEN)) {
                 [ #  # ]
     725                 :            :         // do not map ports or try to retrieve public IP when not listening (pointless)
     726 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-upnp", false))
                 [ #  # ]
     727 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -listen=0 -> setting -upnp=0\n", __func__);
                 [ #  # ]
     728 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-natpmp", false)) {
                 [ #  # ]
     729 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -listen=0 -> setting -natpmp=0\n", __func__);
                 [ #  # ]
     730                 :          0 :         }
     731 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-discover", false))
                 [ #  # ]
     732 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -listen=0 -> setting -discover=0\n", __func__);
                 [ #  # ]
     733 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-listenonion", false))
                 [ #  # ]
     734 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -listen=0 -> setting -listenonion=0\n", __func__);
                 [ #  # ]
     735 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-i2pacceptincoming", false)) {
                 [ #  # ]
     736 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -listen=0 -> setting -i2pacceptincoming=0\n", __func__);
                 [ #  # ]
     737                 :          0 :         }
     738                 :          0 :     }
     739                 :            : 
     740 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-externalip")) {
                 [ #  # ]
     741                 :            :         // if an explicit public IP is specified, do not try to find others
     742 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-discover", false))
                 [ #  # ]
     743 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -externalip set -> setting -discover=0\n", __func__);
                 [ #  # ]
     744                 :          0 :     }
     745                 :            : 
     746 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-blocksonly", DEFAULT_BLOCKSONLY)) {
                 [ #  # ]
     747                 :            :         // disable whitelistrelay in blocksonly mode
     748 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-whitelistrelay", false))
                 [ #  # ]
     749 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -blocksonly=1 -> setting -whitelistrelay=0\n", __func__);
                 [ #  # ]
     750                 :            :         // Reduce default mempool size in blocksonly mode to avoid unexpected resource usage
     751 [ #  # ][ #  # ]:          0 :         if (args.SoftSetArg("-maxmempool", ToString(DEFAULT_BLOCKSONLY_MAX_MEMPOOL_SIZE_MB)))
         [ #  # ][ #  # ]
     752 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -blocksonly=1 -> setting -maxmempool=%d\n", __func__, DEFAULT_BLOCKSONLY_MAX_MEMPOOL_SIZE_MB);
                 [ #  # ]
     753                 :          0 :     }
     754                 :            : 
     755                 :            :     // Forcing relay from whitelisted hosts implies we will accept relays from them in the first place.
     756 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-whitelistforcerelay", DEFAULT_WHITELISTFORCERELAY)) {
                 [ #  # ]
     757 [ #  # ][ #  # ]:          0 :         if (args.SoftSetBoolArg("-whitelistrelay", true))
                 [ #  # ]
     758 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -whitelistforcerelay=1 -> setting -whitelistrelay=1\n", __func__);
                 [ #  # ]
     759                 :          0 :     }
     760 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-onlynet")) {
                 [ #  # ]
     761 [ #  # ][ #  # ]:          0 :         const auto onlynets = args.GetArgs("-onlynet");
     762         [ #  # ]:          0 :         bool clearnet_reachable = std::any_of(onlynets.begin(), onlynets.end(), [](const auto& net) {
     763                 :          0 :             const auto n = ParseNetwork(net);
     764         [ #  # ]:          0 :             return n == NET_IPV4 || n == NET_IPV6;
     765                 :            :         });
     766 [ #  # ][ #  # ]:          0 :         if (!clearnet_reachable && args.SoftSetBoolArg("-dnsseed", false)) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     767 [ #  # ][ #  # ]:          0 :             LogPrintf("%s: parameter interaction: -onlynet excludes IPv4 and IPv6 -> setting -dnsseed=0\n", __func__);
                 [ #  # ]
     768                 :          0 :         }
     769                 :          0 :     }
     770                 :          0 : }
     771                 :            : 
     772                 :            : /**
     773                 :            :  * Initialize global loggers.
     774                 :            :  *
     775                 :            :  * Note that this is called very early in the process lifetime, so you should be
     776                 :            :  * careful about what global state you rely on here.
     777                 :            :  */
     778                 :          1 : void InitLogging(const ArgsManager& args)
     779                 :            : {
     780                 :          1 :     init::SetLoggingOptions(args);
     781                 :          1 :     init::LogPackageVersion();
     782                 :          1 : }
     783                 :            : 
     784                 :            : namespace { // Variables internal to initialization process only
     785                 :            : 
     786                 :            : int nMaxConnections;
     787                 :            : int nUserMaxConnections;
     788                 :            : int nFD;
     789                 :            : ServiceFlags nLocalServices = ServiceFlags(NODE_NETWORK_LIMITED | NODE_WITNESS);
     790                 :            : int64_t peer_connect_timeout;
     791                 :          2 : std::set<BlockFilterType> g_enabled_filter_types;
     792                 :            : 
     793                 :            : } // namespace
     794                 :            : 
     795                 :          0 : [[noreturn]] static void new_handler_terminate()
     796                 :            : {
     797                 :            :     // Rather than throwing std::bad-alloc if allocation fails, terminate
     798                 :            :     // immediately to (try to) avoid chain corruption.
     799                 :            :     // Since LogPrintf may itself allocate memory, set the handler directly
     800                 :            :     // to terminate first.
     801                 :          0 :     std::set_new_handler(std::terminate);
     802 [ #  # ][ #  # ]:          0 :     LogPrintf("Error: Out of memory. Terminating.\n");
                 [ #  # ]
     803                 :            : 
     804                 :            :     // The log was successful, terminate now.
     805                 :          0 :     std::terminate();
     806                 :          0 : };
     807                 :            : 
     808                 :          0 : bool AppInitBasicSetup(const ArgsManager& args, std::atomic<int>& exit_status)
     809                 :            : {
     810                 :            :     // ********************************************************* Step 1: setup
     811                 :            : #ifdef _MSC_VER
     812                 :            :     // Turn off Microsoft heap dump noise
     813                 :            :     _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
     814                 :            :     _CrtSetReportFile(_CRT_WARN, CreateFileA("NUL", GENERIC_WRITE, 0, nullptr, OPEN_EXISTING, 0, 0));
     815                 :            :     // Disable confusing "helpful" text message on abort, Ctrl-C
     816                 :            :     _set_abort_behavior(0, _WRITE_ABORT_MSG | _CALL_REPORTFAULT);
     817                 :            : #endif
     818                 :            : #ifdef WIN32
     819                 :            :     // Enable heap terminate-on-corruption
     820                 :            :     HeapSetInformation(nullptr, HeapEnableTerminationOnCorruption, nullptr, 0);
     821                 :            : #endif
     822         [ #  # ]:          0 :     if (!SetupNetworking()) {
     823 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("Initializing networking failed."));
                 [ #  # ]
     824                 :            :     }
     825                 :            : 
     826                 :            : #ifndef WIN32
     827                 :            :     // Clean shutdown on SIGTERM
     828                 :          0 :     registerSignalHandler(SIGTERM, HandleSIGTERM);
     829                 :          0 :     registerSignalHandler(SIGINT, HandleSIGTERM);
     830                 :            : 
     831                 :            :     // Reopen debug.log on SIGHUP
     832                 :          0 :     registerSignalHandler(SIGHUP, HandleSIGHUP);
     833                 :            : 
     834                 :            :     // Ignore SIGPIPE, otherwise it will bring the daemon down if the client closes unexpectedly
     835                 :          0 :     signal(SIGPIPE, SIG_IGN);
     836                 :            : #else
     837                 :            :     SetConsoleCtrlHandler(consoleCtrlHandler, true);
     838                 :            : #endif
     839                 :            : 
     840                 :          0 :     std::set_new_handler(new_handler_terminate);
     841                 :            : 
     842                 :          0 :     return true;
     843                 :          0 : }
     844                 :            : 
     845                 :          1 : bool AppInitParameterInteraction(const ArgsManager& args)
     846                 :            : {
     847                 :          1 :     const CChainParams& chainparams = Params();
     848                 :            :     // ********************************************************* Step 2: parameter interactions
     849                 :            : 
     850                 :            :     // also see: InitParameterInteraction()
     851                 :            : 
     852                 :            :     // Error if network-specific options (-addnode, -connect, etc) are
     853                 :            :     // specified in default section of config file, but not overridden
     854                 :            :     // on the command line or in this chain's section of the config file.
     855                 :          1 :     ChainType chain = args.GetChainType();
     856         [ +  - ]:          1 :     if (chain == ChainType::SIGNET) {
     857 [ #  # ][ #  # ]:          0 :         LogPrintf("Signet derived magic (message start): %s\n", HexStr(chainparams.MessageStart()));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     858                 :          0 :     }
     859                 :          1 :     bilingual_str errors;
     860 [ +  - ][ -  + ]:          1 :     for (const auto& arg : args.GetUnsuitableSectionOnlyArgs()) {
     861 [ #  # ][ #  # ]:          0 :         errors += strprintf(_("Config setting for %s only applied on %s network when in [%s] section.") + Untranslated("\n"), arg, ChainTypeToString(chain), ChainTypeToString(chain));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     862                 :            :     }
     863                 :            : 
     864 [ +  - ][ -  + ]:          1 :     if (!errors.empty()) {
     865         [ #  # ]:          0 :         return InitError(errors);
     866                 :            :     }
     867                 :            : 
     868                 :            :     // Warn if unrecognized section name are present in the config file.
     869                 :          1 :     bilingual_str warnings;
     870 [ +  - ][ -  + ]:          1 :     for (const auto& section : args.GetUnrecognizedSections()) {
     871 [ #  # ][ #  # ]:          0 :         warnings += strprintf(Untranslated("%s:%i ") + _("Section [%s] is not recognized.") + Untranslated("\n"), section.m_file, section.m_line, section.m_name);
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
     872                 :            :     }
     873                 :            : 
     874 [ +  - ][ -  + ]:          1 :     if (!warnings.empty()) {
     875         [ #  # ]:          0 :         InitWarning(warnings);
     876                 :          0 :     }
     877                 :            : 
     878 [ +  - ][ +  - ]:          1 :     if (!fs::is_directory(args.GetBlocksDirPath())) {
                 [ -  + ]
     879 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Specified blocks directory \"%s\" does not exist."), args.GetArg("-blocksdir", "")));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     880                 :            :     }
     881                 :            : 
     882                 :            :     // parse and validate enabled filter types
     883 [ +  - ][ +  - ]:          1 :     std::string blockfilterindex_value = args.GetArg("-blockfilterindex", DEFAULT_BLOCKFILTERINDEX);
                 [ +  - ]
     884 [ +  - ][ +  - ]:          1 :     if (blockfilterindex_value == "" || blockfilterindex_value == "1") {
         [ +  - ][ +  - ]
     885 [ #  # ][ #  # ]:          0 :         g_enabled_filter_types = AllBlockFilterTypes();
     886 [ +  - ][ +  - ]:          1 :     } else if (blockfilterindex_value != "0") {
     887 [ #  # ][ #  # ]:          0 :         const std::vector<std::string> names = args.GetArgs("-blockfilterindex");
     888         [ #  # ]:          0 :         for (const auto& name : names) {
     889                 :            :             BlockFilterType filter_type;
     890 [ #  # ][ #  # ]:          0 :             if (!BlockFilterTypeByName(name, filter_type)) {
     891 [ #  # ][ #  # ]:          0 :                 return InitError(strprintf(_("Unknown -blockfilterindex value %s."), name));
                 [ #  # ]
     892                 :            :             }
     893         [ #  # ]:          0 :             g_enabled_filter_types.insert(filter_type);
     894                 :            :         }
     895         [ #  # ]:          0 :     }
     896                 :            : 
     897                 :            :     // Signal NODE_P2P_V2 if BIP324 v2 transport is enabled.
     898 [ +  - ][ +  - ]:          1 :     if (args.GetBoolArg("-v2transport", DEFAULT_V2_TRANSPORT)) {
                 [ +  - ]
     899                 :          0 :         nLocalServices = ServiceFlags(nLocalServices | NODE_P2P_V2);
     900                 :          0 :     }
     901                 :            : 
     902                 :            :     // Signal NODE_COMPACT_FILTERS if peerblockfilters and basic filters index are both enabled.
     903 [ +  - ][ +  - ]:          1 :     if (args.GetBoolArg("-peerblockfilters", DEFAULT_PEERBLOCKFILTERS)) {
                 [ -  + ]
     904 [ #  # ][ #  # ]:          0 :         if (g_enabled_filter_types.count(BlockFilterType::BASIC) != 1) {
     905 [ #  # ][ #  # ]:          0 :             return InitError(_("Cannot set -peerblockfilters without -blockfilterindex."));
     906                 :            :         }
     907                 :            : 
     908                 :          0 :         nLocalServices = ServiceFlags(nLocalServices | NODE_COMPACT_FILTERS);
     909                 :          0 :     }
     910                 :            : 
     911 [ +  - ][ +  - ]:          1 :     if (args.GetIntArg("-prune", 0)) {
                 [ +  - ]
     912 [ #  # ][ #  # ]:          0 :         if (args.GetBoolArg("-txindex", DEFAULT_TXINDEX))
                 [ #  # ]
     913 [ #  # ][ #  # ]:          0 :             return InitError(_("Prune mode is incompatible with -txindex."));
     914 [ #  # ][ #  # ]:          0 :         if (args.GetBoolArg("-reindex-chainstate", false)) {
                 [ #  # ]
     915 [ #  # ][ #  # ]:          0 :             return InitError(_("Prune mode is incompatible with -reindex-chainstate. Use full -reindex instead."));
     916                 :            :         }
     917                 :          0 :     }
     918                 :            : 
     919                 :            :     // If -forcednsseed is set to true, ensure -dnsseed has not been set to false
     920 [ +  - ][ +  - ]:          1 :     if (args.GetBoolArg("-forcednsseed", DEFAULT_FORCEDNSSEED) && !args.GetBoolArg("-dnsseed", DEFAULT_DNSSEED)){
         [ +  - ][ #  # ]
         [ #  # ][ +  - ]
         [ +  - ][ -  + ]
         [ #  # ][ #  # ]
     921 [ #  # ][ #  # ]:          0 :         return InitError(_("Cannot set -forcednsseed to true when setting -dnsseed to false."));
     922                 :            :     }
     923                 :            : 
     924                 :            :     // -bind and -whitebind can't be set when not listening
     925 [ +  - ][ +  - ]:          1 :     size_t nUserBind = args.GetArgs("-bind").size() + args.GetArgs("-whitebind").size();
         [ +  - ][ +  - ]
     926 [ +  - ][ #  # ]:          1 :     if (nUserBind != 0 && !args.GetBoolArg("-listen", DEFAULT_LISTEN)) {
         [ #  # ][ +  - ]
         [ +  - ][ -  + ]
         [ #  # ][ #  # ]
     927 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("Cannot set -bind or -whitebind together with -listen=0"));
                 [ #  # ]
     928                 :            :     }
     929                 :            : 
     930                 :            :     // if listen=0, then disallow listenonion=1
     931 [ +  - ][ +  - ]:          1 :     if (!args.GetBoolArg("-listen", DEFAULT_LISTEN) && args.GetBoolArg("-listenonion", DEFAULT_LISTEN_ONION)) {
         [ +  - ][ #  # ]
         [ #  # ][ +  - ]
         [ +  - ][ +  - ]
         [ #  # ][ #  # ]
     932 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("Cannot set -listen=0 together with -listenonion=1"));
                 [ #  # ]
     933                 :            :     }
     934                 :            : 
     935                 :            :     // Make sure enough file descriptors are available
     936         [ +  - ]:          1 :     int nBind = std::max(nUserBind, size_t(1));
     937 [ +  - ][ +  - ]:          1 :     nUserMaxConnections = args.GetIntArg("-maxconnections", DEFAULT_MAX_PEER_CONNECTIONS);
     938         [ +  - ]:          1 :     nMaxConnections = std::max(nUserMaxConnections, 0);
     939                 :            : 
     940         [ +  - ]:          1 :     nFD = RaiseFileDescriptorLimit(nMaxConnections + MIN_CORE_FILEDESCRIPTORS + MAX_ADDNODE_CONNECTIONS + nBind + NUM_FDS_MESSAGE_CAPTURE);
     941                 :            : 
     942                 :            : #ifdef USE_POLL
     943                 :          1 :     int fd_max = nFD;
     944                 :            : #else
     945                 :            :     int fd_max = FD_SETSIZE;
     946                 :            : #endif
     947                 :            :     // Trim requested connection counts, to fit into system limitations
     948                 :            :     // <int> in std::min<int>(...) to work around FreeBSD compilation issue described in #2695
     949 [ +  - ][ +  - ]:          1 :     nMaxConnections = std::max(std::min<int>(nMaxConnections, fd_max - nBind - MIN_CORE_FILEDESCRIPTORS - MAX_ADDNODE_CONNECTIONS - NUM_FDS_MESSAGE_CAPTURE), 0);
     950         [ -  + ]:          1 :     if (nFD < MIN_CORE_FILEDESCRIPTORS)
     951 [ #  # ][ #  # ]:          0 :         return InitError(_("Not enough file descriptors available."));
     952         [ +  - ]:          1 :     nMaxConnections = std::min(nFD - MIN_CORE_FILEDESCRIPTORS - MAX_ADDNODE_CONNECTIONS - NUM_FDS_MESSAGE_CAPTURE, nMaxConnections);
     953                 :            : 
     954         [ -  + ]:          1 :     if (nMaxConnections < nUserMaxConnections)
     955 [ #  # ][ #  # ]:          0 :         InitWarning(strprintf(_("Reducing -maxconnections from %d to %d, because of system limitations."), nUserMaxConnections, nMaxConnections));
                 [ #  # ]
     956                 :            : 
     957                 :            :     // ********************************************************* Step 3: parameter-to-internal-flags
     958         [ +  - ]:          1 :     auto result = init::SetLoggingCategories(args);
     959 [ -  + ][ #  # ]:          1 :     if (!result) return InitError(util::ErrorString(result));
                 [ #  # ]
     960         [ +  - ]:          1 :     result = init::SetLoggingLevel(args);
     961 [ -  + ][ #  # ]:          1 :     if (!result) return InitError(util::ErrorString(result));
                 [ #  # ]
     962                 :            : 
     963 [ +  - ][ +  - ]:          1 :     nConnectTimeout = args.GetIntArg("-timeout", DEFAULT_CONNECT_TIMEOUT);
     964         [ +  - ]:          1 :     if (nConnectTimeout <= 0) {
     965                 :          0 :         nConnectTimeout = DEFAULT_CONNECT_TIMEOUT;
     966                 :          0 :     }
     967                 :            : 
     968 [ +  - ][ +  - ]:          1 :     peer_connect_timeout = args.GetIntArg("-peertimeout", DEFAULT_PEER_CONNECT_TIMEOUT);
     969         [ -  + ]:          1 :     if (peer_connect_timeout <= 0) {
     970 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("peertimeout must be a positive integer."));
                 [ #  # ]
     971                 :            :     }
     972                 :            : 
     973                 :            :     // Sanity check argument for min fee for including tx in block
     974                 :            :     // TODO: Harmonize which arguments need sanity checking and where that happens
     975 [ +  - ][ +  - ]:          1 :     if (args.IsArgSet("-blockmintxfee")) {
                 [ +  - ]
     976 [ #  # ][ #  # ]:          0 :         if (!ParseMoney(args.GetArg("-blockmintxfee", ""))) {
         [ #  # ][ #  # ]
                 [ #  # ]
     977 [ #  # ][ #  # ]:          0 :             return InitError(AmountErrMsg("blockmintxfee", args.GetArg("-blockmintxfee", "")));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     978                 :            :         }
     979                 :          0 :     }
     980                 :            : 
     981 [ +  - ][ +  - ]:          1 :     nBytesPerSigOp = args.GetIntArg("-bytespersigop", nBytesPerSigOp);
     982                 :            : 
     983 [ +  - ][ +  - ]:          1 :     if (!g_wallet_init_interface.ParameterInteraction()) return false;
     984                 :            : 
     985                 :            :     // Option to startup with mocktime set (used for regression testing):
     986 [ +  - ][ +  - ]:          1 :     SetMockTime(args.GetIntArg("-mocktime", 0)); // SetMockTime(0) is a no-op
                 [ +  - ]
     987                 :            : 
     988 [ +  - ][ +  - ]:          1 :     if (args.GetBoolArg("-peerbloomfilters", DEFAULT_PEERBLOOMFILTERS))
                 [ +  - ]
     989                 :          0 :         nLocalServices = ServiceFlags(nLocalServices | NODE_BLOOM);
     990                 :            : 
     991 [ +  - ][ +  - ]:          1 :     if (args.GetIntArg("-rpcserialversion", DEFAULT_RPC_SERIALIZE_VERSION) < 0)
                 [ +  - ]
     992 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("rpcserialversion must be non-negative."));
                 [ #  # ]
     993                 :            : 
     994 [ +  - ][ +  - ]:          1 :     if (args.GetIntArg("-rpcserialversion", DEFAULT_RPC_SERIALIZE_VERSION) > 1)
                 [ -  + ]
     995 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("Unknown rpcserialversion requested."));
                 [ #  # ]
     996                 :            : 
     997 [ +  - ][ +  - ]:          1 :     if (args.GetIntArg("-rpcserialversion", DEFAULT_RPC_SERIALIZE_VERSION) == 0 && !IsDeprecatedRPCEnabled("serialversion")) {
         [ +  - ][ #  # ]
         [ #  # ][ +  - ]
         [ +  - ][ -  + ]
         [ #  # ][ #  # ]
     998 [ #  # ][ #  # ]:          0 :         return InitError(Untranslated("-rpcserialversion=0 is deprecated and will be removed in the future. Specify -deprecatedrpc=serialversion to allow anyway."));
                 [ #  # ]
     999                 :            :     }
    1000                 :            : 
    1001                 :            :     // Also report errors from parsing before daemonization
    1002                 :            :     {
    1003                 :          1 :         kernel::Notifications notifications{};
    1004                 :          7 :         ChainstateManager::Options chainman_opts_dummy{
    1005                 :          1 :             .chainparams = chainparams,
    1006 [ +  - ][ +  - ]:          1 :             .datadir = args.GetDataDirNet(),
    1007                 :            :             .notifications = notifications,
    1008                 :            :         };
    1009         [ +  - ]:          1 :         auto chainman_result{ApplyArgsManOptions(args, chainman_opts_dummy)};
    1010         [ -  + ]:          1 :         if (!chainman_result) {
    1011 [ #  # ][ #  # ]:          0 :             return InitError(util::ErrorString(chainman_result));
    1012                 :            :         }
    1013                 :          4 :         BlockManager::Options blockman_opts_dummy{
    1014                 :          1 :             .chainparams = chainman_opts_dummy.chainparams,
    1015 [ +  - ][ +  - ]:          1 :             .blocks_dir = args.GetBlocksDirPath(),
    1016                 :          1 :             .notifications = chainman_opts_dummy.notifications,
    1017                 :            :         };
    1018         [ +  - ]:          1 :         auto blockman_result{ApplyArgsManOptions(args, blockman_opts_dummy)};
    1019         [ +  - ]:          1 :         if (!blockman_result) {
    1020 [ #  # ][ #  # ]:          0 :             return InitError(util::ErrorString(blockman_result));
    1021                 :            :         }
    1022         [ -  + ]:          1 :     }
    1023                 :            : 
    1024                 :          1 :     return true;
    1025                 :          1 : }
    1026                 :            : 
    1027                 :          0 : static bool LockDataDirectory(bool probeOnly)
    1028                 :            : {
    1029                 :            :     // Make sure only a single Bitcoin process is using the data directory.
    1030                 :          0 :     const fs::path& datadir = gArgs.GetDataDirNet();
    1031         [ #  # ]:          0 :     if (!DirIsWritable(datadir)) {
    1032 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Cannot write to data directory '%s'; check permissions."), fs::PathToString(datadir)));
                 [ #  # ]
    1033                 :            :     }
    1034 [ #  # ][ #  # ]:          0 :     if (!LockDirectory(datadir, ".lock", probeOnly)) {
    1035 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Cannot obtain a lock on data directory %s. %s is probably already running."), fs::PathToString(datadir), PACKAGE_NAME));
                 [ #  # ]
    1036                 :            :     }
    1037                 :          0 :     return true;
    1038                 :          0 : }
    1039                 :            : 
    1040                 :          0 : bool AppInitSanityChecks(const kernel::Context& kernel)
    1041                 :            : {
    1042                 :            :     // ********************************************************* Step 4: sanity checks
    1043                 :          0 :     auto result{kernel::SanityChecks(kernel)};
    1044         [ #  # ]:          0 :     if (!result) {
    1045 [ #  # ][ #  # ]:          0 :         InitError(util::ErrorString(result));
    1046 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Initialization sanity check failed. %s is shutting down."), PACKAGE_NAME));
                 [ #  # ]
    1047                 :            :     }
    1048                 :            : 
    1049                 :            :     // Probe the data directory lock to give an early error message, if possible
    1050                 :            :     // We cannot hold the data directory lock here, as the forking for daemon() hasn't yet happened,
    1051                 :            :     // and a fork will cause weird behavior to it.
    1052         [ #  # ]:          0 :     return LockDataDirectory(true);
    1053                 :          0 : }
    1054                 :            : 
    1055                 :          0 : bool AppInitLockDataDirectory()
    1056                 :            : {
    1057                 :            :     // After daemonization get the data directory lock again and hold on to it until exit
    1058                 :            :     // This creates a slight window for a race condition to happen, however this condition is harmless: it
    1059                 :            :     // will at most make us exit without printing a message to console.
    1060         [ #  # ]:          0 :     if (!LockDataDirectory(false)) {
    1061                 :            :         // Detailed error printed inside LockDataDirectory
    1062                 :          0 :         return false;
    1063                 :            :     }
    1064                 :          0 :     return true;
    1065                 :          0 : }
    1066                 :            : 
    1067                 :          0 : bool AppInitInterfaces(NodeContext& node)
    1068                 :            : {
    1069                 :          0 :     node.chain = node.init->makeChain();
    1070                 :          0 :     return true;
    1071                 :            : }
    1072                 :            : 
    1073                 :          0 : bool AppInitMain(NodeContext& node, interfaces::BlockAndHeaderTipInfo* tip_info)
    1074                 :            : {
    1075                 :          0 :     const ArgsManager& args = *Assert(node.args);
    1076                 :          0 :     const CChainParams& chainparams = Params();
    1077                 :            : 
    1078 [ #  # ][ #  # ]:          0 :     auto opt_max_upload = ParseByteUnits(args.GetArg("-maxuploadtarget", DEFAULT_MAX_UPLOAD_TARGET), ByteUnit::M);
                 [ #  # ]
    1079         [ #  # ]:          0 :     if (!opt_max_upload) {
    1080 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Unable to parse -maxuploadtarget: '%s'"), args.GetArg("-maxuploadtarget", "")));
         [ #  # ][ #  # ]
                 [ #  # ]
    1081                 :            :     }
    1082                 :            : 
    1083                 :            :     // ********************************************************* Step 4a: application initialization
    1084         [ #  # ]:          0 :     if (!CreatePidFile(args)) {
    1085                 :            :         // Detailed error printed inside CreatePidFile().
    1086                 :          0 :         return false;
    1087                 :            :     }
    1088         [ #  # ]:          0 :     if (!init::StartLogging(args)) {
    1089                 :            :         // Detailed error printed inside StartLogging().
    1090                 :          0 :         return false;
    1091                 :            :     }
    1092                 :            : 
    1093 [ #  # ][ #  # ]:          0 :     LogPrintf("Using at most %i automatic connections (%i file descriptors available)\n", nMaxConnections, nFD);
                 [ #  # ]
    1094                 :            : 
    1095                 :            :     // Warn about relative -datadir path.
    1096 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-datadir") && !args.GetPathArg("-datadir").is_absolute()) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
    1097 [ #  # ][ #  # ]:          0 :         LogPrintf("Warning: relative datadir option '%s' specified, which will be interpreted relative to the "
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
    1098                 :            :                   "current working directory '%s'. This is fragile, because if bitcoin is started in the future "
    1099                 :            :                   "from a different location, it will be unable to locate the current data files. There could "
    1100                 :            :                   "also be data loss if bitcoin is started while in a temporary directory.\n",
    1101                 :            :                   args.GetArg("-datadir", ""), fs::PathToString(fs::current_path()));
    1102                 :          0 :     }
    1103                 :            : 
    1104                 :          0 :     ValidationCacheSizes validation_cache_sizes{};
    1105                 :          0 :     ApplyArgsManOptions(args, validation_cache_sizes);
    1106         [ #  # ]:          0 :     if (!InitSignatureCache(validation_cache_sizes.signature_cache_bytes)
    1107         [ #  # ]:          0 :         || !InitScriptExecutionCache(validation_cache_sizes.script_execution_cache_bytes))
    1108                 :            :     {
    1109 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Unable to allocate memory for -maxsigcachesize: '%s' MiB"), args.GetIntArg("-maxsigcachesize", DEFAULT_MAX_SIG_CACHE_BYTES >> 20)));
         [ #  # ][ #  # ]
    1110                 :            :     }
    1111                 :            : 
    1112 [ #  # ][ #  # ]:          0 :     int script_threads = args.GetIntArg("-par", DEFAULT_SCRIPTCHECK_THREADS);
    1113         [ #  # ]:          0 :     if (script_threads <= 0) {
    1114                 :            :         // -par=0 means autodetect (number of cores - 1 script threads)
    1115                 :            :         // -par=-n means "leave n cores free" (number of cores - n - 1 script threads)
    1116                 :          0 :         script_threads += GetNumCores();
    1117                 :          0 :     }
    1118                 :            : 
    1119                 :            :     // Subtract 1 because the main thread counts towards the par threads
    1120                 :          0 :     script_threads = std::max(script_threads - 1, 0);
    1121                 :            : 
    1122                 :            :     // Number of script-checking threads <= MAX_SCRIPTCHECK_THREADS
    1123                 :          0 :     script_threads = std::min(script_threads, MAX_SCRIPTCHECK_THREADS);
    1124                 :            : 
    1125 [ #  # ][ #  # ]:          0 :     LogPrintf("Script verification uses %d additional threads\n", script_threads);
                 [ #  # ]
    1126         [ #  # ]:          0 :     if (script_threads >= 1) {
    1127                 :          0 :         StartScriptCheckWorkerThreads(script_threads);
    1128                 :          0 :     }
    1129                 :            : 
    1130         [ #  # ]:          0 :     assert(!node.scheduler);
    1131                 :          0 :     node.scheduler = std::make_unique<CScheduler>();
    1132                 :            : 
    1133                 :            :     // Start the lightweight task scheduler thread
    1134                 :          0 :     node.scheduler->m_service_thread = std::thread(util::TraceThread, "scheduler", [&] { node.scheduler->serviceQueue(); });
    1135                 :            : 
    1136                 :            :     // Gather some entropy once per minute.
    1137         [ #  # ]:          0 :     node.scheduler->scheduleEvery([]{
    1138                 :          0 :         RandAddPeriodic();
    1139 [ #  # ][ #  # ]:          0 :     }, std::chrono::minutes{1});
    1140                 :            : 
    1141                 :            :     // Check disk space every 5 minutes to avoid db corruption.
    1142         [ #  # ]:          0 :     node.scheduler->scheduleEvery([&args]{
    1143                 :          0 :         constexpr uint64_t min_disk_space = 50 << 20; // 50 MB
    1144         [ #  # ]:          0 :         if (!CheckDiskSpace(args.GetBlocksDirPath(), min_disk_space)) {
    1145 [ #  # ][ #  # ]:          0 :             LogPrintf("Shutting down due to lack of disk space!\n");
                 [ #  # ]
    1146                 :          0 :             StartShutdown();
    1147                 :          0 :         }
    1148 [ #  # ][ #  # ]:          0 :     }, std::chrono::minutes{5});
    1149                 :            : 
    1150                 :          0 :     GetMainSignals().RegisterBackgroundSignalScheduler(*node.scheduler);
    1151                 :            : 
    1152                 :            :     // Create client interfaces for wallets that are supposed to be loaded
    1153                 :            :     // according to -wallet and -disablewallet options. This only constructs
    1154                 :            :     // the interfaces, it doesn't load wallet data. Wallets actually get loaded
    1155                 :            :     // when load() and start() interface methods are called below.
    1156                 :          0 :     g_wallet_init_interface.Construct(node);
    1157                 :          0 :     uiInterface.InitWallet();
    1158                 :            : 
    1159                 :            :     /* Register RPC commands regardless of -server setting so they will be
    1160                 :            :      * available in the GUI RPC console even if external calls are disabled.
    1161                 :            :      */
    1162                 :          0 :     RegisterAllCoreRPCCommands(tableRPC);
    1163         [ #  # ]:          0 :     for (const auto& client : node.chain_clients) {
    1164                 :          0 :         client->registerRpcs();
    1165                 :            :     }
    1166                 :            : #if ENABLE_ZMQ
    1167                 :            :     RegisterZMQRPCCommands(tableRPC);
    1168                 :            : #endif
    1169                 :            : 
    1170                 :            :     /* Start the RPC server already.  It will be started in "warmup" mode
    1171                 :            :      * and not really process calls already (but it will signify connections
    1172                 :            :      * that the server is there and will be ready later).  Warmup mode will
    1173                 :            :      * be disabled when initialisation is finished.
    1174                 :            :      */
    1175 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-server", false)) {
                 [ #  # ]
    1176         [ #  # ]:          0 :         uiInterface.InitMessage_connect(SetRPCWarmupStatus);
    1177         [ #  # ]:          0 :         if (!AppInitServers(node))
    1178         [ #  # ]:          0 :             return InitError(_("Unable to start HTTP server. See debug log for details."));
    1179                 :          0 :     }
    1180                 :            : 
    1181                 :            :     // ********************************************************* Step 5: verify wallet database integrity
    1182         [ #  # ]:          0 :     for (const auto& client : node.chain_clients) {
    1183         [ #  # ]:          0 :         if (!client->verify()) {
    1184                 :          0 :             return false;
    1185                 :            :         }
    1186                 :            :     }
    1187                 :            : 
    1188                 :            :     // ********************************************************* Step 6: network initialization
    1189                 :            :     // Note that we absolutely cannot open any actual connections
    1190                 :            :     // until the very end ("start node") as the UTXO/block state
    1191                 :            :     // is not yet setup and may end up being set up twice if we
    1192                 :            :     // need to reindex later.
    1193                 :            : 
    1194 [ #  # ][ #  # ]:          0 :     fListen = args.GetBoolArg("-listen", DEFAULT_LISTEN);
    1195 [ #  # ][ #  # ]:          0 :     fDiscover = args.GetBoolArg("-discover", true);
    1196                 :            : 
    1197                 :          0 :     PeerManager::Options peerman_opts{};
    1198                 :          0 :     ApplyArgsManOptions(args, peerman_opts);
    1199                 :            : 
    1200                 :            :     {
    1201                 :            : 
    1202                 :            :         // Read asmap file if configured
    1203                 :          0 :         std::vector<bool> asmap;
    1204 [ #  # ][ #  # ]:          0 :         if (args.IsArgSet("-asmap")) {
                 [ #  # ]
    1205 [ #  # ][ #  # ]:          0 :             fs::path asmap_path = args.GetPathArg("-asmap", DEFAULT_ASMAP_FILENAME);
                 [ #  # ]
    1206         [ #  # ]:          0 :             if (!asmap_path.is_absolute()) {
    1207 [ #  # ][ #  # ]:          0 :                 asmap_path = args.GetDataDirNet() / asmap_path;
         [ #  # ][ #  # ]
    1208                 :          0 :             }
    1209 [ #  # ][ #  # ]:          0 :             if (!fs::exists(asmap_path)) {
    1210 [ #  # ][ #  # ]:          0 :                 InitError(strprintf(_("Could not find asmap file %s"), fs::quoted(fs::PathToString(asmap_path))));
         [ #  # ][ #  # ]
                 [ #  # ]
    1211                 :          0 :                 return false;
    1212                 :            :             }
    1213 [ #  # ][ #  # ]:          0 :             asmap = DecodeAsmap(asmap_path);
    1214         [ #  # ]:          0 :             if (asmap.size() == 0) {
    1215 [ #  # ][ #  # ]:          0 :                 InitError(strprintf(_("Could not parse asmap file %s"), fs::quoted(fs::PathToString(asmap_path))));
         [ #  # ][ #  # ]
                 [ #  # ]
    1216                 :          0 :                 return false;
    1217                 :            :             }
    1218 [ #  # ][ #  # ]:          0 :             const uint256 asmap_version = (HashWriter{} << asmap).GetHash();
                 [ #  # ]
    1219 [ #  # ][ #  # ]:          0 :             LogPrintf("Using asmap version %s for IP bucketing\n", asmap_version.ToString());
         [ #  # ][ #  # ]
    1220         [ #  # ]:          0 :         } else {
    1221 [ #  # ][ #  # ]:          0 :             LogPrintf("Using /16 prefix for IP bucketing\n");
                 [ #  # ]
    1222                 :            :         }
    1223                 :            : 
    1224                 :            :         // Initialize netgroup manager
    1225         [ #  # ]:          0 :         assert(!node.netgroupman);
    1226         [ #  # ]:          0 :         node.netgroupman = std::make_unique<NetGroupManager>(std::move(asmap));
    1227                 :            : 
    1228                 :            :         // Initialize addrman
    1229         [ #  # ]:          0 :         assert(!node.addrman);
    1230 [ #  # ][ #  # ]:          0 :         uiInterface.InitMessage(_("Loading P2P addresses…").translated);
    1231         [ #  # ]:          0 :         auto addrman{LoadAddrman(*node.netgroupman, args)};
    1232 [ #  # ][ #  # ]:          0 :         if (!addrman) return InitError(util::ErrorString(addrman));
                 [ #  # ]
    1233         [ #  # ]:          0 :         node.addrman = std::move(*addrman);
    1234         [ #  # ]:          0 :     }
    1235                 :            : 
    1236         [ #  # ]:          0 :     assert(!node.banman);
    1237 [ #  # ][ #  # ]:          0 :     node.banman = std::make_unique<BanMan>(args.GetDataDirNet() / "banlist", &uiInterface, args.GetIntArg("-bantime", DEFAULT_MISBEHAVING_BANTIME));
         [ #  # ][ #  # ]
    1238         [ #  # ]:          0 :     assert(!node.connman);
    1239         [ #  # ]:          0 :     node.connman = std::make_unique<CConnman>(GetRand<uint64_t>(),
    1240                 :          0 :                                               GetRand<uint64_t>(),
    1241 [ #  # ][ #  # ]:          0 :                                               *node.addrman, *node.netgroupman, chainparams, args.GetBoolArg("-networkactive", true));
    1242                 :            : 
    1243         [ #  # ]:          0 :     assert(!node.fee_estimator);
    1244                 :            :     // Don't initialize fee estimation with old data if we don't relay transactions,
    1245                 :            :     // as they would never get updated.
    1246         [ #  # ]:          0 :     if (!peerman_opts.ignore_incoming_txs) {
    1247 [ #  # ][ #  # ]:          0 :         bool read_stale_estimates = args.GetBoolArg("-acceptstalefeeestimates", DEFAULT_ACCEPT_STALE_FEE_ESTIMATES);
    1248 [ #  # ][ #  # ]:          0 :         if (read_stale_estimates && (chainparams.GetChainType() != ChainType::REGTEST)) {
    1249 [ #  # ][ #  # ]:          0 :             return InitError(strprintf(_("acceptstalefeeestimates is not supported on %s chain."), chainparams.GetChainTypeString()));
                 [ #  # ]
    1250                 :            :         }
    1251         [ #  # ]:          0 :         node.fee_estimator = std::make_unique<CBlockPolicyEstimator>(FeeestPath(args), read_stale_estimates);
    1252                 :            : 
    1253                 :            :         // Flush estimates to disk periodically
    1254                 :          0 :         CBlockPolicyEstimator* fee_estimator = node.fee_estimator.get();
    1255 [ #  # ][ #  # ]:          0 :         node.scheduler->scheduleEvery([fee_estimator] { fee_estimator->FlushFeeEstimates(); }, FEE_FLUSH_INTERVAL);
    1256                 :          0 :     }
    1257                 :            : 
    1258                 :            :     // Check port numbers
    1259 [ #  # ][ #  # ]:          0 :     for (const std::string port_option : {
    1260                 :            :         "-port",
    1261                 :            :         "-rpcport",
    1262                 :            :     }) {
    1263 [ #  # ][ #  # ]:          0 :         if (args.IsArgSet(port_option)) {
    1264 [ #  # ][ #  # ]:          0 :             const std::string port = args.GetArg(port_option, "");
    1265                 :            :             uint16_t n;
    1266 [ #  # ][ #  # ]:          0 :             if (!ParseUInt16(port, &n) || n == 0) {
                 [ #  # ]
    1267 [ #  # ][ #  # ]:          0 :                 return InitError(InvalidPortErrMsg(port_option, port));
    1268                 :            :             }
    1269         [ #  # ]:          0 :         }
    1270         [ #  # ]:          0 :     }
    1271                 :            : 
    1272 [ #  # ][ #  # ]:          0 :     for (const std::string port_option : {
    1273                 :            :         "-i2psam",
    1274                 :            :         "-onion",
    1275                 :            :         "-proxy",
    1276                 :            :         "-rpcbind",
    1277                 :            :         "-torcontrol",
    1278                 :            :         "-whitebind",
    1279                 :            :         "-zmqpubhashblock",
    1280                 :            :         "-zmqpubhashtx",
    1281                 :            :         "-zmqpubrawblock",
    1282                 :            :         "-zmqpubrawtx",
    1283                 :            :         "-zmqpubsequence",
    1284                 :            :     }) {
    1285 [ #  # ][ #  # ]:          0 :         for (const std::string& socket_addr : args.GetArgs(port_option)) {
                 [ #  # ]
    1286                 :          0 :             std::string host_out;
    1287                 :          0 :             uint16_t port_out{0};
    1288 [ #  # ][ #  # ]:          0 :             if (!SplitHostPort(socket_addr, port_out, host_out)) {
    1289 [ #  # ][ #  # ]:          0 :                 return InitError(InvalidPortErrMsg(port_option, socket_addr));
    1290                 :            :             }
    1291         [ #  # ]:          0 :         }
    1292         [ #  # ]:          0 :     }
    1293                 :            : 
    1294 [ #  # ][ #  # ]:          0 :     for (const std::string& socket_addr : args.GetArgs("-bind")) {
         [ #  # ][ #  # ]
    1295                 :          0 :         std::string host_out;
    1296                 :          0 :         uint16_t port_out{0};
    1297         [ #  # ]:          0 :         std::string bind_socket_addr = socket_addr.substr(0, socket_addr.rfind('='));
    1298 [ #  # ][ #  # ]:          0 :         if (!SplitHostPort(bind_socket_addr, port_out, host_out)) {
    1299 [ #  # ][ #  # ]:          0 :             return InitError(InvalidPortErrMsg("-bind", socket_addr));
                 [ #  # ]
    1300                 :            :         }
    1301         [ #  # ]:          0 :     }
    1302                 :            : 
    1303                 :            :     // sanitize comments per BIP-0014, format user agent and check total size
    1304                 :          0 :     std::vector<std::string> uacomments;
    1305 [ #  # ][ #  # ]:          0 :     for (const std::string& cmt : args.GetArgs("-uacomment")) {
         [ #  # ][ #  # ]
    1306 [ #  # ][ #  # ]:          0 :         if (cmt != SanitizeString(cmt, SAFE_CHARS_UA_COMMENT))
    1307 [ #  # ][ #  # ]:          0 :             return InitError(strprintf(_("User Agent comment (%s) contains unsafe characters."), cmt));
                 [ #  # ]
    1308         [ #  # ]:          0 :         uacomments.push_back(cmt);
    1309                 :            :     }
    1310         [ #  # ]:          0 :     strSubVersion = FormatSubVersion(CLIENT_NAME, CLIENT_VERSION, uacomments);
    1311         [ #  # ]:          0 :     if (strSubVersion.size() > MAX_SUBVERSION_LENGTH) {
    1312 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Total length of network version string (%i) exceeds maximum length (%i). Reduce the number or size of uacomments."),
                 [ #  # ]
    1313                 :          0 :             strSubVersion.size(), MAX_SUBVERSION_LENGTH));
    1314                 :            :     }
    1315                 :            : 
    1316 [ #  # ][ #  # ]:          0 :     if (args.IsArgSet("-onlynet")) {
                 [ #  # ]
    1317         [ #  # ]:          0 :         g_reachable_nets.RemoveAll();
    1318 [ #  # ][ #  # ]:          0 :         for (const std::string& snet : args.GetArgs("-onlynet")) {
         [ #  # ][ #  # ]
    1319         [ #  # ]:          0 :             enum Network net = ParseNetwork(snet);
    1320         [ #  # ]:          0 :             if (net == NET_UNROUTABLE)
    1321 [ #  # ][ #  # ]:          0 :                 return InitError(strprintf(_("Unknown network specified in -onlynet: '%s'"), snet));
                 [ #  # ]
    1322         [ #  # ]:          0 :             g_reachable_nets.Add(net);
    1323                 :            :         }
    1324                 :          0 :     }
    1325                 :            : 
    1326 [ #  # ][ #  # ]:          0 :     if (!args.IsArgSet("-cjdnsreachable")) {
                 [ #  # ]
    1327 [ #  # ][ #  # ]:          0 :         if (args.IsArgSet("-onlynet") && g_reachable_nets.Contains(NET_CJDNS)) {
         [ #  # ][ #  # ]
                 [ #  # ]
    1328         [ #  # ]:          0 :             return InitError(
    1329         [ #  # ]:          0 :                 _("Outbound connections restricted to CJDNS (-onlynet=cjdns) but "
    1330                 :            :                   "-cjdnsreachable is not provided"));
    1331                 :            :         }
    1332         [ #  # ]:          0 :         g_reachable_nets.Remove(NET_CJDNS);
    1333                 :          0 :     }
    1334                 :            :     // Now g_reachable_nets.Contains(NET_CJDNS) is true if:
    1335                 :            :     // 1. -cjdnsreachable is given and
    1336                 :            :     // 2.1. -onlynet is not given or
    1337                 :            :     // 2.2. -onlynet=cjdns is given
    1338                 :            : 
    1339                 :            :     // Requesting DNS seeds entails connecting to IPv4/IPv6, which -onlynet options may prohibit:
    1340                 :            :     // If -dnsseed=1 is explicitly specified, abort. If it's left unspecified by the user, we skip
    1341                 :            :     // the DNS seeds by adjusting -dnsseed in InitParameterInteraction.
    1342 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-dnsseed") == true && !g_reachable_nets.Contains(NET_IPV4) && !g_reachable_nets.Contains(NET_IPV6)) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1343 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("Incompatible options: -dnsseed=1 was explicitly specified, but -onlynet forbids connections to IPv4/IPv6")));
                 [ #  # ]
    1344                 :            :     };
    1345                 :            : 
    1346                 :            :     // Check for host lookup allowed before parsing any network related parameters
    1347 [ #  # ][ #  # ]:          0 :     fNameLookup = args.GetBoolArg("-dns", DEFAULT_NAME_LOOKUP);
    1348                 :            : 
    1349         [ #  # ]:          0 :     Proxy onion_proxy;
    1350                 :            : 
    1351 [ #  # ][ #  # ]:          0 :     bool proxyRandomize = args.GetBoolArg("-proxyrandomize", DEFAULT_PROXYRANDOMIZE);
    1352                 :            :     // -proxy sets a proxy for all outgoing network traffic
    1353                 :            :     // -noproxy (or -proxy=0) as well as the empty string can be used to not set a proxy, this is the default
    1354 [ #  # ][ #  # ]:          0 :     std::string proxyArg = args.GetArg("-proxy", "");
                 [ #  # ]
    1355 [ #  # ][ #  # ]:          0 :     if (proxyArg != "" && proxyArg != "0") {
         [ #  # ][ #  # ]
    1356 [ #  # ][ #  # ]:          0 :         const std::optional<CService> proxyAddr{Lookup(proxyArg, 9050, fNameLookup)};
    1357         [ #  # ]:          0 :         if (!proxyAddr.has_value()) {
    1358 [ #  # ][ #  # ]:          0 :             return InitError(strprintf(_("Invalid -proxy address or hostname: '%s'"), proxyArg));
                 [ #  # ]
    1359                 :            :         }
    1360                 :            : 
    1361 [ #  # ][ #  # ]:          0 :         Proxy addrProxy = Proxy(proxyAddr.value(), proxyRandomize);
    1362 [ #  # ][ #  # ]:          0 :         if (!addrProxy.IsValid())
    1363 [ #  # ][ #  # ]:          0 :             return InitError(strprintf(_("Invalid -proxy address or hostname: '%s'"), proxyArg));
                 [ #  # ]
    1364                 :            : 
    1365         [ #  # ]:          0 :         SetProxy(NET_IPV4, addrProxy);
    1366         [ #  # ]:          0 :         SetProxy(NET_IPV6, addrProxy);
    1367         [ #  # ]:          0 :         SetProxy(NET_CJDNS, addrProxy);
    1368         [ #  # ]:          0 :         SetNameProxy(addrProxy);
    1369         [ #  # ]:          0 :         onion_proxy = addrProxy;
    1370         [ #  # ]:          0 :     }
    1371                 :            : 
    1372 [ #  # ][ #  # ]:          0 :     const bool onlynet_used_with_onion{args.IsArgSet("-onlynet") && g_reachable_nets.Contains(NET_ONION)};
         [ #  # ][ #  # ]
    1373                 :            : 
    1374                 :            :     // -onion can be used to set only a proxy for .onion, or override normal proxy for .onion addresses
    1375                 :            :     // -noonion (or -onion=0) disables connecting to .onion entirely
    1376                 :            :     // An empty string is used to not override the onion proxy (in which case it defaults to -proxy set above, or none)
    1377 [ #  # ][ #  # ]:          0 :     std::string onionArg = args.GetArg("-onion", "");
                 [ #  # ]
    1378 [ #  # ][ #  # ]:          0 :     if (onionArg != "") {
    1379 [ #  # ][ #  # ]:          0 :         if (onionArg == "0") { // Handle -noonion/-onion=0
    1380         [ #  # ]:          0 :             onion_proxy = Proxy{};
    1381         [ #  # ]:          0 :             if (onlynet_used_with_onion) {
    1382         [ #  # ]:          0 :                 return InitError(
    1383         [ #  # ]:          0 :                     _("Outbound connections restricted to Tor (-onlynet=onion) but the proxy for "
    1384                 :            :                       "reaching the Tor network is explicitly forbidden: -onion=0"));
    1385                 :            :             }
    1386                 :          0 :         } else {
    1387 [ #  # ][ #  # ]:          0 :             const std::optional<CService> addr{Lookup(onionArg, 9050, fNameLookup)};
    1388 [ #  # ][ #  # ]:          0 :             if (!addr.has_value() || !addr->IsValid()) {
                 [ #  # ]
    1389 [ #  # ][ #  # ]:          0 :                 return InitError(strprintf(_("Invalid -onion address or hostname: '%s'"), onionArg));
                 [ #  # ]
    1390                 :            :             }
    1391 [ #  # ][ #  # ]:          0 :             onion_proxy = Proxy{addr.value(), proxyRandomize};
    1392         [ #  # ]:          0 :         }
    1393                 :          0 :     }
    1394                 :            : 
    1395 [ #  # ][ #  # ]:          0 :     if (onion_proxy.IsValid()) {
    1396         [ #  # ]:          0 :         SetProxy(NET_ONION, onion_proxy);
    1397                 :          0 :     } else {
    1398                 :            :         // If -listenonion is set, then we will (try to) connect to the Tor control port
    1399                 :            :         // later from the torcontrol thread and may retrieve the onion proxy from there.
    1400 [ #  # ][ #  # ]:          0 :         const bool listenonion_disabled{!args.GetBoolArg("-listenonion", DEFAULT_LISTEN_ONION)};
    1401 [ #  # ][ #  # ]:          0 :         if (onlynet_used_with_onion && listenonion_disabled) {
    1402         [ #  # ]:          0 :             return InitError(
    1403         [ #  # ]:          0 :                 _("Outbound connections restricted to Tor (-onlynet=onion) but the proxy for "
    1404                 :            :                   "reaching the Tor network is not provided: none of -proxy, -onion or "
    1405                 :            :                   "-listenonion is given"));
    1406                 :            :         }
    1407         [ #  # ]:          0 :         g_reachable_nets.Remove(NET_ONION);
    1408                 :            :     }
    1409                 :            : 
    1410 [ #  # ][ #  # ]:          0 :     for (const std::string& strAddr : args.GetArgs("-externalip")) {
         [ #  # ][ #  # ]
    1411 [ #  # ][ #  # ]:          0 :         const std::optional<CService> addrLocal{Lookup(strAddr, GetListenPort(), fNameLookup)};
                 [ #  # ]
    1412 [ #  # ][ #  # ]:          0 :         if (addrLocal.has_value() && addrLocal->IsValid())
                 [ #  # ]
    1413 [ #  # ][ #  # ]:          0 :             AddLocal(addrLocal.value(), LOCAL_MANUAL);
    1414                 :            :         else
    1415 [ #  # ][ #  # ]:          0 :             return InitError(ResolveErrMsg("externalip", strAddr));
                 [ #  # ]
    1416         [ #  # ]:          0 :     }
    1417                 :            : 
    1418                 :            : #if ENABLE_ZMQ
    1419                 :            :     g_zmq_notification_interface = CZMQNotificationInterface::Create(
    1420                 :            :         [&chainman = node.chainman](CBlock& block, const CBlockIndex& index) {
    1421                 :            :             assert(chainman);
    1422                 :            :             return chainman->m_blockman.ReadBlockFromDisk(block, index);
    1423                 :            :         });
    1424                 :            : 
    1425                 :            :     if (g_zmq_notification_interface) {
    1426                 :            :         RegisterValidationInterface(g_zmq_notification_interface.get());
    1427                 :            :     }
    1428                 :            : #endif
    1429                 :            : 
    1430                 :            :     // ********************************************************* Step 7: load block chain
    1431                 :            : 
    1432         [ #  # ]:          0 :     node.notifications = std::make_unique<KernelNotifications>(node.exit_status);
    1433         [ #  # ]:          0 :     ReadNotificationArgs(args, *node.notifications);
    1434 [ #  # ][ #  # ]:          0 :     fReindex = args.GetBoolArg("-reindex", false);
    1435 [ #  # ][ #  # ]:          0 :     bool fReindexChainState = args.GetBoolArg("-reindex-chainstate", false);
    1436                 :          0 :     ChainstateManager::Options chainman_opts{
    1437                 :          0 :         .chainparams = chainparams,
    1438 [ #  # ][ #  # ]:          0 :         .datadir = args.GetDataDirNet(),
    1439                 :          0 :         .adjusted_time_callback = GetAdjustedTime,
    1440                 :          0 :         .notifications = *node.notifications,
    1441                 :            :     };
    1442 [ #  # ][ #  # ]:          0 :     Assert(ApplyArgsManOptions(args, chainman_opts)); // no error can happen, already checked in AppInitParameterInteraction
    1443                 :            : 
    1444                 :          0 :     BlockManager::Options blockman_opts{
    1445                 :          0 :         .chainparams = chainman_opts.chainparams,
    1446 [ #  # ][ #  # ]:          0 :         .blocks_dir = args.GetBlocksDirPath(),
    1447                 :          0 :         .notifications = chainman_opts.notifications,
    1448                 :            :     };
    1449 [ #  # ][ #  # ]:          0 :     Assert(ApplyArgsManOptions(args, blockman_opts)); // no error can happen, already checked in AppInitParameterInteraction
    1450                 :            : 
    1451                 :            :     // cache size calculations
    1452         [ #  # ]:          0 :     CacheSizes cache_sizes = CalculateCacheSizes(args, g_enabled_filter_types.size());
    1453                 :            : 
    1454 [ #  # ][ #  # ]:          0 :     LogPrintf("Cache configuration:\n");
                 [ #  # ]
    1455 [ #  # ][ #  # ]:          0 :     LogPrintf("* Using %.1f MiB for block index database\n", cache_sizes.block_tree_db * (1.0 / 1024 / 1024));
                 [ #  # ]
    1456 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-txindex", DEFAULT_TXINDEX)) {
                 [ #  # ]
    1457 [ #  # ][ #  # ]:          0 :         LogPrintf("* Using %.1f MiB for transaction index database\n", cache_sizes.tx_index * (1.0 / 1024 / 1024));
                 [ #  # ]
    1458                 :          0 :     }
    1459         [ #  # ]:          0 :     for (BlockFilterType filter_type : g_enabled_filter_types) {
    1460 [ #  # ][ #  # ]:          0 :         LogPrintf("* Using %.1f MiB for %s block filter index database\n",
         [ #  # ][ #  # ]
    1461                 :            :                   cache_sizes.filter_index * (1.0 / 1024 / 1024), BlockFilterTypeName(filter_type));
    1462                 :            :     }
    1463 [ #  # ][ #  # ]:          0 :     LogPrintf("* Using %.1f MiB for chain state database\n", cache_sizes.coins_db * (1.0 / 1024 / 1024));
                 [ #  # ]
    1464                 :            : 
    1465         [ #  # ]:          0 :     assert(!node.mempool);
    1466         [ #  # ]:          0 :     assert(!node.chainman);
    1467                 :            : 
    1468                 :          0 :     CTxMemPool::Options mempool_opts{
    1469                 :          0 :         .estimator = node.fee_estimator.get(),
    1470         [ #  # ]:          0 :         .check_ratio = chainparams.DefaultConsistencyChecks() ? 1 : 0,
    1471                 :            :     };
    1472         [ #  # ]:          0 :     auto result{ApplyArgsManOptions(args, chainparams, mempool_opts)};
    1473         [ #  # ]:          0 :     if (!result) {
    1474 [ #  # ][ #  # ]:          0 :         return InitError(util::ErrorString(result));
    1475                 :            :     }
    1476         [ #  # ]:          0 :     mempool_opts.check_ratio = std::clamp<int>(mempool_opts.check_ratio, 0, 1'000'000);
    1477                 :            : 
    1478                 :          0 :     int64_t descendant_limit_bytes = mempool_opts.limits.descendant_size_vbytes * 40;
    1479 [ #  # ][ #  # ]:          0 :     if (mempool_opts.max_size_bytes < 0 || mempool_opts.max_size_bytes < descendant_limit_bytes) {
    1480 [ #  # ][ #  # ]:          0 :         return InitError(strprintf(_("-maxmempool must be at least %d MB"), std::ceil(descendant_limit_bytes / 1'000'000.0)));
                 [ #  # ]
    1481                 :            :     }
    1482 [ #  # ][ #  # ]:          0 :     LogPrintf("* Using %.1f MiB for in-memory UTXO set (plus up to %.1f MiB of unused mempool space)\n", cache_sizes.coins * (1.0 / 1024 / 1024), mempool_opts.max_size_bytes * (1.0 / 1024 / 1024));
                 [ #  # ]
    1483                 :            : 
    1484 [ #  # ][ #  # ]:          0 :     for (bool fLoaded = false; !fLoaded && !ShutdownRequested();) {
                 [ #  # ]
    1485         [ #  # ]:          0 :         node.mempool = std::make_unique<CTxMemPool>(mempool_opts);
    1486                 :            : 
    1487         [ #  # ]:          0 :         node.chainman = std::make_unique<ChainstateManager>(node.kernel->interrupt, chainman_opts, blockman_opts);
    1488                 :          0 :         ChainstateManager& chainman = *node.chainman;
    1489                 :            : 
    1490                 :            :         // This is defined and set here instead of inline in validation.h to avoid a hard
    1491                 :            :         // dependency between validation and index/base, since the latter is not in
    1492                 :            :         // libbitcoinkernel.
    1493                 :          0 :         chainman.restart_indexes = [&node]() {
    1494 [ #  # ][ #  # ]:          0 :             LogPrintf("[snapshot] restarting indexes\n");
                 [ #  # ]
    1495                 :            : 
    1496                 :            :             // Drain the validation interface queue to ensure that the old indexes
    1497                 :            :             // don't have any pending work.
    1498                 :          0 :             SyncWithValidationInterfaceQueue();
    1499                 :            : 
    1500         [ #  # ]:          0 :             for (auto* index : node.indexes) {
    1501                 :          0 :                 index->Interrupt();
    1502                 :          0 :                 index->Stop();
    1503 [ #  # ][ #  # ]:          0 :                 if (!(index->Init() && index->StartBackgroundSync())) {
    1504 [ #  # ][ #  # ]:          0 :                     LogPrintf("[snapshot] WARNING failed to restart index %s on snapshot chain\n", index->GetName());
         [ #  # ][ #  # ]
    1505                 :          0 :                 }
    1506                 :            :             }
    1507                 :          0 :         };
    1508                 :            : 
    1509                 :          0 :         node::ChainstateLoadOptions options;
    1510         [ #  # ]:          0 :         options.mempool = Assert(node.mempool.get());
    1511                 :          0 :         options.reindex = node::fReindex;
    1512                 :          0 :         options.reindex_chainstate = fReindexChainState;
    1513         [ #  # ]:          0 :         options.prune = chainman.m_blockman.IsPruneMode();
    1514 [ #  # ][ #  # ]:          0 :         options.check_blocks = args.GetIntArg("-checkblocks", DEFAULT_CHECKBLOCKS);
    1515 [ #  # ][ #  # ]:          0 :         options.check_level = args.GetIntArg("-checklevel", DEFAULT_CHECKLEVEL);
    1516 [ #  # ][ #  # ]:          0 :         options.require_full_verification = args.IsArgSet("-checkblocks") || args.IsArgSet("-checklevel");
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
    1517                 :          0 :         options.check_interrupt = ShutdownRequested;
    1518                 :          0 :         options.coins_error_cb = [] {
    1519         [ #  # ]:          0 :             uiInterface.ThreadSafeMessageBox(
    1520                 :          0 :                 _("Error reading from database, shutting down."),
    1521         [ #  # ]:          0 :                 "", CClientUIInterface::MSG_ERROR);
    1522                 :          0 :         };
    1523                 :            : 
    1524 [ #  # ][ #  # ]:          0 :         uiInterface.InitMessage(_("Loading block index…").translated);
    1525                 :          0 :         const auto load_block_index_start_time{SteadyClock::now()};
    1526                 :          0 :         auto catch_exceptions = [](auto&& f) {
    1527                 :            :             try {
    1528 [ #  # ][ #  # ]:          0 :                 return f();
    1529 [ #  # ][ #  # ]:          0 :             } catch (const std::exception& e) {
    1530 [ #  # ][ #  # ]:          0 :                 LogPrintf("%s\n", e.what());
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1531 [ #  # ][ #  # ]:          0 :                 return std::make_tuple(node::ChainstateLoadStatus::FAILURE, _("Error opening block database"));
                 [ #  # ]
    1532 [ #  # ][ #  # ]:          0 :             }
    1533                 :          0 :         };
    1534         [ #  # ]:          0 :         auto [status, error] = catch_exceptions([&]{ return LoadChainstate(chainman, cache_sizes, options); });
    1535         [ #  # ]:          0 :         if (status == node::ChainstateLoadStatus::SUCCESS) {
    1536 [ #  # ][ #  # ]:          0 :             uiInterface.InitMessage(_("Verifying blocks…").translated);
    1537 [ #  # ][ #  # ]:          0 :             if (chainman.m_blockman.m_have_pruned && options.check_blocks > MIN_BLOCKS_TO_KEEP) {
    1538 [ #  # ][ #  # ]:          0 :                 LogPrintfCategory(BCLog::PRUNE, "pruned datadir may not have more than %d blocks; only checking available blocks\n",
                 [ #  # ]
    1539                 :            :                                   MIN_BLOCKS_TO_KEEP);
    1540                 :          0 :             }
    1541         [ #  # ]:          0 :             std::tie(status, error) = catch_exceptions([&]{ return VerifyLoadedChainstate(chainman, options);});
    1542         [ #  # ]:          0 :             if (status == node::ChainstateLoadStatus::SUCCESS) {
    1543                 :          0 :                 fLoaded = true;
    1544 [ #  # ][ #  # ]:          0 :                 LogPrintf(" block index %15dms\n", Ticks<std::chrono::milliseconds>(SteadyClock::now() - load_block_index_start_time));
         [ #  # ][ #  # ]
                 [ #  # ]
    1545                 :          0 :             }
    1546                 :          0 :         }
    1547                 :            : 
    1548 [ #  # ][ #  # ]:          0 :         if (status == node::ChainstateLoadStatus::FAILURE_FATAL || status == node::ChainstateLoadStatus::FAILURE_INCOMPATIBLE_DB || status == node::ChainstateLoadStatus::FAILURE_INSUFFICIENT_DBCACHE) {
                 [ #  # ]
    1549         [ #  # ]:          0 :             return InitError(error);
    1550                 :            :         }
    1551                 :            : 
    1552 [ #  # ][ #  # ]:          0 :         if (!fLoaded && !ShutdownRequested()) {
                 [ #  # ]
    1553                 :            :             // first suggest a reindex
    1554         [ #  # ]:          0 :             if (!options.reindex) {
    1555         [ #  # ]:          0 :                 bool fRet = uiInterface.ThreadSafeQuestion(
    1556 [ #  # ][ #  # ]:          0 :                     error + Untranslated(".\n\n") + _("Do you want to rebuild the block database now?"),
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1557         [ #  # ]:          0 :                     error.original + ".\nPlease restart with -reindex or -reindex-chainstate to recover.",
    1558         [ #  # ]:          0 :                     "", CClientUIInterface::MSG_ERROR | CClientUIInterface::BTN_ABORT);
    1559         [ #  # ]:          0 :                 if (fRet) {
    1560                 :          0 :                     fReindex = true;
    1561         [ #  # ]:          0 :                     AbortShutdown();
    1562                 :          0 :                 } else {
    1563 [ #  # ][ #  # ]:          0 :                     LogPrintf("Aborted block database rebuild. Exiting.\n");
                 [ #  # ]
    1564                 :          0 :                     return false;
    1565                 :            :                 }
    1566                 :          0 :             } else {
    1567         [ #  # ]:          0 :                 return InitError(error);
    1568                 :            :             }
    1569                 :          0 :         }
    1570         [ #  # ]:          0 :     }
    1571                 :            : 
    1572                 :            :     // As LoadBlockIndex can take several minutes, it's possible the user
    1573                 :            :     // requested to kill the GUI during the last operation. If so, exit.
    1574                 :            :     // As the program has not fully started yet, Shutdown() is possibly overkill.
    1575 [ #  # ][ #  # ]:          0 :     if (ShutdownRequested()) {
    1576 [ #  # ][ #  # ]:          0 :         LogPrintf("Shutdown requested. Exiting.\n");
                 [ #  # ]
    1577                 :          0 :         return false;
    1578                 :            :     }
    1579                 :            : 
    1580         [ #  # ]:          0 :     ChainstateManager& chainman = *Assert(node.chainman);
    1581                 :            : 
    1582         [ #  # ]:          0 :     assert(!node.peerman);
    1583 [ #  # ][ #  # ]:          0 :     node.peerman = PeerManager::make(*node.connman, *node.addrman,
    1584                 :          0 :                                      node.banman.get(), chainman,
    1585                 :          0 :                                      *node.mempool, peerman_opts);
    1586         [ #  # ]:          0 :     RegisterValidationInterface(node.peerman.get());
    1587                 :            : 
    1588                 :            :     // ********************************************************* Step 8: start indexers
    1589                 :            : 
    1590 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-txindex", DEFAULT_TXINDEX)) {
                 [ #  # ]
    1591 [ #  # ][ #  # ]:          0 :         g_txindex = std::make_unique<TxIndex>(interfaces::MakeChain(node), cache_sizes.tx_index, false, fReindex);
    1592         [ #  # ]:          0 :         node.indexes.emplace_back(g_txindex.get());
    1593                 :          0 :     }
    1594                 :            : 
    1595         [ #  # ]:          0 :     for (const auto& filter_type : g_enabled_filter_types) {
    1596         [ #  # ]:          0 :         InitBlockFilterIndex([&]{ return interfaces::MakeChain(node); }, filter_type, cache_sizes.filter_index, false, fReindex);
    1597 [ #  # ][ #  # ]:          0 :         node.indexes.emplace_back(GetBlockFilterIndex(filter_type));
    1598                 :            :     }
    1599                 :            : 
    1600 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-coinstatsindex", DEFAULT_COINSTATSINDEX)) {
                 [ #  # ]
    1601 [ #  # ][ #  # ]:          0 :         g_coin_stats_index = std::make_unique<CoinStatsIndex>(interfaces::MakeChain(node), /*cache_size=*/0, false, fReindex);
    1602         [ #  # ]:          0 :         node.indexes.emplace_back(g_coin_stats_index.get());
    1603                 :          0 :     }
    1604                 :            : 
    1605                 :            :     // Init indexes
    1606 [ #  # ][ #  # ]:          0 :     for (auto index : node.indexes) if (!index->Init()) return false;
                 [ #  # ]
    1607                 :            : 
    1608                 :            :     // ********************************************************* Step 9: load wallet
    1609         [ #  # ]:          0 :     for (const auto& client : node.chain_clients) {
    1610 [ #  # ][ #  # ]:          0 :         if (!client->load()) {
    1611                 :          0 :             return false;
    1612                 :            :         }
    1613                 :            :     }
    1614                 :            : 
    1615                 :            :     // ********************************************************* Step 10: data directory maintenance
    1616                 :            : 
    1617                 :            :     // if pruning, perform the initial blockstore prune
    1618                 :            :     // after any wallet rescanning has taken place.
    1619 [ #  # ][ #  # ]:          0 :     if (chainman.m_blockman.IsPruneMode()) {
    1620         [ #  # ]:          0 :         if (!fReindex) {
    1621 [ #  # ][ #  # ]:          0 :             LOCK(cs_main);
    1622 [ #  # ][ #  # ]:          0 :             for (Chainstate* chainstate : chainman.GetAll()) {
    1623 [ #  # ][ #  # ]:          0 :                 uiInterface.InitMessage(_("Pruning blockstore…").translated);
    1624         [ #  # ]:          0 :                 chainstate->PruneAndFlush();
    1625                 :            :             }
    1626                 :          0 :         }
    1627                 :          0 :     } else {
    1628 [ #  # ][ #  # ]:          0 :         LogPrintf("Setting NODE_NETWORK on non-prune mode\n");
                 [ #  # ]
    1629                 :          0 :         nLocalServices = ServiceFlags(nLocalServices | NODE_NETWORK);
    1630                 :            :     }
    1631                 :            : 
    1632                 :            :     // ********************************************************* Step 11: import blocks
    1633                 :            : 
    1634 [ #  # ][ #  # ]:          0 :     if (!CheckDiskSpace(args.GetDataDirNet())) {
                 [ #  # ]
    1635 [ #  # ][ #  # ]:          0 :         InitError(strprintf(_("Error: Disk space is low for %s"), fs::quoted(fs::PathToString(args.GetDataDirNet()))));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1636                 :          0 :         return false;
    1637                 :            :     }
    1638 [ #  # ][ #  # ]:          0 :     if (!CheckDiskSpace(args.GetBlocksDirPath())) {
                 [ #  # ]
    1639 [ #  # ][ #  # ]:          0 :         InitError(strprintf(_("Error: Disk space is low for %s"), fs::quoted(fs::PathToString(args.GetBlocksDirPath()))));
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1640                 :          0 :         return false;
    1641                 :            :     }
    1642                 :            : 
    1643 [ #  # ][ #  # ]:          0 :     int chain_active_height = WITH_LOCK(cs_main, return chainman.ActiveChain().Height());
         [ #  # ][ #  # ]
    1644                 :            : 
    1645                 :            :     // On first startup, warn on low block storage space
    1646 [ #  # ][ #  # ]:          0 :     if (!fReindex && !fReindexChainState && chain_active_height <= 1) {
                 [ #  # ]
    1647         [ #  # ]:          0 :         uint64_t assumed_chain_bytes{chainparams.AssumedBlockchainSize() * 1024 * 1024 * 1024};
    1648                 :          0 :         uint64_t additional_bytes_needed{
    1649 [ #  # ][ #  # ]:          0 :             chainman.m_blockman.IsPruneMode() ?
    1650 [ #  # ][ #  # ]:          0 :                 std::min(chainman.m_blockman.GetPruneTarget(), assumed_chain_bytes) :
    1651                 :          0 :                 assumed_chain_bytes};
    1652                 :            : 
    1653 [ #  # ][ #  # ]:          0 :         if (!CheckDiskSpace(args.GetBlocksDirPath(), additional_bytes_needed)) {
                 [ #  # ]
    1654 [ #  # ][ #  # ]:          0 :             InitWarning(strprintf(_(
                 [ #  # ]
    1655                 :            :                     "Disk space for %s may not accommodate the block files. " \
    1656                 :            :                     "Approximately %u GB of data will be stored in this directory."
    1657                 :            :                 ),
    1658 [ #  # ][ #  # ]:          0 :                 fs::quoted(fs::PathToString(args.GetBlocksDirPath())),
                 [ #  # ]
    1659         [ #  # ]:          0 :                 chainparams.AssumedBlockchainSize()
    1660                 :            :             ));
    1661                 :          0 :         }
    1662                 :          0 :     }
    1663                 :            : 
    1664                 :            :     // Either install a handler to notify us when genesis activates, or set fHaveGenesis directly.
    1665                 :            :     // No locking, as this happens before any background thread is started.
    1666         [ #  # ]:          0 :     boost::signals2::connection block_notify_genesis_wait_connection;
    1667 [ #  # ][ #  # ]:          0 :     if (WITH_LOCK(chainman.GetMutex(), return chainman.ActiveChain().Tip() == nullptr)) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1668 [ #  # ][ #  # ]:          0 :         block_notify_genesis_wait_connection = uiInterface.NotifyBlockTip_connect(std::bind(BlockNotifyGenesisWait, std::placeholders::_2));
         [ #  # ][ #  # ]
    1669                 :          0 :     } else {
    1670                 :          0 :         fHaveGenesis = true;
    1671                 :            :     }
    1672                 :            : 
    1673                 :            : #if HAVE_SYSTEM
    1674 [ #  # ][ #  # ]:          0 :     const std::string block_notify = args.GetArg("-blocknotify", "");
                 [ #  # ]
    1675         [ #  # ]:          0 :     if (!block_notify.empty()) {
    1676 [ #  # ][ #  # ]:          0 :         uiInterface.NotifyBlockTip_connect([block_notify](SynchronizationState sync_state, const CBlockIndex* pBlockIndex) {
                 [ #  # ]
    1677 [ #  # ][ #  # ]:          0 :             if (sync_state != SynchronizationState::POST_INIT || !pBlockIndex) return;
    1678                 :          0 :             std::string command = block_notify;
    1679 [ #  # ][ #  # ]:          0 :             ReplaceAll(command, "%s", pBlockIndex->GetBlockHash().GetHex());
         [ #  # ][ #  # ]
    1680         [ #  # ]:          0 :             std::thread t(runCommand, command);
    1681         [ #  # ]:          0 :             t.detach(); // thread runs free
    1682                 :          0 :         });
    1683                 :          0 :     }
    1684                 :            : #endif
    1685                 :            : 
    1686                 :          0 :     std::vector<fs::path> vImportFiles;
    1687 [ #  # ][ #  # ]:          0 :     for (const std::string& strFile : args.GetArgs("-loadblock")) {
                 [ #  # ]
    1688 [ #  # ][ #  # ]:          0 :         vImportFiles.push_back(fs::PathFromString(strFile));
    1689                 :            :     }
    1690                 :            : 
    1691 [ #  # ][ #  # ]:          0 :     chainman.m_thread_load = std::thread(&util::TraceThread, "initload", [=, &chainman, &args, &node] {
    1692                 :            :         // Import blocks
    1693         [ #  # ]:          0 :         ImportBlocks(chainman, vImportFiles);
    1694 [ #  # ][ #  # ]:          0 :         if (args.GetBoolArg("-stopafterblockimport", DEFAULT_STOPAFTERBLOCKIMPORT)) {
                 [ #  # ]
    1695 [ #  # ][ #  # ]:          0 :             LogPrintf("Stopping after block import\n");
                 [ #  # ]
    1696                 :          0 :             StartShutdown();
    1697                 :          0 :             return;
    1698                 :            :         }
    1699                 :            : 
    1700                 :            :         // Start indexes initial sync
    1701         [ #  # ]:          0 :         if (!StartIndexBackgroundSync(node)) {
    1702                 :          0 :             bilingual_str err_str = _("Failed to start indexes, shutting down..");
    1703 [ #  # ][ #  # ]:          0 :             chainman.GetNotifications().fatalError(err_str.original, err_str);
    1704                 :            :             return;
    1705                 :          0 :         }
    1706                 :            :         // Load mempool from disk
    1707         [ #  # ]:          0 :         if (auto* pool{chainman.ActiveChainstate().GetMempool()}) {
    1708 [ #  # ][ #  # ]:          0 :             LoadMempool(*pool, ShouldPersistMempool(args) ? MempoolPath(args) : fs::path{}, chainman.ActiveChainstate(), {});
         [ #  # ][ #  # ]
    1709                 :          0 :             pool->SetLoadTried(!chainman.m_interrupt);
    1710                 :          0 :         }
    1711                 :          0 :     });
    1712                 :            : 
    1713                 :            :     // Wait for genesis block to be processed
    1714                 :            :     {
    1715 [ #  # ][ #  # ]:          0 :         WAIT_LOCK(g_genesis_wait_mutex, lock);
    1716                 :            :         // We previously could hang here if StartShutdown() is called prior to
    1717                 :            :         // ImportBlocks getting started, so instead we just wait on a timer to
    1718                 :            :         // check ShutdownRequested() regularly.
    1719 [ #  # ][ #  # ]:          0 :         while (!fHaveGenesis && !ShutdownRequested()) {
                 [ #  # ]
    1720 [ #  # ][ #  # ]:          0 :             g_genesis_wait_cv.wait_for(lock, std::chrono::milliseconds(500));
    1721                 :            :         }
    1722         [ #  # ]:          0 :         block_notify_genesis_wait_connection.disconnect();
    1723                 :          0 :     }
    1724                 :            : 
    1725 [ #  # ][ #  # ]:          0 :     if (ShutdownRequested()) {
    1726                 :          0 :         return false;
    1727                 :            :     }
    1728                 :            : 
    1729                 :            :     // ********************************************************* Step 12: start node
    1730                 :            : 
    1731                 :            :     //// debug print
    1732                 :            :     {
    1733 [ #  # ][ #  # ]:          0 :         LOCK(cs_main);
    1734 [ #  # ][ #  # ]:          0 :         LogPrintf("block tree size = %u\n", chainman.BlockIndex().size());
         [ #  # ][ #  # ]
    1735 [ #  # ][ #  # ]:          0 :         chain_active_height = chainman.ActiveChain().Height();
    1736         [ #  # ]:          0 :         if (tip_info) {
    1737                 :          0 :             tip_info->block_height = chain_active_height;
    1738 [ #  # ][ #  # ]:          0 :             tip_info->block_time = chainman.ActiveChain().Tip() ? chainman.ActiveChain().Tip()->GetBlockTime() : chainman.GetParams().GenesisBlock().GetBlockTime();
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
    1739 [ #  # ][ #  # ]:          0 :             tip_info->verification_progress = GuessVerificationProgress(chainman.GetParams().TxData(), chainman.ActiveChain().Tip());
         [ #  # ][ #  # ]
                 [ #  # ]
    1740                 :          0 :         }
    1741 [ #  # ][ #  # ]:          0 :         if (tip_info && chainman.m_best_header) {
    1742                 :          0 :             tip_info->header_height = chainman.m_best_header->nHeight;
    1743         [ #  # ]:          0 :             tip_info->header_time = chainman.m_best_header->GetBlockTime();
    1744                 :          0 :         }
    1745                 :          0 :     }
    1746 [ #  # ][ #  # ]:          0 :     LogPrintf("nBestHeight = %d\n", chain_active_height);
                 [ #  # ]
    1747 [ #  # ][ #  # ]:          0 :     if (node.peerman) node.peerman->SetBestHeight(chain_active_height);
    1748                 :            : 
    1749                 :            :     // Map ports with UPnP or NAT-PMP.
    1750 [ #  # ][ #  # ]:          0 :     StartMapPort(args.GetBoolArg("-upnp", DEFAULT_UPNP), args.GetBoolArg("-natpmp", DEFAULT_NATPMP));
         [ #  # ][ #  # ]
                 [ #  # ]
    1751                 :            : 
    1752                 :          0 :     CConnman::Options connOptions;
    1753                 :          0 :     connOptions.nLocalServices = nLocalServices;
    1754                 :          0 :     connOptions.nMaxConnections = nMaxConnections;
    1755         [ #  # ]:          0 :     connOptions.m_max_outbound_full_relay = std::min(MAX_OUTBOUND_FULL_RELAY_CONNECTIONS, connOptions.nMaxConnections);
    1756         [ #  # ]:          0 :     connOptions.m_max_outbound_block_relay = std::min(MAX_BLOCK_RELAY_ONLY_CONNECTIONS, connOptions.nMaxConnections-connOptions.m_max_outbound_full_relay);
    1757                 :          0 :     connOptions.nMaxAddnode = MAX_ADDNODE_CONNECTIONS;
    1758                 :          0 :     connOptions.nMaxFeeler = MAX_FEELER_CONNECTIONS;
    1759                 :          0 :     connOptions.uiInterface = &uiInterface;
    1760                 :          0 :     connOptions.m_banman = node.banman.get();
    1761         [ #  # ]:          0 :     connOptions.m_msgproc = node.peerman.get();
    1762 [ #  # ][ #  # ]:          0 :     connOptions.nSendBufferMaxSize = 1000 * args.GetIntArg("-maxsendbuffer", DEFAULT_MAXSENDBUFFER);
    1763 [ #  # ][ #  # ]:          0 :     connOptions.nReceiveFloodSize = 1000 * args.GetIntArg("-maxreceivebuffer", DEFAULT_MAXRECEIVEBUFFER);
    1764 [ #  # ][ #  # ]:          0 :     connOptions.m_added_nodes = args.GetArgs("-addnode");
    1765                 :          0 :     connOptions.nMaxOutboundLimit = *opt_max_upload;
    1766                 :          0 :     connOptions.m_peer_connect_timeout = peer_connect_timeout;
    1767                 :            : 
    1768                 :            :     // Port to bind to if `-bind=addr` is provided without a `:port` suffix.
    1769                 :          0 :     const uint16_t default_bind_port =
    1770 [ #  # ][ #  # ]:          0 :         static_cast<uint16_t>(args.GetIntArg("-port", Params().GetDefaultPort()));
         [ #  # ][ #  # ]
    1771                 :            : 
    1772                 :          0 :     const auto BadPortWarning = [](const char* prefix, uint16_t port) {
    1773         [ #  # ]:          0 :         return strprintf(_("%s request to listen on port %u. This port is considered \"bad\" and "
    1774                 :            :                            "thus it is unlikely that any peer will connect to it. See "
    1775                 :            :                            "doc/p2p-bad-ports.md for details and a full list."),
    1776                 :            :                          prefix,
    1777                 :            :                          port);
    1778                 :          0 :     };
    1779                 :            : 
    1780 [ #  # ][ #  # ]:          0 :     for (const std::string& bind_arg : args.GetArgs("-bind")) {
         [ #  # ][ #  # ]
    1781                 :          0 :         std::optional<CService> bind_addr;
    1782                 :          0 :         const size_t index = bind_arg.rfind('=');
    1783         [ #  # ]:          0 :         if (index == std::string::npos) {
    1784 [ #  # ][ #  # ]:          0 :             bind_addr = Lookup(bind_arg, default_bind_port, /*fAllowLookup=*/false);
    1785         [ #  # ]:          0 :             if (bind_addr.has_value()) {
    1786 [ #  # ][ #  # ]:          0 :                 connOptions.vBinds.push_back(bind_addr.value());
    1787 [ #  # ][ #  # ]:          0 :                 if (IsBadPort(bind_addr.value().GetPort())) {
         [ #  # ][ #  # ]
    1788 [ #  # ][ #  # ]:          0 :                     InitWarning(BadPortWarning("-bind", bind_addr.value().GetPort()));
         [ #  # ][ #  # ]
    1789                 :          0 :                 }
    1790                 :          0 :                 continue;
    1791                 :            :             }
    1792                 :          0 :         } else {
    1793         [ #  # ]:          0 :             const std::string network_type = bind_arg.substr(index + 1);
    1794 [ #  # ][ #  # ]:          0 :             if (network_type == "onion") {
    1795         [ #  # ]:          0 :                 const std::string truncated_bind_arg = bind_arg.substr(0, index);
    1796 [ #  # ][ #  # ]:          0 :                 bind_addr = Lookup(truncated_bind_arg, BaseParams().OnionServiceTargetPort(), false);
         [ #  # ][ #  # ]
    1797         [ #  # ]:          0 :                 if (bind_addr.has_value()) {
    1798 [ #  # ][ #  # ]:          0 :                     connOptions.onion_binds.push_back(bind_addr.value());
    1799                 :          0 :                     continue;
    1800                 :            :                 }
    1801         [ #  # ]:          0 :             }
    1802         [ #  # ]:          0 :         }
    1803 [ #  # ][ #  # ]:          0 :         return InitError(ResolveErrMsg("bind", bind_arg));
                 [ #  # ]
    1804         [ #  # ]:          0 :     }
    1805                 :            : 
    1806 [ #  # ][ #  # ]:          0 :     for (const std::string& strBind : args.GetArgs("-whitebind")) {
         [ #  # ][ #  # ]
    1807         [ #  # ]:          0 :         NetWhitebindPermissions whitebind;
    1808                 :          0 :         bilingual_str error;
    1809 [ #  # ][ #  # ]:          0 :         if (!NetWhitebindPermissions::TryParse(strBind, whitebind, error)) return InitError(error);
                 [ #  # ]
    1810         [ #  # ]:          0 :         connOptions.vWhiteBinds.push_back(whitebind);
    1811         [ #  # ]:          0 :     }
    1812                 :            : 
    1813                 :            :     // If the user did not specify -bind= or -whitebind= then we bind
    1814                 :            :     // on any address - 0.0.0.0 (IPv4) and :: (IPv6).
    1815 [ #  # ][ #  # ]:          0 :     connOptions.bind_on_any = args.GetArgs("-bind").empty() && args.GetArgs("-whitebind").empty();
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1816                 :            : 
    1817                 :            :     // Emit a warning if a bad port is given to -port= but only if -bind and -whitebind are not
    1818                 :            :     // given, because if they are, then -port= is ignored.
    1819 [ #  # ][ #  # ]:          0 :     if (connOptions.bind_on_any && args.IsArgSet("-port")) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
    1820 [ #  # ][ #  # ]:          0 :         const uint16_t port_arg = args.GetIntArg("-port", 0);
    1821 [ #  # ][ #  # ]:          0 :         if (IsBadPort(port_arg)) {
    1822 [ #  # ][ #  # ]:          0 :             InitWarning(BadPortWarning("-port", port_arg));
    1823                 :          0 :         }
    1824                 :          0 :     }
    1825                 :            : 
    1826         [ #  # ]:          0 :     CService onion_service_target;
    1827         [ #  # ]:          0 :     if (!connOptions.onion_binds.empty()) {
    1828         [ #  # ]:          0 :         onion_service_target = connOptions.onion_binds.front();
    1829                 :          0 :     } else {
    1830         [ #  # ]:          0 :         onion_service_target = DefaultOnionServiceTarget();
    1831         [ #  # ]:          0 :         connOptions.onion_binds.push_back(onion_service_target);
    1832                 :            :     }
    1833                 :            : 
    1834 [ #  # ][ #  # ]:          0 :     if (args.GetBoolArg("-listenonion", DEFAULT_LISTEN_ONION)) {
                 [ #  # ]
    1835         [ #  # ]:          0 :         if (connOptions.onion_binds.size() > 1) {
    1836 [ #  # ][ #  # ]:          0 :             InitWarning(strprintf(_("More than one onion bind address is provided. Using %s "
                 [ #  # ]
    1837                 :            :                                     "for the automatically created Tor onion service."),
    1838         [ #  # ]:          0 :                                   onion_service_target.ToStringAddrPort()));
    1839                 :          0 :         }
    1840 [ #  # ][ #  # ]:          0 :         StartTorControl(onion_service_target);
    1841                 :          0 :     }
    1842                 :            : 
    1843         [ #  # ]:          0 :     if (connOptions.bind_on_any) {
    1844                 :            :         // Only add all IP addresses of the machine if we would be listening on
    1845                 :            :         // any address - 0.0.0.0 (IPv4) and :: (IPv6).
    1846         [ #  # ]:          0 :         Discover();
    1847                 :          0 :     }
    1848                 :            : 
    1849 [ #  # ][ #  # ]:          0 :     for (const auto& net : args.GetArgs("-whitelist")) {
         [ #  # ][ #  # ]
    1850         [ #  # ]:          0 :         NetWhitelistPermissions subnet;
    1851                 :          0 :         bilingual_str error;
    1852 [ #  # ][ #  # ]:          0 :         if (!NetWhitelistPermissions::TryParse(net, subnet, error)) return InitError(error);
                 [ #  # ]
    1853         [ #  # ]:          0 :         connOptions.vWhitelistedRange.push_back(subnet);
    1854         [ #  # ]:          0 :     }
    1855                 :            : 
    1856 [ #  # ][ #  # ]:          0 :     connOptions.vSeedNodes = args.GetArgs("-seednode");
    1857                 :            : 
    1858                 :            :     // Initiate outbound connections unless connect=0
    1859 [ #  # ][ #  # ]:          0 :     connOptions.m_use_addrman_outgoing = !args.IsArgSet("-connect");
    1860         [ #  # ]:          0 :     if (!connOptions.m_use_addrman_outgoing) {
    1861 [ #  # ][ #  # ]:          0 :         const auto connect = args.GetArgs("-connect");
    1862 [ #  # ][ #  # ]:          0 :         if (connect.size() != 1 || connect[0] != "0") {
                 [ #  # ]
    1863         [ #  # ]:          0 :             connOptions.m_specified_outgoing = connect;
    1864                 :          0 :         }
    1865 [ #  # ][ #  # ]:          0 :         if (!connOptions.m_specified_outgoing.empty() && !connOptions.vSeedNodes.empty()) {
    1866 [ #  # ][ #  # ]:          0 :             LogPrintf("-seednode is ignored when -connect is used\n");
                 [ #  # ]
    1867                 :          0 :         }
    1868                 :            : 
    1869 [ #  # ][ #  # ]:          0 :         if (args.IsArgSet("-dnsseed") && args.GetBoolArg("-dnsseed", DEFAULT_DNSSEED) && args.IsArgSet("-proxy")) {
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
    1870 [ #  # ][ #  # ]:          0 :             LogPrintf("-dnsseed is ignored when -connect is used and -proxy is specified\n");
                 [ #  # ]
    1871                 :          0 :         }
    1872                 :          0 :     }
    1873                 :            : 
    1874 [ #  # ][ #  # ]:          0 :     const std::string& i2psam_arg = args.GetArg("-i2psam", "");
                 [ #  # ]
    1875         [ #  # ]:          0 :     if (!i2psam_arg.empty()) {
    1876 [ #  # ][ #  # ]:          0 :         const std::optional<CService> addr{Lookup(i2psam_arg, 7656, fNameLookup)};
    1877 [ #  # ][ #  # ]:          0 :         if (!addr.has_value() || !addr->IsValid()) {
                 [ #  # ]
    1878 [ #  # ][ #  # ]:          0 :             return InitError(strprintf(_("Invalid -i2psam address or hostname: '%s'"), i2psam_arg));
                 [ #  # ]
    1879                 :            :         }
    1880 [ #  # ][ #  # ]:          0 :         SetProxy(NET_I2P, Proxy{addr.value()});
                 [ #  # ]
    1881         [ #  # ]:          0 :     } else {
    1882 [ #  # ][ #  # ]:          0 :         if (args.IsArgSet("-onlynet") && g_reachable_nets.Contains(NET_I2P)) {
         [ #  # ][ #  # ]
                 [ #  # ]
    1883         [ #  # ]:          0 :             return InitError(
    1884         [ #  # ]:          0 :                 _("Outbound connections restricted to i2p (-onlynet=i2p) but "
    1885                 :            :                   "-i2psam is not provided"));
    1886                 :            :         }
    1887         [ #  # ]:          0 :         g_reachable_nets.Remove(NET_I2P);
    1888                 :            :     }
    1889                 :            : 
    1890 [ #  # ][ #  # ]:          0 :     connOptions.m_i2p_accept_incoming = args.GetBoolArg("-i2pacceptincoming", DEFAULT_I2P_ACCEPT_INCOMING);
    1891                 :            : 
    1892 [ #  # ][ #  # ]:          0 :     if (!node.connman->Start(*node.scheduler, connOptions)) {
    1893                 :          0 :         return false;
    1894                 :            :     }
    1895                 :            : 
    1896                 :            :     // ********************************************************* Step 13: finished
    1897                 :            : 
    1898                 :            :     // At this point, the RPC is "started", but still in warmup, which means it
    1899                 :            :     // cannot yet be called. Before we make it callable, we need to make sure
    1900                 :            :     // that the RPC's view of the best block is valid and consistent with
    1901                 :            :     // ChainstateManager's active tip.
    1902                 :            :     //
    1903                 :            :     // If we do not do this, RPC's view of the best block will be height=0 and
    1904                 :            :     // hash=0x0. This will lead to erroroneous responses for things like
    1905                 :            :     // waitforblockheight.
    1906 [ #  # ][ #  # ]:          0 :     RPCNotifyBlockChange(WITH_LOCK(chainman.GetMutex(), return chainman.ActiveTip()));
         [ #  # ][ #  # ]
                 [ #  # ]
    1907         [ #  # ]:          0 :     SetRPCWarmupFinished();
    1908                 :            : 
    1909 [ #  # ][ #  # ]:          0 :     uiInterface.InitMessage(_("Done loading").translated);
    1910                 :            : 
    1911         [ #  # ]:          0 :     for (const auto& client : node.chain_clients) {
    1912         [ #  # ]:          0 :         client->start(*node.scheduler);
    1913                 :            :     }
    1914                 :            : 
    1915                 :          0 :     BanMan* banman = node.banman.get();
    1916         [ #  # ]:          0 :     node.scheduler->scheduleEvery([banman]{
    1917                 :          0 :         banman->DumpBanlist();
    1918         [ #  # ]:          0 :     }, DUMP_BANS_INTERVAL);
    1919                 :            : 
    1920 [ #  # ][ #  # ]:          0 :     if (node.peerman) node.peerman->StartScheduledTasks(*node.scheduler);
    1921                 :            : 
    1922                 :            : #if HAVE_SYSTEM
    1923         [ #  # ]:          0 :     StartupNotify(args);
    1924                 :            : #endif
    1925                 :            : 
    1926                 :          0 :     return true;
    1927                 :          0 : }
    1928                 :            : 
    1929                 :          0 : bool StartIndexBackgroundSync(NodeContext& node)
    1930                 :            : {
    1931                 :            :     // Find the oldest block among all indexes.
    1932                 :            :     // This block is used to verify that we have the required blocks' data stored on disk,
    1933                 :            :     // starting from that point up to the current tip.
    1934                 :            :     // indexes_start_block='nullptr' means "start from height 0".
    1935                 :          0 :     std::optional<const CBlockIndex*> indexes_start_block;
    1936                 :          0 :     std::string older_index_name;
    1937         [ #  # ]:          0 :     ChainstateManager& chainman = *Assert(node.chainman);
    1938 [ #  # ][ #  # ]:          0 :     const Chainstate& chainstate = WITH_LOCK(::cs_main, return chainman.GetChainstateForIndexing());
                 [ #  # ]
    1939                 :          0 :     const CChain& index_chain = chainstate.m_chain;
    1940                 :            : 
    1941         [ #  # ]:          0 :     for (auto index : node.indexes) {
    1942         [ #  # ]:          0 :         const IndexSummary& summary = index->GetSummary();
    1943         [ #  # ]:          0 :         if (summary.synced) continue;
    1944                 :            : 
    1945                 :            :         // Get the last common block between the index best block and the active chain
    1946 [ #  # ][ #  # ]:          0 :         LOCK(::cs_main);
    1947         [ #  # ]:          0 :         const CBlockIndex* pindex = chainman.m_blockman.LookupBlockIndex(summary.best_block_hash);
    1948 [ #  # ][ #  # ]:          0 :         if (!index_chain.Contains(pindex)) {
    1949         [ #  # ]:          0 :             pindex = index_chain.FindFork(pindex);
    1950                 :          0 :         }
    1951                 :            : 
    1952 [ #  # ][ #  # ]:          0 :         if (!indexes_start_block || !pindex || pindex->nHeight < indexes_start_block.value()->nHeight) {
         [ #  # ][ #  # ]
    1953                 :          0 :             indexes_start_block = pindex;
    1954         [ #  # ]:          0 :             older_index_name = summary.name;
    1955         [ #  # ]:          0 :             if (!pindex) break; // Starting from genesis so no need to look for earlier block.
    1956                 :          0 :         }
    1957   [ #  #  #  # ]:          0 :     };
    1958                 :            : 
    1959                 :            :     // Verify all blocks needed to sync to current tip are present.
    1960         [ #  # ]:          0 :     if (indexes_start_block) {
    1961 [ #  # ][ #  # ]:          0 :         LOCK(::cs_main);
    1962                 :          0 :         const CBlockIndex* start_block = *indexes_start_block;
    1963 [ #  # ][ #  # ]:          0 :         if (!start_block) start_block = chainman.ActiveChain().Genesis();
                 [ #  # ]
    1964 [ #  # ][ #  # ]:          0 :         if (!chainman.m_blockman.CheckBlockDataAvailability(*index_chain.Tip(), *Assert(start_block))) {
         [ #  # ][ #  # ]
    1965 [ #  # ][ #  # ]:          0 :             return InitError(strprintf(Untranslated("%s best block of the index goes beyond pruned data. Please disable the index or reindex (which will download the whole blockchain again)"), older_index_name));
         [ #  # ][ #  # ]
    1966                 :            :         }
    1967         [ #  # ]:          0 :     }
    1968                 :            : 
    1969                 :            :     // Start threads
    1970 [ #  # ][ #  # ]:          0 :     for (auto index : node.indexes) if (!index->StartBackgroundSync()) return false;
                 [ #  # ]
    1971                 :          0 :     return true;
    1972                 :          0 : }

Generated by: LCOV version 1.14