|
|
|
|
.TH "LIGHTNING-LISTFORWARDS" "7" "" "" "lightning-listforwards"
|
|
|
|
|
.SH NAME
|
|
|
|
|
lightning-listforwards - Command showing all htlcs and their information
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
|
|
|
|
\fBlistforwards\fR
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
|
|
|
|
|
The \fBlistforwards\fR RPC command displays all htlcs that have been
|
|
|
|
|
attempted to be forwarded by the c-lightning node\.
|
|
|
|
|
|
|
|
|
|
.SH RETURN VALUE
|
|
|
|
|
|
|
|
|
|
On success one array will be returned: \fIforwards\fR with htlcs that have
|
|
|
|
|
been processed
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Each entry in \fIforwards\fR will include:
|
|
|
|
|
|
|
|
|
|
.RS
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIin_channel\fR: the short_channel_id of the channel that recieved the incoming htlc\.
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIin_msatoshi\fR, \fIin_msat\fR - amount of msatoshis that are forwarded to this node\.
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIstatus\fR: status can be either \fIoffered\fR if the routing process is still ongoing,
|
|
|
|
|
\fIsettled\fR if the routing process is completed or \fIfailed\fR if the routing process could not be completed\.
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIreceived_time\fR: timestamp when incoming htlc was received\.
|
|
|
|
|
|
|
|
|
|
.RE
|
|
|
|
|
|
|
|
|
|
The following additional fields are usually present, but will not be for some
|
|
|
|
|
variants of status \fIlocal_failed\fR (if it failed before we determined these):
|
|
|
|
|
|
|
|
|
|
.RS
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIout_channel\fR: the short_channel_id of to which the outgoing htlc is supposed to be forwarded\.
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIfee\fR, \fIfee_msat\fR: fee offered for forwarding the htlc in msatoshi\.
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIout_msatoshi\fR, \fIout_msat\fR - amount of msatoshis to be forwarded\.
|
|
|
|
|
|
|
|
|
|
.RE
|
|
|
|
|
|
|
|
|
|
The following fields may be offered, but for old forgotten HTLCs they will be omitted:
|
|
|
|
|
|
|
|
|
|
.RS
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIpayment_hash\fR - the payment_hash belonging to the HTLC\.
|
|
|
|
|
|
|
|
|
|
.RE
|
|
|
|
|
|
|
|
|
|
If the status is not 'offered', the following additional fields are present:
|
|
|
|
|
|
|
|
|
|
.RS
|
|
|
|
|
.IP \[bu]
|
|
|
|
|
\fIresolved_time\fR - timestamp when htlc was resolved (settled or failed)\.
|
|
|
|
|
|
|
|
|
|
.RE
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
|
|
|
|
|
Rene Pickhardt \fI<r.pickhardt@gmail.com\fR> is mainly responsible\.
|
|
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
|
|
|
|
|
\fBlightning-getinfo\fR(7)
|
|
|
|
|
|
|
|
|
|
.SH RESOURCES
|
|
|
|
|
|
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|
|
|
|
|
|
|
|
\" SHA256STAMP:8cefda0944e3371f1f7bca046d8792125fb8b6eda11351b6f39a08bab60cff2e
|
