NAME

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.

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:

{}