Skip to content

Commit

Permalink
docs/recovery: add Last resort manual force close
Browse files Browse the repository at this point in the history
Also updated release-notes.
  • Loading branch information
starius committed Oct 2, 2024
1 parent ed7ce3f commit 621a963
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 1 deletion.
16 changes: 16 additions & 0 deletions docs/recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -258,6 +258,22 @@ An example of using file system level notification to [copy the backup to a
distinct volume/partition/drive can be found
here](https://gist.github.com/alexbosworth/2c5e185aedbdac45a03655b709e255a3).

##### Last resort manual force close

Reserve this option as a last resort when the peer is offline and all other
avenues to retrieve funds from the channel have been exhausted. The primary
motivation for introducing this option is to provide a means of recovery,
albeit with some risk, rather than losing the funds indefinitely. This is a very
dangerous option, so it should only be used after consulting with a recovery
specialist or after opening an issue to make sure!!!

Starting with release 0.19.0 LND includes unsigned force close transaction
for a channel into channel.backup file and RPCs returning channel backups.
To generate a force close transaction from the backup file, utilize the
`chantools scbforceclose` command. However, exercise caution as this action is
perilous. If the channel has been updated since the backup creation, another
node or a watchtower may issue a penalty transaction, seizing all funds!

#### Using the `ExportChanBackup` RPC

Another way to obtain SCBS for all or a target channel is via the new
Expand Down
9 changes: 8 additions & 1 deletion docs/release-notes/release-notes-0.19.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,18 @@

* [Allow](https://github.com/lightningnetwork/lnd/pull/9017) the compression of logs during rotation with ZSTD via the `logcompressor` startup argument.

* The SCB file now [contains more data][https://github.com/lightningnetwork/lnd/pull/8183]
that enable a last resort rescue for certain cases where the peer is no longer
around.

* LND updates channel.backup file at shutdown time.

## RPC Updates

## lncli Updates

## Code Health

## Breaking Changes
## Performance Improvements

Expand Down Expand Up @@ -80,6 +86,7 @@

# Contributors (Alphabetical Order)

* Boris Nagaev
* CharlieZKSmith
* Elle Mouton
* Pins
Expand Down

0 comments on commit 621a963

Please sign in to comment.