nyanrainbowcoinnyancoin

Nyancoin Command Line Options

Applicable to Nyancoin Core version v2.0
Note that some options listed here may relate to features not enabled or planned for a future version.

Use Examples

These can be used on the command line when starting the application, or added to the nyancoin.conf file where that usage makes sense.

Command line

nyancoin-qt -maxconnections=25 -txindex

nyancoin.conf

maxconnections=25
txindex=1

General Options

-?

Print this help message and exit

-version

Print version and exit

-alerts

Receive and display P2P network alerts (default: 1)

-alertnotify=<cmd>

Execute command when a relevant alert is received or we see a really long fork (%s in cmd is replaced by message)

-blocknotify=<cmd>

Execute command when the best block changes (%s in cmd is replaced by block hash, %i is replaced by block number)

-assumevalid=<hex>

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: b477d9bc0721a1b96547495404583d68123f471fdd1d4058a9adff2fa7452298, testnet: 6943eaeaba98dc7d09f7e73398daccb4abcabb18b66c8c875e52b07638d93951).

-conf=<file>

Specify configuration file (default: nyancoin.conf)

-datadir=<dir>

Specify data directory

-dbcache=<n>

Set database cache size in megabytes (4 to 16384, default: 450)

-loadblock=<file>

Imports blocks from external blk000??.dat file on startup

-maxreorg=<n>

Set the Maximum reorg depth (default: 55)

-minreorgpeers=<n>

Set the Minimum amount of peers required to not allow reorgs. Peers must be greater than. (default: 3)

-maxorphantx=<n>

Keep at most <n> unconnectable transactions in memory (default: 100)

-maxmempool=<n>

Keep the transaction memory pool below <n> megabytes (default: 300)

-mempoolexpiry=<n>

Do not keep transactions in the mempool longer than <n> hours (default: 24)

-blockreconstructionextratxn=<n>

Extra transactions to keep in memory for compact block reconstructions (default: 100).

-par=<n>

Set the number of script verification threads (-16 to 16, 0 = auto, <0 = leave that many cores free, default: 0)

-prune=<n>

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 and -rescan.
Warning: Reverting this setting requires re-downloading the entire blockchain.
(default: 0 = disable pruning blocks, 1 = allow manual pruning via RPC, >2200 = automatically prune block files to stay under the specified target size in MiB)

-reindex-chainstate

Rebuild chain state from the currently indexed blocks

-reindex

Rebuild chain state and block index from the blk*.dat files on disk

-txindex

Maintain a full transaction index, used by the getrawtransaction rpc call (default: 0)

Connection options:

-addnode=<ip>

Add a node to connect to and attempt to keep the connection open

-banscore=<n>

Threshold for disconnecting misbehaving peers (default: 100)

-bantime=<n>

Number of seconds to keep misbehaving peers from reconnecting (default: 86400)

-bind=<addr>

Bind to given address and always listen on it. Use [host]:port notation for IPv6

-connect=<ip>

Connect only to the specified node(s); -noconnect or -connect=0 alone to disable automatic connections

-discover

Discover own IP addresses (default: 1 when listening and no -externalip or -proxy)

-dns

Allow DNS lookups for -addnode, -seednode and -connect (default: 1)

-dnsseed

Query for peer addresses via DNS lookup, if low on addresses (default: 1 unless -connect/-noconnect)

-externalip=<ip>

Specify your own public address

-forcednsseed

Always query for peer addresses via DNS lookup (default: 0)

-listen

Accept connections from outside (default: 1 if no -proxy or -connect/-noconnect)

-listenonion

Automatically create Tor hidden service (default: 1)

-maxconnections=<n>

Maintain at most <n> connections to peers (default: 125)

-maxreceivebuffer=<n>

Maximum per-connection receive buffer, <n>*1000 bytes (default: 5000)

-maxsendbuffer=<n>

Maximum per-connection send buffer, <n>*1000 bytes (default: 1000)

-maxtimeadjustment

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)

-onion=<ip:port>

Use separate SOCKS5 proxy to reach peers via Tor hidden services (default: -proxy)

-onlynet=<net>

Only connect to nodes in network <net> (ipv4, ipv6 or onion)

-permitbaremultisig

Relay non-P2SH multisig (default: 1)

-peerbloomfilters

Support filtering of blocks and transaction with bloom filters (default: 1)

-port=<port>

Listen for connections on <port> (default: 33701 or testnet: 19526)

-proxy=<ip:port>

Connect through SOCKS5 proxy

-proxyrandomize

Randomise credentials for every proxy connection. This enables Tor stream isolation (default: 1)

-rpcserialversion

Sets the serialisation of raw transaction or block hex returned in non-verbose mode, non-segwit(0) or segwit(1) (default: 1).

-seednode=<ip>

Connect to a node to retrieve peer addresses, and disconnect

-timeout=<n>

Specify connection timeout in milliseconds (minimum: 1, default: 5000)

-torcontrol=<ip>:<port>

Tor control port to use if onion listening enabled (default: 127.0.0.1:9051)

-torpassword=<pass>

Tor control port password (default: empty)

-upnp

Use UPnP to map the listening port (default: 0)

-whitebind=<addr>

Bind to given address and whitelist peers connecting to it. Use [host]:port notation for IPv6

-whitelist=<IP address or network>

Whitelist peers connecting from the given IP address (e.g. 1.2.3.4) or CIDR notated network (e.g. 1.2.3.0/24).
Can be specified multiple times.
Whitelisted peers cannot be DoS banned and their transactions are always relayed, even if they are already in the mempool, useful e.g. for a gateway

-whitelistrelay

Accept relayed transactions received from whitelisted peers even when not relaying transactions (default: 1)

-whitelistforcerelay

Force relay of transactions from whitelisted peers, even if they violate local relay policy (default: 1).

-maxuploadtarget=<n>

Tries to keep outbound traffic under the given target (in MiB per 24h), 0 = no limit (default: 0)

Wallet options:

-disablewallet

Do not load the wallet and disable wallet RPC calls

-keypool=<n>

Set key pool size to <n> (default: 100)

-fallbackfee=<amt>

A fee rate (in NYAN/kB) that will be used when fee estimation has insufficient data (default: 0.00000001)

-mintxfee=<amt>

Fees (in NYAN/kB) smaller than this are considered zero fee for transaction creation (default: 0.00000001)

-paytxfee=<amt>

Fee (in NYAN/kB) to add to transactions you send (default: 0.00)

-rescan

Rescan the block chain for missing wallet transactions on startup

-salvagewallet

Attempt to recover private keys from a corrupt wallet on startup

-spendzeroconfchange

Spend unconfirmed change when sending transactions (default: 1)

-txconfirmtarget=<n>

If paytxfee is not set, include enough fee so transactions begin confirmation on average within n blocks (default: 6)

-usehd

Use hierarchical deterministic key generation (HD) after BIP32. Only has effect during wallet creation/first start (default: 1)

-walletrbf

Send transactions with full-RBF opt-in enabled (default: 0)

-upgradewallet

Upgrade wallet to latest format on startup

-wallet=<file>

Specify wallet file (within data directory) (default: wallet.dat)

-walletbroadcast

Make the wallet broadcast transactions (default: 1)

-walletnotify=<cmd>

Execute command when a wallet transaction changes (%s in cmd is replaced by TxID)

-zapwallettxes=<mode>

Delete all wallet transactions and only recover those parts of the blockchain through -rescan on startup (1 = keep tx meta data e.g. account owner and payment request information, 2 = drop tx meta data)

ZeroMQ notification options:

-zmqpubhashblock=<address>

Enable publish hash block in <address>

-zmqpubhashtx=<address>

Enable publish hash transaction in <address>

-zmqpubrawblock=<address>

Enable publish raw block in <address>

-zmqpubrawtx=<address>

Enable publish raw transaction in <address>

Debugging/Testing options:

-uacomment=<cmt>

Append comment to the user agent string

-debug=<category>

Output debugging information (default: 0, supplying <category> is optional).
If <category> is not supplied or if <category> = 1, output all debugging information.
<category> can be: addrman, alert, bench, cmpctblock, coindb, db, http, libevent, lock, mempool, mempoolrej, net, proxy, prune, rand, reindex, rpc, selectcoins, tor, zmq, qt.

-help-debug

Show all debugging options (usage: --help -help-debug)

-logips

Include IP addresses in debug output (default: 0)

-logtimestamps

Prepend debug output with timestamp (default: 1)

-minrelaytxfee=<amt>

Fees (in NYAN/kB) smaller than this are considered zero fee for relaying, mining and transaction creation (default: 0.00000001)

-maxtxfee=<amt>

Maximum total fees (in NYAN) to use in a single wallet transaction or raw transaction; setting this too low may abort large transactions (default: 0.10)

-printtoconsole

Send trace/debug info to console instead of debug.log file

-shrinkdebugfile

Shrink debug.log file on client startup (default: 1 when no -debug)

Chain selection options:

-testnet

Use the test chain

Node relay options:

-bytespersigop

Equivalent bytes per sigop in transactions for relay and mining (default: 20)

-datacarrier

Relay and mine data carrier transactions (default: 1)

-datacarriersize

Maximum size of data in data carrier transactions we relay and mine (default: 83)

-mempoolreplacement

Enable transaction replacement in the memory pool (default: 1)

Block creation options:

-blockmaxweight=<n>

Set maximum BIP141 block weight (default: 3000000)

-blockmaxsize=<n>

Set maximum block size in bytes (default: 1000000)

-blockprioritysize=<n>

Set maximum size of high-priority/low-fee transactions in bytes (default: 27000)

-blockmintxfee=<amt>

Set lowest fee rate (in NYAN/kB) for transactions to be included in block creation (default: 0.00000001).

RPC server options:

-server

Accept command line and JSON-RPC commands

-rest

Accept public REST requests (default: 0)

-rpcbind=<addr>

Bind to given address to listen for JSON-RPC connections.
Use [host]:port notation for IPv6. This option can be specified multiple times (default: bind to all interfaces)

-rpccookiefile=<loc>

Location of the auth cookie (default: data dir)

-rpcuser=<user>

Username for JSON-RPC connections

-rpcpassword=<pw>

Password for JSON-RPC connections

-rpcauth=<userpw>

Username and hashed password for JSON-RPC connections.
The field <userpw> comes in the format: <USERNAME>:<SALT>#60;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.

-rpcport=<port>

Listen for JSON-RPC connections on <port> (default: 33700 or testnet: 44555)

-rpcallowip=<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

-rpcthreads=<n>

Set the number of threads to service RPC calls (default: 4)

UI Options:

-choosedatadir

Choose data directory on startup (default: 0)

-lang=<lang>

Set language, for example "de_DE" (default: system locale)

-min

Start minimised

-rootcertificates=<file>

Set SSL root certificates for payment request (default: -system-)

-splash

Show splash screen on startup (default: 1)

-resetguisettings

Reset all settings changed in the GUI

Updated 13 July 2022. Contact / impressum Sitemap:sitemap.xml.