Skip to content

Commit ba0bff8

Browse files
authored
update documentation
1 parent 1b03ba3 commit ba0bff8

File tree

2 files changed

+24
-1
lines changed

2 files changed

+24
-1
lines changed

docs/lnd/recovery.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -258,6 +258,22 @@ An example of using file system level notification to [copy the backup to a
258258
distinct volume/partition/drive can be found
259259
here](https://gist.github.com/alexbosworth/2c5e185aedbdac45a03655b709e255a3).
260260

261+
##### Last resort manual force close
262+
263+
Reserve this option as a last resort when the peer is offline and all other
264+
avenues to retrieve funds from the channel have been exhausted. The primary
265+
motivation for introducing this option is to provide a means of recovery,
266+
albeit with some risk, rather than losing the funds indefinitely. This is a very
267+
dangerous option, so it should only be used after consulting with a recovery
268+
specialist or after opening an issue to make sure!!!
269+
270+
Starting with release 0.19.0 LND includes unsigned force close transaction
271+
for a channel into channel.backup file and RPCs returning channel backups.
272+
To generate a force close transaction from the backup file, utilize the
273+
`chantools scbforceclose` command. However, exercise caution as this action is
274+
perilous. If the channel has been updated since the backup creation, another
275+
node or a watchtower may issue a penalty transaction, seizing all funds!
276+
261277
#### Using the `ExportChanBackup` RPC
262278

263279
Another way to obtain SCBS for all or a target channel is via the new

docs/lnd/release-notes/release-notes-0.19.0.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,12 +51,18 @@
5151

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

54+
* The SCB file now [contains more data][https://github.com/lightningnetwork/lnd/pull/8183]
55+
that enable a last resort rescue for certain cases where the peer is no longer
56+
around.
57+
58+
* LND updates channel.backup file at shutdown time.
59+
5460
## RPC Updates
5561

5662
## lncli Updates
5763

5864
## Code Health
59-
65+
6066
## Breaking Changes
6167
## Performance Improvements
6268

@@ -89,6 +95,7 @@
8995

9096
# Contributors (Alphabetical Order)
9197

98+
* Boris Nagaev
9299
* CharlieZKSmith
93100
* Elle Mouton
94101
* Pins

0 commit comments

Comments
 (0)