2020-11-18 10:43:15 +01:00
|
|
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.13.
|
|
|
|
.TH BITCOIN-CLI "1" "November 2020" "bitcoin-cli v0.21.0.0" "User Commands"
|
2016-08-27 01:03:06 +02:00
|
|
|
.SH NAME
|
2020-11-18 10:43:15 +01:00
|
|
|
bitcoin-cli \- manual page for bitcoin-cli v0.21.0.0
|
2018-12-29 10:22:49 +01:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B bitcoin-cli
|
|
|
|
[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR] \fI\,Send command to Bitcoin Core\/\fR
|
|
|
|
.br
|
|
|
|
.B bitcoin-cli
|
|
|
|
[\fI\,options\/\fR] \fI\,-named <command> \/\fR[\fI\,name=value\/\fR]... \fI\,Send command to Bitcoin Core (with named arguments)\/\fR
|
|
|
|
.br
|
|
|
|
.B bitcoin-cli
|
|
|
|
[\fI\,options\/\fR] \fI\,help List commands\/\fR
|
|
|
|
.br
|
|
|
|
.B bitcoin-cli
|
|
|
|
[\fI\,options\/\fR] \fI\,help <command> Get help for a command\/\fR
|
2016-08-27 01:03:06 +02:00
|
|
|
.SH DESCRIPTION
|
2020-11-18 10:43:15 +01:00
|
|
|
Bitcoin Core RPC client version v0.21.0.0
|
2016-08-27 01:03:06 +02:00
|
|
|
.SH OPTIONS
|
|
|
|
.HP
|
|
|
|
\-?
|
|
|
|
.IP
|
2019-02-06 19:57:52 +01:00
|
|
|
Print this help message and exit
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
|
|
|
\fB\-conf=\fR<file>
|
|
|
|
.IP
|
2018-07-27 00:39:42 +02:00
|
|
|
Specify configuration file. Relative paths will be prefixed by datadir
|
|
|
|
location. (default: bitcoin.conf)
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
|
|
|
\fB\-datadir=\fR<dir>
|
|
|
|
.IP
|
|
|
|
Specify data directory
|
2018-01-30 14:23:36 +01:00
|
|
|
.HP
|
2020-11-18 10:43:15 +01:00
|
|
|
\fB\-generate\fR
|
|
|
|
.IP
|
|
|
|
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 \fB\-generate\fR 4 1000
|
|
|
|
.HP
|
2018-01-30 14:23:36 +01:00
|
|
|
\fB\-getinfo\fR
|
|
|
|
.IP
|
|
|
|
Get general information from the remote server. Note that unlike
|
|
|
|
server\-side RPC calls, the results of \fB\-getinfo\fR 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)
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
2017-02-17 18:21:18 +01:00
|
|
|
\fB\-named\fR
|
|
|
|
.IP
|
|
|
|
Pass named instead of positional arguments (default: false)
|
|
|
|
.HP
|
2020-11-18 10:43:15 +01:00
|
|
|
\fB\-netinfo\fR
|
|
|
|
.IP
|
|
|
|
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).
|
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-rpcclienttimeout=\fR<n>
|
|
|
|
.IP
|
|
|
|
Timeout in seconds during HTTP requests, or 0 for no timeout. (default:
|
|
|
|
900)
|
|
|
|
.HP
|
2016-08-27 01:03:06 +02:00
|
|
|
\fB\-rpcconnect=\fR<ip>
|
|
|
|
.IP
|
|
|
|
Send commands to node running on <ip> (default: 127.0.0.1)
|
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-rpccookiefile=\fR<loc>
|
2016-08-27 01:03:06 +02:00
|
|
|
.IP
|
2018-07-27 00:39:42 +02:00
|
|
|
Location of the auth cookie. Relative paths will be prefixed by a
|
|
|
|
net\-specific datadir location. (default: data dir)
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-rpcpassword=\fR<pw>
|
2016-08-27 01:03:06 +02:00
|
|
|
.IP
|
2018-07-27 00:39:42 +02:00
|
|
|
Password for JSON\-RPC connections
|
|
|
|
.HP
|
|
|
|
\fB\-rpcport=\fR<port>
|
|
|
|
.IP
|
2020-11-18 10:43:15 +01:00
|
|
|
Connect to JSON\-RPC on <port> (default: 8332, testnet: 18332, signet:
|
|
|
|
38332, regtest: 18443)
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
|
|
|
\fB\-rpcuser=\fR<user>
|
|
|
|
.IP
|
|
|
|
Username for JSON\-RPC connections
|
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-rpcwait\fR
|
2016-08-27 01:03:06 +02:00
|
|
|
.IP
|
2018-07-27 00:39:42 +02:00
|
|
|
Wait for RPC server to start
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-rpcwallet=\fR<walletname>
|
2016-08-27 01:03:06 +02:00
|
|
|
.IP
|
2018-07-27 00:39:42 +02:00
|
|
|
Send RPC for non\-default wallet on RPC server (needs to exactly match
|
2018-12-29 10:22:49 +01:00
|
|
|
corresponding \fB\-wallet\fR option passed to bitcoind). This changes
|
|
|
|
the RPC endpoint used, e.g.
|
|
|
|
http://127.0.0.1:8332/wallet/<walletname>
|
2018-07-27 00:39:42 +02:00
|
|
|
.HP
|
|
|
|
\fB\-stdin\fR
|
|
|
|
.IP
|
|
|
|
Read extra arguments from standard input, one per line until EOF/Ctrl\-D
|
2018-12-29 10:22:49 +01:00
|
|
|
(recommended for sensitive information such as passphrases). When
|
|
|
|
combined with \fB\-stdinrpcpass\fR, the first line from standard input
|
|
|
|
is used for the RPC password.
|
2017-09-12 09:34:12 +02:00
|
|
|
.HP
|
|
|
|
\fB\-stdinrpcpass\fR
|
|
|
|
.IP
|
2018-12-29 10:22:49 +01:00
|
|
|
Read RPC password from standard input as a single line. When combined
|
2017-09-12 09:34:12 +02:00
|
|
|
with \fB\-stdin\fR, the first line from standard input is used for the
|
2020-11-18 10:43:15 +01:00
|
|
|
RPC password. When combined with \fB\-stdinwalletpassphrase\fR,
|
|
|
|
\fB\-stdinrpcpass\fR consumes the first line, and \fB\-stdinwalletpassphrase\fR
|
|
|
|
consumes the second.
|
|
|
|
.HP
|
|
|
|
\fB\-stdinwalletpassphrase\fR
|
|
|
|
.IP
|
|
|
|
Read wallet passphrase from standard input as a single line. When
|
|
|
|
combined with \fB\-stdin\fR, the first line from standard input is used
|
|
|
|
for the wallet passphrase.
|
2016-08-27 01:03:06 +02:00
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-version\fR
|
2016-08-27 01:03:06 +02:00
|
|
|
.IP
|
2018-07-27 00:39:42 +02:00
|
|
|
Print version and exit
|
|
|
|
.PP
|
2020-11-18 10:43:15 +01:00
|
|
|
Debugging/Testing options:
|
|
|
|
.PP
|
2018-07-27 00:39:42 +02:00
|
|
|
Chain selection options:
|
2017-09-12 09:34:12 +02:00
|
|
|
.HP
|
2020-11-18 10:43:15 +01:00
|
|
|
\fB\-chain=\fR<chain>
|
|
|
|
.IP
|
|
|
|
Use the chain <chain> (default: main). Allowed values: main, test,
|
|
|
|
signet, regtest
|
|
|
|
.HP
|
|
|
|
\fB\-signet\fR
|
|
|
|
.IP
|
|
|
|
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\-signetchallenge\fR
|
|
|
|
.IP
|
|
|
|
Blocks must satisfy the given script to be considered valid (only for
|
|
|
|
signet networks; defaults to the global default signet test
|
|
|
|
network challenge)
|
|
|
|
.HP
|
|
|
|
\fB\-signetseednode\fR
|
|
|
|
.IP
|
|
|
|
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))
|
|
|
|
.HP
|
2018-07-27 00:39:42 +02:00
|
|
|
\fB\-testnet\fR
|
2017-09-12 09:34:12 +02:00
|
|
|
.IP
|
2020-11-18 10:43:15 +01:00
|
|
|
Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR.
|
2016-08-27 01:03:06 +02:00
|
|
|
.SH COPYRIGHT
|
2020-11-18 10:43:15 +01:00
|
|
|
Copyright (C) 2009-2020 The Bitcoin Core developers
|
2016-08-27 01:03:06 +02:00
|
|
|
|
|
|
|
Please contribute if you find Bitcoin Core useful. Visit
|
2020-11-18 10:43:15 +01:00
|
|
|
<https://bitcoincore.org/> for further information about the software.
|
2016-08-27 01:03:06 +02:00
|
|
|
The source code is available from <https://github.com/bitcoin/bitcoin>.
|
|
|
|
|
|
|
|
This is experimental software.
|
|
|
|
Distributed under the MIT software license, see the accompanying file COPYING
|
2017-02-17 18:21:18 +01:00
|
|
|
or <https://opensource.org/licenses/MIT>
|