LIGHTNING-ASKRENE-CREATE-LAYER(7)

💅 LIGHTNING-ASKRENE-CREATE-LAYER(7)

hiii bestie 🫶 welcome to the manual page for lightning-askrene-create-layer, which lives in section 7 of the Lightning manual — and honestly? it's one of the easy ones. no cap. let's get into it ✨

---

🌸 NAME

askrene-create-layer — the command that creates a brand new layer 🎀

---

🦋 SYNOPSIS

askrene-create-layer layer [persistent]

---

✨ DESCRIPTION

okay so first thing's first: this command was added in v24.11. noted, timestamped, iconic. 📌

The askrene-create-layer RPC command tells askrene to create a new, empty layer. then you can populate that layer with askrene-create-channel and askrene-inform-channel, and use it in getroutes. it's giving blank canvas, main character energy 🎨

• layer (string) — the name of the layer to create. pick something cute, you're gonna be typing it a lot.
• persistent (boolean, optional) — True if askrene should save and restore this layer. and lowkey, as a side-effect, create-layer also succeeds if the layer already exists and persistent is true (so no error drama if you double-create it 💀). The default is False.

---

👑 RETURN VALUE

On success, an object containing layers is returned. It is an array of objects, where each object contains:

• layer (string) — the name of the layer.
• persistent (boolean) — whether the layer is saved/restored across restarts.
• disabled_nodes (array of pubkeys):
  • (pubkey, optional) — the id of the disabled node.
• created_channels (array of objects):
  • 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.
  • capacity_msat (msat) — the capacity (onchain size) of the channel.
• channel_updates (array of objects):
  • htlc_minimum_msat (msat, optional) — the minimum value allowed in this direction.
  • htlc_maximum_msat (msat, optional) — the maximum value allowed in this direction.
  • fee_base_msat (msat, optional) — the base fee to apply to use the channel in this direction.
  • fee_proportional_millionths (u32, optional) — the proportional fee (in parts per million) to apply to use the channel in this direction.
  • delay (u16, optional) — the CLTV delay required for this direction.
• constraints (array of objects):
  • short_channel_id (short_channel_id) — the short channel id.
  • direction (u32) — the direction.
  • maximum_msat (msat, optional) — the maximum value which this channel could pass. This or minimum_msat will be present, but not both.
  • minimum_msat (msat, optional) — the minimum value which this channel could pass. This or minimum_msat will be present, but not both.
• disabled_channels (array of short_channel_id_dirs, optional):
  • (short_channel_id_dir, optional) — the channel and direction which is disabled.
• biases (array of objects, optional):
  • short_channel_id_dir (short_channel_id_dir) — the short channel id and direction
  • bias (integer) — the bias (-100 to +100)
  • timestamp (u64) — the UNIX timestamp when this bias was created. (added v25.12)
  • description (string, optional) — description/annotation to display in askrene-listlayers(7)
• node_biases (array of objects, optional) (added v25.12):
  • node (pubkey) — the id of the biased node. (added v25.12)
  • in_bias (integer) — the bias (-100 to +100) on incoming channels. (added v25.12)
  • out_bias (integer) — the bias (-100 to +100) on outgoing channels. (added v25.12)
  • timestamp (u64) — the UNIX timestamp when this bias was created or last updated. (added v25.12)
  • description (string, optional) — a human readable annotation. (added v25.12)

---

🫶 AUTHOR

Rusty Russell rusty@rustcorp.com.au is mainly responsible. ty king 👑

---

🔥 SEE ALSO

• lightning-askrene-remove-layer(7)
• lightning-getroutes(7)
• lightning-askrene-create-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-layer -k "layer"="test_layers"

{
  "id": "example:askrene-create-layer#1",
  "method": "askrene-create-layer",
  "params": {
    "layer": "test_layers"
  }
}

Response:

{
  "layers": [
    {
      "layer": "test_layers",
      "persistent": false,
      "disabled_nodes": [],
      "created_channels": [],
      "channel_updates": [],
      "constraints": [],
      "biases": [],
      "node_biases": []
    }
  ]
}

look at all those empty arrays — a freshly created layer is literally a clean slate bestie, so go fill it up 🧚

---

and that's the whole page!! 💖 this little number ships with Core Lightning v26.06.9, so like… go forth and create layers, you've got this 🌟