LIGHTNING-HOOK-RPC_COMMAND(7)

💅 rpc_command — the hook for intercepting and modifying RPC commands

okay so bestie, welcome to LIGHTNING-HOOK-RPC_COMMAND(7) — the manual page about the hook that lets you slide into any RPC command's DMs and take over. no cap, this is main character energy for plugins. 🎀

---

✨ DESCRIPTION ✨

the rpc_command hook lets a plugin take over any RPC command. literally any of them. it's giving absolute power. 👑

you can optionally specify a filters array, containing the command names you actually want to intercept. without it? every single command gets sent to this hook. every. one. (added in v25.12 — so if you're on an older version, that's a 💀 moment)

the plugin receives the full JSON-RPC request and may choose to:

• continue (just vibe and let it through)
• replace the request (swap it out for your own)
• return a custom result or error (do it yourself, diva behavior)

⚠️ heads up bestie: this is a chained hook. only the first plugin that modifies the request or response will take effect. other plugins get ignored and a warning gets logged. so like… first come first served, and the rest of the group chat just gets left on read. 😭

---

🌸 HOOK PAYLOAD 🌸

what lightningd hands you:

• rpc_command (object) — The original JSON-RPC request object.
  • id (one of) — The JSON-RPC request id.
    • (string)
    • (number)
    • (null)
  • method (string) — The RPC method name.
  • params (one of) — The parameters passed to the RPC method.
    • (object)
    • (array)
      • (any type)

---

🦋 HOOK RETURN 🦋

what you're allowed to send back:

• result (string, optional) (always "continue") — Indicates that lightningd should continue processing the RPC command normally.
• replace (object, optional) — Replaces the original JSON-RPC request with a new one.
  • jsonrpc (string) (always "2.0") — The JSON-RPC version.
  • id (one of) — The JSON-RPC request id.
    • (string)
    • (number)
    • (null)
  • method (string) — The RPC method name.
  • params (one of) — The parameters passed to the RPC method.
    • (object)
    • (array)
      • (any type)
• return (object, optional) — Returns a custom JSON-RPC response to the caller.
  • result (object, optional) — Custom result object to return to the caller.
  • error (object, optional) — Custom error object to return to the caller.
    • code (integer) — JSON-RPC error code.
    • message (string) — Human-readable error message.

---

and that's the whole vibe check, bestie — you're officially certified to intercept RPC commands like the icon you are. 💅✨

mwah 💖 this page is from Core Lightning v26.06.9 — LIGHTNING-HOOK-RPC_COMMAND(7), slay, periodt. 🫶