rust-lightning/pending_changelog/matt-persist-preimage-on-upgrade.txt
Matt Corallo ba264323f8 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-10-24 17:44:33 +00:00

9 lines
538 B
Plaintext

# 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.