NAME

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\""


    }


  ]
}