askrene-listreservations

lightning-askrene-listreservations -- Command to display information about reservations

SYNOPSIS

askrene-listreservations

DESCRIPTION

Command added in v24.11.

The askrene-reservations RPC command reports outstanding reservations made with askrene-reserve, mainly for debugging.

RETURN VALUE

On success, an object containing reservations is returned. It is an array of objects, where each object contains:

  • short_channel_id_dir (short_channel_id_dir): The channel and direction that is reserved.
  • amount_msat (msat): The amount reserved.
  • age_in_seconds (u64): The age of this reservation.
  • command_id (string): The JSON id of the command used to make the reservation.

AUTHOR

Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.

SEE ALSO

lightning-askrene-reserve(7), lightning-askrene-unreserve(7)

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli askrene-listreservations
{
  "id": "example:askrene-listreservations#1",
  "method": "askrene-listreservations",
  "params": {}
}

Response:

{
  "reservations": [
    {
      "short_channel_id_dir": "109x1x1/1",
      "amount_msat": 1250000,
      "age_in_seconds": 2,
      "command_id": "\"-c:askrene-reserve#62/cln:askrene-reserve#122\""
    },
    {
      "short_channel_id_dir": "123x1x1/0",
      "amount_msat": 1250001,
      "age_in_seconds": 2,
      "command_id": "\"-c:askrene-reserve#62/cln:askrene-reserve#122\""
    },
    {
      "short_channel_id_dir": "109x1x1/1",
      "amount_msat": 1250000000000,
      "age_in_seconds": 2,
      "command_id": "\"-c:askrene-reserve#66/cln:askrene-reserve#126\""
    },
    {
      "short_channel_id_dir": "123x1x1/0",
      "amount_msat": 1250000000000,
      "age_in_seconds": 2,
      "command_id": "\"-c:askrene-reserve#66/cln:askrene-reserve#126\""
    }
  ]
}