mirror of
				https://github.com/ChristopherA/Learning-Bitcoin-from-the-Command-Line.git
				synced 2025-10-31 02:17:24 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			682 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			682 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| 
 | |
| ### WORK IN PROGRESS
 | |
| 
 | |
| Goal to capture all the bitcoin-cli help text in a single file, then later annotate with
 | |
| more links and such.
 | |
| 
 | |
| $ bitcoin-cli help
 | |
| == Blockchain ==
 | |
| getbestblockhash
 | |
| getblock "hash" ( verbose )
 | |
| getblockchaininfo
 | |
| getblockcount
 | |
| getblockhash index
 | |
| getblockheader "hash" ( verbose )
 | |
| getchaintips
 | |
| getdifficulty
 | |
| getmempoolancestors txid (verbose)
 | |
| getmempooldescendants txid (verbose)
 | |
| getmempoolentry txid
 | |
| getmempoolinfo
 | |
| getrawmempool ( verbose )
 | |
| gettxout "txid" n ( includemempool )
 | |
| gettxoutproof ["txid",...] ( blockhash )
 | |
| gettxoutsetinfo
 | |
| verifychain ( checklevel numblocks )
 | |
| verifytxoutproof "proof"
 | |
| 
 | |
| ## Control ##
 | |
| 
 | |
| ### getinfo ###
 | |
| getinfo
 | |
| 
 | |
| Returns an object containing various state info.
 | |
| 
 | |
| Result:
 | |
| ```
 | |
| {
 | |
|   "version": xxxxx,           (numeric) the server version
 | |
|   "protocolversion": xxxxx,   (numeric) the protocol version
 | |
|   "walletversion": xxxxx,     (numeric) the wallet version
 | |
|   "balance": xxxxxxx,         (numeric) the total bitcoin balance of the wallet
 | |
|   "blocks": xxxxxx,           (numeric) the current number of blocks processed in the server
 | |
|   "timeoffset": xxxxx,        (numeric) the time offset
 | |
|   "connections": xxxxx,       (numeric) the number of connections
 | |
|   "proxy": "host:port",     (string, optional) the proxy used by the server
 | |
|   "difficulty": xxxxxx,       (numeric) the current difficulty
 | |
|   "testnet": true|false,      (boolean) if the server is using testnet or not
 | |
|   "keypoololdest": xxxxxx,    (numeric) the timestamp (seconds since Unix epoch) of the oldest pre-generated key in the key pool
 | |
|   "keypoolsize": xxxx,        (numeric) how many new keys are pre-generated
 | |
|   "unlocked_until": ttt,      (numeric) the timestamp in seconds since epoch (midnight Jan 1 1970 GMT) that the wallet is unlocked for transfers, or 0 if the wallet is locked
 | |
|   "paytxfee": x.xxxx,         (numeric) the transaction fee set in BTC/kB
 | |
|   "relayfee": x.xxxx,         (numeric) minimum relay fee for non-free transactions in BTC/kB
 | |
|   "errors": "..."           (string) any error messages
 | |
| }
 | |
| ```
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli getinfo
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| help ( "command" )
 | |
| stop
 | |
| 
 | |
| == Generating ==
 | |
| generate numblocks ( maxtries )
 | |
| generatetoaddress numblocks address (maxtries)
 | |
| 
 | |
| == Mining ==
 | |
| getblocktemplate ( TemplateRequest )
 | |
| getmininginfo
 | |
| getnetworkhashps ( blocks height )
 | |
| prioritisetransaction <txid> <priority delta> <fee delta>
 | |
| submitblock "hexdata" ( "jsonparametersobject" )
 | |
| 
 | |
| == Network ==
 | |
| addnode "node" "add|remove|onetry"
 | |
| clearbanned
 | |
| disconnectnode "node"
 | |
| getaddednodeinfo dummy ( "node" )
 | |
| getconnectioncount
 | |
| getnettotals
 | |
| getnetworkinfo
 | |
| getpeerinfo
 | |
| listbanned
 | |
| ping
 | |
| setban "ip(/netmask)" "add|remove" (bantime) (absolute)
 | |
| 
 | |
| == Rawtransactions ==
 | |
| createrawtransaction [{"txid":"id","vout":n},...] {"address":amount,"data":"hex",...} ( locktime )
 | |
| decoderawtransaction "hexstring"
 | |
| decodescript "hex"
 | |
| fundrawtransaction "hexstring" ( options )
 | |
| 
 | |
| ### getrawtransaction "txid" ( verbose )
 | |
| 
 | |
| NOTE: By default this function only works sometimes. This is when the tx is in
 | |
| the mempool or there is an unspent output in the utxo for this transaction. To
 | |
| make it always work, you need to maintain a transaction index, using the
 | |
| -txindex command line option.
 | |
| 
 | |
| Return the raw transaction data.
 | |
| 
 | |
| If verbose=0, returns a string that is serialized, hex-encoded data for 'txid'.
 | |
| If verbose is non-zero, returns an Object with information about 'txid'.
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| 1. "txid"      (string, required) The transaction id
 | |
| 2. verbose       (numeric, optional, default=0) If 0, return a string, other return a json object
 | |
| 
 | |
| Result (if verbose is not set or set to 0):
 | |
| 
 | |
| "data"      (string) The serialized, hex-encoded data for 'txid'
 | |
| 
 | |
| Result (if verbose > 0):
 | |
| 
 | |
| ```
 | |
| {
 | |
|   "hex" : "data",       (string) The serialized, hex-encoded data for 'txid'
 | |
|   "txid" : "id",        (string) The transaction id (same as provided)
 | |
|   "hash" : "id",        (string) The transaction hash (differs from txid for witness transactions)
 | |
|   "size" : n,             (numeric) The serialized transaction size
 | |
|   "vsize" : n,            (numeric) The virtual transaction size (differs from size for witness transactions)
 | |
|   "version" : n,          (numeric) The version
 | |
|   "locktime" : ttt,       (numeric) The lock time
 | |
|   "vin" : [               (array of json objects)
 | |
|      {
 | |
|        "txid": "id",    (string) The transaction id
 | |
|        "vout": n,         (numeric)
 | |
|        "scriptSig": {     (json object) The script
 | |
|          "asm": "asm",  (string) asm
 | |
|          "hex": "hex"   (string) hex
 | |
|        },
 | |
|        "sequence": n      (numeric) The script sequence number
 | |
|        "txinwitness": ["hex", ...] (array of string) hex-encoded witness data (if any)
 | |
|      }
 | |
|      ,...
 | |
|   ],
 | |
|   "vout" : [              (array of json objects)
 | |
|      {
 | |
|        "value" : x.xxx,            (numeric) The value in BTC
 | |
|        "n" : n,                    (numeric) index
 | |
|        "scriptPubKey" : {          (json object)
 | |
|          "asm" : "asm",          (string) the asm
 | |
|          "hex" : "hex",          (string) the hex
 | |
|          "reqSigs" : n,            (numeric) The required sigs
 | |
|          "type" : "pubkeyhash",  (string) The type, eg 'pubkeyhash'
 | |
|          "addresses" : [           (json array of string)
 | |
|            "bitcoinaddress"        (string) bitcoin address
 | |
|            ,...
 | |
|          ]
 | |
|        }
 | |
|      }
 | |
|      ,...
 | |
|   ],
 | |
|   "blockhash" : "hash",   (string) the block hash
 | |
|   "confirmations" : n,      (numeric) The confirmations
 | |
|   "time" : ttt,             (numeric) The transaction time in seconds since epoch (Jan 1 1970 GMT)
 | |
|   "blocktime" : ttt         (numeric) The block time in seconds since epoch (Jan 1 1970 GMT)
 | |
| }
 | |
| ```
 | |
| 
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli getrawtransaction "mytxid"
 | |
| > bitcoin-cli getrawtransaction "mytxid" 1
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getrawtransaction", "params": ["mytxid", 1] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| sendrawtransaction "hexstring" ( allowhighfees )
 | |
| signrawtransaction "hexstring" ( [{"txid":"id","vout":n,"scriptPubKey":"hex","redeemScript":"hex"},...] ["privatekey1",...] sighashtype )
 | |
| 
 | |
| == Util ==
 | |
| createmultisig nrequired ["key",...]
 | |
| estimatefee nblocks
 | |
| estimatepriority nblocks
 | |
| estimatesmartfee nblocks
 | |
| estimatesmartpriority nblocks
 | |
| signmessagewithprivkey "privkey" "message"
 | |
| validateaddress "bitcoinaddress"
 | |
| verifymessage "bitcoinaddress" "signature" "message"
 | |
| 
 | |
| == Wallet ==
 | |
| abandontransaction "txid"
 | |
| addmultisigaddress nrequired ["key",...] ( "account" )
 | |
| addwitnessaddress "address"
 | |
| backupwallet "destination"
 | |
| 
 | |
| ### dumpprivkey "bitcoinaddress"
 | |
| 
 | |
| Reveals the private key corresponding to 'bitcoinaddress'.
 | |
| 
 | |
| Then the importprivkey can be used with this output
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| 1. "bitcoinaddress"   (string, required) The bitcoin address for the private key
 | |
| 
 | |
| Result:
 | |
| 
 | |
| "key"                (string) The private key
 | |
| 
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli dumpprivkey "myaddress"
 | |
| > bitcoin-cli importprivkey "mykey"
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "dumpprivkey", "params": ["myaddress"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| dumpwallet "filename"
 | |
| encryptwallet "passphrase"
 | |
| getaccount "bitcoinaddress"
 | |
| getaccountaddress "account"
 | |
| getaddressesbyaccount "account"
 | |
| ###
 | |
| getbalance ( "account" minconf includeWatchonly )
 | |
| 
 | |
| If account is not specified, returns the server's total available balance.
 | |
| If account is specified (DEPRECATED), returns the balance in the account.
 | |
| Note that the account "" is not the same as leaving the parameter out.
 | |
| The server total may be different to the balance in the default "" account.
 | |
| 
 | |
| Arguments:
 | |
| 1. "account"      (string, optional) DEPRECATED. The selected account, or "\*" for entire wallet. It may be the default account using "".
 | |
| 2. minconf          (numeric, optional, default=1) Only include transactions confirmed at least this many times.
 | |
| 3. includeWatchonly (bool, optional, default=false) Also include balance in watchonly addresses (see 'importaddress')
 | |
| 
 | |
| Result:
 | |
| ```
 | |
| amount              (numeric) The total amount in BTC received for this account.
 | |
| ```
 | |
| Examples:
 | |
| 
 | |
| The total amount in the wallet
 | |
| ```
 | |
| > bitcoin-cli getbalance
 | |
| ```
 | |
| 
 | |
| The total amount in the wallet at least 5 blocks confirmed
 | |
| ```
 | |
| > bitcoin-cli getbalance "*" 6
 | |
| ```
 | |
| 
 | |
| As a json rpc call
 | |
| ```
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getbalance", "params": ["*", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| 
 | |
| ### getnewaddress ( "account" )
 | |
| 
 | |
| Returns a new Bitcoin address for receiving payments.
 | |
| 
 | |
| If 'account' is specified (DEPRECATED), it is added to the address book
 | |
| so payments received with the address will be credited to 'account'.
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| 1. "account"        (string, optional) DEPRECATED. The account name for the
 | |
| address to be linked to. If not provided, the default account "" is used. It
 | |
| can also be set to the empty string "" to represent the default account. The
 | |
| account does not need to exist, it will be created if there is no account by
 | |
| the given name.
 | |
| 
 | |
| Result:
 | |
| 
 | |
| "bitcoinaddress"    (string) The new bitcoin address
 | |
| 
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli getnewaddress
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnewaddress", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| getrawchangeaddress
 | |
| getreceivedbyaccount "account" ( minconf )
 | |
| getreceivedbyaddress "bitcoinaddress" ( minconf )
 | |
| 
 | |
| ## gettransaction "txid" ( includeWatchonly )
 | |
| 
 | |
| Get detailed information about in-wallet transaction <txid>
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| 1. "txid"    (string, required) The transaction id
 | |
| 2. "includeWatchonly"    (bool, optional, default=false) Whether to include watchonly addresses in balance calculation and details[]
 | |
| 
 | |
| Result:
 | |
| ```
 | |
| {
 | |
|   "amount" : x.xxx,        (numeric) The transaction amount in BTC
 | |
|   "confirmations" : n,     (numeric) The number of confirmations
 | |
|   "blockhash" : "hash",  (string) The block hash
 | |
|   "blockindex" : xx,       (numeric) The index of the transaction in the block that includes it
 | |
|   "blocktime" : ttt,       (numeric) The time in seconds since epoch (1 Jan 1970 GMT)
 | |
|   "txid" : "transactionid",   (string) The transaction id.
 | |
|   "time" : ttt,            (numeric) The transaction time in seconds since epoch (1 Jan 1970 GMT)
 | |
|   "timereceived" : ttt,    (numeric) The time received in seconds since epoch (1 Jan 1970 GMT)
 | |
|   "bip125-replaceable": "yes|no|unknown"  (string) Whether this transaction could be replaced due to BIP125 (replace-by-fee);
 | |
|                                                    may be unknown for unconfirmed transactions not in the mempool
 | |
|   "details" : [
 | |
|     {
 | |
|       "account" : "accountname",  (string) DEPRECATED. The account name involved in the transaction, can be "" for the default account.
 | |
|       "address" : "bitcoinaddress",   (string) The bitcoin address involved in the transaction
 | |
|       "category" : "send|receive",    (string) The category, either 'send' or 'receive'
 | |
|       "amount" : x.xxx,                 (numeric) The amount in BTC
 | |
|       "label" : "label",              (string) A comment for the address/transaction, if any
 | |
|       "vout" : n,                       (numeric) the vout value
 | |
|     }
 | |
|     ,...
 | |
|   ],
 | |
|   "hex" : "data"         (string) Raw data for transaction
 | |
| }
 | |
| ```
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
 | |
| > bitcoin-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d" true
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettransaction", "params": ["1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| getunconfirmedbalance
 | |
| 
 | |
| ## getwalletinfo
 | |
| Returns an object containing various wallet state info.
 | |
| 
 | |
| Result:
 | |
| ```
 | |
| {
 | |
|   "walletversion": xxxxx,       (numeric) the wallet version
 | |
|   "balance": xxxxxxx,           (numeric) the total confirmed balance of the wallet in BTC
 | |
|   "unconfirmed_balance": xxx,   (numeric) the total unconfirmed balance of the wallet in BTC
 | |
|   "immature_balance": xxxxxx,   (numeric) the total immature balance of the wallet in BTC
 | |
|   "txcount": xxxxxxx,           (numeric) the total number of transactions in the wallet
 | |
|   "keypoololdest": xxxxxx,      (numeric) the timestamp (seconds since Unix epoch) of the oldest pre-generated key in the key pool
 | |
|   "keypoolsize": xxxx,          (numeric) how many new keys are pre-generated
 | |
|   "unlocked_until": ttt,        (numeric) the timestamp in seconds since epoch (midnight Jan 1 1970 GMT) that the wallet is unlocked for transfers, or 0 if the wallet is locked
 | |
|   "paytxfee": x.xxxx,           (numeric) the transaction fee configuration, set in BTC/kB
 | |
|   "hdmasterkeyid": "<hash160>", (string) the Hash160 of the HD master pubkey
 | |
| }
 | |
| ```
 | |
| 
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli getwalletinfo
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getwalletinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| importaddress "address" ( "label" rescan p2sh )
 | |
| importprivkey "bitcoinprivkey" ( "label" rescan )
 | |
| importprunedfunds
 | |
| importpubkey "pubkey" ( "label" rescan )
 | |
| importwallet "filename"
 | |
| keypoolrefill ( newsize )
 | |
| listaccounts ( minconf includeWatchonly)
 | |
| listaddressgroupings
 | |
| listlockunspent
 | |
| listreceivedbyaccount ( minconf includeempty includeWatchonly)
 | |
| listreceivedbyaddress ( minconf includeempty includeWatchonly)
 | |
| listsinceblock ( "blockhash" target-confirmations includeWatchonly)
 | |
| listtransactions ( "account" count from includeWatchonly)
 | |
| 
 | |
| ### listunspent ( minconf maxconf  ["address",...] )
 | |
| 
 | |
| Returns array of unspent transaction outputs
 | |
| with between minconf and maxconf (inclusive) confirmations.
 | |
| Optionally filter to only include txouts paid to specified addresses.
 | |
| 
 | |
| Arguments:
 | |
| 
 | |
| 1. minconf          (numeric, optional, default=1) The minimum confirmations to filter
 | |
| 2. maxconf          (numeric, optional, default=9999999) The maximum confirmations to filter
 | |
| 3. "addresses"    (string) A json array of bitcoin addresses to filter
 | |
| ```
 | |
|     [
 | |
|       "address"   (string) bitcoin address
 | |
|       ,...
 | |
|     ]
 | |
| ```
 | |
| 
 | |
| Result:
 | |
| ```
 | |
| [                   (array of json object)
 | |
|   {
 | |
|     "txid" : "txid",          (string) the transaction id
 | |
|     "vout" : n,               (numeric) the vout value
 | |
|     "address" : "address",    (string) the bitcoin address
 | |
|     "account" : "account",    (string) DEPRECATED. The associated account, or "" for the default account
 | |
|     "scriptPubKey" : "key",   (string) the script key
 | |
|     "amount" : x.xxx,         (numeric) the transaction amount in BTC
 | |
|     "confirmations" : n,      (numeric) The number of confirmations
 | |
|     "redeemScript" : n        (string) The redeemScript if scriptPubKey is P2SH
 | |
|     "spendable" : xxx,        (bool) Whether we have the private keys to spend this output
 | |
|     "solvable" : xxx          (bool) Whether we know how to spend this output, ignoring the lack of keys
 | |
|   }
 | |
|   ,...
 | |
| ]
 | |
| ```
 | |
| 
 | |
| Examples:
 | |
| ```
 | |
| > bitcoin-cli listunspent
 | |
| > bitcoin-cli listunspent 6 9999999 "[\"1PGFqEzfmQch1gKD3ra4k18PNj3tTUUSqg\",\"1LtvqCaApEdUGFkpKMM4MstjcaL4dKg8SP\"]"
 | |
| > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listunspent", "params": [6, 9999999 "[\"1PGFqEzfmQch1gKD3ra4k18PNj3tTUUSqg\",\"1LtvqCaApEdUGFkpKMM4MstjcaL4dKg8SP\"]"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/
 | |
| ```
 | |
| 
 | |
| lockunspent unlock ([{"txid":"txid","vout":n},...])
 | |
| move "fromaccount" "toaccount" amount ( minconf "comment" )
 | |
| removeprunedfunds "txid"
 | |
| sendfrom "fromaccount" "tobitcoinaddress" amount ( minconf "comment" "comment-to" )
 | |
| sendmany "fromaccount" {"address":amount,...} ( minconf "comment" ["address",...] )
 | |
| sendtoaddress "bitcoinaddress" amount ( "comment" "comment-to" subtractfeefromamount )
 | |
| setaccount "bitcoinaddress" "account"
 | |
| settxfee amount
 | |
| signmessage "bitcoinaddress" "message"
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| =====
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| -?
 | |
| Print this help message and exit
 | |
| -version
 | |
| Print version and exit
 | |
| -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)
 | |
| -checkblocks=<n>
 | |
| How many blocks to check at startup (default: 6, 0 = all)
 | |
| -checklevel=<n>
 | |
| How thorough the block verification of -checkblocks is (0-4, default: 3)
 | |
| -conf=<file>
 | |
| Specify configuration file (default: bitcoin.conf)
 | |
| -datadir=<dir>
 | |
| Specify data directory
 | |
| -dbcache=<n>
 | |
| Set database cache size in megabytes (4 to 16384, default: 300)
 | |
| -loadblock=<file>
 | |
| Imports blocks from external blk000??.dat file on startup
 | |
| -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: 72)
 | |
| -par=<n>
 | |
| Set the number of script verification threads (-4 to 16, 0 = auto, <0 = leave that many cores free, default: 0)
 | |
| -pid=<file>
 | |
| Specify pid file (default: bitcoind.pid)
 | |
| -prune=<n>
 | |
| Reduce storage requirements by pruning (deleting) old blocks. This mode is incompatible with -txindex and -rescan. Warning: Reverting this setting requires re-downloading the entire blockchain. (default: 0 = disable pruning blocks, >550 = target size in MiB to use for block files)
 | |
| -reindex-chainstate
 | |
| Rebuild chain state from the currently indexed blocks
 | |
| -reindex
 | |
| Rebuild chain state and block index from the blk*.dat files on disk
 | |
| -sysperms
 | |
| Create new files with system default permissions, instead of umask 077 (only effective with disabled wallet functionality)
 | |
| -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)
 | |
| -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)
 | |
| -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)
 | |
| -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: 8333 or testnet: 18333)
 | |
| -proxy=<ip:port>
 | |
| Connect through SOCKS5 proxy
 | |
| -proxyrandomize
 | |
| Randomize credentials for every proxy connection. This enables Tor stream isolation (default: 1)
 | |
| -rpcserialversion
 | |
| Sets the serialization 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 BTC/kB) that will be used when fee estimation has insufficient data (default: 0.0002)
 | |
| -mintxfee=<amt>
 | |
| Fees (in BTC/kB) smaller than this are considered zero fee for transaction creation (default: 0.00001)
 | |
| -paytxfee=<amt>
 | |
| Fee (in BTC/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: 2)
 | |
| -usehd
 | |
| Use hierarchical deterministic key generation (HD) after BIP32. Only has effect during wallet creation/first start (default: 1)
 | |
| -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 BTC/kB) smaller than this are considered zero fee for relaying, mining and transaction creation (default: 0.00001)
 | |
| -maxtxfee=<amt>
 | |
| Maximum total fees (in BTC) 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: 750000)
 | |
| -blockprioritysize=<n>
 | |
| Set maximum size of high-priority/low-fee transactions in bytes (default: 0)
 | |
| 
 | |
| 
 | |
| 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>$<HASH>. A canonical python script is included in share/rpcuser. This option can be specified multiple times
 | |
| -rpcport=<port>
 | |
| Listen for JSON-RPC connections on <port> (default: 8332 or testnet: 18332)
 | |
| -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 minimized
 | |
| -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
 |