Use `crate::prelude::*` rather than specific imports
[rust-lightning] / lightning / src / ln / reload_tests.rs
1 // This file is Copyright its original authors, visible in version control
2 // history.
3 //
4 // This file is licensed under the Apache License, Version 2.0 <LICENSE-APACHE
5 // or http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
6 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your option.
7 // You may not use this file except in accordance with one or both of these
8 // licenses.
9
10 //! Functional tests which test for correct behavior across node restarts.
11
12 use crate::chain::{ChannelMonitorUpdateStatus, Watch};
13 use crate::chain::chaininterface::LowerBoundedFeeEstimator;
14 use crate::chain::channelmonitor::{CLOSED_CHANNEL_UPDATE_ID, ChannelMonitor};
15 use crate::sign::EntropySource;
16 use crate::chain::transaction::OutPoint;
17 use crate::events::{ClosureReason, Event, HTLCDestination, MessageSendEvent, MessageSendEventsProvider};
18 use crate::ln::channelmanager::{ChannelManager, ChannelManagerReadArgs, PaymentId, RecipientOnionFields};
19 use crate::ln::{msgs, ChannelId};
20 use crate::ln::msgs::{ChannelMessageHandler, RoutingMessageHandler, ErrorAction};
21 use crate::util::test_channel_signer::TestChannelSigner;
22 use crate::util::test_utils;
23 use crate::util::errors::APIError;
24 use crate::util::ser::{Writeable, ReadableArgs};
25 use crate::util::config::UserConfig;
26
27 use bitcoin::hash_types::BlockHash;
28
29 use crate::prelude::*;
30 use crate::sync::Mutex;
31
32 use crate::ln::functional_test_utils::*;
33
34 #[test]
35 fn test_funding_peer_disconnect() {
36         // Test that we can lock in our funding tx while disconnected
37         let chanmon_cfgs = create_chanmon_cfgs(2);
38         let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
39         let persister;
40         let new_chain_monitor;
41
42         let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
43         let nodes_0_deserialized;
44         let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
45         let tx = create_chan_between_nodes_with_value_init(&nodes[0], &nodes[1], 100000, 10001);
46
47         nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id());
48         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
49
50         confirm_transaction(&nodes[0], &tx);
51         let events_1 = nodes[0].node.get_and_clear_pending_msg_events();
52         assert!(events_1.is_empty());
53
54         let mut reconnect_args = ReconnectArgs::new(&nodes[0], &nodes[1]);
55         reconnect_args.send_channel_ready.1 = true;
56         reconnect_nodes(reconnect_args);
57
58         nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id());
59         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
60
61         confirm_transaction(&nodes[1], &tx);
62         let events_2 = nodes[1].node.get_and_clear_pending_msg_events();
63         assert!(events_2.is_empty());
64
65         nodes[0].node.peer_connected(&nodes[1].node.get_our_node_id(), &msgs::Init {
66                 features: nodes[1].node.init_features(), networks: None, remote_network_address: None
67         }, true).unwrap();
68         let as_reestablish = get_chan_reestablish_msgs!(nodes[0], nodes[1]).pop().unwrap();
69         nodes[1].node.peer_connected(&nodes[0].node.get_our_node_id(), &msgs::Init {
70                 features: nodes[0].node.init_features(), networks: None, remote_network_address: None
71         }, false).unwrap();
72         let bs_reestablish = get_chan_reestablish_msgs!(nodes[1], nodes[0]).pop().unwrap();
73
74         // nodes[0] hasn't yet received a channel_ready, so it only sends that on reconnect.
75         nodes[0].node.handle_channel_reestablish(&nodes[1].node.get_our_node_id(), &bs_reestablish);
76         let events_3 = nodes[0].node.get_and_clear_pending_msg_events();
77         assert_eq!(events_3.len(), 1);
78         let as_channel_ready = match events_3[0] {
79                 MessageSendEvent::SendChannelReady { ref node_id, ref msg } => {
80                         assert_eq!(*node_id, nodes[1].node.get_our_node_id());
81                         msg.clone()
82                 },
83                 _ => panic!("Unexpected event {:?}", events_3[0]),
84         };
85
86         // nodes[1] received nodes[0]'s channel_ready on the first reconnect above, so it should send
87         // announcement_signatures as well as channel_update.
88         nodes[1].node.handle_channel_reestablish(&nodes[0].node.get_our_node_id(), &as_reestablish);
89         let events_4 = nodes[1].node.get_and_clear_pending_msg_events();
90         assert_eq!(events_4.len(), 3);
91         let chan_id;
92         let bs_channel_ready = match events_4[0] {
93                 MessageSendEvent::SendChannelReady { ref node_id, ref msg } => {
94                         assert_eq!(*node_id, nodes[0].node.get_our_node_id());
95                         chan_id = msg.channel_id;
96                         msg.clone()
97                 },
98                 _ => panic!("Unexpected event {:?}", events_4[0]),
99         };
100         let bs_announcement_sigs = match events_4[1] {
101                 MessageSendEvent::SendAnnouncementSignatures { ref node_id, ref msg } => {
102                         assert_eq!(*node_id, nodes[0].node.get_our_node_id());
103                         msg.clone()
104                 },
105                 _ => panic!("Unexpected event {:?}", events_4[1]),
106         };
107         match events_4[2] {
108                 MessageSendEvent::SendChannelUpdate { ref node_id, msg: _ } => {
109                         assert_eq!(*node_id, nodes[0].node.get_our_node_id());
110                 },
111                 _ => panic!("Unexpected event {:?}", events_4[2]),
112         }
113
114         // Re-deliver nodes[0]'s channel_ready, which nodes[1] can safely ignore. It currently
115         // generates a duplicative private channel_update
116         nodes[1].node.handle_channel_ready(&nodes[0].node.get_our_node_id(), &as_channel_ready);
117         let events_5 = nodes[1].node.get_and_clear_pending_msg_events();
118         assert_eq!(events_5.len(), 1);
119         match events_5[0] {
120                 MessageSendEvent::SendChannelUpdate { ref node_id, msg: _ } => {
121                         assert_eq!(*node_id, nodes[0].node.get_our_node_id());
122                 },
123                 _ => panic!("Unexpected event {:?}", events_5[0]),
124         };
125
126         // When we deliver nodes[1]'s channel_ready, however, nodes[0] will generate its
127         // announcement_signatures.
128         nodes[0].node.handle_channel_ready(&nodes[1].node.get_our_node_id(), &bs_channel_ready);
129         let events_6 = nodes[0].node.get_and_clear_pending_msg_events();
130         assert_eq!(events_6.len(), 1);
131         let as_announcement_sigs = match events_6[0] {
132                 MessageSendEvent::SendAnnouncementSignatures { ref node_id, ref msg } => {
133                         assert_eq!(*node_id, nodes[1].node.get_our_node_id());
134                         msg.clone()
135                 },
136                 _ => panic!("Unexpected event {:?}", events_6[0]),
137         };
138         expect_channel_ready_event(&nodes[0], &nodes[1].node.get_our_node_id());
139         expect_channel_ready_event(&nodes[1], &nodes[0].node.get_our_node_id());
140
141         // When we deliver nodes[1]'s announcement_signatures to nodes[0], nodes[0] should immediately
142         // broadcast the channel announcement globally, as well as re-send its (now-public)
143         // channel_update.
144         nodes[0].node.handle_announcement_signatures(&nodes[1].node.get_our_node_id(), &bs_announcement_sigs);
145         let events_7 = nodes[0].node.get_and_clear_pending_msg_events();
146         assert_eq!(events_7.len(), 1);
147         let (chan_announcement, as_update) = match events_7[0] {
148                 MessageSendEvent::BroadcastChannelAnnouncement { ref msg, ref update_msg } => {
149                         (msg.clone(), update_msg.clone().unwrap())
150                 },
151                 _ => panic!("Unexpected event {:?}", events_7[0]),
152         };
153
154         // Finally, deliver nodes[0]'s announcement_signatures to nodes[1] and make sure it creates the
155         // same channel_announcement.
156         nodes[1].node.handle_announcement_signatures(&nodes[0].node.get_our_node_id(), &as_announcement_sigs);
157         let events_8 = nodes[1].node.get_and_clear_pending_msg_events();
158         assert_eq!(events_8.len(), 1);
159         let bs_update = match events_8[0] {
160                 MessageSendEvent::BroadcastChannelAnnouncement { ref msg, ref update_msg } => {
161                         assert_eq!(*msg, chan_announcement);
162                         update_msg.clone().unwrap()
163                 },
164                 _ => panic!("Unexpected event {:?}", events_8[0]),
165         };
166
167         // Provide the channel announcement and public updates to the network graph
168         nodes[0].gossip_sync.handle_channel_announcement(&chan_announcement).unwrap();
169         nodes[0].gossip_sync.handle_channel_update(&bs_update).unwrap();
170         nodes[0].gossip_sync.handle_channel_update(&as_update).unwrap();
171
172         let (route, _, _, _) = get_route_and_payment_hash!(nodes[0], nodes[1], 1000000);
173         let payment_preimage = send_along_route(&nodes[0], route, &[&nodes[1]], 1000000).0;
174         claim_payment(&nodes[0], &[&nodes[1]], payment_preimage);
175
176         // Check that after deserialization and reconnection we can still generate an identical
177         // channel_announcement from the cached signatures.
178         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
179
180         let chan_0_monitor_serialized = get_monitor!(nodes[0], chan_id).encode();
181
182         reload_node!(nodes[0], &nodes[0].node.encode(), &[&chan_0_monitor_serialized], persister, new_chain_monitor, nodes_0_deserialized);
183
184         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[1]));
185 }
186
187 #[test]
188 fn test_no_txn_manager_serialize_deserialize() {
189         let chanmon_cfgs = create_chanmon_cfgs(2);
190         let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
191         let persister;
192         let new_chain_monitor;
193
194         let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
195         let nodes_0_deserialized;
196         let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
197
198         let tx = create_chan_between_nodes_with_value_init(&nodes[0], &nodes[1], 100000, 10001);
199
200         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
201
202         let chan_0_monitor_serialized =
203                 get_monitor!(nodes[0], ChannelId::v1_from_funding_outpoint(OutPoint { txid: tx.txid(), index: 0 })).encode();
204         reload_node!(nodes[0], nodes[0].node.encode(), &[&chan_0_monitor_serialized], persister, new_chain_monitor, nodes_0_deserialized);
205
206         nodes[0].node.peer_connected(&nodes[1].node.get_our_node_id(), &msgs::Init {
207                 features: nodes[1].node.init_features(), networks: None, remote_network_address: None
208         }, true).unwrap();
209         let reestablish_1 = get_chan_reestablish_msgs!(nodes[0], nodes[1]);
210         nodes[1].node.peer_connected(&nodes[0].node.get_our_node_id(), &msgs::Init {
211                 features: nodes[0].node.init_features(), networks: None, remote_network_address: None
212         }, false).unwrap();
213         let reestablish_2 = get_chan_reestablish_msgs!(nodes[1], nodes[0]);
214
215         nodes[1].node.handle_channel_reestablish(&nodes[0].node.get_our_node_id(), &reestablish_1[0]);
216         assert!(nodes[1].node.get_and_clear_pending_msg_events().is_empty());
217         nodes[0].node.handle_channel_reestablish(&nodes[1].node.get_our_node_id(), &reestablish_2[0]);
218         assert!(nodes[0].node.get_and_clear_pending_msg_events().is_empty());
219
220         let (channel_ready, _) = create_chan_between_nodes_with_value_confirm(&nodes[0], &nodes[1], &tx);
221         let (announcement, as_update, bs_update) = create_chan_between_nodes_with_value_b(&nodes[0], &nodes[1], &channel_ready);
222         for node in nodes.iter() {
223                 assert!(node.gossip_sync.handle_channel_announcement(&announcement).unwrap());
224                 node.gossip_sync.handle_channel_update(&as_update).unwrap();
225                 node.gossip_sync.handle_channel_update(&bs_update).unwrap();
226         }
227
228         send_payment(&nodes[0], &[&nodes[1]], 1000000);
229 }
230
231 #[test]
232 fn test_manager_serialize_deserialize_events() {
233         // This test makes sure the events field in ChannelManager survives de/serialization
234         let chanmon_cfgs = create_chanmon_cfgs(2);
235         let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
236         let persister;
237         let new_chain_monitor;
238
239         let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
240         let nodes_0_deserialized;
241         let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
242
243         // Start creating a channel, but stop right before broadcasting the funding transaction
244         let channel_value = 100000;
245         let push_msat = 10001;
246         let node_a = nodes.remove(0);
247         let node_b = nodes.remove(0);
248         node_a.node.create_channel(node_b.node.get_our_node_id(), channel_value, push_msat, 42, None, None).unwrap();
249         node_b.node.handle_open_channel(&node_a.node.get_our_node_id(), &get_event_msg!(node_a, MessageSendEvent::SendOpenChannel, node_b.node.get_our_node_id()));
250         node_a.node.handle_accept_channel(&node_b.node.get_our_node_id(), &get_event_msg!(node_b, MessageSendEvent::SendAcceptChannel, node_a.node.get_our_node_id()));
251
252         let (temporary_channel_id, tx, funding_output) = create_funding_transaction(&node_a, &node_b.node.get_our_node_id(), channel_value, 42);
253
254         node_a.node.funding_transaction_generated(&temporary_channel_id, &node_b.node.get_our_node_id(), tx.clone()).unwrap();
255         check_added_monitors!(node_a, 0);
256
257         node_b.node.handle_funding_created(&node_a.node.get_our_node_id(), &get_event_msg!(node_a, MessageSendEvent::SendFundingCreated, node_b.node.get_our_node_id()));
258         {
259                 let mut added_monitors = node_b.chain_monitor.added_monitors.lock().unwrap();
260                 assert_eq!(added_monitors.len(), 1);
261                 assert_eq!(added_monitors[0].0, funding_output);
262                 added_monitors.clear();
263         }
264
265         let bs_funding_signed = get_event_msg!(node_b, MessageSendEvent::SendFundingSigned, node_a.node.get_our_node_id());
266         node_a.node.handle_funding_signed(&node_b.node.get_our_node_id(), &bs_funding_signed);
267         {
268                 let mut added_monitors = node_a.chain_monitor.added_monitors.lock().unwrap();
269                 assert_eq!(added_monitors.len(), 1);
270                 assert_eq!(added_monitors[0].0, funding_output);
271                 added_monitors.clear();
272         }
273         // Normally, this is where node_a would broadcast the funding transaction, but the test de/serializes first instead
274
275         expect_channel_pending_event(&node_a, &node_b.node.get_our_node_id());
276         expect_channel_pending_event(&node_b, &node_a.node.get_our_node_id());
277
278         nodes.push(node_a);
279         nodes.push(node_b);
280
281         // Start the de/seriailization process mid-channel creation to check that the channel manager will hold onto events that are serialized
282         let chan_0_monitor_serialized = get_monitor!(nodes[0], bs_funding_signed.channel_id).encode();
283         reload_node!(nodes[0], nodes[0].node.encode(), &[&chan_0_monitor_serialized], persister, new_chain_monitor, nodes_0_deserialized);
284
285         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
286
287         // After deserializing, make sure the funding_transaction is still held by the channel manager
288         let events_4 = nodes[0].node.get_and_clear_pending_events();
289         assert_eq!(events_4.len(), 0);
290         assert_eq!(nodes[0].tx_broadcaster.txn_broadcasted.lock().unwrap().len(), 1);
291         assert_eq!(nodes[0].tx_broadcaster.txn_broadcasted.lock().unwrap()[0].txid(), funding_output.txid);
292
293         // Make sure the channel is functioning as though the de/serialization never happened
294         assert_eq!(nodes[0].node.list_channels().len(), 1);
295
296         nodes[0].node.peer_connected(&nodes[1].node.get_our_node_id(), &msgs::Init {
297                 features: nodes[1].node.init_features(), networks: None, remote_network_address: None
298         }, true).unwrap();
299         let reestablish_1 = get_chan_reestablish_msgs!(nodes[0], nodes[1]);
300         nodes[1].node.peer_connected(&nodes[0].node.get_our_node_id(), &msgs::Init {
301                 features: nodes[0].node.init_features(), networks: None, remote_network_address: None
302         }, false).unwrap();
303         let reestablish_2 = get_chan_reestablish_msgs!(nodes[1], nodes[0]);
304
305         nodes[1].node.handle_channel_reestablish(&nodes[0].node.get_our_node_id(), &reestablish_1[0]);
306         assert!(nodes[1].node.get_and_clear_pending_msg_events().is_empty());
307         nodes[0].node.handle_channel_reestablish(&nodes[1].node.get_our_node_id(), &reestablish_2[0]);
308         assert!(nodes[0].node.get_and_clear_pending_msg_events().is_empty());
309
310         let (channel_ready, _) = create_chan_between_nodes_with_value_confirm(&nodes[0], &nodes[1], &tx);
311         let (announcement, as_update, bs_update) = create_chan_between_nodes_with_value_b(&nodes[0], &nodes[1], &channel_ready);
312         for node in nodes.iter() {
313                 assert!(node.gossip_sync.handle_channel_announcement(&announcement).unwrap());
314                 node.gossip_sync.handle_channel_update(&as_update).unwrap();
315                 node.gossip_sync.handle_channel_update(&bs_update).unwrap();
316         }
317
318         send_payment(&nodes[0], &[&nodes[1]], 1000000);
319 }
320
321 #[test]
322 fn test_simple_manager_serialize_deserialize() {
323         let chanmon_cfgs = create_chanmon_cfgs(2);
324         let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
325         let persister;
326         let new_chain_monitor;
327
328         let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
329         let nodes_0_deserialized;
330         let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
331         let chan_id = create_announced_chan_between_nodes(&nodes, 0, 1).2;
332
333         let (our_payment_preimage, ..) = route_payment(&nodes[0], &[&nodes[1]], 1000000);
334         let (_, our_payment_hash, ..) = route_payment(&nodes[0], &[&nodes[1]], 1000000);
335
336         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
337
338         let chan_0_monitor_serialized = get_monitor!(nodes[0], chan_id).encode();
339         reload_node!(nodes[0], nodes[0].node.encode(), &[&chan_0_monitor_serialized], persister, new_chain_monitor, nodes_0_deserialized);
340
341         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[1]));
342
343         fail_payment(&nodes[0], &[&nodes[1]], our_payment_hash);
344         claim_payment(&nodes[0], &[&nodes[1]], our_payment_preimage);
345 }
346
347 #[test]
348 fn test_manager_serialize_deserialize_inconsistent_monitor() {
349         // Test deserializing a ChannelManager with an out-of-date ChannelMonitor
350         let chanmon_cfgs = create_chanmon_cfgs(4);
351         let node_cfgs = create_node_cfgs(4, &chanmon_cfgs);
352         let logger;
353         let fee_estimator;
354         let persister;
355         let new_chain_monitor;
356
357         let node_chanmgrs = create_node_chanmgrs(4, &node_cfgs, &[None, None, None, None]);
358         let nodes_0_deserialized;
359         let mut nodes = create_network(4, &node_cfgs, &node_chanmgrs);
360
361         let chan_id_1 = create_announced_chan_between_nodes(&nodes, 0, 1).2;
362         let chan_id_2 = create_announced_chan_between_nodes(&nodes, 2, 0).2;
363         let (_, _, channel_id, funding_tx) = create_announced_chan_between_nodes(&nodes, 0, 3);
364
365         let mut node_0_stale_monitors_serialized = Vec::new();
366         for chan_id_iter in &[chan_id_1, chan_id_2, channel_id] {
367                 let mut writer = test_utils::TestVecWriter(Vec::new());
368                 get_monitor!(nodes[0], chan_id_iter).write(&mut writer).unwrap();
369                 node_0_stale_monitors_serialized.push(writer.0);
370         }
371
372         let (our_payment_preimage, ..) = route_payment(&nodes[2], &[&nodes[0], &nodes[1]], 1000000);
373
374         // Serialize the ChannelManager here, but the monitor we keep up-to-date
375         let nodes_0_serialized = nodes[0].node.encode();
376
377         route_payment(&nodes[0], &[&nodes[3]], 1000000);
378         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
379         nodes[2].node.peer_disconnected(&nodes[0].node.get_our_node_id());
380         nodes[3].node.peer_disconnected(&nodes[0].node.get_our_node_id());
381
382         // Now the ChannelMonitor (which is now out-of-sync with ChannelManager for channel w/
383         // nodes[3])
384         let mut node_0_monitors_serialized = Vec::new();
385         for chan_id_iter in &[chan_id_1, chan_id_2, channel_id] {
386                 node_0_monitors_serialized.push(get_monitor!(nodes[0], chan_id_iter).encode());
387         }
388
389         logger = test_utils::TestLogger::new();
390         fee_estimator = test_utils::TestFeeEstimator { sat_per_kw: Mutex::new(253) };
391         persister = test_utils::TestPersister::new();
392         let keys_manager = &chanmon_cfgs[0].keys_manager;
393         new_chain_monitor = test_utils::TestChainMonitor::new(Some(nodes[0].chain_source), nodes[0].tx_broadcaster, &logger, &fee_estimator, &persister, keys_manager);
394         nodes[0].chain_monitor = &new_chain_monitor;
395
396
397         let mut node_0_stale_monitors = Vec::new();
398         for serialized in node_0_stale_monitors_serialized.iter() {
399                 let mut read = &serialized[..];
400                 let (_, monitor) = <(BlockHash, ChannelMonitor<TestChannelSigner>)>::read(&mut read, (keys_manager, keys_manager)).unwrap();
401                 assert!(read.is_empty());
402                 node_0_stale_monitors.push(monitor);
403         }
404
405         let mut node_0_monitors = Vec::new();
406         for serialized in node_0_monitors_serialized.iter() {
407                 let mut read = &serialized[..];
408                 let (_, monitor) = <(BlockHash, ChannelMonitor<TestChannelSigner>)>::read(&mut read, (keys_manager, keys_manager)).unwrap();
409                 assert!(read.is_empty());
410                 node_0_monitors.push(monitor);
411         }
412
413         let mut nodes_0_read = &nodes_0_serialized[..];
414         if let Err(msgs::DecodeError::DangerousValue) =
415                 <(BlockHash, ChannelManager<&test_utils::TestChainMonitor, &test_utils::TestBroadcaster, &test_utils::TestKeysInterface, &test_utils::TestKeysInterface, &test_utils::TestKeysInterface, &test_utils::TestFeeEstimator, &test_utils::TestRouter, &test_utils::TestLogger>)>::read(&mut nodes_0_read, ChannelManagerReadArgs {
416                 default_config: UserConfig::default(),
417                 entropy_source: keys_manager,
418                 node_signer: keys_manager,
419                 signer_provider: keys_manager,
420                 fee_estimator: &fee_estimator,
421                 router: &nodes[0].router,
422                 chain_monitor: nodes[0].chain_monitor,
423                 tx_broadcaster: nodes[0].tx_broadcaster,
424                 logger: &logger,
425                 channel_monitors: node_0_stale_monitors.iter_mut().map(|monitor| { (monitor.get_funding_txo().0, monitor) }).collect(),
426         }) { } else {
427                 panic!("If the monitor(s) are stale, this indicates a bug and we should get an Err return");
428         };
429
430         let mut nodes_0_read = &nodes_0_serialized[..];
431         let (_, nodes_0_deserialized_tmp) =
432                 <(BlockHash, ChannelManager<&test_utils::TestChainMonitor, &test_utils::TestBroadcaster, &test_utils::TestKeysInterface, &test_utils::TestKeysInterface, &test_utils::TestKeysInterface, &test_utils::TestFeeEstimator, &test_utils::TestRouter, &test_utils::TestLogger>)>::read(&mut nodes_0_read, ChannelManagerReadArgs {
433                 default_config: UserConfig::default(),
434                 entropy_source: keys_manager,
435                 node_signer: keys_manager,
436                 signer_provider: keys_manager,
437                 fee_estimator: &fee_estimator,
438                 router: nodes[0].router,
439                 chain_monitor: nodes[0].chain_monitor,
440                 tx_broadcaster: nodes[0].tx_broadcaster,
441                 logger: &logger,
442                 channel_monitors: node_0_monitors.iter_mut().map(|monitor| { (monitor.get_funding_txo().0, monitor) }).collect(),
443         }).unwrap();
444         nodes_0_deserialized = nodes_0_deserialized_tmp;
445         assert!(nodes_0_read.is_empty());
446
447         for monitor in node_0_monitors.drain(..) {
448                 let funding_outpoint = monitor.get_funding_txo().0;
449                 assert_eq!(nodes[0].chain_monitor.watch_channel(funding_outpoint, monitor),
450                         Ok(ChannelMonitorUpdateStatus::Completed));
451                 check_added_monitors!(nodes[0], 1);
452         }
453         nodes[0].node = &nodes_0_deserialized;
454
455         check_closed_event!(nodes[0], 1, ClosureReason::OutdatedChannelManager, [nodes[3].node.get_our_node_id()], 100000);
456         { // Channel close should result in a commitment tx
457                 nodes[0].node.timer_tick_occurred();
458                 let txn = nodes[0].tx_broadcaster.txn_broadcasted.lock().unwrap();
459                 assert_eq!(txn.len(), 1);
460                 check_spends!(txn[0], funding_tx);
461                 assert_eq!(txn[0].input[0].previous_output.txid, funding_tx.txid());
462         }
463         check_added_monitors!(nodes[0], 1);
464
465         // nodes[1] and nodes[2] have no lost state with nodes[0]...
466         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[1]));
467         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[2]));
468         //... and we can even still claim the payment!
469         claim_payment(&nodes[2], &[&nodes[0], &nodes[1]], our_payment_preimage);
470
471         nodes[3].node.peer_connected(&nodes[0].node.get_our_node_id(), &msgs::Init {
472                 features: nodes[0].node.init_features(), networks: None, remote_network_address: None
473         }, true).unwrap();
474         let reestablish = get_chan_reestablish_msgs!(nodes[3], nodes[0]).pop().unwrap();
475         nodes[0].node.peer_connected(&nodes[3].node.get_our_node_id(), &msgs::Init {
476                 features: nodes[3].node.init_features(), networks: None, remote_network_address: None
477         }, false).unwrap();
478         nodes[0].node.handle_channel_reestablish(&nodes[3].node.get_our_node_id(), &reestablish);
479         let mut found_err = false;
480         for msg_event in nodes[0].node.get_and_clear_pending_msg_events() {
481                 if let MessageSendEvent::HandleError { ref action, .. } = msg_event {
482                         match action {
483                                 &ErrorAction::SendErrorMessage { ref msg } => {
484                                         assert_eq!(msg.channel_id, channel_id);
485                                         assert!(!found_err);
486                                         found_err = true;
487                                 },
488                                 _ => panic!("Unexpected event!"),
489                         }
490                 }
491         }
492         assert!(found_err);
493 }
494
495 #[cfg(feature = "std")]
496 fn do_test_data_loss_protect(reconnect_panicing: bool, substantially_old: bool, not_stale: bool) {
497         use crate::routing::router::{RouteParameters, PaymentParameters};
498         use crate::ln::channelmanager::Retry;
499         use crate::util::string::UntrustedString;
500         // When we get a data_loss_protect proving we're behind, we immediately panic as the
501         // chain::Watch API requirements have been violated (e.g. the user restored from a backup). The
502         // panic message informs the user they should force-close without broadcasting, which is tested
503         // if `reconnect_panicing` is not set.
504         let mut chanmon_cfgs = create_chanmon_cfgs(2);
505         // We broadcast during Drop because chanmon is out of sync with chanmgr, which would cause a panic
506         // during signing due to revoked tx
507         chanmon_cfgs[0].keys_manager.disable_revocation_policy_check = true;
508         let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
509         let persister;
510         let new_chain_monitor;
511
512         let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
513         let nodes_0_deserialized;
514
515         let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
516
517         let chan = create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1000000, 1000000);
518
519         // Cache node A state before any channel update
520         let previous_node_state = nodes[0].node.encode();
521         let previous_chain_monitor_state = get_monitor!(nodes[0], chan.2).encode();
522
523         assert!(!substantially_old || !not_stale, "substantially_old and not_stale doesn't make sense");
524         if not_stale || !substantially_old {
525                 // Previously, we'd only hit the data_loss_protect assertion if we had a state which
526                 // revoked at least two revocations ago, not the latest revocation. Here, we use
527                 // `not_stale` to test the boundary condition.
528                 let pay_params = PaymentParameters::for_keysend(nodes[1].node.get_our_node_id(), 100, false);
529                 let route_params = RouteParameters::from_payment_params_and_value(pay_params, 40000);
530                 nodes[0].node.send_spontaneous_payment_with_retry(None, RecipientOnionFields::spontaneous_empty(), PaymentId([0; 32]), route_params, Retry::Attempts(0)).unwrap();
531                 check_added_monitors(&nodes[0], 1);
532                 let update_add_commit = SendEvent::from_node(&nodes[0]);
533
534                 nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &update_add_commit.msgs[0]);
535                 nodes[1].node.handle_commitment_signed(&nodes[0].node.get_our_node_id(), &update_add_commit.commitment_msg);
536                 check_added_monitors(&nodes[1], 1);
537                 let (raa, cs) = get_revoke_commit_msgs(&nodes[1], &nodes[0].node.get_our_node_id());
538
539                 nodes[0].node.handle_revoke_and_ack(&nodes[1].node.get_our_node_id(), &raa);
540                 check_added_monitors(&nodes[0], 1);
541                 assert!(nodes[0].node.get_and_clear_pending_msg_events().is_empty());
542                 if !not_stale {
543                         nodes[0].node.handle_commitment_signed(&nodes[1].node.get_our_node_id(), &cs);
544                         check_added_monitors(&nodes[0], 1);
545                         // A now revokes their original state, at which point reconnect should panic
546                         let raa = get_event_msg!(nodes[0], MessageSendEvent::SendRevokeAndACK, nodes[1].node.get_our_node_id());
547                         nodes[1].node.handle_revoke_and_ack(&nodes[0].node.get_our_node_id(), &raa);
548                         check_added_monitors(&nodes[1], 1);
549                         expect_pending_htlcs_forwardable_ignore!(nodes[1]);
550                 }
551         } else {
552                 send_payment(&nodes[0], &[&nodes[1]], 8000000);
553                 send_payment(&nodes[0], &[&nodes[1]], 8000000);
554         }
555
556         nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id());
557         nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id());
558
559         reload_node!(nodes[0], previous_node_state, &[&previous_chain_monitor_state], persister, new_chain_monitor, nodes_0_deserialized);
560
561         if reconnect_panicing {
562                 nodes[0].node.peer_connected(&nodes[1].node.get_our_node_id(), &msgs::Init {
563                         features: nodes[1].node.init_features(), networks: None, remote_network_address: None
564                 }, true).unwrap();
565                 nodes[1].node.peer_connected(&nodes[0].node.get_our_node_id(), &msgs::Init {
566                         features: nodes[0].node.init_features(), networks: None, remote_network_address: None
567                 }, false).unwrap();
568
569                 let reestablish_1 = get_chan_reestablish_msgs!(nodes[0], nodes[1]);
570
571                 // If A has fallen behind substantially, B should send it a message letting it know
572                 // that.
573                 nodes[1].node.handle_channel_reestablish(&nodes[0].node.get_our_node_id(), &reestablish_1[0]);
574                 let reestablish_msg;
575                 if substantially_old {
576                         let warn_msg = "Peer attempted to reestablish channel with a very old local commitment transaction: 0 (received) vs 4 (expected)".to_owned();
577
578                         let warn_reestablish = nodes[1].node.get_and_clear_pending_msg_events();
579                         assert_eq!(warn_reestablish.len(), 2);
580                         match warn_reestablish[1] {
581                                 MessageSendEvent::HandleError { action: ErrorAction::SendWarningMessage { ref msg, .. }, .. } => {
582                                         assert_eq!(msg.data, warn_msg);
583                                 },
584                                 _ => panic!("Unexpected events: {:?}", warn_reestablish),
585                         }
586                         reestablish_msg = match &warn_reestablish[0] {
587                                 MessageSendEvent::SendChannelReestablish { msg, .. } => msg.clone(),
588                                 _ => panic!("Unexpected events: {:?}", warn_reestablish),
589                         };
590                 } else {
591                         let msgs = nodes[1].node.get_and_clear_pending_msg_events();
592                         assert!(msgs.len() >= 4);
593                         match msgs.last() {
594                                 Some(MessageSendEvent::SendChannelUpdate { .. }) => {},
595                                 _ => panic!("Unexpected events: {:?}", msgs),
596                         }
597                         assert!(msgs.iter().any(|msg| matches!(msg, MessageSendEvent::SendRevokeAndACK { .. })));
598                         assert!(msgs.iter().any(|msg| matches!(msg, MessageSendEvent::UpdateHTLCs { .. })));
599                         reestablish_msg = match &msgs[0] {
600                                 MessageSendEvent::SendChannelReestablish { msg, .. } => msg.clone(),
601                                 _ => panic!("Unexpected events: {:?}", msgs),
602                         };
603                 }
604
605                 {
606                         let mut node_txn = nodes[1].tx_broadcaster.txn_broadcasted.lock().unwrap();
607                         // The node B should never force-close the channel.
608                         assert!(node_txn.is_empty());
609                 }
610
611                 // Check A panics upon seeing proof it has fallen behind.
612                 let reconnect_res = std::panic::catch_unwind(|| {
613                         nodes[0].node.handle_channel_reestablish(&nodes[1].node.get_our_node_id(), &reestablish_msg);
614                 });
615                 if not_stale {
616                         assert!(reconnect_res.is_ok());
617                         // At this point A gets confused because B expects a commitment state newer than A
618                         // has sent, but not a newer revocation secret, so A just (correctly) closes.
619                         check_closed_broadcast(&nodes[0], 1, true);
620                         check_added_monitors(&nodes[0], 1);
621                         check_closed_event!(nodes[0], 1, ClosureReason::ProcessingError {
622                                 err: "Peer attempted to reestablish channel with a future remote commitment transaction: 2 (received) vs 1 (expected)".to_owned()
623                         }, [nodes[1].node.get_our_node_id()], 1000000);
624                 } else {
625                         assert!(reconnect_res.is_err());
626                         // Skip the `Drop` handler for `Node`s as some may be in an invalid (panicked) state.
627                         std::mem::forget(nodes);
628                 }
629         } else {
630                 assert!(!not_stale, "We only care about the stale case when not testing panicking");
631
632                 nodes[0].node.force_close_without_broadcasting_txn(&chan.2, &nodes[1].node.get_our_node_id()).unwrap();
633                 check_added_monitors!(nodes[0], 1);
634                 check_closed_event!(nodes[0], 1, ClosureReason::HolderForceClosed, [nodes[1].node.get_our_node_id()], 1000000);
635                 {
636                         let node_txn = nodes[0].tx_broadcaster.txn_broadcasted.lock().unwrap();
637                         assert_eq!(node_txn.len(), 0);
638                 }
639
640                 for msg in nodes[0].node.get_and_clear_pending_msg_events() {
641                         if let MessageSendEvent::BroadcastChannelUpdate { .. } = msg {
642                         } else if let MessageSendEvent::HandleError { ref action, .. } = msg {
643                                 match action {
644                                         &ErrorAction::DisconnectPeer { ref msg } => {
645                                                 assert_eq!(msg.as_ref().unwrap().data, "Channel force-closed");
646                                         },
647                                         _ => panic!("Unexpected event!"),
648                                 }
649                         } else {
650                                 panic!("Unexpected event {:?}", msg)
651                         }
652                 }
653
654                 // after the warning message sent by B, we should not able to
655                 // use the channel, or reconnect with success to the channel.
656                 assert!(nodes[0].node.list_usable_channels().is_empty());
657                 nodes[0].node.peer_connected(&nodes[1].node.get_our_node_id(), &msgs::Init {
658                         features: nodes[1].node.init_features(), networks: None, remote_network_address: None
659                 }, true).unwrap();
660                 nodes[1].node.peer_connected(&nodes[0].node.get_our_node_id(), &msgs::Init {
661                         features: nodes[0].node.init_features(), networks: None, remote_network_address: None
662                 }, false).unwrap();
663                 let retry_reestablish = get_chan_reestablish_msgs!(nodes[1], nodes[0]);
664
665                 nodes[0].node.handle_channel_reestablish(&nodes[1].node.get_our_node_id(), &retry_reestablish[0]);
666                 let mut err_msgs_0 = Vec::with_capacity(1);
667                 if let MessageSendEvent::HandleError { ref action, .. } = nodes[0].node.get_and_clear_pending_msg_events()[1] {
668                         match action {
669                                 &ErrorAction::SendErrorMessage { ref msg } => {
670                                         assert_eq!(msg.data, format!("Got a message for a channel from the wrong node! No such channel for the passed counterparty_node_id {}", &nodes[1].node.get_our_node_id()));
671                                         err_msgs_0.push(msg.clone());
672                                 },
673                                 _ => panic!("Unexpected event!"),
674                         }
675                 } else {
676                         panic!("Unexpected event!");
677                 }
678                 assert_eq!(err_msgs_0.len(), 1);
679                 nodes[1].node.handle_error(&nodes[0].node.get_our_node_id(), &err_msgs_0[0]);
680                 assert!(nodes[1].node.list_usable_channels().is_empty());
681                 check_added_monitors!(nodes[1], 1);
682                 check_closed_event!(nodes[1], 1, ClosureReason::CounterpartyForceClosed { peer_msg: UntrustedString(format!("Got a message for a channel from the wrong node! No such channel for the passed counterparty_node_id {}", &nodes[1].node.get_our_node_id())) }
683                         , [nodes[0].node.get_our_node_id()], 1000000);
684                 check_closed_broadcast!(nodes[1], false);
685         }
686 }
687
688 #[test]
689 #[cfg(feature = "std")]
690 fn test_data_loss_protect() {
691         do_test_data_loss_protect(true, false, true);
692         do_test_data_loss_protect(true, true, false);
693         do_test_data_loss_protect(true, false, false);
694         do_test_data_loss_protect(false, true, false);
695         do_test_data_loss_protect(false, false, false);
696 }
697
698 #[test]
699 fn test_forwardable_regen() {
700         // Tests that if we reload a ChannelManager while forwards are pending we will regenerate the
701         // PendingHTLCsForwardable event automatically, ensuring we don't forget to forward/receive
702         // HTLCs.
703         // We test it for both payment receipt and payment forwarding.
704
705         let chanmon_cfgs = create_chanmon_cfgs(3);
706         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
707         let persister;
708         let new_chain_monitor;
709         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
710         let nodes_1_deserialized;
711         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
712         let chan_id_1 = create_announced_chan_between_nodes(&nodes, 0, 1).2;
713         let chan_id_2 = create_announced_chan_between_nodes(&nodes, 1, 2).2;
714
715         // First send a payment to nodes[1]
716         let (route, payment_hash, payment_preimage, payment_secret) = get_route_and_payment_hash!(nodes[0], nodes[1], 100_000);
717         nodes[0].node.send_payment_with_route(&route, payment_hash,
718                 RecipientOnionFields::secret_only(payment_secret), PaymentId(payment_hash.0)).unwrap();
719         check_added_monitors!(nodes[0], 1);
720
721         let mut events = nodes[0].node.get_and_clear_pending_msg_events();
722         assert_eq!(events.len(), 1);
723         let payment_event = SendEvent::from_event(events.pop().unwrap());
724         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
725         commitment_signed_dance!(nodes[1], nodes[0], payment_event.commitment_msg, false);
726
727         expect_pending_htlcs_forwardable_ignore!(nodes[1]);
728
729         // Next send a payment which is forwarded by nodes[1]
730         let (route_2, payment_hash_2, payment_preimage_2, payment_secret_2) = get_route_and_payment_hash!(nodes[0], nodes[2], 200_000);
731         nodes[0].node.send_payment_with_route(&route_2, payment_hash_2,
732                 RecipientOnionFields::secret_only(payment_secret_2), PaymentId(payment_hash_2.0)).unwrap();
733         check_added_monitors!(nodes[0], 1);
734
735         let mut events = nodes[0].node.get_and_clear_pending_msg_events();
736         assert_eq!(events.len(), 1);
737         let payment_event = SendEvent::from_event(events.pop().unwrap());
738         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
739         commitment_signed_dance!(nodes[1], nodes[0], payment_event.commitment_msg, false);
740
741         // There is already a PendingHTLCsForwardable event "pending" so another one will not be
742         // generated
743         assert!(nodes[1].node.get_and_clear_pending_events().is_empty());
744
745         // Now restart nodes[1] and make sure it regenerates a single PendingHTLCsForwardable
746         nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id());
747         nodes[2].node.peer_disconnected(&nodes[1].node.get_our_node_id());
748
749         let chan_0_monitor_serialized = get_monitor!(nodes[1], chan_id_1).encode();
750         let chan_1_monitor_serialized = get_monitor!(nodes[1], chan_id_2).encode();
751         reload_node!(nodes[1], nodes[1].node.encode(), &[&chan_0_monitor_serialized, &chan_1_monitor_serialized], persister, new_chain_monitor, nodes_1_deserialized);
752
753         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[1]));
754         // Note that nodes[1] and nodes[2] resend their channel_ready here since they haven't updated
755         // the commitment state.
756         let mut reconnect_args = ReconnectArgs::new(&nodes[1], &nodes[2]);
757         reconnect_args.send_channel_ready = (true, true);
758         reconnect_nodes(reconnect_args);
759
760         assert!(nodes[1].node.get_and_clear_pending_msg_events().is_empty());
761
762         expect_pending_htlcs_forwardable!(nodes[1]);
763         expect_payment_claimable!(nodes[1], payment_hash, payment_secret, 100_000);
764         check_added_monitors!(nodes[1], 1);
765
766         let mut events = nodes[1].node.get_and_clear_pending_msg_events();
767         assert_eq!(events.len(), 1);
768         let payment_event = SendEvent::from_event(events.pop().unwrap());
769         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), &payment_event.msgs[0]);
770         commitment_signed_dance!(nodes[2], nodes[1], payment_event.commitment_msg, false);
771         expect_pending_htlcs_forwardable!(nodes[2]);
772         expect_payment_claimable!(nodes[2], payment_hash_2, payment_secret_2, 200_000);
773
774         claim_payment(&nodes[0], &[&nodes[1]], payment_preimage);
775         claim_payment(&nodes[0], &[&nodes[1], &nodes[2]], payment_preimage_2);
776 }
777
778 fn do_test_partial_claim_before_restart(persist_both_monitors: bool) {
779         // Test what happens if a node receives an MPP payment, claims it, but crashes before
780         // persisting the ChannelManager. If `persist_both_monitors` is false, also crash after only
781         // updating one of the two channels' ChannelMonitors. As a result, on startup, we'll (a) still
782         // have the PaymentClaimable event, (b) have one (or two) channel(s) that goes on chain with the
783         // HTLC preimage in them, and (c) optionally have one channel that is live off-chain but does
784         // not have the preimage tied to the still-pending HTLC.
785         //
786         // To get to the correct state, on startup we should propagate the preimage to the
787         // still-off-chain channel, claiming the HTLC as soon as the peer connects, with the monitor
788         // receiving the preimage without a state update.
789         //
790         // Further, we should generate a `PaymentClaimed` event to inform the user that the payment was
791         // definitely claimed.
792         let chanmon_cfgs = create_chanmon_cfgs(4);
793         let node_cfgs = create_node_cfgs(4, &chanmon_cfgs);
794         let persister;
795         let new_chain_monitor;
796
797         let node_chanmgrs = create_node_chanmgrs(4, &node_cfgs, &[None, None, None, None]);
798         let nodes_3_deserialized;
799
800         let mut nodes = create_network(4, &node_cfgs, &node_chanmgrs);
801
802         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 100_000, 0);
803         create_announced_chan_between_nodes_with_value(&nodes, 0, 2, 100_000, 0);
804         let chan_id_persisted = create_announced_chan_between_nodes_with_value(&nodes, 1, 3, 100_000, 0).2;
805         let chan_id_not_persisted = create_announced_chan_between_nodes_with_value(&nodes, 2, 3, 100_000, 0).2;
806
807         // Create an MPP route for 15k sats, more than the default htlc-max of 10%
808         let (mut route, payment_hash, payment_preimage, payment_secret) = get_route_and_payment_hash!(nodes[0], nodes[3], 15_000_000);
809         assert_eq!(route.paths.len(), 2);
810         route.paths.sort_by(|path_a, _| {
811                 // Sort the path so that the path through nodes[1] comes first
812                 if path_a.hops[0].pubkey == nodes[1].node.get_our_node_id() {
813                         core::cmp::Ordering::Less } else { core::cmp::Ordering::Greater }
814         });
815
816         nodes[0].node.send_payment_with_route(&route, payment_hash,
817                 RecipientOnionFields::secret_only(payment_secret), PaymentId(payment_hash.0)).unwrap();
818         check_added_monitors!(nodes[0], 2);
819
820         // Send the payment through to nodes[3] *without* clearing the PaymentClaimable event
821         let mut send_events = nodes[0].node.get_and_clear_pending_msg_events();
822         assert_eq!(send_events.len(), 2);
823         let node_1_msgs = remove_first_msg_event_to_node(&nodes[1].node.get_our_node_id(), &mut send_events);
824         let node_2_msgs = remove_first_msg_event_to_node(&nodes[2].node.get_our_node_id(), &mut send_events);
825         do_pass_along_path(PassAlongPathArgs::new(&nodes[0],&[&nodes[1], &nodes[3]], 15_000_000, payment_hash, node_1_msgs)
826                 .with_payment_secret(payment_secret)
827                 .without_clearing_recipient_events());
828         do_pass_along_path(PassAlongPathArgs::new(&nodes[0], &[&nodes[2], &nodes[3]], 15_000_000, payment_hash, node_2_msgs)
829                 .with_payment_secret(payment_secret)
830                 .without_clearing_recipient_events());
831
832         // Now that we have an MPP payment pending, get the latest encoded copies of nodes[3]'s
833         // monitors and ChannelManager, for use later, if we don't want to persist both monitors.
834         let mut original_monitor = test_utils::TestVecWriter(Vec::new());
835         if !persist_both_monitors {
836                 for (outpoint, channel_id) in nodes[3].chain_monitor.chain_monitor.list_monitors() {
837                         if channel_id == chan_id_not_persisted {
838                                 assert!(original_monitor.0.is_empty());
839                                 nodes[3].chain_monitor.chain_monitor.get_monitor(outpoint).unwrap().write(&mut original_monitor).unwrap();
840                         }
841                 }
842         }
843
844         let original_manager = nodes[3].node.encode();
845
846         expect_payment_claimable!(nodes[3], payment_hash, payment_secret, 15_000_000);
847
848         nodes[3].node.claim_funds(payment_preimage);
849         check_added_monitors!(nodes[3], 2);
850         expect_payment_claimed!(nodes[3], payment_hash, 15_000_000);
851
852         // Now fetch one of the two updated ChannelMonitors from nodes[3], and restart pretending we
853         // crashed in between the two persistence calls - using one old ChannelMonitor and one new one,
854         // with the old ChannelManager.
855         let mut updated_monitor = test_utils::TestVecWriter(Vec::new());
856         for (outpoint, channel_id) in nodes[3].chain_monitor.chain_monitor.list_monitors() {
857                 if channel_id == chan_id_persisted {
858                         assert!(updated_monitor.0.is_empty());
859                         nodes[3].chain_monitor.chain_monitor.get_monitor(outpoint).unwrap().write(&mut updated_monitor).unwrap();
860                 }
861         }
862         // If `persist_both_monitors` is set, get the second monitor here as well
863         if persist_both_monitors {
864                 for (outpoint, channel_id) in nodes[3].chain_monitor.chain_monitor.list_monitors() {
865                         if channel_id == chan_id_not_persisted {
866                                 assert!(original_monitor.0.is_empty());
867                                 nodes[3].chain_monitor.chain_monitor.get_monitor(outpoint).unwrap().write(&mut original_monitor).unwrap();
868                         }
869                 }
870         }
871
872         // Now restart nodes[3].
873         reload_node!(nodes[3], original_manager, &[&updated_monitor.0, &original_monitor.0], persister, new_chain_monitor, nodes_3_deserialized);
874
875         // On startup the preimage should have been copied into the non-persisted monitor:
876         assert!(get_monitor!(nodes[3], chan_id_persisted).get_stored_preimages().contains_key(&payment_hash));
877         assert!(get_monitor!(nodes[3], chan_id_not_persisted).get_stored_preimages().contains_key(&payment_hash));
878
879         nodes[1].node.peer_disconnected(&nodes[3].node.get_our_node_id());
880         nodes[2].node.peer_disconnected(&nodes[3].node.get_our_node_id());
881
882         // During deserialization, we should have closed one channel and broadcast its latest
883         // commitment transaction. We should also still have the original PaymentClaimable event we
884         // never finished processing.
885         let events = nodes[3].node.get_and_clear_pending_events();
886         assert_eq!(events.len(), if persist_both_monitors { 4 } else { 3 });
887         if let Event::PaymentClaimable { amount_msat: 15_000_000, .. } = events[0] { } else { panic!(); }
888         if let Event::ChannelClosed { reason: ClosureReason::OutdatedChannelManager, .. } = events[1] { } else { panic!(); }
889         if persist_both_monitors {
890                 if let Event::ChannelClosed { reason: ClosureReason::OutdatedChannelManager, .. } = events[2] { } else { panic!(); }
891                 check_added_monitors(&nodes[3], 2);
892         } else {
893                 check_added_monitors(&nodes[3], 1);
894         }
895
896         // On restart, we should also get a duplicate PaymentClaimed event as we persisted the
897         // ChannelManager prior to handling the original one.
898         if let Event::PaymentClaimed { payment_hash: our_payment_hash, amount_msat: 15_000_000, .. } =
899                 events[if persist_both_monitors { 3 } else { 2 }]
900         {
901                 assert_eq!(payment_hash, our_payment_hash);
902         } else { panic!(); }
903
904         assert_eq!(nodes[3].node.list_channels().len(), if persist_both_monitors { 0 } else { 1 });
905         if !persist_both_monitors {
906                 // If one of the two channels is still live, reveal the payment preimage over it.
907
908                 nodes[3].node.peer_connected(&nodes[2].node.get_our_node_id(), &msgs::Init {
909                         features: nodes[2].node.init_features(), networks: None, remote_network_address: None
910                 }, true).unwrap();
911                 let reestablish_1 = get_chan_reestablish_msgs!(nodes[3], nodes[2]);
912                 nodes[2].node.peer_connected(&nodes[3].node.get_our_node_id(), &msgs::Init {
913                         features: nodes[3].node.init_features(), networks: None, remote_network_address: None
914                 }, false).unwrap();
915                 let reestablish_2 = get_chan_reestablish_msgs!(nodes[2], nodes[3]);
916
917                 nodes[2].node.handle_channel_reestablish(&nodes[3].node.get_our_node_id(), &reestablish_1[0]);
918                 get_event_msg!(nodes[2], MessageSendEvent::SendChannelUpdate, nodes[3].node.get_our_node_id());
919                 assert!(nodes[2].node.get_and_clear_pending_msg_events().is_empty());
920
921                 nodes[3].node.handle_channel_reestablish(&nodes[2].node.get_our_node_id(), &reestablish_2[0]);
922
923                 // Once we call `get_and_clear_pending_msg_events` the holding cell is cleared and the HTLC
924                 // claim should fly.
925                 let ds_msgs = nodes[3].node.get_and_clear_pending_msg_events();
926                 check_added_monitors!(nodes[3], 1);
927                 assert_eq!(ds_msgs.len(), 2);
928                 if let MessageSendEvent::SendChannelUpdate { .. } = ds_msgs[0] {} else { panic!(); }
929
930                 let cs_updates = match ds_msgs[1] {
931                         MessageSendEvent::UpdateHTLCs { ref updates, .. } => {
932                                 nodes[2].node.handle_update_fulfill_htlc(&nodes[3].node.get_our_node_id(), &updates.update_fulfill_htlcs[0]);
933                                 check_added_monitors!(nodes[2], 1);
934                                 let cs_updates = get_htlc_update_msgs!(nodes[2], nodes[0].node.get_our_node_id());
935                                 expect_payment_forwarded!(nodes[2], nodes[0], nodes[3], Some(1000), false, false);
936                                 commitment_signed_dance!(nodes[2], nodes[3], updates.commitment_signed, false, true);
937                                 cs_updates
938                         }
939                         _ => panic!(),
940                 };
941
942                 nodes[0].node.handle_update_fulfill_htlc(&nodes[2].node.get_our_node_id(), &cs_updates.update_fulfill_htlcs[0]);
943                 commitment_signed_dance!(nodes[0], nodes[2], cs_updates.commitment_signed, false, true);
944                 expect_payment_sent!(nodes[0], payment_preimage);
945         }
946 }
947
948 #[test]
949 fn test_partial_claim_before_restart() {
950         do_test_partial_claim_before_restart(false);
951         do_test_partial_claim_before_restart(true);
952 }
953
954 fn do_forwarded_payment_no_manager_persistence(use_cs_commitment: bool, claim_htlc: bool, use_intercept: bool) {
955         if !use_cs_commitment { assert!(!claim_htlc); }
956         // If we go to forward a payment, and the ChannelMonitor persistence completes, but the
957         // ChannelManager does not, we shouldn't try to forward the payment again, nor should we fail
958         // it back until the ChannelMonitor decides the fate of the HTLC.
959         // This was never an issue, but it may be easy to regress here going forward.
960         let chanmon_cfgs = create_chanmon_cfgs(3);
961         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
962         let persister;
963         let new_chain_monitor;
964
965         let mut intercept_forwards_config = test_default_channel_config();
966         intercept_forwards_config.accept_intercept_htlcs = true;
967         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, Some(intercept_forwards_config), None]);
968         let nodes_1_deserialized;
969
970         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
971
972         let chan_id_1 = create_announced_chan_between_nodes(&nodes, 0, 1).2;
973         let chan_id_2 = create_announced_chan_between_nodes(&nodes, 1, 2).2;
974
975         let intercept_scid = nodes[1].node.get_intercept_scid();
976
977         let (mut route, payment_hash, payment_preimage, payment_secret) =
978                 get_route_and_payment_hash!(nodes[0], nodes[2], 1_000_000);
979         if use_intercept {
980                 route.paths[0].hops[1].short_channel_id = intercept_scid;
981         }
982         let payment_id = PaymentId(nodes[0].keys_manager.backing.get_secure_random_bytes());
983         let htlc_expiry = nodes[0].best_block_info().1 + TEST_FINAL_CLTV;
984         nodes[0].node.send_payment_with_route(&route, payment_hash,
985                 RecipientOnionFields::secret_only(payment_secret), payment_id).unwrap();
986         check_added_monitors!(nodes[0], 1);
987
988         let payment_event = SendEvent::from_node(&nodes[0]);
989         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
990         commitment_signed_dance!(nodes[1], nodes[0], payment_event.commitment_msg, false);
991
992         // Store the `ChannelManager` before handling the `PendingHTLCsForwardable`/`HTLCIntercepted`
993         // events, expecting either event (and the HTLC itself) to be missing on reload even though its
994         // present when we serialized.
995         let node_encoded = nodes[1].node.encode();
996
997         let mut intercept_id = None;
998         let mut expected_outbound_amount_msat = None;
999         if use_intercept {
1000                 let events = nodes[1].node.get_and_clear_pending_events();
1001                 assert_eq!(events.len(), 1);
1002                 match events[0] {
1003                         Event::HTLCIntercepted { intercept_id: ev_id, expected_outbound_amount_msat: ev_amt, .. } => {
1004                                 intercept_id = Some(ev_id);
1005                                 expected_outbound_amount_msat = Some(ev_amt);
1006                         },
1007                         _ => panic!()
1008                 }
1009                 nodes[1].node.forward_intercepted_htlc(intercept_id.unwrap(), &chan_id_2,
1010                         nodes[2].node.get_our_node_id(), expected_outbound_amount_msat.unwrap()).unwrap();
1011         }
1012
1013         expect_pending_htlcs_forwardable!(nodes[1]);
1014
1015         let payment_event = SendEvent::from_node(&nodes[1]);
1016         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), &payment_event.msgs[0]);
1017         nodes[2].node.handle_commitment_signed(&nodes[1].node.get_our_node_id(), &payment_event.commitment_msg);
1018         check_added_monitors!(nodes[2], 1);
1019
1020         if claim_htlc {
1021                 get_monitor!(nodes[2], chan_id_2).provide_payment_preimage(&payment_hash, &payment_preimage,
1022                         &nodes[2].tx_broadcaster, &LowerBoundedFeeEstimator(nodes[2].fee_estimator), &nodes[2].logger);
1023         }
1024         assert!(nodes[2].tx_broadcaster.txn_broadcasted.lock().unwrap().is_empty());
1025
1026         let _ = nodes[2].node.get_and_clear_pending_msg_events();
1027
1028         nodes[2].node.force_close_broadcasting_latest_txn(&chan_id_2, &nodes[1].node.get_our_node_id()).unwrap();
1029         let cs_commitment_tx = nodes[2].tx_broadcaster.txn_broadcasted.lock().unwrap().split_off(0);
1030         assert_eq!(cs_commitment_tx.len(), if claim_htlc { 2 } else { 1 });
1031
1032         check_added_monitors!(nodes[2], 1);
1033         check_closed_event!(nodes[2], 1, ClosureReason::HolderForceClosed, [nodes[1].node.get_our_node_id()], 100000);
1034         check_closed_broadcast!(nodes[2], true);
1035
1036         let chan_0_monitor_serialized = get_monitor!(nodes[1], chan_id_1).encode();
1037         let chan_1_monitor_serialized = get_monitor!(nodes[1], chan_id_2).encode();
1038         reload_node!(nodes[1], node_encoded, &[&chan_0_monitor_serialized, &chan_1_monitor_serialized], persister, new_chain_monitor, nodes_1_deserialized);
1039
1040         // Note that this checks that this is the only event on nodes[1], implying the
1041         // `HTLCIntercepted` event has been removed in the `use_intercept` case.
1042         check_closed_event!(nodes[1], 1, ClosureReason::OutdatedChannelManager, [nodes[2].node.get_our_node_id()], 100000);
1043
1044         if use_intercept {
1045                 // Attempt to forward the HTLC back out over nodes[1]' still-open channel, ensuring we get
1046                 // a intercept-doesn't-exist error.
1047                 let forward_err = nodes[1].node.forward_intercepted_htlc(intercept_id.unwrap(), &chan_id_1,
1048                         nodes[0].node.get_our_node_id(), expected_outbound_amount_msat.unwrap()).unwrap_err();
1049                 assert_eq!(forward_err, APIError::APIMisuseError {
1050                         err: format!("Payment with intercept id {} not found", log_bytes!(intercept_id.unwrap().0))
1051                 });
1052         }
1053
1054         nodes[1].node.timer_tick_occurred();
1055         let bs_commitment_tx = nodes[1].tx_broadcaster.txn_broadcasted.lock().unwrap().split_off(0);
1056         assert_eq!(bs_commitment_tx.len(), 1);
1057         check_added_monitors!(nodes[1], 1);
1058
1059         nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id());
1060         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[1]));
1061
1062         if use_cs_commitment {
1063                 // If we confirm a commitment transaction that has the HTLC on-chain, nodes[1] should wait
1064                 // for an HTLC-spending transaction before it does anything with the HTLC upstream.
1065                 confirm_transaction(&nodes[1], &cs_commitment_tx[0]);
1066                 assert!(nodes[1].node.get_and_clear_pending_events().is_empty());
1067                 assert!(nodes[1].node.get_and_clear_pending_msg_events().is_empty());
1068
1069                 if claim_htlc {
1070                         confirm_transaction(&nodes[1], &cs_commitment_tx[1]);
1071                 } else {
1072                         connect_blocks(&nodes[1], htlc_expiry - nodes[1].best_block_info().1 + 1);
1073                         let mut txn = nodes[1].tx_broadcaster.txn_broadcast();
1074                         assert_eq!(txn.len(), if nodes[1].connect_style.borrow().updates_best_block_first() { 2 } else { 1 });
1075                         let bs_htlc_timeout_tx = txn.pop().unwrap();
1076                         confirm_transaction(&nodes[1], &bs_htlc_timeout_tx);
1077                 }
1078         } else {
1079                 confirm_transaction(&nodes[1], &bs_commitment_tx[0]);
1080         }
1081
1082         if !claim_htlc {
1083                 expect_pending_htlcs_forwardable_and_htlc_handling_failed!(nodes[1], [HTLCDestination::NextHopChannel { node_id: Some(nodes[2].node.get_our_node_id()), channel_id: chan_id_2 }]);
1084         } else {
1085                 expect_payment_forwarded!(nodes[1], nodes[0], nodes[2], Some(1000), false, true);
1086         }
1087         check_added_monitors!(nodes[1], 1);
1088
1089         let events = nodes[1].node.get_and_clear_pending_msg_events();
1090         assert_eq!(events.len(), 1);
1091         match &events[0] {
1092                 MessageSendEvent::UpdateHTLCs { updates: msgs::CommitmentUpdate { update_fulfill_htlcs, update_fail_htlcs, commitment_signed, .. }, .. } => {
1093                         if claim_htlc {
1094                                 nodes[0].node.handle_update_fulfill_htlc(&nodes[1].node.get_our_node_id(), &update_fulfill_htlcs[0]);
1095                         } else {
1096                                 nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &update_fail_htlcs[0]);
1097                         }
1098                         commitment_signed_dance!(nodes[0], nodes[1], commitment_signed, false);
1099                 },
1100                 _ => panic!("Unexpected event"),
1101         }
1102
1103         if claim_htlc {
1104                 expect_payment_sent!(nodes[0], payment_preimage);
1105         } else {
1106                 expect_payment_failed!(nodes[0], payment_hash, false);
1107         }
1108 }
1109
1110 #[test]
1111 fn forwarded_payment_no_manager_persistence() {
1112         do_forwarded_payment_no_manager_persistence(true, true, false);
1113         do_forwarded_payment_no_manager_persistence(true, false, false);
1114         do_forwarded_payment_no_manager_persistence(false, false, false);
1115 }
1116
1117 #[test]
1118 fn intercepted_payment_no_manager_persistence() {
1119         do_forwarded_payment_no_manager_persistence(true, true, true);
1120         do_forwarded_payment_no_manager_persistence(true, false, true);
1121         do_forwarded_payment_no_manager_persistence(false, false, true);
1122 }
1123
1124 #[test]
1125 fn removed_payment_no_manager_persistence() {
1126         // If an HTLC is failed to us on a channel, and the ChannelMonitor persistence completes, but
1127         // the corresponding ChannelManager persistence does not, we need to ensure that the HTLC is
1128         // still failed back to the previous hop even though the ChannelMonitor now no longer is aware
1129         // of the HTLC. This was previously broken as no attempt was made to figure out which HTLCs
1130         // were left dangling when a channel was force-closed due to a stale ChannelManager.
1131         let chanmon_cfgs = create_chanmon_cfgs(3);
1132         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
1133         let persister;
1134         let new_chain_monitor;
1135
1136         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
1137         let nodes_1_deserialized;
1138
1139         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
1140
1141         let chan_id_1 = create_announced_chan_between_nodes(&nodes, 0, 1).2;
1142         let chan_id_2 = create_announced_chan_between_nodes(&nodes, 1, 2).2;
1143
1144         let (_, payment_hash, ..) = route_payment(&nodes[0], &[&nodes[1], &nodes[2]], 1_000_000);
1145
1146         let node_encoded = nodes[1].node.encode();
1147
1148         nodes[2].node.fail_htlc_backwards(&payment_hash);
1149         expect_pending_htlcs_forwardable_and_htlc_handling_failed!(nodes[2], [HTLCDestination::FailedPayment { payment_hash }]);
1150         check_added_monitors!(nodes[2], 1);
1151         let events = nodes[2].node.get_and_clear_pending_msg_events();
1152         assert_eq!(events.len(), 1);
1153         match &events[0] {
1154                 MessageSendEvent::UpdateHTLCs { updates: msgs::CommitmentUpdate { update_fail_htlcs, commitment_signed, .. }, .. } => {
1155                         nodes[1].node.handle_update_fail_htlc(&nodes[2].node.get_our_node_id(), &update_fail_htlcs[0]);
1156                         commitment_signed_dance!(nodes[1], nodes[2], commitment_signed, false);
1157                 },
1158                 _ => panic!("Unexpected event"),
1159         }
1160
1161         let chan_0_monitor_serialized = get_monitor!(nodes[1], chan_id_1).encode();
1162         let chan_1_monitor_serialized = get_monitor!(nodes[1], chan_id_2).encode();
1163         reload_node!(nodes[1], node_encoded, &[&chan_0_monitor_serialized, &chan_1_monitor_serialized], persister, new_chain_monitor, nodes_1_deserialized);
1164
1165         match nodes[1].node.pop_pending_event().unwrap() {
1166                 Event::ChannelClosed { ref reason, .. } => {
1167                         assert_eq!(*reason, ClosureReason::OutdatedChannelManager);
1168                 },
1169                 _ => panic!("Unexpected event"),
1170         }
1171
1172         nodes[1].node.test_process_background_events();
1173         check_added_monitors(&nodes[1], 1);
1174
1175         // Now that the ChannelManager has force-closed the channel which had the HTLC removed, it is
1176         // now forgotten everywhere. The ChannelManager should have, as a side-effect of reload,
1177         // learned that the HTLC is gone from the ChannelMonitor and added it to the to-fail-back set.
1178         nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id());
1179         reconnect_nodes(ReconnectArgs::new(&nodes[0], &nodes[1]));
1180
1181         expect_pending_htlcs_forwardable_and_htlc_handling_failed!(nodes[1], [HTLCDestination::NextHopChannel { node_id: Some(nodes[2].node.get_our_node_id()), channel_id: chan_id_2 }]);
1182         check_added_monitors!(nodes[1], 1);
1183         let events = nodes[1].node.get_and_clear_pending_msg_events();
1184         assert_eq!(events.len(), 1);
1185         match &events[0] {
1186                 MessageSendEvent::UpdateHTLCs { updates: msgs::CommitmentUpdate { update_fail_htlcs, commitment_signed, .. }, .. } => {
1187                         nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &update_fail_htlcs[0]);
1188                         commitment_signed_dance!(nodes[0], nodes[1], commitment_signed, false);
1189                 },
1190                 _ => panic!("Unexpected event"),
1191         }
1192
1193         expect_payment_failed!(nodes[0], payment_hash, false);
1194 }
1195
1196 #[test]
1197 fn test_reload_partial_funding_batch() {
1198         let chanmon_cfgs = create_chanmon_cfgs(3);
1199         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
1200         let new_persister;
1201         let new_chain_monitor;
1202
1203         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
1204         let new_channel_manager;
1205         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
1206
1207         // Initiate channel opening and create the batch channel funding transaction.
1208         let (tx, funding_created_msgs) = create_batch_channel_funding(&nodes[0], &[
1209                 (&nodes[1], 100_000, 0, 42, None),
1210                 (&nodes[2], 200_000, 0, 43, None),
1211         ]);
1212
1213         // Go through the funding_created and funding_signed flow with node 1.
1214         nodes[1].node.handle_funding_created(&nodes[0].node.get_our_node_id(), &funding_created_msgs[0]);
1215         check_added_monitors(&nodes[1], 1);
1216         expect_channel_pending_event(&nodes[1], &nodes[0].node.get_our_node_id());
1217
1218         // The monitor is persisted when receiving funding_signed.
1219         let funding_signed_msg = get_event_msg!(nodes[1], MessageSendEvent::SendFundingSigned, nodes[0].node.get_our_node_id());
1220         nodes[0].node.handle_funding_signed(&nodes[1].node.get_our_node_id(), &funding_signed_msg);
1221         check_added_monitors(&nodes[0], 1);
1222
1223         // The transaction should not have been broadcast before all channels are ready.
1224         assert_eq!(nodes[0].tx_broadcaster.txn_broadcast().len(), 0);
1225
1226         // Reload the node while a subset of the channels in the funding batch have persisted monitors.
1227         let channel_id_1 = ChannelId::v1_from_funding_outpoint(OutPoint { txid: tx.txid(), index: 0 });
1228         let node_encoded = nodes[0].node.encode();
1229         let channel_monitor_1_serialized = get_monitor!(nodes[0], channel_id_1).encode();
1230         reload_node!(nodes[0], node_encoded, &[&channel_monitor_1_serialized], new_persister, new_chain_monitor, new_channel_manager);
1231
1232         // Process monitor events.
1233         assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
1234
1235         // The monitor should become closed.
1236         check_added_monitors(&nodes[0], 1);
1237         {
1238                 let mut monitor_updates = nodes[0].chain_monitor.monitor_updates.lock().unwrap();
1239                 let monitor_updates_1 = monitor_updates.get(&channel_id_1).unwrap();
1240                 assert_eq!(monitor_updates_1.len(), 1);
1241                 assert_eq!(monitor_updates_1[0].update_id, CLOSED_CHANNEL_UPDATE_ID);
1242         }
1243
1244         // The funding transaction should not have been broadcast, but we broadcast the force-close
1245         // transaction as part of closing the monitor.
1246         {
1247                 let broadcasted_txs = nodes[0].tx_broadcaster.txn_broadcast();
1248                 assert_eq!(broadcasted_txs.len(), 1);
1249                 assert!(broadcasted_txs[0].txid() != tx.txid());
1250                 assert_eq!(broadcasted_txs[0].input.len(), 1);
1251                 assert_eq!(broadcasted_txs[0].input[0].previous_output.txid, tx.txid());
1252         }
1253
1254         // Ensure the channels don't exist anymore.
1255         assert!(nodes[0].node.list_channels().is_empty());
1256 }