core-lightning/doc/schemas/lightning-askrene-reserve.json
Rusty Russell 48f50a26bf askrene: commit to API.
This does not mean it won't change, just that it will be backwards compatible.

Changelog-Added: Plugins: `askrene` which provides `getroutes` and a complete API for adding information in layers.
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2024-11-08 21:48:55 +10:30

62 lines
1.8 KiB
JSON

{
"$schema": "../rpc-schema-draft.json",
"type": "object",
"rpc": "askrene-reserve",
"title": "Command for informing askrene that you are trying a path",
"added": "v24.11",
"description": [
"The **askrene-reserve** RPC command tells askrene that a path is being attempted. This allows it to take that into account when other *getroutes* calls are made. You should call *askrene-unreserve* after the attempt has completed (and before calling *askrene-inform*).",
"",
"Note that additional properties inside the *path* elements are ignored, which is useful when used with the result of *getroutes*."
],
"request": {
"required": [
"path"
],
"additionalProperties": false,
"properties": {
"path": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"short_channel_id_dir",
"amount_msat"
],
"properties": {
"short_channel_id_dir": {
"type": "short_channel_id_dir",
"description": [
"The channel and direction joining these nodes."
]
},
"amount_msat": {
"type": "msat",
"description": [
"The amount to send into this hop."
]
}
}
}
}
}
},
"response": {
"required": [],
"additionalProperties": false,
"properties": {}
},
"see_also": [
"lightning-getroutes(7)",
"lightning-askrene-unreserve(7)",
"lightning-askrene-listreservations(7)"
],
"author": [
"Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible."
],
"resources": [
"Main web site: <https://github.com/ElementsProject/lightning>"
]
}