home | help 
LIGHTNING-RECOVER(7)					    LIGHTNING-RECOVER(7)

NAME
     recover -- Reinitialize Your Node for Recovery

SYNOPSIS
     recover hsmsecret

DESCRIPTION
     The  recover RPC command wipes your node and restarts it with the --recover
     option. This is only permitted if the node is unused: no channels, no  bit-
     coin addresses issued (you can use check to see if recovery is possible).

     For  nodes  created  with	v25.12	or  later, hsmsecret MUST be the 12-word
     mnemonic.

     For earlier nodes, hsmsecret is either a codex32 secret starting with "cl1"
     as returned by lightning-hsmtool getcodexsecret, or a raw 64 character  hex
     string.

     NOTE: this command only currently works with the sqlite3 database backend.

     *	hsmsecret (string): Usually a 12-word mnemonic; but for old nodes either
	a codex32 secret starting with cl1 as returned by lightning-hsmtool get-
	codexsecret or a raw 64 character hex string.

RETURN VALUE
     On success, an object is returned, containing:

     *	result (string) (always "Recovery restart in progress") (added v24.05)

AUTHOR
     Rusty Russell rusty@blockstream.com is mainly responsible.

SEE ALSO
     lightning-hsmtool(7)

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

EXAMPLES
     Example 1:

     Request:

     $ lightning-cli recover -k "hsmsecret"="6c696768746e696e672d36000000000000000000000000000000000000000000"

     {
       "id": "example:recover#1",
       "method": "recover",
       "params": {
	 "hsmsecret": "6c696768746e696e672d36000000000000000000000000000000000000000000"
       }
     }

     Response:

     {
       "result": "Recovery restart in progress"
     }

     Example 2:

     Request:

     $ lightning-cli recover -k "hsmsecret"="cl10leetsd35kw6r5de5kueedxyesqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqluplcg0lxenqd"

     {
       "id": "example:recover#2",
       "method": "recover",
       "params": {
	 "hsmsecret": "cl10leetsd35kw6r5de5kueedxyesqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqluplcg0lxenqd"
       }
     }

     Response:

     {
       "result": "Recovery restart in progress"
     }

Core Lightning v26.06.1 				    LIGHTNING-RECOVER(7)
home | help