From 65df996358a33244341d1c6ab933efabf495e3f1 Mon Sep 17 00:00:00 2001 From: Boris Nagaev Date: Sat, 13 Jul 2024 13:21:46 -0300 Subject: [PATCH] docs/recovery: add Last resort manual force close Also updated release-notes. --- docs/recovery.md | 16 ++++++++++++++++ docs/release-notes/release-notes-0.19.0.md | 9 ++++++++- 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/recovery.md b/docs/recovery.md index c99e0ddef0..89c2f069f1 100644 --- a/docs/recovery.md +++ b/docs/recovery.md @@ -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 diff --git a/docs/release-notes/release-notes-0.19.0.md b/docs/release-notes/release-notes-0.19.0.md index c7410fced0..204d25a54d 100644 --- a/docs/release-notes/release-notes-0.19.0.md +++ b/docs/release-notes/release-notes-0.19.0.md @@ -51,12 +51,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 @@ -89,6 +95,7 @@ # Contributors (Alphabetical Order) +* Boris Nagaev * CharlieZKSmith * Elle Mouton * Pins