askrene-create-channel

lightning-askrene-create-channel -- Command to add a channel to layer

SYNOPSIS

askrene-create-channel layer source destination short_channel_id capacity_msat

DESCRIPTION

Command added in v24.11.

The askrene-create-channel RPC command tells askrene create a channel in the given layer. To actually populate the channel use askrene-update-channel in each direction.

  • layer (string): The name of the layer to apply this change to.
  • source (pubkey): The source node id for the channel.
  • destination (pubkey): The destination node id for the channel.
  • short_channel_id (short_channel_id): The short channel id for the channel. If a channel with this short channel id already exists in layer, the source, destination and capacity_msat must be the same.
  • capacity_msat (msat): The capacity (onchain size) of the channel.
    NOTE: this is in millisatoshis!

RETURN VALUE

On success, an empty object is returned.

AUTHOR

Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.

SEE ALSO

lightning-getroutes(7), lightning-askrene-disable-node(7), lightning-askrene-update-channel(7), lightning-askrene-inform-channel(7), lightning-askrene-listlayers(7), lightning-askrene-age(7)

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli askrene-create-channel -k "layer"="test_layers" "source"="nodeid030303030303030303030303030303030303030303030303030303030303" "destination"="nodeid010101010101010101010101010101010101010101010101010101010101" "short_channel_id"="0x0x1" "capacity_msat"="1000000sat"
{
  "id": "example:askrene-create-channel#1",
  "method": "askrene-create-channel",
  "params": {
    "layer": "test_layers",
    "source": "nodeid030303030303030303030303030303030303030303030303030303030303",
    "destination": "nodeid010101010101010101010101010101010101010101010101010101010101",
    "short_channel_id": "0x0x1",
    "capacity_msat": "1000000sat"
  }
}

Response:

{}