Coverage Report

Created: 2026-10-19 15:22

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/tmp/bitcoin/src/init.cpp
Line
Count
Source
1
// Copyright (c) 2009-2010 Satoshi Nakamoto
2
// Copyright (c) 2009-present 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
#include <bitcoin-build-config.h> // IWYU pragma: keep
7
8
#include <init.h>
9
10
#include <addrdb.h>
11
#include <addrman.h>
12
#include <banman.h>
13
#include <blockfilter.h>
14
#include <chain.h>
15
#include <chainparams.h>
16
#include <chainparamsbase.h>
17
#include <clientversion.h>
18
#include <common/args.h>
19
#include <common/messages.h>
20
#include <common/system.h>
21
#include <compat/compat.h>
22
#include <consensus/params.h>
23
#include <crypto/hex_base.h>
24
#include <dbwrapper.h>
25
#include <httprpc.h>
26
#include <httpserver.h>
27
#include <index/base.h>
28
#include <index/blockfilterindex.h>
29
#include <index/coinstatsindex.h>
30
#include <index/txindex.h>
31
#include <index/txospenderindex.h>
32
#include <init/common.h>
33
#include <interfaces/chain.h>
34
#include <interfaces/init.h>
35
#include <interfaces/ipc.h>
36
#include <interfaces/node.h>
37
#include <ipc/exception.h>
38
#include <ipc/types.h>
39
#include <kernel/blockmanager_opts.h>
40
#include <kernel/caches.h>
41
#include <kernel/chainstatemanager_opts.h>
42
#include <kernel/checks.h>
43
#include <kernel/context.h>
44
#include <kernel/notifications_interface.h>
45
#include <key.h>
46
#include <logging.h>
47
#include <mapport.h>
48
#include <net.h>
49
#include <net_permissions.h>
50
#include <net_processing.h>
51
#include <netaddress.h>
52
#include <netbase.h>
53
#include <netgroup.h>
54
#include <node/block_template_manager.h>
55
#include <node/blockmanager_args.h>
56
#include <node/blockstorage.h>
57
#include <node/caches.h>
58
#include <node/chainstate.h>
59
#include <node/chainstatemanager_args.h>
60
#include <node/context.h>
61
#include <node/interface_ui.h>
62
#include <node/kernel_notifications.h>
63
#include <node/mempool_args.h>
64
#include <node/mempool_persist.h>
65
#include <node/mempool_persist_args.h>
66
#include <node/mining_args.h>
67
#include <node/peerman_args.h>
68
#include <policy/feerate.h>
69
#include <policy/fees/block_policy_estimator.h>
70
#include <policy/fees/estimator_args.h>
71
#include <policy/fees/estimator_man.h>
72
#include <policy/policy.h>
73
#include <policy/settings.h>
74
#include <protocol.h>
75
#include <random.h>
76
#include <rpc/register.h>
77
#include <rpc/server.h>
78
#include <rpc/util.h>
79
#include <scheduler.h>
80
#include <script/sigcache.h>
81
#include <sync.h>
82
#include <tinyformat.h>
83
#include <torcontrol.h>
84
#include <txgraph.h>
85
#include <txmempool.h>
86
#include <uint256.h>
87
#include <util/asmap.h>
88
#include <util/batchpriority.h>
89
#include <util/btcsignals.h>
90
#include <util/byte_units.h>
91
#include <util/chaintype.h>
92
#include <util/check.h>
93
#include <util/fs.h>
94
#include <util/fs_helpers.h>
95
#include <util/moneystr.h>
96
#include <util/overflow.h>
97
#include <util/result.h>
98
#include <util/signalinterrupt.h>
99
#include <util/strencodings.h>
100
#include <util/string.h>
101
#include <util/syserror.h>
102
#include <util/thread.h>
103
#include <util/threadnames.h>
104
#include <util/time.h>
105
#include <util/translation.h>
106
#include <validation.h>
107
#include <validationinterface.h>
108
#include <walletinitinterface.h>
109
110
#include <algorithm>
111
#include <any>
112
#include <cerrno>
113
#include <condition_variable>
114
#include <cstddef>
115
#include <cstdint>
116
#include <exception>
117
#include <fstream>
118
#include <functional>
119
#include <limits>
120
#include <list>
121
#include <memory>
122
#include <new>
123
#include <optional>
124
#include <set>
125
#include <span>
126
#include <string>
127
#include <system_error>
128
#include <thread>
129
#include <tuple>
130
#include <utility>
131
#include <vector>
132
133
#ifndef WIN32
134
#include <csignal>
135
#endif
136
137
#ifdef ENABLE_ZMQ
138
#include <zmq/zmqabstractnotifier.h>
139
#include <zmq/zmqnotificationinterface.h>
140
#include <zmq/zmqrpc.h>
141
#endif
142
143
#ifdef ENABLE_EMBEDDED_ASMAP
144
#include <node/data/ip_asn.dat.h>
145
#endif
146
147
using common::InvalidPortErrMsg;
148
using common::ResolveErrMsg;
149
150
using node::ApplyArgsManOptions;
151
using node::BlockManager;
152
using node::CalculateCacheSizes;
153
using node::ChainstateLoadResult;
154
using node::ChainstateLoadStatus;
155
using node::DEFAULT_PERSIST_MEMPOOL;
156
using node::DEFAULT_PRINT_MODIFIED_FEE;
157
using node::DEFAULT_STOPATHEIGHT;
158
using node::DumpMempool;
159
using node::ImportBlocks;
160
using node::KernelNotifications;
161
using node::LoadChainstate;
162
using node::LoadMempool;
163
using node::MempoolPath;
164
using node::NodeContext;
165
using node::ShouldPersistMempool;
166
using node::VerifyLoadedChainstate;
167
using util::Join;
168
using util::ReplaceAll;
169
using util::ToString;
170
using util::TrimStringView;
171
172
static constexpr bool DEFAULT_PROXYRANDOMIZE{true};
173
static constexpr bool DEFAULT_REST_ENABLE{false};
174
static constexpr bool DEFAULT_I2P_ACCEPT_INCOMING{true};
175
static constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT{false};
176
177
#ifdef WIN32
178
// Win32 LevelDB doesn't use filedescriptors, and the ones used for
179
// accessing block files don't count towards the fd_set size limit
180
// anyway.
181
#define MIN_LEVELDB_FDS 0
182
#else
183
#define MIN_LEVELDB_FDS 150
184
#endif
185
186
static constexpr int MIN_CORE_FDS = MIN_LEVELDB_FDS + NUM_FDS_MESSAGE_CAPTURE;
187
188
/**
189
 * The PID file facilities.
190
 */
191
static const char* BITCOIN_PID_FILENAME = "bitcoind.pid";
192
/**
193
 * True if this process has created a PID file.
194
 * Used to determine whether we should remove the PID file on shutdown.
195
 */
196
static bool g_generated_pid{false};
197
198
static fs::path GetPidFile(const ArgsManager& args)
199
2.45k
{
200
2.45k
    return AbsPathForConfigVal(args, args.GetPathArg("-pid", BITCOIN_PID_FILENAME));
201
2.45k
}
202
203
[[nodiscard]] static bool CreatePidFile(const ArgsManager& args)
204
1.22k
{
205
1.22k
    if (args.IsArgNegated("-pid")) return true;
206
207
1.22k
    std::ofstream file{GetPidFile(args).std_path()};
208
1.22k
    if (file) {
209
#ifdef WIN32
210
        tfm::format(file, "%d\n", GetCurrentProcessId());
211
#else
212
1.22k
        tfm::format(file, "%d\n", getpid());
213
1.22k
#endif
214
1.22k
        g_generated_pid = true;
215
1.22k
        return true;
216
1.22k
    } else {
217
0
        return InitError(strprintf(_("Unable to create the PID file '%s': %s"), fs::PathToString(GetPidFile(args)), SysErrorString(errno)));
218
0
    }
219
1.22k
}
220
221
static void RemovePidFile(const ArgsManager& args)
222
1.25k
{
223
1.25k
    if (!g_generated_pid) return;
224
1.22k
    const auto pid_path{GetPidFile(args)};
225
1.22k
    if (std::error_code error; !fs::remove(pid_path, error)) {
226
0
        std::string msg{error ? error.message() : "File does not exist"};
227
0
        LogWarning("Unable to remove PID file (%s): %s", fs::PathToString(pid_path), msg);
228
0
    }
229
1.22k
}
230
231
static std::optional<util::SignalInterrupt> g_shutdown;
232
233
void InitContext(NodeContext& node)
234
1.29k
{
235
1.29k
    assert(!g_shutdown);
236
1.29k
    g_shutdown.emplace();
237
238
1.29k
    node.args = &gArgs;
239
1.29k
    node.shutdown_signal = &*g_shutdown;
240
1.29k
    node.shutdown_request = [&node] {
241
1.07k
        assert(node.shutdown_signal);
242
1.07k
        if (!(*node.shutdown_signal)()) return false;
243
1.07k
        return true;
244
1.07k
    };
245
1.29k
}
246
247
//////////////////////////////////////////////////////////////////////////////
248
//
249
// Shutdown
250
//
251
252
//
253
// Thread management and startup/shutdown:
254
//
255
// The network-processing threads are all part of a thread group
256
// created by AppInit() or the Qt main() function.
257
//
258
// A clean exit happens when the SignalInterrupt object is triggered, which
259
// makes the main thread's SignalInterrupt::wait() call return, and join all
260
// other ongoing threads in the thread group to the main thread.
261
// Shutdown() is then called to clean up database connections, and stop other
262
// threads that should only be stopped after the main network-processing
263
// threads have exited.
264
//
265
// Shutdown for Qt is very similar, only it uses a QTimer to detect
266
// ShutdownRequested() getting set, and then does the normal Qt
267
// shutdown thing.
268
//
269
270
bool ShutdownRequested(node::NodeContext& node)
271
85.4k
{
272
85.4k
    return bool{*Assert(node.shutdown_signal)};
273
85.4k
}
274
275
#if HAVE_SYSTEM
276
static void ShutdownNotify(const ArgsManager& args)
277
1.25k
{
278
1.25k
    std::vector<std::thread> threads;
279
1.25k
    for (const auto& cmd : args.GetArgs("-shutdownnotify")) {
280
1
        threads.emplace_back(runCommand, cmd);
281
1
    }
282
1.25k
    for (auto& t : threads) {
283
1
        t.join();
284
1
    }
285
1.25k
}
286
#endif
287
288
void Interrupt(NodeContext& node)
289
1.25k
{
290
1.25k
#if HAVE_SYSTEM
291
1.25k
    ShutdownNotify(*node.args);
292
1.25k
#endif
293
    // Wake any threads that may be waiting for the tip to change.
294
1.25k
    if (node.notifications) WITH_LOCK(node.notifications->m_tip_block_mutex, node.notifications->m_tip_block_cv.notify_all());
295
1.25k
    InterruptHTTPServer();
296
1.25k
    InterruptHTTPRPC();
297
1.25k
    InterruptRPC();
298
1.25k
    InterruptREST();
299
1.25k
    if (node.tor_controller) {
300
9
        node.tor_controller->Interrupt();
301
9
    }
302
1.25k
    InterruptMapPort();
303
1.25k
    if (node.connman)
304
1.16k
        node.connman->Interrupt();
305
1.25k
    for (auto* index : node.indexes) {
306
137
        index->Interrupt();
307
137
    }
308
1.25k
}
309
310
void Shutdown(NodeContext& node)
311
1.25k
{
312
1.25k
    static Mutex g_shutdown_mutex;
313
1.25k
    TRY_LOCK(g_shutdown_mutex, lock_shutdown);
314
1.25k
    if (!lock_shutdown) return;
315
1.25k
    LogInfo("Shutdown in progress...");
316
1.25k
    Assert(node.args);
317
318
    /// Note: Shutdown() must be able to handle cases in which initialization failed part of the way,
319
    /// for example if the data directory was found to be locked.
320
    /// Be sure that anything that writes files or flushes caches only does this if the respective
321
    /// module was initialized.
322
1.25k
    util::ThreadRename("shutoff");
323
1.25k
    if (node.mempool) node.mempool->AddTransactionsUpdated(1);
324
325
1.25k
    StopHTTPRPC();
326
1.25k
    StopREST();
327
1.25k
    StopRPC();
328
1.25k
    StopHTTPServer();
329
1.25k
    for (auto& client : node.chain_clients) {
330
430
        try {
331
430
            client->stop();
332
430
        } catch (const ipc::Exception& e) {
333
0
            LogDebug(BCLog::IPC, "Chain client did not disconnect cleanly: %s", e.what());
334
0
            client.reset();
335
0
        }
336
430
    }
337
1.25k
    StopMapPort();
338
339
    // Because these depend on each-other, we make sure that neither can be
340
    // using the other before destroying them.
341
1.25k
    if (node.peerman && node.validation_signals) node.validation_signals->UnregisterValidationInterface(node.peerman.get());
342
1.25k
    if (node.connman) node.connman->Stop();
343
344
1.25k
    if (node.tor_controller) {
345
9
        node.tor_controller->Join();
346
9
        node.tor_controller.reset();
347
9
    }
348
349
1.25k
    if (node.background_init_thread.joinable()) node.background_init_thread.join();
350
    // After everything has been shut down, but before things get flushed, stop the
351
    // the scheduler. After this point, SyncWithValidationInterfaceQueue() should not be called anymore
352
    // as this would prevent the shutdown from completing.
353
1.25k
    if (node.scheduler) node.scheduler->stop();
354
355
    // After the threads that potentially access these pointers have been stopped,
356
    // destruct and reset all to nullptr.
357
1.25k
    node.peerman.reset();
358
1.25k
    node.connman.reset();
359
1.25k
    node.banman.reset();
360
1.25k
    node.addrman.reset();
361
1.25k
    node.netgroupman.reset();
362
363
1.25k
    if (node.mempool && node.mempool->GetLoadTried() && ShouldPersistMempool(*node.args)) {
364
1.02k
        DumpMempool(*node.mempool, MempoolPath(*node.args));
365
1.02k
    }
366
367
    // FlushStateToDisk generates a ChainStateFlushed callback, which we should avoid missing
368
1.25k
    if (node.chainman) {
369
1.14k
        LOCK(cs_main);
370
1.15k
        for (const auto& chainstate : node.chainman->m_chainstates) {
371
1.15k
            if (chainstate->CanFlushToDisk()) {
372
1.14k
                chainstate->ForceFlushStateToDisk();
373
1.14k
            }
374
1.15k
        }
375
1.14k
    }
376
377
    // After there are no more peers/RPC left to give us new data which may generate
378
    // CValidationInterface callbacks, flush them...
379
1.25k
    if (node.validation_signals) node.validation_signals->FlushBackgroundCallbacks();
380
381
    // Once callbacks drain, drop tracked transactions, save estimates, and unregister the estimator
382
1.25k
    if (node.fee_estimator_man) {
383
1.11k
        node.fee_estimator_man->ShutdownFlush();
384
1.11k
        if (node.validation_signals) {
385
1.11k
            node.validation_signals->UnregisterValidationInterface(node.fee_estimator_man.get());
386
1.11k
        }
387
1.11k
    }
388
389
    // Stop and delete all indexes only after flushing background callbacks.
390
1.25k
    for (auto* index : node.indexes) index->Stop();
391
1.25k
    if (g_txindex) g_txindex.reset();
392
1.25k
    if (g_txospenderindex) g_txospenderindex.reset();
393
1.25k
    if (g_coin_stats_index) g_coin_stats_index.reset();
394
1.25k
    DestroyAllBlockFilterIndexes();
395
1.25k
    node.indexes.clear(); // all instances are nullptr now
396
397
    // Callbacks queued by this final chainstate flush will not run during shutdown
398
1.25k
    if (node.chainman) {
399
1.14k
        LOCK(cs_main);
400
1.15k
        for (const auto& chainstate : node.chainman->m_chainstates) {
401
1.15k
            if (chainstate->CanFlushToDisk()) {
402
1.14k
                chainstate->ForceFlushStateToDisk();
403
1.14k
                chainstate->ResetCoinsViews();
404
1.14k
            }
405
1.15k
        }
406
1.14k
    }
407
408
    // If any -ipcbind clients are still connected, disconnect them now so they
409
    // do not block shutdown.
410
1.25k
    if (interfaces::Ipc* ipc = node.init->ipc()) {
411
17
        ipc->disconnectIncoming();
412
17
    }
413
414
#ifdef ENABLE_ZMQ
415
    if (g_zmq_notification_interface) {
416
        if (node.validation_signals) node.validation_signals->UnregisterValidationInterface(g_zmq_notification_interface.get());
417
        g_zmq_notification_interface.reset();
418
    }
419
#endif
420
421
1.25k
    node.chain_clients.clear();
422
1.25k
    if (node.validation_signals) {
423
1.22k
        node.validation_signals->UnregisterAllValidationInterfaces();
424
1.22k
    }
425
1.25k
    node.fee_estimator_man.reset();
426
1.25k
    node.block_template_manager.reset();
427
1.25k
    node.mempool.reset();
428
1.25k
    node.chainman.reset();
429
1.25k
    node.validation_signals.reset();
430
1.25k
    node.scheduler.reset();
431
1.25k
    node.ecc_context.reset();
432
1.25k
    node.kernel.reset();
433
434
1.25k
    RemovePidFile(*node.args);
435
436
1.25k
    LogInfo("Shutdown done");
437
1.25k
}
438
439
/**
440
 * Signal handlers are very limited in what they are allowed to do.
441
 * The execution context the handler is invoked in is not guaranteed,
442
 * so we restrict handler operations to just touching variables:
443
 */
444
#ifndef WIN32
445
static void HandleSIGTERM(int)
446
24
{
447
    // Return value is intentionally ignored because there is not a better way
448
    // of handling this failure in a signal handler.
449
24
    (void)(*Assert(g_shutdown))();
450
24
}
451
452
static void HandleSIGHUP(int)
453
0
{
454
0
    LogInstance().m_reopen_file = true;
455
0
}
456
#else
457
static BOOL WINAPI consoleCtrlHandler(DWORD dwCtrlType)
458
{
459
    if (!(*Assert(g_shutdown))()) {
460
        LogError("Failed to send shutdown signal on Ctrl-C\n");
461
        return false;
462
    }
463
    Sleep(INFINITE);
464
    return true;
465
}
466
#endif
467
468
#ifndef WIN32
469
static void registerSignalHandler(int signal, void(*handler)(int))
470
3.76k
{
471
3.76k
    struct sigaction sa;
472
3.76k
    sa.sa_handler = handler;
473
3.76k
    sigemptyset(&sa.sa_mask);
474
3.76k
    sa.sa_flags = 0;
475
3.76k
    sigaction(signal, &sa, nullptr);
476
3.76k
}
477
#endif
478
479
void SetupServerArgs(ArgsManager& argsman, bool can_listen_ipc)
480
2.07k
{
481
2.07k
    SetupHelpOptions(argsman);
482
2.07k
    argsman.AddArg("-help-debug", "Print help message with debugging options and exit", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST); // server-only for now
483
484
2.07k
    init::AddLoggingArgs(argsman);
485
486
2.07k
    const auto defaultBaseParams = CreateBaseChainParams(argsman, ChainType::MAIN);
487
2.07k
    const auto testnetBaseParams = CreateBaseChainParams(argsman, ChainType::TESTNET);
488
2.07k
    const auto testnet4BaseParams = CreateBaseChainParams(argsman, ChainType::TESTNET4);
489
2.07k
    const auto signetBaseParams = CreateBaseChainParams(argsman, ChainType::SIGNET);
490
2.07k
    const auto regtestBaseParams = CreateBaseChainParams(argsman, ChainType::REGTEST);
491
2.07k
    const auto defaultChainParams = CreateChainParams(argsman, ChainType::MAIN);
492
2.07k
    const auto testnetChainParams = CreateChainParams(argsman, ChainType::TESTNET);
493
2.07k
    const auto testnet4ChainParams = CreateChainParams(argsman, ChainType::TESTNET4);
494
2.07k
    const auto signetChainParams = CreateChainParams(argsman, ChainType::SIGNET);
495
2.07k
    const auto regtestChainParams = CreateChainParams(argsman, ChainType::REGTEST);
496
497
    // Hidden Options
498
2.07k
    std::vector<std::string> hidden_args = {
499
2.07k
        "-dbcrashratio", "-forcecompactdb",
500
        // GUI args. These will be overwritten by SetupUIArgs for the GUI
501
2.07k
        "-choosedatadir", "-lang=<lang>", "-min", "-resetguisettings", "-splash", "-uiplatform"};
502
503
2.07k
    argsman.AddArg("-version", "Print version and exit", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
504
2.07k
#if HAVE_SYSTEM
505
2.07k
    argsman.AddArg("-alertnotify=<cmd>", "Execute command when an alert is raised (%s in cmd is replaced by message)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
506
2.07k
#endif
507
2.07k
    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, testnet3: %s, testnet4: %s, signet: %s)", defaultChainParams->GetConsensus().defaultAssumeValid.GetHex(), testnetChainParams->GetConsensus().defaultAssumeValid.GetHex(), testnet4ChainParams->GetConsensus().defaultAssumeValid.GetHex(), signetChainParams->GetConsensus().defaultAssumeValid.GetHex()), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
508
2.07k
    argsman.AddArg("-blocksdir=<dir>", "Specify directory to hold blocks subdirectory for *.dat files (default: <datadir>)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
509
2.07k
    argsman.AddArg("-blocksxor",
510
2.07k
                   strprintf("Whether an XOR-key applies to blocksdir *.dat files. "
511
2.07k
                             "The created XOR-key will be zeros for an existing blocksdir or when `-blocksxor=0` is "
512
2.07k
                             "set, and random for a freshly initialized blocksdir. "
513
2.07k
                             "(default: %u)",
514
2.07k
                             kernel::DEFAULT_XOR_BLOCKSDIR),
515
2.07k
                   ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
516
2.07k
    argsman.AddArg("-fastprune", "Use smaller block files and lower minimum prune height for testing purposes", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
517
2.07k
#if HAVE_SYSTEM
518
2.07k
    argsman.AddArg("-blocknotify=<cmd>", "Execute command when the best block changes (%s in cmd is replaced by block hash). Not run for blocks connected during initial block download or reindexing.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
519
2.07k
#endif
520
2.07k
    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);
521
2.07k
    argsman.AddArg("-blocksonly", strprintf("Whether to reject transactions from network peers. Disables automatic broadcast and rebroadcast of transactions, unless the source peer has the 'forcerelay' permission. RPC transactions are not affected. (default: %u)", DEFAULT_BLOCKSONLY), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
522
2.07k
    argsman.AddArg("-coinstatsindex", strprintf("Maintain coinstats index used by the gettxoutsetinfo RPC (default: %u)", DEFAULT_COINSTATSINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
523
2.07k
    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);
524
2.07k
    argsman.AddArg("-datadir=<dir>", "Specify data directory", ArgsManager::ALLOW_ANY | ArgsManager::DISALLOW_NEGATION, OptionsCategory::OPTIONS);
525
2.07k
    argsman.AddArg("-dbbatchsize", strprintf("Maximum database write batch size in bytes (default: %u)", DEFAULT_DB_CACHE_BATCH), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::OPTIONS);
526
2.07k
    argsman.AddArg("-dbcache=<n>", strprintf("Maximum database cache size <n> MiB (minimum %d, default: %d). Make sure you have enough RAM. In addition, unused memory allocated to the mempool is shared with this cache (see -maxmempool).", MIN_DBCACHE_BYTES / 1_MiB, node::GetDefaultDBCache() / 1_MiB), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
527
2.07k
    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);
528
2.07k
    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);
529
2.07k
    argsman.AddArg("-loadblock=<file>", "Imports blocks from an external file on startup. Obfuscated blocks are not supported.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
530
2.07k
    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);
531
2.07k
    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);
532
2.07k
    argsman.AddArg("-minimumchainwork=<hex>", strprintf("Minimum work assumed to exist on a valid chain in hex (default: %s, testnet3: %s, testnet4: %s, signet: %s)", defaultChainParams->GetConsensus().nMinimumChainWork.GetHex(), testnetChainParams->GetConsensus().nMinimumChainWork.GetHex(), testnet4ChainParams->GetConsensus().nMinimumChainWork.GetHex(), signetChainParams->GetConsensus().nMinimumChainWork.GetHex()), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::OPTIONS);
533
2.07k
    argsman.AddArg("-par=<n>", strprintf("Set the number of script verification threads (0 = auto, up to %d, <0 = leave that many cores free, default: %d)",
534
2.07k
        MAX_SCRIPTCHECK_THREADS, DEFAULT_SCRIPTCHECK_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
535
2.07k
    argsman.AddArg("-prevoutfetchthreads=<n>", strprintf("Set the number of threads used to prefetch block input prevouts from the chainstate database (0 disables, up to %d, default: %d). Negative values are rejected.", MAX_PREVOUTFETCH_THREADS, DEFAULT_PREVOUTFETCH_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
536
2.07k
    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);
537
2.07k
    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);
538
2.07k
    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. "
539
2.07k
            "Warning: Reverting this setting requires re-downloading the entire blockchain. Wallets and indexes should be loaded at startup and kept active while pruning is enabled so they stay synchronized before old block data is deleted; wallets or indexes that fall behind pruned data may require a reindex. "
540
2.07k
            "(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 / 1_MiB), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
541
2.07k
    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);
542
2.07k
    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);
543
2.07k
    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);
544
2.07k
#if HAVE_SYSTEM
545
2.07k
    argsman.AddArg("-startupnotify=<cmd>", "Execute command on startup.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
546
2.07k
    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);
547
2.07k
#endif
548
2.07k
    argsman.AddArg("-txindex", strprintf("Maintain a full transaction index, used by the getrawtransaction rpc call (default: %u)", DEFAULT_TXINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
549
2.07k
    argsman.AddArg("-txospenderindex", strprintf("Maintain a transaction output spender index, used by the gettxspendingprevout rpc call (default: %u)", DEFAULT_TXOSPENDERINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
550
2.07k
    argsman.AddArg("-blockfilterindex=<type>",
551
2.07k
                 strprintf("Maintain an index of compact filters by block (default: %s, values: %s).", DEFAULT_BLOCKFILTERINDEX, ListBlockFilterTypes()) +
552
2.07k
                 " If <type> is not supplied or if <type> = 1, indexes for all known types are enabled.",
553
2.07k
                 ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
554
555
2.07k
    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);
556
2.07k
    argsman.AddArg("-asmap=<file>", strprintf("Specify asn mapping used for bucketing of the peers. Relative paths will be prefixed by the net-specific datadir location.%s",
557
2.07k
                #ifdef ENABLE_EMBEDDED_ASMAP
558
2.07k
                    " If a bool arg is given (-asmap or -asmap=1), the embedded mapping data in the binary will be used."
559
                #else
560
                    ""
561
                #endif
562
2.07k
                ), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
563
2.07k
    argsman.AddArg("-bantime=<n>", strprintf("Default duration (in seconds) of manually configured bans (default: %u)", DEFAULT_MISBEHAVING_BANTIME), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
564
2.07k
    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, testnet3: 127.0.0.1:%u=onion, testnet4: 127.0.0.1:%u=onion, signet: 127.0.0.1:%u=onion, regtest: 127.0.0.1:%u=onion)", defaultChainParams->GetDefaultPort() + 1, testnetChainParams->GetDefaultPort() + 1, testnet4ChainParams->GetDefaultPort() + 1, signetChainParams->GetDefaultPort() + 1, regtestChainParams->GetDefaultPort() + 1), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::CONNECTION);
565
2.07k
    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);
566
2.07k
    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);
567
2.07k
    argsman.AddArg("-discover", "Discover own IP addresses (default: 1 when listening and no -externalip or -proxy)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
568
2.07k
    argsman.AddArg("-dns", strprintf("Allow DNS lookups for -addnode, -seednode and -connect (default: %u)", DEFAULT_NAME_LOOKUP), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
569
2.07k
    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);
570
2.07k
    argsman.AddArg("-externalip=<ip>", "Specify your own public address", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
571
2.07k
    argsman.AddArg("-fixedseeds", strprintf("Allow fixed seeds if DNS seeds don't provide peers (default: %u)", DEFAULT_FIXEDSEEDS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
572
2.07k
    argsman.AddArg("-forcednsseed", strprintf("Always query for peer addresses via DNS lookup (default: %u)", DEFAULT_FORCEDNSSEED), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
573
2.07k
    argsman.AddArg("-listen", strprintf("Accept connections from outside (default: %u if no -proxy, -connect or -maxconnections=0)", DEFAULT_LISTEN), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
574
2.07k
    argsman.AddArg("-listenonion", strprintf("Automatically create Tor onion service (default: %d)", DEFAULT_LISTEN_ONION), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
575
2.07k
    argsman.AddArg("-maxconnections=<n>", strprintf("Maintain at most <n> automatic connections to peers (default: %u). %u slots of these are reserved for outgoing connections. See -inboundrelaypercent for more information about limits applied to transaction relay inbound peers. "
576
2.07k
                                                    "This limit does not apply to connections manually added via -addnode or the addnode RPC, which have a separate limit of %u. "
577
2.07k
                                                    "It does not apply to short-lived private broadcast connections either, which have a separate limit of %u.",
578
2.07k
                                                    DEFAULT_MAX_PEER_CONNECTIONS, MAX_OUTBOUND_FULL_RELAY_CONNECTIONS + MAX_BLOCK_RELAY_ONLY_CONNECTIONS + MAX_FEELER_CONNECTIONS, MAX_ADDNODE_CONNECTIONS, MAX_PRIVATE_BROADCAST_CONNECTIONS),
579
2.07k
                   ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
580
2.07k
    argsman.AddArg("-inboundrelaypercent=<n>", strprintf("Permit a maximum percent of inbound connections to relay transactions, to limit memory utilization (0 to 100, default: %u).", DEFAULT_FULL_RELAY_INBOUND_PCT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
581
2.07k
    argsman.AddArg("-maxreceivebuffer=<n>", strprintf("Maximum per-connection receive buffer, <n>*1000 bytes (default: %u)", DEFAULT_MAXRECEIVEBUFFER), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
582
2.07k
    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);
583
2.07k
    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);
584
2.07k
#ifdef HAVE_SOCKADDR_UN
585
2.07k
    argsman.AddArg("-onion=<ip:port|path>", "Use separate SOCKS5 proxy to reach peers via Tor onion services, set -noonion to disable (default: -proxy). May be a local file path prefixed with 'unix:'.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
586
#else
587
    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);
588
#endif
589
2.07k
    argsman.AddArg("-i2psam=<ip:port>", "I2P SAM proxy to reach I2P peers and accept I2P connections", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
590
2.07k
    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);
591
2.07k
    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);
592
2.07k
    argsman.AddArg("-v2transport", strprintf("Support v2 transport (default: %u)", DEFAULT_V2_TRANSPORT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
593
2.07k
    argsman.AddArg("-peerbloomfilters", strprintf("Support filtering of blocks and transaction with bloom filters (default: %u)", DEFAULT_PEERBLOOMFILTERS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
594
2.07k
    argsman.AddArg("-peerblockfilters", strprintf("Serve compact block filters to peers per BIP 157 (default: %u)", DEFAULT_PEERBLOCKFILTERS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
595
2.07k
    argsman.AddArg("-txreconciliation", strprintf("Enable transaction reconciliations per BIP 330 (default: %d)", DEFAULT_TXRECONCILIATION_ENABLE), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::CONNECTION);
596
2.07k
    argsman.AddArg("-port=<port>", strprintf("Listen for connections on <port> (default: %u, testnet3: %u, testnet4: %u, signet: %u, regtest: %u). Not relevant for I2P (see doc/i2p.md). If set to a value x, the default onion listening port will be set to x+1.", defaultChainParams->GetDefaultPort(), testnetChainParams->GetDefaultPort(), testnet4ChainParams->GetDefaultPort(), signetChainParams->GetDefaultPort(), regtestChainParams->GetDefaultPort()), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::CONNECTION);
597
2.07k
    const std::string proxy_doc_for_value =
598
2.07k
#ifdef HAVE_SOCKADDR_UN
599
2.07k
        "<ip>[:<port>]|unix:<path>";
600
#else
601
        "<ip>[:<port>]";
602
#endif
603
2.07k
    const std::string proxy_doc_for_unix_socket =
604
2.07k
#ifdef HAVE_SOCKADDR_UN
605
2.07k
        "May be a local file path prefixed with 'unix:' if the proxy supports it. ";
606
#else
607
        "";
608
#endif
609
2.07k
    argsman.AddArg("-proxy=" + proxy_doc_for_value + "[=<network>]",
610
2.07k
                   "Connect through SOCKS5 proxy, set -noproxy to disable. " +
611
2.07k
                   proxy_doc_for_unix_socket +
612
2.07k
                   "Could end in =network to set the proxy only for that network. " +
613
2.07k
                   "The network can be any of ipv4, ipv6, tor or cjdns. " +
614
2.07k
                   "(default: disabled)",
615
2.07k
                   ArgsManager::ALLOW_ANY | ArgsManager::DISALLOW_ELISION,
616
2.07k
                   OptionsCategory::CONNECTION);
617
2.07k
    argsman.AddArg("-proxyrandomize", strprintf("Randomize credentials for every proxy connection. This enables Tor stream isolation (default: %u)", DEFAULT_PROXYRANDOMIZE), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
618
2.07k
    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. During startup, seednodes will be tried before dnsseeds.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
619
2.07k
    argsman.AddArg("-networkactive", "Enable all P2P network activity (default: 1). Can be changed by the setnetworkactive RPC command", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
620
2.07k
    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);
621
2.07k
    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);
622
2.07k
    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);
623
2.07k
    argsman.AddArg("-torpassword=<pass>", "Tor control port password (default: empty)", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::CONNECTION);
624
2.07k
    argsman.AddArg("-natpmp", strprintf("Use PCP or NAT-PMP to map the listening port (default: %u)", DEFAULT_NATPMP), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
625
2.07k
    argsman.AddArg("-whitebind=<[permissions@]addr>", "Bind to the given address and add permission flags to the peers connecting to it. "
626
2.07k
        "Use [host]:port notation for IPv6. Allowed permissions: " + Join(NET_PERMISSIONS_DOC, ", ") + ". "
627
2.07k
        "Specify multiple permissions separated by commas (default: download,noban,mempool,relay). Can be specified multiple times.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
628
629
2.07k
    argsman.AddArg("-whitelist=<[permissions@]IP address or network>", "Add permission flags to the peers using the given IP address (e.g. 1.2.3.4) or "
630
2.07k
        "CIDR-notated network (e.g. 1.2.3.0/24). Uses the same permissions as "
631
2.07k
        "-whitebind. "
632
2.07k
        "Additional flags \"in\" and \"out\" control whether permissions apply to incoming connections and/or manual (default: incoming only). "
633
2.07k
        "Can be specified multiple times.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);
634
635
2.07k
    g_wallet_init_interface.AddWalletOptions(argsman);
636
637
#ifdef ENABLE_ZMQ
638
    argsman.AddArg("-zmqpubhashblock=<address>", "Enable publish hash block in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
639
    argsman.AddArg("-zmqpubhashtx=<address>", "Enable publish hash transaction in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
640
    argsman.AddArg("-zmqpubrawblock=<address>", "Enable publish raw block in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
641
    argsman.AddArg("-zmqpubrawtx=<address>", "Enable publish raw transaction in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
642
    argsman.AddArg("-zmqpubsequence=<address>", "Enable publish hash block and tx sequence in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
643
    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);
644
    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);
645
    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);
646
    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);
647
    argsman.AddArg("-zmqpubsequencehwm=<n>", strprintf("Set publish hash sequence message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);
648
#else
649
2.07k
    hidden_args.emplace_back("-zmqpubhashblock=<address>");
650
2.07k
    hidden_args.emplace_back("-zmqpubhashtx=<address>");
651
2.07k
    hidden_args.emplace_back("-zmqpubrawblock=<address>");
652
2.07k
    hidden_args.emplace_back("-zmqpubrawtx=<address>");
653
2.07k
    hidden_args.emplace_back("-zmqpubsequence=<n>");
654
2.07k
    hidden_args.emplace_back("-zmqpubhashblockhwm=<n>");
655
2.07k
    hidden_args.emplace_back("-zmqpubhashtxhwm=<n>");
656
2.07k
    hidden_args.emplace_back("-zmqpubrawblockhwm=<n>");
657
2.07k
    hidden_args.emplace_back("-zmqpubrawtxhwm=<n>");
658
2.07k
    hidden_args.emplace_back("-zmqpubsequencehwm=<n>");
659
2.07k
#endif
660
661
2.07k
    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);
662
2.07k
    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);
663
2.07k
    argsman.AddArg("-checkblockindex", strprintf("Do a consistency check for the block tree, chainstate, and other validation data structures every <n> operations. Use 0 to disable. (default: %u, regtest: %u)", defaultChainParams->DefaultConsistencyChecks(), regtestChainParams->DefaultConsistencyChecks()), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
664
2.07k
    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);
665
2.07k
    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);
666
    // Checkpoints were removed. We keep `-checkpoints` as a hidden arg to display a more user friendly error when set.
667
2.07k
    argsman.AddArg("-checkpoints", "", ArgsManager::ALLOW_ANY, OptionsCategory::HIDDEN);
668
2.07k
    argsman.AddArg("-deprecatedrpc=<method>", "Allows deprecated RPC method(s) to be used", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
669
2.07k
    argsman.AddArg("-stopafterblockimport", strprintf("Stop running after importing blocks from disk (default: %u)", DEFAULT_STOPAFTERBLOCKIMPORT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
670
2.07k
    argsman.AddArg("-stopatheight", strprintf("Stop running after reaching the given height in the main chain (default: %u). Blocks after target height may be processed during shutdown.", DEFAULT_STOPATHEIGHT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
671
2.07k
    argsman.AddArg("-limitancestorcount=<n>", strprintf("Deprecated setting to not accept transactions if number of in-mempool ancestors is <n> or more (default: %u); replaced by cluster limits (see -limitclustercount) and only used by wallet for coin selection", DEFAULT_ANCESTOR_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
672
    // Ancestor and descendant size limits were removed. We keep
673
    // -limitancestorsize/-limitdescendantsize as hidden args to display a more
674
    // user friendly error when set.
675
2.07k
    argsman.AddArg("-limitancestorsize", "", ArgsManager::ALLOW_ANY, OptionsCategory::HIDDEN);
676
2.07k
    argsman.AddArg("-limitdescendantsize", "", ArgsManager::ALLOW_ANY, OptionsCategory::HIDDEN);
677
2.07k
    argsman.AddArg("-limitdescendantcount=<n>", strprintf("Deprecated setting to not accept transactions if any ancestor would have <n> or more in-mempool descendants (default: %u); replaced by cluster limits (see -limitclustercount) and only used by wallet for coin selection", DEFAULT_DESCENDANT_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
678
2.07k
    argsman.AddArg("-test=<option>", "Pass a test-only option. Options include : " + Join(TEST_OPTIONS_DOC, ", ") + ".", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
679
2.07k
    argsman.AddArg("-limitclustercount=<n>", strprintf("Do not accept transactions into mempool which are directly or indirectly connected to <n> or more other unconfirmed transactions (default: %u, maximum: %u)", DEFAULT_CLUSTER_LIMIT, MAX_CLUSTER_COUNT_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
680
2.07k
    argsman.AddArg("-limitclustersize=<n>", strprintf("Do not accept transactions whose virtual size with all in-mempool connected transactions exceeds <n> kilobytes (default: %u)", DEFAULT_CLUSTER_SIZE_LIMIT_KVB), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
681
2.07k
    argsman.AddArg("-capturemessages", "Capture all P2P messages to disk", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
682
2.07k
    argsman.AddArg("-mocktime=<n>", "Replace actual time with " + UNIX_EPOCH_TIME + " (default: 0)", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
683
2.07k
    argsman.AddArg("-maxsigcachesize=<n>", strprintf("Limit sum of signature cache and script execution cache sizes to <n> MiB (default: %u)", DEFAULT_VALIDATION_CACHE_BYTES >> 20), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
684
2.07k
    argsman.AddArg("-maxtipage=<n>",
685
2.07k
                   strprintf("Maximum tip age in seconds to consider node in initial block download (default: %u)",
686
2.07k
                             Ticks<std::chrono::seconds>(DEFAULT_MAX_TIP_AGE)),
687
2.07k
                   ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
688
2.07k
    argsman.AddArg("-printpriority", strprintf("Log transaction fee rate in %s/kvB when mining blocks (default: %u)", CURRENCY_UNIT, DEFAULT_PRINT_MODIFIED_FEE), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);
689
2.07k
    argsman.AddArg("-uacomment=<cmt>", "Append comment to the user agent string", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST);
690
691
2.07k
    SetupChainParamsBaseOptions(argsman);
692
693
2.07k
    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);
694
2.07k
    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);
695
2.07k
    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);
696
2.07k
    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);
697
2.07k
    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);
698
2.07k
    argsman.AddArg("-datacarrier", strprintf("Relay and mine data carrier transactions (default: %u)", DEFAULT_ACCEPT_DATACARRIER), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
699
2.07k
    argsman.AddArg("-datacarriersize",
700
2.07k
                   strprintf("Relay and mine transactions whose data-carrying raw scriptPubKeys in aggregate "
701
2.07k
                             "are of this size or less, allowing multiple outputs (default: %u)",
702
2.07k
                             MAX_OP_RETURN_RELAY),
703
2.07k
                   ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
704
2.07k
    argsman.AddArg("-permitbaremultisig", strprintf("Relay transactions creating non-P2SH multisig outputs (default: %u)", DEFAULT_PERMIT_BAREMULTISIG), ArgsManager::ALLOW_ANY,
705
2.07k
                   OptionsCategory::NODE_RELAY);
706
2.07k
    argsman.AddArg("-minrelaytxfee=<amt>", strprintf("Fees (in %s/kvB) smaller than this are considered zero fee for relaying, mining and transaction creation (default: %s)",
707
2.07k
        CURRENCY_UNIT, FormatMoney(DEFAULT_MIN_RELAY_TX_FEE)), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
708
2.07k
    argsman.AddArg("-txsendrate=<n>",
709
2.07k
                   strprintf("Set the maximum ongoing rate for sending transactions to (inbound) peers (default: %u tx/s)",
710
2.07k
                             DEFAULT_TX_SEND_RATE),
711
2.07k
                   ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::NODE_RELAY);
712
2.07k
    argsman.AddArg("-privatebroadcast",
713
2.07k
                   strprintf(
714
2.07k
                       "EXPERIMENTAL: Broadcast transactions submitted via sendrawtransaction RPC using short-lived "
715
2.07k
                       "connections through the Tor or I2P networks, without putting them in the mempool first. "
716
2.07k
                       "This provides best-effort concealment of the transaction's origin. "
717
2.07k
                       "Transactions submitted through the wallet are not affected by this option "
718
2.07k
                       "(default: %u)",
719
2.07k
                   DEFAULT_PRIVATE_BROADCAST),
720
2.07k
                   ArgsManager::ALLOW_ANY,
721
2.07k
                   OptionsCategory::NODE_RELAY);
722
2.07k
    argsman.AddArg("-whitelistforcerelay", strprintf("Add 'forcerelay' permission to whitelisted 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);
723
2.07k
    argsman.AddArg("-whitelistrelay", strprintf("Add 'relay' permission to whitelisted peers with default permissions. This will accept relayed transactions even when not relaying transactions (default: %d)", DEFAULT_WHITELISTRELAY), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);
724
725
726
2.07k
    argsman.AddArg("-blockmaxweight=<n>", strprintf("Set maximum BIP141 block weight (default: %d)", DEFAULT_BLOCK_MAX_WEIGHT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::BLOCK_CREATION);
727
2.07k
    argsman.AddArg("-blockreservedweight=<n>", strprintf("Reserve space for the fixed-size block header plus the largest coinbase transaction the mining software may add to the block. Only affects mining RPC clients, not IPC clients. (default: %d).", DEFAULT_BLOCK_RESERVED_WEIGHT), ArgsManager::ALLOW_ANY, OptionsCategory::BLOCK_CREATION);
728
2.07k
    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);
729
2.07k
    argsman.AddArg("-blockversion=<n>", "Override block version to test forking scenarios", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::BLOCK_CREATION);
730
731
2.07k
    argsman.AddArg("-rest", strprintf("Accept public REST requests (default: %u)", DEFAULT_REST_ENABLE), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
732
2.07k
    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). RFC4193 is allowed only if -cjdnsreachable=0. This option can be specified multiple times", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
733
2.07k
    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);
734
2.07k
    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);
735
2.07k
    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);
736
2.07k
    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);
737
2.07k
    argsman.AddArg("-rpccookieperms=<readable-by>", strprintf("Set permissions on the RPC auth cookie file so that it is readable by [owner|group|all] (default: owner [via umask 0077])"), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
738
2.07k
    argsman.AddArg("-rpcmaxconnections=<n>", strprintf("The maximum number of connected HTTP clients (default: %d)", DEFAULT_MAX_HTTP_CONNECTIONS), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
739
2.07k
    argsman.AddArg("-rpcpassword=<pw>", "Password for JSON-RPC connections", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);
740
2.07k
    argsman.AddArg("-rpcport=<port>", strprintf("Listen for JSON-RPC connections on <port> (default: %u, testnet3: %u, testnet4: %u, signet: %u, regtest: %u)", defaultBaseParams->RPCPort(), testnetBaseParams->RPCPort(), testnet4BaseParams->RPCPort(), signetBaseParams->RPCPort(), regtestBaseParams->RPCPort()), ArgsManager::ALLOW_ANY | ArgsManager::NETWORK_ONLY, OptionsCategory::RPC);
741
2.07k
    argsman.AddArg("-rpcservertimeout=<n>", strprintf("Timeout during HTTP requests (default: %d)", DEFAULT_HTTP_SERVER_TIMEOUT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::RPC);
742
2.07k
    argsman.AddArg("-rpcthreads=<n>", strprintf("Set the number of threads to service RPC calls (default: %d)", DEFAULT_HTTP_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
743
2.07k
    argsman.AddArg("-rpcuser=<user>", "Username for JSON-RPC connections", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);
744
2.07k
    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);
745
2.07k
    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);
746
2.07k
    argsman.AddArg("-rpcworkqueue=<n>", strprintf("Set the maximum depth of the work queue to service RPC calls (default: %d)", DEFAULT_HTTP_WORKQUEUE), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::RPC);
747
2.07k
    argsman.AddArg("-server", "Accept command line and JSON-RPC commands", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);
748
2.07k
    if (can_listen_ipc) {
749
21
        argsman.AddArg("-ipcbind=<address>", strprintf("Bind to Unix socket address and listen for incoming connections. Valid address values are \"unix\" to listen on the default path, <datadir>/node.sock, or \"unix:/custom/path\" to specify a custom path. Append \",max-connections=8\", for example \"unix:/custom/path,max-connections=8\", to limit the number of simultaneous connections on that address (default: %d, maximum: %d). Can be specified multiple times to listen on multiple paths. Default behavior is not to listen on any path. If relative paths are specified, they are interpreted relative to the network data directory. If paths include any parent directory components and the parent directories do not exist, they will be created. Enabling this gives local processes that can access the socket unauthenticated RPC access, so it's important to choose a path with secure permissions if customizing this.",ipc::DEFAULT_MAX_CONNECTIONS, ipc::MAX_CONNECTIONS), ArgsManager::ALLOW_ANY, OptionsCategory::IPC);
750
21
    }
751
752
2.07k
#if HAVE_DECL_FORK
753
2.07k
    argsman.AddArg("-daemon", strprintf("Run in the background as a daemon and accept commands (default: %d)", DEFAULT_DAEMON), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
754
2.07k
    argsman.AddArg("-daemonwait", strprintf("Wait for initialization to be finished before exiting. This implies -daemon (default: %d)", DEFAULT_DAEMONWAIT), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
755
#else
756
    hidden_args.emplace_back("-daemon");
757
    hidden_args.emplace_back("-daemonwait");
758
#endif
759
760
    // Add the hidden options
761
2.07k
    argsman.AddHiddenArgs(hidden_args);
762
2.07k
}
763
764
#if HAVE_SYSTEM
765
static void StartupNotify(const ArgsManager& args)
766
1.08k
{
767
1.08k
    std::string cmd = args.GetArg("-startupnotify", "");
768
1.08k
    if (!cmd.empty()) {
769
1
        std::thread t(runCommand, cmd);
770
1
        t.detach(); // thread runs free
771
1
    }
772
1.08k
}
773
#endif
774
775
static bool AppInitServers(NodeContext& node)
776
1.20k
{
777
1.20k
    const ArgsManager& args = *Assert(node.args);
778
1.20k
    if (!InitHTTPServer()) {
779
1
        return false;
780
1
    }
781
1.20k
    StartRPC();
782
1.20k
    node.rpc_interruption_point = RpcInterruptionPoint;
783
1.20k
    if (!StartHTTPRPC(&node))
784
12
        return false;
785
1.19k
    if (args.GetBoolArg("-rest", DEFAULT_REST_ENABLE)) StartREST(&node);
786
1.19k
    StartHTTPServer();
787
1.19k
    return true;
788
1.20k
}
789
790
// Parameter interaction based on rules
791
void InitParameterInteraction(ArgsManager& args)
792
1.25k
{
793
    // when specifying an explicit binding address, you want to listen on it
794
    // even when -connect or -proxy is specified
795
1.25k
    if (!args.GetArgs("-bind").empty()) {
796
1.21k
        if (args.SoftSetBoolArg("-listen", true))
797
1.21k
            LogInfo("parameter interaction: -bind set -> setting -listen=1\n");
798
1.21k
    }
799
1.25k
    if (!args.GetArgs("-whitebind").empty()) {
800
9
        if (args.SoftSetBoolArg("-listen", true))
801
9
            LogInfo("parameter interaction: -whitebind set -> setting -listen=1\n");
802
9
    }
803
804
1.25k
    if (!args.GetArgs("-connect").empty() || args.IsArgNegated("-connect") || args.GetIntArg("-maxconnections", DEFAULT_MAX_PEER_CONNECTIONS) <= 0) {
805
        // when only connecting to trusted nodes, do not seed via DNS, or listen by default
806
        // do the same when connections are disabled
807
1.21k
        if (args.SoftSetBoolArg("-dnsseed", false))
808
1.21k
            LogInfo("parameter interaction: -connect or -maxconnections=0 set -> setting -dnsseed=0\n");
809
1.21k
        if (args.SoftSetBoolArg("-listen", false))
810
1.21k
            LogInfo("parameter interaction: -connect or -maxconnections=0 set -> setting -listen=0\n");
811
1.21k
    }
812
813
1.25k
    std::string proxy_arg = args.GetArg("-proxy", "");
814
1.25k
    if (proxy_arg != "" && proxy_arg != "0") {
815
        // to protect privacy, do not listen by default if a default proxy server is specified
816
49
        if (args.SoftSetBoolArg("-listen", false))
817
49
            LogInfo("parameter interaction: -proxy set -> setting -listen=0\n");
818
        // to protect privacy, do not map ports when a proxy is set. The user may still specify -listen=1
819
        // to listen locally, so don't rely on this happening through -listen below.
820
49
        if (args.SoftSetBoolArg("-natpmp", false)) {
821
0
            LogInfo("parameter interaction: -proxy set -> setting -natpmp=0\n");
822
0
        }
823
        // to protect privacy, do not discover addresses by default
824
49
        if (args.SoftSetBoolArg("-discover", false))
825
49
            LogInfo("parameter interaction: -proxy set -> setting -discover=0\n");
826
49
    }
827
828
1.25k
    if (!args.GetBoolArg("-listen", DEFAULT_LISTEN)) {
829
        // do not map ports or try to retrieve public IP when not listening (pointless)
830
34
        if (args.SoftSetBoolArg("-natpmp", false)) {
831
0
            LogInfo("parameter interaction: -listen=0 -> setting -natpmp=0\n");
832
0
        }
833
34
        if (args.SoftSetBoolArg("-discover", false))
834
34
            LogInfo("parameter interaction: -listen=0 -> setting -discover=0\n");
835
34
        if (args.SoftSetBoolArg("-listenonion", false))
836
34
            LogInfo("parameter interaction: -listen=0 -> setting -listenonion=0\n");
837
34
        if (args.SoftSetBoolArg("-i2pacceptincoming", false)) {
838
34
            LogInfo("parameter interaction: -listen=0 -> setting -i2pacceptincoming=0\n");
839
34
        }
840
34
    }
841
842
1.25k
    if (!args.GetArgs("-externalip").empty()) {
843
        // if an explicit public IP is specified, do not try to find others
844
13
        if (args.SoftSetBoolArg("-discover", false))
845
13
            LogInfo("parameter interaction: -externalip set -> setting -discover=0\n");
846
13
    }
847
848
1.25k
    if (args.GetBoolArg("-blocksonly", DEFAULT_BLOCKSONLY)) {
849
        // disable whitelistrelay in blocksonly mode
850
7
        if (args.SoftSetBoolArg("-whitelistrelay", false))
851
7
            LogInfo("parameter interaction: -blocksonly=1 -> setting -whitelistrelay=0\n");
852
        // Reduce default mempool size in blocksonly mode to avoid unexpected resource usage
853
7
        if (args.SoftSetArg("-maxmempool", ToString(DEFAULT_BLOCKSONLY_MAX_MEMPOOL_SIZE_MB)))
854
7
            LogInfo("parameter interaction: -blocksonly=1 -> setting -maxmempool=%d\n", DEFAULT_BLOCKSONLY_MAX_MEMPOOL_SIZE_MB);
855
7
    }
856
857
    // Forcing relay from whitelisted hosts implies we will accept relays from them in the first place.
858
1.25k
    if (args.GetBoolArg("-whitelistforcerelay", DEFAULT_WHITELISTFORCERELAY)) {
859
3
        if (args.SoftSetBoolArg("-whitelistrelay", true))
860
3
            LogInfo("parameter interaction: -whitelistforcerelay=1 -> setting -whitelistrelay=1\n");
861
3
    }
862
1.25k
    const auto onlynets = args.GetArgs("-onlynet");
863
1.25k
    if (!onlynets.empty()) {
864
9
        bool clearnet_reachable = std::any_of(onlynets.begin(), onlynets.end(), [](const auto& net) {
865
9
            const auto n = ParseNetwork(net);
866
9
            return n == NET_IPV4 || n == NET_IPV6;
867
9
        });
868
9
        if (!clearnet_reachable && args.SoftSetBoolArg("-dnsseed", false)) {
869
0
            LogInfo("parameter interaction: -onlynet excludes IPv4 and IPv6 -> setting -dnsseed=0\n");
870
0
        }
871
9
    }
872
1.25k
}
873
874
/**
875
 * Initialize global loggers.
876
 *
877
 * Note that this is called very early in the process lifetime, so you should be
878
 * careful about what global state you rely on here.
879
 */
880
void InitLogging(const ArgsManager& args)
881
2.03k
{
882
2.03k
    init::SetLoggingOptions(args);
883
2.03k
    init::LogPackageVersion();
884
2.03k
}
885
886
namespace { // Variables internal to initialization process only
887
888
int num_p2p_max_connections;
889
int available_fds;
890
ServiceFlags g_local_services = ServiceFlags(NODE_NETWORK_LIMITED | NODE_WITNESS);
891
int64_t peer_connect_timeout;
892
std::set<BlockFilterType> g_enabled_filter_types;
893
894
} // namespace
895
896
[[noreturn]] static void new_handler_terminate()
897
0
{
898
    // Rather than throwing std::bad-alloc if allocation fails, terminate
899
    // immediately to (try to) avoid chain corruption.
900
    // Since logging may itself allocate memory, set the handler directly
901
    // to terminate first.
902
0
    std::set_new_handler(std::terminate);
903
0
    LogError("Out of memory. Terminating.\n");
904
905
    // The log was successful, terminate now.
906
0
    std::terminate();
907
0
};
908
909
bool AppInitBasicSetup(const ArgsManager& args, std::atomic<int>& exit_status)
910
1.25k
{
911
    // ********************************************************* Step 1: setup
912
#ifdef _MSC_VER
913
    // Turn off Microsoft heap dump noise
914
    _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
915
    _CrtSetReportFile(_CRT_WARN, CreateFileA("NUL", GENERIC_WRITE, 0, nullptr, OPEN_EXISTING, 0, 0));
916
    // Disable confusing "helpful" text message on abort, Ctrl-C
917
    _set_abort_behavior(0, _WRITE_ABORT_MSG | _CALL_REPORTFAULT);
918
#endif
919
#ifdef WIN32
920
    // Enable heap terminate-on-corruption
921
    HeapSetInformation(nullptr, HeapEnableTerminationOnCorruption, nullptr, 0);
922
#endif
923
1.25k
    if (!SetupNetworking()) {
924
0
        return InitError(Untranslated("Initializing networking failed."));
925
0
    }
926
927
1.25k
#ifndef WIN32
928
    // Clean shutdown on SIGTERM
929
1.25k
    registerSignalHandler(SIGTERM, HandleSIGTERM);
930
1.25k
    registerSignalHandler(SIGINT, HandleSIGTERM);
931
932
    // Reopen debug.log on SIGHUP
933
1.25k
    registerSignalHandler(SIGHUP, HandleSIGHUP);
934
935
    // Ignore SIGPIPE, otherwise it will bring the daemon down if the client closes unexpectedly
936
1.25k
    signal(SIGPIPE, SIG_IGN);
937
#else
938
    SetConsoleCtrlHandler(consoleCtrlHandler, true);
939
#endif
940
941
1.25k
    std::set_new_handler(new_handler_terminate);
942
943
1.25k
    return true;
944
1.25k
}
945
946
bool AppInitParameterInteraction(const ArgsManager& args)
947
4.03k
{
948
4.03k
    const CChainParams& chainparams = Params();
949
    // ********************************************************* Step 2: parameter interactions
950
951
    // also see: InitParameterInteraction()
952
953
    // We removed checkpoints but keep the option to warn users who still have it in their config.
954
4.03k
    if (args.IsArgSet("-checkpoints")) {
955
0
        InitWarning(_("Option '-checkpoints' is set but checkpoints were removed. This option has no effect."));
956
0
    }
957
4.03k
    if (args.IsArgSet("-limitancestorsize")) {
958
0
        InitWarning(_("Option '-limitancestorsize' is given but ancestor size limits have been replaced with cluster size limits (see -limitclustersize). This option has no effect."));
959
0
    }
960
4.03k
    if (args.IsArgSet("-limitdescendantsize")) {
961
0
        InitWarning(_("Option '-limitdescendantsize' is given but descendant size limits have been replaced with cluster size limits (see -limitclustersize). This option has no effect."));
962
0
    }
963
964
    // Error if network-specific options (-addnode, -connect, etc) are
965
    // specified in default section of config file, but not overridden
966
    // on the command line or in this chain's section of the config file.
967
4.03k
    ChainType chain = args.GetChainType();
968
4.03k
    if (chain == ChainType::SIGNET) {
969
15
        LogInfo("Signet derived magic (message start): %s", HexStr(chainparams.MessageStart()));
970
15
    }
971
4.03k
    bilingual_str errors;
972
4.03k
    for (const auto& arg : args.GetUnsuitableSectionOnlyArgs()) {
973
1
        errors += strprintf(_("Config setting for %s only applied on %s network when in [%s] section."), arg, ChainTypeToString(chain), ChainTypeToString(chain)) + Untranslated("\n");
974
1
    }
975
976
4.03k
    if (!errors.empty()) {
977
1
        return InitError(errors);
978
1
    }
979
980
    // Testnet3 deprecation warning
981
4.03k
    if (chain == ChainType::TESTNET) {
982
2
        LogInfo("Warning: Support for testnet3 is deprecated and will be removed in an upcoming release. Consider switching to testnet4.\n");
983
2
    }
984
985
    // Warn if unrecognized section name are present in the config file.
986
4.03k
    bilingual_str warnings;
987
4.03k
    for (const auto& section : args.GetUnrecognizedSections()) {
988
2
        warnings += Untranslated(strprintf("%s:%i ", section.m_file, section.m_line)) + strprintf(_("Section [%s] is not recognized."), section.m_name) + Untranslated("\n");
989
2
    }
990
991
4.03k
    if (!warnings.empty()) {
992
1
        InitWarning(warnings);
993
1
    }
994
995
4.03k
    if (!fs::is_directory(args.GetBlocksDirPath())) {
996
1
        return InitError(strprintf(_("Specified blocks directory \"%s\" does not exist."), args.GetArg("-blocksdir", "")));
997
1
    }
998
999
    // parse and validate enabled filter types
1000
4.03k
    std::string blockfilterindex_value = args.GetArg("-blockfilterindex", DEFAULT_BLOCKFILTERINDEX);
1001
4.03k
    if (blockfilterindex_value == "" || blockfilterindex_value == "1") {
1002
50
        g_enabled_filter_types = AllBlockFilterTypes();
1003
3.98k
    } else if (blockfilterindex_value != "0") {
1004
1
        const std::vector<std::string> names = args.GetArgs("-blockfilterindex");
1005
1
        for (const auto& name : names) {
1006
1
            BlockFilterType filter_type;
1007
1
            if (!BlockFilterTypeByName(name, filter_type)) {
1008
1
                return InitError(strprintf(_("Unknown -blockfilterindex value %s."), name));
1009
1
            }
1010
0
            g_enabled_filter_types.insert(filter_type);
1011
0
        }
1012
1
    }
1013
1014
    // Signal NODE_P2P_V2 if BIP324 v2 transport is enabled.
1015
4.03k
    if (args.GetBoolArg("-v2transport", DEFAULT_V2_TRANSPORT)) {
1016
834
        g_local_services = ServiceFlags(g_local_services | NODE_P2P_V2);
1017
834
    }
1018
1019
    // Signal NODE_COMPACT_FILTERS if peerblockfilters and basic filters index are both enabled.
1020
4.03k
    if (args.GetBoolArg("-peerblockfilters", DEFAULT_PEERBLOCKFILTERS)) {
1021
2
        if (!g_enabled_filter_types.contains(BlockFilterType::BASIC)) {
1022
1
            return InitError(_("Cannot set -peerblockfilters without -blockfilterindex."));
1023
1
        }
1024
1025
1
        g_local_services = ServiceFlags(g_local_services | NODE_COMPACT_FILTERS);
1026
1
    }
1027
1028
4.03k
    if (args.GetIntArg("-prune", 0)) {
1029
45
        if (args.GetBoolArg("-txindex", DEFAULT_TXINDEX))
1030
0
            return InitError(_("Prune mode is incompatible with -txindex."));
1031
45
        if (args.GetBoolArg("-txospenderindex", DEFAULT_TXOSPENDERINDEX))
1032
0
            return InitError(_("Prune mode is incompatible with -txospenderindex."));
1033
45
        if (args.GetBoolArg("-reindex-chainstate", false)) {
1034
0
            return InitError(_("Prune mode is incompatible with -reindex-chainstate. Use full -reindex instead."));
1035
0
        }
1036
45
    }
1037
1038
    // If -forcednsseed is set to true, ensure -dnsseed has not been set to false
1039
4.03k
    if (args.GetBoolArg("-forcednsseed", DEFAULT_FORCEDNSSEED) && !args.GetBoolArg("-dnsseed", DEFAULT_DNSSEED)){
1040
2
        return InitError(_("Cannot set -forcednsseed to true when setting -dnsseed to false."));
1041
2
    }
1042
1043
    // -bind and -whitebind can't be set when not listening
1044
4.03k
    size_t num_user_p2p_bind = args.GetArgs("-bind").size() + args.GetArgs("-whitebind").size();
1045
4.03k
    if (num_user_p2p_bind != 0 && !args.GetBoolArg("-listen", DEFAULT_LISTEN)) {
1046
1
        return InitError(Untranslated("Cannot set -bind or -whitebind together with -listen=0"));
1047
1
    }
1048
1049
    // if listen=0, then disallow listenonion=1
1050
4.02k
    if (!args.GetBoolArg("-listen", DEFAULT_LISTEN) && args.GetBoolArg("-listenonion", DEFAULT_LISTEN_ONION)) {
1051
0
        return InitError(Untranslated("Cannot set -listen=0 together with -listenonion=1"));
1052
0
    }
1053
1054
    // Make sure enough file descriptors are available. We need to reserve enough FDs to account for the bare minimum,
1055
    // plus all manual connections and all bound interfaces. Any remainder will be available for connection sockets
1056
1057
    // Keep IPC reservations low enough to leave room for core and P2P file descriptor reservations.
1058
4.02k
    constexpr size_t MAX_IPC_FDS{ipc::MAX_CONNECTIONS + 1};
1059
1060
    // Number of bound interfaces (we have at least one)
1061
4.02k
    int num_p2p_bind = std::max(num_user_p2p_bind, size_t(1));
1062
    // Maximum number of connections with other nodes, this accounts for all types of outbounds and inbounds except for manual
1063
4.02k
    int user_p2p_max_connections = args.GetIntArg("-maxconnections", DEFAULT_MAX_PEER_CONNECTIONS);
1064
4.02k
    if (user_p2p_max_connections < 0) {
1065
0
        return InitError(Untranslated("-maxconnections must be greater or equal than zero"));
1066
0
    }
1067
1068
    // Reserve one listening socket per -ipcbind address plus its accepted
1069
    // connection slots. Unlike P2P, IPC has no default listener.
1070
4.02k
    size_t ipc_addresses{0};
1071
4.02k
    size_t ipc_max_connections{0};
1072
4.02k
    for (const std::string& configured_address : args.GetArgs("-ipcbind")) {
1073
19
        auto listen_address{interfaces::Ipc::parseListenAddress(configured_address)};
1074
19
        if (!listen_address) {
1075
2
            return InitError(Untranslated(strprintf("Invalid -ipcbind address '%s': %s", configured_address, util::ErrorString(listen_address).original)));
1076
2
        }
1077
        // Check the aggregate after adding this listener so multiple
1078
        // individually valid -ipcbind values cannot exceed the IPC FD cap.
1079
17
        ipc_addresses += 1;
1080
17
        ipc_max_connections += listen_address->max_connections;
1081
17
    }
1082
    // Actual number of IPC file descriptors to be reserved.
1083
4.02k
    const size_t ipc_fds{ipc_max_connections + ipc_addresses};
1084
1085
4.02k
    if (ipc_fds > MAX_IPC_FDS) {
1086
1
        return InitError(Untranslated(strprintf("Too many IPC file descriptors requested: %d -ipcbind listeners and connection slots exceed the limit of %d. Reduce the number of -ipcbind addresses or their max-connections values", static_cast<int>(ipc_fds), static_cast<int>(MAX_IPC_FDS))));
1087
1
    }
1088
1089
4.02k
    if (ipc_addresses > 0) {
1090
14
        LogInfo("Reserving %d file descriptors for IPC (%d listening sockets, %d connection slots)",
1091
14
                static_cast<int>(ipc_fds),
1092
14
                static_cast<int>(ipc_addresses),
1093
14
                static_cast<int>(ipc_max_connections));
1094
14
    }
1095
1096
4.02k
    const size_t max_private{args.GetBoolArg("-privatebroadcast", DEFAULT_PRIVATE_BROADCAST)
1097
4.02k
                             ? MAX_PRIVATE_BROADCAST_CONNECTIONS
1098
4.02k
                             : 0};
1099
    // HTTP server listen sockets: by default two (IPv4 and IPv6 loopback), or one per -rpcbind entry
1100
4.02k
    int num_rpc_bind = std::max(args.GetArgs("-rpcbind").size(), size_t(2));
1101
    // HTTP server connected client sockets
1102
4.02k
    int user_rpc_max_connections = args.GetArg<int>("-rpcmaxconnections", DEFAULT_MAX_HTTP_CONNECTIONS);
1103
4.02k
    if (user_rpc_max_connections < 1) {
1104
0
        return InitError(Untranslated("-rpcmaxconnections must be greater than zero. Use -server=0 to disable HTTP."));
1105
0
    }
1106
4.02k
    if (!args.GetBoolArg("-server", false)) {
1107
780
        num_rpc_bind = 0;
1108
780
        user_rpc_max_connections = 0;
1109
780
    }
1110
1111
    // Reserve enough FDs to account for the bare minimum, plus any manual connections, plus the bound interfaces.
1112
    // Every element is an int >= 0 so summing in int64_t cannot overflow.
1113
    // RaiseFileDescriptorLimit() accepts an int so we check that limit before casting.
1114
4.02k
    const int64_t total_fds = int64_t{MIN_CORE_FDS} +
1115
4.02k
                              MAX_ADDNODE_CONNECTIONS +
1116
4.02k
                              num_p2p_bind +
1117
4.02k
                              num_rpc_bind +
1118
4.02k
                              user_rpc_max_connections +
1119
4.02k
                              user_p2p_max_connections +
1120
4.02k
                              static_cast<int64_t>(ipc_fds) +
1121
4.02k
                              static_cast<int64_t>(max_private);
1122
4.02k
    if (total_fds > std::numeric_limits<int>::max()) {
1123
1
        return InitError(Untranslated("Too many file descriptors requested. Try lower values for -rpcmaxconnections "
1124
1
                                      "or -maxconnections, or fewer settings of "
1125
1
                                      "-rpcbind, -bind, -whitebind and -ipcbind"));
1126
1
    }
1127
1128
    // Subset of total_fds must also be a safe int
1129
4.02k
    int min_required_fds = MIN_CORE_FDS +
1130
4.02k
                           MAX_ADDNODE_CONNECTIONS +
1131
4.02k
                           num_p2p_bind +
1132
4.02k
                           num_rpc_bind +
1133
4.02k
                           user_rpc_max_connections +
1134
4.02k
                           static_cast<int>(ipc_fds);
1135
1136
    // Try raising the FD limit to what the user wants (available_fds may be smaller than the requested amount if this fails)
1137
4.02k
    available_fds = RaiseFileDescriptorLimit(static_cast<int>(total_fds));
1138
    // If we are using select instead of poll, our actual limit may be even smaller
1139
#ifndef USE_POLL
1140
    available_fds = std::min(FD_SETSIZE, available_fds);
1141
#endif
1142
    // The system can't support our bare minimum
1143
4.02k
    if (available_fds < min_required_fds)
1144
0
        return InitError(strprintf(_("Not enough file descriptors available. %d available, %d required."), available_fds, min_required_fds));
1145
1146
    // The system can support our minimum but not the full amount the user requested.
1147
4.02k
    if (available_fds < total_fds) {
1148
        // If the user is requesting extra HTTP connections, abort. They need to change that.
1149
2
        if (user_rpc_max_connections > DEFAULT_MAX_HTTP_CONNECTIONS) {
1150
1
            return InitError(strprintf(_("Not enough file descriptors available. "
1151
1
                                         "Try reducing -rpcmaxconnections or using the default value of %d"),
1152
1
                                         DEFAULT_MAX_HTTP_CONNECTIONS));
1153
1
        }
1154
2
    }
1155
1156
    // Trim requested connection counts, to fit into system limitations
1157
4.02k
    num_p2p_max_connections = std::min(available_fds - min_required_fds, user_p2p_max_connections);
1158
1159
4.02k
    if (num_p2p_max_connections < user_p2p_max_connections)
1160
1
        InitWarning(strprintf(_("Reducing -maxconnections from %d to %d, because of system limitations."), user_p2p_max_connections, num_p2p_max_connections));
1161
1162
    // ********************************************************* Step 3: parameter-to-internal-flags
1163
4.02k
    if (auto result{init::SetLoggingCategories(args)}; !result) return InitError(util::ErrorString(result));
1164
4.02k
    if (auto result{init::SetLoggingLevel(args)}; !result) return InitError(util::ErrorString(result));
1165
1166
4.01k
    nConnectTimeout = args.GetIntArg("-timeout", DEFAULT_CONNECT_TIMEOUT);
1167
4.01k
    if (nConnectTimeout <= 0) {
1168
0
        nConnectTimeout = DEFAULT_CONNECT_TIMEOUT;
1169
0
    }
1170
1171
4.01k
    peer_connect_timeout = args.GetIntArg("-peertimeout", DEFAULT_PEER_CONNECT_TIMEOUT);
1172
4.01k
    if (peer_connect_timeout <= 0) {
1173
2
        return InitError(Untranslated("peertimeout must be a positive integer."));
1174
2
    }
1175
1176
4.01k
    auto mining_result{node::ReadMiningArgs(args)};
1177
4.01k
    if (!mining_result) {
1178
4
        return InitError(util::ErrorString(mining_result));
1179
4
    }
1180
1181
4.01k
    nBytesPerSigOp = args.GetIntArg("-bytespersigop", nBytesPerSigOp);
1182
1183
4.01k
    if (!g_wallet_init_interface.ParameterInteraction()) return false;
1184
1185
    // Option to startup with mocktime set (used for regression testing):
1186
4.01k
    if (const auto mocktime{args.GetIntArg("-mocktime")}) {
1187
11
        SetMockTime(std::chrono::seconds{*mocktime});
1188
11
    }
1189
1190
4.01k
    if (args.GetBoolArg("-peerbloomfilters", DEFAULT_PEERBLOOMFILTERS))
1191
4
        g_local_services = ServiceFlags(g_local_services | NODE_BLOOM);
1192
1193
4.01k
    const std::vector<std::string> test_options = args.GetArgs("-test");
1194
4.01k
    if (!test_options.empty()) {
1195
16
        if (chainparams.GetChainType() != ChainType::REGTEST) {
1196
0
            return InitError(Untranslated("-test=<option> can only be used with regtest"));
1197
0
        }
1198
16
        for (const std::string& option : test_options) {
1199
19
            auto it = std::find_if(TEST_OPTIONS_DOC.begin(), TEST_OPTIONS_DOC.end(), [&option](const std::string& doc_option) {
1200
19
                size_t pos = doc_option.find(" (");
1201
19
                return (pos != std::string::npos) && (doc_option.substr(0, pos) == option);
1202
19
            });
1203
16
            if (it == TEST_OPTIONS_DOC.end()) {
1204
0
                InitWarning(strprintf(_("Unrecognised option \"%s\" provided in -test=<option>."), option));
1205
0
            }
1206
16
        }
1207
16
    }
1208
1209
    // Prevent setting deployment parameters on mainnet.
1210
4.01k
    if (chainparams.GetChainType() == ChainType::MAIN) {
1211
664
        if (args.IsArgSet("-testactivationheight")) {
1212
0
            return InitError(_("The -testactivationheight option may not be used on mainnet."));
1213
0
        }
1214
664
        if (args.IsArgSet("-vbparams")) {
1215
0
            return InitError(_("The -vbparams option may not be used on mainnet."));
1216
0
        }
1217
664
    }
1218
1219
    // Also report errors from parsing before daemonization
1220
4.01k
    {
1221
4.01k
        kernel::Notifications notifications{};
1222
4.01k
        ChainstateManager::Options chainman_opts_dummy{
1223
4.01k
            .chainparams = chainparams,
1224
4.01k
            .datadir = args.GetDataDirNet(),
1225
4.01k
            .notifications = notifications,
1226
4.01k
        };
1227
4.01k
        auto chainman_result{ApplyArgsManOptions(args, chainman_opts_dummy)};
1228
4.01k
        if (!chainman_result) {
1229
1
            return InitError(util::ErrorString(chainman_result));
1230
1
        }
1231
4.01k
        BlockManager::Options blockman_opts_dummy{
1232
4.01k
            .chainparams = chainman_opts_dummy.chainparams,
1233
4.01k
            .blocks_dir = args.GetBlocksDirPath(),
1234
4.01k
            .notifications = chainman_opts_dummy.notifications,
1235
4.01k
            .block_tree_db_params = DBParams{
1236
4.01k
                .path = args.GetDataDirNet() / "blocks" / "index",
1237
4.01k
                .cache_bytes = 0,
1238
4.01k
            },
1239
4.01k
        };
1240
4.01k
        auto blockman_result{ApplyArgsManOptions(args, blockman_opts_dummy)};
1241
4.01k
        if (!blockman_result) {
1242
0
            return InitError(util::ErrorString(blockman_result));
1243
0
        }
1244
4.01k
        CTxMemPool::Options mempool_opts{};
1245
4.01k
        auto mempool_result{ApplyArgsManOptions(args, chainparams, mempool_opts)};
1246
4.01k
        if (!mempool_result) {
1247
1
            return InitError(util::ErrorString(mempool_result));
1248
1
        }
1249
4.01k
    }
1250
1251
4.01k
    return true;
1252
4.01k
}
1253
1254
static bool LockDirectory(const fs::path& dir, bool probeOnly)
1255
4.91k
{
1256
    // Make sure only a single process is using the directory.
1257
4.91k
    switch (util::LockDirectory(dir, ".lock", probeOnly)) {
1258
0
    case util::LockResult::ErrorWrite:
1259
0
        return InitError(strprintf(_("Cannot write to directory '%s'; check permissions."), fs::PathToString(dir)));
1260
2
    case util::LockResult::ErrorLock:
1261
2
        return InitError(strprintf(_("Cannot obtain a lock on directory %s. %s is probably already running."), fs::PathToString(dir), CLIENT_NAME));
1262
4.90k
    case util::LockResult::Success: return true;
1263
4.91k
    } // no default case, so the compiler can warn about missing cases
1264
4.91k
    assert(false);
1265
0
}
1266
static bool LockDirectories(bool probeOnly)
1267
2.45k
{
1268
2.45k
    return LockDirectory(gArgs.GetDataDirNet(), probeOnly) && \
1269
2.45k
           LockDirectory(gArgs.GetBlocksDirPath(), probeOnly);
1270
2.45k
}
1271
1272
bool AppInitSanityChecks(const kernel::Context& kernel)
1273
1.22k
{
1274
    // ********************************************************* Step 4: sanity checks
1275
1.22k
    auto result{kernel::SanityChecks(kernel)};
1276
1.22k
    if (!result) {
1277
0
        InitError(util::ErrorString(result));
1278
0
        return InitError(strprintf(_("Initialization sanity check failed. %s is shutting down."), CLIENT_NAME));
1279
0
    }
1280
1281
1.22k
    if (!ECC_InitSanityCheck()) {
1282
0
        return InitError(strprintf(_("Elliptic curve cryptography sanity check failure. %s is shutting down."), CLIENT_NAME));
1283
0
    }
1284
1285
    // Probe the directory locks to give an early error message, if possible
1286
    // We cannot hold the directory locks here, as the forking for daemon() hasn't yet happened,
1287
    // and a fork will cause weird behavior to them.
1288
1.22k
    return LockDirectories(true);
1289
1.22k
}
1290
1291
bool AppInitLockDirectories()
1292
1.22k
{
1293
    // After daemonization get the directory locks again and hold on to them until exit
1294
    // This creates a slight window for a race condition to happen, however this condition is harmless: it
1295
    // will at most make us exit without printing a message to console.
1296
1.22k
    if (!LockDirectories(false)) {
1297
        // Detailed error printed inside LockDirectory
1298
0
        return false;
1299
0
    }
1300
1.22k
    return true;
1301
1.22k
}
1302
1303
bool AppInitInterfaces(NodeContext& node)
1304
1.22k
{
1305
1.22k
    node.chain = interfaces::MakeChain(node);
1306
1.22k
    return true;
1307
1.22k
}
1308
1309
1.22k
bool CheckHostPortOptions(const ArgsManager& args) {
1310
1.22k
    for (const std::string port_option : {
1311
1.22k
        "-port",
1312
1.22k
        "-rpcport",
1313
2.44k
    }) {
1314
2.44k
        if (const auto port{args.GetArg(port_option)}) {
1315
2.44k
            const auto n{ToIntegral<uint16_t>(*port)};
1316
2.44k
            if (!n || *n == 0) {
1317
2
                return InitError(InvalidPortErrMsg(port_option, *port));
1318
2
            }
1319
2.44k
        }
1320
2.44k
    }
1321
1322
1.22k
    for ([[maybe_unused]] const auto& [param_name, unix, suffix_allowed] : std::vector<std::tuple<std::string, bool, bool>>{
1323
        // arg name          UNIX socket support  =suffix allowed
1324
1.22k
        {"-i2psam",          false,               false},
1325
1.22k
        {"-onion",           true,                false},
1326
1.22k
        {"-proxy",           true,                true},
1327
1.22k
        {"-bind",            false,               true},
1328
1.22k
        {"-rpcbind",         false,               false},
1329
1.22k
        {"-torcontrol",      false,               false},
1330
1.22k
        {"-whitebind",       false,               false},
1331
1.22k
        {"-zmqpubhashblock", true,                false},
1332
1.22k
        {"-zmqpubhashtx",    true,                false},
1333
1.22k
        {"-zmqpubrawblock",  true,                false},
1334
1.22k
        {"-zmqpubrawtx",     true,                false},
1335
1.22k
        {"-zmqpubsequence",  true,                false},
1336
14.5k
    }) {
1337
14.5k
        for (const std::string& param_value : args.GetArgs(param_name)) {
1338
1.31k
            const std::string param_value_hostport{
1339
1.31k
                suffix_allowed ? param_value.substr(0, param_value.rfind('=')) : param_value};
1340
1.31k
            std::string host_out;
1341
1.31k
            uint16_t port_out{0};
1342
1.31k
            if (!SplitHostPort(param_value_hostport, port_out, host_out)) {
1343
14
#ifdef HAVE_SOCKADDR_UN
1344
                // Allow unix domain sockets for some options e.g. unix:/some/file/path
1345
14
                if (!unix || !param_value.starts_with(ADDR_PREFIX_UNIX)) {
1346
11
                    return InitError(InvalidPortErrMsg(param_name, param_value));
1347
11
                }
1348
#else
1349
                return InitError(InvalidPortErrMsg(param_name, param_value));
1350
#endif
1351
14
            }
1352
1.31k
        }
1353
14.5k
    }
1354
1355
1.21k
    return true;
1356
1.22k
}
1357
1358
/**
1359
 * @brief Checks for duplicate bindings across all binding configurations.
1360
 *
1361
 * @param[in] conn_options Connection options containing the binding vectors to check
1362
 * @return std::optional<CService> containing the first duplicate found, or std::nullopt if no duplicates
1363
 */
1364
static std::optional<CService> CheckBindingConflicts(const CConnman::Options& conn_options)
1365
1.10k
{
1366
1.10k
    std::set<CService> seen;
1367
1368
    // Check all whitelisted bindings
1369
1.10k
    for (const auto& wb : conn_options.vWhiteBinds) {
1370
8
        if (!seen.insert(wb.m_service).second) {
1371
1
            return wb.m_service;
1372
1
        }
1373
8
    }
1374
1375
    // Check regular bindings
1376
1.10k
    for (const auto& bind : conn_options.vBinds) {
1377
1.07k
        if (!seen.insert(bind).second) {
1378
2
            return bind;
1379
2
        }
1380
1.07k
    }
1381
1382
    // Check onion bindings
1383
1.10k
    for (const auto& onion_bind : conn_options.onion_binds) {
1384
45
        if (!seen.insert(onion_bind).second) {
1385
3
            return onion_bind;
1386
3
        }
1387
45
    }
1388
1389
1.09k
    return std::nullopt;
1390
1.10k
}
1391
1392
// A GUI user may opt to retry once with do_reindex set if there is a failure during chainstate initialization.
1393
// The function therefore has to support re-entry.
1394
static ChainstateLoadResult InitAndLoadChainstate(
1395
    NodeContext& node,
1396
    bool do_reindex,
1397
    const bool do_reindex_chainstate,
1398
    const kernel::CacheSizes& cache_sizes,
1399
    const ArgsManager& args)
1400
2.29k
{
1401
    // This function may be called twice, so any dirty state must be reset.
1402
2.29k
    node.notifications->setChainstateLoaded(false); // Drop state, such as a cached tip block
1403
2.29k
    node.block_template_manager.reset();
1404
2.29k
    node.mempool.reset();
1405
2.29k
    node.chainman.reset(); // Drop state, such as an initialized m_block_tree_db
1406
1407
2.29k
    const CChainParams& chainparams = Params();
1408
1409
2.29k
    CTxMemPool::Options mempool_opts{
1410
2.29k
        .check_ratio = chainparams.DefaultConsistencyChecks() ? 1 : 0,
1411
2.29k
        .signals = node.validation_signals.get(),
1412
2.29k
    };
1413
2.29k
    Assert(ApplyArgsManOptions(args, chainparams, mempool_opts)); // no error can happen, already checked in AppInitParameterInteraction
1414
2.29k
    bilingual_str mempool_error;
1415
2.29k
    Assert(!node.mempool); // Was reset above
1416
2.29k
    node.mempool = std::make_unique<CTxMemPool>(mempool_opts, mempool_error);
1417
2.29k
    if (!mempool_error.empty()) {
1418
1
        return {ChainstateLoadStatus::FAILURE_FATAL, mempool_error};
1419
1
    }
1420
2.29k
    LogInfo("* Using %.1f MiB for in-memory UTXO set (plus up to %.1f MiB of unused mempool space)",
1421
2.29k
            cache_sizes.coins / double(1_MiB),
1422
2.29k
            mempool_opts.max_size_bytes / double(1_MiB));
1423
2.29k
    ChainstateManager::Options chainman_opts{
1424
2.29k
        .chainparams = chainparams,
1425
2.29k
        .datadir = args.GetDataDirNet(),
1426
2.29k
        .notifications = *node.notifications,
1427
2.29k
        .signals = node.validation_signals.get(),
1428
2.29k
    };
1429
2.29k
    Assert(ApplyArgsManOptions(args, chainman_opts)); // no error can happen, already checked in AppInitParameterInteraction
1430
1431
2.29k
    BlockManager::Options blockman_opts{
1432
2.29k
        .chainparams = chainman_opts.chainparams,
1433
2.29k
        .blocks_dir = args.GetBlocksDirPath(),
1434
2.29k
        .notifications = chainman_opts.notifications,
1435
2.29k
        .block_tree_db_params = DBParams{
1436
2.29k
            .path = args.GetDataDirNet() / "blocks" / "index",
1437
2.29k
            .cache_bytes = cache_sizes.block_tree_db,
1438
2.29k
            .wipe_data = do_reindex,
1439
2.29k
        },
1440
2.29k
    };
1441
2.29k
    Assert(ApplyArgsManOptions(args, blockman_opts)); // no error can happen, already checked in AppInitParameterInteraction
1442
1443
    // Creating the chainstate manager internally creates a BlockManager, opens
1444
    // the blocks tree db, and wipes existing block files in case of a reindex.
1445
    // The coinsdb is opened at a later point on LoadChainstate.
1446
2.29k
    Assert(!node.chainman); // Was reset above
1447
2.29k
    try {
1448
2.29k
        node.chainman = std::make_unique<ChainstateManager>(*Assert(node.shutdown_signal), chainman_opts, blockman_opts);
1449
2.29k
    } catch (dbwrapper_error& e) {
1450
1
        LogError("%s", e.what());
1451
1
        return {ChainstateLoadStatus::FAILURE, _("Error opening block database")};
1452
1
    } catch (std::exception& e) {
1453
1
        return {ChainstateLoadStatus::FAILURE_FATAL, Untranslated(strprintf("Failed to initialize ChainstateManager: %s", e.what()))};
1454
1
    }
1455
1.14k
    ChainstateManager& chainman = *node.chainman;
1456
1.14k
    if (chainman.m_interrupt) return {ChainstateLoadStatus::INTERRUPTED, {}};
1457
1458
    // This is defined and set here instead of inline in validation.h to avoid a hard
1459
    // dependency between validation and index/base, since the latter is not in
1460
    // libbitcoinkernel.
1461
1.14k
    chainman.snapshot_download_completed = [&node]() {
1462
7
        if (!node.chainman->m_blockman.IsPruneMode()) {
1463
5
            LogInfo("[snapshot] re-enabling NODE_NETWORK services");
1464
5
            node.connman->AddLocalServices(NODE_NETWORK);
1465
5
        }
1466
7
        LogInfo("[snapshot] restarting indexes");
1467
        // Drain the validation interface queue to ensure that the old indexes
1468
        // don't have any pending work.
1469
7
        Assert(node.validation_signals)->SyncWithValidationInterfaceQueue();
1470
8
        for (auto* index : node.indexes) {
1471
8
            index->Interrupt();
1472
8
            index->Stop();
1473
8
            if (!(index->Init() && index->StartBackgroundSync())) {
1474
0
                LogWarning("[snapshot] Failed to restart index %s on snapshot chain", index->GetName());
1475
0
            }
1476
8
        }
1477
7
    };
1478
1.14k
    node::ChainstateLoadOptions options;
1479
1.14k
    options.mempool = Assert(node.mempool.get());
1480
1.14k
    options.wipe_chainstate_db = do_reindex || do_reindex_chainstate;
1481
1.14k
    options.prune = chainman.m_blockman.IsPruneMode();
1482
1.14k
    options.check_blocks = args.GetIntArg("-checkblocks", DEFAULT_CHECKBLOCKS);
1483
1.14k
    options.check_level = args.GetIntArg("-checklevel", DEFAULT_CHECKLEVEL);
1484
1.14k
    options.require_full_verification = args.IsArgSet("-checkblocks") || args.IsArgSet("-checklevel");
1485
1.14k
    options.coins_error_cb = [] {
1486
0
        uiInterface.ThreadSafeMessageBox(
1487
0
            _("Error reading from database, shutting down."),
1488
0
            CClientUIInterface::MSG_ERROR);
1489
0
    };
1490
1.14k
    uiInterface.InitMessage(_("Loading block index…"));
1491
2.26k
    auto catch_exceptions = [](auto&& f) -> ChainstateLoadResult {
1492
2.26k
        try {
1493
2.26k
            return f();
1494
2.26k
        } catch (const std::exception& e) {
1495
0
            LogError("%s\n", e.what());
1496
0
            return std::make_tuple(node::ChainstateLoadStatus::FAILURE, _("Error loading databases"));
1497
0
        }
1498
2.26k
    };
init.cpp:_ZZL21InitAndLoadChainstateRN4node11NodeContextEbbRKN6kernel10CacheSizesERK11ArgsManagerENK3$_2clIZL21InitAndLoadChainstateS1_bbS5_S8_E3$_3EESt5tupleIJNS_20ChainstateLoadStatusE13bilingual_strEEOT_
Line
Count
Source
1491
1.14k
    auto catch_exceptions = [](auto&& f) -> ChainstateLoadResult {
1492
1.14k
        try {
1493
1.14k
            return f();
1494
1.14k
        } catch (const std::exception& e) {
1495
0
            LogError("%s\n", e.what());
1496
0
            return std::make_tuple(node::ChainstateLoadStatus::FAILURE, _("Error loading databases"));
1497
0
        }
1498
1.14k
    };
init.cpp:_ZZL21InitAndLoadChainstateRN4node11NodeContextEbbRKN6kernel10CacheSizesERK11ArgsManagerENK3$_2clIZL21InitAndLoadChainstateS1_bbS5_S8_E3$_4EESt5tupleIJNS_20ChainstateLoadStatusE13bilingual_strEEOT_
Line
Count
Source
1491
1.12k
    auto catch_exceptions = [](auto&& f) -> ChainstateLoadResult {
1492
1.12k
        try {
1493
1.12k
            return f();
1494
1.12k
        } catch (const std::exception& e) {
1495
0
            LogError("%s\n", e.what());
1496
0
            return std::make_tuple(node::ChainstateLoadStatus::FAILURE, _("Error loading databases"));
1497
0
        }
1498
1.12k
    };
1499
1.14k
    auto [status, error] = catch_exceptions([&] { return LoadChainstate(chainman, cache_sizes, options); });
1500
1.14k
    if (status == node::ChainstateLoadStatus::SUCCESS) {
1501
1.12k
        uiInterface.InitMessage(_("Verifying blocks…"));
1502
1.12k
        if (chainman.m_blockman.m_have_pruned && options.check_blocks > MIN_BLOCKS_TO_KEEP) {
1503
0
            LogWarning("pruned datadir may not have more than %d blocks; only checking available blocks\n",
1504
0
                       MIN_BLOCKS_TO_KEEP);
1505
0
        }
1506
1.12k
        std::tie(status, error) = catch_exceptions([&] { return VerifyLoadedChainstate(chainman, options); });
1507
1.12k
        if (status == node::ChainstateLoadStatus::SUCCESS) {
1508
1.12k
            LogInfo("Block index and chainstate loaded");
1509
1.12k
            auto mining_args{node::ReadMiningArgs(args)};
1510
1.12k
            Assert(mining_args); // no error can happen, already checked in AppInitParameterInteraction
1511
            // Must be set before setChainstateLoaded(true), which unblocks MakeMining waiters that assume it is non-null.
1512
1.12k
            node.block_template_manager = std::make_unique<node::BlockTemplateManager>(*node.mempool, chainman, *node.notifications, std::move(*mining_args));
1513
1.12k
            node.notifications->setChainstateLoaded(true);
1514
1.12k
        }
1515
1.12k
    }
1516
1.14k
    return {status, error};
1517
1.14k
};
1518
1519
bool AppInitMain(NodeContext& node, interfaces::BlockAndHeaderTipInfo* tip_info)
1520
1.22k
{
1521
1.22k
    const ArgsManager& args = *Assert(node.args);
1522
1.22k
    const CChainParams& chainparams = Params();
1523
1524
1.22k
    auto opt_max_upload = ParseByteUnits(args.GetArg("-maxuploadtarget", DEFAULT_MAX_UPLOAD_TARGET), ByteUnit::M);
1525
1.22k
    if (!opt_max_upload) {
1526
1
        return InitError(strprintf(_("Unable to parse -maxuploadtarget: '%s'"), args.GetArg("-maxuploadtarget", "")));
1527
1
    }
1528
1529
    // ********************************************************* Step 4a: application initialization
1530
1.22k
    if (!CreatePidFile(args)) {
1531
        // Detailed error printed inside CreatePidFile().
1532
0
        return false;
1533
0
    }
1534
1.22k
    if (!init::StartLogging(args)) {
1535
        // Detailed error printed inside StartLogging().
1536
2
        return false;
1537
2
    }
1538
1539
1.22k
    LogInfo("Using at most %i automatic connections (%i file descriptors available)", num_p2p_max_connections, available_fds);
1540
1541
    // Warn about relative -datadir path.
1542
1.22k
    if (args.IsArgSet("-datadir") && !args.GetPathArg("-datadir").is_absolute()) {
1543
0
        LogWarning("Relative datadir option '%s' specified, which will be interpreted relative to the "
1544
0
                   "current working directory '%s'. This is fragile, because if bitcoin is started in the future "
1545
0
                   "from a different location, it will be unable to locate the current data files. There could "
1546
0
                   "also be data loss if bitcoin is started while in a temporary directory.",
1547
0
                   args.GetArg("-datadir", ""), fs::PathToString(fs::current_path()));
1548
0
    }
1549
1550
1.22k
    assert(!node.scheduler);
1551
1.22k
    node.scheduler = std::make_unique<CScheduler>();
1552
1.22k
    auto& scheduler = *node.scheduler;
1553
1554
    // Start the lightweight task scheduler thread
1555
1.22k
    scheduler.m_service_thread = std::thread(util::TraceThread, "scheduler", [&] { scheduler.serviceQueue(); });
1556
1557
    // Gather some entropy once per minute.
1558
1.22k
    scheduler.scheduleEvery([]{
1559
108
        RandAddPeriodic();
1560
108
    }, std::chrono::minutes{1});
1561
1562
    // Check disk space every 5 minutes to avoid db corruption.
1563
1.22k
    scheduler.scheduleEvery([&args, &node]{
1564
21
        constexpr uint64_t min_disk_space{50_MiB};
1565
21
        if (!CheckDiskSpace(args.GetBlocksDirPath(), min_disk_space)) {
1566
0
            LogError("Shutting down due to lack of disk space!\n");
1567
0
            if (!(Assert(node.shutdown_request))()) {
1568
0
                LogError("Failed to send shutdown signal after disk space check\n");
1569
0
            }
1570
0
        }
1571
21
    }, std::chrono::minutes{5});
1572
1573
1.22k
    if (args.GetBoolArg("-logratelimit", BCLog::DEFAULT_LOGRATELIMIT)) {
1574
1
        LogInstance().SetRateLimiting(BCLog::LogRateLimiter::Create(
1575
1
            [&scheduler](auto func, auto window) { scheduler.scheduleEvery(std::move(func), window); },
1576
1
            BCLog::RATELIMIT_MAX_BYTES,
1577
1
            BCLog::RATELIMIT_WINDOW));
1578
1.22k
    } else {
1579
1.22k
        LogInfo("Log rate limiting disabled");
1580
1.22k
    }
1581
1582
1.22k
    assert(!node.validation_signals);
1583
1.22k
    node.validation_signals = std::make_unique<ValidationSignals>(std::make_unique<SerialTaskRunner>(scheduler));
1584
1.22k
    auto& validation_signals = *node.validation_signals;
1585
1586
    // Create KernelNotifications object. Important to do this early before
1587
    // calling ipc->listenAddress() below so makeMining and other IPC methods
1588
    // can use this.
1589
1.22k
    assert(!node.notifications);
1590
1.22k
    node.notifications = std::make_unique<KernelNotifications>(Assert(node.shutdown_request), node.exit_status, *Assert(node.warnings));
1591
1.22k
    ReadNotificationArgs(args, *node.notifications);
1592
1593
    // Create client interfaces for wallets that are supposed to be loaded
1594
    // according to -wallet and -disablewallet options. This only constructs
1595
    // the interfaces, it doesn't load wallet data. Wallets actually get loaded
1596
    // when load() and start() interface methods are called below.
1597
1.22k
    g_wallet_init_interface.Construct(node);
1598
1.22k
    uiInterface.InitWallet();
1599
1600
1.22k
    if (interfaces::Ipc* ipc = node.init->ipc()) {
1601
15
        for (const std::string& configured_address : gArgs.GetArgs("-ipcbind")) {
1602
15
            auto listen_address{interfaces::Ipc::parseListenAddress(configured_address)};
1603
15
            Assert(listen_address); // Already validated in AppInitParameterInteraction.
1604
15
            try {
1605
15
                ipc->listenAddress(*listen_address);
1606
15
            } catch (const std::exception& e) {
1607
0
                return InitError(Untranslated(strprintf("Unable to bind to IPC address '%s'. %s", listen_address->address, e.what())));
1608
0
            }
1609
15
            LogInfo("Listening for IPC requests on address %s", listen_address->address);
1610
15
        }
1611
14
    }
1612
1613
    /* Register RPC commands regardless of -server setting so they will be
1614
     * available in the GUI RPC console even if external calls are disabled.
1615
     */
1616
1.22k
    RegisterAllCoreRPCCommands(tableRPC);
1617
1.22k
    for (const auto& client : node.chain_clients) {
1618
430
        client->registerRpcs();
1619
430
    }
1620
#ifdef ENABLE_ZMQ
1621
    RegisterZMQRPCCommands(tableRPC);
1622
#endif
1623
1624
    // Check port numbers
1625
1.22k
    if (!CheckHostPortOptions(args)) return false;
1626
1627
    // Configure reachable networks before we start the RPC server.
1628
    // This is necessary for -rpcallowip to distinguish CJDNS from other RFC4193
1629
1.21k
    const auto onlynets = args.GetArgs("-onlynet");
1630
1.21k
    if (!onlynets.empty()) {
1631
9
        g_reachable_nets.RemoveAll();
1632
9
        for (const std::string& snet : onlynets) {
1633
9
            enum Network net = ParseNetwork(snet);
1634
9
            if (net == NET_UNROUTABLE)
1635
1
                return InitError(strprintf(_("Unknown network specified in -onlynet: '%s'"), snet));
1636
8
            g_reachable_nets.Add(net);
1637
8
        }
1638
9
    }
1639
1640
1.21k
    if (!args.IsArgSet("-cjdnsreachable")) {
1641
1.20k
        if (!onlynets.empty() && g_reachable_nets.Contains(NET_CJDNS)) {
1642
1
            return InitError(
1643
1
                _("Outbound connections restricted to CJDNS (-onlynet=cjdns) but "
1644
1
                  "-cjdnsreachable is not provided"));
1645
1
        }
1646
1.20k
        g_reachable_nets.Remove(NET_CJDNS);
1647
1.20k
    }
1648
    // Now g_reachable_nets.Contains(NET_CJDNS) is true if:
1649
    // 1. -cjdnsreachable is given and
1650
    // 2.1. -onlynet is not given or
1651
    // 2.2. -onlynet=cjdns is given
1652
1653
    /* Start the RPC server already.  It will be started in "warmup" mode
1654
     * and not really process calls already (but it will signify connections
1655
     * that the server is there and will be ready later).  Warmup mode will
1656
     * be disabled when initialisation is finished.
1657
     */
1658
1.21k
    if (args.GetBoolArg("-server", false)) {
1659
1.20k
        uiInterface.InitMessage.connect(SetRPCWarmupStatus);
1660
1.20k
        if (!AppInitServers(node))
1661
13
            return InitError(_("Unable to start HTTP server. See debug log for details."));
1662
1.20k
    }
1663
1664
    // ********************************************************* Step 5: verify wallet database integrity
1665
1.19k
    for (const auto& client : node.chain_clients) {
1666
430
        if (!client->verify()) {
1667
23
            return false;
1668
23
        }
1669
430
    }
1670
1671
    // ********************************************************* Step 6: network initialization
1672
    // Note that we absolutely cannot open any actual connections
1673
    // until the very end ("start node") as the UTXO/block state
1674
    // is not yet setup and may end up being set up twice if we
1675
    // need to reindex later.
1676
1677
1.17k
    fListen = args.GetBoolArg("-listen", DEFAULT_LISTEN);
1678
1.17k
    fDiscover = args.GetBoolArg("-discover", true);
1679
1680
1.17k
    PeerManager::Options peerman_opts{};
1681
1.17k
    ApplyArgsManOptions(args, peerman_opts);
1682
1683
1.17k
    {
1684
        // Read asmap file if configured or embedded asmap data and initialize
1685
        // Netgroupman with or without it
1686
1.17k
        assert(!node.netgroupman);
1687
1.17k
        if (args.IsArgSet("-asmap") && !args.IsArgNegated("-asmap")) {
1688
9
            if (!args.GetBoolArg("-asmap", false)) {
1689
7
                fs::path asmap_path = args.GetPathArg("-asmap");
1690
7
                if (!asmap_path.is_absolute()) {
1691
2
                    asmap_path = args.GetDataDirNet() / asmap_path;
1692
2
                }
1693
1694
                // If a specific path was passed with the asmap argument check if
1695
                // the file actually exists in that location
1696
7
                if (!fs::exists(asmap_path)) {
1697
1
                    InitError(strprintf(_("Could not find asmap file %s"), fs::quoted(fs::PathToString(asmap_path))));
1698
1
                    return false;
1699
1
                }
1700
1701
                // If a file exists at the path, try to read the file
1702
6
                std::vector<std::byte> asmap{DecodeAsmap(asmap_path)};
1703
6
                if (asmap.empty()) {
1704
1
                    InitError(strprintf(_("Could not parse asmap file %s"), fs::quoted(fs::PathToString(asmap_path))));
1705
1
                    return false;
1706
1
                }
1707
5
                node.netgroupman = std::make_unique<NetGroupManager>(NetGroupManager::WithLoadedAsmap(std::move(asmap)));
1708
5
            } else {
1709
2
                #ifdef ENABLE_EMBEDDED_ASMAP
1710
                    // Use the embedded asmap data
1711
2
                    std::span<const std::byte> asmap{node::data::ip_asn};
1712
2
                    if (asmap.empty() || !CheckStandardAsmap(asmap)) {
1713
0
                        InitError(strprintf(_("Could not read embedded asmap data")));
1714
0
                        return false;
1715
0
                    }
1716
2
                    node.netgroupman = std::make_unique<NetGroupManager>(NetGroupManager::WithEmbeddedAsmap(asmap));
1717
2
                    LogInfo("Opened asmap data (%zu bytes) from embedded byte array\n", asmap.size());
1718
                #else
1719
                    // If there is no embedded data, fail and report it since
1720
                    // the user tried to use it
1721
                    InitError(strprintf(_("Embedded asmap data not available")));
1722
                    return false;
1723
                #endif
1724
2
            }
1725
7
            LogInfo("Using asmap version %s for IP bucketing", HexStr(node.netgroupman->GetAsmapVersion()));
1726
1.16k
        } else {
1727
1.16k
            node.netgroupman = std::make_unique<NetGroupManager>(NetGroupManager::NoAsmap());
1728
1.16k
            LogInfo("Using /16 prefix for IP bucketing");
1729
1.16k
        }
1730
1731
        // Initialize addrman
1732
1.17k
        assert(!node.addrman);
1733
1.17k
        uiInterface.InitMessage(_("Loading P2P addresses…"));
1734
1.17k
        auto addrman{LoadAddrman(*node.netgroupman, args)};
1735
1.17k
        if (!addrman) return InitError(util::ErrorString(addrman));
1736
1.16k
        node.addrman = std::move(*addrman);
1737
1.16k
    }
1738
1739
0
    FastRandomContext rng;
1740
1.16k
    assert(!node.banman);
1741
1.16k
    node.banman = std::make_unique<BanMan>(args.GetDataDirNet() / "banlist", &uiInterface, args.GetIntArg("-bantime", DEFAULT_MISBEHAVING_BANTIME));
1742
1.16k
    assert(!node.connman);
1743
1.16k
    node.connman = std::make_unique<CConnman>(rng.rand64(),
1744
1.16k
                                              rng.rand64(),
1745
1.16k
                                              *node.addrman, *node.netgroupman, chainparams, args.GetBoolArg("-networkactive", true));
1746
1747
1.16k
    for (const std::string& socket_addr : args.GetArgs("-bind")) {
1748
1.15k
        std::string host_out;
1749
1.15k
        uint16_t port_out{0};
1750
1.15k
        std::string bind_socket_addr = socket_addr.substr(0, socket_addr.rfind('='));
1751
1.15k
        if (!SplitHostPort(bind_socket_addr, port_out, host_out)) {
1752
0
            return InitError(InvalidPortErrMsg("-bind", socket_addr));
1753
0
        }
1754
1.15k
    }
1755
1756
    // sanitize comments per BIP-0014, format user agent and check total size
1757
1.16k
    std::vector<std::string> uacomments;
1758
1.17k
    for (const std::string& cmt : args.GetArgs("-uacomment")) {
1759
1.17k
        if (cmt != SanitizeString(cmt, SAFE_CHARS_UA_COMMENT))
1760
6
            return InitError(strprintf(_("User Agent comment (%s) contains unsafe characters."), cmt));
1761
1.17k
        uacomments.push_back(cmt);
1762
1.17k
    }
1763
1.15k
    strSubVersion = FormatSubVersion(UA_NAME, CLIENT_VERSION, uacomments);
1764
1.15k
    if (strSubVersion.size() > MAX_SUBVERSION_LENGTH) {
1765
1
        return InitError(strprintf(_("Total length of network version string (%i) exceeds maximum length (%i). Reduce the number or size of uacomments."),
1766
1
            strSubVersion.size(), MAX_SUBVERSION_LENGTH));
1767
1
    }
1768
1769
    // Requesting DNS seeds entails connecting to IPv4/IPv6, which -onlynet options may prohibit:
1770
    // If -dnsseed=1 is explicitly specified, abort. If it's left unspecified by the user, we skip
1771
    // the DNS seeds by adjusting -dnsseed in InitParameterInteraction.
1772
1.15k
    if (args.GetBoolArg("-dnsseed") == true && !g_reachable_nets.Contains(NET_IPV4) && !g_reachable_nets.Contains(NET_IPV6)) {
1773
1
        return InitError(strprintf(_("Incompatible options: -dnsseed=1 was explicitly specified, but -onlynet forbids connections to IPv4/IPv6")));
1774
1.15k
    };
1775
1776
    // Check for host lookup allowed before parsing any network related parameters
1777
1.15k
    fNameLookup = args.GetBoolArg("-dns", DEFAULT_NAME_LOOKUP);
1778
1779
1.15k
    bool proxyRandomize = args.GetBoolArg("-proxyrandomize", DEFAULT_PROXYRANDOMIZE);
1780
    // -proxy sets a proxy for outgoing network traffic, possibly per network.
1781
    // -noproxy, -proxy=0 or -proxy="" can be used to remove the proxy setting, this is the default
1782
1.15k
    Proxy ipv4_proxy;
1783
1.15k
    Proxy ipv6_proxy;
1784
1.15k
    Proxy onion_proxy;
1785
1.15k
    Proxy name_proxy;
1786
1.15k
    Proxy cjdns_proxy;
1787
1.15k
    for (const std::string& param_value : args.GetArgs("-proxy")) {
1788
51
        const auto eq_pos{param_value.rfind('=')};
1789
51
        const std::string proxy_str{param_value.substr(0, eq_pos)}; // e.g. 127.0.0.1:9050=ipv4 -> 127.0.0.1:9050
1790
51
        std::string net_str;
1791
51
        if (eq_pos != std::string::npos) {
1792
7
            if (eq_pos + 1 == param_value.length()) {
1793
1
                return InitError(strprintf(_("Invalid -proxy address or hostname, ends with '=': '%s'"), param_value));
1794
1
            }
1795
6
            net_str = ToLower(param_value.substr(eq_pos + 1)); // e.g. 127.0.0.1:9050=ipv4 -> ipv4
1796
6
        }
1797
1798
50
        Proxy proxy;
1799
50
        if (!proxy_str.empty() && proxy_str != "0") {
1800
49
            if (IsUnixSocketPath(proxy_str)) {
1801
1
                proxy = Proxy{proxy_str, /*tor_stream_isolation=*/proxyRandomize};
1802
48
            } else {
1803
48
                const std::optional<CService> addr{Lookup(proxy_str, DEFAULT_TOR_SOCKS_PORT, fNameLookup)};
1804
48
                if (!addr.has_value()) {
1805
2
                    return InitError(strprintf(_("Invalid -proxy address or hostname: '%s'"), proxy_str));
1806
2
                }
1807
46
                proxy = Proxy{addr.value(), /*tor_stream_isolation=*/proxyRandomize};
1808
46
            }
1809
47
            if (!proxy.IsValid()) {
1810
0
                return InitError(strprintf(_("Invalid -proxy address or hostname: '%s'"), proxy_str));
1811
0
            }
1812
47
        }
1813
1814
48
        if (net_str.empty()) { // For all networks.
1815
42
            ipv4_proxy = ipv6_proxy = name_proxy = cjdns_proxy = onion_proxy = proxy;
1816
42
        } else if (net_str == "ipv4") {
1817
1
            ipv4_proxy = name_proxy = proxy;
1818
5
        } else if (net_str == "ipv6") {
1819
2
            ipv6_proxy = name_proxy = proxy;
1820
3
        } else if (net_str == "onion") {
1821
1
            onion_proxy = proxy;
1822
2
        } else if (net_str == "cjdns") {
1823
1
            cjdns_proxy = proxy;
1824
1
        } else {
1825
1
            return InitError(strprintf(_("Unrecognized network in -proxy='%s': '%s'"), param_value, net_str));
1826
1
        }
1827
48
    }
1828
1.15k
    if (ipv4_proxy.IsValid()) {
1829
43
        SetProxy(NET_IPV4, ipv4_proxy);
1830
43
    }
1831
1.15k
    if (ipv6_proxy.IsValid()) {
1832
44
        SetProxy(NET_IPV6, ipv6_proxy);
1833
44
    }
1834
1.15k
    if (name_proxy.IsValid()) {
1835
44
        SetNameProxy(name_proxy);
1836
44
    }
1837
1.15k
    if (cjdns_proxy.IsValid()) {
1838
41
        SetProxy(NET_CJDNS, cjdns_proxy);
1839
41
    }
1840
1841
1.15k
    const bool onlynet_used_with_onion{!onlynets.empty() && g_reachable_nets.Contains(NET_ONION)};
1842
1843
    // -onion can be used to set only a proxy for .onion, or override normal proxy for .onion addresses
1844
    // -noonion (or -onion=0) disables connecting to .onion entirely
1845
    // An empty string is used to not override the onion proxy (in which case it defaults to -proxy set above, or none)
1846
1.15k
    std::string onionArg = args.GetArg("-onion", "");
1847
1.15k
    if (onionArg != "") {
1848
13
        if (onionArg == "0") { // Handle -noonion/-onion=0
1849
3
            onion_proxy = Proxy{};
1850
3
            if (onlynet_used_with_onion) {
1851
2
                return InitError(
1852
2
                    _("Outbound connections restricted to Tor (-onlynet=onion) but the proxy for "
1853
2
                      "reaching the Tor network is explicitly forbidden: -onion=0"));
1854
2
            }
1855
10
        } else {
1856
10
            if (IsUnixSocketPath(onionArg)) {
1857
1
                onion_proxy = Proxy(onionArg, /*tor_stream_isolation=*/proxyRandomize);
1858
9
            } else {
1859
9
                const std::optional<CService> addr{Lookup(onionArg, DEFAULT_TOR_SOCKS_PORT, fNameLookup)};
1860
9
                if (!addr.has_value() || !addr->IsValid()) {
1861
1
                    return InitError(strprintf(_("Invalid -onion address or hostname: '%s'"), onionArg));
1862
1
                }
1863
1864
8
                onion_proxy = Proxy(addr.value(), /*tor_stream_isolation=*/proxyRandomize);
1865
8
            }
1866
10
        }
1867
13
    }
1868
1869
1.14k
    const bool listenonion{args.GetBoolArg("-listenonion", DEFAULT_LISTEN_ONION)};
1870
1.14k
    if (onion_proxy.IsValid()) {
1871
47
        SetProxy(NET_ONION, onion_proxy);
1872
1.10k
    } else {
1873
        // If -listenonion is set, then we will (try to) connect to the Tor control port
1874
        // later from the torcontrol thread and may retrieve the onion proxy from there.
1875
1.10k
        if (onlynet_used_with_onion && !listenonion) {
1876
1
            return InitError(
1877
1
                _("Outbound connections restricted to Tor (-onlynet=onion) but the proxy for "
1878
1
                  "reaching the Tor network is not provided: none of -proxy, -onion or "
1879
1
                  "-listenonion is given"));
1880
1
        }
1881
1.10k
        g_reachable_nets.Remove(NET_ONION);
1882
1.10k
    }
1883
1884
1.14k
    for (const std::string& strAddr : args.GetArgs("-externalip")) {
1885
13
        const std::optional<CService> addrLocal{Lookup(strAddr, GetListenPort(), fNameLookup)};
1886
13
        if (addrLocal.has_value() && addrLocal->IsValid())
1887
13
            AddLocal(addrLocal.value(), LOCAL_MANUAL, /*add_even_if_unreachable=*/true);
1888
0
        else
1889
0
            return InitError(ResolveErrMsg("externalip", strAddr));
1890
13
    }
1891
1892
#ifdef ENABLE_ZMQ
1893
    g_zmq_notification_interface = CZMQNotificationInterface::Create(
1894
        [&chainman = node.chainman](std::vector<std::byte>& block, const CBlockIndex& index) {
1895
            assert(chainman);
1896
            if (auto ret{chainman->m_blockman.ReadRawBlock(WITH_LOCK(cs_main, return index.GetBlockPos()))}) {
1897
                block = std::move(*ret);
1898
                return true;
1899
            }
1900
            return false;
1901
        });
1902
1903
    if (g_zmq_notification_interface) {
1904
        validation_signals.RegisterValidationInterface(g_zmq_notification_interface.get());
1905
    }
1906
#endif
1907
1908
    // ********************************************************* Step 7: load block chain
1909
1910
    // cache size calculations
1911
1.14k
    node::LogOversizedDbCache(args);
1912
1.14k
    const auto [index_cache_sizes, kernel_cache_sizes] = CalculateCacheSizes(args, g_enabled_filter_types.size());
1913
1914
1.14k
    LogInfo("Cache configuration:");
1915
1.14k
    LogInfo("* Using %.1f MiB for block index database", kernel_cache_sizes.block_tree_db / double(1_MiB));
1916
1.14k
    if (args.GetBoolArg("-txindex", DEFAULT_TXINDEX)) {
1917
49
        LogInfo("* Using %.1f MiB for transaction index database", index_cache_sizes.tx_index / double(1_MiB));
1918
49
    }
1919
1.14k
    if (args.GetBoolArg("-txospenderindex", DEFAULT_TXOSPENDERINDEX)) {
1920
34
        LogInfo("* Using %.1f MiB for transaction output spender index database", index_cache_sizes.txospender_index / double(1_MiB));
1921
34
    }
1922
1.14k
    for (BlockFilterType filter_type : g_enabled_filter_types) {
1923
50
        LogInfo("* Using %.1f MiB for %s block filter index database",
1924
50
                  index_cache_sizes.filter_index / double(1_MiB), BlockFilterTypeName(filter_type));
1925
50
    }
1926
1.14k
    LogInfo("* Using %.1f MiB for chain state database", kernel_cache_sizes.coins_db / double(1_MiB));
1927
1928
1.14k
    assert(!node.mempool);
1929
1.14k
    assert(!node.chainman);
1930
1.14k
    assert(!node.block_template_manager);
1931
1932
1.14k
    bool do_reindex{args.GetBoolArg("-reindex", false)};
1933
1.14k
    const bool do_reindex_chainstate{args.GetBoolArg("-reindex-chainstate", false)};
1934
1935
    // Chainstate initialization and loading may be retried once with reindexing by GUI users
1936
1.14k
    auto [status, error] = InitAndLoadChainstate(
1937
1.14k
        node,
1938
1.14k
        do_reindex,
1939
1.14k
        do_reindex_chainstate,
1940
1.14k
        kernel_cache_sizes,
1941
1.14k
        args);
1942
1.14k
    if (status == ChainstateLoadStatus::FAILURE && !do_reindex && !ShutdownRequested(node)) {
1943
        // suggest a reindex
1944
12
        bool do_retry{HasTestOption(args, "reindex_after_failure_noninteractive_yes") ||
1945
12
            uiInterface.ThreadSafeQuestion(
1946
11
            error + Untranslated(".\n\n") + _("Do you want to rebuild the databases now?"),
1947
11
            error.original + (args.GetIntArg("-prune", 0) ? ".\nPlease restart with -reindex to recover." : ".\nPlease restart with -reindex or -reindex-chainstate to recover."),
1948
11
            CClientUIInterface::MSG_ERROR | CClientUIInterface::BTN_ABORT)};
1949
12
        if (!do_retry) {
1950
11
            return false;
1951
11
        }
1952
1
        do_reindex = true;
1953
1
        if (!Assert(node.shutdown_signal)->reset()) {
1954
0
            LogError("Internal error: failed to reset shutdown signal.\n");
1955
0
        }
1956
1
        std::tie(status, error) = InitAndLoadChainstate(
1957
1
            node,
1958
1
            do_reindex,
1959
1
            do_reindex_chainstate,
1960
1
            kernel_cache_sizes,
1961
1
            args);
1962
1
    }
1963
1.13k
    if (status != ChainstateLoadStatus::SUCCESS && status != ChainstateLoadStatus::INTERRUPTED) {
1964
3
        return InitError(error);
1965
3
    }
1966
1967
    // As LoadBlockIndex can take several minutes, it's possible the user
1968
    // requested to kill the GUI during the last operation. If so, exit.
1969
1.13k
    if (ShutdownRequested(node)) {
1970
11
        LogInfo("Shutdown requested. Exiting.");
1971
11
        return true;
1972
11
    }
1973
1974
1.12k
    ChainstateManager& chainman = *Assert(node.chainman);
1975
1976
1.12k
    assert(!node.fee_estimator_man);
1977
    // Don't initialize fee estimation with old data if we don't relay transactions,
1978
    // as they would never get updated.
1979
1.12k
    if (!peerman_opts.ignore_incoming_txs) {
1980
1.11k
        bool read_stale_estimates = args.GetBoolArg("-acceptstalefeeestimates", DEFAULT_ACCEPT_STALE_FEE_ESTIMATES);
1981
1.11k
        if (read_stale_estimates && (chainparams.GetChainType() != ChainType::REGTEST)) {
1982
4
            return InitError(strprintf(_("acceptstalefeeestimates is not supported on %s chain."), chainparams.GetChainTypeString()));
1983
4
        }
1984
1.11k
        MaybeMigrateLegacyFeeEstimates(args);
1985
1.11k
        node.fee_estimator_man = std::make_unique<FeeRateEstimatorManager>(BlockPolicyFeeEstPath(args), read_stale_estimates, MempoolPolicyEstimatorPath(args), *Assert(node.mempool), chainman);
1986
1987
        // Flush estimates to disk periodically
1988
1.11k
        FeeRateEstimatorManager* fee_estimator_man = node.fee_estimator_man.get();
1989
1.11k
        scheduler.scheduleEvery([fee_estimator_man] { fee_estimator_man->IntervalFlush(); }, FEE_FLUSH_INTERVAL);
1990
1.11k
        validation_signals.RegisterValidationInterface(fee_estimator_man);
1991
1.11k
    }
1992
1993
1.11k
    auto& kernel_notifications{*Assert(node.notifications)};
1994
1995
1.11k
    assert(!node.peerman);
1996
1.11k
    node.peerman = PeerManager::make(*node.connman, *node.addrman,
1997
1.11k
                                     node.banman.get(), chainman,
1998
1.11k
                                     *node.mempool, *node.warnings,
1999
1.11k
                                     peerman_opts);
2000
1.11k
    validation_signals.RegisterValidationInterface(node.peerman.get());
2001
2002
    // ********************************************************* Step 8: start indexers
2003
2004
1.11k
    if (args.GetBoolArg("-txindex", DEFAULT_TXINDEX)) {
2005
39
        g_txindex = std::make_unique<TxIndex>(interfaces::MakeChain(node), index_cache_sizes.tx_index, false, do_reindex);
2006
39
        node.indexes.emplace_back(g_txindex.get());
2007
39
    }
2008
2009
1.11k
    if (args.GetBoolArg("-txospenderindex", DEFAULT_TXOSPENDERINDEX)) {
2010
24
        g_txospenderindex = std::make_unique<TxoSpenderIndex>(interfaces::MakeChain(node), index_cache_sizes.txospender_index, false, do_reindex);
2011
24
        node.indexes.emplace_back(g_txospenderindex.get());
2012
24
    }
2013
2014
1.11k
    for (const auto& filter_type : g_enabled_filter_types) {
2015
40
        InitBlockFilterIndex([&]{ return interfaces::MakeChain(node); }, filter_type, index_cache_sizes.filter_index, false, do_reindex);
2016
40
        node.indexes.emplace_back(GetBlockFilterIndex(filter_type));
2017
40
    }
2018
2019
1.11k
    if (args.GetBoolArg("-coinstatsindex", DEFAULT_COINSTATSINDEX)) {
2020
41
        g_coin_stats_index = std::make_unique<CoinStatsIndex>(interfaces::MakeChain(node), /*cache_size=*/0, false, do_reindex);
2021
41
        node.indexes.emplace_back(g_coin_stats_index.get());
2022
41
    }
2023
2024
    // Init indexes
2025
1.11k
    for (auto index : node.indexes) if (!index->Init()) return false;
2026
2027
    // ********************************************************* Step 9: load wallet
2028
1.11k
    for (const auto& client : node.chain_clients) {
2029
379
        if (!client->load()) {
2030
0
            return false;
2031
0
        }
2032
379
    }
2033
2034
    // ********************************************************* Step 10: data directory maintenance
2035
2036
    // if pruning, perform the initial blockstore prune
2037
    // after any wallet rescanning has taken place.
2038
1.11k
    if (chainman.m_blockman.IsPruneMode()) {
2039
41
        if (chainman.m_blockman.m_blockfiles_indexed) {
2040
39
            LOCK(cs_main);
2041
39
            for (const auto& chainstate : chainman.m_chainstates) {
2042
39
                uiInterface.InitMessage(_("Pruning blockstore…"));
2043
39
                chainstate->PruneAndFlush();
2044
39
            }
2045
39
        }
2046
1.07k
    } else {
2047
        // Prior to setting NODE_NETWORK, check if we can provide historical blocks.
2048
1.07k
        if (!WITH_LOCK(chainman.GetMutex(), return chainman.HistoricalChainstate())) {
2049
1.06k
            LogInfo("Setting NODE_NETWORK in non-prune mode");
2050
1.06k
            g_local_services = ServiceFlags(g_local_services | NODE_NETWORK);
2051
1.06k
        } else {
2052
8
            LogInfo("Running node in NODE_NETWORK_LIMITED mode until snapshot background sync completes");
2053
8
        }
2054
1.07k
    }
2055
2056
    // ********************************************************* Step 11: import blocks
2057
2058
1.11k
    if (!CheckDiskSpace(args.GetDataDirNet())) {
2059
0
        InitError(strprintf(_("Error: Disk space is low for %s"), fs::quoted(fs::PathToString(args.GetDataDirNet()))));
2060
0
        return false;
2061
0
    }
2062
1.11k
    if (!CheckDiskSpace(args.GetBlocksDirPath())) {
2063
0
        InitError(strprintf(_("Error: Disk space is low for %s"), fs::quoted(fs::PathToString(args.GetBlocksDirPath()))));
2064
0
        return false;
2065
0
    }
2066
2067
1.11k
    int chain_active_height = WITH_LOCK(cs_main, return chainman.ActiveChain().Height());
2068
2069
    // On first startup, warn on low block storage space
2070
1.11k
    if (!do_reindex && !do_reindex_chainstate && chain_active_height <= 1) {
2071
447
        uint64_t assumed_chain_bytes{chainparams.AssumedBlockchainSize() * 1_GiB};
2072
447
        uint64_t additional_bytes_needed{
2073
447
            chainman.m_blockman.IsPruneMode() ?
2074
23
                std::min(chainman.m_blockman.GetPruneTarget(), assumed_chain_bytes) :
2075
447
                assumed_chain_bytes};
2076
2077
447
        if (!CheckDiskSpace(args.GetBlocksDirPath(), additional_bytes_needed)) {
2078
1
            InitWarning(strprintf(_(
2079
1
                    "Disk space for %s may not accommodate the block files. " \
2080
1
                    "Approximately %u GiB of data will be stored in this directory."
2081
1
                ),
2082
1
                fs::quoted(fs::PathToString(args.GetBlocksDirPath())),
2083
1
                CeilDiv(additional_bytes_needed, 1_GiB)
2084
1
            ));
2085
1
        }
2086
447
    }
2087
2088
#ifdef __APPLE__
2089
    auto check_and_warn_fs{[&](const fs::path& path, std::string_view desc) {
2090
        const auto path_desc{strprintf("%s (\"%s\")", desc, fs::PathToString(path))};
2091
        switch (GetFilesystemType(path)) {
2092
        case FSType::EXFAT:
2093
            InitWarning(strprintf(_("The %s path uses exFAT, which is known to have intermittent corruption problems on macOS. "
2094
                "Move this directory to a different filesystem to avoid data loss."), path_desc));
2095
            break;
2096
        case FSType::ERROR:
2097
            LogInfo("Failed to detect filesystem type for %s", path_desc);
2098
            break;
2099
        case FSType::OTHER:
2100
            break;
2101
        }
2102
    }};
2103
2104
    check_and_warn_fs(args.GetDataDirNet(), "data directory");
2105
    check_and_warn_fs(args.GetBlocksDirPath(), "blocks directory");
2106
#endif
2107
2108
1.11k
#if HAVE_SYSTEM
2109
1.11k
    const std::string block_notify = args.GetArg("-blocknotify", "");
2110
1.11k
    if (!block_notify.empty()) {
2111
113
        uiInterface.NotifyBlockTip.connect([block_notify](SynchronizationState sync_state, const CBlockIndex& block, double /* verification_progress */) {
2112
113
            if (sync_state != SynchronizationState::POST_INIT) return;
2113
112
            std::string command = block_notify;
2114
112
            ReplaceAll(command, "%s", block.GetBlockHash().GetHex());
2115
112
            std::thread t(runCommand, command);
2116
112
            t.detach(); // thread runs free
2117
112
        });
2118
1
    }
2119
1.11k
#endif
2120
2121
1.11k
    std::vector<fs::path> vImportFiles;
2122
1.11k
    for (const std::string& strFile : args.GetArgs("-loadblock")) {
2123
1
        vImportFiles.push_back(fs::PathFromString(strFile));
2124
1
    }
2125
2126
    /// \anchor initload
2127
1.11k
    node.background_init_thread = std::thread(&util::TraceThread, "initload", [=, &chainman, &args, &kernel_notifications, &node] {
2128
1.11k
        ScheduleBatchPriority();
2129
        // Import blocks and ActivateBestChain()
2130
1.11k
        ImportBlocks(chainman, vImportFiles);
2131
        // An interrupted import may return without activating genesis. Wake
2132
        // the init thread's genesis wait, which is otherwise only notified
2133
        // on blockTip, and that never fires when the import was interrupted
2134
        // before activating genesis. This wakeup lets the wait observe the
2135
        // shutdown request.
2136
1.11k
        WITH_LOCK(kernel_notifications.m_tip_block_mutex, kernel_notifications.m_tip_block_cv.notify_all());
2137
1.11k
        WITH_LOCK(::cs_main, chainman.UpdateIBDStatus());
2138
1.11k
        if (args.GetBoolArg("-stopafterblockimport", DEFAULT_STOPAFTERBLOCKIMPORT)) {
2139
0
            LogInfo("Stopping after block import");
2140
0
            if (!(Assert(node.shutdown_request))()) {
2141
0
                LogError("Failed to send shutdown signal after finishing block import\n");
2142
0
            }
2143
0
            return;
2144
0
        }
2145
2146
        // Start indexes initial sync
2147
1.11k
        if (!StartIndexBackgroundSync(node)) {
2148
0
            bilingual_str err_str = _("Failed to start indexes, shutting down…");
2149
0
            chainman.GetNotifications().fatalError(err_str);
2150
0
            return;
2151
0
        }
2152
        // Load mempool from disk
2153
1.11k
        if (auto* pool{chainman.ActiveChainstate().GetMempool()}) {
2154
1.11k
            const bool loaded{LoadMempool(*pool, ShouldPersistMempool(args) ? MempoolPath(args) : fs::path{}, chainman.ActiveChainstate(), {})};
2155
            // A shutdown request sets m_interrupt and aborts the mempool load, which is not a
2156
            // load failure, so only notify the fee estimator when the load actually failed.
2157
1.11k
            if (node.fee_estimator_man && !chainman.m_interrupt && !loaded) {
2158
600
                node.fee_estimator_man->MempoolLoadFailed();
2159
600
            }
2160
1.11k
            pool->SetLoadTried(!chainman.m_interrupt);
2161
1.11k
        }
2162
1.11k
    });
2163
2164
    /*
2165
     * Wait for genesis block to be processed. Typically kernel_notifications.m_tip_block
2166
     * has already been set by a call to LoadChainTip() in CompleteChainstateInitialization().
2167
     * But this is skipped if the chainstate doesn't exist yet or is being wiped:
2168
     *
2169
     * 1. first startup with an empty datadir
2170
     * 2. reindex
2171
     * 3. reindex-chainstate
2172
     *
2173
     * In these case it's connected by a call to ActivateBestChain() in the initload thread.
2174
     */
2175
1.11k
    {
2176
1.11k
        WAIT_LOCK(kernel_notifications.m_tip_block_mutex, lock);
2177
1.43k
        kernel_notifications.m_tip_block_cv.wait(lock, [&]() EXCLUSIVE_LOCKS_REQUIRED(kernel_notifications.m_tip_block_mutex) {
2178
1.43k
            return kernel_notifications.TipBlock() || ShutdownRequested(node);
2179
1.43k
        });
2180
1.11k
    }
2181
2182
1.11k
    if (ShutdownRequested(node)) {
2183
1
        return true;
2184
1
    }
2185
2186
    // ********************************************************* Step 12: start node
2187
2188
1.11k
    int64_t best_block_time{};
2189
1.11k
    {
2190
1.11k
        LOCK(chainman.GetMutex());
2191
1.11k
        const auto& tip{*Assert(chainman.ActiveTip())};
2192
1.11k
        LogInfo("block tree size = %u", chainman.BlockIndex().size());
2193
1.11k
        chain_active_height = tip.nHeight;
2194
1.11k
        best_block_time = tip.GetBlockTime();
2195
1.11k
        if (tip_info) {
2196
0
            tip_info->block_height = chain_active_height;
2197
0
            tip_info->block_time = best_block_time;
2198
0
            tip_info->verification_progress = chainman.GuessVerificationProgress(&tip);
2199
0
        }
2200
1.11k
        if (tip_info && chainman.m_best_header) {
2201
0
            tip_info->header_height = chainman.m_best_header->nHeight;
2202
0
            tip_info->header_time = chainman.m_best_header->GetBlockTime();
2203
0
        }
2204
1.11k
    }
2205
1.11k
    LogInfo("nBestHeight = %d", chain_active_height);
2206
1.11k
    if (node.peerman) node.peerman->SetBestBlock(chain_active_height, std::chrono::seconds{best_block_time});
2207
2208
    // Map ports with NAT-PMP
2209
1.11k
    StartMapPort(args.GetBoolArg("-natpmp", DEFAULT_NATPMP));
2210
2211
1.11k
    CConnman::Options connOptions;
2212
1.11k
    connOptions.m_local_services = g_local_services;
2213
1.11k
    connOptions.m_max_automatic_connections = num_p2p_max_connections;
2214
1.11k
    connOptions.m_full_relay_inbound_percent = std::clamp<int>(args.GetIntArg("-inboundrelaypercent", DEFAULT_FULL_RELAY_INBOUND_PCT), 0, 100);
2215
1.11k
    connOptions.uiInterface = &uiInterface;
2216
1.11k
    connOptions.m_banman = node.banman.get();
2217
1.11k
    connOptions.m_msgproc = node.peerman.get();
2218
1.11k
    connOptions.nSendBufferMaxSize = 1000 * args.GetIntArg("-maxsendbuffer", DEFAULT_MAXSENDBUFFER);
2219
1.11k
    connOptions.nReceiveFloodSize = 1000 * args.GetIntArg("-maxreceivebuffer", DEFAULT_MAXRECEIVEBUFFER);
2220
1.11k
    for (const std::string& added_node : args.GetArgs("-addnode")) {
2221
        // Such a value is not a valid connection target, but would otherwise be
2222
        // treated as one and retried indefinitely.
2223
6
        if (TrimStringView(added_node).empty()) {
2224
3
            LogWarning("Ignoring empty -addnode value");
2225
3
            continue;
2226
3
        }
2227
3
        connOptions.m_added_nodes.push_back(added_node);
2228
3
    }
2229
1.11k
    connOptions.nMaxOutboundLimit = *opt_max_upload;
2230
1.11k
    connOptions.m_peer_connect_timeout = peer_connect_timeout;
2231
1.11k
    connOptions.whitelist_forcerelay = args.GetBoolArg("-whitelistforcerelay", DEFAULT_WHITELISTFORCERELAY);
2232
1.11k
    connOptions.whitelist_relay = args.GetBoolArg("-whitelistrelay", DEFAULT_WHITELISTRELAY);
2233
1.11k
    connOptions.m_capture_messages = args.GetBoolArg("-capturemessages", false);
2234
2235
    // Port to bind to if `-bind=addr` is provided without a `:port` suffix.
2236
1.11k
    const uint16_t default_bind_port =
2237
1.11k
        static_cast<uint16_t>(args.GetIntArg("-port", Params().GetDefaultPort()));
2238
2239
1.11k
    const uint16_t default_bind_port_onion = default_bind_port + 1;
2240
2241
1.11k
    const auto BadPortWarning = [](const char* prefix, uint16_t port) {
2242
0
        return strprintf(_("%s request to listen on port %u. This port is considered \"bad\" and "
2243
0
                           "thus it is unlikely that any peer will connect to it. See "
2244
0
                           "doc/p2p-bad-ports.md for details and a full list."),
2245
0
                         prefix,
2246
0
                         port);
2247
0
    };
2248
2249
1.11k
    for (const std::string& bind_arg : args.GetArgs("-bind")) {
2250
1.10k
        std::optional<CService> bind_addr;
2251
1.10k
        const size_t index = bind_arg.rfind('=');
2252
1.10k
        if (index == std::string::npos) {
2253
1.08k
            bind_addr = Lookup(bind_arg, default_bind_port, /*fAllowLookup=*/false);
2254
1.08k
            if (bind_addr.has_value()) {
2255
1.08k
                connOptions.vBinds.push_back(bind_addr.value());
2256
1.08k
                if (IsBadPort(bind_addr.value().GetPort())) {
2257
0
                    InitWarning(BadPortWarning("-bind", bind_addr.value().GetPort()));
2258
0
                }
2259
1.08k
                continue;
2260
1.08k
            }
2261
1.08k
        } else {
2262
22
            const std::string network_type = bind_arg.substr(index + 1);
2263
22
            if (network_type == "onion") {
2264
22
                const std::string truncated_bind_arg = bind_arg.substr(0, index);
2265
22
                bind_addr = Lookup(truncated_bind_arg, default_bind_port_onion, false);
2266
22
                if (bind_addr.has_value()) {
2267
22
                    connOptions.onion_binds.push_back(bind_addr.value());
2268
22
                    continue;
2269
22
                }
2270
22
            }
2271
22
        }
2272
0
        return InitError(ResolveErrMsg("bind", bind_arg));
2273
1.10k
    }
2274
2275
1.11k
    for (const std::string& strBind : args.GetArgs("-whitebind")) {
2276
9
        NetWhitebindPermissions whitebind;
2277
9
        bilingual_str error;
2278
9
        if (!NetWhitebindPermissions::TryParse(strBind, whitebind, error)) return InitError(error);
2279
8
        connOptions.vWhiteBinds.push_back(whitebind);
2280
8
    }
2281
2282
    // If the user did not specify -bind= or -whitebind= then we bind
2283
    // on any address - 0.0.0.0 (IPv4) and :: (IPv6).
2284
1.11k
    connOptions.bind_on_any = args.GetArgs("-bind").empty() && args.GetArgs("-whitebind").empty();
2285
2286
    // Emit a warning if a bad port is given to -port= but only if -bind and -whitebind are not
2287
    // given, because if they are, then -port= is ignored.
2288
1.11k
    if (connOptions.bind_on_any && args.IsArgSet("-port")) {
2289
22
        const uint16_t port_arg = args.GetIntArg("-port", 0);
2290
22
        if (IsBadPort(port_arg)) {
2291
0
            InitWarning(BadPortWarning("-port", port_arg));
2292
0
        }
2293
22
    }
2294
2295
1.11k
    CService onion_service_target;
2296
1.11k
    if (!connOptions.onion_binds.empty()) {
2297
20
        onion_service_target = connOptions.onion_binds.front();
2298
1.09k
    } else if (!connOptions.vBinds.empty()) {
2299
1.06k
        onion_service_target = connOptions.vBinds.front();
2300
1.06k
    } else {
2301
31
        onion_service_target = DefaultOnionServiceTarget(default_bind_port_onion);
2302
31
        connOptions.onion_binds.push_back(onion_service_target);
2303
31
    }
2304
2305
1.11k
    if (listenonion) {
2306
9
        if (connOptions.onion_binds.size() > 1) {
2307
0
            InitWarning(strprintf(_("More than one onion bind address is provided. Using %s "
2308
0
                                    "for the automatically created Tor onion service."),
2309
0
                                  onion_service_target.ToStringAddrPort()));
2310
0
        }
2311
9
        node.tor_controller = std::make_unique<TorController>(gArgs.GetArg("-torcontrol", DEFAULT_TOR_CONTROL), onion_service_target);
2312
9
    }
2313
2314
1.11k
    bool should_discover = connOptions.bind_on_any;
2315
1.11k
    if (!should_discover) {
2316
1.08k
        for (const auto& bind : connOptions.vBinds) {
2317
1.08k
            if (bind.IsBindAny()) {
2318
13
                should_discover = true;
2319
13
                break;
2320
13
            }
2321
1.08k
        }
2322
1.08k
    }
2323
2324
1.11k
    if (!should_discover) {
2325
1.07k
        for (const auto& whitebind : connOptions.vWhiteBinds) {
2326
6
            if (whitebind.m_service.IsBindAny()) {
2327
1
                should_discover = true;
2328
1
                break;
2329
1
            }
2330
6
        }
2331
1.07k
    }
2332
2333
1.11k
    if (should_discover) {
2334
        // Only add all IP addresses of the machine if we would be listening on
2335
        // any address - 0.0.0.0 (IPv4) and :: (IPv6).
2336
37
        Discover();
2337
37
    }
2338
2339
1.11k
    for (const auto& net : args.GetArgs("-whitelist")) {
2340
180
        NetWhitelistPermissions subnet;
2341
180
        ConnectionDirection connection_direction;
2342
180
        bilingual_str error;
2343
180
        if (!NetWhitelistPermissions::TryParse(net, subnet, connection_direction, error)) return InitError(error);
2344
177
        if (connection_direction & ConnectionDirection::In) {
2345
176
            connOptions.vWhitelistedRangeIncoming.push_back(subnet);
2346
176
        }
2347
177
        if (connection_direction & ConnectionDirection::Out) {
2348
144
            connOptions.vWhitelistedRangeOutgoing.push_back(subnet);
2349
144
        }
2350
177
    }
2351
2352
1.11k
    connOptions.vSeedNodes = args.GetArgs("-seednode");
2353
2354
1.11k
    const auto connect = args.GetArgs("-connect");
2355
1.11k
    if (!connect.empty() || args.IsArgNegated("-connect")) {
2356
        // Do not initiate other outgoing connections when connecting to trusted
2357
        // nodes, or when -noconnect is specified.
2358
1.06k
        connOptions.m_use_addrman_outgoing = false;
2359
2360
1.06k
        if (connect.size() != 1 || connect[0] != "0") {
2361
9
            connOptions.m_specified_outgoing = connect;
2362
9
        }
2363
1.06k
        if (!connOptions.m_specified_outgoing.empty() && !connOptions.vSeedNodes.empty()) {
2364
1
            LogInfo("-seednode is ignored when -connect is used");
2365
1
        }
2366
2367
1.06k
        if (args.IsArgSet("-dnsseed") && args.GetBoolArg("-dnsseed", DEFAULT_DNSSEED) && args.IsArgSet("-proxy")) {
2368
12
            LogInfo("-dnsseed is ignored when -connect is used and -proxy is specified");
2369
12
        }
2370
1.06k
    }
2371
2372
1.11k
    const std::string& i2psam_arg = args.GetArg("-i2psam", "");
2373
1.11k
    if (!i2psam_arg.empty()) {
2374
8
        const std::optional<CService> addr{Lookup(i2psam_arg, 7656, fNameLookup)};
2375
8
        if (!addr.has_value() || !addr->IsValid()) {
2376
1
            return InitError(strprintf(_("Invalid -i2psam address or hostname: '%s'"), i2psam_arg));
2377
1
        }
2378
7
        SetProxy(NET_I2P, Proxy{addr.value()});
2379
1.10k
    } else {
2380
1.10k
        if (!onlynets.empty() && g_reachable_nets.Contains(NET_I2P)) {
2381
1
            return InitError(
2382
1
                _("Outbound connections restricted to i2p (-onlynet=i2p) but "
2383
1
                  "-i2psam is not provided"));
2384
1
        }
2385
1.10k
        g_reachable_nets.Remove(NET_I2P);
2386
1.10k
    }
2387
2388
1.11k
    connOptions.m_i2p_accept_incoming = args.GetBoolArg("-i2pacceptincoming", DEFAULT_I2P_ACCEPT_INCOMING);
2389
2390
1.11k
    if (auto conflict = CheckBindingConflicts(connOptions)) {
2391
6
        return InitError(strprintf(
2392
6
            _("Duplicate binding configuration for address %s. "
2393
6
                "Please check your -bind, -bind=...=onion and -whitebind settings."),
2394
6
                    conflict->ToStringAddrPort()));
2395
6
    }
2396
2397
1.10k
    if (args.GetBoolArg("-privatebroadcast", DEFAULT_PRIVATE_BROADCAST)) {
2398
        // If -listenonion is set, then NET_ONION may not be reachable now
2399
        // but may become reachable later, thus only error here if it is not
2400
        // reachable and will not become reachable for sure.
2401
9
        const bool onion_may_become_reachable{listenonion && (!args.IsArgSet("-onlynet") || onlynet_used_with_onion)};
2402
9
        if (!g_reachable_nets.Contains(NET_I2P) &&
2403
9
            !g_reachable_nets.Contains(NET_ONION) &&
2404
9
            !onion_may_become_reachable) {
2405
1
            return InitError(_("Private broadcast of own transactions requested (-privatebroadcast), "
2406
1
                               "but none of Tor or I2P networks is reachable"));
2407
1
        }
2408
8
        if (!connOptions.m_use_addrman_outgoing) {
2409
1
            return InitError(_("Private broadcast of own transactions requested (-privatebroadcast), "
2410
1
                               "but -connect is also configured. They are incompatible because the "
2411
1
                               "private broadcast needs to open new connections to randomly "
2412
1
                               "chosen Tor or I2P peers. Consider using -maxconnections=0 -addnode=... "
2413
1
                               "instead"));
2414
1
        }
2415
7
        if (!proxyRandomize && (g_reachable_nets.Contains(NET_ONION) || onion_may_become_reachable)) {
2416
1
            InitWarning(_("Private broadcast of own transactions requested (-privatebroadcast) and "
2417
1
                          "-proxyrandomize is disabled. Tor circuits for private broadcast connections "
2418
1
                          "may be correlated to other connections over Tor. To reduce this risk, set "
2419
1
                          "-proxyrandomize=1."));
2420
1
        }
2421
7
    }
2422
2423
1.10k
    if (!node.connman->Start(scheduler, connOptions)) {
2424
11
        return false;
2425
11
    }
2426
2427
    // ********************************************************* Step 13: finished
2428
2429
    // At this point, the RPC is "started", but still in warmup, which means it
2430
    // cannot yet be called. Before we make it callable, we need to make sure
2431
    // that the RPC's view of the best block is valid and consistent with
2432
    // ChainstateManager's active tip.
2433
1.09k
    SetRPCWarmupFinished();
2434
2435
1.09k
    uiInterface.InitMessage(_("Done loading"));
2436
2437
1.09k
    for (const auto& client : node.chain_clients) {
2438
376
        client->start(scheduler);
2439
376
    }
2440
2441
1.09k
    BanMan* banman = node.banman.get();
2442
1.09k
    scheduler.scheduleEvery([banman]{
2443
11
        banman->DumpBanlist();
2444
11
    }, DUMP_BANS_INTERVAL);
2445
2446
1.09k
    if (node.peerman) node.peerman->StartScheduledTasks(scheduler);
2447
2448
1.09k
#if HAVE_SYSTEM
2449
1.09k
    StartupNotify(args);
2450
1.09k
#endif
2451
2452
1.09k
    return true;
2453
1.10k
}
2454
2455
bool StartIndexBackgroundSync(NodeContext& node)
2456
1.11k
{
2457
1.11k
    ChainstateManager& chainman = *Assert(node.chainman);
2458
1.11k
    const Chainstate& chainstate = WITH_LOCK(::cs_main, return chainman.ValidatedChainstate());
2459
1.11k
    const CChain& index_chain = chainstate.m_chain;
2460
1.11k
    const int current_height = WITH_LOCK(::cs_main, return index_chain.Height());
2461
2462
    // Skip checking data availability if we have not synced any blocks yet
2463
1.11k
    if (current_height > 0) {
2464
        // Before starting index sync, verify that all required block data is available
2465
        // on disk from each index's current sync position up to the chain tip.
2466
        //
2467
        // This is done separately for undo and block data: First we verify block + undo
2468
        // data existence from tip down to the lowest height required by any index that
2469
        // needs undo data (e.g., coinstatsindex, blockfilterindex). Then, if any
2470
        // block-only index needs to sync from a lower height than previously covered,
2471
        // verify block data existence down to that lower height.
2472
        //
2473
        // This avoids checking undo data for blocks where no index requires it,
2474
        // though currently block and undo data availability are synchronized on disk
2475
        // under normal circumstances.
2476
673
        std::optional<const CBlockIndex*> block_start;
2477
673
        std::string block_start_name;
2478
673
        std::optional<const CBlockIndex*> undo_start;
2479
673
        std::string undo_start_name;
2480
2481
673
        for (const auto& index : node.indexes) {
2482
119
            const IndexSummary& summary = index->GetSummary();
2483
119
            if (summary.synced) continue;
2484
2485
            // Get the last common block between the index best block and the active chain
2486
74
            const CBlockIndex* pindex = nullptr;
2487
74
            {
2488
74
                LOCK(::cs_main);
2489
74
                pindex = chainman.m_blockman.LookupBlockIndex(summary.best_block_hash);
2490
74
                if (!pindex) {
2491
0
                    LogWarning("Failed to find block manager entry for best block %s from %s, falling back to genesis for index sync",
2492
0
                        summary.best_block_hash.ToString(), summary.name);
2493
74
                } else if (!index_chain.Contains(*pindex)) {
2494
1
                    pindex = index_chain.FindFork(*pindex);
2495
1
                }
2496
74
            }
2497
74
            if (!pindex) {
2498
0
                pindex = index_chain.Genesis();
2499
0
            }
2500
2501
74
            bool need_undo = index->CustomOptions().connect_undo_data;
2502
74
            auto& op_start_index = need_undo ? undo_start : block_start;
2503
74
            auto& name_index = need_undo ? undo_start_name : block_start_name;
2504
2505
74
            if (op_start_index && pindex->nHeight >= op_start_index.value()->nHeight) continue;
2506
49
            op_start_index = pindex;
2507
49
            name_index = summary.name;
2508
49
        }
2509
2510
        // Verify all blocks needed to sync to current tip are present including undo data.
2511
673
        if (undo_start) {
2512
24
            LOCK(::cs_main);
2513
24
            if (!chainman.m_blockman.CheckBlockDataAvailability(*index_chain.Tip(), *Assert(undo_start.value()), BlockStatus{BLOCK_HAVE_DATA | BLOCK_HAVE_UNDO})) {
2514
0
                return InitError(Untranslated(strprintf("%s best block of the index goes beyond pruned data (including undo data). Please disable the index or reindex (which will download the whole blockchain again)", undo_start_name)));
2515
0
            }
2516
24
        }
2517
2518
        // Verify all blocks needed to sync to current tip are present unless we already checked all of them above.
2519
673
        if (block_start && !(undo_start && undo_start.value()->nHeight <= block_start.value()->nHeight)) {
2520
6
            LOCK(::cs_main);
2521
6
            if (!chainman.m_blockman.CheckBlockDataAvailability(*index_chain.Tip(), *Assert(block_start.value()), BlockStatus{BLOCK_HAVE_DATA})) {
2522
0
                return InitError(Untranslated(strprintf("%s best block of the index goes beyond pruned data. Please disable the index or reindex (which will download the whole blockchain again)", block_start_name)));
2523
0
            }
2524
6
        }
2525
673
    }
2526
2527
    // Start threads
2528
1.11k
    for (auto index : node.indexes) if (!index->StartBackgroundSync()) return false;
2529
1.11k
    return true;
2530
1.11k
}