.TH "LIGHTNING-LISTCONFIGS" "7" "" "" "lightning-listconfigs" .SH NAME lightning-listconfigs - Command to list all configuration options\. .SH SYNOPSIS \fBlistconfigs\fR [\fIconfig\fR] .SH DESCRIPTION \fIconfig\fR (optional) is a configuration option name, or "plugin" to show plugin options The \fBlistconfigs\fR RPC command to list all configuration options, or with \fIconfig\fR only a selection\. The returned values reflect the current configuration, including showing default values (\fBdev-\fR options are not shown)\. .SH EXAMPLE JSON REQUEST .nf .RS { "id": 82, "method": "listconfigs", "params": { "config": "network" } } .RE .fi .SH RETURN VALUE On success, an object is returned, containing: .RS .IP \[bu] \fB# version\fR (string, optional): Special field indicating the current version .IP \[bu] \fBplugins\fR (array of objects, optional): .RS .IP \[bu] \fBpath\fR (string): Full path of the plugin .IP \[bu] \fBname\fR (string): short name of the plugin .IP \[bu] \fBoptions\fR (object, optional): Specific options set for this plugin: .RE .IP \[bu] \fBimportant-plugins\fR (array of objects, optional): .RS .IP \[bu] \fBpath\fR (string): Full path of the plugin .IP \[bu] \fBname\fR (string): short name of the plugin .IP \[bu] \fBoptions\fR (object, optional): Specific options set for this plugin: .RE .IP \[bu] \fBconf\fR (string, optional): \fBconf\fR field from cmdline, or default .IP \[bu] \fBlightning-dir\fR (string, optional): \fBlightning-dir\fR field from config or cmdline, or default .IP \[bu] \fBnetwork\fR (string, optional): \fBnetwork\fR field from config or cmdline, or default .IP \[bu] \fBallow-deprecated-apis\fR (boolean, optional): \fBallow-deprecated-apis\fR field from config or cmdline, or default .IP \[bu] \fBrpc-file\fR (string, optional): \fBrpc-file\fR field from config or cmdline, or default .IP \[bu] \fBdisable-plugin\fR (array of strings, optional): .RS .IP \[bu] \fBdisable-plugin\fR field from config or cmdline .RE .IP \[bu] \fBalways-use-proxy\fR (boolean, optional): \fBalways-use-proxy\fR field from config or cmdline, or default .IP \[bu] \fBdaemon\fR (boolean, optional): \fBdaemon\fR field from config or cmdline, or default .IP \[bu] \fBwallet\fR (string, optional): \fBwallet\fR field from config or cmdline, or default .IP \[bu] \fBlarge-channels\fR (boolean, optional): \fBlarge-channels\fR field from config or cmdline, or default .IP \[bu] \fBexperimental-dual-fund\fR (boolean, optional): \fBexperimental-dual-fund\fR field from config or cmdline, or default .IP \[bu] \fBexperimental-onion-messages\fR (boolean, optional): \fBexperimental-onion-messages\fR field from config or cmdline, or default .IP \[bu] \fBexperimental-offers\fR (boolean, optional): \fBexperimental-offers\fR field from config or cmdline, or default .IP \[bu] \fBexperimental-shutdown-wrong-funding\fR (boolean, optional): \fBexperimental-shutdown-wrong-funding\fR field from config or cmdline, or default .IP \[bu] \fBexperimental-websocket-port\fR (u16, optional): \fBexperimental-websocket-port\fR field from config or cmdline, or default .IP \[bu] \fBrgb\fR (hex, optional): \fBrgb\fR field from config or cmdline, or default (always 6 characters) .IP \[bu] \fBalias\fR (string, optional): \fBalias\fR field from config or cmdline, or default .IP \[bu] \fBpid-file\fR (string, optional): \fBpid-file\fR field from config or cmdline, or default .IP \[bu] \fBignore-fee-limits\fR (boolean, optional): \fBignore-fee-limits\fR field from config or cmdline, or default .IP \[bu] \fBwatchtime-blocks\fR (u32, optional): \fBwatchtime-blocks\fR field from config or cmdline, or default .IP \[bu] \fBmax-locktime-blocks\fR (u32, optional): \fBmax-locktime-blocks\fR field from config or cmdline, or default .IP \[bu] \fBfunding-confirms\fR (u32, optional): \fBfunding-confirms\fR field from config or cmdline, or default .IP \[bu] \fBcltv-delta\fR (u32, optional): \fBcltv-delta\fR field from config or cmdline, or default .IP \[bu] \fBcltv-final\fR (u32, optional): \fBcltv-final\fR field from config or cmdline, or default .IP \[bu] \fBcommit-time\fR (u32, optional): \fBcommit-time\fR field from config or cmdline, or default .IP \[bu] \fBfee-base\fR (u32, optional): \fBfee-base\fR field from config or cmdline, or default .IP \[bu] \fBrescan\fR (integer, optional): \fBrescan\fR field from config or cmdline, or default .IP \[bu] \fBfee-per-satoshi\fR (u32, optional): \fBfee-per-satoshi\fR field from config or cmdline, or default .IP \[bu] \fBmax-concurrent-htlcs\fR (u32, optional): \fBmax-concurrent-htlcs\fR field from config or cmdline, or default .IP \[bu] \fBhtlc-minimum-msat\fR (msat, optional): \fBhtlc-minimum-msat\fR field from config or cmdline, or default .IP \[bu] \fBhtlc-maximum-msat\fR (msat, optional): \fBhtlc-maximum-msat\fR field from config or cmdline, or default .IP \[bu] \fBmax-dust-htlc-exposure-msat\fR (msat, optional): \fBmax-dust-htlc-exposure-mast\fR field from config or cmdline, or default .IP \[bu] \fBmin-capacity-sat\fR (u64, optional): \fBmin-capacity-sat\fR field from config or cmdline, or default .IP \[bu] \fBaddr\fR (string, optional): \fBaddr\fR field from config or cmdline (can be more than one) .IP \[bu] \fBannounce-addr\fR (string, optional): \fBannounce-addr\fR field from config or cmdline (can be more than one) .IP \[bu] \fBbind-addr\fR (string, optional): \fBbind-addr\fR field from config or cmdline (can be more than one) .IP \[bu] \fBoffline\fR (boolean, optional): \fBtrue\fR if \fBoffline\fR was set in config or cmdline .IP \[bu] \fBautolisten\fR (boolean, optional): \fBautolisten\fR field from config or cmdline, or default .IP \[bu] \fBproxy\fR (string, optional): \fBproxy\fR field from config or cmdline, or default .IP \[bu] \fBdisable-dns\fR (boolean, optional): \fBtrue\fR if \fBdisable-dns\fR was set in config or cmdline .IP \[bu] \fBdisable-ip-discovery\fR (boolean, optional): \fBtrue\fR if \fBdisable-ip-discovery\fR was set in config or cmdline .IP \[bu] \fBencrypted-hsm\fR (boolean, optional): \fBtrue\fR if \fBencrypted-hsm\fR was set in config or cmdline .IP \[bu] \fBrpc-file-mode\fR (string, optional): \fBrpc-file-mode\fR field from config or cmdline, or default .IP \[bu] \fBlog-level\fR (string, optional): \fBlog-level\fR field from config or cmdline, or default .IP \[bu] \fBlog-prefix\fR (string, optional): \fBlog-prefix\fR field from config or cmdline, or default .IP \[bu] \fBlog-file\fR (string, optional): \fBlog-file\fR field from config or cmdline, or default .IP \[bu] \fBlog-timestamps\fR (boolean, optional): \fBlog-timestamps\fR field from config or cmdline, or default .IP \[bu] \fBforce-feerates\fR (string, optional): force-feerate configuration setting, if any .IP \[bu] \fBsubdaemon\fR (string, optional): \fBsubdaemon\fR fields from config or cmdline if any (can be more than one) .IP \[bu] \fBfetchinvoice-noconnect\fR (boolean, optional): \fBfeatchinvoice-noconnect\fR fileds from config or cmdline, or default .IP \[bu] \fBtor-service-password\fR (string, optional): \fBtor-service-password\fR field from config or cmdline, if any .RE On failure, one of the following error codes may be returned: .RS .IP \[bu] -32602: Error in given parameters or field with \fIconfig\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", "encrypted-hsm": false, "rpc-file-mode": "0600", "log-level": "DEBUG", "log-prefix": "lightningd", } .RE .fi .SH AUTHOR Vincenzo Palazzo \fI wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command\. .SH SEE ALSO \fBlightning-getinfo\fR(7), \fBlightningd-config\fR(5) .SH RESOURCES Main web site: \fIhttps://github.com/ElementsProject/lightning\fR \" SHA256STAMP:7ac9ef3477f64fd3a4181cb27b8810ecf2c1a082688180716adfe79843ab09aa