GSP
Quick Navigator
Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
LIGHTNING-HSMTOOL(8) lightning-hsmtool LIGHTNING-HSMTOOL(8)

lightning-hsmtool - Tool for working with software HSM secrets of lightningd 

lightning-hsmtool method [ARGUMENTS]...








lightning-hsmtool performs various operations on the hsm_secret
  file used by the software HSM component of lightningd.



This can be used to encrypt and decrypt the hsm_secret
    file, as well as derive secrets used in channel commitments.









 encrypt hsm_secret password Encrypt the hsm_secret
  file so that it can only be decrypted at lightningd startup. You must
  give the option --encrypted-hsm to lightningd. The password of
  the hsm_secret file will be asked whenever you start lightningd.




   decrypt hsm_secret password Decrypt the
    hsm_secret file that was encrypted with the encrypt
  method.





   dumpcommitments node_id channel_dbid depth
    hsm_secret [password] Show the per-commitment secret and point
    of up to depth commitments, of the specified channel with the
    specified peer, identified by the channel database index. Specify
    password if the hsm_secret is encrypted.





   guesstoremote p2wpkh node_id max_channel_dbid
    hsm_secret [password] Brute-force the private key to our funds
    from a remote unilateral close of a channel, in a case where we have lost
    all database data except for our hsm_secret. The peer must be the one
    to close the channel (and the funds will remain unrecoverable until the
    channel is closed). max_channel_dbid is your own guess on what the
    channel_dbid was, or at least the maximum possible value, and is
    usually no greater than the number of channels that the node has ever had.
    Specify password if the hsm_secret is encrypted.




generatehsm hsm_secret_path Generates a new
    hsm_secret using BIP39.





   dumponchaindescriptors hsm_secret [password]
    [network] Dump output descriptors for our onchain wallet. The
    descriptors can be used by external services to be able to generate
    addresses for our onchain wallet. (for example on bitcoind using the
    importmulti or importdescriptors RPC calls) We need the path
    to the hsm_secret containing the wallet seed, and an optional (skip using
    "") password if it was encrypted. To generate descriptors
    using testnet master keys, you may specify testnet as the last
    parameter. By default, mainnet-encoded keys are generated.









You should report bugs on our github issues page, and maybe submit a fix to gain
  our eternal gratitude!








ZmnSCPxj <ZmnSCPxj@protonmail.com> wrote the initial version of
  this man page, but many others did the hard work of actually implementing
  lightning-hsmtool.








lightningd(8), lightningd-config(5)








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








Note: the modules in the ccan/ directory have their own licenses, but the rest
  of the code is covered by the BSD-style MIT license. Main web site:
  https://github.com/ElementsProject/lightning










  

    
    
  







Search for    or go to Top of page | 
Section 8 | 
Main Index



   
Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.