- /// `counterparty_selected`/`holder_selected_contest_delay` and funding outpoint. Since these
- /// are static channel data, they MUST NOT be allowed to change to different values once set,
- /// as LDK may call this method more than once.
+ /// `counterparty_selected`/`holder_selected_contest_delay` and funding outpoint.
+ ///
+ /// This data is static, and will never change for a channel once set. For a given [`BaseSign`]
+ /// instance, LDK will call this method exactly once - either immediately after construction
+ /// (not including if done via [`KeysInterface::read_chan_signer`]) or when the funding
+ /// information has been generated.