bitcoin-cli --help
Jump to navigation
Jump to search
./bitcoin-cli --help
Bitcoin Core RPC client version v0.21.1.0-g194b9b8792d9b0798fdb570b79fa51f1d1f5ebaf
Usage: bitcoin-cli [options] <command> [params] Send command to Bitcoin Core
or: bitcoin-cli [options] -named <command> [name=value]... Send command to Bitcoin Core (with named arguments)
or: bitcoin-cli [options] help List commands
or: bitcoin-cli [options] help <command> Get help for a command
Options:
-?
Print this help message and exit
-conf=<file>
Specify configuration file. Relative paths will be prefixed by datadir
location. (default: bitcoin.conf)
-datadir=<dir>
Specify data directory
-generate
Generate blocks immediately, equivalent to RPC generatenewaddress
followed by RPC generatetoaddress. Optional positional integer
arguments are number of blocks to generate (default: 1) and
maximum iterations to try (default: 1000000), equivalent to RPC
generatetoaddress nblocks and maxtries arguments. Example:
bitcoin-cli -generate 4 1000
-getinfo
Get general information from the remote server. Note that unlike
server-side RPC calls, the results of -getinfo is the result of
multiple non-atomic requests. Some entries in the result may
represent results from different states (e.g. wallet balance may
be as of a different block from the chain state reported)
-named
Pass named instead of positional arguments (default: false)
-netinfo
Get network peer connection information from the remote server. An
optional integer argument from 0 to 4 can be passed for different
peers listings (default: 0).
-rpcclienttimeout=<n>
Timeout in seconds during HTTP requests, or 0 for no timeout. (default:
900)
-rpcconnect=<ip>
Send commands to node running on <ip> (default: 127.0.0.1)
-rpccookiefile=<loc>
Location of the auth cookie. Relative paths will be prefixed by a
net-specific datadir location. (default: data dir)
-rpcpassword=<pw>
Password for JSON-RPC connections
-rpcport=<port>
Connect to JSON-RPC on <port> (default: 8332, testnet: 18332, signet:
38332, regtest: 18443)
-rpcuser=<user>
Username for JSON-RPC connections
-rpcwait
Wait for RPC server to start
-rpcwallet=<walletname>
Send RPC for non-default wallet on RPC server (needs to exactly match
corresponding -wallet option passed to bitcoind). This changes
the RPC endpoint used, e.g.
http://127.0.0.1:8332/wallet/<walletname>
-stdin
Read extra arguments from standard input, one per line until EOF/Ctrl-D
(recommended for sensitive information such as passphrases). When
combined with -stdinrpcpass, the first line from standard input
is used for the RPC password.
-stdinrpcpass
Read RPC password from standard input as a single line. When combined
with -stdin, the first line from standard input is used for the
RPC password. When combined with -stdinwalletpassphrase,
-stdinrpcpass consumes the first line, and -stdinwalletpassphrase
consumes the second.
-stdinwalletpassphrase
Read wallet passphrase from standard input as a single line. When
combined with -stdin, the first line from standard input is used
for the wallet passphrase.
-version
Print version and exit
Debugging/Testing options:
Chain selection options:
-chain=<chain>
Use the chain <chain> (default: main). Allowed values: main, test,
signet, regtest
-signet
Use the signet chain. Equivalent to -chain=signet. Note that the network
is defined by the -signetchallenge parameter
-signetchallenge
Blocks must satisfy the given script to be considered valid (only for
signet networks; defaults to the global default signet test
network challenge)
-signetseednode
Specify a seed node for the signet network, in the hostname[:port]
format, e.g. sig.net:1234 (may be used multiple times to specify
multiple seed nodes; defaults to the global default signet test
network seed node(s))
-testnet
Use the test chain. Equivalent to -chain=test.
bitcoin-cli help
See also[edit]
bitcoin-cli [ listtransactions | help ]bitcoind, .bitcoin/, bitcoin.conf, Dockerfile, Bitcoind ports( 8332 18332 18443 8333 18333 18444 ), -chain, -datadir, -server, --help, Bitcoind logs, Bitcoind changelog- Bitcoin (
BTC), Bitcoin Cash (BCH), Wrapped Bitcoin (WBTC), Bitcoin Satoshi Vision (BSV), blockchain.com, Coinbase, Cryptocurrency wallet, Ripple, Grayscale, Hummingbot, USD Coin, Zcash, Polkadot,bitcoin-cli, Bitmain, Hal Finney, List of bitcoin forks, Lightning Network, Minsc, SegWit, Bitcoin mining, BIP, Bech32, Ordinals, SPV, Bitcoin testnet, Satoshi Nakamoto, BRC-20, Bitcoin genesis block, Bitcoin address, Omni Layer protocol, Bitcoin Supercharged Network, Partially Signed Bitcoin Transactions (PSBTs)
Advertising: