home | help
LIGHTNING-ASKRENE-DISABLE-NODE(7)	       LIGHTNING-ASKRENE-DISABLE-NODE(7)

NAME
     askrene-disable-node -- Command to disable all channels to/from a node in a
     layer

SYNOPSIS
     askrene-disable-node layer node

DESCRIPTION
     Command added in v24.11.

     The  askrene-disable-node RPC command tells askrene to disable all channels
     connected to a node whenever the given layer is used.  This is mainly  use-
     ful  to  force the use of alternate paths: while individual channels can be
     disabled using askrene-create-channel or askrene-inform-channel, that would
     be racy if new channels appeared.

     *	layer (string): The name of the layer to apply this change to.
     *	node (pubkey): The node to disable.  It does not need to exist.

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),   lightning-
     askrene-inform-channel(7),    lightning-askrene-listlayers(7),   lightning-
     askrene-age(7)

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

EXAMPLES
     Example 1:

     Request:

     $ lightning-cli askrene-disable-node -k "layer"="test_layers" "node"="nodeid010101010101010101010101010101010101010101010101010101010101"

     {
       "id": "example:askrene-disable-node#1",
       "method": "askrene-disable-node",
       "params": {
	 "layer": "test_layers",
	 "node": "nodeid010101010101010101010101010101010101010101010101010101010101"
       }
     }

     Response:

     {}

Core Lightning v26.06.1 		       LIGHTNING-ASKRENE-DISABLE-NODE(7)

home | help