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 <[email protected]> is mainly responsible.

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:

{}