b905c53f3b877f27b12e21d8fd816f9864a6a1a0
[rapid-gossip-sync-server] / src / config.rs
1 use crate::hex_utils;
2
3 use std::convert::TryInto;
4 use std::env;
5 use std::io::Cursor;
6 use std::net::{SocketAddr, ToSocketAddrs};
7 use std::time::Duration;
8
9 use bitcoin::Network;
10 use bitcoin::hashes::hex::FromHex;
11 use bitcoin::secp256k1::PublicKey;
12 use futures::stream::{FuturesUnordered, StreamExt};
13 use lightning::ln::msgs::ChannelAnnouncement;
14 use lightning::util::ser::Readable;
15 use lightning_block_sync::http::HttpEndpoint;
16 use tokio_postgres::Config;
17
18 pub(crate) const SCHEMA_VERSION: i32 = 12;
19 pub(crate) const SYMLINK_GRANULARITY_INTERVAL: u32 = 3600 * 3; // three hours
20 pub(crate) const MAX_SNAPSHOT_SCOPE: u32 = 3600 * 24 * 21; // three weeks
21 // generate symlinks based on a 3-hour-granularity
22 /// If the last update in either direction was more than six days ago, we send a reminder
23 /// That reminder may be either in the form of a channel announcement, or in the form of empty
24 /// updates in both directions.
25 pub(crate) const CHANNEL_REMINDER_AGE: Duration = Duration::from_secs(6 * 24 * 60 * 60);
26 pub(crate) const DOWNLOAD_NEW_GOSSIP: bool = true;
27
28 pub(crate) fn snapshot_generation_interval() -> u32 {
29         let interval = env::var("RAPID_GOSSIP_SYNC_SERVER_SNAPSHOT_INTERVAL").unwrap_or(SYMLINK_GRANULARITY_INTERVAL.to_string())
30                 .parse::<u32>()
31                 .expect("RAPID_GOSSIP_SYNC_SERVER_SNAPSHOT_INTERVAL env variable must be a u32.");
32         assert!(interval > 0, "RAPID_GOSSIP_SYNC_SERVER_SNAPSHOT_INTERVAL must be positive");
33         assert_eq!(interval % SYMLINK_GRANULARITY_INTERVAL, 0, "RAPID_GOSSIP_SYNC_SERVER_SNAPSHOT_INTERVAL must be a multiple of {} (seconds)", SYMLINK_GRANULARITY_INTERVAL);
34         interval
35 }
36
37 pub(crate) fn network() -> Network {
38         let network = env::var("RAPID_GOSSIP_SYNC_SERVER_NETWORK").unwrap_or("bitcoin".to_string()).to_lowercase();
39         match network.as_str() {
40                 "mainnet" => Network::Bitcoin,
41                 "bitcoin" => Network::Bitcoin,
42                 "testnet" => Network::Testnet,
43                 "signet" => Network::Signet,
44                 "regtest" => Network::Regtest,
45                 _ => panic!("Invalid network"),
46         }
47 }
48
49 pub(crate) fn log_level() -> lightning::util::logger::Level {
50         let level = env::var("RAPID_GOSSIP_SYNC_SERVER_LOG_LEVEL").unwrap_or("info".to_string()).to_lowercase();
51         match level.as_str() {
52                 "gossip" => lightning::util::logger::Level::Gossip,
53                 "trace" => lightning::util::logger::Level::Trace,
54                 "debug" => lightning::util::logger::Level::Debug,
55                 "info" => lightning::util::logger::Level::Info,
56                 "warn" => lightning::util::logger::Level::Warn,
57                 "error" => lightning::util::logger::Level::Error,
58                 _ => panic!("Invalid log level"),
59         }
60 }
61
62 pub(crate) fn network_graph_cache_path() -> String {
63         format!("{}/network_graph.bin", cache_path())
64 }
65
66 pub(crate) fn cache_path() -> String {
67         let path = env::var("RAPID_GOSSIP_SYNC_SERVER_CACHES_PATH").unwrap_or("./res".to_string()).to_lowercase();
68         path
69 }
70
71 pub(crate) fn db_connection_config() -> Config {
72         let mut config = Config::new();
73         let host = env::var("RAPID_GOSSIP_SYNC_SERVER_DB_HOST").unwrap_or("localhost".to_string());
74         let user = env::var("RAPID_GOSSIP_SYNC_SERVER_DB_USER").unwrap_or("alice".to_string());
75         let db = env::var("RAPID_GOSSIP_SYNC_SERVER_DB_NAME").unwrap_or("ln_graph_sync".to_string());
76         config.host(&host);
77         config.user(&user);
78         config.dbname(&db);
79         if let Ok(password) = env::var("RAPID_GOSSIP_SYNC_SERVER_DB_PASSWORD") {
80                 config.password(&password);
81         }
82         config
83 }
84
85 pub(crate) fn bitcoin_rest_endpoint() -> HttpEndpoint {
86         let host = env::var("BITCOIN_REST_DOMAIN").unwrap_or("127.0.0.1".to_string());
87         let port = env::var("BITCOIN_REST_PORT")
88                 .unwrap_or("8332".to_string())
89                 .parse::<u16>()
90                 .expect("BITCOIN_REST_PORT env variable must be a u16.");
91         let path = env::var("BITCOIN_REST_PATH").unwrap_or("/rest/".to_string());
92         HttpEndpoint::for_host(host).with_port(port).with_path(path)
93 }
94
95 pub(crate) fn db_config_table_creation_query() -> &'static str {
96         "CREATE TABLE IF NOT EXISTS config (
97                 id SERIAL PRIMARY KEY,
98                 db_schema integer
99         )"
100 }
101
102 pub(crate) fn db_announcement_table_creation_query() -> &'static str {
103         "CREATE TABLE IF NOT EXISTS channel_announcements (
104                 id SERIAL PRIMARY KEY,
105                 short_channel_id bigint NOT NULL UNIQUE,
106                 announcement_signed BYTEA,
107                 seen timestamp NOT NULL DEFAULT NOW()
108         )"
109 }
110
111 pub(crate) fn db_channel_update_table_creation_query() -> &'static str {
112         "CREATE TABLE IF NOT EXISTS channel_updates (
113                 id SERIAL PRIMARY KEY,
114                 short_channel_id bigint NOT NULL,
115                 timestamp bigint NOT NULL,
116                 channel_flags smallint NOT NULL,
117                 direction boolean NOT NULL,
118                 disable boolean NOT NULL,
119                 cltv_expiry_delta integer NOT NULL,
120                 htlc_minimum_msat bigint NOT NULL,
121                 fee_base_msat integer NOT NULL,
122                 fee_proportional_millionths integer NOT NULL,
123                 htlc_maximum_msat bigint NOT NULL,
124                 blob_signed BYTEA NOT NULL,
125                 seen timestamp NOT NULL DEFAULT NOW()
126         )"
127 }
128
129 pub(crate) fn db_index_creation_query() -> &'static str {
130         "
131         CREATE INDEX IF NOT EXISTS channel_updates_seen_scid ON channel_updates(seen, short_channel_id);
132         CREATE INDEX IF NOT EXISTS channel_updates_scid_dir_seen_asc ON channel_updates(short_channel_id, direction, seen);
133         CREATE INDEX IF NOT EXISTS channel_updates_scid_dir_seen_desc_with_id ON channel_updates(short_channel_id ASC, direction ASC, seen DESC) INCLUDE (id);
134         CREATE UNIQUE INDEX IF NOT EXISTS channel_updates_key ON channel_updates (short_channel_id, direction, timestamp);
135         CREATE INDEX IF NOT EXISTS channel_updates_seen ON channel_updates(seen);
136         CREATE INDEX IF NOT EXISTS channel_updates_timestamp_desc ON channel_updates(timestamp DESC);
137         "
138 }
139
140 pub(crate) async fn upgrade_db(schema: i32, client: &mut tokio_postgres::Client) {
141         if schema == 1 {
142                 let tx = client.transaction().await.unwrap();
143                 tx.execute("ALTER TABLE channel_updates DROP COLUMN chain_hash", &[]).await.unwrap();
144                 tx.execute("ALTER TABLE channel_announcements DROP COLUMN chain_hash", &[]).await.unwrap();
145                 tx.execute("UPDATE config SET db_schema = 2 WHERE id = 1", &[]).await.unwrap();
146                 tx.commit().await.unwrap();
147         }
148         if schema == 1 || schema == 2 {
149                 let tx = client.transaction().await.unwrap();
150                 tx.execute("ALTER TABLE channel_updates DROP COLUMN short_channel_id", &[]).await.unwrap();
151                 tx.execute("ALTER TABLE channel_updates ADD COLUMN short_channel_id bigint DEFAULT null", &[]).await.unwrap();
152                 tx.execute("ALTER TABLE channel_updates DROP COLUMN direction", &[]).await.unwrap();
153                 tx.execute("ALTER TABLE channel_updates ADD COLUMN direction boolean DEFAULT null", &[]).await.unwrap();
154                 loop {
155                         let rows = tx.query("SELECT id, composite_index FROM channel_updates WHERE short_channel_id IS NULL LIMIT 50000", &[]).await.unwrap();
156                         if rows.is_empty() { break; }
157                         let mut updates = FuturesUnordered::new();
158                         for row in rows {
159                                 let id: i32 = row.get("id");
160                                 let index: String = row.get("composite_index");
161                                 let tx_ref = &tx;
162                                 updates.push(async move {
163                                         let mut index_iter = index.split(":");
164                                         let scid_hex = index_iter.next().unwrap();
165                                         index_iter.next().unwrap();
166                                         let direction_str = index_iter.next().unwrap();
167                                         assert!(direction_str == "1" || direction_str == "0");
168                                         let direction = direction_str == "1";
169                                         let scid_be_bytes = hex_utils::to_vec(scid_hex).unwrap();
170                                         let scid = i64::from_be_bytes(scid_be_bytes.try_into().unwrap());
171                                         assert!(scid > 0); // Will roll over in some 150 years or so
172                                         tx_ref.execute("UPDATE channel_updates SET short_channel_id = $1, direction = $2 WHERE id = $3", &[&scid, &direction, &id]).await.unwrap();
173                                 });
174                         }
175                         while let Some(_) = updates.next().await {}
176                 }
177                 tx.execute("ALTER TABLE channel_updates ALTER short_channel_id DROP DEFAULT", &[]).await.unwrap();
178                 tx.execute("ALTER TABLE channel_updates ALTER short_channel_id SET NOT NULL", &[]).await.unwrap();
179                 tx.execute("ALTER TABLE channel_updates ALTER direction DROP DEFAULT", &[]).await.unwrap();
180                 tx.execute("ALTER TABLE channel_updates ALTER direction SET NOT NULL", &[]).await.unwrap();
181                 tx.execute("UPDATE config SET db_schema = 3 WHERE id = 1", &[]).await.unwrap();
182                 tx.commit().await.unwrap();
183         }
184         if schema >= 1 && schema <= 3 {
185                 let tx = client.transaction().await.unwrap();
186                 tx.execute("ALTER TABLE channel_announcements DROP COLUMN short_channel_id", &[]).await.unwrap();
187                 tx.execute("ALTER TABLE channel_announcements ADD COLUMN short_channel_id bigint DEFAULT null", &[]).await.unwrap();
188                 loop {
189                         let rows = tx.query("SELECT id, announcement_signed FROM channel_announcements WHERE short_channel_id IS NULL LIMIT 10000", &[]).await.unwrap();
190                         if rows.is_empty() { break; }
191                         let mut updates = FuturesUnordered::new();
192                         for row in rows {
193                                 let id: i32 = row.get("id");
194                                 let announcement: Vec<u8> = row.get("announcement_signed");
195                                 let tx_ref = &tx;
196                                 updates.push(async move {
197                                         let scid = ChannelAnnouncement::read(&mut Cursor::new(announcement)).unwrap().contents.short_channel_id as i64;
198                                         assert!(scid > 0); // Will roll over in some 150 years or so
199                                         tx_ref.execute("UPDATE channel_announcements SET short_channel_id = $1 WHERE id = $2", &[&scid, &id]).await.unwrap();
200                                 });
201                         }
202                         while let Some(_) = updates.next().await {}
203                 }
204                 tx.execute("ALTER TABLE channel_announcements ADD CONSTRAINT channel_announcements_short_channel_id_key UNIQUE (short_channel_id)", &[]).await.unwrap();
205                 tx.execute("ALTER TABLE channel_announcements ALTER short_channel_id DROP DEFAULT", &[]).await.unwrap();
206                 tx.execute("ALTER TABLE channel_announcements ALTER short_channel_id SET NOT NULL", &[]).await.unwrap();
207                 tx.execute("UPDATE config SET db_schema = 4 WHERE id = 1", &[]).await.unwrap();
208                 tx.commit().await.unwrap();
209         }
210         if schema >= 1 && schema <= 4 {
211                 let tx = client.transaction().await.unwrap();
212                 tx.execute("ALTER TABLE channel_updates ALTER composite_index SET DATA TYPE character(29)", &[]).await.unwrap();
213                 tx.execute("UPDATE config SET db_schema = 5 WHERE id = 1", &[]).await.unwrap();
214                 tx.commit().await.unwrap();
215         }
216         if schema >= 1 && schema <= 5 {
217                 let tx = client.transaction().await.unwrap();
218                 tx.execute("ALTER TABLE channel_updates ALTER channel_flags SET DATA TYPE smallint", &[]).await.unwrap();
219                 tx.execute("ALTER TABLE channel_announcements DROP COLUMN block_height", &[]).await.unwrap();
220                 tx.execute("UPDATE config SET db_schema = 6 WHERE id = 1", &[]).await.unwrap();
221                 tx.commit().await.unwrap();
222         }
223         if schema >= 1 && schema <= 6 {
224                 let tx = client.transaction().await.unwrap();
225                 tx.execute("ALTER TABLE channel_updates DROP COLUMN composite_index", &[]).await.unwrap();
226                 tx.execute("ALTER TABLE channel_updates ALTER timestamp SET NOT NULL", &[]).await.unwrap();
227                 tx.execute("ALTER TABLE channel_updates ALTER channel_flags SET NOT NULL", &[]).await.unwrap();
228                 tx.execute("ALTER TABLE channel_updates ALTER disable SET NOT NULL", &[]).await.unwrap();
229                 tx.execute("ALTER TABLE channel_updates ALTER cltv_expiry_delta SET NOT NULL", &[]).await.unwrap();
230                 tx.execute("ALTER TABLE channel_updates ALTER htlc_minimum_msat SET NOT NULL", &[]).await.unwrap();
231                 tx.execute("ALTER TABLE channel_updates ALTER fee_base_msat SET NOT NULL", &[]).await.unwrap();
232                 tx.execute("ALTER TABLE channel_updates ALTER fee_proportional_millionths SET NOT NULL", &[]).await.unwrap();
233                 tx.execute("ALTER TABLE channel_updates ALTER htlc_maximum_msat SET NOT NULL", &[]).await.unwrap();
234                 tx.execute("ALTER TABLE channel_updates ALTER blob_signed SET NOT NULL", &[]).await.unwrap();
235                 tx.execute("CREATE UNIQUE INDEX channel_updates_key ON channel_updates (short_channel_id, direction, timestamp)", &[]).await.unwrap();
236                 tx.execute("UPDATE config SET db_schema = 7 WHERE id = 1", &[]).await.unwrap();
237                 tx.commit().await.unwrap();
238         }
239         if schema >= 1 && schema <= 7 {
240                 let tx = client.transaction().await.unwrap();
241                 tx.execute("DROP INDEX IF EXISTS channels_seen", &[]).await.unwrap();
242                 tx.execute("DROP INDEX IF EXISTS channel_updates_scid", &[]).await.unwrap();
243                 tx.execute("DROP INDEX IF EXISTS channel_updates_direction", &[]).await.unwrap();
244                 tx.execute("DROP INDEX IF EXISTS channel_updates_seen", &[]).await.unwrap();
245                 tx.execute("DROP INDEX IF EXISTS channel_updates_scid_seen", &[]).await.unwrap();
246                 tx.execute("DROP INDEX IF EXISTS channel_updates_scid_dir_seen", &[]).await.unwrap();
247                 tx.execute("UPDATE config SET db_schema = 8 WHERE id = 1", &[]).await.unwrap();
248                 tx.commit().await.unwrap();
249         }
250         if schema >= 1 && schema <= 8 {
251                 let tx = client.transaction().await.unwrap();
252                 tx.execute("DROP INDEX IF EXISTS channel_updates_seen", &[]).await.unwrap();
253                 tx.execute("DROP INDEX IF EXISTS channel_updates_scid_seen", &[]).await.unwrap();
254                 tx.execute("UPDATE config SET db_schema = 9 WHERE id = 1", &[]).await.unwrap();
255                 tx.commit().await.unwrap();
256         }
257         if schema >= 1 && schema <= 9 {
258                 let tx = client.transaction().await.unwrap();
259                 tx.execute("DROP INDEX IF EXISTS channel_updates_scid_dir_seen", &[]).await.unwrap();
260                 tx.execute("UPDATE config SET db_schema = 10 WHERE id = 1", &[]).await.unwrap();
261                 tx.commit().await.unwrap();
262         }
263         if schema >= 1 && schema <= 10 {
264                 let tx = client.transaction().await.unwrap();
265                 tx.execute("DROP INDEX IF EXISTS channel_updates_id_with_scid_dir_blob", &[]).await.unwrap();
266                 tx.execute("UPDATE config SET db_schema = 11 WHERE id = 1", &[]).await.unwrap();
267                 tx.commit().await.unwrap();
268         }
269         if schema >= 1 && schema <= 11 {
270                 let tx = client.transaction().await.unwrap();
271                 tx.execute("DROP INDEX IF EXISTS channel_updates_seen_with_id_direction_blob", &[]).await.unwrap();
272                 tx.execute("UPDATE config SET db_schema = 12 WHERE id = 1", &[]).await.unwrap();
273                 tx.commit().await.unwrap();
274         }
275         if schema <= 1 || schema > SCHEMA_VERSION {
276                 panic!("Unknown schema in db: {}, we support up to {}", schema, SCHEMA_VERSION);
277         }
278         // PostgreSQL (at least v13, but likely later versions as well) handles insert-only tables
279         // *very* poorly. After some number of inserts, it refuses to rely on indexes, assuming them to
280         // be possibly-stale, until a VACUUM happens. Thus, we set the vacuum factor really low here,
281         // pushing PostgreSQL to vacuum often.
282         // See https://www.cybertec-postgresql.com/en/postgresql-autovacuum-insert-only-tables/
283         let _ = client.execute("ALTER TABLE channel_updates SET ( autovacuum_vacuum_insert_scale_factor = 0.005 );", &[]).await;
284         let _ = client.execute("ALTER TABLE channel_announcements SET ( autovacuum_vacuum_insert_scale_factor = 0.005 );", &[]).await;
285 }
286
287 pub(crate) fn ln_peers() -> Vec<(PublicKey, SocketAddr)> {
288         const WALLET_OF_SATOSHI: &str = "035e4ff418fc8b5554c5d9eea66396c227bd429a3251c8cbc711002ba215bfc226@170.75.163.209:9735";
289         let list = env::var("LN_PEERS").unwrap_or(WALLET_OF_SATOSHI.to_string());
290         let mut peers = Vec::new();
291         for peer_info in list.split(',') {
292                 peers.push(resolve_peer_info(peer_info).expect("Invalid peer info in LN_PEERS"));
293         }
294         peers
295 }
296
297 fn resolve_peer_info(peer_info: &str) -> Result<(PublicKey, SocketAddr), &str> {
298         let mut peer_info = peer_info.splitn(2, '@');
299
300         let pubkey = peer_info.next().ok_or("Invalid peer info. Should be formatted as: `pubkey@host:port`")?;
301         let pubkey = Vec::from_hex(pubkey).map_err(|_| "Invalid node pubkey")?;
302         let pubkey = PublicKey::from_slice(&pubkey).map_err(|_| "Invalid node pubkey")?;
303
304         let socket_address = peer_info.next().ok_or("Invalid peer info. Should be formatted as: `pubkey@host:port`")?;
305         let socket_address = socket_address
306                 .to_socket_addrs()
307                 .map_err(|_| "Cannot resolve node address")?
308                 .next()
309                 .ok_or("Cannot resolve node address")?;
310
311         Ok((pubkey, socket_address))
312 }
313
314 #[cfg(test)]
315 mod tests {
316         use super::resolve_peer_info;
317         use bitcoin::hashes::hex::ToHex;
318
319         #[test]
320         fn test_resolve_peer_info() {
321                 let wallet_of_satoshi = "035e4ff418fc8b5554c5d9eea66396c227bd429a3251c8cbc711002ba215bfc226@170.75.163.209:9735";
322                 let (pubkey, socket_address) = resolve_peer_info(wallet_of_satoshi).unwrap();
323                 assert_eq!(pubkey.serialize().to_hex(), "035e4ff418fc8b5554c5d9eea66396c227bd429a3251c8cbc711002ba215bfc226");
324                 assert_eq!(socket_address.to_string(), "170.75.163.209:9735");
325
326                 let ipv6 = "033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025@[2001:db8::1]:80";
327                 let (pubkey, socket_address) = resolve_peer_info(ipv6).unwrap();
328                 assert_eq!(pubkey.serialize().to_hex(), "033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025");
329                 assert_eq!(socket_address.to_string(), "[2001:db8::1]:80");
330
331                 let localhost = "033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025@localhost:9735";
332                 let (pubkey, socket_address) = resolve_peer_info(localhost).unwrap();
333                 assert_eq!(pubkey.serialize().to_hex(), "033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025");
334                 let socket_address = socket_address.to_string();
335                 assert!(socket_address == "127.0.0.1:9735" || socket_address == "[::1]:9735");
336         }
337 }