2020-08-31 14:42:28 +02:00
.TH "LIGHTNING-LISTCONFIGS" "7" "" "" "lightning-listconfigs"
.SH NAME
lightning-listconfigs - Command to list all configuration options\.
.SH SYNOPSIS
\fB listconfigs\fR [config]
.SH DESCRIPTION
2020-09-07 12:46:28 +02:00
The \fB listconfigs\fR RPC command to list all configuration options, or with \fI config\fR , just that one\.
2020-08-31 14:42:28 +02:00
.SH EXAMPLE JSON REQUEST
.nf
.RS
{
"id": 82,
"method": "listconfigs",
2020-09-04 21:07:19 +02:00
"params": {
"config": "network"
}
2020-08-31 14:42:28 +02:00
}
.RE
.fi
.SH RETURN VALUE
2020-09-07 12:46:28 +02:00
On success, an object is returned with members reflecting the
corresponding \fB lightningd-config\fR (5) options which were specified in
the configuration file(s) and command line\.
Additional members include:
2020-08-31 14:42:28 +02:00
.RS
.IP \[ bu]
2020-09-07 12:46:28 +02:00
\fI # version\fR : A string that represents the version of node\.
2020-08-31 14:42:28 +02:00
.IP \[ bu]
2021-05-26 07:41:01 +02:00
\fI plugins\fR : A array that represents the non-important plugin registered\. Each object contains the following members:
.RS
2020-08-31 14:42:28 +02:00
.IP \[ bu]
2020-09-07 12:46:28 +02:00
\fI path\fR : A string that represents the path of plugin\.
2020-08-31 14:42:28 +02:00
.IP \[ bu]
2020-09-07 12:46:28 +02:00
\fI name\fR : A string that represents the name of plugin\.
2020-08-31 14:42:28 +02:00
.IP \[ bu]
2020-09-07 12:46:28 +02:00
\fI options\fR : A object that contains all options accepted from command line or configuration file, if the plugin has opitions
2020-08-31 14:42:28 +02:00
.RE
.IP \[ bu]
2020-09-07 12:46:28 +02:00
\fI important-plugins\fR : An array that represents all important plugins registered to the node\. Each object contains the same members as the \fI plugin\fR array\.
2020-08-31 14:42:28 +02:00
2020-09-04 21:07:19 +02:00
.RE
2020-08-31 14:42:28 +02:00
2020-09-04 21:07:19 +02:00
On failure, one of the following error codes may be returned:
2020-08-31 14:42:28 +02:00
2020-09-04 21:07:19 +02:00
.RS
2020-08-31 14:42:28 +02:00
.IP \[ bu]
-32602: Error in given parameters or field with \fI config\fR name doesn't exist\.
.RE
.SH EXAMPLE JSON RESPONSE
.nf
.RS
{
"# version": "v0.9.0-1",
"lightning-dir": "/media/vincent/Maxtor/sanboxTestWrapperRPC/lightning_dir_dev",
"network": "testnet",
"allow-deprecated-apis": true,
"rpc-file": "lightning-rpc",
"plugins": [
{
"path": "/home/vincent/Github/plugins/sauron/sauron.py",
"name": "sauron.py",
"options": {
"sauron-api-endpoint": "http://blockstream.info/testnet/api/",
"sauron-tor-proxy": ""
}
},
{
"path": "/home/vincent/Github/reckless/reckless.py",
"name": "reckless.py"
}
],
"important-plugins": [
{
"path": "/home/vincent/Github/lightning/lightningd/../plugins/autoclean",
"name": "autoclean",
"options": {
"autocleaninvoice-cycle": null,
"autocleaninvoice-expired-by": null
}
},
{
"path": "/home/vincent/Github/lightning/lightningd/../plugins/fundchannel",
"name": "fundchannel"
},
{
"path": "/home/vincent/Github/lightning/lightningd/../plugins/keysend",
"name": "keysend"
},
{
"path": "/home/vincent/Github/lightning/lightningd/../plugins/pay",
"name": "pay",
"options": {
"disable-mpp": false
}
}
],
"important-plugin": "/home/vincent/Github/lightning/lightningd/../plugins/autoclean",
"important-plugin": "/home/vincent/Github/lightning/lightningd/../plugins/fundchannel",
"important-plugin": "/home/vincent/Github/lightning/lightningd/../plugins/keysend",
"important-plugin": "/home/vincent/Github/lightning/lightningd/../plugins/pay",
"plugin": "/home/vincent/Github/plugins/sauron/sauron.py",
"plugin": "/home/vincent/Github/reckless/reckless.py",
"disable-plugin": [
"bcli"
],
"always-use-proxy": false,
"daemon": "false",
"wallet": "sqlite3:///media/vincent/Maxtor/sanboxTestWrapperRPC/lightning_dir_dev/testnet/lightningd.sqlite3",
"wumbo": false,
"wumbo": false,
"rgb": "03ad98",
"alias": "BRUCEWAYN-TES-DEV",
"pid-file": "/media/vincent/Maxtor/sanboxTestWrapperRPC/lightning_dir_dev/lightningd-testne...",
"ignore-fee-limits": true,
"watchtime-blocks": 6,
"max-locktime-blocks": 2016,
"funding-confirms": 1,
"commit-fee-min": 0,
"commit-fee-max": 0,
"cltv-delta": 6,
"cltv-final": 10,
"commit-time": 10,
"fee-base": 1,
"rescan": 30,
"fee-per-satoshi": 10,
"max-concurrent-htlcs": 483,
"min-capacity-sat": 10000,
"addr": "autotor:127.0.0.1:9051",
"bind-addr": "127.0.0.1:9735",
"announce-addr": "fp463inc4w3lamhhduytrwdwq6q6uzugtaeapylqfc43agrdnnqsheyd.onion:9735",
"offline": "false",
"autolisten": true,
"proxy": "127.0.0.1:9050",
"disable-dns": "false",
"enable-autotor-v2-mode": "false",
"encrypted-hsm": false,
"rpc-file-mode": "0600",
"log-level": "DEBUG",
"log-prefix": "lightningd",
}
.RE
.fi
.SH AUTHOR
Vincenzo Palazzo \fI <vincenzo.palazzo@protonmail.com\fR > wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command\.
.SH SEE ALSO
2020-09-07 12:46:28 +02:00
\fB lightning-getinfo\fR (7), \fB lightningd-config\fR (5)
2020-08-31 14:42:28 +02:00
.SH RESOURCES
Main web site: \fI https://github.com/ElementsProject/lightning\fR
2020-09-07 12:46:28 +02:00
\" SHA256STAMP:19542af1d9c13e31ec6fada46f85a080433c2c7a863779a8b9e3ac86a5903b48