f more docs

Author: TheBlueMatt

lightning/src/chain/keysinterface.rs

@@ -349,9 +349,10 @@ pub trait KeysInterface: Send + Sync {
 
 	/// Reads a `ChanKeySigner` for this `KeysInterface` from the given input stream.
 	/// This is only called during deserialization of other objects which contain
-	/// `ChannelKeys`-implementing objects (ie `ChannelMonitor`s and `ChannelManager`s) and must
-	/// read exactly the bytes that `<Self::ChanKeySigner as Writeable>::write()` writes, or return
-	/// an error.
+	/// `ChannelKeys`-implementing objects (ie `ChannelMonitor`s and `ChannelManager`s).
+	/// The bytes are exactly those which `<Self::ChanKeySigner as Writeable>::write()` writes, and
+	/// contain no versioning scheme. You may wish to include your own version prefix and ensure
+	/// you've read all of the provided bytes to ensure no corruption occurred.
 	fn read_chan_signer(&self, reader: &[u8]) -> Result<Self::ChanKeySigner, DecodeError>;
 }