recover

recover -- Hook fired when node starts in recovery mode

DESCRIPTION

Hook added in v23.08.

The recover hook is called whenever the node is started using the --recovery flag.
It provides the codex32 secret used to derive the HSM secret.
Plugins can use this to reconnect to peers who keep your peer storage backups with them and recover state or funds.

This hook is informational and does not allow altering execution flow.
Plugins are expected to perform recovery-related side effects such as reconnecting to peers.

HOOK PAYLOAD

  • codex32 (string): The codex32-encoded secret provided via --recover.
    Used to reconstruct the node's HSM secret.

HOOK RETURN

  • result (string) (always "continue"): Returning "continue" resumes normal execution.

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2026 Core Lightning, a Blockstream project.
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.