NAME

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 <rusty@rustcorp.com.au> is mainly responsible.

SEE ALSO

lightning-getroutes(7), lightning-askrene-inform-channel(7), lightning-askrene-listlayers(7)

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
}