mirror of https://github.com/ElementsProject/lightning.git synced 2024-11-20 02:27:51 +01:00

ShahanaFarooqui b0da807700 doc: Markdown cleanup

This commit will remove parameter descriptions from RPC markdown but we will fix it in next commits by reading these descriptions directly from json.

- Removing parameter description text
- Adding/removing newlines for cleaner formatting
- Adding ERRORS title wherever needed
- Updating titles for consistency
- Adding resources links

2024-03-19 14:58:59 +10:30

2.0 KiB

Raw Blame History

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

{
  "id": 82,
  "method": "help",
  "params": {}
}

RETURN VALUE

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)

ERRORS

On failure, one of the following error codes may be returned:

-32602: Error in given parameters.

EXAMPLE JSON RESPONSE

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

2.0 KiB Raw Blame History