lightning-askrene-update-channel

lightning-askrene-update-channel -- Command to manipulate channel in a layer

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]

DESCRIPTION

Command added in v24.11.

The askrene-update-channel RPC command overrides updates for an existing channel when the layer is applied.

  • 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.
  • enabled (boolean, optional): Whether the channel is usable at all.
  • 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.
  • cltv_expiry_delta (u16, optional): The CLTV delay required for this direction.

RETURN VALUE

On success, an empty object is returned.

AUTHOR

Rusty Russell <[email protected]> is mainly responsible.

SEE ALSO

lightning-getroutes(7), lightning-askrene-create-channel(7)

RESOURCES

Main web site: https://github.com/ElementsProject/lightning

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:

{}

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:

{}

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.