f monotonic clockish

Author: TheBlueMatt

lightning/src/ln/peer_handler.rs

@@ -559,9 +559,9 @@ impl<Descriptor: SocketDescriptor, CM: Deref, OM: Deref, L: Deref> PeerManager<D
 	/// ephemeral_random_data is used to derive per-connection ephemeral keys and must be
 	/// cryptographically secure random bytes.
 	///
-	/// `current_time` should be set higher than any previous `PeerManager` instance with the same
-	/// secret key. The simplest way to ensure this, of course, is to simply set it to the current
-	/// UNIX timestamp on startup.
+	/// `current_time` is used as an always-increasing counter that survives across restarts and is
+	/// incremented irregularly internally. In general it is best to simply use the current UNIX
+	/// timestamp.
 	///
 	/// (C-not exported) as we can't export a PeerManager with a dummy route handler
 	pub fn new_channel_only(channel_message_handler: CM, onion_message_handler: OM, our_node_secret: SecretKey, current_time: u64, ephemeral_random_data: &[u8; 32], logger: L) -> Self {
@@ -581,9 +581,9 @@ impl<Descriptor: SocketDescriptor, RM: Deref, L: Deref> PeerManager<Descriptor,
 	/// generate error messages). Note that some other lightning implementations time-out connections
 	/// after some time if no channel is built with the peer.
 	///
-	/// `current_time` should be set higher than any previous `PeerManager` instance with the same
-	/// secret key. The simplest way to ensure this, of course, is to simply set it to the current
-	/// UNIX timestamp on startup.
+	/// `current_time` is used as an always-increasing counter that survives across restarts and is
+	/// incremented irregularly internally. In general it is best to simply use the current UNIX
+	/// timestamp.
 	///
 	/// ephemeral_random_data is used to derive per-connection ephemeral keys and must be
 	/// cryptographically secure random bytes.
@@ -649,9 +649,9 @@ impl<Descriptor: SocketDescriptor, CM: Deref, RM: Deref, OM: Deref, L: Deref, CM
 	/// ephemeral_random_data is used to derive per-connection ephemeral keys and must be
 	/// cryptographically secure random bytes.
 	///
-	/// `current_time` should be set higher than any previous `PeerManager` instance with the same
-	/// secret key. The simplest way to ensure this, of course, is to simply set it to the current
-	/// UNIX timestamp on startup.
+	/// `current_time` is used as an always-increasing counter that survives across restarts and is
+	/// incremented irregularly internally. In general it is best to simply use the current UNIX
+	/// timestamp.
 	pub fn new(message_handler: MessageHandler<CM, RM, OM>, our_node_secret: SecretKey, current_time: u64, ephemeral_random_data: &[u8; 32], logger: L, custom_message_handler: CMH) -> Self {
 		let mut ephemeral_key_midstate = Sha256::engine();
 		ephemeral_key_midstate.input(ephemeral_random_data);