lightning-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 <[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"="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 (previously c-lightning) is a lightweight, highly customizable and standard compliant implementation of the Lightning Network protocol.

© 2023 Core Lightning
All rights reserved.

Discussion Forum

The official Core Lightning forum is hosted at discuss.corelightning.org

BuildonL2 Community

The official BuildOnL2 community lives at community.corelightning.org. Join us and build the future of bitcoin on lightning.

Mailing List

For general discussions about CLN implementation, use [email protected]. For the Lightning Network, use [email protected]

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/w27fMFESMN to join.

Internet Relay Chat

Don't hesitate to reach out to us on IRC at #lightning-dev @ libera.chat, #c-lightning @ libera.chat.