mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-20 02:27:51 +01:00
6e636a835f
1. listpeers has a deprecated `"closer": null`, which we need to handle in the schema, while trying not to damage our documentation too much. 2. Don't print a condition if there are no fields to print. 3. Allow a special "untyped" marker for multifundchannel which returns arbitrary JSON in a field. 4. Allow a single field return (for 'stop'). Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
70 lines
2.0 KiB
Markdown
70 lines
2.0 KiB
Markdown
lightning-help -- Command to return all information about RPC commands.
|
|
=======================================================================
|
|
|
|
SYNOPSIS
|
|
--------
|
|
|
|
**help** \[*command\*]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
The **help** is a RPC command which is possible consult all information about the RPC commands, or a specific command if *command* is given.
|
|
|
|
Note that the lightning-cli(1) tool will prefer to list a man page when a
|
|
specific *command* is specified, and will only return the JSON if the man
|
|
page is not found.
|
|
|
|
EXAMPLE JSON REQUEST
|
|
--------------------
|
|
```json
|
|
{
|
|
"id": 82,
|
|
"method": "help",
|
|
"params": {}
|
|
}
|
|
```
|
|
|
|
RETURN VALUE
|
|
------------
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
On success, an object is returned, containing:
|
|
- **help** (array of objects):
|
|
- **command** (string): the command
|
|
- **category** (string): the category for this command (useful for grouping)
|
|
- **description** (string): a one-line description of the purpose of this command
|
|
- **verbose** (string): a full description of this command (including whether it's deprecated)
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
On failure, one of the following error codes may be returned:
|
|
|
|
- -32602: Error in given parameters.
|
|
|
|
EXAMPLE JSON RESPONSE
|
|
---------------------
|
|
|
|
```json
|
|
{
|
|
"help": [
|
|
{
|
|
"command": "autocleaninvoice [cycle_seconds] [expired_by]",
|
|
"category": "plugin",
|
|
"description": "Set up autoclean of expired invoices. ",
|
|
"verbose": "Perform cleanup every {cycle_seconds} (default 3600), or disable autoclean if 0. Clean up expired invoices that have expired for {expired_by} seconds (default 86400). "
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
AUTHOR
|
|
------
|
|
|
|
Vincenzo Palazzo <<vincenzo.palazzo@protonmail.com>> wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command.
|
|
|
|
RESOURCES
|
|
---------
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
[comment]: # ( SHA256STAMP:89fb5e6d1f3127f8a4331fb00756871565c10e874a24554c60fa1a0e26ca5c8f)
|