You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

75 lines
2.0 KiB

.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