home | help
LIGHTNING-ASKRENE-UPDATE-CHANNEL(7)	     LIGHTNING-ASKRENE-UPDATE-CHANNEL(7)

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

SYNOPSIS
     askrene-update-channel  layer  short_channel_id_dir  [enabled]  [htlc_mini-
     mum_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 di-
	rection.

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:

     {}

Core Lightning v26.06.1 		     LIGHTNING-ASKRENE-UPDATE-CHANNEL(7)

home | help