lukechilds
/
lightning
mirror of https://github.com/lukechilds/lightning.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
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.
6340 Commits
55 Branches
107 Tags
38 MiB
 
 
 
 
 
 
Tree: 8f8e955421
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '8f8e955421'
${ noResults }
lightning/doc/lightning-listforwards.7.md

1.9 KiB
Raw Blame History

LIGHTNING-LISTFORWARDS(7) Manual Page

lightning-listforwards - Command showing all htlcs and their information.

SYNOPSIS

listforwards

DESCRIPTION

The listforwards RPC command displays all htlcs that have been attempted to be forwarded by the c-lightning node.

RETURN VALUE

On success one array will be returned: forwards with htlcs that have been processed

Each entry in forwards will include:

  • in_channel: the short_channel_id of the channel that recieved the incoming htlc.
  • in_msatoshi, in_msat - amount of msatoshis that are forwarded to this node.
  • status: status can be either offered if the routing process is still ongoing, settled if the routing process is completed or failed if the routing process could not be completed.
  • received_time: timestamp when incoming htlc was received.

The following additional fields are usually present, but will not be for some variants of status local_failed (if it failed before we determined these):

  • out_channel: the short_channel_id of to which the outgoing htlc is supposed to be forwarded.
  • fee, fee_msat: fee offered for forwarding the htlc in msatoshi.
  • out_msatoshi, out_msat - amount of msatoshis to be forwarded.

The following fields may be offered, but for old forgotten HTLCs they will be omitted:

  • payment_hash - the payment_hash belonging to the HTLC.

If the status is not 'offered', the following additional fields are present:

  • resolved_time - timestamp when htlc was resolved (settled or failed).

AUTHOR

Rene Pickhardt <r.pickhardt@gmail.com> is mainly responsible.

SEE ALSO

lightning-getinfo(7)

RESOURCES

Main web site: https://github.com/ElementsProject/lightning

Last updated 2019-07-23 00:53:16 CEST