f docs

Author: TheBlueMatt

lightning/src/sign/mod.rs

@@ -2075,7 +2075,12 @@ impl KeysManager {
 	}
 
 	/// Gets the set of possible `script_pubkey`s which can appear on chain for our
-	/// non-HTLC-encumbered balance if our counterparty force-closes the channel.
+	/// non-HTLC-encumbered balance if our counterparty force-closes a channel.
+	///
+	/// If you've lost all data except your seed, asking your peers nicely to force-close the
+	/// chanels they had with you (and hoping they don't broadcast a stale state and that there are
+	/// no pending HTLCs in the latest state) and scanning the chain for these `script_pubkey`s can
+	/// allow you to recover (some of) your funds.
 	///
 	/// Only channels opened when using a [`KeysManager`] with the `v2_remote_key_derivation`
 	/// argument to [`KeysManager::new`] set, or any spliced channels will close to such scripts,