Omit reminders for channels with incomplete data.
[rapid-gossip-sync-server] / src / lookup.rs
1 use std::collections::{BTreeMap, HashSet};
2 use std::io::Cursor;
3 use std::ops::Add;
4 use std::sync::Arc;
5 use std::time::{Duration, Instant, SystemTime};
6
7 use lightning::ln::msgs::{ChannelAnnouncement, ChannelUpdate, UnsignedChannelAnnouncement, UnsignedChannelUpdate};
8 use lightning::routing::gossip::NetworkGraph;
9 use lightning::util::ser::Readable;
10 use tokio_postgres::{Client, Connection, NoTls, Socket};
11 use tokio_postgres::tls::NoTlsStream;
12
13 use crate::{config, TestLogger};
14 use crate::serialization::MutatedProperties;
15
16 /// The delta set needs to be a BTreeMap so the keys are sorted.
17 /// That way, the scids in the response automatically grow monotonically
18 pub(super) type DeltaSet = BTreeMap<u64, ChannelDelta>;
19
20 pub(super) struct AnnouncementDelta {
21         pub(super) seen: u32,
22         pub(super) announcement: UnsignedChannelAnnouncement,
23 }
24
25 pub(super) struct UpdateDelta {
26         pub(super) seen: u32,
27         pub(super) update: UnsignedChannelUpdate,
28 }
29
30 pub(super) struct DirectedUpdateDelta {
31         pub(super) last_update_before_seen: Option<UnsignedChannelUpdate>,
32         pub(super) mutated_properties: MutatedProperties,
33         pub(super) latest_update_after_seen: Option<UpdateDelta>,
34         pub(super) serialization_update_flags: Option<u8>,
35 }
36
37 pub(super) struct ChannelDelta {
38         pub(super) announcement: Option<AnnouncementDelta>,
39         pub(super) updates: (Option<DirectedUpdateDelta>, Option<DirectedUpdateDelta>),
40         pub(super) first_bidirectional_updates_seen: Option<u32>,
41         /// The seen timestamp of the older of the two latest directional updates
42         pub(super) requires_reminder: bool,
43 }
44
45 impl Default for ChannelDelta {
46         fn default() -> Self {
47                 Self {
48                         announcement: None,
49                         updates: (None, None),
50                         first_bidirectional_updates_seen: None,
51                         requires_reminder: false,
52                 }
53         }
54 }
55
56 impl Default for DirectedUpdateDelta {
57         fn default() -> Self {
58                 Self {
59                         last_update_before_seen: None,
60                         mutated_properties: MutatedProperties::default(),
61                         latest_update_after_seen: None,
62                         serialization_update_flags: None,
63                 }
64         }
65 }
66
67 pub(super) async fn connect_to_db() -> (Client, Connection<Socket, NoTlsStream>) {
68         let connection_config = config::db_connection_config();
69         connection_config.connect(NoTls).await.unwrap()
70 }
71
72 /// Fetch all the channel announcements that are presently in the network graph, regardless of
73 /// whether they had been seen before.
74 /// Also include all announcements for which the first update was announced
75 /// after `last_sync_timestamp`
76 pub(super) async fn fetch_channel_announcements(delta_set: &mut DeltaSet, network_graph: Arc<NetworkGraph<TestLogger>>, client: &Client, last_sync_timestamp: u32) {
77         println!("Obtaining channel ids from network graph");
78         let channel_ids = {
79                 let read_only_graph = network_graph.read_only();
80                 println!("Retrieved read-only network graph copy");
81                 let channel_iterator = read_only_graph.channels().unordered_iter();
82                 channel_iterator
83                         .filter(|c| c.1.announcement_message.is_some())
84                         .map(|c| c.1.announcement_message.as_ref().unwrap().contents.short_channel_id as i64)
85                         .collect::<Vec<_>>()
86         };
87
88         println!("Obtaining corresponding database entries");
89         // get all the channel announcements that are currently in the network graph
90         let announcement_rows = client.query("SELECT announcement_signed, seen FROM channel_announcements WHERE short_channel_id = any($1) ORDER BY short_channel_id ASC", &[&channel_ids]).await.unwrap();
91
92         for current_announcement_row in announcement_rows {
93                 let blob: Vec<u8> = current_announcement_row.get("announcement_signed");
94                 let mut readable = Cursor::new(blob);
95                 let unsigned_announcement = ChannelAnnouncement::read(&mut readable).unwrap().contents;
96
97                 let scid = unsigned_announcement.short_channel_id;
98                 let current_seen_timestamp_object: SystemTime = current_announcement_row.get("seen");
99                 let current_seen_timestamp: u32 = current_seen_timestamp_object.duration_since(SystemTime::UNIX_EPOCH).unwrap().as_secs() as u32;
100
101                 let current_channel_delta = delta_set.entry(scid).or_insert(ChannelDelta::default());
102                 (*current_channel_delta).announcement = Some(AnnouncementDelta {
103                         announcement: unsigned_announcement,
104                         seen: current_seen_timestamp,
105                 });
106         }
107
108         {
109                 // THIS STEP IS USED TO DETERMINE IF A CHANNEL SHOULD BE OMITTED FROM THE DELTA
110
111                 println!("Annotating channel announcements whose oldest channel update in a given direction occurred after the last sync");
112                 // Steps:
113                 // — Obtain all updates, distinct by (scid, direction), ordered by seen DESC // to find the oldest update in a given direction
114                 // — From those updates, select distinct by (scid), ordered by seen DESC (to obtain the newer one per direction)
115                 // This will allow us to mark the first time updates in both directions were seen
116
117                 // here is where the channels whose first update in either direction occurred after
118                 // `last_seen_timestamp` are added to the selection
119                 let newer_oldest_directional_updates = client.query("
120                 SELECT DISTINCT ON (short_channel_id) *
121                 FROM (
122                         SELECT DISTINCT ON (short_channel_id, direction) blob_signed
123                         FROM channel_updates
124                         WHERE short_channel_id = any($1)
125                         ORDER BY seen ASC, short_channel_id ASC, direction ASC
126                 ) AS directional_last_seens
127                 ORDER BY short_channel_id ASC, seen DESC
128         ", &[&channel_ids]).await.unwrap();
129
130                 for current_row in newer_oldest_directional_updates {
131                         let blob: Vec<u8> = current_row.get("blob_signed");
132                         let mut readable = Cursor::new(blob);
133                         let unsigned_update = ChannelUpdate::read(&mut readable).unwrap().contents;
134                         let scid = unsigned_update.short_channel_id;
135                         let current_seen_timestamp_object: SystemTime = current_row.get("seen");
136                         let current_seen_timestamp: u32 = current_seen_timestamp_object.duration_since(SystemTime::UNIX_EPOCH).unwrap().as_secs() as u32;
137
138                         if current_seen_timestamp > last_sync_timestamp {
139                                 // the newer of the two oldest seen directional updates came after last sync timestamp
140                                 let current_channel_delta = delta_set.entry(scid).or_insert(ChannelDelta::default());
141                                 // first time a channel was seen in both directions
142                                 (*current_channel_delta).first_bidirectional_updates_seen = Some(current_seen_timestamp);
143                         }
144                 }
145         }
146
147         {
148                 // THIS STEP IS USED TO DETERMINE IF A REMINDER UPDATE SHOULD BE SENT
149
150                 println!("Annotating channel announcements whose latest channel update in a given direction occurred more than six days ago");
151                 // Steps:
152                 // — Obtain all updates, distinct by (scid, direction), ordered by seen DESC
153                 // — From those updates, select distinct by (scid), ordered by seen ASC (to obtain the older one per direction)
154                 let current_timestamp = SystemTime::now().duration_since(SystemTime::UNIX_EPOCH).unwrap().as_secs() as u32;
155                 let reminder_threshold_timestamp = current_timestamp.saturating_sub(config::CHANNEL_REMINDER_AGE);
156                 let read_only_graph = network_graph.read_only();
157
158                 let older_latest_directional_updates = client.query("
159                 SELECT DISTINCT ON (short_channel_id) *
160                 FROM (
161                         SELECT DISTINCT ON (short_channel_id, direction) *
162                         FROM channel_updates
163                         WHERE short_channel_id = any($1)
164                         ORDER BY short_channel_id ASC, direction ASC, seen DESC
165                 ) AS directional_last_seens
166                 ORDER BY short_channel_id ASC, seen ASC
167         ", &[&channel_ids]).await.unwrap();
168
169                 for current_row in older_latest_directional_updates {
170                         let blob: Vec<u8> = current_row.get("blob_signed");
171                         let mut readable = Cursor::new(blob);
172                         let unsigned_update = ChannelUpdate::read(&mut readable).unwrap().contents;
173                         let scid = unsigned_update.short_channel_id;
174                         let current_seen_timestamp_object: SystemTime = current_row.get("seen");
175                         let current_seen_timestamp: u32 = current_seen_timestamp_object.duration_since(SystemTime::UNIX_EPOCH).unwrap().as_secs() as u32;
176
177                         if current_seen_timestamp <= reminder_threshold_timestamp {
178                                 // annotate this channel as requiring that reminders be sent to the client
179                                 let current_channel_delta = delta_set.entry(scid).or_insert(ChannelDelta::default());
180
181                                 // way might be able to get away with not using this
182                                 (*current_channel_delta).requires_reminder = true;
183
184                                 if let Some(current_channel_info) = read_only_graph.channel(scid) {
185                                         if current_channel_info.one_to_two.is_none() || current_channel_info.two_to_one.is_none() {
186                                                 // we don't send reminders if we don't have bidirectional update data
187                                                 continue;
188                                         }
189
190                                         if let Some(info) = current_channel_info.one_to_two.as_ref() {
191                                                 let flags: u8 = if info.enabled { 0 } else { 2 };
192                                                 let current_update = (*current_channel_delta).updates.0.get_or_insert(DirectedUpdateDelta::default());
193                                                 current_update.serialization_update_flags = Some(flags);
194                                         }
195
196                                         if let Some(info) = current_channel_info.two_to_one.as_ref() {
197                                                 let flags: u8 = if info.enabled { 1 } else { 3 };
198                                                 let current_update = (*current_channel_delta).updates.1.get_or_insert(DirectedUpdateDelta::default());
199                                                 current_update.serialization_update_flags = Some(flags);
200                                         }
201                                 } else {
202                                         // we don't send reminders if we don't have the channel
203                                         continue;
204                                 }
205                         }
206                 }
207         }
208 }
209
210 pub(super) async fn fetch_channel_updates(delta_set: &mut DeltaSet, client: &Client, last_sync_timestamp: u32, consider_intermediate_updates: bool) {
211         let start = Instant::now();
212         let last_sync_timestamp_object = SystemTime::UNIX_EPOCH.add(Duration::from_secs(last_sync_timestamp as u64));
213
214         // get the latest channel update in each direction prior to last_sync_timestamp, provided
215         // there was an update in either direction that happened after the last sync (to avoid
216         // collecting too many reference updates)
217         let reference_rows = client.query("SELECT DISTINCT ON (short_channel_id, direction) id, direction, blob_signed FROM channel_updates WHERE seen < $1 AND short_channel_id IN (SELECT short_channel_id FROM channel_updates WHERE seen >= $1 GROUP BY short_channel_id) ORDER BY short_channel_id ASC, direction ASC, seen DESC", &[&last_sync_timestamp_object]).await.unwrap();
218
219         println!("Fetched reference rows ({}): {:?}", reference_rows.len(), start.elapsed());
220
221         let mut last_seen_update_ids: Vec<i32> = Vec::with_capacity(reference_rows.len());
222         let mut non_intermediate_ids: HashSet<i32> = HashSet::new();
223
224         for current_reference in reference_rows {
225                 let update_id: i32 = current_reference.get("id");
226                 last_seen_update_ids.push(update_id);
227                 non_intermediate_ids.insert(update_id);
228
229                 let direction: bool = current_reference.get("direction");
230                 let blob: Vec<u8> = current_reference.get("blob_signed");
231                 let mut readable = Cursor::new(blob);
232                 let unsigned_channel_update = ChannelUpdate::read(&mut readable).unwrap().contents;
233                 let scid = unsigned_channel_update.short_channel_id;
234
235                 let current_channel_delta = delta_set.entry(scid).or_insert(ChannelDelta::default());
236                 let update_delta = if !direction {
237                         (*current_channel_delta).updates.0.get_or_insert(DirectedUpdateDelta::default())
238                 } else {
239                         (*current_channel_delta).updates.1.get_or_insert(DirectedUpdateDelta::default())
240                 };
241                 update_delta.last_update_before_seen = Some(unsigned_channel_update);
242         }
243
244         println!("Processed reference rows (delta size: {}): {:?}", delta_set.len(), start.elapsed());
245
246         // get all the intermediate channel updates
247         // (to calculate the set of mutated fields for snapshotting, where intermediate updates may
248         // have been omitted)
249
250         let mut intermediate_update_prefix = "";
251         if !consider_intermediate_updates {
252                 intermediate_update_prefix = "DISTINCT ON (short_channel_id, direction)";
253         }
254
255         let query_string = format!("SELECT {} id, direction, blob_signed, seen FROM channel_updates WHERE seen >= $1 ORDER BY short_channel_id ASC, direction ASC, seen DESC", intermediate_update_prefix);
256         let intermediate_updates = client.query(&query_string, &[&last_sync_timestamp_object]).await.unwrap();
257         println!("Fetched intermediate rows ({}): {:?}", intermediate_updates.len(), start.elapsed());
258
259         let mut previous_scid = u64::MAX;
260         let mut previously_seen_directions = (false, false);
261
262         // let mut previously_seen_directions = (false, false);
263         let mut intermediate_update_count = 0;
264         for intermediate_update in intermediate_updates {
265                 let update_id: i32 = intermediate_update.get("id");
266                 if non_intermediate_ids.contains(&update_id) {
267                         continue;
268                 }
269                 intermediate_update_count += 1;
270
271                 let direction: bool = intermediate_update.get("direction");
272                 let current_seen_timestamp_object: SystemTime = intermediate_update.get("seen");
273                 let current_seen_timestamp: u32 = current_seen_timestamp_object.duration_since(SystemTime::UNIX_EPOCH).unwrap().as_secs() as u32;
274                 let blob: Vec<u8> = intermediate_update.get("blob_signed");
275                 let mut readable = Cursor::new(blob);
276                 let unsigned_channel_update = ChannelUpdate::read(&mut readable).unwrap().contents;
277
278                 let scid = unsigned_channel_update.short_channel_id;
279                 if scid != previous_scid {
280                         previous_scid = scid;
281                         previously_seen_directions = (false, false);
282                 }
283
284                 // get the write configuration for this particular channel's directional details
285                 let current_channel_delta = delta_set.entry(scid).or_insert(ChannelDelta::default());
286                 let update_delta = if !direction {
287                         (*current_channel_delta).updates.0.get_or_insert(DirectedUpdateDelta::default())
288                 } else {
289                         (*current_channel_delta).updates.1.get_or_insert(DirectedUpdateDelta::default())
290                 };
291
292                 {
293                         // handle the latest deltas
294                         if !direction && !previously_seen_directions.0 {
295                                 previously_seen_directions.0 = true;
296                                 update_delta.latest_update_after_seen = Some(UpdateDelta {
297                                         seen: current_seen_timestamp,
298                                         update: unsigned_channel_update.clone(),
299                                 });
300                         } else if direction && !previously_seen_directions.1 {
301                                 previously_seen_directions.1 = true;
302                                 update_delta.latest_update_after_seen = Some(UpdateDelta {
303                                         seen: current_seen_timestamp,
304                                         update: unsigned_channel_update.clone(),
305                                 });
306                         }
307                 }
308
309                 // determine mutations
310                 if let Some(last_seen_update) = update_delta.last_update_before_seen.as_ref() {
311                         if unsigned_channel_update.flags != last_seen_update.flags {
312                                 update_delta.mutated_properties.flags = true;
313                         }
314                         if unsigned_channel_update.cltv_expiry_delta != last_seen_update.cltv_expiry_delta {
315                                 update_delta.mutated_properties.cltv_expiry_delta = true;
316                         }
317                         if unsigned_channel_update.htlc_minimum_msat != last_seen_update.htlc_minimum_msat {
318                                 update_delta.mutated_properties.htlc_minimum_msat = true;
319                         }
320                         if unsigned_channel_update.fee_base_msat != last_seen_update.fee_base_msat {
321                                 update_delta.mutated_properties.fee_base_msat = true;
322                         }
323                         if unsigned_channel_update.fee_proportional_millionths != last_seen_update.fee_proportional_millionths {
324                                 update_delta.mutated_properties.fee_proportional_millionths = true;
325                         }
326                         if unsigned_channel_update.htlc_maximum_msat != last_seen_update.htlc_maximum_msat {
327                                 update_delta.mutated_properties.htlc_maximum_msat = true;
328                         }
329                 }
330         }
331         println!("Processed intermediate rows ({}) (delta size: {}): {:?}", intermediate_update_count, delta_set.len(), start.elapsed());
332 }
333
334 pub(super) fn filter_delta_set(delta_set: &mut DeltaSet) {
335         let original_length = delta_set.len();
336         let keys: Vec<u64> = delta_set.keys().cloned().collect();
337         for k in keys {
338                 let v = delta_set.get(&k).unwrap();
339                 if v.announcement.is_none() {
340                         // this channel is not currently in the network graph
341                         delta_set.remove(&k);
342                         continue;
343                 }
344
345                 let update_meets_criteria = |update: &Option<DirectedUpdateDelta>| {
346                         if update.is_none() {
347                                 return false;
348                         };
349                         let update_reference = update.as_ref().unwrap();
350                         // update_reference.latest_update_after_seen.is_some() && !update_reference.intermediate_updates.is_empty()
351                         // if there has been an update after the channel was first seen
352
353                         v.requires_reminder || update_reference.latest_update_after_seen.is_some()
354                 };
355
356                 let direction_a_meets_criteria = update_meets_criteria(&v.updates.0);
357                 let direction_b_meets_criteria = update_meets_criteria(&v.updates.1);
358
359                 if !v.requires_reminder && !direction_a_meets_criteria && !direction_b_meets_criteria {
360                         delta_set.remove(&k);
361                 }
362         }
363
364         let new_length = delta_set.len();
365         if original_length != new_length {
366                 println!("length modified!");
367         }
368 }