LIGHTNING-LISTCONFIGS(7)

πŸ“¦
version 26.06.9 Β· 2 versions
, in nixpkgs unstable

✨ NAME ✨

okay so this is LIGHTNING-LISTCONFIGS(7), the manual page for listconfigs β€” the command that lists all your configuration options. all of them, bestie. πŸ’…

πŸŽ€ SYNOPSIS πŸŽ€

listconfigs [config]

🌸 DESCRIPTION 🌸

The listconfigs RPC command lists all configuration options β€” or, if you pass config, just that one. slay.

  • config (string, optional): Configuration option name to restrict return. iykyk.

πŸ’– RETURN VALUE πŸ’–

The returned values reflect the current configuration, including showing default values. Heads up though: dev- options are not shown unless specified as config explicitly.

bestie pls remember: since plugins can add options, not all configuration settings are listed here! The format of each entry is as follows:
  • source (string): source of configuration setting (file:linenum)
  • dynamic (boolean, optional): true if this option is settable via setconfig
  • plugin (string, optional): set if this is from a plugin

Depending on the option type, exactly one of the following is present:

  • set (boolean, optional): for simple flag options
  • value_str (string, optional): for string options
  • value_msat (msat, optional): for msat options
  • value_int (integer, optional): for integer options
  • value_bool (boolean, optional): for boolean options

On success, an object containing configs is returned. It is an object containing:

okay bestie, here is the full key-by-key rundown β€” not skipping a single one, because we don’t do that here πŸ’…

  • conf (object, optional):
    • value_str (string): Field from cmdline.
    • source (string) (always "cmdline"): Source of configuration setting.
  • developer (object, optional) (added v23.08):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • clear-plugins (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • disable-mpp (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
    • plugin (string, optional): Plugin which registered this configuration setting.
  • mainnet (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • regtest (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • signet (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • testnet (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • important-plugin (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • plugin (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • plugin-dir (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • lightning-dir (object, optional):
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • network (object, optional):
    • value_str (string): Field from config or cmdline, or default (can also be changed by testnet, signet, regtest options!).
    • source (string): Source of configuration setting.
  • allow-deprecated-apis (object, optional):
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • rpc-file (object, optional):
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • disable-plugin (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • always-use-proxy (object, optional):
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • daemon (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • wallet (object, optional):
    • value_str (string): Always ... (the value is concealed).
    • source (string): Source of configuration setting.
  • large-channels (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • experimental-dual-fund (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • experimental-splicing (object, optional) deprecated in v26.04, removed after v27.04 (added v23.08):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • experimental-shutdown-wrong-funding (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • experimental-peer-storage (object, optional) (added v23.02):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • experimental-anchors (object, optional) (added v23.08):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • database-upgrade (object, optional):
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • rgb (object, optional):
    • value_str (hex) (always 6 characters): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • alias (object, optional):
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • pid-file (object, optional):
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • ignore-fee-limits (object, optional):
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • watchtime-blocks (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • funding-confirms (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • cltv-delta (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • cltv-final (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • commit-time (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • fee-base (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • rescan (object, optional):
    • value_int (integer): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • fee-per-satoshi (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • max-concurrent-htlcs (object, optional):
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • htlc-minimum-msat (object, optional):
    • value_msat (msat): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • htlc-maximum-msat (object, optional):
    • value_msat (msat): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • max-dust-htlc-exposure-msat (object, optional):
    • value_msat (msat): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • min-capacity-sat (object, optional):
    • value_int (u64): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
    • dynamic (boolean, optional) (always true): Can this be set by setconfig().
  • addr (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • announce-addr (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • bind-addr (object, optional):
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • offline (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • autolisten (object, optional):
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • proxy (object, optional):
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • disable-dns (object, optional):
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • announce-addr-discovered (object, optional) (added v23.02):
    • value_str (string) (one of "true", "false", "auto"): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • announce-addr-discovered-port (object, optional) (added v23.02) ✨ β€” the port we announce when we auto-discover our address, bestie:
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • encrypted-hsm (object, optional) πŸ” β€” whether the hsm_secret is encrypted:
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
  • rpc-file-mode (object, optional) πŸŽ€ β€” the permissions on the rpc file:
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • log-level (object, optional) πŸ“ β€” how chatty daemon is:
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • log-prefix (object, optional) 🏷️ β€” what gets stamped on every log line:
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • log-file (object, optional) πŸ“„ β€” where the logs go. Heads up, the page literally lists this one with that odd dangling dash thing, so we're keeping it exactly like that, no cap:
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • log-timestamps (object, optional) ⏰ β€” do log lines get a timestamp:
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • force-feerates (object, optional) πŸ”₯ β€” the feerate override, if you set one:
    • value_str (string): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • subdaemon (object, optional) 🧚 β€” which subdaemon binary to use. Same dangling-dash situation as log-file above, so again, verbatim:
    • values_str (array of strings):
    • (string, optional): Field from config or cmdline.
    • sources (array of strings):
    • (string, optional): Source of configuration setting.
  • fetchinvoice-noconnect (object, optional) πŸ”Œ β€” the no-connect setting for fetchinvoice:
    • set (boolean): true if set in config or cmdline.
    • source (string): Source of configuration setting.
    • plugin (string, optional): Plugin which registered this configuration setting. (added v23.08)
  • tor-service-password (object, optional) πŸ™ˆ β€” the Tor service password. And the value here is always ... because obviously we're not leaking that, bestie:
    • value_str (string): Always ... (the value is concealed).
    • source (string): Source of configuration setting.
  • announce-addr-dns (object, optional) 🌐 β€” announcing DNS addresses, yes or no:
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • require-confirmed-inputs (object, optional) βœ… β€” whether confirmed inputs are mandatory:
    • value_bool (boolean): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • commit-fee (object, optional) πŸ’Έ β€” the commit fee value:
    • value_int (u64): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • commit-feerate-offset (object, optional) πŸ“ˆ β€” the offset applied to the commit feerate:
    • value_int (u32): Field from config or cmdline, or default.
    • source (string): Source of configuration setting.
  • autoconnect-seeker-peers (object, optional) (added v24.11) πŸ¦‹ β€” seeker peers for autoconnect:
    • value_int (u32): Field from config or cmdline, or default. (added v24.11)
    • source (string): Source of configuration setting. (added v24.11)
  • currencyrate-add-source (object, optional) (added v26.04) πŸ’± β€” adding a price source for cln-currencyrate:
    • values_str (array of strings) (added v26.04):
    • (string, optional): A source for cln-currencyrate to fetch price data from in the format of NAME,URL,MEMBERS
    • sources (array of strings) (added v26.04):
    • (string, optional): Source of configuration setting.
    • plugin (string, optional): Plugin which registered this configuration setting. (added v26.04)
  • currencyrate-disable-source (object, optional) (added v26.04) 🚫 β€” turning a price source off:
    • values_str (array of strings) (added v26.04):
    • (string, optional): The name of the cln-currencyrate source to disable
    • sources (array of strings) (added v26.04):
    • (string, optional): Source of configuration setting.
    • plugin (string, optional): Plugin which registered this configuration setting. (added v26.04)

πŸ’€ ERRORS πŸ’€

Okay so if it goes wrong, one of these error codes can come back at you, periodt:

  • -32602: Error in given parameters or field with config name doesn't exist.

🌸 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. πŸ‘‘ Respect where it's due, honestly.


🫢 SEE ALSO 🫢

lightning-getinfo(7), lightningd-config(5)


🌈 RESOURCES 🌈

Main web site: https://github.com/ElementsProject/lightning


✨ EXAMPLES ✨

Example 1 πŸ“

Request:

$ lightning-cli listconfigs -k "config"="network"

{
  "id": "example:listconfigs#1",
  "method": "listconfigs",
  "params": {
    "config": "network"
  }
}

Response:

{
  "configs": {
    "network": {
      "value_str": "regtest",
      "source": "cmdline"
    }
  }
}

Example 2 πŸ’œ

Request:

$ lightning-cli listconfigs -k "config"="experimental-dual-fund"

{
  "id": "example:listconfigs#2",
  "method": "listconfigs",
  "params": {
    "config": "experimental-dual-fund"
  }
}

Response:

{
  "configs": {
    "experimental-dual-fund": {
      "set": true,
      "source": "cmdline"
    }
  }
}

Example 3 ⭐

Request:

$ lightning-cli listconfigs

{
  "id": "example:listconfigs#3",
  "method": "listconfigs",
  "params": {}
}

Response:

okay picking right back up mid-dump, no ceremony, we're in the thick of the configs object and it is long β€” buckle up bestie πŸ’…

{
  "configs": {
    "accept-htlc-tlv-type": {
      "values_int": [],
      "sources": []
    },
    "addr": {
      "values_str": [
        "127.0.0.1:19735"
      ],
      "sources": [
        "cmdline"
      ]
    },
    "alias": {
      "value_str": "SILENTARTIST",
      "source": "default"
    },
    "allow-deprecated-apis": {
      "value_bool": true,
      "source": "cmdline"
    },
    "always-use-proxy": {
      "value_bool": false,
      "source": "default"
    },
    "announce-addr": {
      "values_str": [],
      "sources": []
    },
    "announce-addr-discovered": {
      "value_str": "auto",
      "source": "default"
    },
    "announce-addr-discovered-port": {
      "value_int": 19846,
      "source": "default"
    },
    "autoclean-cycle": {
      "value_int": 3600,
      "source": "default",
      "plugin": "/root/lightning/plugins/autoclean",
      "dynamic": true
    },
    "autoclean-expiredinvoices-age": {
      "value_int": 300,
      "source": "/tmp/.lightning/regtest/config.setconfig:2",
      "plugin": "/root/lightning/plugins/autoclean",
      "dynamic": true
    },
    "autoconnect-seeker-peers": {
      "value_int": 0,
      "source": "cmdline"
    },
    "autolisten": {
      "value_bool": false,
      "source": "default"
    },

obsessed with "alias" being SILENTARTIST β€” main character energy fr, bestie picked her own name and it ate πŸŽ€

also notice how autoclean-cycle and autoclean-expiredinvoices-age roll with a "plugin" field and "dynamic": true, and that second one's "source" is a whole file path β€” /tmp/.lightning/regtest/config.setconfig:2 β€” line two of your setconfig file, no cap, it's telling you exactly where that value came from πŸ”


    "bind-addr": {
      "values_str": [],
      "sources": []
    },
    "bitcoin-datadir": {
      "value_str": "/tmp/.lightning/",
      "source": "cmdline",
      "plugin": "/root/lightning/plugins/bcli"
    },
    "bitcoin-retry-timeout": {
      "value_int": 60,
      "source": "default",
      "plugin": "/root/lightning/plugins/bcli"
    },
    "bitcoin-rpcclienttimeout": {
      "value_int": 60,
      "source": "default",
      "plugin": "/root/lightning/plugins/bcli"
    },
    "bitcoin-rpcpassword": {
      "value_str": "...",
      "source": "cmdline",
      "plugin": "/root/lightning/plugins/bcli"
    },
    "bitcoin-rpcport": {
      "value_int": 18332,
      "source": "cmdline",
      "plugin": "/root/lightning/plugins/bcli"
    },
    "bitcoin-rpcuser": {
      "value_str": "rpcuser",
      "source": "cmdline",
      "plugin": "/root/lightning/plugins/bcli"
    },
    "clear-plugins": {
      "set": false,
      "source": "default"
    },
    "cltv-delta": {
      "value_int": 6,
      "source": "cmdline"
    },
    "cltv-final": {
      "value_int": 5,
      "source": "cmdline"
    },
    "commit-fee": {
      "value_int": 100,
      "source": "default"
    },
    "commit-feerate-offset": {
      "value_int": 5,
      "source": "default"
    },
    "commit-time": {
      "value_int": 10,
      "source": "default"
    },
    "daemon": {
      "set": false,
      "source": "default"
    },
    "dev-autoclean-max-batch": {
      "value_int": 100,
      "source": "default",
      "plugin": "/root/lightning/plugins/autoclean",
      "dynamic": true
    },
    "dev-bitcoind-poll": {
      "value_int": 3,
      "source": "cmdline"
    },
    "dev-crash-after": {
      "value_str": "3600",
      "source": "cmdline"
    },

⚠️ bestie see bitcoin-rpcpassword showing "..."? that's the example being coy about secrets, we do not leak those in public πŸ™ˆ β€” and note value_str there is a string even though it's secret, don't get it twisted.

the whole bcli crew is repping plugin field: bitcoin-datadir, bitcoin-retry-timeout, bitcoin-rpcclienttimeout, bitcoin-rpcpassword, bitcoin-rpcport, bitcoin-rpcuser β€” all of them live at /root/lightning/plugins/bcli πŸ’œ

and daemon / clear-plugins are out here using "set" instead of a value β€” iykyk, they're switches πŸ”˜


    "dev-fail-on-subdaemon-fail": {
      "set": true,
      "source": "cmdline"
    },
    "dev-fast-gossip": {
      "set": true,
      "source": "cmdline"
    },
    "dev-hsmd-no-preapprove-check": {
      "set": true,
      "source": "cmdline"
    },
    "dev-invoice-bpath-scid": {
      "set": false,
      "source": "default",
      "plugin": "/root/lightning/plugins/offers"
    },
    "dev-no-plugin-checksum": {
      "set": true,
      "source": "cmdline"
    },
    "dev-no-version-checks": {
      "set": true,
      "source": "cmdline"
    },
    "developer": {
      "set": true,
      "source": "cmdline"
    },
    "disable-dns": {
      "set": true,
      "source": "cmdline"
    },
    "disable-mpp": {
      "set": false,
      "source": "default",
      "plugin": "/root/lightning/plugins/pay"
    },
    "disable-plugin": {
      "values_str": [],
      "sources": []
    },
    "encrypted-hsm": {
      "set": false,
      "source": "default"
    },
    "experimental-dual-fund": {
      "set": true,
      "source": "cmdline"
    },
    "experimental-quiesce": {
      "set": false,
      "source": "default"
    },
    "experimental-shutdown-wrong-funding": {
      "set": false,
      "source": "default"
    },
    "experimental-splicing": {
      "set": false,
      "source": "default"
    },
    "exposesecret-passphrase": {
      "value_str": "...",
      "source": "default",
      "plugin": "/root/lightning/plugins/exposesecret"
    },

okay so this chunk is giving danger gremlin energy β€” dev-fail-on-subdaemon-fail, dev-fast-gossip, dev-hsmd-no-preapprove-check, dev-no-plugin-checksum, dev-no-version-checks, and developer are all "set": true from cmdline. bestie turned the dev flags on, live, in public 😭

also experimental-dual-fund sitting there true while experimental-quiesce, experimental-shutdown-wrong-funding, and experimental-splicing are all false β€” make it make sense πŸ’€

and exposesecret-passphrase is also "..." β€” same secret-hiding courtesy, from the plugin at /root/lightning/plugins/exposesecret 🫣


    "fee-base": {
      "value_int": 1,
      "source": "default"
    },
    "fee-per-satoshi": {
      "value_int": 10,
      "source": "default"
    },
    "fetchinvoice-noconnect": {
      "set": false,
      "source": "default",
      "plugin": "/root/lightning/plugins/offers"
    },
    "funder-fund-probability": {
      "value_int": 100,
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-fuzz-percent": {
      "value_int": 0,
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-lease-requests-only": {
      "value_bool": true,
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-max-their-funding": {
      "value_str": "4294967295sat",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-min-their-funding": {
      "value_str": "10000sat",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-per-channel-max": {
      "value_str": "4294967295sat",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-per-channel-min": {
      "value_str": "10000sat",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-policy": {
      "value_str": "fixed",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-policy-mod": {
      "value_str": "0",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funder-reserve-tank": {
      "value_str": "0sat",
      "source": "default",
      "plugin": "/root/lightning/plugins/funder"
    },
    "funding-confirms": {
      "value_int": 1,
      "source": "default"
    },
    "grpc-host": {
      "value_str": "127.0.0.1",
      "source": "default",
      "plugin": "/root/lightning/plugins/cln-grpc"
    },
    "grpc-msg-buffer-size": {
      "value_int": 1024,
      "source": "default",
      "plugin": "/root/lightning/plugins/cln-grpc"
    },
    "grpc-port": {
      "value_int": 9736,
      "source": "cmdline",
      "plugin": "/root/lightning/plugins/cln-grpc"
    },

the funder section is a whole personality β€” eleven entries, all default, all repping /root/lightning/plugins/funder, and look at the sat strings: "4294967295sat" for both funder-max-their-funding and funder-per-channel-max, "10000sat" for both funder-min-their-funding and funder-per-channel-min, "0sat" for funder-reserve-tank. numbers kept exactly as strings, bestie, that's the vibe πŸ’Έ

and the cln-grpc trio: grpc-host "127.0.0.1" default, grpc-msg-buffer-size 1024 default, but grpc-port 9736 came from cmdline β€” one of these things is not like the others πŸ”₯


    "htlc-maximum-msat": {
      "value_msat": 18446744073709552000,
      "source": "default"
    },
    "htlc-minimum-msat": {
      "value_msat": 0,
      "source": "default"
    },
    "i-promise-to-fix-broken-api-user": {
      "values_str": [],
      "sources": []
    },
    "ignore-fee-limits": {
      "value_bool": false,
      "source": "cmdline"
    },
    "important-plugin": {
      "values_str": [],
      "sources": []
    },
    "invoices-onchain-fallback": {
      "set": false,
      "source": "default"
    },
    "lightning-dir": {
      "value_str": "/tmp/.lightning/",
      "source": "cmdline"
    },
    "log-file": {
      "values_str": [
        "-",
        "/tmp/.lightning/log"
      ],
      "sources": [
        "cmdline",
        "cmdline"
      ]
    },
    "log-level": {
      "value_str": "debug",
      "source": "cmdline"
    },
    "log-prefix": {
      "value_str": "lightningd-2 ",
      "source": "cmdline"
    },
    "log-timestamps": {
      "value_bool": true,
      "source": "default"
    },
    "mainnet": {
      "set": false,
      "source": "default"
    },
    "max-concurrent-htlcs": {
      "value_int": 483,
      "source": "default"
    },
    "max-dust-htlc-exposure-msat": {
      "value_msat": 50000000,
      "source": "default"
    },
    "min-capacity-sat": {
      "value_int": 500000,
      "source": "/tmp/.lightning/regtest/config.setconfig:3",
      "dynamic": true
    },
    "min-emergency-msat": {
      "value_msat": 25000000,
      "source": "default"
    },
    "network": {
      "value_str": "regtest",
      "source": "cmdline"
    },

log-file is the only one here rocking plural arrays for both β€” values_str is ["-", "/tmp/.lightning/log"] and sources is ["cmdline", "cmdline"] β€” two entries, two sources, they line up, slay 🧚

and log-prefix is "lightningd-2 " β€” with a trailing space, bestie, do not strip it, character-for-character or it's over 😀

min-capacity-sat is out here with "dynamic": true and a source pointing at /tmp/.lightning/regtest/config.setconfig:3 β€” line three this time, the setconfig file is really doing the most πŸ“


    "offline": {
      "set": false,
      "source": "default"
    },
    "pid-file": {
      "value_str": "/tmp/.lightning/lightningd-regtest.pid",
      "source": "default"
    },
    "plugin": {
      "values_str": [],
      "sources": []
    },
    "plugin-dir": {
      "values_str": [],
      "sources": []
    },
    "regtest": {
      "set": false,
      "source": "default"
    },
    "renepay-debug-mcf": {
      "set": false,
      "source": "default",
      "plugin": "/root/lightning/plugins/cln-renepay"
    },
    "renepay-debug-payflow": {
      "set": false,
      "source": "default",
      "plugin": "/root/lightning/plugins/cln-renepay"
    },
    "require-confirmed-inputs": {
      "value_bool": false,
      "source": "default"
    },
    "rescan": {
      "value_int": 1,
      "source": "cmdline"
    },
    "rgb": {
      "value_str": "022d22",

and there's renepay-debug-mcf + renepay-debug-payflow, both false, both repping /root/lightning/plugins/cln-renepay, matching pair, we love symmetry πŸ¦‹

then we hit "rgb" and it's "022d22" and β€” 😭 β€” the output just keeps going, bestie, we are so not done, this dump is a marathon and we're barely at the halfway water station πŸƒβ€β™€οΈπŸ’¨

             "source": "default"
           },
           "rpc-file": {
             "value_str": "lightning-rpc",
             "source": "default"
           },
           "rpc-file-mode": {
             "value_str": "0600",
             "source": "default"
           },
           "signet": {
             "set": false,
             "source": "default"
           },
           "subdaemon": {
             "values_str": [],
             "sources": []
           },
           "testnet": {
             "set": false,
             "source": "default"
           },
           "testnet4": {
             "set": false,
             "source": "default"
           },
           "watchtime-blocks": {
             "value_int": 5,
             "source": "cmdline"
           },
           "xpay-handle-pay": {
             "value_bool": false,
             "source": "default",
             "plugin": "/root/lightning/plugins/cln-xpay",
             "dynamic": true
           },
           "xpay-slow-mode": {
             "value_bool": false,
             "source": "default",
             "plugin": "/root/lightning/plugins/cln-xpay",
             "dynamic": true
           }
         }
       }

Okay so that's the end of the dump, bestie 🫢 β€” and look at those last few entries, they're giving range. You can literally see the difference between a config that got set on the cmdline ("watchtime-blocks" with "value_int": 5 and "source": "cmdline") versus everything that's just vibing on "source": "default" πŸŽ€.

And the plugin ones? "xpay-handle-pay" and "xpay-slow-mode" are the main characters here β€” they've got that extra "plugin" field pointing at /root/lightning/plugins/cln-xpay plus "dynamic": true, so you know exactly which plugin brought them and that they can be changed on the fly ✨. Meanwhile "subdaemon" is sitting there with its empty "values_str": [] and "sources": [] β€” not nothing, but not set either, and that's totally valid πŸ’….

Same rules as always though: those <italic>value_*</italic> / set / values_* keys and the source / sources / plugin / dynamic fields do not all show up on every single entry β€” only the ones that apply β€” so don't go assuming a uniform shape, okay? πŸ™ˆ The shape flexes per config. And if you ask for a value and there isn't one, that's an "error" on that entry instead, and missing names in the "configs" object just mean they weren't in the list. Fr fr.


And that's the whole page, bestie, we made it πŸ˜­πŸŽ‰

Core Lightning v26.06.9 🌈 β€” LIGHTNING-LISTCONFIGS(7), served piping hot and complete. Go forth and interrogate your config πŸ‘‘β­πŸ’œ

πŸ“¦ where this page comes from