LIGHTNING-LISTCHANNELS(7) LIGHTNING-LISTCHANNELS(7) NAME listchannels -- Command to query active lightning channels in the entire network SYNOPSIS listchannels [short_channel_id] [source] [destination] DESCRIPTION The listchannels RPC command returns data on channels that are known to the node. Because channels may be bidirectional, up to 2 objects will be re- turned for each channel (one for each direction). Only one of short_channel_id, source or destination can be supplied. If nothing is supplied, data on all lightning channels known to this node, are returned. These can be local channels or public channels broadcast on the gossip network. * short_channel_id (short_channel_id, optional): If short_channel_id is a short channel id, then only known channels with a matching short_chan- nel_id are returned. Otherwise, it must be null. * source (pubkey, optional): If source is a node id, then only channels leading from that node id are returned. * destination (pubkey, optional): If destination is a node id, then only channels leading to that node id are returned. RETURN VALUE On success, an object containing channels is returned. It is an array of objects, where each object contains: * source (pubkey): The source node. * destination (pubkey): The destination node. * short_channel_id (short_channel_id): Short channel id of channel. * direction (u32): Direction (0 if source < destination, 1 otherwise). * public (boolean): True if this is announced (from v24.02, being false is deprecated). * amount_msat (msat): The total capacity of this channel (always a whole number of satoshis). * message_flags (u8): As defined by BOLT #7. * channel_flags (u8): As defined by BOLT #7. * active (boolean): True unless source has disabled it (or (deprecated in v24.02) it's a local channel and the peer is disconnected or it's still opening or closing). * last_update (u32): UNIX timestamp on the last channel_update from source. * base_fee_millisatoshi (u32): Base fee changed by source to use this channel. * fee_per_millionth (u32): Proportional fee changed by source to use this channel, in parts-per-million. * delay (u32): The number of blocks delay required by source to use this channel. * htlc_minimum_msat (msat): The smallest payment source will allow via this channel. * features (hex): BOLT #9 features bitmap for this channel. * htlc_maximum_msat (msat, optional): The largest payment source will al- low via this channel. If one of short_channel_id, source or destination is supplied and no match- ing channels are found, a 'channels' object with an empty list is returned. ERRORS On error the returned object will contain code and message properties, with code being one of the following: * -32602: If the given parameters are wrong. AUTHOR Michael Hawkins michael.hawkins@protonmail.com. SEE ALSO lightning-fundchannel(7), lightning-listnodes(7) RESOURCES Main web site: https://github.com/ElementsProject/lightning BOLT #7: https://github.com/lightning/bolts/blob/master/07-routing-gos- sip.md EXAMPLES Example 1: Request: $ lightning-cli listchannels -k "short_channel_id"="109x1x1" { "id": "example:listchannels#1", "method": "listchannels", "params": { "short_channel_id": "109x1x1" } } Response: { "channels": [ { "source": "nodeid020202020202020202020202020202020202020202020202020202020202", "destination": "nodeid010101010101010101010101010101010101010101010101010101010101", "short_channel_id": "109x1x1", "direction": 0, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 0, "active": true, "last_update": 1738500000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" }, { "source": "nodeid010101010101010101010101010101010101010101010101010101010101", "destination": "nodeid020202020202020202020202020202020202020202020202020202020202", "short_channel_id": "109x1x1", "direction": 1, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 1, "active": false, "last_update": 1738510000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" } ] } Example 2: Request: $ lightning-cli listchannels { "id": "example:listchannels#2", "method": "listchannels", "params": {} } Response: { "channels": [ { "source": "nodeid020202020202020202020202020202020202020202020202020202020202", "destination": "nodeid010101010101010101010101010101010101010101010101010101010101", "short_channel_id": "109x1x1", "direction": 0, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 0, "active": true, "last_update": 1738500000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" }, { "source": "nodeid010101010101010101010101010101010101010101010101010101010101", "destination": "nodeid020202020202020202020202020202020202020202020202020202020202", "short_channel_id": "109x1x1", "direction": 1, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 1, "active": false, "last_update": 1738510000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" }, { "source": "nodeid020202020202020202020202020202020202020202020202020202020202", "destination": "nodeid030303030303030303030303030303030303030303030303030303030303", "short_channel_id": "123x1x1", "direction": 0, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 2, "active": true, "last_update": 1738520000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" }, { "source": "nodeid030303030303030303030303030303030303030303030303030303030303", "destination": "nodeid020202020202020202020202020202020202020202020202020202020202", "short_channel_id": "123x1x1", "direction": 1, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 3, "active": false, "last_update": 1738530000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" }, { "source": "nodeid030303030303030303030303030303030303030303030303030303030303", "destination": "nodeid040404040404040404040404040404040404040404040404040404040404", "short_channel_id": "130x1x1", "direction": 0, "public": true, "amount_msat": 1000000000, "message_flags": 1, "channel_flags": 2, "active": true, "last_update": 1738540000, "base_fee_millisatoshi": 1, "fee_per_millionth": 10, "delay": 6, "htlc_minimum_msat": 0, "htlc_maximum_msat": 990000000, "features": "" } ] } Core Lightning v26.06.1 LIGHTNING-LISTCHANNELS(7)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | AUTHOR | SEE ALSO | RESOURCES | EXAMPLES
Want to link to this manual page? Use this URL:
<https://man.FreeBSD.org/cgi/man.cgi?query=lightning-listchannels&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>