diff --git a/doc/man/bitcoin-cli.1 b/doc/man/bitcoin-cli.1 index a84e8405d99ff2..bbd72d44587c29 100644 --- a/doc/man/bitcoin-cli.1 +++ b/doc/man/bitcoin-cli.1 @@ -1,13 +1,13 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH BITCOIN-CLI "1" "February 2024" "bitcoin-cli v26.1.0rc1" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH BITCOIN-CLI "1" "March 2024" "bitcoin-cli v26.1.0rc1" "User Commands" .SH NAME bitcoin-cli \- manual page for bitcoin-cli v26.1.0rc1 .SH SYNOPSIS .B bitcoin-cli -[\fI\,options\/\fR] \fI\, \/\fR[\fI\,params\/\fR] \fI\,Send command to Bitcoin Core\/\fR +[\fI\,options\/\fR] \fI\, \/\fR[\fI\,params\/\fR] \fI\,Send command to Bitcoin Knots\/\fR .br .B bitcoin-cli -[\fI\,options\/\fR] \fI\,-named \/\fR[\fI\,name=value\/\fR]... \fI\,Send command to Bitcoin Core (with named arguments)\/\fR +[\fI\,options\/\fR] \fI\,-named \/\fR[\fI\,name=value\/\fR]... \fI\,Send command to Bitcoin Knots (with named arguments)\/\fR .br .B bitcoin-cli [\fI\,options\/\fR] \fI\,help List commands\/\fR @@ -15,7 +15,7 @@ bitcoin-cli \- manual page for bitcoin-cli v26.1.0rc1 .B bitcoin-cli [\fI\,options\/\fR] \fI\,help Get help for a command\/\fR .SH DESCRIPTION -Bitcoin Core RPC client version v26.1.0rc1 +Bitcoin Knots RPC client version v26.1.0rc1 .SH OPTIONS .HP \-? @@ -39,6 +39,12 @@ and OS is not WIN32), never. Specify configuration file. Relative paths will be prefixed by datadir location. (default: bitcoin.conf) .HP +\fB\-confrw=\fR +.IP +Specify read/write configuration file. Relative paths will be prefixed +by the network\-specific datadir location. (default: +bitcoin_rw.conf) +.HP \fB\-datadir=\fR .IP Specify data directory @@ -54,11 +60,12 @@ nblocks and maxtries arguments. Example: bitcoin\-cli \fB\-generate\fR 4 .HP \fB\-getinfo\fR .IP -Get general information from the remote server. Note that unlike -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) +Get general information from the remote server, including the total +balance and the balances of each loaded wallet when in +multiwallet mode. Note that \fB\-getinfo\fR is the combined result of +several RPCs (getnetworkinfo, getblockchaininfo, getwalletinfo, +getbalances, and in multiwallet mode, listwallets), each with +potentially different state. .HP \fB\-named\fR .IP @@ -153,6 +160,12 @@ signet, regtest Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network is defined by the \fB\-signetchallenge\fR parameter .HP +\fB\-signetblocktime\fR +.IP +Difficulty adjustment will target a block time of the given amount in +seconds (only for custom signet networks, must have +\fB\-signetchallenge\fR set; defaults to 10 minutes) +.HP \fB\-signetchallenge\fR .IP Blocks must satisfy the given script to be considered valid (only for @@ -170,11 +183,11 @@ network seed node(s)) .IP Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR. .SH COPYRIGHT -Copyright (C) 2009-2023 The Bitcoin Core developers +Copyright (C) 2009-2024 The Bitcoin Core developers -Please contribute if you find Bitcoin Core useful. Visit - for further information about the software. -The source code is available from . +Please contribute if you find Bitcoin Knots 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 diff --git a/doc/man/bitcoin-qt.1 b/doc/man/bitcoin-qt.1 index 4e048c0f5945d1..272014d0bae886 100644 --- a/doc/man/bitcoin-qt.1 +++ b/doc/man/bitcoin-qt.1 @@ -1,12 +1,12 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH BITCOIN-QT "1" "February 2024" "bitcoin-qt v26.1.0rc1" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH BITCOIN-QT "1" "March 2024" "bitcoin-qt v26.1.0rc1" "User Commands" .SH NAME bitcoin-qt \- manual page for bitcoin-qt v26.1.0rc1 .SH SYNOPSIS .B bitcoin-qt -[\fI\,command-line options\/\fR] +[\fI\,command-line options\/\fR] [\fI\,URI\/\fR] .SH DESCRIPTION -Bitcoin Core version v26.1.0rc1 +Bitcoin Knots version v26.1.0rc1 .SH OPTIONS .HP \-? @@ -28,7 +28,7 @@ datadir as a warning, not an error. 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: -00000000000000000001a0a448d6cf2546b06801389cc030b2b18c6491266815, +00000000000000000003349bda23ed5efc98145c10620c247ec93896ac249e22, testnet: 0000000000000093bcb68c03a9a168ae252572d348a2eaeba2cdf9231d73206f, signet: @@ -37,8 +37,8 @@ signet: \fB\-blockfilterindex=\fR .IP 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. +basic, v0). If is not supplied or if = 1, certain +indexes are enabled (currently just basic). .HP \fB\-blocknotify=\fR .IP @@ -57,10 +57,10 @@ Specify directory to hold blocks subdirectory for *.dat files (default: .HP \fB\-blocksonly\fR .IP -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) +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: 0) .HP \fB\-coinstatsindex\fR .IP @@ -72,6 +72,16 @@ Specify path to read\-only configuration file. Relative paths will be prefixed by datadir location (only useable from command line, not configuration file) (default: bitcoin.conf) .HP +\fB\-confrw=\fR +.IP +Specify read/write configuration file. Relative paths will be prefixed +by the network\-specific datadir location (default: +bitcoin_rw.conf) +.HP +\fB\-corepolicy\fR +.IP +Use Bitcoin Core policy defaults (default: 0) +.HP \fB\-daemon\fR .IP Run in the background as a daemon and accept commands (default: 0) @@ -87,7 +97,7 @@ Specify data directory .HP \fB\-dbcache=\fR .IP -Maximum database cache size MiB (4 to 16384, default: 450). In +Maximum database cache size MiB (4 to 1048576, default: 450). In addition, unused mempool memory is shared for this cache (see \fB\-maxmempool\fR). .HP @@ -106,6 +116,11 @@ Specify additional configuration file, relative to the \fB\-datadir\fR path .IP Imports blocks from external file on startup .HP +\fB\-lowmem=\fR +.IP +If system available memory falls below MiB, flush caches (0 to +disable, default: 10) +.HP \fB\-maxmempool=\fR .IP Keep the transaction memory pool below megabytes (default: 300) @@ -151,7 +166,8 @@ 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. +reloaded via RPC. Setting this to auto automatically reindexes +the block database if it is corrupted. .HP \fB\-reindex\-chainstate\fR .IP @@ -333,7 +349,7 @@ Serve compact block filters to peers per BIP 157 (default: 0) \fB\-peerbloomfilters\fR .IP Support filtering of blocks and transaction with bloom filters (default: -0) +1) .HP \fB\-port=\fR .IP @@ -370,40 +386,53 @@ 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\-torexecute=\fR +.IP +Tor command to use if not already running (default: tor) +.HP \fB\-torpassword=\fR .IP Tor control port password (default: empty) .HP +\fB\-uaappend=\fR +.IP +Append literal to the user agent string (should only be used for +software embedding) +.HP \fB\-upnp\fR .IP -Use UPnP to map the listening port (default: 1 when listening and no -\fB\-proxy\fR) +Use UPnP to map the listening port (default: 0) .HP \fB\-v2transport\fR .IP -Support v2 transport (default: 0) +Support v2 transport (default: 1) .HP \fB\-whitebind=\fR<[permissions@]addr> .IP 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 +and transactions), blockfilters (serve compact block filters to +peers per BIP157), noban (do not ban for misbehavior; implies download), forcerelay (relay transactions that are already in the mempool; implies relay), relay (relay even in \fB\-blocksonly\fR 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 +records with the most up\-to\-date info), forceinbound (when +connections are full, attempt to evict a random unprotected +inbound peer to open a slot; implies noban). Specify multiple permissions separated by commas (default: download,noban,mempool,relay). Can be specified multiple times. .HP \fB\-whitelist=\fR<[permissions@]IP address or network> .IP -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 \fB\-whitebind\fR. Can be specified multiple +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 \fB\-whitebind\fR. Additional flags "in" and "out" +control whether permissions apply to incoming connections and/or +outgoing (default: incoming only). Can be specified multiple times. .PP Wallet options: @@ -486,7 +515,7 @@ Spend unconfirmed change when sending transactions (default: 1) \fB\-txconfirmtarget=\fR .IP If paytxfee is not set, include enough fee so transactions begin -confirmation on average within n blocks (default: 6) +confirmation on average within n blocks (default: 144) .HP \fB\-wallet=\fR .IP @@ -507,16 +536,20 @@ Make the wallet broadcast transactions (default: 1) Specify directory to hold wallets (default: /wallets if it exists, otherwise ) .HP +\fB\-walletimplicitsegwit\fR +.IP +Support segwit when restoring wallet backups and importing keys +(default: 0) +.HP \fB\-walletnotify=\fR .IP 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 (\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. +block height (\fB\-1\fR if not included). %w should NOT be quoted +because this would break shell escaping used to invoke the +command. .HP \fB\-walletrbf\fR .IP @@ -541,6 +574,15 @@ Enable publish hash transaction in
Set publish hash transaction outbound message high water mark (default: 1000) .HP +\fB\-zmqpubhashwallettx=\fR
+.IP +Enable publish hash wallet transaction in
+.HP +\fB\-zmqpubhashwallettxhwm=\fR +.IP +Set publish hash wallet transaction outbound message high water mark +(default: 1000) +.HP \fB\-zmqpubrawblock=\fR
.IP Enable publish raw block in
@@ -558,6 +600,15 @@ Enable publish raw transaction in
Set publish raw transaction outbound message high water mark (default: 1000) .HP +\fB\-zmqpubrawwallettx=\fR
+.IP +Enable publish raw wallet transaction in
+.HP +\fB\-zmqpubrawwallettxhwm=\fR +.IP +Set publish raw wallet transaction outbound message high water mark +(default: 1000) +.HP \fB\-zmqpubsequence=\fR
.IP Enable publish hash block and tx sequence in
@@ -574,10 +625,11 @@ 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, 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. +ipc, leveldb, libevent, lock, mempool, mempoolrej, 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 @@ -638,6 +690,12 @@ signet, regtest Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network is defined by the \fB\-signetchallenge\fR parameter .HP +\fB\-signetblocktime\fR +.IP +Difficulty adjustment will target a block time of the given amount in +seconds (only for custom signet networks, must have +\fB\-signetchallenge\fR set; defaults to 10 minutes) +.HP \fB\-signetchallenge\fR .IP Blocks must satisfy the given script to be considered valid (only for @@ -657,24 +715,47 @@ Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR. .PP Node relay options: .HP +\fB\-acceptnonstdtxn\fR +.IP +Relay and mine "non\-standard" transactions (default: 0) +.HP \fB\-bytespersigop\fR .IP Equivalent bytes per sigop in transactions for relay and mining (default: 20) .HP +\fB\-bytespersigopstrict\fR +.IP +Minimum bytes per sigop in transactions we relay and mine (default: 20) +.HP \fB\-datacarrier\fR .IP Relay and mine data carrier transactions (default: 1) .HP +\fB\-datacarriercost\fR +.IP +Treat extra data in transactions as at least N vbytes per actual byte +(default: 1) +.HP \fB\-datacarriersize\fR .IP -Relay and mine transactions whose data\-carrying raw scriptPubKey is of -this size or less (default: 83) +Maximum size of data in data carrier transactions we relay and mine +(default: 42) +.HP +\fB\-maxscriptsize\fR +.IP +Maximum size of scripts we relay and mine (default: 1650) .HP \fB\-mempoolfullrbf\fR .IP Accept transaction replace\-by\-fee without requiring replaceability -signaling (default: 0) +signaling (default: 1) +.HP +\fB\-mempoolreplacement\fR +.IP +Set to 0 to disable RBF entirely, "fee,optin" to honour RBF opt\-out +signal, or "fee,\-optin" to always RBF aka full RBF (default: +fee,\-optin) .HP \fB\-minrelaytxfee=\fR .IP @@ -683,30 +764,48 @@ relaying, mining and transaction creation (default: 0.00001) .HP \fB\-permitbaremultisig\fR .IP -Relay non\-P2SH multisig (default: 1) +Relay non\-P2SH multisig (default: 0) +.HP +\fB\-permitbarepubkey\fR +.IP +Relay legacy pubkey outputs (default: 0) +.HP +\fB\-spkreuse\fR +.IP +Accept transactions reusing addresses or other pubkey scripts (default: +allow) .HP \fB\-whitelistforcerelay\fR .IP -Add 'forcerelay' permission to whitelisted inbound peers with default +Add 'forcerelay' permission to whitelisted peers with default permissions. This will relay transactions even if the transactions were already in the mempool. (default: 0) .HP \fB\-whitelistrelay\fR .IP -Add 'relay' permission to whitelisted inbound peers with default -permissions. This will accept relayed transactions even when not -relaying transactions (default: 1) +Add 'relay' permission to whitelisted peers with default permissions. +This will accept relayed transactions even when not relaying +transactions (default: 1) .PP Block creation options: .HP +\fB\-blockmaxsize=\fR +.IP +Set maximum block size in bytes (default: 300000) +.HP \fB\-blockmaxweight=\fR .IP -Set maximum BIP141 block weight (default: 3996000) +Set maximum BIP141 block weight (default: 1500000) .HP \fB\-blockmintxfee=\fR .IP Set lowest fee rate (in BTC/kvB) for transactions to be included in block creation. (default: 0.00001) +.HP +\fB\-blockprioritysize=\fR +.IP +Set maximum size of high\-priority/low\-fee transactions in bytes +(default: 100000) .PP RPC server options: .HP @@ -731,6 +830,11 @@ then connects normally using the rpcuser=/rpcpassword= pair of arguments. This option can be specified multiple times .HP +\fB\-rpcauthfile=\fR +.IP +A file with a single lines with same format as rpcauth. This option can +be specified multiple times +.HP \fB\-rpcbind=\fR[:port] .IP Bind to given address to listen for JSON\-RPC connections. Do not expose @@ -745,6 +849,11 @@ IPv6. This option can be specified multiple times (default: Location of the auth cookie. Relative paths will be prefixed by a net\-specific datadir location. (default: data dir) .HP +\fB\-rpccookieperms=\fR +.IP +Set the permissions on the RPC auth cookie file to the specified octal +value (default: 400) +.HP \fB\-rpcpassword=\fR .IP Password for JSON\-RPC connections @@ -795,6 +904,10 @@ UI Options: .IP Choose data directory on startup (default: 0) .HP +\fB\-guisettingsdir=\fR +.IP +Choose a custom data directory especially for the Qt Settings +.HP \fB\-lang=\fR .IP Set language, for example "de_DE" (default: system locale) @@ -810,12 +923,22 @@ Reset all settings changed in the GUI \fB\-splash\fR .IP Show splash screen on startup (default: 1) +.PP +Statistic options: +.HP +\fB\-statsenable\fR +.IP +Enable statistics (default: 0) +.HP +\fB\-statsmaxmemorytarget=\fR +.IP +Set the memory limit target for statistics in bytes (default: 10485760) .SH COPYRIGHT -Copyright (C) 2009-2023 The Bitcoin Core developers +Copyright (C) 2009-2024 The Bitcoin Core developers -Please contribute if you find Bitcoin Core useful. Visit - for further information about the software. -The source code is available from . +Please contribute if you find Bitcoin Knots 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 diff --git a/doc/man/bitcoin-tx.1 b/doc/man/bitcoin-tx.1 index 9b27b88a8e3725..20d244c07f5291 100644 --- a/doc/man/bitcoin-tx.1 +++ b/doc/man/bitcoin-tx.1 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH BITCOIN-TX "1" "February 2024" "bitcoin-tx v26.1.0rc1" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH BITCOIN-TX "1" "March 2024" "bitcoin-tx v26.1.0rc1" "User Commands" .SH NAME bitcoin-tx \- manual page for bitcoin-tx v26.1.0rc1 .SH SYNOPSIS @@ -9,7 +9,7 @@ bitcoin-tx \- manual page for bitcoin-tx v26.1.0rc1 .B bitcoin-tx [\fI\,options\/\fR] \fI\,-create \/\fR[\fI\,commands\/\fR] \fI\,Create hex-encoded bitcoin transaction\/\fR .SH DESCRIPTION -Bitcoin Core bitcoin\-tx utility version v26.1.0rc1 +Bitcoin Knots bitcoin\-tx utility version v26.1.0rc1 .SH OPTIONS .HP \-? @@ -46,6 +46,12 @@ signet, regtest Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network is defined by the \fB\-signetchallenge\fR parameter .HP +\fB\-signetblocktime\fR +.IP +Difficulty adjustment will target a block time of the given amount in +seconds (only for custom signet networks, must have +\fB\-signetchallenge\fR set; defaults to 10 minutes) +.HP \fB\-signetchallenge\fR .IP Blocks must satisfy the given script to be considered valid (only for @@ -114,8 +120,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 @@ -134,11 +142,11 @@ set=NAME:JSON\-STRING .IP Set register NAME to given JSON\-STRING .SH COPYRIGHT -Copyright (C) 2009-2023 The Bitcoin Core developers +Copyright (C) 2009-2024 The Bitcoin Core developers -Please contribute if you find Bitcoin Core useful. Visit - for further information about the software. -The source code is available from . +Please contribute if you find Bitcoin Knots 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 diff --git a/doc/man/bitcoin-util.1 b/doc/man/bitcoin-util.1 index 0e7420493049b4..4c74bb0bf0047c 100644 --- a/doc/man/bitcoin-util.1 +++ b/doc/man/bitcoin-util.1 @@ -1,12 +1,12 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH BITCOIN-UTIL "1" "February 2024" "bitcoin-util v26.1.0rc1" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH BITCOIN-UTIL "1" "March 2024" "bitcoin-util v26.1.0rc1" "User Commands" .SH NAME bitcoin-util \- manual page for bitcoin-util v26.1.0rc1 .SH SYNOPSIS .B bitcoin-util [\fI\,options\/\fR] [\fI\,commands\/\fR] \fI\,Do stuff\/\fR .SH DESCRIPTION -Bitcoin Core bitcoin\-util utility version v26.1.0rc1 +Bitcoin Knots bitcoin\-util utility version v26.1.0rc1 .SH OPTIONS .HP \-? @@ -31,6 +31,12 @@ signet, regtest Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network is defined by the \fB\-signetchallenge\fR parameter .HP +\fB\-signetblocktime\fR +.IP +Difficulty adjustment will target a block time of the given amount in +seconds (only for custom signet networks, must have +\fB\-signetchallenge\fR set; defaults to 10 minutes) +.HP \fB\-signetchallenge\fR .IP Blocks must satisfy the given script to be considered valid (only for @@ -54,11 +60,11 @@ grind .IP Perform proof of work on hex header string .SH COPYRIGHT -Copyright (C) 2009-2023 The Bitcoin Core developers +Copyright (C) 2009-2024 The Bitcoin Core developers -Please contribute if you find Bitcoin Core useful. Visit - for further information about the software. -The source code is available from . +Please contribute if you find Bitcoin Knots 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 diff --git a/doc/man/bitcoin-wallet.1 b/doc/man/bitcoin-wallet.1 index f09d68b2c6be09..ddc5be2a5f5ee3 100644 --- a/doc/man/bitcoin-wallet.1 +++ b/doc/man/bitcoin-wallet.1 @@ -1,11 +1,11 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH BITCOIN-WALLET "1" "February 2024" "bitcoin-wallet v26.1.0rc1" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH BITCOIN-WALLET "1" "March 2024" "bitcoin-wallet v26.1.0rc1" "User Commands" .SH NAME bitcoin-wallet \- manual page for bitcoin-wallet v26.1.0rc1 .SH DESCRIPTION -Bitcoin Core bitcoin\-wallet version v26.1.0rc1 +Bitcoin Knots bitcoin\-wallet version v26.1.0rc1 .PP -bitcoin\-wallet is an offline tool for creating and interacting with Bitcoin Core wallet files. +bitcoin\-wallet is an offline tool for creating and interacting with Bitcoin Knots wallet files. By default bitcoin\-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\-regtest\fR/\-signet/\-testnet arguments. .SS "Usage:" @@ -70,6 +70,12 @@ signet, regtest Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network is defined by the \fB\-signetchallenge\fR parameter .HP +\fB\-signetblocktime\fR +.IP +Difficulty adjustment will target a block time of the given amount in +seconds (only for custom signet networks, must have +\fB\-signetchallenge\fR set; defaults to 10 minutes) +.HP \fB\-signetchallenge\fR .IP Blocks must satisfy the given script to be considered valid (only for @@ -101,6 +107,10 @@ dump .IP Print out all of the wallet key\-value records .IP +importfromcoldcard +.IP +Create new wallet file and import descriptors from Coldcard wallet +.IP info .IP Get wallet info @@ -110,11 +120,11 @@ salvage Attempt to recover private keys from a corrupt wallet. Warning: \&'salvage' is experimental. .SH COPYRIGHT -Copyright (C) 2009-2023 The Bitcoin Core developers +Copyright (C) 2009-2024 The Bitcoin Core developers -Please contribute if you find Bitcoin Core useful. Visit - for further information about the software. -The source code is available from . +Please contribute if you find Bitcoin Knots 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 diff --git a/doc/man/bitcoind.1 b/doc/man/bitcoind.1 index 717d6503d76774..70eab0ac233a4d 100644 --- a/doc/man/bitcoind.1 +++ b/doc/man/bitcoind.1 @@ -1,12 +1,12 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1. -.TH BITCOIND "1" "February 2024" "bitcoind v26.1.0rc1" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH BITCOIND "1" "March 2024" "bitcoind v26.1.0rc1" "User Commands" .SH NAME bitcoind \- manual page for bitcoind v26.1.0rc1 .SH SYNOPSIS .B bitcoind -[\fI\,options\/\fR] \fI\,Start Bitcoin Core\/\fR +[\fI\,options\/\fR] \fI\,Start Bitcoin Knots\/\fR .SH DESCRIPTION -Bitcoin Core version v26.1.0rc1 +Bitcoin Knots version v26.1.0rc1 .SH OPTIONS .HP \-? @@ -28,7 +28,7 @@ datadir as a warning, not an error. 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: -00000000000000000001a0a448d6cf2546b06801389cc030b2b18c6491266815, +00000000000000000003349bda23ed5efc98145c10620c247ec93896ac249e22, testnet: 0000000000000093bcb68c03a9a168ae252572d348a2eaeba2cdf9231d73206f, signet: @@ -37,8 +37,8 @@ signet: \fB\-blockfilterindex=\fR .IP 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. +basic, v0). If is not supplied or if = 1, certain +indexes are enabled (currently just basic). .HP \fB\-blocknotify=\fR .IP @@ -57,10 +57,10 @@ Specify directory to hold blocks subdirectory for *.dat files (default: .HP \fB\-blocksonly\fR .IP -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) +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: 0) .HP \fB\-coinstatsindex\fR .IP @@ -72,6 +72,16 @@ Specify path to read\-only configuration file. Relative paths will be prefixed by datadir location (only useable from command line, not configuration file) (default: bitcoin.conf) .HP +\fB\-confrw=\fR +.IP +Specify read/write configuration file. Relative paths will be prefixed +by the network\-specific datadir location (default: +bitcoin_rw.conf) +.HP +\fB\-corepolicy\fR +.IP +Use Bitcoin Core policy defaults (default: 0) +.HP \fB\-daemon\fR .IP Run in the background as a daemon and accept commands (default: 0) @@ -87,7 +97,7 @@ Specify data directory .HP \fB\-dbcache=\fR .IP -Maximum database cache size MiB (4 to 16384, default: 450). In +Maximum database cache size MiB (4 to 1048576, default: 450). In addition, unused mempool memory is shared for this cache (see \fB\-maxmempool\fR). .HP @@ -106,6 +116,11 @@ Specify additional configuration file, relative to the \fB\-datadir\fR path .IP Imports blocks from external file on startup .HP +\fB\-lowmem=\fR +.IP +If system available memory falls below MiB, flush caches (0 to +disable, default: 10) +.HP \fB\-maxmempool=\fR .IP Keep the transaction memory pool below megabytes (default: 300) @@ -151,7 +166,8 @@ 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. +reloaded via RPC. Setting this to auto automatically reindexes +the block database if it is corrupted. .HP \fB\-reindex\-chainstate\fR .IP @@ -333,7 +349,7 @@ Serve compact block filters to peers per BIP 157 (default: 0) \fB\-peerbloomfilters\fR .IP Support filtering of blocks and transaction with bloom filters (default: -0) +1) .HP \fB\-port=\fR .IP @@ -370,40 +386,53 @@ 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\-torexecute=\fR +.IP +Tor command to use if not already running (default: tor) +.HP \fB\-torpassword=\fR .IP Tor control port password (default: empty) .HP +\fB\-uaappend=\fR +.IP +Append literal to the user agent string (should only be used for +software embedding) +.HP \fB\-upnp\fR .IP -Use UPnP to map the listening port (default: 1 when listening and no -\fB\-proxy\fR) +Use UPnP to map the listening port (default: 0) .HP \fB\-v2transport\fR .IP -Support v2 transport (default: 0) +Support v2 transport (default: 1) .HP \fB\-whitebind=\fR<[permissions@]addr> .IP 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 +and transactions), blockfilters (serve compact block filters to +peers per BIP157), noban (do not ban for misbehavior; implies download), forcerelay (relay transactions that are already in the mempool; implies relay), relay (relay even in \fB\-blocksonly\fR 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 +records with the most up\-to\-date info), forceinbound (when +connections are full, attempt to evict a random unprotected +inbound peer to open a slot; implies noban). Specify multiple permissions separated by commas (default: download,noban,mempool,relay). Can be specified multiple times. .HP \fB\-whitelist=\fR<[permissions@]IP address or network> .IP -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 \fB\-whitebind\fR. Can be specified multiple +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 \fB\-whitebind\fR. Additional flags "in" and "out" +control whether permissions apply to incoming connections and/or +outgoing (default: incoming only). Can be specified multiple times. .PP Wallet options: @@ -486,7 +515,7 @@ Spend unconfirmed change when sending transactions (default: 1) \fB\-txconfirmtarget=\fR .IP If paytxfee is not set, include enough fee so transactions begin -confirmation on average within n blocks (default: 6) +confirmation on average within n blocks (default: 144) .HP \fB\-wallet=\fR .IP @@ -507,16 +536,20 @@ Make the wallet broadcast transactions (default: 1) Specify directory to hold wallets (default: /wallets if it exists, otherwise ) .HP +\fB\-walletimplicitsegwit\fR +.IP +Support segwit when restoring wallet backups and importing keys +(default: 0) +.HP \fB\-walletnotify=\fR .IP 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 (\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. +block height (\fB\-1\fR if not included). %w should NOT be quoted +because this would break shell escaping used to invoke the +command. .HP \fB\-walletrbf\fR .IP @@ -541,6 +574,15 @@ Enable publish hash transaction in
Set publish hash transaction outbound message high water mark (default: 1000) .HP +\fB\-zmqpubhashwallettx=\fR
+.IP +Enable publish hash wallet transaction in
+.HP +\fB\-zmqpubhashwallettxhwm=\fR +.IP +Set publish hash wallet transaction outbound message high water mark +(default: 1000) +.HP \fB\-zmqpubrawblock=\fR
.IP Enable publish raw block in
@@ -558,6 +600,15 @@ Enable publish raw transaction in
Set publish raw transaction outbound message high water mark (default: 1000) .HP +\fB\-zmqpubrawwallettx=\fR
+.IP +Enable publish raw wallet transaction in
+.HP +\fB\-zmqpubrawwallettxhwm=\fR +.IP +Set publish raw wallet transaction outbound message high water mark +(default: 1000) +.HP \fB\-zmqpubsequence=\fR
.IP Enable publish hash block and tx sequence in
@@ -574,10 +625,11 @@ 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, 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. +ipc, leveldb, libevent, lock, mempool, mempoolrej, 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 @@ -638,6 +690,12 @@ signet, regtest Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network is defined by the \fB\-signetchallenge\fR parameter .HP +\fB\-signetblocktime\fR +.IP +Difficulty adjustment will target a block time of the given amount in +seconds (only for custom signet networks, must have +\fB\-signetchallenge\fR set; defaults to 10 minutes) +.HP \fB\-signetchallenge\fR .IP Blocks must satisfy the given script to be considered valid (only for @@ -657,24 +715,47 @@ Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR. .PP Node relay options: .HP +\fB\-acceptnonstdtxn\fR +.IP +Relay and mine "non\-standard" transactions (default: 0) +.HP \fB\-bytespersigop\fR .IP Equivalent bytes per sigop in transactions for relay and mining (default: 20) .HP +\fB\-bytespersigopstrict\fR +.IP +Minimum bytes per sigop in transactions we relay and mine (default: 20) +.HP \fB\-datacarrier\fR .IP Relay and mine data carrier transactions (default: 1) .HP +\fB\-datacarriercost\fR +.IP +Treat extra data in transactions as at least N vbytes per actual byte +(default: 1) +.HP \fB\-datacarriersize\fR .IP -Relay and mine transactions whose data\-carrying raw scriptPubKey is of -this size or less (default: 83) +Maximum size of data in data carrier transactions we relay and mine +(default: 42) +.HP +\fB\-maxscriptsize\fR +.IP +Maximum size of scripts we relay and mine (default: 1650) .HP \fB\-mempoolfullrbf\fR .IP Accept transaction replace\-by\-fee without requiring replaceability -signaling (default: 0) +signaling (default: 1) +.HP +\fB\-mempoolreplacement\fR +.IP +Set to 0 to disable RBF entirely, "fee,optin" to honour RBF opt\-out +signal, or "fee,\-optin" to always RBF aka full RBF (default: +fee,\-optin) .HP \fB\-minrelaytxfee=\fR .IP @@ -683,30 +764,48 @@ relaying, mining and transaction creation (default: 0.00001) .HP \fB\-permitbaremultisig\fR .IP -Relay non\-P2SH multisig (default: 1) +Relay non\-P2SH multisig (default: 0) +.HP +\fB\-permitbarepubkey\fR +.IP +Relay legacy pubkey outputs (default: 0) +.HP +\fB\-spkreuse\fR +.IP +Accept transactions reusing addresses or other pubkey scripts (default: +allow) .HP \fB\-whitelistforcerelay\fR .IP -Add 'forcerelay' permission to whitelisted inbound peers with default +Add 'forcerelay' permission to whitelisted peers with default permissions. This will relay transactions even if the transactions were already in the mempool. (default: 0) .HP \fB\-whitelistrelay\fR .IP -Add 'relay' permission to whitelisted inbound peers with default -permissions. This will accept relayed transactions even when not -relaying transactions (default: 1) +Add 'relay' permission to whitelisted peers with default permissions. +This will accept relayed transactions even when not relaying +transactions (default: 1) .PP Block creation options: .HP +\fB\-blockmaxsize=\fR +.IP +Set maximum block size in bytes (default: 300000) +.HP \fB\-blockmaxweight=\fR .IP -Set maximum BIP141 block weight (default: 3996000) +Set maximum BIP141 block weight (default: 1500000) .HP \fB\-blockmintxfee=\fR .IP Set lowest fee rate (in BTC/kvB) for transactions to be included in block creation. (default: 0.00001) +.HP +\fB\-blockprioritysize=\fR +.IP +Set maximum size of high\-priority/low\-fee transactions in bytes +(default: 100000) .PP RPC server options: .HP @@ -731,6 +830,11 @@ then connects normally using the rpcuser=/rpcpassword= pair of arguments. This option can be specified multiple times .HP +\fB\-rpcauthfile=\fR +.IP +A file with a single lines with same format as rpcauth. This option can +be specified multiple times +.HP \fB\-rpcbind=\fR[:port] .IP Bind to given address to listen for JSON\-RPC connections. Do not expose @@ -745,6 +849,11 @@ IPv6. This option can be specified multiple times (default: Location of the auth cookie. Relative paths will be prefixed by a net\-specific datadir location. (default: data dir) .HP +\fB\-rpccookieperms=\fR +.IP +Set the permissions on the RPC auth cookie file to the specified octal +value (default: 400) +.HP \fB\-rpcpassword=\fR .IP Password for JSON\-RPC connections @@ -788,12 +897,22 @@ subject to empty whitelists. \fB\-server\fR .IP Accept command line and JSON\-RPC commands +.PP +Statistic options: +.HP +\fB\-statsenable\fR +.IP +Enable statistics (default: 0) +.HP +\fB\-statsmaxmemorytarget=\fR +.IP +Set the memory limit target for statistics in bytes (default: 10485760) .SH COPYRIGHT -Copyright (C) 2009-2023 The Bitcoin Core developers +Copyright (C) 2009-2024 The Bitcoin Core developers -Please contribute if you find Bitcoin Core useful. Visit - for further information about the software. -The source code is available from . +Please contribute if you find Bitcoin Knots 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 diff --git a/share/examples/bitcoin.conf b/share/examples/bitcoin.conf index 0470acd3001570..87e0777ed85188 100644 --- a/share/examples/bitcoin.conf +++ b/share/examples/bitcoin.conf @@ -23,7 +23,7 @@ # 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: -# 00000000000000000001a0a448d6cf2546b06801389cc030b2b18c6491266815, +# 00000000000000000003349bda23ed5efc98145c10620c247ec93896ac249e22, # testnet: # 0000000000000093bcb68c03a9a168ae252572d348a2eaeba2cdf9231d73206f, # signet: @@ -31,8 +31,8 @@ #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. +# basic, v0). If is not supplied or if = 1, certain +# indexes are enabled (currently just basic). #blockfilterindex= # Execute command when the best block changes (%s in cmd is replaced by @@ -47,10 +47,10 @@ # ) #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) +# 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: 0) #blocksonly=1 # Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0) @@ -61,6 +61,14 @@ # configuration file) (default: bitcoin.conf) #conf= +# Specify read/write configuration file. Relative paths will be prefixed +# by the network-specific datadir location (default: +# bitcoin_rw.conf) +#confrw= + +# Use Bitcoin Core policy defaults (default: 0) +#corepolicy=1 + # Run in the background as a daemon and accept commands (default: 0) #daemon=1 @@ -71,7 +79,7 @@ # Specify data directory #datadir= -# Maximum database cache size MiB (4 to 16384, default: 450). In +# Maximum database cache size MiB (4 to 1048576, default: 450). In # addition, unused mempool memory is shared for this cache (see # -maxmempool). #dbcache= @@ -88,6 +96,10 @@ # Imports blocks from external file on startup #loadblock= +# If system available memory falls below MiB, flush caches (0 to +# disable, default: 10) +#lowmem= + # Keep the transaction memory pool below megabytes (default: 300) #maxmempool= @@ -124,7 +136,8 @@ # 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. +# reloaded via RPC. Setting this to auto automatically reindexes +# the block database if it is corrupted. #reindex=1 # If enabled, wipe chain state, and rebuild it from blk*.dat files on @@ -275,7 +288,7 @@ #peerblockfilters=1 # Support filtering of blocks and transaction with bloom filters (default: -# 0) +# 1) #peerbloomfilters=1 # Listen for connections on . Nodes not using the default ports @@ -307,34 +320,45 @@ # 9051 will be used. #torcontrol=: +# Tor command to use if not already running (default: tor) +#torexecute= + # Tor control port password (default: empty) #torpassword= -# Use UPnP to map the listening port (default: 1 when listening and no -# -proxy) +# Append literal to the user agent string (should only be used for +# software embedding) +#uaappend= + +# Use UPnP to map the listening port (default: 0) #upnp=1 -# Support v2 transport (default: 0) +# 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 +# and transactions), blockfilters (serve compact block filters to +# peers per BIP157), 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 +# records with the most up-to-date info), forceinbound (when +# connections are full, attempt to evict a random unprotected +# inbound peer to open a slot; implies noban). 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 +# 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 +# outgoing (default: incoming only). Can be specified multiple # times. #whitelist=<[permissions@]IP address or network> @@ -405,7 +429,7 @@ #spendzeroconfchange=1 # If paytxfee is not set, include enough fee so transactions begin -# confirmation on average within n blocks (default: 6) +# confirmation on average within n blocks (default: 144) #txconfirmtarget= # Specify wallet path to load at startup. Can be used multiple times to @@ -424,14 +448,17 @@ # exists, otherwise ) #walletdir= +# Support segwit when restoring wallet backups and importing keys +# (default: 0) +#walletimplicitsegwit=1 + # 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. +# block height (-1 if not included). %w 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) @@ -454,6 +481,13 @@ # 1000) #zmqpubhashtxhwm= +# Enable publish hash wallet transaction in
+#zmqpubhashwallettx=
+ +# Set publish hash wallet transaction outbound message high water mark +# (default: 1000) +#zmqpubhashwallettxhwm= + # Enable publish raw block in
#zmqpubrawblock=
@@ -467,6 +501,13 @@ # 1000) #zmqpubrawtxhwm= +# Enable publish raw wallet transaction in
+#zmqpubrawwallettx=
+ +# Set publish raw wallet transaction outbound message high water mark +# (default: 1000) +#zmqpubrawwallettxhwm= + # Enable publish hash block and tx sequence in
#zmqpubsequence=
@@ -481,10 +522,11 @@ # 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, 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. +# ipc, leveldb, libevent, lock, mempool, mempoolrej, 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 @@ -536,6 +578,11 @@ # is defined by the -signetchallenge parameter #signet=1 +# Difficulty adjustment will target a block time of the given amount in +# seconds (only for custom signet networks, must have +# -signetchallenge set; defaults to 10 minutes) +#signetblocktime=1 + # Blocks must satisfy the given script to be considered valid (only for # signet networks; defaults to the global default signet test # network challenge) @@ -554,49 +601,81 @@ ### Node relay options +# Relay and mine "non-standard" transactions (default: 0) +#acceptnonstdtxn=1 + # Equivalent bytes per sigop in transactions for relay and mining # (default: 20) #bytespersigop=1 +# Minimum bytes per sigop in transactions we relay and mine (default: 20) +#bytespersigopstrict=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) +# Treat extra data in transactions as at least N vbytes per actual byte +# (default: 1) +#datacarriercost=1 + +# Maximum size of data in data carrier transactions we relay and mine +# (default: 42) #datacarriersize=1 +# Maximum size of scripts we relay and mine (default: 1650) +#maxscriptsize=1 + # Accept transaction replace-by-fee without requiring replaceability -# signaling (default: 0) +# signaling (default: 1) #mempoolfullrbf=1 +# Set to 0 to disable RBF entirely, "fee,optin" to honour RBF opt-out +# signal, or "fee,-optin" to always RBF aka full RBF (default: +# fee,-optin) +#mempoolreplacement=1 + # Fees (in BTC/kvB) smaller than this are considered zero fee for # relaying, mining and transaction creation (default: 0.00001) #minrelaytxfee= -# Relay non-P2SH multisig (default: 1) +# Relay non-P2SH multisig (default: 0) #permitbaremultisig=1 -# Add 'forcerelay' permission to whitelisted inbound peers with default +# Relay legacy pubkey outputs (default: 0) +#permitbarepubkey=1 + +# Accept transactions reusing addresses or other pubkey scripts (default: +# allow) +#spkreuse=1 + +# Add 'forcerelay' permission to whitelisted 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) +# Add 'relay' permission to whitelisted 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) +# Set maximum block size in bytes (default: 300000) +#blockmaxsize= + +# Set maximum BIP141 block weight (default: 1500000) #blockmaxweight= # Set lowest fee rate (in BTC/kvB) for transactions to be included in # block creation. (default: 0.00001) #blockmintxfee= +# Set maximum size of high-priority/low-fee transactions in bytes +# (default: 100000) +#blockprioritysize= + ### RPC server options @@ -619,6 +698,10 @@ # option can be specified multiple times #rpcauth= +# A file with a single lines with same format as rpcauth. This option can +# be specified multiple times +#rpcauthfile= + # 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 @@ -631,6 +714,10 @@ # net-specific datadir location. (default: data dir) #rpccookiefile= +# Set the permissions on the RPC auth cookie file to the specified octal +# value (default: 400) +#rpccookieperms= + # Password for JSON-RPC connections #rpcpassword= @@ -668,6 +755,16 @@ #server=1 +### Statistic options + + +# Enable statistics (default: 0) +#statsenable=1 + +# Set the memory limit target for statistics in bytes (default: 10485760) +#statsmaxmemorytarget= + + # [Sections] # Most options will apply to all networks. To confine an option to a specific # network, add it under the relevant section below.