mirror of
https://github.com/dashpay/dash.git
synced 2024-12-25 20:12:57 +01:00
d7cd9f10fd
2dabd78956chore: update man pages for v22 (UdjinM6) Pull request description: ## Issue being fixed or feature implemented ## What was done? ## How Has This Been Tested? ## Breaking Changes ## Checklist: - [ ] I have performed a self-review of my own code - [ ] I have commented my code, particularly in hard-to-understand areas - [ ] I have added or updated relevant unit/integration/functional/e2e tests - [ ] I have made corresponding changes to the documentation - [ ] I have assigned this pull request to a milestone _(for repository code-owners and collaborators only)_ ACKs for top commit: PastaPastaPasta: utACK2dabd78956knst: utACK2dabd78956Tree-SHA512: fc03af689e9c5be54f150d6727772038c70e1fafad0f450b431203aa0e662873e17095e702c8d970eafdd92e386bb471d7894ba51bb72b166fadefabdfaad116
1128 lines
32 KiB
Groff
1128 lines
32 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
|
|
.TH DASHD "1" "December 2024" "dashd v22.0.0" "User Commands"
|
|
.SH NAME
|
|
dashd \- manual page for dashd v22.0.0
|
|
.SH SYNOPSIS
|
|
.B dashd
|
|
[\fI\,options\/\fR] \fI\,Start Dash Core\/\fR
|
|
.SH DESCRIPTION
|
|
Dash Core version v22.0.0
|
|
Copyright \(co 2014\-2024 The Dash Core developers
|
|
Copyright \(co 2009\-2024 The Bitcoin Core developers
|
|
.PP
|
|
Please contribute if you find Dash Core useful. Visit <https://dash.org/> for
|
|
further information about the software.
|
|
The source code is available from <https://github.com/dashpay/dash>.
|
|
.PP
|
|
This is experimental software.
|
|
Distributed under the MIT software license, see the accompanying file COPYING
|
|
or <https://opensource.org/licenses/MIT>
|
|
.SH OPTIONS
|
|
.HP
|
|
\-?
|
|
.IP
|
|
Print this help message and exit
|
|
.HP
|
|
\fB\-alertnotify=\fR<cmd>
|
|
.IP
|
|
Execute command when an alert is raised (%s in cmd is replaced by
|
|
message)
|
|
.HP
|
|
\fB\-assumevalid=\fR<hex>
|
|
.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:
|
|
000000000000001cf26547602d982dcaa909231bbcd1e70c0eb3c65de25473ba,
|
|
testnet:
|
|
000000eef20eb0062abd4e799967e98bdebb165dd1c567ab4118c1c86c6e948f)
|
|
.HP
|
|
\fB\-blockfilterindex=\fR<type>
|
|
.IP
|
|
Maintain an index of compact filters by block (default: 0, values:
|
|
basic). If <type> is not supplied or if <type> = 1, indexes for
|
|
all known types are enabled.
|
|
.HP
|
|
\fB\-blocknotify=\fR<cmd>
|
|
.IP
|
|
Execute command when the best block changes (%s in cmd is replaced by
|
|
block hash)
|
|
.HP
|
|
\fB\-blockreconstructionextratxn=\fR<n>
|
|
.IP
|
|
Extra transactions to keep in memory for compact block reconstructions
|
|
(default: 100)
|
|
.HP
|
|
\fB\-blocksdir=\fR<dir>
|
|
.IP
|
|
Specify directory to hold blocks subdirectory for *.dat files (default:
|
|
<datadir>)
|
|
.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)
|
|
.HP
|
|
\fB\-chainlocknotify=\fR<cmd>
|
|
.IP
|
|
Execute command when the best chainlock changes (%s in cmd is replaced
|
|
by chainlocked block hash)
|
|
.HP
|
|
\fB\-coinstatsindex\fR
|
|
.IP
|
|
Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0)
|
|
.HP
|
|
\fB\-conf=\fR<file>
|
|
.IP
|
|
Specify path to read\-only configuration file. Relative paths will be
|
|
prefixed by datadir location. (default: dash.conf)
|
|
.HP
|
|
\fB\-daemon\fR
|
|
.IP
|
|
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<dir>
|
|
.IP
|
|
Specify data directory
|
|
.HP
|
|
\fB\-dbcache=\fR<n>
|
|
.IP
|
|
Maximum database cache size <n> MiB (4 to 16384, default: 300). In
|
|
addition, unused mempool memory is shared for this cache (see
|
|
\fB\-maxmempool\fR).
|
|
.HP
|
|
\fB\-debuglogfile=\fR<file>
|
|
.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)
|
|
.HP
|
|
\fB\-includeconf=\fR<file>
|
|
.IP
|
|
Specify additional configuration file, relative to the \fB\-datadir\fR path
|
|
(only useable from configuration file, not command line)
|
|
.HP
|
|
\fB\-loadblock=\fR<file>
|
|
.IP
|
|
Imports blocks from external file on startup
|
|
.HP
|
|
\fB\-maxmempool=\fR<n>
|
|
.IP
|
|
Keep the transaction memory pool below <n> megabytes (default: 300)
|
|
.HP
|
|
\fB\-maxorphantxsize=\fR<n>
|
|
.IP
|
|
Maximum total size of all orphan transactions in megabytes (default: 10)
|
|
.HP
|
|
\fB\-maxrecsigsage=\fR<n>
|
|
.IP
|
|
Number of seconds to keep LLMQ recovery sigs (default: 604800)
|
|
.HP
|
|
\fB\-mempoolexpiry=\fR<n>
|
|
.IP
|
|
Do not keep transactions in the mempool longer than <n> hours (default:
|
|
336)
|
|
.HP
|
|
\fB\-par=\fR<n>
|
|
.IP
|
|
Set the number of script verification threads (\fB\-16\fR to 15, 0 = auto, <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\-pid=\fR<file>
|
|
.IP
|
|
Specify pid file. Relative paths will be prefixed by a net\-specific
|
|
datadir location. (default: dashd.pid)
|
|
.HP
|
|
\fB\-prune=\fR<n>
|
|
.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
|
|
blocks if a target size in MiB is provided. This mode is
|
|
incompatible with \fB\-txindex\fR, \fB\-rescan\fR and \fB\-disablegovernance\fR=\fI\,false\/\fR.
|
|
Warning: Reverting this setting requires re\-downloading the
|
|
entire blockchain. (default: 0 = disable pruning blocks, 1 =
|
|
allow manual pruning via RPC, >945 = automatically prune block
|
|
files to stay under the specified target size in MiB)
|
|
.HP
|
|
\fB\-settings=\fR<file>
|
|
.IP
|
|
Specify path to dynamic settings data file. Can be disabled with
|
|
\fB\-nosettings\fR. File is written at runtime and not meant to be
|
|
edited by users (use dash.conf instead for custom settings).
|
|
Relative paths will be prefixed by datadir location. (default:
|
|
settings.json)
|
|
.HP
|
|
\fB\-startupnotify=\fR<cmd>
|
|
.IP
|
|
Execute command on startup.
|
|
.HP
|
|
\fB\-syncmempool\fR
|
|
.IP
|
|
Sync mempool from other nodes on start (default: 1)
|
|
.HP
|
|
\fB\-sysperms\fR
|
|
.IP
|
|
Create new files with system default permissions, instead of umask 077
|
|
(only effective with disabled wallet functionality)
|
|
.HP
|
|
\fB\-version\fR
|
|
.IP
|
|
Print version and exit
|
|
.PP
|
|
Connection options:
|
|
.HP
|
|
\fB\-addnode=\fR<ip>
|
|
.IP
|
|
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 \fB\-maxconnections\fR
|
|
limit.
|
|
.HP
|
|
\fB\-allowprivatenet\fR
|
|
.IP
|
|
Allow RFC1918 addresses to be relayed and connected to (default: 0)
|
|
.HP
|
|
\fB\-asmap=\fR<file>
|
|
.IP
|
|
Specify asn mapping used for bucketing of the peers (default:
|
|
ip_asn.map). Relative paths will be prefixed by the net\-specific
|
|
datadir location.
|
|
.HP
|
|
\fB\-bantime=\fR<n>
|
|
.IP
|
|
Default duration (in seconds) of manually configured bans (default:
|
|
86400)
|
|
.HP
|
|
\fB\-bind=\fR<addr>[:<port>][=onion]
|
|
.IP
|
|
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:9996=onion, testnet: 127.0.0.1:19996=onion,
|
|
regtest: 127.0.0.1:19896=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>
|
|
.IP
|
|
Connect only to the specified node; \fB\-noconnect\fR disables automatic
|
|
connections (the rules for this peer are the same as for
|
|
\fB\-addnode\fR). This option can be specified multiple times to connect
|
|
to multiple nodes.
|
|
.HP
|
|
\fB\-discover\fR
|
|
.IP
|
|
Discover own IP addresses (default: 1 when listening and no \fB\-externalip\fR
|
|
or \fB\-proxy\fR)
|
|
.HP
|
|
\fB\-dns\fR
|
|
.IP
|
|
Allow DNS lookups for \fB\-addnode\fR, \fB\-seednode\fR and \fB\-connect\fR (default: 1)
|
|
.HP
|
|
\fB\-dnsseed\fR
|
|
.IP
|
|
Query for peer addresses via DNS lookup, if low on addresses (default: 1
|
|
unless \fB\-connect\fR used)
|
|
.HP
|
|
\fB\-externalip=\fR<ip>
|
|
.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:port>
|
|
.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)
|
|
.HP
|
|
\fB\-listenonion\fR
|
|
.IP
|
|
Automatically create Tor onion service (default: 1)
|
|
.HP
|
|
\fB\-maxconnections=\fR<n>
|
|
.IP
|
|
Maintain at most <n> connections to peers (temporary service connections
|
|
excluded) (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<n>
|
|
.IP
|
|
Maximum per\-connection receive buffer, <n>*1000 bytes (default: 5000)
|
|
.HP
|
|
\fB\-maxsendbuffer=\fR<n>
|
|
.IP
|
|
Maximum per\-connection memory usage for the send buffer, <n>*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)
|
|
.HP
|
|
\fB\-maxuploadtarget=\fR<n>
|
|
.IP
|
|
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\-natpmp\fR
|
|
.IP
|
|
Use NAT\-PMP to map the listening port (default: 0)
|
|
.HP
|
|
\fB\-networkactive\fR
|
|
.IP
|
|
Enable all P2P network activity (default: 1). Can be changed by the
|
|
setnetworkactive RPC command
|
|
.HP
|
|
\fB\-onion=\fR<ip:port>
|
|
.IP
|
|
Use separate SOCKS5 proxy to reach peers via Tor onion services, set
|
|
\fB\-noonion\fR to disable (default: \fB\-proxy\fR)
|
|
.HP
|
|
\fB\-onlynet=\fR<net>
|
|
.IP
|
|
Make automatic outbound connections only to network <net> (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
|
|
Serve compact block filters to peers per BIP 157 (default: 0)
|
|
.HP
|
|
\fB\-peerbloomfilters\fR
|
|
.IP
|
|
Support filtering of blocks and transaction with bloom filters (default:
|
|
1)
|
|
.HP
|
|
\fB\-peertimeout=\fR<n>
|
|
.IP
|
|
Specify a p2p connection timeout delay in seconds. After connecting to a
|
|
peer, wait this amount of time before considering disconnection
|
|
based on inactivity (minimum: 1, default: 60)
|
|
.HP
|
|
\fB\-permitbaremultisig\fR
|
|
.IP
|
|
Relay non\-P2SH multisig (default: 1)
|
|
.HP
|
|
\fB\-port=\fR<port>
|
|
.IP
|
|
Listen for connections on <port>. Nodes not using the default ports
|
|
(default: 9999, testnet: 19999, regtest: 19899) are unlikely to
|
|
get incoming connections. Not relevant for I2P (see doc/i2p.md).
|
|
.HP
|
|
\fB\-proxy=\fR<ip:port>
|
|
.IP
|
|
Connect through SOCKS5 proxy, set \fB\-noproxy\fR to disable (default:
|
|
disabled)
|
|
.HP
|
|
\fB\-proxyrandomize\fR
|
|
.IP
|
|
Randomize credentials for every proxy connection. This enables Tor
|
|
stream isolation (default: 1)
|
|
.HP
|
|
\fB\-seednode=\fR<ip>
|
|
.IP
|
|
Connect to a node to retrieve peer addresses, and disconnect. This
|
|
option can be specified multiple times to connect to multiple
|
|
nodes.
|
|
.HP
|
|
\fB\-socketevents=\fR<mode>
|
|
.IP
|
|
Socket events mode, which must be one of 'select', 'poll', 'epoll' or
|
|
\&'kqueue', depending on your system (default: Linux \- 'epoll',
|
|
FreeBSD/Apple \- 'kqueue', Windows \- 'select')
|
|
.HP
|
|
\fB\-timeout=\fR<n>
|
|
.IP
|
|
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>:<port>
|
|
.IP
|
|
Tor control port to use if onion listening enabled (default:
|
|
127.0.0.1:9051)
|
|
.HP
|
|
\fB\-torpassword=\fR<pass>
|
|
.IP
|
|
Tor control port password (default: empty)
|
|
.HP
|
|
\fB\-upnp\fR
|
|
.IP
|
|
Use UPnP to map the listening port (default: 1 when listening and no
|
|
\fB\-proxy\fR)
|
|
.HP
|
|
\fB\-v2transport\fR
|
|
.IP
|
|
Support v2 transport (default: 0)
|
|
.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
|
|
download), forcerelay (relay transactions that are already in the
|
|
mempool; implies relay), relay (relay even in \fB\-blocksonly\fR mode),
|
|
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.
|
|
.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
|
|
times.
|
|
.PP
|
|
Indexing options:
|
|
.HP
|
|
\fB\-addressindex\fR
|
|
.IP
|
|
Maintain a full address index, used to query for the balance, txids and
|
|
unspent outputs for addresses (default: 0)
|
|
.HP
|
|
\fB\-reindex\fR
|
|
.IP
|
|
Rebuild chain state and block index from the blk*.dat files on disk.
|
|
This will also rebuild active optional indexes.
|
|
.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. Deactivate all optional indexes before running this.
|
|
.HP
|
|
\fB\-spentindex\fR
|
|
.IP
|
|
Maintain a full spent index, used to query the spending txid and input
|
|
index for an outpoint (default: 0)
|
|
.HP
|
|
\fB\-timestampindex\fR
|
|
.IP
|
|
Maintain a timestamp index for block hashes, used to query blocks hashes
|
|
by a range of timestamps (default: 0)
|
|
.HP
|
|
\fB\-txindex\fR
|
|
.IP
|
|
Maintain a full transaction index, used by the getrawtransaction rpc
|
|
call (default: 1)
|
|
.PP
|
|
Masternode options:
|
|
.HP
|
|
\fB\-deprecated\-platform\-user=\fR<user>
|
|
.IP
|
|
Set the username for the "platform user", a restricted user intended to
|
|
be used by Dash Platform, to the specified username.
|
|
.HP
|
|
\fB\-llmq\-data\-recovery=\fR<n>
|
|
.IP
|
|
Enable automated quorum data recovery (default: 1)
|
|
.HP
|
|
\fB\-llmq\-qvvec\-sync=\fR<quorum_name>:<mode>
|
|
.IP
|
|
Defines from which LLMQ type the masternode should sync quorum
|
|
verification vectors. Can be used multiple times with different
|
|
LLMQ types. <mode>: 0 (sync always from all quorums of the type
|
|
defined by <quorum_name>), 1 (sync from all quorums of the type
|
|
defined by <quorum_name> if a member of any of the quorums)
|
|
.HP
|
|
\fB\-masternodeblsprivkey=\fR<hex>
|
|
.IP
|
|
Set the masternode BLS private key and enable the client to act as a
|
|
masternode
|
|
.PP
|
|
Statsd options:
|
|
.HP
|
|
\fB\-statsbatchsize=\fR<bytes>
|
|
.IP
|
|
Specify the size of each batch of stats messages (default: 1024)
|
|
.HP
|
|
\fB\-statsduration=\fR<ms>
|
|
.IP
|
|
Specify the number of milliseconds between stats messages (default:
|
|
1000)
|
|
.HP
|
|
\fB\-statshost=\fR<ip>
|
|
.IP
|
|
Specify statsd host (default: )
|
|
.HP
|
|
\fB\-statsperiod=\fR<seconds>
|
|
.IP
|
|
Specify the number of seconds between periodic measurements (default:
|
|
60)
|
|
.HP
|
|
\fB\-statsport=\fR<port>
|
|
.IP
|
|
Specify statsd port (default: 8125)
|
|
.HP
|
|
\fB\-statsprefix=\fR<string>
|
|
.IP
|
|
Specify an optional string prepended to every stats key (default: )
|
|
.HP
|
|
\fB\-statssuffix=\fR<string>
|
|
.IP
|
|
Specify an optional string appended to every stats key (default: )
|
|
.PP
|
|
Wallet options:
|
|
.HP
|
|
\fB\-avoidpartialspends\fR
|
|
.IP
|
|
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\-createwalletbackups=\fR<n>
|
|
.IP
|
|
Number of automatic wallet backups (default: 10)
|
|
.HP
|
|
\fB\-disablewallet\fR
|
|
.IP
|
|
Do not load the wallet and disable wallet RPC calls
|
|
.HP
|
|
\fB\-instantsendnotify=\fR<cmd>
|
|
.IP
|
|
Execute command when a wallet InstantSend transaction is successfully
|
|
locked. %s in cmd is replaced by TxID and %w is replaced by
|
|
wallet name. %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\-keypool=\fR<n>
|
|
.IP
|
|
Set key pool size to <n> (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.
|
|
.HP
|
|
\fB\-maxapsfee=\fR<n>
|
|
.IP
|
|
Spend up to this amount in additional (absolute) fees (in DASH) if it
|
|
allows the use of partial spend avoidance (default: 0.00)
|
|
.HP
|
|
\fB\-rescan=\fR<mode>
|
|
.IP
|
|
Rescan the block chain for missing wallet transactions on startup (1 =
|
|
start from wallet creation time, 2 = start from genesis block)
|
|
.HP
|
|
\fB\-spendzeroconfchange\fR
|
|
.IP
|
|
Spend unconfirmed change when sending transactions (default: 1)
|
|
.HP
|
|
\fB\-wallet=\fR<path>
|
|
.IP
|
|
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 <walletdir>. 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
|
|
<walletdir>.
|
|
.HP
|
|
\fB\-walletbackupsdir=\fR<dir>
|
|
.IP
|
|
Specify full path to directory for automatic wallet backups (must exist)
|
|
.HP
|
|
\fB\-walletbroadcast\fR
|
|
.IP
|
|
Make the wallet broadcast transactions (default: 1)
|
|
.HP
|
|
\fB\-walletdir=\fR<dir>
|
|
.IP
|
|
Specify directory to hold wallets (default: <datadir>/wallets if it
|
|
exists, otherwise <datadir>)
|
|
.HP
|
|
\fB\-walletnotify=\fR<cmd>
|
|
.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.
|
|
.PP
|
|
Wallet fee options:
|
|
.HP
|
|
\fB\-discardfee=\fR<amt>
|
|
.IP
|
|
The fee rate (in DASH/kB) 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
|
|
.HP
|
|
\fB\-fallbackfee=\fR<amt>
|
|
.IP
|
|
A fee rate (in DASH/kB) that will be used when fee estimation has
|
|
insufficient data. 0 to entirely disable the fallbackfee feature.
|
|
(default: 0.00001)
|
|
.HP
|
|
\fB\-mintxfee=\fR<amt>
|
|
.IP
|
|
Fee rates (in DASH/kB) smaller than this are considered zero fee for
|
|
transaction creation (default: 0.00001)
|
|
.HP
|
|
\fB\-paytxfee=\fR<amt>
|
|
.IP
|
|
Fee rate (in DASH/kB) to add to transactions you send (default: 0.00)
|
|
.HP
|
|
\fB\-txconfirmtarget=\fR<n>
|
|
.IP
|
|
If paytxfee is not set, include enough fee so transactions begin
|
|
confirmation on average within n blocks (default: 6)
|
|
.PP
|
|
HD wallet options:
|
|
.HP
|
|
\fB\-hdseed=\fR<hex>
|
|
.IP
|
|
User defined seed for HD wallet (should be in hex). Only has effect
|
|
during wallet creation/first start (default: randomly generated)
|
|
.HP
|
|
\fB\-mnemonic=\fR<text>
|
|
.IP
|
|
User defined mnemonic for HD wallet (bip39). Only has effect during
|
|
wallet creation/first start (default: randomly generated)
|
|
.HP
|
|
\fB\-mnemonicbits=\fR<n>
|
|
.IP
|
|
User defined mnemonic security for HD wallet in bits (BIP39). Only has
|
|
effect during wallet creation/first start (allowed values: 128,
|
|
160, 192, 224, 256; default: 128)
|
|
.HP
|
|
\fB\-mnemonicpassphrase=\fR<text>
|
|
.IP
|
|
User defined mnemonic passphrase for HD wallet (BIP39). Only has effect
|
|
during wallet creation/first start (default: empty string)
|
|
.HP
|
|
\fB\-usehd\fR
|
|
.IP
|
|
Use hierarchical deterministic key generation (HD) after BIP39/BIP44.
|
|
Only has effect during wallet creation/first start (default: 1)
|
|
.PP
|
|
CoinJoin options:
|
|
.HP
|
|
\fB\-coinjoinamount=\fR<n>
|
|
.IP
|
|
Target CoinJoin balance (2\-21000000, default: 1000)
|
|
.HP
|
|
\fB\-coinjoinautostart\fR
|
|
.IP
|
|
Start CoinJoin automatically (0\-1, default: 0)
|
|
.HP
|
|
\fB\-coinjoindenomsgoal=\fR<n>
|
|
.IP
|
|
Try to create at least N inputs of each denominated amount (10\-100000,
|
|
default: 50)
|
|
.HP
|
|
\fB\-coinjoindenomshardcap=\fR<n>
|
|
.IP
|
|
Create up to N inputs of each denominated amount (10\-100000, default:
|
|
300)
|
|
.HP
|
|
\fB\-coinjoinmultisession\fR
|
|
.IP
|
|
Enable multiple CoinJoin mixing sessions per block, experimental (0\-1,
|
|
default: 0)
|
|
.HP
|
|
\fB\-coinjoinrounds=\fR<n>
|
|
.IP
|
|
Use N separate masternodes for each denominated input to mix funds
|
|
(2\-16, default: 4)
|
|
.HP
|
|
\fB\-coinjoinsessions=\fR<n>
|
|
.IP
|
|
Use N separate masternodes in parallel to mix funds (1\-10, default: 4)
|
|
.HP
|
|
\fB\-enablecoinjoin\fR
|
|
.IP
|
|
Enable use of CoinJoin for funds stored in this wallet (0\-1, default: 0)
|
|
.PP
|
|
ZeroMQ notification options:
|
|
.HP
|
|
\fB\-zmqpubhashblock=\fR<address>
|
|
.IP
|
|
Enable publish hash block in <address>
|
|
.HP
|
|
\fB\-zmqpubhashblockhwm=\fR<n>
|
|
.IP
|
|
Set publish hash block outbound message high water mark (default: 1000)
|
|
.HP
|
|
\fB\-zmqpubhashchainlock=\fR<address>
|
|
.IP
|
|
Enable publish hash block (locked via ChainLocks) in <address>
|
|
.HP
|
|
\fB\-zmqpubhashchainlockhwm=\fR<n>
|
|
.IP
|
|
Set publish hash chain lock outbound message high water mark (default:
|
|
1000)
|
|
.HP
|
|
\fB\-zmqpubhashgovernanceobject=\fR<address>
|
|
.IP
|
|
Enable publish hash of governance objects (like proposals) in <address>
|
|
.HP
|
|
\fB\-zmqpubhashgovernanceobjecthwm=\fR<n>
|
|
.IP
|
|
Set publish hash governance object outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubhashgovernancevote=\fR<address>
|
|
.IP
|
|
Enable publish hash of governance votes in <address>
|
|
.HP
|
|
\fB\-zmqpubhashgovernancevotehwm=\fR<n>
|
|
.IP
|
|
Set publish hash governance vote outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubhashinstantsenddoublespend=\fR<address>
|
|
.IP
|
|
Enable publish transaction hashes of attempted InstantSend double spend
|
|
in <address>
|
|
.HP
|
|
\fB\-zmqpubhashinstantsenddoublespendhwm=\fR<n>
|
|
.IP
|
|
Set publish hash InstantSend double spend outbound message high water
|
|
mark (default: 1000)
|
|
.HP
|
|
\fB\-zmqpubhashrecoveredsig=\fR<address>
|
|
.IP
|
|
Enable publish message hash of recovered signatures (recovered by LLMQs)
|
|
in <address>
|
|
.HP
|
|
\fB\-zmqpubhashrecoveredsighwm=\fR<n>
|
|
.IP
|
|
Set publish hash recovered signature outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubhashtx=\fR<address>
|
|
.IP
|
|
Enable publish hash transaction in <address>
|
|
.HP
|
|
\fB\-zmqpubhashtxhwm=\fR<n>
|
|
.IP
|
|
Set publish hash transaction outbound message high water mark (default:
|
|
1000)
|
|
.HP
|
|
\fB\-zmqpubhashtxlock=\fR<address>
|
|
.IP
|
|
Enable publish hash transaction (locked via InstantSend) in <address>
|
|
.HP
|
|
\fB\-zmqpubhashtxlockhwm=\fR<n>
|
|
.IP
|
|
Set publish hash transaction lock outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawblock=\fR<address>
|
|
.IP
|
|
Enable publish raw block in <address>
|
|
.HP
|
|
\fB\-zmqpubrawblockhwm=\fR<n>
|
|
.IP
|
|
Set publish raw block outbound message high water mark (default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawchainlock=\fR<address>
|
|
.IP
|
|
Enable publish raw block (locked via ChainLocks) in <address>
|
|
.HP
|
|
\fB\-zmqpubrawchainlockhwm=\fR<n>
|
|
.IP
|
|
Set publish raw chain lock outbound message high water mark (default:
|
|
1000)
|
|
.HP
|
|
\fB\-zmqpubrawchainlocksig=\fR<address>
|
|
.IP
|
|
Enable publish raw block (locked via ChainLocks) and CLSIG message in
|
|
<address>
|
|
.HP
|
|
\fB\-zmqpubrawchainlocksighwm=\fR<n>
|
|
.IP
|
|
Set publish raw chain lock signature outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawgovernanceobject=\fR<address>
|
|
.IP
|
|
Enable publish raw governance votes in <address>
|
|
.HP
|
|
\fB\-zmqpubrawgovernanceobjecthwm=\fR<n>
|
|
.IP
|
|
Set publish raw governance object outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawgovernancevote=\fR<address>
|
|
.IP
|
|
Enable publish raw governance objects (like proposals) in <address>
|
|
.HP
|
|
\fB\-zmqpubrawgovernancevotehwm=\fR<n>
|
|
.IP
|
|
Set publish raw governance vote outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawinstantsenddoublespend=\fR<address>
|
|
.IP
|
|
Enable publish raw transactions of attempted InstantSend double spend in
|
|
<address>
|
|
.HP
|
|
\fB\-zmqpubrawinstantsenddoublespendhwm=\fR<n>
|
|
.IP
|
|
Set publish raw InstantSend double spend outbound message high water
|
|
mark (default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawrecoveredsig=\fR<address>
|
|
.IP
|
|
Enable publish raw recovered signatures (recovered by LLMQs) in
|
|
<address>
|
|
.HP
|
|
\fB\-zmqpubrawrecoveredsighwm=\fR<n>
|
|
.IP
|
|
Set publish raw recovered signature outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawtx=\fR<address>
|
|
.IP
|
|
Enable publish raw transaction in <address>
|
|
.HP
|
|
\fB\-zmqpubrawtxhwm=\fR<n>
|
|
.IP
|
|
Set publish raw transaction outbound message high water mark (default:
|
|
1000)
|
|
.HP
|
|
\fB\-zmqpubrawtxlock=\fR<address>
|
|
.IP
|
|
Enable publish raw transaction (locked via InstantSend) in <address>
|
|
.HP
|
|
\fB\-zmqpubrawtxlockhwm=\fR<n>
|
|
.IP
|
|
Set publish raw transaction lock outbound message high water mark
|
|
(default: 1000)
|
|
.HP
|
|
\fB\-zmqpubrawtxlocksig=\fR<address>
|
|
.IP
|
|
Enable publish raw transaction (locked via InstantSend) and ISLOCK in
|
|
<address>
|
|
.HP
|
|
\fB\-zmqpubrawtxlocksighwm=\fR<n>
|
|
.IP
|
|
Set publish raw transaction lock signature outbound message high water
|
|
mark (default: 1000)
|
|
.HP
|
|
\fB\-zmqpubsequence=\fR<address>
|
|
.IP
|
|
Enable publish hash block and tx sequence in <address>
|
|
.HP
|
|
\fB\-zmqpubsequencehwm=\fR<n>
|
|
.IP
|
|
Set publish hash sequence message high water mark (default: 1000)
|
|
.PP
|
|
Debugging/Testing options:
|
|
.HP
|
|
\fB\-debug=\fR<category>
|
|
.IP
|
|
Output debugging information (default: \fB\-nodebug\fR, supplying <category> is
|
|
optional). If <category> is not supplied or if <category> = 1,
|
|
output all debugging information. <category> can be: addrman,
|
|
bench, chainlocks, cmpctblock, coindb, coinjoin, creditpool, ehf,
|
|
estimatefee, gobject, http, i2p, instantsend, ipc, leveldb,
|
|
libevent, llmq, llmq\-dkg, llmq\-sigs, lock, mempool, mempoolrej,
|
|
mnpayments, mnsync, net, netconn, proxy, prune, qt, rand,
|
|
reindex, rpc, selectcoins, spork, tor, txreconciliation,
|
|
validation, walletdb, zmq. This option can be specified multiple
|
|
times to output multiple categories.
|
|
.HP
|
|
\fB\-debugexclude=\fR<category>
|
|
.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 the
|
|
specified category. This option can be specified multiple times
|
|
to exclude multiple categories.
|
|
.HP
|
|
\fB\-disablegovernance\fR
|
|
.IP
|
|
Disable governance validation (0\-1, default: 0)
|
|
.HP
|
|
\fB\-help\-debug\fR
|
|
.IP
|
|
Print help message with debugging options and exit
|
|
.HP
|
|
\fB\-logips\fR
|
|
.IP
|
|
Include IP addresses in debug output (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\-logtimestamps\fR
|
|
.IP
|
|
Prepend debug output with timestamp (default: 1)
|
|
.HP
|
|
\fB\-maxtxfee=\fR<amt>
|
|
.IP
|
|
Maximum total fees (in DASH) to use in a single wallet transaction;
|
|
setting this too low may abort large transactions (default: 0.10)
|
|
.HP
|
|
\fB\-minsporkkeys=\fR<n>
|
|
.IP
|
|
Overrides minimum spork signers to change spork value. Only useful for
|
|
regtest and devnet. Using this on mainnet or testnet will ban
|
|
you.
|
|
.HP
|
|
\fB\-printtoconsole\fR
|
|
.IP
|
|
Send trace/debug info to console (default: 1 when no \fB\-daemon\fR. To disable
|
|
logging to file, set \fB\-nodebuglogfile\fR)
|
|
.HP
|
|
\fB\-pushversion\fR
|
|
.IP
|
|
Protocol version to report to other nodes
|
|
.HP
|
|
\fB\-shrinkdebugfile\fR
|
|
.IP
|
|
Shrink debug.log file on client startup (default: 1 when no \fB\-debug\fR)
|
|
.HP
|
|
\fB\-sporkaddr=\fR<dashaddress>
|
|
.IP
|
|
Override spork address. Only useful for regtest and devnet. Using this
|
|
on mainnet or testnet will ban you.
|
|
.HP
|
|
\fB\-sporkkey=\fR<privatekey>
|
|
.IP
|
|
Set the private key to be used for signing spork messages.
|
|
.HP
|
|
\fB\-uacomment=\fR<cmt>
|
|
.IP
|
|
Append comment to the user agent string
|
|
.PP
|
|
Chain selection options:
|
|
.HP
|
|
\fB\-chain=\fR<chain>
|
|
.IP
|
|
Use the chain <chain> (default: main). Allowed values: main, test,
|
|
regtest
|
|
.HP
|
|
\fB\-devnet=\fR<name>
|
|
.IP
|
|
Use devnet chain with provided name
|
|
.HP
|
|
\fB\-highsubsidyblocks=\fR<n>
|
|
.IP
|
|
The number of blocks with a higher than normal subsidy to mine at the
|
|
start of a chain. Block after that height will have fixed subsidy
|
|
base. (default: 0, devnet\-only)
|
|
.HP
|
|
\fB\-highsubsidyfactor=\fR<n>
|
|
.IP
|
|
The factor to multiply the normal block subsidy by while in the
|
|
highsubsidyblocks window of a chain (default: 1, devnet\-only)
|
|
.HP
|
|
\fB\-llmqchainlocks=\fR<quorum name>
|
|
.IP
|
|
Override the default LLMQ type used for ChainLocks. Allows using
|
|
ChainLocks with smaller LLMQs. (default: llmq_devnet,
|
|
devnet\-only)
|
|
.HP
|
|
\fB\-llmqdevnetparams=\fR<size>:<threshold>
|
|
.IP
|
|
Override the default LLMQ size for the LLMQ_DEVNET quorum (devnet\-only)
|
|
.HP
|
|
\fB\-llmqinstantsenddip0024=\fR<quorum name>
|
|
.IP
|
|
Override the default LLMQ type used for InstantSendDIP0024. (default:
|
|
llmq_devnet_dip0024, devnet\-only)
|
|
.HP
|
|
\fB\-llmqmnhf=\fR<quorum name>
|
|
.IP
|
|
Override the default LLMQ type used for EHF. (default: llmq_devnet,
|
|
devnet\-only)
|
|
.HP
|
|
\fB\-llmqplatform=\fR<quorum name>
|
|
.IP
|
|
Override the default LLMQ type used for Platform. (default:
|
|
llmq_devnet_platform, devnet\-only)
|
|
.HP
|
|
\fB\-minimumdifficultyblocks=\fR<n>
|
|
.IP
|
|
The number of blocks that can be mined with the minimum difficulty at
|
|
the start of a chain (default: 0, devnet\-only)
|
|
.HP
|
|
\fB\-powtargetspacing=\fR<n>
|
|
.IP
|
|
Override the default PowTargetSpacing value in seconds (default: 2.5
|
|
minutes, devnet\-only)
|
|
.HP
|
|
\fB\-testnet\fR
|
|
.IP
|
|
Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR
|
|
.PP
|
|
Node relay options:
|
|
.HP
|
|
\fB\-bytespersigop\fR
|
|
.IP
|
|
Equivalent bytes per sigop in transactions for relay and mining
|
|
(default: 20)
|
|
.HP
|
|
\fB\-datacarrier\fR
|
|
.IP
|
|
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)
|
|
.HP
|
|
\fB\-minrelaytxfee=\fR<amt>
|
|
.IP
|
|
Fees (in DASH/kB) smaller than this are considered zero fee for
|
|
relaying, mining and transaction creation (default: 0.00001)
|
|
.HP
|
|
\fB\-whitelistforcerelay\fR
|
|
.IP
|
|
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)
|
|
.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)
|
|
.PP
|
|
Block creation options:
|
|
.HP
|
|
\fB\-blockmaxsize=\fR<n>
|
|
.IP
|
|
Set maximum block size in bytes (default: 2000000)
|
|
.HP
|
|
\fB\-blockmintxfee=\fR<amt>
|
|
.IP
|
|
Set lowest fee rate (in DASH/kB) for transactions to be included in
|
|
block creation. (default: 0.00001)
|
|
.PP
|
|
RPC server options:
|
|
.HP
|
|
\fB\-rest\fR
|
|
.IP
|
|
Accept public REST requests (default: 0)
|
|
.HP
|
|
\fB\-rpcallowip=\fR<ip>
|
|
.IP
|
|
Allow JSON\-RPC connections from specified source. Valid for <ip> are a
|
|
single IP (e.g. 1.2.3.4), a network/netmask (e.g.
|
|
1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). This
|
|
option can be specified multiple times
|
|
.HP
|
|
\fB\-rpcauth=\fR<userpw>
|
|
.IP
|
|
Username and HMAC\-SHA\-256 hashed password for JSON\-RPC connections. The
|
|
field <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. A
|
|
canonical python script is included in share/rpcuser. The client
|
|
then connects normally using the
|
|
rpcuser=<USERNAME>/rpcpassword=<PASSWORD> pair of arguments. This
|
|
option can be specified multiple times
|
|
.HP
|
|
\fB\-rpcbind=\fR<addr>[:port]
|
|
.IP
|
|
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 \fB\-rpcallowip\fR is also passed. Port is
|
|
optional and overrides \fB\-rpcport\fR. Use [host]:port notation for
|
|
IPv6. This option can be specified multiple times (default:
|
|
127.0.0.1 and ::1 i.e., localhost, or if \fB\-rpcallowip\fR has been
|
|
specified, 0.0.0.0 and :: i.e., all addresses)
|
|
.HP
|
|
\fB\-rpccookiefile=\fR<loc>
|
|
.IP
|
|
Location of the auth cookie. Relative paths will be prefixed by a
|
|
net\-specific datadir location. (default: data dir)
|
|
.HP
|
|
\fB\-rpcexternaluser=\fR<users>
|
|
.IP
|
|
List of comma\-separated usernames for JSON\-RPC external connections
|
|
.HP
|
|
\fB\-rpcpassword=\fR<pw>
|
|
.IP
|
|
Password for JSON\-RPC connections
|
|
.HP
|
|
\fB\-rpcport=\fR<port>
|
|
.IP
|
|
Listen for JSON\-RPC connections on <port> (default: 9998, testnet:
|
|
19998, regtest: 19898)
|
|
.HP
|
|
\fB\-rpcthreads=\fR<n>
|
|
.IP
|
|
Set the number of threads to service RPC calls (default: 4)
|
|
.HP
|
|
\fB\-rpcuser=\fR<user>
|
|
.IP
|
|
Username for JSON\-RPC connections
|
|
.HP
|
|
\fB\-rpcwhitelist=\fR<whitelist>
|
|
.IP
|
|
Set a whitelist to filter incoming RPC calls for a specific user. The
|
|
field <whitelist> comes in the format: <USERNAME>:<rpc 1>,<rpc
|
|
2>,...,<rpc n>. If multiple whitelists are set for a given user,
|
|
they are set\-intersected. See \fB\-rpcwhitelistdefault\fR documentation
|
|
for information on default whitelist behavior.
|
|
.HP
|
|
\fB\-rpcwhitelistdefault\fR
|
|
.IP
|
|
Sets default behavior for rpc whitelisting. Unless rpcwhitelistdefault
|
|
is set to 0, if any \fB\-rpcwhitelist\fR 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
|
|
\fB\-rpcwhitelist\fR is set, rpc server acts as if all rpc users are
|
|
subject to empty whitelists.
|
|
.HP
|
|
\fB\-server\fR
|
|
.IP
|
|
Accept command line and JSON\-RPC commands
|