Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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 --re-
       cover option. This is only permitted if the node	is  unused:  no	 chan-
       nels, no	bitcoin	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 back-
       end.

         hsmsecret (string): Usually a	12-word	mnemonic; but  for  old	 nodes
	  either  a codex32 secret starting with cl1 as	returned by lightning-
	  hsmtool getcodexsecret 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 v25.12.1					  LIGHTNING-RECOVER(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lightning-recover&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help