Track in-flight channel_announcement lookups and avoid duplicates

If we receive two `channel_announcement`s for the same channel at
the same time, we shouldn't spawn a second UTXO lookup for an
identical message. This likely isn't too rare - if we start syncing
the graph from two peers at the same time, it isn't unlikely that
we'll end up with the same messages around the same time.

In order to avoid this we keep a hash map of all the pending
`channel_announcement` messages by SCID and simply ignore duplicate
message lookups.

Author: TheBlueMatt

lightning/src/routing/gossip_checking.rs

@@ -90,6 +90,7 @@ impl AccessFuture {
 	pub fn resolve<L: Deref>(&self, graph: &NetworkGraph<L>, result: Result<TxOut, ChainAccessError>)
 	where L::Target: Logger {
 		let announcement = {
+			let mut pending_checks = graph.pending_checks.internal.lock().unwrap();
 			let mut async_messages = self.state.lock().unwrap();
 
 			if async_messages.channel_announce.is_none() {
@@ -99,6 +100,19 @@ impl AccessFuture {
 				async_messages.complete = Some(result);
 				return;
 			}
+			let announcement_msg = match async_messages.channel_announce.as_ref().unwrap() {
+				ChannelAnnouncement::Full(signed_msg) => &signed_msg.contents,
+				ChannelAnnouncement::Unsigned(msg) => &msg,
+			};
+
+			// First remove the pending entries for this lookup...
+			if let hash_map::Entry::Occupied(e) =
+				pending_checks.channels.entry(announcement_msg.short_channel_id)
+			{
+				if core::ptr::eq(Weak::as_ptr(e.get()), Arc::as_ptr(&self.state)) {
+					e.remove();
+				}
+			}
 
 			async_messages.channel_announce.take().unwrap()
 		};
@@ -119,13 +133,20 @@ impl AccessFuture {
 	}
 }
 
+struct PendingChecksContext {
+	channels: HashMap<u64, Weak<Mutex<AccessMessages>>>,
+}
+
 /// A set of messages which are pending UTXO lookups for processing.
 pub(super) struct PendingChecks {
+	internal: Mutex<PendingChecksContext>,
 }
 
 impl PendingChecks {
 	pub(super) fn new() -> Self {
-		PendingChecks {}
+		PendingChecks { internal: Mutex::new(PendingChecksContext {
+			channels: HashMap::new(),
+		}) }
 	}
 
 	pub(super) fn check_channel_announcement<A: Deref>(&self,
@@ -162,6 +183,60 @@ impl PendingChecks {
 			}
 		};
 
+		macro_rules! check_previous_entry {
+			($pending_channels: expr, $item_for_replace: expr) => {
+				match $pending_channels.entry(msg.short_channel_id) {
+					hash_map::Entry::Occupied(mut e) => {
+						// There's already a pending lookup for the given SCID. Check if the messages
+						// are the same and, if so, return immediately (don't bother spawning another
+						// lookup if we haven't gotten that far yet).
+						match Weak::upgrade(&e.get()) {
+							Some(pending_msgs) => {
+								let pending_matches = match &pending_msgs.lock().unwrap().channel_announce {
+									Some(ChannelAnnouncement::Full(pending_msg)) => Some(pending_msg) == full_msg,
+									Some(ChannelAnnouncement::Unsigned(pending_msg)) => pending_msg == msg,
+									None => {
+										// This shouldn't actually be reachable. We set the
+										// `channel_announce` field under the same lock as setting the
+										// channel map entry. Still, we can just treat it as
+										// non-matching and let the new request fly.
+										false
+									},
+								};
+								if pending_matches {
+									return Err(LightningError {
+										err: "Channel announcement is already being checked".to_owned(),
+										action: ErrorAction::IgnoreError,
+									});
+								} else {
+									// The earlier lookup is a different message. If we have another
+									// request in-flight now replace the original.
+									// Note that in the replace case whether to replace is somewhat
+									// arbitrary - both results will be handled, we're just updating the
+									// value that will be compared to future lookups with the same SCID.
+									if let Some(item) = $item_for_replace {
+										*e.get_mut() = item;
+									}
+								}
+							},
+							None => {
+								// The earlier lookup already resolved. We can't be sure its the same
+								// so just remove/replace it and move on.
+								if let Some(item) = $item_for_replace {
+									*e.get_mut() = item;
+								} else { e.remove(); }
+							},
+						}
+					},
+					hash_map::Entry::Vacant(v) => {
+						if let Some(item) = $item_for_replace { v.insert(item); }
+					},
+				}
+			}
+		}
+
+		check_previous_entry!(self.internal.lock().unwrap().channels, None);
+
 		match chain_access {
 			&None => {
 				// Tentatively accept, potentially exposing us to DoS attacks
@@ -171,12 +246,14 @@ impl PendingChecks {
 				match chain_access.get_utxo(&msg.chain_hash, msg.short_channel_id) {
 					ChainAccessResult::Sync(res) => handle_result(res),
 					ChainAccessResult::Async(future) => {
+						let mut pending_checks = self.internal.lock().unwrap();
 						let mut async_messages = future.state.lock().unwrap();
 						if let Some(res) = async_messages.complete.take() {
 							// In the unlikely event the future resolved before we managed to get it,
 							// handle the result in-line.
 							handle_result(res)
 						} else {
+							check_previous_entry!(pending_checks.channels, Some(Arc::downgrade(&future.state)));
 							async_messages.channel_announce = Some(
 								if let Some(msg) = full_msg { ChannelAnnouncement::Full(msg.clone()) }
 								else { ChannelAnnouncement::Unsigned(msg.clone()) });