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 <rusty@rustcorp.com.au> 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:

{}