LIGHTNING-ASKRENE-UPDATE-CHANNEL(7)

πŸ“¦
version 26.06.9 Β· 2 versions
, in nixpkgs unstable

πŸ’… LIGHTNING-ASKRENE-UPDATE-CHANNEL(7) πŸ’…

okay so bestie, welcome to the lightning-askrene-update-channel page β€” that's the manual name, yes it's a mouthful, we deal πŸ’– It's a lightning-askrene-update-channel command situation and honestly? iconic.


✨ NAME ✨

askrene-update-channel β€” the command that lets you manipulate channel in a layer. lowkey powerful, highkey useful 🫢


🌸 SYNOPSIS 🌸

askrene-update-channel layer short_channel_id_dir [enabled]
[htlc_minimum_msat] [htlc_maximum_msat] [fee_base_msat]
[fee_proportional_millionths] [cltv_expiry_delta]

that's it. that's the whole shape of it. very demure, very mindful πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

Command added in v24.11. so yeah, it's a newer one β€” vintage girlies stay mad 😌

The askrene-update-channel RPC command overrides updates for an existing channel when the layer is applied. it's giving "i know better than the gossip, trust me" energy ✨

  • layer (string) β€” the name of the layer to apply this change to πŸŽ€
  • short_channel_id_dir (short_channel_id_dir) β€” the channel and direction to apply the change to, bestie. direction matters, don't forget the direction πŸ’€
  • enabled (boolean, optional) β€” whether the channel is usable at all. like, on or off, dead or alive, that kind of vibe
  • htlc_minimum_msat (msat, optional) β€” the minimum value allowed in this direction πŸ“
  • htlc_maximum_msat (msat, optional) β€” the maximum value allowed in this direction. the ceiling. the limit. the cap πŸ’…
  • 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. ppm girlies rise πŸ™ˆ
  • cltv_expiry_delta (u16, optional) β€” the CLTV delay required for this direction ⏳

πŸ”₯ RETURN VALUE πŸ”₯

On success, an empty object is returned.

like literally just {}. nothing. silence. the void. and honestly? that's the flex 🌈


πŸ‘‘ AUTHOR πŸ‘‘

Rusty Russell rusty@rustcorp.com.au is mainly responsible. main character energy fr fr πŸ’œ


🧚 SEE ALSO 🧚

go read those too, iykyk πŸŽ€


⭐ RESOURCES ⭐

Main web site: https://github.com/ElementsProject/lightning β€” the mothership πŸš€


πŸ’– EXAMPLES πŸ’–

Example 1 πŸ¦‹

Request:

$ lightning-cli askrene-update-channel "test_layers" "0x0x1/0"
{
  "id": "example:askrene-update-channel#1",
  "method": "askrene-update-channel",
  "params": [
    "test_layers",
    "0x0x1/0"
  ]
}

Response:

{}

see? {}. slay πŸ’…


Example 2 πŸ“

Request:

$ lightning-cli askrene-update-channel -k "layer"="test_layers" "short_channel_id_dir"="0x0x1/0" "htlc_minimum_msat"=100 "htlc_maximum_msat"=900000000 "fee_base_msat"=1 "fee_proportional_millionths"=2 "cltv_expiry_delta"=18
{
  "id": "example:askrene-update-channel#2",
  "method": "askrene-update-channel",
  "params": {
    "layer": "test_layers",
    "short_channel_id_dir": "0x0x1/0",
    "htlc_minimum_msat": 100,
    "htlc_maximum_msat": 900000000,
    "fee_base_msat": 1,
    "fee_proportional_millionths": 2,
    "cltv_expiry_delta": 18
  }
}

Response:

{}

okay that's the whole thing, every flag, every default-free optional arg, all the fields, all the vibes 🫢


anyway bestie, this page is from Core Lightning v26.06.9 and yes we're citing it because credit is due β€” LIGHTNING-ASKRENE-UPDATE-CHANNEL(7), periodt. now go override some channels, you absolute icon πŸ‘‘πŸ’–

πŸ“¦ where this page comes from