lightning-askrene-age -- Command for expiring information in a layer

SYNOPSIS

askrene-age layer cutoff

DESCRIPTION

Command added in v24.11.

The askrene-age RPC command tells askrene that information added to a layer by askrene-inform-channel beyond a certain age is less useful. It currently completely forgets constraints older than cutoff.

layer (string): The name of the layer to apply this change to.
cutoff (u64): The UNIX timestamp: constraints older than this will be forgotten.

RETURN VALUE

On success, an object is returned, containing:

layer (string): The layer parameter provided.
num_removed (u64): The number of constraints removed from layer

AUTHOR

Rusty Russell <[email protected]> is mainly responsible.

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli askrene-age -k "layer"="test_layers" "cutoff"=1738000000

{
  "id": "example:askrene-age#1",
  "method": "askrene-age",
  "params": {
    "layer": "test_layers",
    "cutoff": 1738000000
  }
}

Response:

{
  "layer": "test_layers",
  "num_removed": 1
}