askrene-disable-node

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 <[email protected]> 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 is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2023 Core Lightning
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.