mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-02-23 15:00:34 +01:00
101 lines
2.7 KiB
JSON
101 lines
2.7 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>"
|
|
],
|
|
"examples": [
|
|
{
|
|
"request": {
|
|
"id": "example:askrene-reserve#1",
|
|
"method": "askrene-reserve",
|
|
"params": {
|
|
"path": [
|
|
{
|
|
"short_channel_id_dir": "109x1x1/1",
|
|
"amount_msat": 1250000
|
|
},
|
|
{
|
|
"short_channel_id_dir": "123x1x1/0",
|
|
"amount_msat": 1250001
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"response": {}
|
|
},
|
|
{
|
|
"request": {
|
|
"id": "example:askrene-reserve#2",
|
|
"method": "askrene-reserve",
|
|
"params": {
|
|
"path": [
|
|
{
|
|
"short_channel_id_dir": "109x1x1/1",
|
|
"amount_msat": 1250000000000
|
|
},
|
|
{
|
|
"short_channel_id_dir": "123x1x1/0",
|
|
"amount_msat": 1250000000000
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"response": {}
|
|
}
|
|
]
|
|
}
|