lightning-listfunds.7.txt

LIGHTNING-LISTFUNDS(7)
======================
:doctype: manpage

NAME
----
lightning-listfunds - Command showing all funds currently managed by 
the c-lightning node.

SYNOPSIS
--------
*listfunds* 

DESCRIPTION
-----------
The *listfunds* RPC command displays all funds available, either in 
unspent outputs (UTXOs) in the internal wallet or funds locked in 
currently open channels.

RETURN VALUE
------------
On success two arrays will be returned: 'outputs' with funds 
currently locked onchain in UTXOs and 'channels' with funds 
readily spendable in channels. 

Each entry in 'outputs' will include:

- 'txid'

- 'output' (the index of the output in the transaction)

- 'value' (the output value in satoshis)

- 'amount_msat' (the same as 'value', but in millisatoshi with 'msat' appended)

- 'address'

- 'status' (whether 'unconfirmed', 'confirmed', or 'spent')

Each entry in 'channels' will include: 

- 'peer_id' - the peer with which the channel is opened.

- 'short_channel_id' - as per BOLT 7 (representing the block, transaction
number and output index of the channel funding transaction).

- 'channel_sat' - available satoshis on our node's end of the channel 
(values rounded down to satoshis as internal storage is in millisatoshi).

- 'our_amount_msat' - same as above, but in millisatoshis with 'msat' appended.

- 'channel_total_sat' - total channel value in satoshi 

- 'amount_msat' - same as above, but in millisatoshis with 'msat' appended.

- 'funding_txid' - funding transaction id.

AUTHOR
------
Felix <fixone@gmail.com> is mainly responsible.

SEE ALSO
--------
lightning-newaddr(7), lightning-fundchannel(7), lightning-withdraw(7)

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