LIGHTNING-DEPRECATIONS(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💅 deprecations — the command that lets you turn deprecated APIs on/off ✨

okay bestie, so this is the lightning-deprecations(7) manual page and honestly it's a little cutie. let's get into it 🎀

✨ NAME ✨

deprecations — the command to enable/disable deprecated APIs. that's it, that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

deprecations enable

💖 DESCRIPTION 💖

this command was added in v24.02. yes, we're citing receipts. 💅

the deprecations RPC command is used to override the global config option allow-deprecated-apis for further RPC commands on this same connection. so like — just this connection, not the whole world, no cap. 🫶

why would you want that? honestly it's useful for developer testing, so you can make sure you don't accidentally rely on deprecated features. like a vibe check for your own code. 🙈

  • enable (boolean) — the flag that turns deprecated APIs on or off. setting it to false will neither accept deprecated parameters or commands, nor output deprecated fields. it's giving strict mode, and honestly? iconic. 👑

🔥 RETURN VALUE 🔥

on success you get back an empty object. {}. that's the whole gift. 💀

😭 ERRORS 😭

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

  • -32602 — error in given parameters. something you passed was not it, bestie. 🍓

🧚 AUTHOR 🧚

Rusty Russell rusty@blockstream.com wrote the initial version of this man page. legend behaviour, fr fr. 💜

⭐ SEE ALSO ⭐

go read those too, iykyk 🌈

🌸 RESOURCES 🌸

main web site: https://github.com/ElementsProject/lightning — the main character energy source. 👑

💅 EXAMPLES 💅

example 1 ✨

request:

$ lightning-cli deprecations -k "enable"=True

{
  "id": "example:deprecations#1",
  "method": "deprecations",
  "params": {
    "enable": true
  }
}

response:

{}

ate. no crumbs. 🎀

🦋 example 2 🦋

request:

$ lightning-cli deprecations -k "enable"=False

{
  "id": "example:deprecations#2",
  "method": "deprecations",
  "params": {
    "enable": false
  }
}

response:

{}

still {}. slay. 💖

that's the whole page bestie — Core Lightning v26.06.9, LIGHTNING-DEPRECATIONS(7), mwah 💋 go forth and don't rely on deprecated stuff ✨🫶

📦 where this page comes from