Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LIGHTNING-LISTFORWARDS(7)   lightning-listforwards   LIGHTNING-LISTFORWARDS(7)

NAME
       lightning-listforwards  -  Command showing all htlcs and	their informa-
       tion

SYNOPSIS
       listforwards

DESCRIPTION
       The listforwards	RPC command displays all  htlcs	 that  have  been  at-
       tempted 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:

       o      in_channel: the short_channel_id of the  channel	that  recieved
	      the incoming htlc.

       o      in_msatoshi, in_msat - amount of msatoshis that are forwarded to
	      this node.

       o      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.

       o      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):

       o      out_channel: the short_channel_id	of to which the	outgoing  htlc
	      is supposed to be	forwarded.

       o      fee, fee_msat: fee offered for forwarding	the htlc in msatoshi.

       o      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:

       o      payment_hash - the payment_hash belonging	to the HTLC.

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

       o      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

						     LIGHTNING-LISTFORWARDS(7)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | AUTHOR | SEE ALSO | RESOURCES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lightning-listforwards&sektion=7&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help