core-lightning/doc/lightning-listfunds.7.txt

71 lines
1.8 KiB
Plaintext

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.
- 'funding_output' - the index of the output in the funding transaction.
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