LIGHTNING-ASKRENE-CREATE-CHANNEL(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💅 LIGHTNING-ASKRENE-CREATE-CHANNEL(7) — askrene-create-channel

okay so bestie, listen: askrene-create-channel is an RPC command from the lightning-askrene-create-channel manual page, and it's literally the glow-up your layer needs. It adds a channel to a layer, that's the whole vibe ✨

🌸 SYNOPSIS 🌸

askrene-create-channel layer source destination short_channel_id
capacity_msat

🎀 DESCRIPTION 🎀

okay so this command was added in v24.11 — vintage, iconic, we love her 💖

The askrene-create-channel RPC command tells askrene to create a channel in the given layer. But heeere's the thing — creating it is only step one, bestie. To actually populate the channel, you gotta use askrene-update-channel in each direction. Yes, both. Go both ways, it's giving bidirectional main character energy 🦋

  • layer (string) — the name of the layer you're applying this change to. Pick your layer, claim your layer 👑
  • source (pubkey) — the source node id for the channel
  • destination (pubkey) — the destination node id for the channel. Must be different from source — no, you cannot be your own destination, that's not the vibe okay 🙈
  • 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, then the source, destination and capacity_msat must be the same. consistency is the moment, no cap 💅
  • capacity_msat (msat) — the capacity (onchain size) of the channel. NOTE: this is in millisatoshis! not sats, not BTC, millisatoshis. I cannot stress this enough, bestie 😭

⭐ RETURN VALUE ⭐

On success, an empty object is returned.

that's it. {}. the emptiest little slay, and honestly? it ate 🌈

💜 AUTHOR 💜

Rusty Russell rusty@rustcorp.com.au is mainly responsible. 🫶 legend behavior, fr fr.

👑 SEE ALSO 👑

all of them, in that order, the whole friend group 💕

🧚 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:

{}

okay that's the whole page, bestie, you're officially educated 💅✨ this lil rewrite is serving Core Lightning v26.06.9 — go forth and populate those channels in both directions, mwah 🫶💖

📦 where this page comes from