README+doc: update docs

Author: guggero

README.md

@@ -424,6 +424,7 @@ Available Commands:
   filterbackup        Filter an lnd channel.backup file and remove certain channels
   fixoldbackup        Fixes an old channel.backup file that is affected by the lnd issue #3881 (unable to derive shachain root key)
   forceclose          Force-close the last state that is in the channel.db provided
+  scbforceclose       Force-close the last state that is in the SCB provided
   genimportscript     Generate a script containing the on-chain keys of an lnd wallet that can be imported into other software like bitcoind
   migratedb           Apply all recent lnd channel database migrations
   pullanchor          Attempt to CPFP an anchor output of a channel
@@ -496,6 +497,7 @@ Legend:
 | [removechannel](doc/chantools_removechannel.md)             | (:skull: :warning:) Remove a single channel from a `channel.db` file                                                                     |
 | [rescueclosed](doc/chantools_rescueclosed.md)               | :pencil: (:pushpin:) Rescue funds in a legacy (pre `STATIC_REMOTE_KEY`) channel output                                                   |
 | [rescuefunding](doc/chantools_rescuefunding.md)             | :pencil: (:pushpin:) Rescue funds from a funding transaction. Deprecated, use [zombierecovery](doc/chantools_zombierecovery.md) instead  |
+| [scbforceclose](doc/chantools_scbforceclose.md)             | :pencil: :warning: :skull: Force close a channel using the latest state from a channel backup. EXTREMELY DANGEROUS, read help text!      |
 | [showrootkey](doc/chantools_showrootkey.md)                 | :pencil: Display the master root key (`xprv`) from your seed (DO NOT SHARE WITH ANYONE)                                                  |
 | [signmessage](doc/chantools_signmessage.md)                 | :pencil: Sign a message with the nodes identity pubkey.                                                                                  |
 | [signpsbt](doc/chantools_signpsbt.md)                       | :pencil: Sign a Partially Signed Bitcoin Transaction (PSBT)                                                                              |

doc/chantools.md

@@ -43,6 +43,7 @@ https://github.com/lightninglabs/chantools/.
 * [chantools rescueclosed](chantools_rescueclosed.md)	 - Try finding the private keys for funds that are in outputs of remotely force-closed channels
 * [chantools rescuefunding](chantools_rescuefunding.md)	 - Rescue funds locked in a funding multisig output that never resulted in a proper channel; this is the command the initiator of the channel needs to run
 * [chantools rescuetweakedkey](chantools_rescuetweakedkey.md)	 - Attempt to rescue funds locked in an address with a key that was affected by a specific bug in lnd
+* [chantools scbforceclose](chantools_scbforceclose.md)	 - Force-close the last state that is in the SCB provided
 * [chantools showrootkey](chantools_showrootkey.md)	 - Extract and show the BIP32 HD root key from the 24 word lnd aezeed
 * [chantools signmessage](chantools_signmessage.md)	 - Sign a message with the node's private key.
 * [chantools signpsbt](chantools_signpsbt.md)	 - Sign a Partially Signed Bitcoin Transaction (PSBT)

doc/chantools_forceclose.md

@@ -4,9 +4,10 @@ Force-close the last state that is in the channel.db provided
 
 ### Synopsis
 
-If you are certain that a node is offline for good (AFTER
-you've tried SCB!) and a channel is still open, you can use this method to
-force-close your latest state that you have in your channel.db.
+
+If you are certain that a node is offline for good (AFTER you've tried SCB!)
+and a channel is still open, you can use this method to force-close your
+latest state that you have in your channel.db.
 
 **!!! WARNING !!! DANGER !!! WARNING !!!**
 

doc/chantools_scbforceclose.md

@@ -0,0 +1,57 @@
+## chantools scbforceclose
+
+Force-close the last state that is in the SCB provided
+
+### Synopsis
+
+
+If you are certain that a node is offline for good (AFTER you've tried SCB!)
+and a channel is still open, you can use this method to force-close your
+latest state that you have in your channel.db.
+
+**!!! WARNING !!! DANGER !!! WARNING !!!**
+
+If you do this and the state that you publish is *not* the latest state, then
+the remote node *could* punish you by taking the whole channel amount *if* they
+come online before you can sweep the funds from the time locked (144 - 2000
+blocks) transaction *or* they have a watch tower looking out for them.
+
+**This should absolutely be the last resort and you have been warned!**
+
+```
+chantools scbforceclose [flags]
+```
+
+### Examples
+
+```
+chantools scbforceclose --multi_file channel.backup
+```
+
+### Options
+
+```
+      --apiurl string          API URL to use (must be esplora compatible) (default "https://api.node-recovery.com")
+      --bip39                  read a classic BIP39 seed and passphrase from the terminal instead of asking for lnd seed format or providing the --rootkey flag
+  -h, --help                   help for scbforceclose
+      --multi_backup string    a hex encoded multi-channel backup obtained from exportchanbackup for force-closing channels
+      --multi_file string      the path to a single-channel backup file (channel.backup)
+      --publish                publish force-closing TX to the chain API instead of just printing the TX
+      --rootkey string         BIP32 HD root key of the wallet to use for decrypting the backup and signing tx; leave empty to prompt for lnd 24 word aezeed
+      --single_backup string   a hex encoded single channel backup obtained from exportchanbackup for force-closing channels
+      --single_file string     the path to a single-channel backup file
+      --walletdb string        read the seed/master root key to use for decrypting the backup and signing tx from an lnd wallet.db file instead of asking for a seed or providing the --rootkey flag
+```
+
+### Options inherited from parent commands
+
+```
+  -r, --regtest   Indicates if regtest parameters should be used
+  -s, --signet    Indicates if the public signet parameters should be used
+  -t, --testnet   Indicates if testnet parameters should be used
+```
+
+### SEE ALSO
+
+* [chantools](chantools.md)	 - Chantools helps recover funds from lightning channels
+