NAME

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:

{}