askrene-create-channel

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 (must be different from source).
  • 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.

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"="03cecbfdc68544cc596223b68ce0710c9e5d2c9cb317ee07822d95079acc703d31" "destination"="038194b5f32bdf0aa59812c86c4ef7ad2f294104fa027d1ace9b469bb6f88cf37b" "short_channel_id"="0x0x1" "capacity_msat"="1000000sat"
{
  "id": "example:askrene-create-channel#1",
  "method": "askrene-create-channel",
  "params": {
    "layer": "test_layers",
    "source": "03cecbfdc68544cc596223b68ce0710c9e5d2c9cb317ee07822d95079acc703d31",
    "destination": "038194b5f32bdf0aa59812c86c4ef7ad2f294104fa027d1ace9b469bb6f88cf37b",
    "short_channel_id": "0x0x1",
    "capacity_msat": "1000000sat"
  }
}

Response:

{}

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2026 Core Lightning, a Blockstream project.
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.