rust-lightning/pending_changelog/matt-persist-preimage-on-upgrade.txt

# Backwards Compatibility
 * The `ChannelManager` deserialization semantics no longer require that
   `ChannelMonitor`s be re-persisted after `(BlockHash, ChannelManager)::read`
   is called prior to normal node operation. This applies to upgraded nodes
   only *after* a startup with the old semantics completes at least once. IOW,
   you must deserialize the `ChannelManager` with upgraded LDK, persist the
   `ChannelMonitor`s then continue to normal startup once, and thereafter you
   may skip the `ChannelMonitor` persistence step.
Doc the on-upgrade `ChannelMonitor` startup persistence semantics Because the new startup `ChannelMonitor` persistence semantics rely on new information stored in `ChannelMonitor` only for claims made in the upgraded code, users upgrading from previous version of LDK must apply the old `ChannelMonitor` persistence semantics at least once (as the old code will be used to handle partial claims). 2024-09-15 19:24:19 +02:00			`# Backwards Compatibility`
			* The `ChannelManager` deserialization semantics no longer require that
			`ChannelMonitor`s be re-persisted after `(BlockHash, ChannelManager)::read`
			`is called prior to normal node operation. This applies to upgraded nodes`
			`only after a startup with the old semantics completes at least once. IOW,`
			you must deserialize the `ChannelManager` with upgraded LDK, persist the
			`ChannelMonitor`s then continue to normal startup once, and thereafter you
			may skip the `ChannelMonitor` persistence step.