NAME

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:

{}