bcabb3825f
1. If the tool changes, you need to regenerate since the output may change. 2. This didn't just filter that out, ignored all but the first dependency, which made bisecting the bookkeeper plugin a nightmare: it didn't regenerate the .po file, causing random crashes. If we want this, try $(filter-out tools/fromschema.py) instead. But I don't think we want that. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
3.0 KiB
lightning-listfunds -- Command showing all funds currently managed by the Core Lightning node
SYNOPSIS
listfunds [spent]
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.
spent is a boolean: if true, then the outputs will include spent outputs in addition to the unspent ones. Default is false.
RETURN VALUE
On success, an object is returned, containing:
-
outputs (array of objects):
- txid (txid): the ID of the spendable transaction
- output (u32): the index within txid
- amount_msat (msat): the amount of the output
- scriptpubkey (hex): the scriptPubkey of the output
- status (string) (one of "unconfirmed", "confirmed", "spent")
- reserved (boolean): whether this UTXO is currently reserved for an in-flight tx
- address (string, optional): the bitcoin address of the output
- redeemscript (hex, optional): the redeemscript, only if it's p2sh-wrapped
If status is "confirmed":
- blockheight (u32): Block height where it was confirmed
If reserved is "true":
- reserved_to_block (u32): Block height where reservation will expire
-
channels (array of objects):
- peer_id (pubkey): the peer with which the channel is opened
- our_amount_msat (msat): available satoshis on our node's end of the channel
- amount_msat (msat): total channel value
- funding_txid (txid): funding transaction id
- funding_output (u32): the 0-based index of the output in the funding transaction
- connected (boolean): whether the channel peer is connected
- state (string): the channel state, in particular "CHANNELD_NORMAL" means the channel can be used normally (one of "OPENINGD", "CHANNELD_AWAITING_LOCKIN", "CHANNELD_NORMAL", "CHANNELD_SHUTTING_DOWN", "CLOSINGD_SIGEXCHANGE", "CLOSINGD_COMPLETE", "AWAITING_UNILATERAL", "FUNDING_SPEND_SEEN", "ONCHAIN", "DUALOPEND_OPEN_INIT", "DUALOPEND_AWAITING_LOCKIN")
If state is "CHANNELD_NORMAL":
- short_channel_id (short_channel_id): short channel id of channel
If state is "CHANNELD_SHUTTING_DOWN", "CLOSINGD_SIGEXCHANGE", "CLOSINGD_COMPLETE", "AWAITING_UNILATERAL", "FUNDING_SPEND_SEEN" or "ONCHAIN":
- short_channel_id (short_channel_id, optional): short channel id of channel (only if funding reached lockin depth before closing)
AUTHOR
Felix <fixone@gmail.com> is mainly responsible.
SEE ALSO
lightning-newaddr(7), lightning-fundchannel(7), lightning-withdraw(7), lightning-listtransactions(7)
RESOURCES
Main web site: https://github.com/ElementsProject/lightning