LIGHTNING-HOOK-RECOVER(7)

💅 LIGHTNING-HOOK-RECOVER — the recovery-mode hook, explained (man section 7) 💅

okay bestie, buckle up, because this one is short but it's important — it's the lightning-hook-recover page from the Core Lightning manual, and it's all about what happens the moment your node wakes up in recovery mode 🌸

---

✨ NAME ✨

recover — the hook that gets fired when your node starts up in recovery mode 🫶

---

🦋 DESCRIPTION 🦋

so this hook is kind of a new addition — it landed in v23.08 ✨

the recover hook gets called every single time the node is started with the --recovery flag. no cap. and what it hands you is the codex32 secret — the one used to derive the HSM secret 👑

why do you care? because plugins can use that secret to reconnect to peers who are holding onto your peer storage backups for you, and recover state or funds from them. it's giving "hey bestie, remember me? I have receipts" 😭💖

heads up though: this hook is informational only. it does not let you alter execution flow. nope, not even a little. 🙈

what plugins are expected to do is perform the recovery-related side effects — stuff like reconnecting to peers. that's the whole vibe. lowkey the main character energy of this hook is "here's your secret, now go do your little recovery tasks" 💅

---

🎀 HOOK PAYLOAD 🎀

• codex32 (string) — the codex32-encoded secret that was handed over via --recover. it's the thing you use to reconstruct the node's HSM secret 🔥

---

⭐ HOOK RETURN ⭐

• result (string) (always "continue") — returning "continue" just resumes normal execution. that's it, that's the whole return value, periodt ✨

---

fr fr, the one thing to remember: informational hook, --recovery flag, --recover secret, "continue" return. slay 💜

---

and that's the page, bestie 🧚 this was Core Lightning v26.06.9 — go forth and recover your funds, ily, mwah 💖🎀🦋