forked from ElementsProject/lightning
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathlightning-listchannels.7
134 lines (93 loc) · 3.79 KB
/
lightning-listchannels.7
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
.TH "LIGHTNING-LISTCHANNELS" "7" "" "" "lightning-listchannels"
.SH NAME
lightning-listchannels - Command to query active lightning channels in the entire network
.SH SYNOPSIS
\fBlistchannels\fR [\fIshort_channel_id\fR] [\fIsource\fR]
.SH DESCRIPTION
The \fBlistchannels\fR RPC command returns data on channels that are known
to the node\. Because channels may be bidirectional, up to 2 objects will
be returned for each channel (one for each direction)\.
If \fIshort_channel_id\fR is supplied, then only known channels with a
matching \fIshort_channel_id\fR are returned\.
If \fIsource\fR is supplied, then only channels leading from that node id
are returned\.
If neither is supplied, data on all lightning channels known to this
node, are returned\. These can be local channels or public channels
broadcast on the gossip network\.
.SH RETURN VALUE
On success, an object with a "channels" key is returned containing a
list of 0 or more objects\.
Each object in the list contains the following data:
.IP \[bu]
\fIsource\fR : The node providing entry to the channel, specifying the
fees charged for using the channel in that direction\.
.IP \[bu]
\fIdestination\fR : The node providing the exit point for the channel\.
.IP \[bu]
\fIshort_channel_id\fR : The channel identifier\.
.IP \[bu]
\fIpublic\fR : Boolean value, is publicly available\. Non-local channels
will only ever have this value set to true\. Local channels are
side-loaded by this node, rather than obtained through the gossip
network, and so may have this value set to false\.
.IP \[bu]
\fIsatoshis\fR : Funds available in the channel\.
.IP \[bu]
\fIamount_sat\fR : Same as above, but ending in \fIsat\fR\.
.IP \[bu]
\fImessage_flags\fR : Bitfield showing the presence of optional fields
in the \fIchannel_update\fR message (BOLT #7)\.
.IP \[bu]
\fIchannel_flags\fR : Bitfields indicating the direction of the channel
and signaling various options concerning the channel\. (BOLT #7)\.
.IP \[bu]
\fIactive\fR : Boolean value, is available for routing\. This is linked
to the channel flags data, where if the second bit is set, signals a
channels temporary unavailability (due to loss of connectivity) OR
permanent unavailability where the channel has been closed but not
settlement on-chain\.
.IP \[bu]
\fIlast_update\fR : Unix timestamp (seconds) showing when the last
channel_update message was received\.
.IP \[bu]
\fIbase_fee_millisatoshi\fR : The base fee (in millisatoshi) charged
for the HTLC (BOLT #2)\.
.IP \[bu]
\fIfee_per_millionth\fR : The amount (in millionths of a satoshi)
charged per transferred satoshi (BOLT #2)\.
.IP \[bu]
\fIdelay\fR : The number of blocks delay required to wait for on-chain
settlement when unilaterally closing the channel (BOLT #2)\.
.IP \[bu]
\fIhtlc_minimum_msat\fR : The minimum payment which can be send
through this channel\.
.IP \[bu]
\fIhtlc_maximum_msat\fR : The maximum payment which can be send
through this channel\.
If \fIshort_channel_id\fR or \fIsource\fR is supplied and no matching channels
are found, a "channels" object with an empty list is returned\.
.SH ERRORS
If \fIshort_channel_id\fR is not a valid short_channel_id, an error
message will be returned:
.nf
.RS
{ "code" : -32602,
"message" : "'short_channel_id' should be a short channel id, not '...'" }
.RE
.fi
Similarly if \fIsource\fR is not a valid pubkey\.
.SH AUTHOR
Michael Hawkins \fI<[email protected]\fR>\.
.SH SEE ALSO
\fBlightning-fundchannel\fR(7), \fBlightning-listnodes\fR(7)
.SH RESOURCES
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
Lightning RFC site
.IP \[bu]
BOLT #2:
\fIhttps://github.com/lightningnetwork/lightning-rfc/blob/master/02-peer-protocol.md\fR
.IP \[bu]
BOLT #7:
\fIhttps://github.com/lightningnetwork/lightning-rfc/blob/master/07-routing-gossip.md\fR
.HL
Last updated 2019-06-12 11:16:20 CEST