home | help 
LIGHTNING-ASKRENE-CREATE-CHANNEL(7)	     LIGHTNING-ASKRENE-CREATE-CHANNEL(7)

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

SYNOPSIS
     askrene-create-channel  layer  source  destination  short_channel_id capac-
     ity_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-chan-
     nel 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 (must be
	different from source).
     *	short_channel_id (short_channel_id): The short channel id for the  chan-
	nel.   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:

     {}

Core Lightning v26.06.1 		     LIGHTNING-ASKRENE-CREATE-CHANNEL(7)
home | help