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 (boolean, optional): If True, then the outputs will include spent outputs in addition to the unspent ones. The 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", "immature")
- 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) (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", "DUALOPEND_OPEN_COMMITTED", "DUALOPEND_OPEN_COMMIT_READY"): The channel state, in particular CHANNELD_NORMAL means the channel can be used normally.
- channel_id (hash): The full channel_id (funding txid Xored with output number). (added v23.05)
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 <[email protected]> is mainly responsible.

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli listfunds

{
  "id": "example:listfunds#1",
  "method": "listfunds",
  "params": {}
}

Response:

{
  "outputs": [
    {
      "txid": "0f184b101569bf777af3449fa266948a9d55768f97867e48416a2c92858dd1bc",
      "output": 1,
      "amount_msat": 1111111000,
      "scriptpubkey": "001401fad90abcd66697e2592164722de4a95ebee165",
      "address": "bcrt1qq8adjz4u6enf0cjey9j8yt0y490tact93fzgsf",
      "status": "confirmed",
      "blockheight": 102,
      "reserved": false
    },
    {
      "txid": "4bee7dc3a28f2434e9bb3e9aaab418dd276485a8705b0f787bf741d3f979ec3b",
      "output": 1,
      "amount_msat": 1111111000,
      "scriptpubkey": "001401fad90abcd66697e2592164722de4a95ebee165",
      "address": "bcrt1qq8adjz4u6enf0cjey9j8yt0y490tact93fzgsf",
      "status": "confirmed",
      "blockheight": 102,
      "reserved": false
    }
  ],
  "channels": []
}