diff --git a/configure.ac b/configure.ac index 11c5da551b..fb897f4fc7 100644 --- a/configure.ac +++ b/configure.ac @@ -1,9 +1,9 @@ AC_PREREQ([2.69]) -define(_CLIENT_VERSION_MAJOR, 26) -define(_CLIENT_VERSION_MINOR, 99) +define(_CLIENT_VERSION_MAJOR, 27) +define(_CLIENT_VERSION_MINOR, 0) define(_CLIENT_VERSION_BUILD, 0) -define(_CLIENT_VERSION_RC, 0) -define(_CLIENT_VERSION_IS_RELEASE, false) +define(_CLIENT_VERSION_RC, 1) +define(_CLIENT_VERSION_IS_RELEASE, true) define(_COPYRIGHT_YEAR, 2024) define(_COPYRIGHT_HOLDERS,[The %s developers]) define(_COPYRIGHT_HOLDERS_SUBSTITUTION,[[Bitcoin Core and Namecoin]]) diff --git a/doc/man/namecoin-cli.1 b/doc/man/namecoin-cli.1 index 8975614af0..3da4f97fcd 100644 --- a/doc/man/namecoin-cli.1 +++ b/doc/man/namecoin-cli.1 @@ -1,7 +1,7 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8. -.TH NAMECOIN-CLI "1" "January 2021" "namecoin-cli v21.99.0" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1. +.TH NAMECOIN-CLI "1" "March 2024" "namecoin-cli v27.0.0rc1" "User Commands" .SH NAME -namecoin-cli \- manual page for namecoin-cli v21.99.0 +namecoin-cli \- manual page for namecoin-cli v27.0.0rc1 .SH SYNOPSIS .B namecoin-cli [\fI\,options\/\fR] \fI\, \/\fR[\fI\,params\/\fR] \fI\,Send command to Namecoin Core\/\fR @@ -15,13 +15,25 @@ namecoin-cli \- manual page for namecoin-cli v21.99.0 .B namecoin-cli [\fI\,options\/\fR] \fI\,help Get help for a command\/\fR .SH DESCRIPTION -Namecoin Core RPC client version v21.99.0\-dirty +Namecoin Core RPC client version v27.0.0rc1 .SH OPTIONS .HP \-? .IP Print this help message and exit .HP +\fB\-addrinfo\fR +.IP +Get the number of addresses known to the node, per network and total, +after filtering for quality and recency. The total number of +addresses known to the node may be higher. +.HP +\fB\-color=\fR +.IP +Color setting for CLI output (default: auto). Valid values: always, auto +(add color codes when standard output is connected to a terminal +and OS is not WIN32), never. +.HP \fB\-conf=\fR .IP Specify configuration file. Relative paths will be prefixed by datadir @@ -33,18 +45,18 @@ Specify data directory .HP \fB\-generate\fR .IP -Generate blocks immediately, equivalent to RPC generatenewaddress -followed by RPC generatetoaddress. Optional positional integer -arguments are number of blocks to generate (default: 1) and -maximum iterations to try (default: 1000000), equivalent to RPC -generatetoaddress nblocks and maxtries arguments. Example: -namecoin\-cli \fB\-generate\fR 4 1000 +Generate blocks, equivalent to RPC getnewaddress followed by RPC +generatetoaddress. Optional positional integer arguments are +number of blocks to generate (default: 1) and maximum iterations +to try (default: 1000000), equivalent to RPC generatetoaddress +nblocks and maxtries arguments. Example: namecoin\-cli \fB\-generate\fR 4 +1000 .HP \fB\-getinfo\fR .IP Get general information from the remote server. Note that unlike -server\-side RPC calls, the results of \fB\-getinfo\fR is the result of -multiple non\-atomic requests. Some entries in the result may +server\-side RPC calls, the output of \fB\-getinfo\fR is the result of +multiple non\-atomic requests. Some entries in the output may represent results from different states (e.g. wallet balance may be as of a different block from the chain state reported) .HP @@ -90,6 +102,11 @@ Username for JSON\-RPC connections .IP Wait for RPC server to start .HP +\fB\-rpcwaittimeout=\fR +.IP +Timeout in seconds to wait for the RPC server to start, or 0 for no +timeout. (default: 0) +.HP \fB\-rpcwallet=\fR .IP Send RPC for non\-default wallet on RPC server (needs to exactly match @@ -152,3 +169,13 @@ network seed node(s)) \fB\-testnet\fR .IP Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR. +.SH COPYRIGHT +Copyright (C) 2009-2024 The Bitcoin Core and Namecoin developers + +Please contribute if you find Namecoin Core useful. Visit + for further information about the software. +The source code is available from . + +This is experimental software. +Distributed under the MIT software license, see the accompanying file COPYING +or \ No newline at end of file diff --git a/doc/man/namecoin-qt.1 b/doc/man/namecoin-qt.1 index 8059537ade..85fbd267b4 100644 --- a/doc/man/namecoin-qt.1 +++ b/doc/man/namecoin-qt.1 @@ -1,12 +1,14 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8. -.TH NAMECOIN-QT "1" "January 2021" "namecoin-qt v21.99.0" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1. +.TH NAMECOIN-QT "1" "March 2024" "namecoin-qt v27.0.0rc1" "User Commands" .SH NAME -namecoin-qt \- manual page for namecoin-qt v21.99.0 +namecoin-qt \- manual page for namecoin-qt v27.0.0rc1 .SH SYNOPSIS .B namecoin-qt -[\fI\,command-line options\/\fR] +[\fI\,command-line options\/\fR] [\fI\,URI\/\fR] .SH DESCRIPTION -Namecoin Core version v21.99.0\-dirty +Namecoin Core version v27.0.0rc1 +.PP +Optional URI is a Namecoin address in BIP21 URI format. .SH OPTIONS .HP \-? @@ -15,19 +17,24 @@ Print this help message and exit .HP \fB\-alertnotify=\fR .IP -Execute command when a relevant alert is received or we see a really -long fork (%s in cmd is replaced by message) +Execute command when an alert is raised (%s in cmd is replaced by +message) +.HP +\fB\-allowignoredconf\fR +.IP +For backwards compatibility, treat an unused namecoin.conf file in the +datadir as a warning, not an error. .HP \fB\-assumevalid=\fR .IP 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: -992d2364a40f7ecc57e518655b99254ca98806a950e6227ad022618c95a75e88, +3367fd440ecbdd76e5d852f3f96d7d74a28fb7795e6fb0ac0fe9d1551c1299b2, testnet: bc66fc22b8a2988bdc519c4c6aa431bb57201e5102ad8b8272fcde2937b4d2f7, signet: -0000002a1de0f46379358c1fd09906f7ac59adf3712323ed90eb59e4c183c020) +0000000870f15246ba23c16e370a7ffb1fc8a3dcf8cb4492882ed4b0e3d4cd26) .HP \fB\-blockfilterindex=\fR .IP @@ -57,14 +64,24 @@ and rebroadcast of any transactions from inbound peers is disabled, unless the peer has the 'forcerelay' permission. RPC transactions are not affected. (default: 0) .HP +\fB\-coinstatsindex\fR +.IP +Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0) +.HP \fB\-conf=\fR .IP Specify path to read\-only configuration file. Relative paths will be -prefixed by datadir location. (default: namecoin.conf) +prefixed by datadir location (only useable from command line, not +configuration file) (default: namecoin.conf) .HP \fB\-daemon\fR .IP -Run in the background as a daemon and accept commands +Run in the background as a daemon and accept commands (default: 0) +.HP +\fB\-daemonwait\fR +.IP +Wait for initialization to be finished before exiting. This implies +\fB\-daemon\fR (default: 0) .HP \fB\-datadir=\fR .IP @@ -78,9 +95,9 @@ addition, unused mempool memory is shared for this cache (see .HP \fB\-debuglogfile=\fR .IP -Specify location of debug log file. Relative paths will be prefixed by a -net\-specific datadir location. (\fB\-nodebuglogfile\fR to disable; -default: debug.log) +Specify location of debug log file (default: debug.log). Relative paths +will be prefixed by a net\-specific datadir location. Pass +\fB\-nodebuglogfile\fR to disable writing the log to a file. .HP \fB\-includeconf=\fR .IP @@ -114,13 +131,20 @@ Keep track of the full name history (default: 0) .HP \fB\-par=\fR .IP -Set the number of script verification threads (\fB\-24\fR to 15, 0 = auto, <0 = +Set the number of script verification threads (0 = auto, up to 15, <0 = leave that many cores free, default: 0) .HP \fB\-persistmempool\fR .IP Whether to save the mempool on shutdown and load on restart (default: 1) .HP +\fB\-persistmempoolv1\fR +.IP +Whether a mempool.dat file created by \fB\-persistmempool\fR or the savemempool +RPC will be written in the legacy format (version 1) or the +current format (version 2). This temporary option will be removed +in the future. (default: 0) +.HP \fB\-pid=\fR .IP Specify pid file. Relative paths will be prefixed by a net\-specific @@ -130,23 +154,27 @@ datadir location. (default: namecoind.pid) .IP 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 +delete specific blocks and enables automatic pruning of old blocks if a target size in MiB is provided. This mode is -incompatible with \fB\-txindex\fR and \fB\-rescan\fR. Warning: Reverting this -setting requires re\-downloading the entire blockchain. (default: -0 = disable pruning blocks, 1 = allow manual pruning via RPC, ->=550 = automatically prune block files to stay under the -specified target size in MiB) +incompatible with \fB\-txindex\fR. Warning: Reverting this setting +requires re\-downloading the entire blockchain. (default: 0 = +disable pruning blocks, 1 = allow manual pruning via RPC, >=550 = +automatically prune block files to stay under the specified +target size in MiB) .HP \fB\-reindex\fR .IP -Rebuild chain state and block index from the blk*.dat files on disk +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. .HP \fB\-reindex\-chainstate\fR .IP -Rebuild chain state from the currently indexed blocks. When in pruning -mode or if blocks on disk might be corrupted, use full \fB\-reindex\fR -instead. +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. .HP \fB\-settings=\fR .IP @@ -156,14 +184,16 @@ edited by users (use namecoin.conf instead for custom settings). Relative paths will be prefixed by datadir location. (default: settings.json) .HP -\fB\-startupnotify=\fR +\fB\-shutdownnotify=\fR .IP -Execute command on startup. +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). .HP -\fB\-sysperms\fR +\fB\-startupnotify=\fR .IP -Create new files with system default permissions, instead of umask 077 -(only effective with disabled wallet functionality) +Execute command on startup. .HP \fB\-txindex\fR .IP @@ -179,8 +209,10 @@ Connection options: \fB\-addnode=\fR .IP Add a node to connect to and attempt to keep the connection open (see -the `addnode` RPC command help for more info). This option can be -specified multiple times to add multiple nodes. +the addnode RPC help for more info). This option can be specified +multiple times to add multiple nodes; connections are limited to +8 at a time and are counted separately from the \fB\-maxconnections\fR +limit. .HP \fB\-asmap=\fR .IP @@ -201,6 +233,12 @@ connections to that address and port as incoming Tor connections (default: 127.0.0.1:8334=onion, testnet: 127.0.0.1:18334=onion, signet: 127.0.0.1:38334=onion, regtest: 127.0.0.1:18445=onion) .HP +\fB\-cjdnsreachable\fR +.IP +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) +.HP \fB\-connect=\fR .IP Connect only to the specified node; \fB\-noconnect\fR disables automatic @@ -220,19 +258,36 @@ Allow DNS lookups for \fB\-addnode\fR, \fB\-seednode\fR and \fB\-connect\fR (def \fB\-dnsseed\fR .IP Query for peer addresses via DNS lookup, if low on addresses (default: 1 -unless \fB\-connect\fR used) +unless \fB\-connect\fR used or \fB\-maxconnections\fR=\fI\,0\/\fR) .HP \fB\-externalip=\fR .IP Specify your own public address .HP +\fB\-fixedseeds\fR +.IP +Allow fixed seeds if DNS seeds don't provide peers (default: 1) +.HP \fB\-forcednsseed\fR .IP Always query for peer addresses via DNS lookup (default: 0) .HP +\fB\-i2pacceptincoming\fR +.IP +Whether to accept inbound I2P connections (default: 1). Ignored if +\fB\-i2psam\fR is not set. Listening for inbound I2P connections is done +through the SAM proxy, not by binding to a local address and +port. +.HP +\fB\-i2psam=\fR +.IP +I2P SAM proxy to reach I2P peers and accept I2P connections (default: +none) +.HP \fB\-listen\fR .IP -Accept connections from outside (default: 1 if no \fB\-proxy\fR or \fB\-connect\fR) +Accept connections from outside (default: 1 if no \fB\-proxy\fR, \fB\-connect\fR or +\fB\-maxconnections\fR=\fI\,0\/\fR) .HP \fB\-listenonion\fR .IP @@ -240,7 +295,9 @@ Automatically create Tor onion service (default: 1) .HP \fB\-maxconnections=\fR .IP -Maintain at most connections to peers (default: 125) +Maintain at most automatic connections to peers (default: 125). This +limit does not apply to connections manually added via \fB\-addnode\fR +or the addnode RPC, which have a separate limit of 8. .HP \fB\-maxreceivebuffer=\fR .IP @@ -248,19 +305,22 @@ Maximum per\-connection receive buffer, *1000 bytes (default: 5000) .HP \fB\-maxsendbuffer=\fR .IP -Maximum per\-connection send buffer, *1000 bytes (default: 1000) +Maximum per\-connection memory usage for the send buffer, *1000 bytes +(default: 1000) .HP \fB\-maxtimeadjustment\fR .IP Maximum allowed median peer time offset adjustment. Local perspective of -time may be influenced by peers forward or backward by this -amount. (default: 4200 seconds) +time may be influenced by outbound peers forward or backward by +this amount (default: 4200 seconds). .HP \fB\-maxuploadtarget=\fR .IP -Tries to keep outbound traffic under the given target (in MiB per 24h). -Limit does not apply to peers with 'download' permission. 0 = no -limit (default: 0) +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: 0M). Optional +suffix units [k|K|m|M|g|G|t|T] (default: M). Lowercase is 1000 +base while uppercase is 1024 base .HP \fB\-networkactive\fR .IP @@ -274,10 +334,10 @@ Use separate SOCKS5 proxy to reach peers via Tor onion services, set .HP \fB\-onlynet=\fR .IP -Make outgoing connections only through network (ipv4, ipv6 or -onion). Incoming connections are not affected by this option. -This option can be specified multiple times to allow multiple -networks. +Make automatic outbound connections only to network (ipv4, ipv6, +onion, i2p, cjdns). Inbound and manual connections are not +affected by this option. It can be specified multiple times to +allow multiple networks. .HP \fB\-peerblockfilters\fR .IP @@ -288,15 +348,12 @@ Serve compact block filters to peers per BIP 157 (default: 0) Support filtering of blocks and transaction with bloom filters (default: 0) .HP -\fB\-permitbaremultisig\fR -.IP -Relay non\-P2SH multisig (default: 1) -.HP \fB\-port=\fR .IP Listen for connections on . Nodes not using the default ports -(default: 8334, testnet: 18334, signet: 38334, regtest: 18445) -are unlikely to get incoming connections. +(default: 8334, testnet: 18334, signet: 38334, regtest: 18444) +are unlikely to get incoming connections. Not relevant for I2P +(see doc/i2p.md). .HP \fB\-proxy=\fR .IP @@ -316,17 +373,24 @@ nodes. .HP \fB\-timeout=\fR .IP -Specify connection timeout in milliseconds (minimum: 1, default: 5000) +Specify socket connection timeout in milliseconds. If an initial attempt +to connect is unsuccessful after this amount of time, drop it +(minimum: 1, default: 5000) .HP \fB\-torcontrol=\fR: .IP -Tor control port to use if onion listening enabled (default: -127.0.0.1:9051) +Tor control host and port to use if onion listening enabled (default: +127.0.0.1:9051). If no port is specified, the default port of +9051 will be used. .HP \fB\-torpassword=\fR .IP Tor control port password (default: empty) .HP +\fB\-v2transport\fR +.IP +Support v2 transport (default: 1) +.HP \fB\-whitebind=\fR<[permissions@]addr> .IP Bind to the given address and add permission flags to the peers @@ -354,24 +418,31 @@ Wallet options: .HP \fB\-addresstype\fR .IP -What type of addresses to use ("legacy", "p2sh\-segwit", or "bech32", -default: "legacy") +What type of addresses to use ("legacy", "p2sh\-segwit", "bech32", or +"bech32m", default: "legacy") .HP \fB\-avoidpartialspends\fR .IP -Group outputs by address, selecting all or none, instead of selecting on -a per\-output basis. Privacy is improved as an address is only -used once (unless someone sends to it after spending from it), -but may result in slightly higher fees as suboptimal coin -selection may result due to the added limitation (default: 0 -(always enabled for wallets with "avoid_reuse" enabled)) +Group outputs by address, selecting many (possibly all) or none, instead +of selecting on a per\-output basis. Privacy is improved as +addresses are mostly swept with fewer transactions and outputs +are aggregated in clean change addresses. It may result in higher +fees due to less optimal coin selection caused by this added +limitation and possibly a larger\-than\-necessary number of inputs +being used. Always enabled for wallets with "avoid_reuse" +enabled, otherwise default: 0. .HP \fB\-changetype\fR .IP -What type of change to use ("legacy", "p2sh\-segwit", or "bech32"). -Default is same as \fB\-addresstype\fR, except when -\fB\-addresstype\fR=\fI\,p2sh\-segwit\/\fR a native segwit output is used when -sending to a native segwit address) +What type of change to use ("legacy", "p2sh\-segwit", "bech32", or +"bech32m"). Default is "legacy" when \fB\-addresstype\fR=\fI\,legacy\/\fR, else it +is an implementation detail. +.HP +\fB\-consolidatefeerate=\fR +.IP +The maximum feerate (in NMC/kvB) at which transaction building may use +more inputs than strictly necessary so that the wallet's UTXO +pool can be reduced (default: 0.01). .HP \fB\-disablewallet\fR .IP @@ -379,7 +450,7 @@ Do not load the wallet and disable wallet RPC calls .HP \fB\-discardfee=\fR .IP -The fee rate (in NMC/kB) that indicates your tolerance for discarding +The fee rate (in NMC/kvB) that indicates your tolerance for discarding change by adding it to the fee (default: 0.0001). Note: An output is discarded if it is dust at this rate, but we will always discard up to the dust relay fee and a discard fee above that is @@ -387,7 +458,7 @@ limited by the fee estimate for the longest target .HP \fB\-fallbackfee=\fR .IP -A fee rate (in NMC/kB) that will be used when fee estimation has +A fee rate (in NMC/kvB) that will be used when fee estimation has insufficient data. 0 to entirely disable the fallbackfee feature. (default: 0.00) .HP @@ -405,16 +476,16 @@ allows the use of partial spend avoidance (default: 0.00) .HP \fB\-mintxfee=\fR .IP -Fees (in NMC/kB) smaller than this are considered zero fee for +Fee rates (in NMC/kvB) smaller than this are considered zero fee for transaction creation (default: 0.001) .HP \fB\-paytxfee=\fR .IP -Fee (in NMC/kB) to add to transactions you send (default: 0.00) +Fee rate (in NMC/kvB) to add to transactions you send (default: 0.00) .HP -\fB\-rescan\fR +\fB\-signer=\fR .IP -Rescan the block chain for missing wallet transactions on startup +External signing tool, see doc/external\-signer.md .HP \fB\-spendzeroconfchange\fR .IP @@ -447,14 +518,17 @@ exists, otherwise ) \fB\-walletnotify=\fR .IP Execute command when a wallet transaction changes. %s in cmd is replaced -by TxID and %w is replaced by wallet name. %w is not currently +by TxID, %w is replaced by wallet name, %b is replaced by the +hash of the block including the transaction (set to 'unconfirmed' +if the transaction is not included) and %h is replaced by the +block height (\fB\-1\fR if not included). %w is not currently implemented on windows. On systems where %w is supported, it should NOT be quoted because this would break shell escaping used to invoke the command. .HP \fB\-walletrbf\fR .IP -Send transactions with full\-RBF opt\-in enabled (RPC only, default: 0) +Send transactions with full\-RBF opt\-in enabled (RPC only, default: 1) .PP ZeroMQ notification options: .HP @@ -502,20 +576,28 @@ Set publish hash sequence message high water mark (default: 1000) .PP Debugging/Testing options: .HP +\fB\-checknamedb\fR +.IP +Check name database for consistency every x blocks, \fB\-1\fR to disable +.HP \fB\-debug=\fR .IP -Output debugging information (default: \fB\-nodebug\fR, supplying is -optional). If is not supplied or if = 1, -output all debugging information. can be: net, tor, -mempool, http, bench, zmq, walletdb, rpc, estimatefee, addrman, -selectcoins, reindex, cmpctblock, rand, prune, proxy, mempoolrej, -libevent, coindb, qt, leveldb, validation, names. +Output debug and trace logging (default: \fB\-nodebug\fR, supplying +is optional). If is not supplied or if = 1, +output all debug and trace logging. can be: addrman, +bench, blockstorage, cmpctblock, coindb, estimatefee, http, i2p, +ipc, leveldb, libevent, mempool, mempoolrej, names, net, proxy, +prune, qt, rand, reindex, rpc, scan, selectcoins, tor, +txpackages, txreconciliation, util, validation, walletdb, zmq. +This option can be specified multiple times to output multiple +categories. .HP \fB\-debugexclude=\fR .IP -Exclude debugging information for a category. Can be used in conjunction -with \fB\-debug\fR=\fI\,1\/\fR to output debug logs for all categories except one -or more specified categories. +Exclude debug and trace logging for a category. Can be used in +conjunction with \fB\-debug\fR=\fI\,1\/\fR to output debug and trace logging for +all categories except the specified category. This option can be +specified multiple times to exclude multiple categories. .HP \fB\-help\-debug\fR .IP @@ -525,6 +607,15 @@ Print help message with debugging options and exit .IP Include IP addresses in debug output (default: 0) .HP +\fB\-loglevelalways\fR +.IP +Always prepend a category and level (default: 0) +.HP +\fB\-logsourcelocations\fR +.IP +Prepend debug output with name of the originating source location +(source file, line number and function name) (default: 0) +.HP \fB\-logthreadnames\fR .IP Prepend debug output with name of the originating thread (only available @@ -594,13 +685,22 @@ Relay and mine data carrier transactions (default: 1) .HP \fB\-datacarriersize\fR .IP -Maximum size of data in data carrier transactions we relay and mine -(default: 83) +Relay and mine transactions whose data\-carrying raw scriptPubKey is of +this size or less (default: 83) +.HP +\fB\-mempoolfullrbf\fR +.IP +Accept transaction replace\-by\-fee without requiring replaceability +signaling (default: 0) .HP \fB\-minrelaytxfee=\fR .IP -Fees (in NMC/kB) smaller than this are considered zero fee for relaying, -mining and transaction creation (default: 0.001) +Fees (in NMC/kvB) smaller than this are considered zero fee for +relaying, mining and transaction creation (default: 0.001) +.HP +\fB\-permitbaremultisig\fR +.IP +Relay non\-P2SH multisig (default: 1) .HP \fB\-whitelistforcerelay\fR .IP @@ -622,8 +722,8 @@ Set maximum BIP141 block weight (default: 3996000) .HP \fB\-blockmintxfee=\fR .IP -Set lowest fee rate (in NMC/kB) for transactions to be included in block -creation. (default: 0.00001) +Set lowest fee rate (in NMC/kvB) for transactions to be included in +block creation. (default: 0.00001) .PP RPC server options: .HP @@ -647,10 +747,11 @@ Accept public REST requests (default: 0) .HP \fB\-rpcallowip=\fR .IP -Allow JSON\-RPC connections from specified source. Valid for are a -single IP (e.g. 1.2.3.4), a network/netmask (e.g. -1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). This -option can be specified multiple times +Allow JSON\-RPC connections from specified source. Valid values for +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 .HP \fB\-rpcauth=\fR .IP @@ -684,11 +785,6 @@ Password for JSON\-RPC connections Listen for JSON\-RPC connections on (default: 8336, testnet: 18336, signet: 38336, regtest: 18443) .HP -\fB\-rpcserialversion\fR -.IP -Sets the serialization of raw transaction or block hex returned in -non\-verbose mode, non\-segwit(0) or segwit(1) (default: 1) -.HP \fB\-rpcthreads=\fR .IP Set the number of threads to service RPC calls (default: 4) @@ -744,3 +840,13 @@ Reset all settings changed in the GUI \fB\-splash\fR .IP Show splash screen on startup (default: 1) +.SH COPYRIGHT +Copyright (C) 2009-2024 The Bitcoin Core and Namecoin developers + +Please contribute if you find Namecoin Core useful. Visit + for further information about the software. +The source code is available from . + +This is experimental software. +Distributed under the MIT software license, see the accompanying file COPYING +or \ No newline at end of file diff --git a/doc/man/namecoin-tx.1 b/doc/man/namecoin-tx.1 index 54c4c4418f..81dc5529de 100644 --- a/doc/man/namecoin-tx.1 +++ b/doc/man/namecoin-tx.1 @@ -1,7 +1,7 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8. -.TH NAMECOIN-TX "1" "January 2021" "namecoin-tx v21.99.0" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1. +.TH NAMECOIN-TX "1" "March 2024" "namecoin-tx v27.0.0rc1" "User Commands" .SH NAME -namecoin-tx \- manual page for namecoin-tx v21.99.0 +namecoin-tx \- manual page for namecoin-tx v27.0.0rc1 .SH SYNOPSIS .B namecoin-tx [\fI\,options\/\fR] \fI\, \/\fR[\fI\,commands\/\fR] \fI\,Update hex-encoded transaction\/\fR @@ -9,7 +9,7 @@ namecoin-tx \- manual page for namecoin-tx v21.99.0 .B namecoin-tx [\fI\,options\/\fR] \fI\,-create \/\fR[\fI\,commands\/\fR] \fI\,Create hex-encoded transaction\/\fR .SH DESCRIPTION -Namecoin Core namecoin\-tx utility version v21.99.0\-dirty +Namecoin Core namecoin\-tx utility version v27.0.0rc1 .SH OPTIONS .HP \-? @@ -137,8 +137,10 @@ wrap the output in a pay\-to\-script\-hash. .IP replaceable(=N) .IP -Set RBF opt\-in sequence number for input N (if not provided, opt\-in all -available inputs) +Sets Replace\-By\-Fee (RBF) opt\-in sequence number for input N. If N is +not provided, the command attempts to opt\-in all available inputs +for RBF. If the transaction has no inputs, this option is +ignored. .IP sign=SIGHASH\-FLAGS .IP @@ -156,3 +158,13 @@ Load JSON file FILENAME into register NAME set=NAME:JSON\-STRING .IP Set register NAME to given JSON\-STRING +.SH COPYRIGHT +Copyright (C) 2009-2024 The Bitcoin Core and Namecoin developers + +Please contribute if you find Namecoin Core useful. Visit + for further information about the software. +The source code is available from . + +This is experimental software. +Distributed under the MIT software license, see the accompanying file COPYING +or \ No newline at end of file diff --git a/doc/man/namecoin-util.1 b/doc/man/namecoin-util.1 index 484ca79f66..81694122d5 100644 --- a/doc/man/namecoin-util.1 +++ b/doc/man/namecoin-util.1 @@ -1,12 +1,12 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8. -.TH NAMECOIN-UTIL "1" "January 2021" "namecoin-util v21.99.0" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1. +.TH NAMECOIN-UTIL "1" "March 2024" "namecoin-util v27.0.0rc1" "User Commands" .SH NAME -namecoin-util \- manual page for namecoin-util v21.99.0 +namecoin-util \- manual page for namecoin-util v27.0.0rc1 .SH SYNOPSIS .B bitcoin-util [\fI\,options\/\fR] [\fI\,commands\/\fR] \fI\,Do stuff\/\fR .SH DESCRIPTION -Namecoin Core bitcoin\-util utility version v21.99.0\-dirty +Namecoin Core bitcoin\-util utility version v27.0.0rc1 .SH OPTIONS .HP \-? @@ -47,3 +47,19 @@ network seed node(s)) \fB\-testnet\fR .IP Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR. +.PP +Commands: +.IP +grind +.IP +Perform proof of work on hex header string +.SH COPYRIGHT +Copyright (C) 2009-2024 The Bitcoin Core and Namecoin developers + +Please contribute if you find Namecoin Core useful. Visit + for further information about the software. +The source code is available from . + +This is experimental software. +Distributed under the MIT software license, see the accompanying file COPYING +or \ No newline at end of file diff --git a/doc/man/namecoin-wallet.1 b/doc/man/namecoin-wallet.1 index 7e5005dc92..16d57a53de 100644 --- a/doc/man/namecoin-wallet.1 +++ b/doc/man/namecoin-wallet.1 @@ -1,13 +1,13 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8. -.TH NAMECOIN-WALLET "1" "January 2021" "namecoin-wallet v21.99.0" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1. +.TH NAMECOIN-WALLET "1" "March 2024" "namecoin-wallet v27.0.0rc1" "User Commands" .SH NAME -namecoin-wallet \- manual page for namecoin-wallet v21.99.0 +namecoin-wallet \- manual page for namecoin-wallet v27.0.0rc1 .SH DESCRIPTION -Namecoin Core namecoin\-wallet version v21.99.0\-dirty +Namecoin Core namecoin\-wallet version v27.0.0rc1 .PP namecoin\-wallet is an offline tool for creating and interacting with Namecoin Core wallet files. By default namecoin\-wallet will act on wallets in the default mainnet wallet directory in the datadir. -To change the target wallet, use the \fB\-datadir\fR, \fB\-wallet\fR and \fB\-testnet\fR/\-regtest arguments. +To change the target wallet, use the \fB\-datadir\fR, \fB\-wallet\fR and \fB\-regtest\fR/\-signet/\-testnet arguments. .SS "Usage:" .IP namecoin\-wallet [options] @@ -35,6 +35,10 @@ with 'createfromdump', loads the records into a new wallet. The format of the wallet file to create. Either "bdb" or "sqlite". Only used with 'createfromdump' .HP +\fB\-legacy\fR +.IP +Create legacy wallet. Only for 'create' +.HP \fB\-version\fR .IP Print version and exit @@ -105,3 +109,13 @@ salvage .IP Attempt to recover private keys from a corrupt wallet. Warning: \&'salvage' is experimental. +.SH COPYRIGHT +Copyright (C) 2009-2024 The Bitcoin Core and Namecoin developers + +Please contribute if you find Namecoin Core useful. Visit + for further information about the software. +The source code is available from . + +This is experimental software. +Distributed under the MIT software license, see the accompanying file COPYING +or \ No newline at end of file diff --git a/doc/man/namecoind.1 b/doc/man/namecoind.1 index af2efefbfc..d811c09125 100644 --- a/doc/man/namecoind.1 +++ b/doc/man/namecoind.1 @@ -1,21 +1,12 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8. -.TH NAMECOIND "1" "January 2021" "namecoind v21.99.0" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1. +.TH NAMECOIND "1" "March 2024" "namecoind v27.0.0rc1" "User Commands" .SH NAME -namecoind \- manual page for namecoind v21.99.0 +namecoind \- manual page for namecoind v27.0.0rc1 .SH SYNOPSIS .B namecoind [\fI\,options\/\fR] \fI\,Start Namecoin Core\/\fR .SH DESCRIPTION -Namecoin Core version v21.99.0\-dirty -Copyright \(co 2009\-2021 The Bitcoin Core and Namecoin developers -.PP -Please contribute if you find Namecoin Core useful. Visit - for further information about the software. -The source code is available from . -.PP -This is experimental software. -Distributed under the MIT software license, see the accompanying file COPYING -or +Namecoin Core version v27.0.0rc1 .SH OPTIONS .HP \-? @@ -24,19 +15,24 @@ Print this help message and exit .HP \fB\-alertnotify=\fR .IP -Execute command when a relevant alert is received or we see a really -long fork (%s in cmd is replaced by message) +Execute command when an alert is raised (%s in cmd is replaced by +message) +.HP +\fB\-allowignoredconf\fR +.IP +For backwards compatibility, treat an unused namecoin.conf file in the +datadir as a warning, not an error. .HP \fB\-assumevalid=\fR .IP 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: -992d2364a40f7ecc57e518655b99254ca98806a950e6227ad022618c95a75e88, +3367fd440ecbdd76e5d852f3f96d7d74a28fb7795e6fb0ac0fe9d1551c1299b2, testnet: bc66fc22b8a2988bdc519c4c6aa431bb57201e5102ad8b8272fcde2937b4d2f7, signet: -0000002a1de0f46379358c1fd09906f7ac59adf3712323ed90eb59e4c183c020) +0000000870f15246ba23c16e370a7ffb1fc8a3dcf8cb4492882ed4b0e3d4cd26) .HP \fB\-blockfilterindex=\fR .IP @@ -66,14 +62,24 @@ and rebroadcast of any transactions from inbound peers is disabled, unless the peer has the 'forcerelay' permission. RPC transactions are not affected. (default: 0) .HP +\fB\-coinstatsindex\fR +.IP +Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0) +.HP \fB\-conf=\fR .IP Specify path to read\-only configuration file. Relative paths will be -prefixed by datadir location. (default: namecoin.conf) +prefixed by datadir location (only useable from command line, not +configuration file) (default: namecoin.conf) .HP \fB\-daemon\fR .IP -Run in the background as a daemon and accept commands +Run in the background as a daemon and accept commands (default: 0) +.HP +\fB\-daemonwait\fR +.IP +Wait for initialization to be finished before exiting. This implies +\fB\-daemon\fR (default: 0) .HP \fB\-datadir=\fR .IP @@ -87,9 +93,9 @@ addition, unused mempool memory is shared for this cache (see .HP \fB\-debuglogfile=\fR .IP -Specify location of debug log file. Relative paths will be prefixed by a -net\-specific datadir location. (\fB\-nodebuglogfile\fR to disable; -default: debug.log) +Specify location of debug log file (default: debug.log). Relative paths +will be prefixed by a net\-specific datadir location. Pass +\fB\-nodebuglogfile\fR to disable writing the log to a file. .HP \fB\-includeconf=\fR .IP @@ -123,13 +129,20 @@ Keep track of the full name history (default: 0) .HP \fB\-par=\fR .IP -Set the number of script verification threads (\fB\-24\fR to 15, 0 = auto, <0 = +Set the number of script verification threads (0 = auto, up to 15, <0 = leave that many cores free, default: 0) .HP \fB\-persistmempool\fR .IP Whether to save the mempool on shutdown and load on restart (default: 1) .HP +\fB\-persistmempoolv1\fR +.IP +Whether a mempool.dat file created by \fB\-persistmempool\fR or the savemempool +RPC will be written in the legacy format (version 1) or the +current format (version 2). This temporary option will be removed +in the future. (default: 0) +.HP \fB\-pid=\fR .IP Specify pid file. Relative paths will be prefixed by a net\-specific @@ -139,23 +152,27 @@ datadir location. (default: namecoind.pid) .IP 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 +delete specific blocks and enables automatic pruning of old blocks if a target size in MiB is provided. This mode is -incompatible with \fB\-txindex\fR and \fB\-rescan\fR. Warning: Reverting this -setting requires re\-downloading the entire blockchain. (default: -0 = disable pruning blocks, 1 = allow manual pruning via RPC, ->=550 = automatically prune block files to stay under the -specified target size in MiB) +incompatible with \fB\-txindex\fR. Warning: Reverting this setting +requires re\-downloading the entire blockchain. (default: 0 = +disable pruning blocks, 1 = allow manual pruning via RPC, >=550 = +automatically prune block files to stay under the specified +target size in MiB) .HP \fB\-reindex\fR .IP -Rebuild chain state and block index from the blk*.dat files on disk +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. .HP \fB\-reindex\-chainstate\fR .IP -Rebuild chain state from the currently indexed blocks. When in pruning -mode or if blocks on disk might be corrupted, use full \fB\-reindex\fR -instead. +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. .HP \fB\-settings=\fR .IP @@ -165,14 +182,16 @@ edited by users (use namecoin.conf instead for custom settings). Relative paths will be prefixed by datadir location. (default: settings.json) .HP -\fB\-startupnotify=\fR +\fB\-shutdownnotify=\fR .IP -Execute command on startup. +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). .HP -\fB\-sysperms\fR +\fB\-startupnotify=\fR .IP -Create new files with system default permissions, instead of umask 077 -(only effective with disabled wallet functionality) +Execute command on startup. .HP \fB\-txindex\fR .IP @@ -188,8 +207,10 @@ Connection options: \fB\-addnode=\fR .IP Add a node to connect to and attempt to keep the connection open (see -the `addnode` RPC command help for more info). This option can be -specified multiple times to add multiple nodes. +the addnode RPC help for more info). This option can be specified +multiple times to add multiple nodes; connections are limited to +8 at a time and are counted separately from the \fB\-maxconnections\fR +limit. .HP \fB\-asmap=\fR .IP @@ -210,6 +231,12 @@ connections to that address and port as incoming Tor connections (default: 127.0.0.1:8334=onion, testnet: 127.0.0.1:18334=onion, signet: 127.0.0.1:38334=onion, regtest: 127.0.0.1:18445=onion) .HP +\fB\-cjdnsreachable\fR +.IP +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) +.HP \fB\-connect=\fR .IP Connect only to the specified node; \fB\-noconnect\fR disables automatic @@ -229,19 +256,36 @@ Allow DNS lookups for \fB\-addnode\fR, \fB\-seednode\fR and \fB\-connect\fR (def \fB\-dnsseed\fR .IP Query for peer addresses via DNS lookup, if low on addresses (default: 1 -unless \fB\-connect\fR used) +unless \fB\-connect\fR used or \fB\-maxconnections\fR=\fI\,0\/\fR) .HP \fB\-externalip=\fR .IP Specify your own public address .HP +\fB\-fixedseeds\fR +.IP +Allow fixed seeds if DNS seeds don't provide peers (default: 1) +.HP \fB\-forcednsseed\fR .IP Always query for peer addresses via DNS lookup (default: 0) .HP +\fB\-i2pacceptincoming\fR +.IP +Whether to accept inbound I2P connections (default: 1). Ignored if +\fB\-i2psam\fR is not set. Listening for inbound I2P connections is done +through the SAM proxy, not by binding to a local address and +port. +.HP +\fB\-i2psam=\fR +.IP +I2P SAM proxy to reach I2P peers and accept I2P connections (default: +none) +.HP \fB\-listen\fR .IP -Accept connections from outside (default: 1 if no \fB\-proxy\fR or \fB\-connect\fR) +Accept connections from outside (default: 1 if no \fB\-proxy\fR, \fB\-connect\fR or +\fB\-maxconnections\fR=\fI\,0\/\fR) .HP \fB\-listenonion\fR .IP @@ -249,7 +293,9 @@ Automatically create Tor onion service (default: 1) .HP \fB\-maxconnections=\fR .IP -Maintain at most connections to peers (default: 125) +Maintain at most automatic connections to peers (default: 125). This +limit does not apply to connections manually added via \fB\-addnode\fR +or the addnode RPC, which have a separate limit of 8. .HP \fB\-maxreceivebuffer=\fR .IP @@ -257,19 +303,22 @@ Maximum per\-connection receive buffer, *1000 bytes (default: 5000) .HP \fB\-maxsendbuffer=\fR .IP -Maximum per\-connection send buffer, *1000 bytes (default: 1000) +Maximum per\-connection memory usage for the send buffer, *1000 bytes +(default: 1000) .HP \fB\-maxtimeadjustment\fR .IP Maximum allowed median peer time offset adjustment. Local perspective of -time may be influenced by peers forward or backward by this -amount. (default: 4200 seconds) +time may be influenced by outbound peers forward or backward by +this amount (default: 4200 seconds). .HP \fB\-maxuploadtarget=\fR .IP -Tries to keep outbound traffic under the given target (in MiB per 24h). -Limit does not apply to peers with 'download' permission. 0 = no -limit (default: 0) +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: 0M). Optional +suffix units [k|K|m|M|g|G|t|T] (default: M). Lowercase is 1000 +base while uppercase is 1024 base .HP \fB\-networkactive\fR .IP @@ -283,10 +332,10 @@ Use separate SOCKS5 proxy to reach peers via Tor onion services, set .HP \fB\-onlynet=\fR .IP -Make outgoing connections only through network (ipv4, ipv6 or -onion). Incoming connections are not affected by this option. -This option can be specified multiple times to allow multiple -networks. +Make automatic outbound connections only to network (ipv4, ipv6, +onion, i2p, cjdns). Inbound and manual connections are not +affected by this option. It can be specified multiple times to +allow multiple networks. .HP \fB\-peerblockfilters\fR .IP @@ -297,15 +346,12 @@ Serve compact block filters to peers per BIP 157 (default: 0) Support filtering of blocks and transaction with bloom filters (default: 0) .HP -\fB\-permitbaremultisig\fR -.IP -Relay non\-P2SH multisig (default: 1) -.HP \fB\-port=\fR .IP Listen for connections on . Nodes not using the default ports -(default: 8334, testnet: 18334, signet: 38334, regtest: 18445) -are unlikely to get incoming connections. +(default: 8334, testnet: 18334, signet: 38334, regtest: 18444) +are unlikely to get incoming connections. Not relevant for I2P +(see doc/i2p.md). .HP \fB\-proxy=\fR .IP @@ -325,17 +371,24 @@ nodes. .HP \fB\-timeout=\fR .IP -Specify connection timeout in milliseconds (minimum: 1, default: 5000) +Specify socket connection timeout in milliseconds. If an initial attempt +to connect is unsuccessful after this amount of time, drop it +(minimum: 1, default: 5000) .HP \fB\-torcontrol=\fR: .IP -Tor control port to use if onion listening enabled (default: -127.0.0.1:9051) +Tor control host and port to use if onion listening enabled (default: +127.0.0.1:9051). If no port is specified, the default port of +9051 will be used. .HP \fB\-torpassword=\fR .IP Tor control port password (default: empty) .HP +\fB\-v2transport\fR +.IP +Support v2 transport (default: 1) +.HP \fB\-whitebind=\fR<[permissions@]addr> .IP Bind to the given address and add permission flags to the peers @@ -363,24 +416,31 @@ Wallet options: .HP \fB\-addresstype\fR .IP -What type of addresses to use ("legacy", "p2sh\-segwit", or "bech32", -default: "legacy") +What type of addresses to use ("legacy", "p2sh\-segwit", "bech32", or +"bech32m", default: "legacy") .HP \fB\-avoidpartialspends\fR .IP -Group outputs by address, selecting all or none, instead of selecting on -a per\-output basis. Privacy is improved as an address is only -used once (unless someone sends to it after spending from it), -but may result in slightly higher fees as suboptimal coin -selection may result due to the added limitation (default: 0 -(always enabled for wallets with "avoid_reuse" enabled)) +Group outputs by address, selecting many (possibly all) or none, instead +of selecting on a per\-output basis. Privacy is improved as +addresses are mostly swept with fewer transactions and outputs +are aggregated in clean change addresses. It may result in higher +fees due to less optimal coin selection caused by this added +limitation and possibly a larger\-than\-necessary number of inputs +being used. Always enabled for wallets with "avoid_reuse" +enabled, otherwise default: 0. .HP \fB\-changetype\fR .IP -What type of change to use ("legacy", "p2sh\-segwit", or "bech32"). -Default is same as \fB\-addresstype\fR, except when -\fB\-addresstype\fR=\fI\,p2sh\-segwit\/\fR a native segwit output is used when -sending to a native segwit address) +What type of change to use ("legacy", "p2sh\-segwit", "bech32", or +"bech32m"). Default is "legacy" when \fB\-addresstype\fR=\fI\,legacy\/\fR, else it +is an implementation detail. +.HP +\fB\-consolidatefeerate=\fR +.IP +The maximum feerate (in NMC/kvB) at which transaction building may use +more inputs than strictly necessary so that the wallet's UTXO +pool can be reduced (default: 0.01). .HP \fB\-disablewallet\fR .IP @@ -388,7 +448,7 @@ Do not load the wallet and disable wallet RPC calls .HP \fB\-discardfee=\fR .IP -The fee rate (in NMC/kB) that indicates your tolerance for discarding +The fee rate (in NMC/kvB) that indicates your tolerance for discarding change by adding it to the fee (default: 0.0001). Note: An output is discarded if it is dust at this rate, but we will always discard up to the dust relay fee and a discard fee above that is @@ -396,7 +456,7 @@ limited by the fee estimate for the longest target .HP \fB\-fallbackfee=\fR .IP -A fee rate (in NMC/kB) that will be used when fee estimation has +A fee rate (in NMC/kvB) that will be used when fee estimation has insufficient data. 0 to entirely disable the fallbackfee feature. (default: 0.00) .HP @@ -414,16 +474,16 @@ allows the use of partial spend avoidance (default: 0.00) .HP \fB\-mintxfee=\fR .IP -Fees (in NMC/kB) smaller than this are considered zero fee for +Fee rates (in NMC/kvB) smaller than this are considered zero fee for transaction creation (default: 0.001) .HP \fB\-paytxfee=\fR .IP -Fee (in NMC/kB) to add to transactions you send (default: 0.00) +Fee rate (in NMC/kvB) to add to transactions you send (default: 0.00) .HP -\fB\-rescan\fR +\fB\-signer=\fR .IP -Rescan the block chain for missing wallet transactions on startup +External signing tool, see doc/external\-signer.md .HP \fB\-spendzeroconfchange\fR .IP @@ -456,14 +516,17 @@ exists, otherwise ) \fB\-walletnotify=\fR .IP Execute command when a wallet transaction changes. %s in cmd is replaced -by TxID and %w is replaced by wallet name. %w is not currently +by TxID, %w is replaced by wallet name, %b is replaced by the +hash of the block including the transaction (set to 'unconfirmed' +if the transaction is not included) and %h is replaced by the +block height (\fB\-1\fR if not included). %w is not currently implemented on windows. On systems where %w is supported, it should NOT be quoted because this would break shell escaping used to invoke the command. .HP \fB\-walletrbf\fR .IP -Send transactions with full\-RBF opt\-in enabled (RPC only, default: 0) +Send transactions with full\-RBF opt\-in enabled (RPC only, default: 1) .PP ZeroMQ notification options: .HP @@ -511,20 +574,28 @@ Set publish hash sequence message high water mark (default: 1000) .PP Debugging/Testing options: .HP +\fB\-checknamedb\fR +.IP +Check name database for consistency every x blocks, \fB\-1\fR to disable +.HP \fB\-debug=\fR .IP -Output debugging information (default: \fB\-nodebug\fR, supplying is -optional). If is not supplied or if = 1, -output all debugging information. can be: net, tor, -mempool, http, bench, zmq, walletdb, rpc, estimatefee, addrman, -selectcoins, reindex, cmpctblock, rand, prune, proxy, mempoolrej, -libevent, coindb, qt, leveldb, validation, names. +Output debug and trace logging (default: \fB\-nodebug\fR, supplying +is optional). If is not supplied or if = 1, +output all debug and trace logging. can be: addrman, +bench, blockstorage, cmpctblock, coindb, estimatefee, http, i2p, +ipc, leveldb, libevent, mempool, mempoolrej, names, net, proxy, +prune, qt, rand, reindex, rpc, scan, selectcoins, tor, +txpackages, txreconciliation, util, validation, walletdb, zmq. +This option can be specified multiple times to output multiple +categories. .HP \fB\-debugexclude=\fR .IP -Exclude debugging information for a category. Can be used in conjunction -with \fB\-debug\fR=\fI\,1\/\fR to output debug logs for all categories except one -or more specified categories. +Exclude debug and trace logging for a category. Can be used in +conjunction with \fB\-debug\fR=\fI\,1\/\fR to output debug and trace logging for +all categories except the specified category. This option can be +specified multiple times to exclude multiple categories. .HP \fB\-help\-debug\fR .IP @@ -534,6 +605,15 @@ Print help message with debugging options and exit .IP Include IP addresses in debug output (default: 0) .HP +\fB\-loglevelalways\fR +.IP +Always prepend a category and level (default: 0) +.HP +\fB\-logsourcelocations\fR +.IP +Prepend debug output with name of the originating source location +(source file, line number and function name) (default: 0) +.HP \fB\-logthreadnames\fR .IP Prepend debug output with name of the originating thread (only available @@ -603,13 +683,22 @@ Relay and mine data carrier transactions (default: 1) .HP \fB\-datacarriersize\fR .IP -Maximum size of data in data carrier transactions we relay and mine -(default: 83) +Relay and mine transactions whose data\-carrying raw scriptPubKey is of +this size or less (default: 83) +.HP +\fB\-mempoolfullrbf\fR +.IP +Accept transaction replace\-by\-fee without requiring replaceability +signaling (default: 0) .HP \fB\-minrelaytxfee=\fR .IP -Fees (in NMC/kB) smaller than this are considered zero fee for relaying, -mining and transaction creation (default: 0.001) +Fees (in NMC/kvB) smaller than this are considered zero fee for +relaying, mining and transaction creation (default: 0.001) +.HP +\fB\-permitbaremultisig\fR +.IP +Relay non\-P2SH multisig (default: 1) .HP \fB\-whitelistforcerelay\fR .IP @@ -631,8 +720,8 @@ Set maximum BIP141 block weight (default: 3996000) .HP \fB\-blockmintxfee=\fR .IP -Set lowest fee rate (in NMC/kB) for transactions to be included in block -creation. (default: 0.00001) +Set lowest fee rate (in NMC/kvB) for transactions to be included in +block creation. (default: 0.00001) .PP RPC server options: .HP @@ -656,10 +745,11 @@ Accept public REST requests (default: 0) .HP \fB\-rpcallowip=\fR .IP -Allow JSON\-RPC connections from specified source. Valid for are a -single IP (e.g. 1.2.3.4), a network/netmask (e.g. -1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). This -option can be specified multiple times +Allow JSON\-RPC connections from specified source. Valid values for +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 .HP \fB\-rpcauth=\fR .IP @@ -693,11 +783,6 @@ Password for JSON\-RPC connections Listen for JSON\-RPC connections on (default: 8336, testnet: 18336, signet: 38336, regtest: 18443) .HP -\fB\-rpcserialversion\fR -.IP -Sets the serialization of raw transaction or block hex returned in -non\-verbose mode, non\-segwit(0) or segwit(1) (default: 1) -.HP \fB\-rpcthreads=\fR .IP Set the number of threads to service RPC calls (default: 4) @@ -731,3 +816,13 @@ Accept command line and JSON\-RPC commands .IP Sets the default encoding used for values in the RPC interface (default: ascii) +.SH COPYRIGHT +Copyright (C) 2009-2024 The Bitcoin Core and Namecoin developers + +Please contribute if you find Namecoin Core useful. Visit + for further information about the software. +The source code is available from . + +This is experimental software. +Distributed under the MIT software license, see the accompanying file COPYING +or \ No newline at end of file diff --git a/doc/release-notes-empty-template.md b/doc/release-notes-empty-template.md deleted file mode 100644 index 96e28c3763..0000000000 --- a/doc/release-notes-empty-template.md +++ /dev/null @@ -1,99 +0,0 @@ -*The release notes draft is a temporary file that can be added to by anyone. See -[/doc/developer-notes.md#release-notes](/doc/developer-notes.md#release-notes) -for the process.* - -*version* Release Notes Draft -=============================== - -Bitcoin Core version *version* is now available from: - - - -This release includes new features, various bug fixes and performance -improvements, as well as updated translations. - -Please report bugs using the issue tracker at GitHub: - - - -To receive security and update notifications, please subscribe to: - - - -How to Upgrade -============== - -If you are running an older version, shut it down. Wait until it has completely -shut down (which might take a few minutes in some cases), then run the -installer (on Windows) or just copy over `/Applications/Bitcoin-Qt` (on macOS) -or `bitcoind`/`bitcoin-qt` (on Linux). - -Upgrading directly from a version of Bitcoin Core that has reached its EOL is -possible, but it might take some time if the data directory needs to be migrated. Old -wallet versions of Bitcoin Core are generally supported. - -Compatibility -============== - -Bitcoin Core is supported and extensively tested on operating systems -using the Linux Kernel 3.17+, macOS 11.0+, and Windows 7 and newer. Bitcoin -Core should also work on most other Unix-like systems but is not as -frequently tested on them. It is not recommended to use Bitcoin Core on -unsupported systems. - -Notable changes -=============== - -P2P and network changes ------------------------ - -Updated RPCs ------------- - - -Changes to wallet related RPCs can be found in the Wallet section below. - -New RPCs --------- - -Build System ------------- - -Updated settings ----------------- - - -Changes to GUI or wallet related settings can be found in the GUI or Wallet section below. - -New settings ------------- - -Tools and Utilities -------------------- - -Wallet ------- - -GUI changes ------------ - -Low-level changes -================= - -RPC ---- - -Tests ------ - -*version* change log -==================== - -Credits -======= - -Thanks to everyone who directly contributed to this release: - - -As well as to everyone that helped with translations on -[Transifex](https://www.transifex.com/bitcoin/bitcoin/). diff --git a/doc/release-notes.md b/doc/release-notes.md new file mode 100644 index 0000000000..00dcd64917 --- /dev/null +++ b/doc/release-notes.md @@ -0,0 +1 @@ +See https://github.com/bitcoin-core/bitcoin-devwiki/wiki/27.0-Release-Notes-Draft diff --git a/share/examples/namecoin.conf b/share/examples/namecoin.conf index 179405104f..b662280a88 100644 --- a/share/examples/namecoin.conf +++ b/share/examples/namecoin.conf @@ -1 +1,710 @@ -# This is a placeholder file. Please follow the instructions in `contrib/devtools/README.md` to generate a namecoin.conf file. +## +## namecoin.conf configuration file. +## Generated by contrib/devtools/gen-bitcoin-conf.sh. +## +## Lines beginning with # are comments. +## All possible configuration options are provided. To use, copy this file +## to your data directory (default or specified by -datadir), uncomment +## options you would like to change, and save the file. +## + + +### Options + + +# Execute command when an alert is raised (%s in cmd is replaced by +# message) +#alertnotify= + +# For backwards compatibility, treat an unused namecoin.conf file in the +# datadir as a warning, not an error. +#allowignoredconf=1 + +# 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: +# 3367fd440ecbdd76e5d852f3f96d7d74a28fb7795e6fb0ac0fe9d1551c1299b2, +# testnet: +# bc66fc22b8a2988bdc519c4c6aa431bb57201e5102ad8b8272fcde2937b4d2f7, +# signet: +# 0000000870f15246ba23c16e370a7ffb1fc8a3dcf8cb4492882ed4b0e3d4cd26) +#assumevalid= + +# Maintain an index of compact filters by block (default: 0, values: +# basic). If is not supplied or if = 1, indexes for +# all known types are enabled. +#blockfilterindex= + +# Execute command when the best block changes (%s in cmd is replaced by +# block hash) +#blocknotify= + +# Extra transactions to keep in memory for compact block reconstructions +# (default: 100) +#blockreconstructionextratxn= + +# Specify directory to hold blocks subdirectory for *.dat files (default: +# ) +#blocksdir= + +# Whether to reject transactions from network peers. Automatic broadcast +# and rebroadcast of any transactions from inbound peers is +# disabled, unless the peer has the 'forcerelay' permission. RPC +# transactions are not affected. (default: 0) +#blocksonly=1 + +# Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0) +#coinstatsindex=1 + +# Specify path to read-only configuration file. Relative paths will be +# prefixed by datadir location (only useable from command line, not +# configuration file) (default: namecoin.conf) +#conf= + +# Run in the background as a daemon and accept commands (default: 0) +#daemon=1 + +# Wait for initialization to be finished before exiting. This implies +# -daemon (default: 0) +#daemonwait=1 + +# Specify data directory +#datadir= + +# Maximum database cache size MiB (4 to 16384, default: 450). In +# addition, unused mempool memory is shared for this cache (see +# -maxmempool). +#dbcache= + +# Specify location of debug log file (default: debug.log). Relative paths +# will be prefixed by a net-specific datadir location. Pass +# -nodebuglogfile to disable writing the log to a file. +#debuglogfile= + +# Specify additional configuration file, relative to the -datadir path +# (only useable from configuration file, not command line) +#includeconf= + +# Imports blocks from external file on startup +#loadblock= + +# Keep the transaction memory pool below megabytes (default: 300) +#maxmempool= + +# Keep at most unconnectable transactions in memory (default: 100) +#maxorphantx= + +# Do not keep transactions in the mempool longer than hours (default: +# 336) +#mempoolexpiry= + +# Maintain an index of name hashes to preimages (default: 0) +#namehashindex=1 + +# Keep track of the full name history (default: 0) +#namehistory=1 + +# Set the number of script verification threads (0 = auto, up to 15, <0 = +# leave that many cores free, default: 0) +#par= + +# Whether to save the mempool on shutdown and load on restart (default: 1) +#persistmempool=1 + +# Whether a mempool.dat file created by -persistmempool or the savemempool +# RPC will be written in the legacy format (version 1) or the +# current format (version 2). This temporary option will be removed +# in the future. (default: 0) +#persistmempoolv1=1 + +# Specify pid file. Relative paths will be prefixed by a net-specific +# datadir location. (default: namecoind.pid) +#pid= + +# 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. Warning: Reverting this setting +# requires re-downloading the entire blockchain. (default: 0 = +# disable pruning blocks, 1 = allow manual pruning via RPC, >=550 = +# automatically prune block files to stay under the specified +# target size in MiB) +#prune= + +# 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. +#reindex=1 + +# 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. +#reindex-chainstate=1 + +# 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 namecoin.conf instead for custom settings). +# Relative paths will be prefixed by datadir location. (default: +# settings.json) +#settings= + +# 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). +#shutdownnotify= + +# Execute command on startup. +#startupnotify= + +# Maintain a full transaction index, used by the getrawtransaction rpc +# call (default: 0) +#txindex=1 + +# Print version and exit +#version=1 + + +### Connection options + + +# 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 +# 8 at a time and are counted separately from the -maxconnections +# limit. +#addnode= + +# Specify asn mapping used for bucketing of the peers (default: +# ip_asn.map). Relative paths will be prefixed by the net-specific +# datadir location. +#asmap= + +# Default duration (in seconds) of manually configured bans (default: +# 86400) +#bantime= + +# 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:8334=onion, testnet: 127.0.0.1:18334=onion, +# signet: 127.0.0.1:38334=onion, regtest: 127.0.0.1:18445=onion) +#bind=[:][=onion] + +# 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) +#cjdnsreachable=1 + +# 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. +#connect= + +# Discover own IP addresses (default: 1 when listening and no -externalip +# or -proxy) +#discover=1 + +# Allow DNS lookups for -addnode, -seednode and -connect (default: 1) +#dns=1 + +# Query for peer addresses via DNS lookup, if low on addresses (default: 1 +# unless -connect used or -maxconnections=0) +#dnsseed=1 + +# Specify your own public address +#externalip= + +# Allow fixed seeds if DNS seeds don't provide peers (default: 1) +#fixedseeds=1 + +# Always query for peer addresses via DNS lookup (default: 0) +#forcednsseed=1 + +# Whether to accept inbound I2P connections (default: 1). 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. +#i2pacceptincoming=1 + +# I2P SAM proxy to reach I2P peers and accept I2P connections (default: +# none) +#i2psam= + +# Accept connections from outside (default: 1 if no -proxy, -connect or +# -maxconnections=0) +#listen=1 + +# Automatically create Tor onion service (default: 1) +#listenonion=1 + +# Maintain at most automatic connections to peers (default: 125). This +# limit does not apply to connections manually added via -addnode +# or the addnode RPC, which have a separate limit of 8. +#maxconnections= + +# Maximum per-connection receive buffer, *1000 bytes (default: 5000) +#maxreceivebuffer= + +# Maximum per-connection memory usage for the send buffer, *1000 bytes +# (default: 1000) +#maxsendbuffer= + +# Maximum allowed median peer time offset adjustment. Local perspective of +# time may be influenced by outbound peers forward or backward by +# this amount (default: 4200 seconds). +#maxtimeadjustment=1 + +# 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: 0M). Optional +# suffix units [k|K|m|M|g|G|t|T] (default: M). Lowercase is 1000 +# base while uppercase is 1024 base +#maxuploadtarget= + +# Enable all P2P network activity (default: 1). Can be changed by the +# setnetworkactive RPC command +#networkactive=1 + +# Use separate SOCKS5 proxy to reach peers via Tor onion services, set +# -noonion to disable (default: -proxy) +#onion= + +# Make automatic outbound connections only to network (ipv4, ipv6, +# onion, i2p, cjdns). Inbound and manual connections are not +# affected by this option. It can be specified multiple times to +# allow multiple networks. +#onlynet= + +# Serve compact block filters to peers per BIP 157 (default: 0) +#peerblockfilters=1 + +# Support filtering of blocks and transaction with bloom filters (default: +# 0) +#peerbloomfilters=1 + +# Listen for connections on . Nodes not using the default ports +# (default: 8334, testnet: 18334, signet: 38334, regtest: 18444) +# are unlikely to get incoming connections. Not relevant for I2P +# (see doc/i2p.md). +#port= + +# Connect through SOCKS5 proxy, set -noproxy to disable (default: +# disabled) +#proxy= + +# Randomize credentials for every proxy connection. This enables Tor +# stream isolation (default: 1) +#proxyrandomize=1 + +# Connect to a node to retrieve peer addresses, and disconnect. This +# option can be specified multiple times to connect to multiple +# nodes. +#seednode= + +# Specify socket connection timeout in milliseconds. If an initial attempt +# to connect is unsuccessful after this amount of time, drop it +# (minimum: 1, default: 5000) +#timeout= + +# Tor control host and port to use if onion listening enabled (default: +# 127.0.0.1:9051). If no port is specified, the default port of +# 9051 will be used. +#torcontrol=: + +# Tor control port password (default: empty) +#torpassword= + +# Support v2 transport (default: 1) +#v2transport=1 + +# Bind to the given address and add permission flags to the peers +# connecting to it. Use [host]:port notation for IPv6. Allowed +# permissions: bloomfilter (allow requesting BIP37 filtered blocks +# and transactions), noban (do not ban for misbehavior; implies +# download), forcerelay (relay transactions that are already in the +# mempool; implies relay), relay (relay even in -blocksonly mode, +# and unlimited transaction announcements), mempool (allow +# requesting BIP35 mempool contents), download (allow getheaders +# during IBD, no disconnect after maxuploadtarget limit), addr +# (responses to GETADDR avoid hitting the cache and contain random +# records with the most up-to-date info). Specify multiple +# permissions separated by commas (default: +# download,noban,mempool,relay). Can be specified multiple times. +#whitebind=<[permissions@]addr> + +# Add permission flags to the peers connecting from 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. Can be specified multiple +# times. +#whitelist=<[permissions@]IP address or network> + + +### Wallet options + + +# What type of addresses to use ("legacy", "p2sh-segwit", "bech32", or +# "bech32m", default: "legacy") +#addresstype=1 + +# Group outputs by address, selecting many (possibly all) or none, instead +# of selecting on a per-output basis. Privacy is improved as +# addresses are mostly swept with fewer transactions and outputs +# are aggregated in clean change addresses. It may result in higher +# fees due to less optimal coin selection caused by this added +# limitation and possibly a larger-than-necessary number of inputs +# being used. Always enabled for wallets with "avoid_reuse" +# enabled, otherwise default: 0. +#avoidpartialspends=1 + +# What type of change to use ("legacy", "p2sh-segwit", "bech32", or +# "bech32m"). Default is "legacy" when -addresstype=legacy, else it +# is an implementation detail. +#changetype=1 + +# The maximum feerate (in NMC/kvB) at which transaction building may use +# more inputs than strictly necessary so that the wallet's UTXO +# pool can be reduced (default: 0.01). +#consolidatefeerate= + +# Do not load the wallet and disable wallet RPC calls +#disablewallet=1 + +# The fee rate (in NMC/kvB) that indicates your tolerance for discarding +# change by adding it to the fee (default: 0.0001). Note: An output +# is discarded if it is dust at this rate, but we will always +# discard up to the dust relay fee and a discard fee above that is +# limited by the fee estimate for the longest target +#discardfee= + +# A fee rate (in NMC/kvB) that will be used when fee estimation has +# insufficient data. 0 to entirely disable the fallbackfee feature. +# (default: 0.00) +#fallbackfee= + +# Set key pool size to (default: 1000). Warning: Smaller sizes may +# increase the risk of losing funds when restoring from an old +# backup, if none of the addresses in the original keypool have +# been used. +#keypool= + +# Spend up to this amount in additional (absolute) fees (in NMC) if it +# allows the use of partial spend avoidance (default: 0.00) +#maxapsfee= + +# Fee rates (in NMC/kvB) smaller than this are considered zero fee for +# transaction creation (default: 0.001) +#mintxfee= + +# Fee rate (in NMC/kvB) to add to transactions you send (default: 0.00) +#paytxfee= + +# External signing tool, see doc/external-signer.md +#signer= + +# Spend unconfirmed change when sending transactions (default: 1) +#spendzeroconfchange=1 + +# If paytxfee is not set, include enough fee so transactions begin +# confirmation on average within n blocks (default: 6) +#txconfirmtarget= + +# Specify wallet path to load at startup. Can be used multiple times to +# load multiple wallets. Path is to a directory containing wallet +# data and log files. If the path is not absolute, it is +# interpreted relative to . This only loads existing +# wallets and does not create new ones. For backwards compatibility +# this also accepts names of existing top-level data files in +# . +#wallet= + +# Make the wallet broadcast transactions (default: 1) +#walletbroadcast=1 + +# Specify directory to hold wallets (default: /wallets if it +# exists, otherwise ) +#walletdir= + +# Execute command when a wallet transaction changes. %s in cmd is replaced +# by TxID, %w is replaced by wallet name, %b is replaced by the +# hash of the block including the transaction (set to 'unconfirmed' +# if the transaction is not included) and %h is replaced by the +# block height (-1 if not included). %w is not currently +# implemented on windows. On systems where %w is supported, it +# should NOT be quoted because this would break shell escaping used +# to invoke the command. +#walletnotify= + +# Send transactions with full-RBF opt-in enabled (RPC only, default: 1) +#walletrbf=1 + + +### ZeroMQ notification options + + +# Enable publish hash block in
+#zmqpubhashblock=
+ +# Set publish hash block outbound message high water mark (default: 1000) +#zmqpubhashblockhwm= + +# Enable publish hash transaction in
+#zmqpubhashtx=
+ +# Set publish hash transaction outbound message high water mark (default: +# 1000) +#zmqpubhashtxhwm= + +# Enable publish raw block in
+#zmqpubrawblock=
+ +# Set publish raw block outbound message high water mark (default: 1000) +#zmqpubrawblockhwm= + +# Enable publish raw transaction in
+#zmqpubrawtx=
+ +# Set publish raw transaction outbound message high water mark (default: +# 1000) +#zmqpubrawtxhwm= + +# Enable publish hash block and tx sequence in
+#zmqpubsequence=
+ +# Set publish hash sequence message high water mark (default: 1000) +#zmqpubsequencehwm= + + +### Debugging/Testing options + + +# Check name database for consistency every x blocks, -1 to disable +#checknamedb=1 + +# Output debug and trace logging (default: -nodebug, supplying +# is optional). If is not supplied or if = 1, +# output all debug and trace logging. can be: addrman, +# bench, blockstorage, cmpctblock, coindb, estimatefee, http, i2p, +# ipc, leveldb, libevent, mempool, mempoolrej, names, net, proxy, +# prune, qt, rand, reindex, rpc, scan, selectcoins, tor, +# txpackages, txreconciliation, util, validation, walletdb, zmq. +# This option can be specified multiple times to output multiple +# categories. +#debug= + +# Exclude debug and trace logging for a category. Can be used in +# conjunction with -debug=1 to output debug and trace logging for +# all categories except the specified category. This option can be +# specified multiple times to exclude multiple categories. +#debugexclude= + +# Print help message with debugging options and exit +#help-debug=1 + +# Include IP addresses in debug output (default: 0) +#logips=1 + +# Always prepend a category and level (default: 0) +#loglevelalways=1 + +# Prepend debug output with name of the originating source location +# (source file, line number and function name) (default: 0) +#logsourcelocations=1 + +# Prepend debug output with name of the originating thread (only available +# on platforms supporting thread_local) (default: 0) +#logthreadnames=1 + +# Prepend debug output with timestamp (default: 1) +#logtimestamps=1 + +# Maximum total fees (in NMC) to use in a single wallet transaction; +# setting this too low may abort large transactions (default: 0.10) +#maxtxfee= + +# Send trace/debug info to console (default: 1 when no -daemon. To disable +# logging to file, set -nodebuglogfile) +#printtoconsole=1 + +# Shrink debug.log file on client startup (default: 1 when no -debug) +#shrinkdebugfile=1 + +# Append comment to the user agent string +#uacomment= + + +### Chain selection options + + +# Use the chain (default: main). Allowed values: main, test, +# signet, regtest +#chain= + +# Use the signet chain. Equivalent to -chain=signet. Note that the network +# is defined by the -signetchallenge parameter +#signet=1 + +# Blocks must satisfy the given script to be considered valid (only for +# signet networks; defaults to the global default signet test +# network challenge) +#signetchallenge=1 + +# Specify a seed node for the signet network, in the hostname[:port] +# format, e.g. sig.net:1234 (may be used multiple times to specify +# multiple seed nodes; defaults to the global default signet test +# network seed node(s)) +#signetseednode=1 + +# Use the test chain. Equivalent to -chain=test. +#testnet=1 + + +### Node relay options + + +# Equivalent bytes per sigop in transactions for relay and mining +# (default: 20) +#bytespersigop=1 + +# Relay and mine data carrier transactions (default: 1) +#datacarrier=1 + +# Relay and mine transactions whose data-carrying raw scriptPubKey is of +# this size or less (default: 83) +#datacarriersize=1 + +# Accept transaction replace-by-fee without requiring replaceability +# signaling (default: 0) +#mempoolfullrbf=1 + +# Fees (in NMC/kvB) smaller than this are considered zero fee for +# relaying, mining and transaction creation (default: 0.001) +#minrelaytxfee= + +# Relay non-P2SH multisig (default: 1) +#permitbaremultisig=1 + +# Add 'forcerelay' permission to whitelisted inbound peers with default +# permissions. This will relay transactions even if the +# transactions were already in the mempool. (default: 0) +#whitelistforcerelay=1 + +# Add 'relay' permission to whitelisted inbound peers with default +# permissions. This will accept relayed transactions even when not +# relaying transactions (default: 1) +#whitelistrelay=1 + + +### Block creation options + + +# Set maximum BIP141 block weight (default: 3996000) +#blockmaxweight= + +# Set lowest fee rate (in NMC/kvB) for transactions to be included in +# block creation. (default: 0.00001) +#blockmintxfee= + + +### RPC server options + + +# Throw error on expired names (default: 0) +#allowexpired=1 + +# Limit pending chains of name operations for name_update to (default: +# 1) +#limitnamechains= + +# Sets the default encoding used for names in the RPC interface (default: +# ascii) +#nameencoding= + +# Accept public REST requests (default: 0) +#rest=1 + +# Allow JSON-RPC connections from specified source. Valid values for +# 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 +#rpcallowip= + +# Username and HMAC-SHA-256 hashed password for JSON-RPC connections. The +# field comes in the format: :$. A +# canonical python script is included in share/rpcauth. The client +# then connects normally using the +# rpcuser=/rpcpassword= pair of arguments. This +# option can be specified multiple times +#rpcauth= + +# 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) +#rpcbind=[:port] + +# Location of the auth cookie. Relative paths will be prefixed by a +# net-specific datadir location. (default: data dir) +#rpccookiefile= + +# Password for JSON-RPC connections +#rpcpassword= + +# Listen for JSON-RPC connections on (default: 8336, testnet: +# 18336, signet: 38336, regtest: 18443) +#rpcport= + +# Set the number of threads to service RPC calls (default: 4) +#rpcthreads= + +# Username for JSON-RPC connections +#rpcuser= + +# Set a whitelist to filter incoming RPC calls for a specific user. The +# field comes in the format: :,,...,. If multiple whitelists are set for a given user, +# they are set-intersected. See -rpcwhitelistdefault documentation +# for information on default whitelist behavior. +#rpcwhitelist= + +# 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. +#rpcwhitelistdefault=1 + +# Accept command line and JSON-RPC commands +#server=1 + +# Sets the default encoding used for values in the RPC interface (default: +# ascii) +#valueencoding= + + +# [Sections] +# Most options will apply to all networks. To confine an option to a specific +# network, add it under the relevant section below. +# +# Note: If not specified under a network section, the options addnode, connect, +# port, bind, rpcport, rpcbind, and wallet will only apply to mainnet. + +# Options for mainnet +[main] + +# Options for testnet +[test] + +# Options for signet +[signet] + +# Options for regtest +[regtest]