lightning-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 useful 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.

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:

{}