fuzz coverage

// Copyright (c) 2009-2010 Satoshi Nakamoto

// Copyright (c) 2009-2022 The Bitcoin Core developers

// Distributed under the MIT software license, see the accompanying

// file COPYING or http://www.opensource.org/licenses/mit-license.php.

#include <bitcoin-build-config.h> // IWYU pragma: keep

#include <init.h>

#include <kernel/checks.h>

#include <addrman.h>

#include <banman.h>

#include <blockfilter.h>

#include <chain.h>

#include <chainparams.h>

#include <chainparamsbase.h>

#include <clientversion.h>

#include <common/args.h>

#include <common/system.h>

#include <consensus/amount.h>

#include <consensus/consensus.h>

#include <deploymentstatus.h>

#include <hash.h>

#include <httprpc.h>

#include <httpserver.h>

#include <index/blockfilterindex.h>

#include <index/coinstatsindex.h>

#include <index/txindex.h>

#include <init/common.h>

#include <interfaces/chain.h>

#include <interfaces/init.h>

#include <interfaces/ipc.h>

#include <interfaces/mining.h>

#include <interfaces/node.h>

#include <kernel/caches.h>

#include <kernel/context.h>

#include <key.h>

#include <logging.h>

#include <mapport.h>

#include <net.h>

#include <net_permissions.h>

#include <net_processing.h>

#include <netbase.h>

#include <netgroup.h>

#include <node/blockmanager_args.h>

#include <node/blockstorage.h>

#include <node/caches.h>

#include <node/chainstate.h>

#include <node/chainstatemanager_args.h>

#include <node/context.h>

#include <node/interface_ui.h>

#include <node/kernel_notifications.h>

#include <node/mempool_args.h>

#include <node/mempool_persist.h>

#include <node/mempool_persist_args.h>

#include <node/miner.h>

#include <node/peerman_args.h>

#include <policy/feerate.h>

#include <policy/fees.h>

#include <policy/fees_args.h>

#include <policy/policy.h>

#include <policy/settings.h>

#include <protocol.h>

#include <rpc/blockchain.h>

#include <rpc/register.h>

#include <rpc/server.h>

#include <rpc/util.h>

#include <scheduler.h>

#include <script/sigcache.h>

#include <sync.h>

#include <torcontrol.h>

#include <txdb.h>

#include <txmempool.h>

#include <util/asmap.h>

#include <util/batchpriority.h>

#include <util/chaintype.h>

#include <util/check.h>

#include <util/fs.h>

#include <util/fs_helpers.h>

#include <util/moneystr.h>

#include <util/result.h>

#include <util/signalinterrupt.h>

#include <util/strencodings.h>

#include <util/string.h>

#include <util/syserror.h>

#include <util/thread.h>

#include <util/threadnames.h>

#include <util/time.h>

#include <util/translation.h>

#include <validation.h>

#include <validationinterface.h>

#include <walletinitinterface.h>

#include <algorithm>

#include <condition_variable>

#include <cstdint>

#include <cstdio>

#include <fstream>

#include <functional>

#include <set>

#include <string>

#include <thread>

#include <vector>

#ifndef WIN32

#include <cerrno>

#include <signal.h>

#include <sys/stat.h>

#endif

#include <boost/signals2/signal.hpp>

#ifdef ENABLE_ZMQ

#include <zmq/zmqabstractnotifier.h>

#include <zmq/zmqnotificationinterface.h>

#include <zmq/zmqrpc.h>

#endif

using common::AmountErrMsg;

using common::InvalidPortErrMsg;

using common::ResolveErrMsg;

using node::ApplyArgsManOptions;

using node::BlockManager;

using node::CalculateCacheSizes;

using node::ChainstateLoadResult;

using node::ChainstateLoadStatus;

using node::DEFAULT_PERSIST_MEMPOOL;

using node::DEFAULT_PRINT_MODIFIED_FEE;

using node::DEFAULT_STOPATHEIGHT;

using node::DumpMempool;

using node::ImportBlocks;

using node::KernelNotifications;

using node::LoadChainstate;

using node::LoadMempool;

using node::MempoolPath;

using node::NodeContext;

using node::ShouldPersistMempool;

using node::VerifyLoadedChainstate;

using util::Join;

using util::ReplaceAll;

using util::ToString;

static constexpr bool DEFAULT_PROXYRANDOMIZE{true};

static constexpr bool DEFAULT_REST_ENABLE{false};

static constexpr bool DEFAULT_I2P_ACCEPT_INCOMING{true};

static constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT{false};

#ifdef WIN32

// Win32 LevelDB doesn't use filedescriptors, and the ones used for

// accessing block files don't count towards the fd_set size limit

// anyway.

#define MIN_LEVELDB_FDS 0

#else

#define MIN_LEVELDB_FDS 150

#endif

static constexpr int MIN_CORE_FDS = MIN_LEVELDB_FDS + NUM_FDS_MESSAGE_CAPTURE;

static const char* DEFAULT_ASMAP_FILENAME="ip_asn.map";

/**

 * The PID file facilities.

 */

static const char* BITCOIN_PID_FILENAME = "bitcoind.pid";

/**

 * True if this process has created a PID file.

 * Used to determine whether we should remove the PID file on shutdown.

 */

static bool g_generated_pid{false};

static fs::path GetPidFile(const ArgsManager& args)

{

    return AbsPathForConfigVal(args, args.GetPathArg("-pid", BITCOIN_PID_FILENAME));

}

[[nodiscard]] static bool CreatePidFile(const ArgsManager& args)

{

    if (args.IsArgNegated("-pid")) return true;

    std::ofstream file{GetPidFile(args)};

    if (file) {

#ifdef WIN32

        tfm::format(file, "%d\n", GetCurrentProcessId());

#else

        tfm::format(file, "%d\n", getpid());

#endif

        g_generated_pid = true;

        return true;

    } else {

        return InitError(strprintf(_("Unable to create the PID file '%s': %s"), fs::PathToString(GetPidFile(args)), SysErrorString(errno)));

Line

Count

Source

1172

0

#define strprintf tfm::format

    }

}

static void RemovePidFile(const ArgsManager& args)

{

    if (!g_generated_pid) return;

    const auto pid_path{GetPidFile(args)};

    if (std::error_code error; !fs::remove(pid_path, error)) {

        std::string msg{error ? error.message() : "File does not exist"};

        LogPrintf("Unable to remove PID file (%s): %s\n", fs::PathToString(pid_path), msg);

Line

Count

Source

266

0

#define LogPrintf(...) LogInfo(__VA_ARGS__)

Line

Count

Source

261

0

#define LogInfo(...) LogPrintLevel_(BCLog::LogFlags::ALL, BCLog::Level::Info, __VA_ARGS__)

Line

Count

Source

255

0

#define LogPrintLevel_(category, level, ...) LogPrintFormatInternal(__func__, __FILE__, __LINE__, category, level, __VA_ARGS__)

    }

}

static std::optional<util::SignalInterrupt> g_shutdown;

void InitContext(NodeContext& node)

{

    assert(!g_shutdown);

    g_shutdown.emplace();

    node.args = &gArgs;

    node.shutdown_signal = &*g_shutdown;

    node.shutdown_request = [&node] {

        assert(node.shutdown_signal);

        if (!(*node.shutdown_signal)()) return false;

        // Wake any threads that may be waiting for the tip to change.

        if (node.notifications) WITH_LOCK(node.notifications->m_tip_block_mutex, node.notifications->m_tip_block_cv.notify_all());

Line

Count

Source

301

0

#define WITH_LOCK(cs, code) (MaybeCheckNotHeld(cs), [&]() -> decltype(auto) { LOCK(cs); code; }())

        return true;

    };

}

//////////////////////////////////////////////////////////////////////////////

//

// Shutdown

//

//

// Thread management and startup/shutdown:

//

// The network-processing threads are all part of a thread group

// created by AppInit() or the Qt main() function.

//

// A clean exit happens when the SignalInterrupt object is triggered, which

// makes the main thread's SignalInterrupt::wait() call return, and join all

// other ongoing threads in the thread group to the main thread.

// Shutdown() is then called to clean up database connections, and stop other

// threads that should only be stopped after the main network-processing

// threads have exited.

//

// Shutdown for Qt is very similar, only it uses a QTimer to detect

// ShutdownRequested() getting set, and then does the normal Qt

// shutdown thing.

//

bool ShutdownRequested(node::NodeContext& node)

{

    return bool{*Assert(node.shutdown_signal)};

Line

Count

Source

106

0

#define Assert(val) inline_assertion_check<true>(val, __FILE__, __LINE__, __func__, #val)

}

#if HAVE_SYSTEM

static void ShutdownNotify(const ArgsManager& args)

{

    std::vector<std::thread> threads;

    for (const auto& cmd : args.GetArgs("-shutdownnotify")) {

        threads.emplace_back(runCommand, cmd);

    }

    for (auto& t : threads) {

        t.join();

    }

}

#endif

void Interrupt(NodeContext& node)

{

#if HAVE_SYSTEM

    ShutdownNotify(*node.args);

#endif

    InterruptHTTPServer();

    InterruptHTTPRPC();

    InterruptRPC();

    InterruptREST();

    InterruptTorControl();

    InterruptMapPort();

    if (node.connman)

        node.connman->Interrupt();

    for (auto* index : node.indexes) {

        index->Interrupt();

    }

}

void Shutdown(NodeContext& node)

{

    static Mutex g_shutdown_mutex;

    TRY_LOCK(g_shutdown_mutex, lock_shutdown);

Line

Count

Source

261

0

#define TRY_LOCK(cs, name) UniqueLock name(MaybeCheckNotHeld(cs), #cs, __FILE__, __LINE__, true)

    if (!lock_shutdown) return;

    LogPrintf("%s: In progress...\n", __func__);

Line

Count

Source

266

0

#define LogPrintf(...) LogInfo(__VA_ARGS__)

Line

Count

Source

261

0

#define LogInfo(...) LogPrintLevel_(BCLog::LogFlags::ALL, BCLog::Level::Info, __VA_ARGS__)

Line

Count

Source

255

0

#define LogPrintLevel_(category, level, ...) LogPrintFormatInternal(__func__, __FILE__, __LINE__, category, level, __VA_ARGS__)

    Assert(node.args);

Line

Count

Source

106

0

#define Assert(val) inline_assertion_check<true>(val, __FILE__, __LINE__, __func__, #val)

    /// Note: Shutdown() must be able to handle cases in which initialization failed part of the way,

    /// for example if the data directory was found to be locked.

    /// Be sure that anything that writes files or flushes caches only does this if the respective

    /// module was initialized.

    util::ThreadRename("shutoff");

    if (node.mempool) node.mempool->AddTransactionsUpdated(1);

    StopHTTPRPC();

    StopREST();

    StopRPC();

    StopHTTPServer();

    for (const auto& client : node.chain_clients) {

        client->flush();

    }

    StopMapPort();

    // Because these depend on each-other, we make sure that neither can be

    // using the other before destroying them.

    if (node.peerman && node.validation_signals) node.validation_signals->UnregisterValidationInterface(node.peerman.get());

    if (node.connman) node.connman->Stop();

    StopTorControl();

    if (node.background_init_thread.joinable()) node.background_init_thread.join();

    // After everything has been shut down, but before things get flushed, stop the

    // the scheduler. After this point, SyncWithValidationInterfaceQueue() should not be called anymore

    // as this would prevent the shutdown from completing.

    if (node.scheduler) node.scheduler->stop();

    // After the threads that potentially access these pointers have been stopped,

    // destruct and reset all to nullptr.

    node.peerman.reset();

    node.connman.reset();

    node.banman.reset();

    node.addrman.reset();

    node.netgroupman.reset();

    if (node.mempool && node.mempool->GetLoadTried() && ShouldPersistMempool(*node.args)) {

        DumpMempool(*node.mempool, MempoolPath(*node.args));

    }

    // Drop transactions we were still watching, record fee estimations and unregister

    // fee estimator from validation interface.

    if (node.fee_estimator) {

        node.fee_estimator->Flush();

        if (node.validation_signals) {

            node.validation_signals->UnregisterValidationInterface(node.fee_estimator.get());

        }

    }

    // FlushStateToDisk generates a ChainStateFlushed callback, which we should avoid missing

    if (node.chainman) {

        LOCK(cs_main);

Line

Count

Source

257

0

#define LOCK(cs) UniqueLock UNIQUE_NAME(criticalblock)(MaybeCheckNotHeld(cs), #cs, __FILE__, __LINE__)

Line

Count

Source

11

0

#define UNIQUE_NAME(name) PASTE2(name, __COUNTER__)

Line

Count

Source

9

0

#define PASTE2(x, y) PASTE(x, y)

Line

Count

Source

8

0

#define PASTE(x, y) x ## y

        for (Chainstate* chainstate : node.chainman->GetAll()) {

            if (chainstate->CanFlushToDisk()) {

                chainstate->ForceFlushStateToDisk();

            }

        }

    }

    // After there are no more peers/RPC left to give us new data which may generate

    // CValidationInterface callbacks, flush them...

    if (node.validation_signals) node.validation_signals->FlushBackgroundCallbacks();

    // Stop and delete all indexes only after flushing background callbacks.

    for (auto* index : node.indexes) index->Stop();

    if (g_txindex) g_txindex.reset();

    if (g_coin_stats_index) g_coin_stats_index.reset();

    DestroyAllBlockFilterIndexes();

    node.indexes.clear(); // all instances are nullptr now

    // Any future callbacks will be dropped. This should absolutely be safe - if

    // missing a callback results in an unrecoverable situation, unclean shutdown

    // would too. The only reason to do the above flushes is to let the wallet catch

    // up with our current chain to avoid any strange pruning edge cases and make

    // next startup faster by avoiding rescan.

    if (node.chainman) {

        LOCK(cs_main);

Line

Count

Source

257

0

#define LOCK(cs) UniqueLock UNIQUE_NAME(criticalblock)(MaybeCheckNotHeld(cs), #cs, __FILE__, __LINE__)

Line

Count

Source

11

0

#define UNIQUE_NAME(name) PASTE2(name, __COUNTER__)

Line

Count

Source

9

0

#define PASTE2(x, y) PASTE(x, y)

Line

Count

Source

8

0

#define PASTE(x, y) x ## y

        for (Chainstate* chainstate : node.chainman->GetAll()) {

            if (chainstate->CanFlushToDisk()) {

                chainstate->ForceFlushStateToDisk();

                chainstate->ResetCoinsViews();

            }

        }

    }

    for (const auto& client : node.chain_clients) {

        client->stop();

    }

#ifdef ENABLE_ZMQ

    if (g_zmq_notification_interface) {

        if (node.validation_signals) node.validation_signals->UnregisterValidationInterface(g_zmq_notification_interface.get());

        g_zmq_notification_interface.reset();

    }

#endif

    node.chain_clients.clear();

    if (node.validation_signals) {

        node.validation_signals->UnregisterAllValidationInterfaces();

    }

    node.mempool.reset();

    node.fee_estimator.reset();

    node.chainman.reset();

    node.validation_signals.reset();

    node.scheduler.reset();

    node.ecc_context.reset();

    node.kernel.reset();

    RemovePidFile(*node.args);

    LogPrintf("%s: done\n", __func__);

Line

Count

Source

266

0

#define LogPrintf(...) LogInfo(__VA_ARGS__)

Line

Count

Source

261

0

#define LogInfo(...) LogPrintLevel_(BCLog::LogFlags::ALL, BCLog::Level::Info, __VA_ARGS__)

Line

Count

Source

255

0

#define LogPrintLevel_(category, level, ...) LogPrintFormatInternal(__func__, __FILE__, __LINE__, category, level, __VA_ARGS__)

}

/**

 * Signal handlers are very limited in what they are allowed to do.

 * The execution context the handler is invoked in is not guaranteed,

 * so we restrict handler operations to just touching variables:

 */

#ifndef WIN32

static void HandleSIGTERM(int)

{

    // Return value is intentionally ignored because there is not a better way

    // of handling this failure in a signal handler.

    (void)(*Assert(g_shutdown))();

Line

Count

Source

106

0

#define Assert(val) inline_assertion_check<true>(val, __FILE__, __LINE__, __func__, #val)

}

static void HandleSIGHUP(int)

{

    LogInstance().m_reopen_file = true;

}

#else

static BOOL WINAPI consoleCtrlHandler(DWORD dwCtrlType)

{

    if (!(*Assert(g_shutdown))()) {

        LogError("Failed to send shutdown signal on Ctrl-C\n");

        return false;

    }

    Sleep(INFINITE);

    return true;

}

#endif

#ifndef WIN32

static void registerSignalHandler(int signal, void(*handler)(int))

{

    struct sigaction sa;

    sa.sa_handler = handler;

    sigemptyset(&sa.sa_mask);

    sa.sa_flags = 0;

    sigaction(signal, &sa, nullptr);

}

#endif

void SetupServerArgs(ArgsManager& argsman, bool can_listen_ipc)

{

    SetupHelpOptions(argsman);

    argsman.AddArg("-help-debug", "Print help message with debugging options and exit", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST); // server-only for now

    init::AddLoggingArgs(argsman);

    const auto defaultBaseParams = CreateBaseChainParams(ChainType::MAIN);

    const auto testnetBaseParams = CreateBaseChainParams(ChainType::TESTNET);

    const auto testnet4BaseParams = CreateBaseChainParams(ChainType::TESTNET4);

    const auto signetBaseParams = CreateBaseChainParams(ChainType::SIGNET);

    const auto regtestBaseParams = CreateBaseChainParams(ChainType::REGTEST);

    const auto defaultChainParams = CreateChainParams(argsman, ChainType::MAIN);

    const auto testnetChainParams = CreateChainParams(argsman, ChainType::TESTNET);

    const auto testnet4ChainParams = CreateChainParams(argsman, ChainType::TESTNET4);

    const auto signetChainParams = CreateChainParams(argsman, ChainType::SIGNET);

    const auto regtestChainParams = CreateChainParams(argsman, ChainType::REGTEST);

    // Hidden Options

    std::vector<std::string> hidden_args = {

        "-dbcrashratio", "-forcecompactdb",

        // GUI args. These will be overwritten by SetupUIArgs for the GUI

        "-choosedatadir", "-lang=<lang>", "-min", "-resetguisettings", "-splash", "-uiplatform"};

    argsman.AddArg("-version", "Print version and exit", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

#if HAVE_SYSTEM

    argsman.AddArg("-alertnotify=<cmd>", "Execute command when an alert is raised (%s in cmd is replaced by message)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

#endif

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-blocksdir=<dir>", "Specify directory to hold blocks subdirectory for *.dat files (default: <datadir>)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    argsman.AddArg("-blocksxor",

                   strprintf("Whether an XOR-key applies to blocksdir *.dat files. "

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

                             "The created XOR-key will be zeros for an existing blocksdir or when `-blocksxor=0` is "

                             "set, and random for a freshly initialized blocksdir. "

                             "(default: %u)",

                             kernel::DEFAULT_XOR_BLOCKSDIR),

                   ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    argsman.AddArg("-fastprune", "Use smaller block files and lower minimum prune height for testing purposes", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

#if HAVE_SYSTEM

    argsman.AddArg("-blocknotify=<cmd>", "Execute command when the best block changes (%s in cmd is replaced by block hash)", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

#endif

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-coinstatsindex", strprintf("Maintain coinstats index used by the gettxoutsetinfo RPC (default: %u)", DEFAULT_COINSTATSINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-datadir=<dir>", "Specify data directory", ArgsManager::ALLOW_ANY | ArgsManager::DISALLOW_NEGATION, OptionsCategory::OPTIONS);

    argsman.AddArg("-dbbatchsize", strprintf("Maximum database write batch size in bytes (default: %u)", nDefaultDbBatchSize), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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_DB_CACHE >> 20, DEFAULT_DB_CACHE >> 20), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-loadblock=<file>", "Imports blocks from external file on startup", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-maxorphantx=<n>", strprintf("Keep at most <n> unconnectable transactions in memory (default: %u)", DEFAULT_MAX_ORPHAN_TRANSACTIONS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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)",

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

        MAX_SCRIPTCHECK_THREADS, DEFAULT_SCRIPTCHECK_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-persistmempoolv1",

                   strprintf("Whether a mempool.dat file created by -persistmempool or the savemempool RPC will be written in the legacy format "

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

                             "(version 1) or the current format (version 2). This temporary option will be removed in the future. (default: %u)",

                             DEFAULT_PERSIST_V1_DAT),

                   ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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. "

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

            "Warning: Reverting this setting requires re-downloading the entire blockchain. "

            "(default: 0 = disable pruning blocks, 1 = allow manual pruning via RPC, >=%u = automatically prune block files to stay under the specified target size in MiB)", MIN_DISK_SPACE_FOR_BLOCK_FILES / 1024 / 1024), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    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);

    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);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

#if HAVE_SYSTEM

    argsman.AddArg("-startupnotify=<cmd>", "Execute command on startup.", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    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);

#endif

    argsman.AddArg("-txindex", strprintf("Maintain a full transaction index, used by the getrawtransaction rpc call (default: %u)", DEFAULT_TXINDEX), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-blockfilterindex=<type>",

                 strprintf("Maintain an index of compact filters by block (default: %s, values: %s).", DEFAULT_BLOCKFILTERINDEX, ListBlockFilterTypes()) +

Line

Count

Source

1172

14.5k

#define strprintf tfm::format

                 " If <type> is not supplied or if <type> = 1, indexes for all known types are enabled.",

                 ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-asmap=<file>", strprintf("Specify asn mapping used for bucketing of the peers (default: %s). Relative paths will be prefixed by the net-specific datadir location.", DEFAULT_ASMAP_FILENAME), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-bantime=<n>", strprintf("Default duration (in seconds) of manually configured bans (default: %u)", DEFAULT_MISBEHAVING_BANTIME), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

    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);

    argsman.AddArg("-discover", "Discover own IP addresses (default: 1 when listening and no -externalip or -proxy)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

    argsman.AddArg("-dns", strprintf("Allow DNS lookups for -addnode, -seednode and -connect (default: %u)", DEFAULT_NAME_LOOKUP), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-externalip=<ip>", "Specify your own public address", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

    argsman.AddArg("-fixedseeds", strprintf("Allow fixed seeds if DNS seeds don't provide peers (default: %u)", DEFAULT_FIXEDSEEDS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-forcednsseed", strprintf("Always query for peer addresses via DNS lookup (default: %u)", DEFAULT_FORCEDNSSEED), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-listen", strprintf("Accept connections from outside (default: %u if no -proxy, -connect or -maxconnections=0)", DEFAULT_LISTEN), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-listenonion", strprintf("Automatically create Tor onion service (default: %d)", DEFAULT_LISTEN_ONION), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-maxconnections=<n>", strprintf("Maintain at most <n> automatic connections to peers (default: %u). This limit does not apply to connections manually added via -addnode or the addnode RPC, which have a separate limit of %u.", DEFAULT_MAX_PEER_CONNECTIONS, MAX_ADDNODE_CONNECTIONS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-maxreceivebuffer=<n>", strprintf("Maximum per-connection receive buffer, <n>*1000 bytes (default: %u)", DEFAULT_MAXRECEIVEBUFFER), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

#ifdef HAVE_SOCKADDR_UN

    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);

#else

    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);

#endif

    argsman.AddArg("-i2psam=<ip:port>", "I2P SAM proxy to reach I2P peers and accept I2P connections (default: none)", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

    argsman.AddArg("-v2transport", strprintf("Support v2 transport (default: %u)", DEFAULT_V2_TRANSPORT), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-peerbloomfilters", strprintf("Support filtering of blocks and transaction with bloom filters (default: %u)", DEFAULT_PEERBLOOMFILTERS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-peerblockfilters", strprintf("Serve compact block filters to peers per BIP 157 (default: %u)", DEFAULT_PEERBLOCKFILTERS), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-txreconciliation", strprintf("Enable transaction reconciliations per BIP 330 (default: %d)", DEFAULT_TXRECONCILIATION_ENABLE), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

#ifdef HAVE_SOCKADDR_UN

    argsman.AddArg("-proxy=<ip:port|path>", "Connect through SOCKS5 proxy, set -noproxy to disable (default: disabled). May be a local file path prefixed with 'unix:' if the proxy supports it.", ArgsManager::ALLOW_ANY | ArgsManager::DISALLOW_ELISION, OptionsCategory::CONNECTION);

#else

    argsman.AddArg("-proxy=<ip:port>", "Connect through SOCKS5 proxy, set -noproxy to disable (default: disabled)", ArgsManager::ALLOW_ANY | ArgsManager::DISALLOW_ELISION, OptionsCategory::CONNECTION);

#endif

    argsman.AddArg("-proxyrandomize", strprintf("Randomize credentials for every proxy connection. This enables Tor stream isolation (default: %u)", DEFAULT_PROXYRANDOMIZE), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

    argsman.AddArg("-networkactive", "Enable all P2P network activity (default: 1). Can be changed by the setnetworkactive RPC command", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-torpassword=<pass>", "Tor control port password (default: empty)", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::CONNECTION);

    // UPnP support was dropped. We keep `-upnp` as a hidden arg to display a more user friendly error when set. TODO: remove (here and below) for 30.0. NOTE: removing this option may prevent the GUI from starting, see https://github.com/bitcoin-core/gui/issues/843.

    argsman.AddArg("-upnp", "", ArgsManager::ALLOW_ANY, OptionsCategory::HIDDEN);

    argsman.AddArg("-natpmp", strprintf("Use PCP or NAT-PMP to map the listening port (default: %u)", DEFAULT_NATPMP), ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-whitebind=<[permissions@]addr>", "Bind to the given address and add permission flags to the peers connecting to it. "

        "Use [host]:port notation for IPv6. Allowed permissions: " + Join(NET_PERMISSIONS_DOC, ", ") + ". "

        "Specify multiple permissions separated by commas (default: download,noban,mempool,relay). Can be specified multiple times.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

    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 "

        "CIDR-notated network (e.g. 1.2.3.0/24). Uses the same permissions as "

        "-whitebind. "

        "Additional flags \"in\" and \"out\" control whether permissions apply to incoming connections and/or manual (default: incoming only). "

        "Can be specified multiple times.", ArgsManager::ALLOW_ANY, OptionsCategory::CONNECTION);

    g_wallet_init_interface.AddWalletOptions(argsman);

#ifdef ENABLE_ZMQ

    argsman.AddArg("-zmqpubhashblock=<address>", "Enable publish hash block in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);

    argsman.AddArg("-zmqpubhashtx=<address>", "Enable publish hash transaction in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);

    argsman.AddArg("-zmqpubrawblock=<address>", "Enable publish raw block in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);

    argsman.AddArg("-zmqpubrawtx=<address>", "Enable publish raw transaction in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);

    argsman.AddArg("-zmqpubsequence=<address>", "Enable publish hash block and tx sequence in <address>", ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);

    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);

    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);

    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);

    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);

    argsman.AddArg("-zmqpubsequencehwm=<n>", strprintf("Set publish hash sequence message high water mark (default: %d)", CZMQAbstractNotifier::DEFAULT_ZMQ_SNDHWM), ArgsManager::ALLOW_ANY, OptionsCategory::ZMQ);

#else

    hidden_args.emplace_back("-zmqpubhashblock=<address>");

    hidden_args.emplace_back("-zmqpubhashtx=<address>");

    hidden_args.emplace_back("-zmqpubrawblock=<address>");

    hidden_args.emplace_back("-zmqpubrawtx=<address>");

    hidden_args.emplace_back("-zmqpubsequence=<n>");

    hidden_args.emplace_back("-zmqpubhashblockhwm=<n>");

    hidden_args.emplace_back("-zmqpubhashtxhwm=<n>");

    hidden_args.emplace_back("-zmqpubrawblockhwm=<n>");

    hidden_args.emplace_back("-zmqpubrawtxhwm=<n>");

    hidden_args.emplace_back("-zmqpubsequencehwm=<n>");

#endif

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    // Checkpoints were removed. We keep `-checkpoints` as a hidden arg to display a more user friendly error when set.

    argsman.AddArg("-checkpoints", "", ArgsManager::ALLOW_ANY, OptionsCategory::HIDDEN);

    argsman.AddArg("-deprecatedrpc=<method>", "Allows deprecated RPC method(s) to be used", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

    argsman.AddArg("-stopafterblockimport", strprintf("Stop running after importing blocks from disk (default: %u)", DEFAULT_STOPAFTERBLOCKIMPORT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-stopatheight", strprintf("Stop running after reaching the given height in the main chain (default: %u)", DEFAULT_STOPATHEIGHT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-limitancestorcount=<n>", strprintf("Do not accept transactions if number of in-mempool ancestors is <n> or more (default: %u)", DEFAULT_ANCESTOR_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-limitancestorsize=<n>", strprintf("Do not accept transactions whose size with all in-mempool ancestors exceeds <n> kilobytes (default: %u)", DEFAULT_ANCESTOR_SIZE_LIMIT_KVB), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-limitdescendantcount=<n>", strprintf("Do not accept transactions if any ancestor would have <n> or more in-mempool descendants (default: %u)", DEFAULT_DESCENDANT_LIMIT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-limitdescendantsize=<n>", strprintf("Do not accept transactions if any ancestor would have more than <n> kilobytes of in-mempool descendants (default: %u).", DEFAULT_DESCENDANT_SIZE_LIMIT_KVB), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-test=<option>", "Pass a test-only option. Options include : " + Join(TEST_OPTIONS_DOC, ", ") + ".", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

    argsman.AddArg("-capturemessages", "Capture all P2P messages to disk", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

    argsman.AddArg("-mocktime=<n>", "Replace actual time with " + UNIX_EPOCH_TIME + " (default: 0)", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-maxtipage=<n>",

                   strprintf("Maximum tip age in seconds to consider node in initial block download (default: %u)",

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

                             Ticks<std::chrono::seconds>(DEFAULT_MAX_TIP_AGE)),

                   ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::DEBUG_TEST);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-uacomment=<cmt>", "Append comment to the user agent string", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST);

    SetupChainParamsBaseOptions(argsman);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-datacarrier", strprintf("Relay and mine data carrier transactions (default: %u)", DEFAULT_ACCEPT_DATACARRIER), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-datacarriersize",

                   strprintf("Relay and mine transactions whose data-carrying raw scriptPubKey "

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

                             "is of this size or less (default: %u)",

                             MAX_OP_RETURN_RELAY),

                   ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);

    argsman.AddArg("-permitbaremultisig", strprintf("Relay transactions creating non-P2SH multisig outputs (default: %u)", DEFAULT_PERMIT_BAREMULTISIG), ArgsManager::ALLOW_ANY,

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

                   OptionsCategory::NODE_RELAY);

    argsman.AddArg("-minrelaytxfee=<amt>", strprintf("Fees (in %s/kvB) smaller than this are considered zero fee for relaying, mining and transaction creation (default: %s)",

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

        CURRENCY_UNIT, FormatMoney(DEFAULT_MIN_RELAY_TX_FEE)), ArgsManager::ALLOW_ANY, OptionsCategory::NODE_RELAY);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-blockmaxweight=<n>", strprintf("Set maximum BIP141 block weight (default: %d)", DEFAULT_BLOCK_MAX_WEIGHT), ArgsManager::ALLOW_ANY, OptionsCategory::BLOCK_CREATION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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. (default: %d).", DEFAULT_BLOCK_RESERVED_WEIGHT), ArgsManager::ALLOW_ANY, OptionsCategory::BLOCK_CREATION);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-blockversion=<n>", "Override block version to test forking scenarios", ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::BLOCK_CREATION);

    argsman.AddArg("-rest", strprintf("Accept public REST requests (default: %u)", DEFAULT_REST_ENABLE), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-rpcallowip=<ip>", "Allow JSON-RPC connections from specified source. Valid values for <ip> are a single IP (e.g. 1.2.3.4), a network/netmask (e.g. 1.2.3.4/255.255.255.0), a network/CIDR (e.g. 1.2.3.4/24), all ipv4 (0.0.0.0/0), or all ipv6 (::/0). This option can be specified multiple times", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);

    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);

    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);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    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);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-rpcpassword=<pw>", "Password for JSON-RPC connections", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-rpcservertimeout=<n>", strprintf("Timeout during HTTP requests (default: %d)", DEFAULT_HTTP_SERVER_TIMEOUT), ArgsManager::ALLOW_ANY | ArgsManager::DEBUG_ONLY, OptionsCategory::RPC);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-rpcthreads=<n>", strprintf("Set the number of threads to service RPC calls (default: %d)", DEFAULT_HTTP_THREADS), ArgsManager::ALLOW_ANY, OptionsCategory::RPC);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-rpcuser=<user>", "Username for JSON-RPC connections", ArgsManager::ALLOW_ANY | ArgsManager::SENSITIVE, OptionsCategory::RPC);

    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);

    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);

    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);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-server", "Accept command line and JSON-RPC commands", ArgsManager::ALLOW_ANY, OptionsCategory::RPC);

    if (can_listen_ipc) {

        argsman.AddArg("-ipcbind=<address>", "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. 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.", ArgsManager::ALLOW_ANY, OptionsCategory::IPC);

    }

#if HAVE_DECL_FORK

    argsman.AddArg("-daemon", strprintf("Run in the background as a daemon and accept commands (default: %d)", DEFAULT_DAEMON), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

    argsman.AddArg("-daemonwait", strprintf("Wait for initialization to be finished before exiting. This implies -daemon (default: %d)", DEFAULT_DAEMONWAIT), ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);

Line

Count

Source

1172

7.28k

#define strprintf tfm::format

#else

    hidden_args.emplace_back("-daemon");

    hidden_args.emplace_back("-daemonwait");

#endif

    // Add the hidden options

    argsman.AddHiddenArgs(hidden_args);

}

#if HAVE_SYSTEM

static void StartupNotify(const ArgsManager& args)

{

    std::string cmd = args.GetArg("-startupnotify", "");

    if (!cmd.empty()) {

        std::thread t(runCommand, cmd);

        t.detach(); // thread runs free

    }

}

#endif

static bool AppInitServers(NodeContext& node)

{

    const ArgsManager& args = *Assert(node.args);

Line

Count

Source

106

0

#define Assert(val) inline_assertion_check<true>(val, __FILE__, __LINE__, __func__, #val)

    if (!InitHTTPServer(*Assert(node.shutdown_signal))) {

Line

Count

Source

106

0

#define Assert(val) inline_assertion_check<true>(val, __FILE__, __LINE__, __func__, #val)

        return false;

    }

    StartRPC();

    node.rpc_interruption_point = RpcInterruptionPoint;

    if (!StartHTTPRPC(&node))

        return false;

    if (args.GetBoolArg("-rest", DEFAULT_REST_ENABLE)) StartREST(&node);

    StartHTTPServer();

    return true;

}

// Parameter interaction based on rules

void InitParameterInteraction(ArgsManager& args)

{

    // when specifying an explicit binding address, you want to listen on it

    // even when -connect or -proxy is specified

    if (!args.GetArgs("-bind").empty()) {

        if (args.SoftSetBoolArg("-listen", true))

            LogInfo("parameter interaction: -bind set -> setting -listen=1\n");

Line

Count

Source