aboutsummaryrefslogtreecommitdiff
path: root/doc/man/bitcoin-cli.1
blob: 8bcbe08a9bcbd9a844d66be1f63b84e10efff5fb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.13.
.TH BITCOIN-CLI "1" "August 2021" "bitcoin-cli v22.0rc2" "User Commands"
.SH NAME
bitcoin-cli  manual page for bitcoin-cli v22.0rc2
.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
.SH DESCRIPTION
Bitcoin Core RPC client version v22.0rc2
.SH OPTIONS
.HP
?
.IP
Print this help message and exit
.HP
\fBaddrinfo\fR
.IP
Get the number of addresses known to the node, per network and total.
.HP
\fBconf=\fR<file>
.IP
Specify configuration file. Relative paths will be prefixed by datadir
location. (default: bitcoin.conf)
.HP
\fBdatadir=\fR<dir>
.IP
Specify data directory
.HP
\fBgenerate\fR
.IP
Generate blocks immediately, equivalent to RPC getnewaddress 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: bitcoincli \fBgenerate\fR 4
1000
.HP
\fBgetinfo\fR
.IP
Get general information from the remote server. Note that unlike
serverside RPC calls, the results of \fBgetinfo\fR is the result of
multiple nonatomic 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)
.HP
\fBnamed\fR
.IP
Pass named instead of positional arguments (default: false)
.HP
\fBnetinfo\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). Pass "help" for detailed help
documentation.
.HP
\fBrpcclienttimeout=\fR<n>
.IP
Timeout in seconds during HTTP requests, or 0 for no timeout. (default:
900)
.HP
\fBrpcconnect=\fR<ip>
.IP
Send commands to node running on <ip> (default: 127.0.0.1)
.HP
\fBrpccookiefile=\fR<loc>
.IP
Location of the auth cookie. Relative paths will be prefixed by a
netspecific datadir location. (default: data dir)
.HP
\fBrpcpassword=\fR<pw>
.IP
Password for JSONRPC connections
.HP
\fBrpcport=\fR<port>
.IP
Connect to JSONRPC on <port> (default: 8332, testnet: 18332, signet:
38332, regtest: 18443)
.HP
\fBrpcuser=\fR<user>
.IP
Username for JSONRPC connections
.HP
\fBrpcwait\fR
.IP
Wait for RPC server to start
.HP
\fBrpcwaittimeout=\fR<n>
.IP
Timeout in seconds to wait for the RPC server to start, or 0 for no
timeout. (default: 0)
.HP
\fBrpcwallet=\fR<walletname>
.IP
Send RPC for nondefault wallet on RPC server (needs to exactly match
corresponding \fBwallet\fR option passed to bitcoind). This changes
the RPC endpoint used, e.g.
http://127.0.0.1:8332/wallet/<walletname>
.HP
\fBstdin\fR
.IP
Read extra arguments from standard input, one per line until EOF/CtrlD
(recommended for sensitive information such as passphrases). When
combined with \fBstdinrpcpass\fR, the first line from standard input
is used for the RPC password.
.HP
\fBstdinrpcpass\fR
.IP
Read RPC password from standard input as a single line. When combined
with \fBstdin\fR, the first line from standard input is used for the
RPC password. When combined with \fBstdinwalletpassphrase\fR,
\fBstdinrpcpass\fR consumes the first line, and \fBstdinwalletpassphrase\fR
consumes the second.
.HP
\fBstdinwalletpassphrase\fR
.IP
Read wallet passphrase from standard input as a single line. When
combined with \fBstdin\fR, the first line from standard input is used
for the wallet passphrase.
.HP
\fBversion\fR
.IP
Print version and exit
.PP
Debugging/Testing options:
.PP
Chain selection options:
.HP
\fBchain=\fR<chain>
.IP
Use the chain <chain> (default: main). Allowed values: main, test,
signet, regtest
.HP
\fBsignet\fR
.IP
Use the signet chain. Equivalent to \fBchain\fR=\fI\,signet\/\fR. Note that the network
is defined by the \fBsignetchallenge\fR parameter
.HP
\fBsignetchallenge\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
\fBsignetseednode\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
\fBtestnet\fR
.IP
Use the test chain. Equivalent to \fBchain\fR=\fI\,test\/\fR.