2021-08-25 04:50:12 +02:00
|
|
|
lightning-listdatastore -- Command for listing (plugin) data
|
|
|
|
|
============================================================
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
**listdatastore** [*key*]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
The **listdatastore** RPC command allows plugins to fetch data which was
|
|
|
|
|
stored in the c-lightning database.
|
|
|
|
|
|
2021-08-25 04:51:34 +02:00
|
|
|
All immediate children of the *key* (or root children) are returned:
|
|
|
|
|
a *key* with children won't have a *hex* or *generation* entry.
|
2021-08-25 04:50:12 +02:00
|
|
|
|
|
|
|
|
RETURN VALUE
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
|
|
|
On success, an object containing **datastore** is returned. It is an array of objects, where each object contains:
|
2021-08-25 04:51:34 +02:00
|
|
|
- **key** (array of strings):
|
|
|
|
|
- Part of the key added to the datastore
|
|
|
|
|
- **generation** (u64, optional): The number of times this has been updated
|
|
|
|
|
- **hex** (hex, optional): The hex data from the datastore
|
2021-08-25 04:50:13 +02:00
|
|
|
- **string** (string, optional): The data as a string, if it's valid utf-8
|
2021-09-03 12:07:59 +02:00
|
|
|
|
2021-08-25 04:50:12 +02:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
|
|
|
|
|
|
The following error codes may occur:
|
|
|
|
|
- -32602: invalid parameters.
|
|
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
lightning-datastore(7), lightning-deldatastore(7)
|
|
|
|
|
|
|
|
|
|
RESOURCES
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
|
|
|
|
2021-09-03 12:07:59 +02:00
|
|
|
[comment]: # ( SHA256STAMP:052a5b86380b78fe292fae2f0378b4bd3d200f838a6ad36e0ee8bed619cb9d1c)
|
