1 // This file is Copyright its original authors, visible in version control
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
10 //! Test that monitor update failures don't get our channel state out of sync.
11 //! One of the biggest concern with the monitor update failure handling code is that messages
12 //! resent after monitor updating is restored are delivered out-of-order, resulting in
13 //! commitment_signed messages having "invalid signatures".
14 //! To test this we stand up a network of three nodes and read bytes from the fuzz input to denote
15 //! actions such as sending payments, handling events, or changing monitor update return values on
16 //! a per-node basis. This should allow it to find any cases where the ordering of actions results
17 //! in us getting out of sync with ourselves, and, assuming at least one of our recieve- or
18 //! send-side handling is correct, other peers. We consider it a failure if any action results in a
19 //! channel being force-closed.
21 use bitcoin::blockdata::block::BlockHeader;
22 use bitcoin::blockdata::transaction::{Transaction, TxOut};
23 use bitcoin::blockdata::script::{Builder, Script};
24 use bitcoin::blockdata::opcodes;
25 use bitcoin::network::constants::Network;
27 use bitcoin::hashes::Hash as TraitImport;
28 use bitcoin::hashes::sha256::Hash as Sha256;
29 use bitcoin::hash_types::{BlockHash, WPubkeyHash};
32 use lightning::chain::chainmonitor;
33 use lightning::chain::channelmonitor;
34 use lightning::chain::channelmonitor::{ChannelMonitor, ChannelMonitorUpdateErr, MonitorEvent};
35 use lightning::chain::transaction::OutPoint;
36 use lightning::chain::chaininterface::{BroadcasterInterface, ConfirmationTarget, FeeEstimator};
37 use lightning::chain::keysinterface::{KeysInterface, InMemoryChannelKeys};
38 use lightning::ln::channelmanager::{ChannelManager, PaymentHash, PaymentPreimage, PaymentSecret, PaymentSendFailure, ChannelManagerReadArgs};
39 use lightning::ln::features::{ChannelFeatures, InitFeatures, NodeFeatures};
40 use lightning::ln::msgs::{CommitmentUpdate, ChannelMessageHandler, ErrorAction, UpdateAddHTLC, Init};
41 use lightning::util::enforcing_trait_impls::EnforcingChannelKeys;
42 use lightning::util::errors::APIError;
43 use lightning::util::events;
44 use lightning::util::logger::Logger;
45 use lightning::util::config::UserConfig;
46 use lightning::util::events::{EventsProvider, MessageSendEventsProvider};
47 use lightning::util::ser::{Readable, ReadableArgs, Writeable, Writer};
48 use lightning::routing::router::{Route, RouteHop};
51 use utils::test_logger;
52 use utils::test_persister::TestPersister;
54 use bitcoin::secp256k1::key::{PublicKey,SecretKey};
55 use bitcoin::secp256k1::Secp256k1;
58 use std::cmp::Ordering;
59 use std::collections::{HashSet, hash_map, HashMap};
60 use std::sync::{Arc,Mutex};
61 use std::sync::atomic;
64 struct FuzzEstimator {}
65 impl FeeEstimator for FuzzEstimator {
66 fn get_est_sat_per_1000_weight(&self, _: ConfirmationTarget) -> u32 {
71 pub struct TestBroadcaster {}
72 impl BroadcasterInterface for TestBroadcaster {
73 fn broadcast_transaction(&self, _tx: &Transaction) { }
76 pub struct VecWriter(pub Vec<u8>);
77 impl Writer for VecWriter {
78 fn write_all(&mut self, buf: &[u8]) -> Result<(), ::std::io::Error> {
79 self.0.extend_from_slice(buf);
82 fn size_hint(&mut self, size: usize) {
83 self.0.reserve_exact(size);
87 struct TestChainMonitor {
88 pub logger: Arc<dyn Logger>,
89 pub chain_monitor: Arc<chainmonitor::ChainMonitor<EnforcingChannelKeys, Arc<dyn chain::Filter>, Arc<TestBroadcaster>, Arc<FuzzEstimator>, Arc<dyn Logger>, Arc<TestPersister>>>,
90 pub update_ret: Mutex<Result<(), channelmonitor::ChannelMonitorUpdateErr>>,
91 // If we reload a node with an old copy of ChannelMonitors, the ChannelManager deserialization
92 // logic will automatically force-close our channels for us (as we don't have an up-to-date
93 // monitor implying we are not able to punish misbehaving counterparties). Because this test
94 // "fails" if we ever force-close a channel, we avoid doing so, always saving the latest
95 // fully-serialized monitor state here, as well as the corresponding update_id.
96 pub latest_monitors: Mutex<HashMap<OutPoint, (u64, Vec<u8>)>>,
97 pub should_update_manager: atomic::AtomicBool,
99 impl TestChainMonitor {
100 pub fn new(broadcaster: Arc<TestBroadcaster>, logger: Arc<dyn Logger>, feeest: Arc<FuzzEstimator>, persister: Arc<TestPersister>) -> Self {
102 chain_monitor: Arc::new(chainmonitor::ChainMonitor::new(None, broadcaster, logger.clone(), feeest, persister)),
104 update_ret: Mutex::new(Ok(())),
105 latest_monitors: Mutex::new(HashMap::new()),
106 should_update_manager: atomic::AtomicBool::new(false),
110 impl chain::Watch for TestChainMonitor {
111 type Keys = EnforcingChannelKeys;
113 fn watch_channel(&self, funding_txo: OutPoint, monitor: channelmonitor::ChannelMonitor<EnforcingChannelKeys>) -> Result<(), channelmonitor::ChannelMonitorUpdateErr> {
114 let mut ser = VecWriter(Vec::new());
115 monitor.serialize_for_disk(&mut ser).unwrap();
116 if let Some(_) = self.latest_monitors.lock().unwrap().insert(funding_txo, (monitor.get_latest_update_id(), ser.0)) {
117 panic!("Already had monitor pre-watch_channel");
119 self.should_update_manager.store(true, atomic::Ordering::Relaxed);
120 assert!(self.chain_monitor.watch_channel(funding_txo, monitor).is_ok());
121 self.update_ret.lock().unwrap().clone()
124 fn update_channel(&self, funding_txo: OutPoint, update: channelmonitor::ChannelMonitorUpdate) -> Result<(), channelmonitor::ChannelMonitorUpdateErr> {
125 let mut map_lock = self.latest_monitors.lock().unwrap();
126 let mut map_entry = match map_lock.entry(funding_txo) {
127 hash_map::Entry::Occupied(entry) => entry,
128 hash_map::Entry::Vacant(_) => panic!("Didn't have monitor on update call"),
130 let mut deserialized_monitor = <(BlockHash, channelmonitor::ChannelMonitor<EnforcingChannelKeys>)>::
131 read(&mut Cursor::new(&map_entry.get().1)).unwrap().1;
132 deserialized_monitor.update_monitor(&update, &&TestBroadcaster{}, &&FuzzEstimator{}, &self.logger).unwrap();
133 let mut ser = VecWriter(Vec::new());
134 deserialized_monitor.serialize_for_disk(&mut ser).unwrap();
135 map_entry.insert((update.update_id, ser.0));
136 self.should_update_manager.store(true, atomic::Ordering::Relaxed);
137 self.update_ret.lock().unwrap().clone()
140 fn release_pending_monitor_events(&self) -> Vec<MonitorEvent> {
141 return self.chain_monitor.release_pending_monitor_events();
147 rand_bytes_id: atomic::AtomicU8,
149 impl KeysInterface for KeyProvider {
150 type ChanKeySigner = EnforcingChannelKeys;
152 fn get_node_secret(&self) -> SecretKey {
153 SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, self.node_id]).unwrap()
156 fn get_destination_script(&self) -> Script {
157 let secp_ctx = Secp256k1::signing_only();
158 let channel_monitor_claim_key = SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, self.node_id]).unwrap();
159 let our_channel_monitor_claim_key_hash = WPubkeyHash::hash(&PublicKey::from_secret_key(&secp_ctx, &channel_monitor_claim_key).serialize());
160 Builder::new().push_opcode(opcodes::all::OP_PUSHBYTES_0).push_slice(&our_channel_monitor_claim_key_hash[..]).into_script()
163 fn get_shutdown_pubkey(&self) -> PublicKey {
164 let secp_ctx = Secp256k1::signing_only();
165 PublicKey::from_secret_key(&secp_ctx, &SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 3, self.node_id]).unwrap())
168 fn get_channel_keys(&self, _inbound: bool, channel_value_satoshis: u64) -> EnforcingChannelKeys {
169 let secp_ctx = Secp256k1::signing_only();
170 EnforcingChannelKeys::new(InMemoryChannelKeys::new(
172 SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, self.node_id]).unwrap(),
173 SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 5, self.node_id]).unwrap(),
174 SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6, self.node_id]).unwrap(),
175 SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, self.node_id]).unwrap(),
176 SecretKey::from_slice(&[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, self.node_id]).unwrap(),
177 [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 9, self.node_id],
178 channel_value_satoshis,
183 fn get_secure_random_bytes(&self) -> [u8; 32] {
184 let id = self.rand_bytes_id.fetch_add(1, atomic::Ordering::Relaxed);
185 [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, id, 11, self.node_id]
190 fn check_api_err(api_err: APIError) {
192 APIError::APIMisuseError { .. } => panic!("We can't misuse the API"),
193 APIError::FeeRateTooHigh { .. } => panic!("We can't send too much fee?"),
194 APIError::RouteError { .. } => panic!("Our routes should work"),
195 APIError::ChannelUnavailable { err } => {
196 // Test the error against a list of errors we can hit, and reject
197 // all others. If you hit this panic, the list of acceptable errors
198 // is probably just stale and you should add new messages here.
200 "Peer for first hop currently disconnected/pending monitor update!" => {},
201 _ if err.starts_with("Cannot push more than their max accepted HTLCs ") => {},
202 _ if err.starts_with("Cannot send value that would put us over the max HTLC value in flight our peer will accept ") => {},
203 _ if err.starts_with("Cannot send value that would put our balance under counterparty-announced channel reserve value") => {},
204 _ if err.starts_with("Cannot send value that would overdraw remaining funds.") => {},
205 _ if err.starts_with("Cannot send value that would not leave enough to pay for fees.") => {},
209 APIError::MonitorUpdateFailed => {
210 // We can (obviously) temp-fail a monitor update
215 fn check_payment_err(send_err: PaymentSendFailure) {
217 PaymentSendFailure::ParameterError(api_err) => check_api_err(api_err),
218 PaymentSendFailure::PathParameterError(per_path_results) => {
219 for res in per_path_results { if let Err(api_err) = res { check_api_err(api_err); } }
221 PaymentSendFailure::AllFailedRetrySafe(per_path_results) => {
222 for api_err in per_path_results { check_api_err(api_err); }
224 PaymentSendFailure::PartialFailure(per_path_results) => {
225 for res in per_path_results { if let Err(api_err) = res { check_api_err(api_err); } }
230 type ChanMan = ChannelManager<EnforcingChannelKeys, Arc<TestChainMonitor>, Arc<TestBroadcaster>, Arc<KeyProvider>, Arc<FuzzEstimator>, Arc<dyn Logger>>;
233 fn send_payment(source: &ChanMan, dest: &ChanMan, dest_chan_id: u64, amt: u64, payment_id: &mut u8) -> bool {
234 let payment_hash = Sha256::hash(&[*payment_id; 1]);
235 *payment_id = payment_id.wrapping_add(1);
236 if let Err(err) = source.send_payment(&Route {
237 paths: vec![vec![RouteHop {
238 pubkey: dest.get_our_node_id(),
239 node_features: NodeFeatures::empty(),
240 short_channel_id: dest_chan_id,
241 channel_features: ChannelFeatures::empty(),
243 cltv_expiry_delta: 200,
245 }, PaymentHash(payment_hash.into_inner()), &None) {
246 check_payment_err(err);
251 fn send_hop_payment(source: &ChanMan, middle: &ChanMan, middle_chan_id: u64, dest: &ChanMan, dest_chan_id: u64, amt: u64, payment_id: &mut u8) -> bool {
252 let payment_hash = Sha256::hash(&[*payment_id; 1]);
253 *payment_id = payment_id.wrapping_add(1);
254 if let Err(err) = source.send_payment(&Route {
255 paths: vec![vec![RouteHop {
256 pubkey: middle.get_our_node_id(),
257 node_features: NodeFeatures::empty(),
258 short_channel_id: middle_chan_id,
259 channel_features: ChannelFeatures::empty(),
261 cltv_expiry_delta: 100,
263 pubkey: dest.get_our_node_id(),
264 node_features: NodeFeatures::empty(),
265 short_channel_id: dest_chan_id,
266 channel_features: ChannelFeatures::empty(),
268 cltv_expiry_delta: 200,
270 }, PaymentHash(payment_hash.into_inner()), &None) {
271 check_payment_err(err);
277 pub fn do_test<Out: test_logger::Output>(data: &[u8], out: Out) {
278 let fee_est = Arc::new(FuzzEstimator{});
279 let broadcast = Arc::new(TestBroadcaster{});
281 macro_rules! make_node {
282 ($node_id: expr) => { {
283 let logger: Arc<dyn Logger> = Arc::new(test_logger::TestLogger::new($node_id.to_string(), out.clone()));
284 let monitor = Arc::new(TestChainMonitor::new(broadcast.clone(), logger.clone(), fee_est.clone(), Arc::new(TestPersister{})));
286 let keys_manager = Arc::new(KeyProvider { node_id: $node_id, rand_bytes_id: atomic::AtomicU8::new(0) });
287 let mut config = UserConfig::default();
288 config.channel_options.fee_proportional_millionths = 0;
289 config.channel_options.announced_channel = true;
290 config.peer_channel_config_limits.min_dust_limit_satoshis = 0;
291 (ChannelManager::new(Network::Bitcoin, fee_est.clone(), monitor.clone(), broadcast.clone(), Arc::clone(&logger), keys_manager.clone(), config, 0),
296 macro_rules! reload_node {
297 ($ser: expr, $node_id: expr, $old_monitors: expr) => { {
298 let logger: Arc<dyn Logger> = Arc::new(test_logger::TestLogger::new($node_id.to_string(), out.clone()));
299 let chain_monitor = Arc::new(TestChainMonitor::new(broadcast.clone(), logger.clone(), fee_est.clone(), Arc::new(TestPersister{})));
301 let keys_manager = Arc::new(KeyProvider { node_id: $node_id, rand_bytes_id: atomic::AtomicU8::new(0) });
302 let mut config = UserConfig::default();
303 config.channel_options.fee_proportional_millionths = 0;
304 config.channel_options.announced_channel = true;
305 config.peer_channel_config_limits.min_dust_limit_satoshis = 0;
307 let mut monitors = HashMap::new();
308 let mut old_monitors = $old_monitors.latest_monitors.lock().unwrap();
309 for (outpoint, (update_id, monitor_ser)) in old_monitors.drain() {
310 monitors.insert(outpoint, <(BlockHash, ChannelMonitor<EnforcingChannelKeys>)>::read(&mut Cursor::new(&monitor_ser)).expect("Failed to read monitor").1);
311 chain_monitor.latest_monitors.lock().unwrap().insert(outpoint, (update_id, monitor_ser));
313 let mut monitor_refs = HashMap::new();
314 for (outpoint, monitor) in monitors.iter_mut() {
315 monitor_refs.insert(*outpoint, monitor);
318 let read_args = ChannelManagerReadArgs {
320 fee_estimator: fee_est.clone(),
321 chain_monitor: chain_monitor.clone(),
322 tx_broadcaster: broadcast.clone(),
324 default_config: config,
325 channel_monitors: monitor_refs,
328 (<(BlockHash, ChanMan)>::read(&mut Cursor::new(&$ser.0), read_args).expect("Failed to read manager").1, chain_monitor)
332 let mut channel_txn = Vec::new();
333 macro_rules! make_channel {
334 ($source: expr, $dest: expr, $chan_id: expr) => { {
335 $source.create_channel($dest.get_our_node_id(), 100_000, 42, 0, None).unwrap();
337 let events = $source.get_and_clear_pending_msg_events();
338 assert_eq!(events.len(), 1);
339 if let events::MessageSendEvent::SendOpenChannel { ref msg, .. } = events[0] {
341 } else { panic!("Wrong event type"); }
344 $dest.handle_open_channel(&$source.get_our_node_id(), InitFeatures::known(), &open_channel);
345 let accept_channel = {
346 let events = $dest.get_and_clear_pending_msg_events();
347 assert_eq!(events.len(), 1);
348 if let events::MessageSendEvent::SendAcceptChannel { ref msg, .. } = events[0] {
350 } else { panic!("Wrong event type"); }
353 $source.handle_accept_channel(&$dest.get_our_node_id(), InitFeatures::known(), &accept_channel);
356 let events = $source.get_and_clear_pending_events();
357 assert_eq!(events.len(), 1);
358 if let events::Event::FundingGenerationReady { ref temporary_channel_id, ref channel_value_satoshis, ref output_script, .. } = events[0] {
359 let tx = Transaction { version: $chan_id, lock_time: 0, input: Vec::new(), output: vec![TxOut {
360 value: *channel_value_satoshis, script_pubkey: output_script.clone(),
362 funding_output = OutPoint { txid: tx.txid(), index: 0 };
363 $source.funding_transaction_generated(&temporary_channel_id, funding_output);
364 channel_txn.push(tx);
365 } else { panic!("Wrong event type"); }
368 let funding_created = {
369 let events = $source.get_and_clear_pending_msg_events();
370 assert_eq!(events.len(), 1);
371 if let events::MessageSendEvent::SendFundingCreated { ref msg, .. } = events[0] {
373 } else { panic!("Wrong event type"); }
375 $dest.handle_funding_created(&$source.get_our_node_id(), &funding_created);
377 let funding_signed = {
378 let events = $dest.get_and_clear_pending_msg_events();
379 assert_eq!(events.len(), 1);
380 if let events::MessageSendEvent::SendFundingSigned { ref msg, .. } = events[0] {
382 } else { panic!("Wrong event type"); }
384 $source.handle_funding_signed(&$dest.get_our_node_id(), &funding_signed);
387 let events = $source.get_and_clear_pending_events();
388 assert_eq!(events.len(), 1);
389 if let events::Event::FundingBroadcastSafe { .. } = events[0] {
390 } else { panic!("Wrong event type"); }
396 macro_rules! confirm_txn {
398 let mut header = BlockHeader { version: 0x20000000, prev_blockhash: Default::default(), merkle_root: Default::default(), time: 42, bits: 42, nonce: 42 };
399 let txdata: Vec<_> = channel_txn.iter().enumerate().map(|(i, tx)| (i + 1, tx)).collect();
400 $node.block_connected(&header, &txdata, 1);
402 header = BlockHeader { version: 0x20000000, prev_blockhash: header.block_hash(), merkle_root: Default::default(), time: 42, bits: 42, nonce: 42 };
403 $node.block_connected(&header, &[], i);
408 macro_rules! lock_fundings {
409 ($nodes: expr) => { {
410 let mut node_events = Vec::new();
411 for node in $nodes.iter() {
412 node_events.push(node.get_and_clear_pending_msg_events());
414 for (idx, node_event) in node_events.iter().enumerate() {
415 for event in node_event {
416 if let events::MessageSendEvent::SendFundingLocked { ref node_id, ref msg } = event {
417 for node in $nodes.iter() {
418 if node.get_our_node_id() == *node_id {
419 node.handle_funding_locked(&$nodes[idx].get_our_node_id(), msg);
422 } else { panic!("Wrong event type"); }
426 for node in $nodes.iter() {
427 let events = node.get_and_clear_pending_msg_events();
428 for event in events {
429 if let events::MessageSendEvent::SendAnnouncementSignatures { .. } = event {
430 } else { panic!("Wrong event type"); }
436 // 3 nodes is enough to hit all the possible cases, notably unknown-source-unknown-dest
438 let (node_a, mut monitor_a) = make_node!(0);
439 let (node_b, mut monitor_b) = make_node!(1);
440 let (node_c, mut monitor_c) = make_node!(2);
442 let mut nodes = [node_a, node_b, node_c];
444 let chan_1_funding = make_channel!(nodes[0], nodes[1], 0);
445 let chan_2_funding = make_channel!(nodes[1], nodes[2], 1);
447 for node in nodes.iter() {
451 lock_fundings!(nodes);
453 let chan_a = nodes[0].list_usable_channels()[0].short_channel_id.unwrap();
454 let chan_b = nodes[2].list_usable_channels()[0].short_channel_id.unwrap();
456 let mut payment_id: u8 = 0;
458 let mut chan_a_disconnected = false;
459 let mut chan_b_disconnected = false;
460 let mut ba_events = Vec::new();
461 let mut bc_events = Vec::new();
463 let mut node_a_ser = VecWriter(Vec::new());
464 nodes[0].write(&mut node_a_ser).unwrap();
465 let mut node_b_ser = VecWriter(Vec::new());
466 nodes[1].write(&mut node_b_ser).unwrap();
467 let mut node_c_ser = VecWriter(Vec::new());
468 nodes[2].write(&mut node_c_ser).unwrap();
470 macro_rules! test_return {
472 assert_eq!(nodes[0].list_channels().len(), 1);
473 assert_eq!(nodes[1].list_channels().len(), 2);
474 assert_eq!(nodes[2].list_channels().len(), 1);
479 let mut read_pos = 0;
480 macro_rules! get_slice {
483 let slice_len = $len as usize;
484 if data.len() < read_pos + slice_len {
487 read_pos += slice_len;
488 &data[read_pos - slice_len..read_pos]
494 macro_rules! send_payment_with_secret {
495 ($source: expr, $middle: expr, $dest: expr) => { {
496 let payment_hash = Sha256::hash(&[payment_id; 1]);
497 payment_id = payment_id.wrapping_add(1);
498 let payment_secret = Sha256::hash(&[payment_id; 1]);
499 payment_id = payment_id.wrapping_add(1);
500 if let Err(err) = $source.send_payment(&Route {
501 paths: vec![vec![RouteHop {
502 pubkey: $middle.0.get_our_node_id(),
503 node_features: NodeFeatures::empty(),
504 short_channel_id: $middle.1,
505 channel_features: ChannelFeatures::empty(),
507 cltv_expiry_delta: 100,
509 pubkey: $dest.0.get_our_node_id(),
510 node_features: NodeFeatures::empty(),
511 short_channel_id: $dest.1,
512 channel_features: ChannelFeatures::empty(),
513 fee_msat: 10_000_000,
514 cltv_expiry_delta: 200,
516 pubkey: $middle.0.get_our_node_id(),
517 node_features: NodeFeatures::empty(),
518 short_channel_id: $middle.1,
519 channel_features: ChannelFeatures::empty(),
521 cltv_expiry_delta: 100,
523 pubkey: $dest.0.get_our_node_id(),
524 node_features: NodeFeatures::empty(),
525 short_channel_id: $dest.1,
526 channel_features: ChannelFeatures::empty(),
527 fee_msat: 10_000_000,
528 cltv_expiry_delta: 200,
530 }, PaymentHash(payment_hash.into_inner()), &Some(PaymentSecret(payment_secret.into_inner()))) {
531 check_payment_err(err);
536 macro_rules! process_msg_events {
537 ($node: expr, $corrupt_forward: expr) => { {
538 let events = if $node == 1 {
539 let mut new_events = Vec::new();
540 mem::swap(&mut new_events, &mut ba_events);
541 new_events.extend_from_slice(&bc_events[..]);
544 } else { Vec::new() };
545 for event in events.iter().chain(nodes[$node].get_and_clear_pending_msg_events().iter()) {
547 events::MessageSendEvent::UpdateHTLCs { ref node_id, updates: CommitmentUpdate { ref update_add_htlcs, ref update_fail_htlcs, ref update_fulfill_htlcs, ref update_fail_malformed_htlcs, ref update_fee, ref commitment_signed } } => {
548 for dest in nodes.iter() {
549 if dest.get_our_node_id() == *node_id {
550 assert!(update_fee.is_none());
551 for update_add in update_add_htlcs {
552 if !$corrupt_forward {
553 dest.handle_update_add_htlc(&nodes[$node].get_our_node_id(), &update_add);
555 // Corrupt the update_add_htlc message so that its HMAC
556 // check will fail and we generate a
557 // update_fail_malformed_htlc instead of an
558 // update_fail_htlc as we do when we reject a payment.
559 let mut msg_ser = update_add.encode();
560 msg_ser[1000] ^= 0xff;
561 let new_msg = UpdateAddHTLC::read(&mut Cursor::new(&msg_ser)).unwrap();
562 dest.handle_update_add_htlc(&nodes[$node].get_our_node_id(), &new_msg);
565 for update_fulfill in update_fulfill_htlcs {
566 dest.handle_update_fulfill_htlc(&nodes[$node].get_our_node_id(), &update_fulfill);
568 for update_fail in update_fail_htlcs {
569 dest.handle_update_fail_htlc(&nodes[$node].get_our_node_id(), &update_fail);
571 for update_fail_malformed in update_fail_malformed_htlcs {
572 dest.handle_update_fail_malformed_htlc(&nodes[$node].get_our_node_id(), &update_fail_malformed);
574 dest.handle_commitment_signed(&nodes[$node].get_our_node_id(), &commitment_signed);
578 events::MessageSendEvent::SendRevokeAndACK { ref node_id, ref msg } => {
579 for dest in nodes.iter() {
580 if dest.get_our_node_id() == *node_id {
581 dest.handle_revoke_and_ack(&nodes[$node].get_our_node_id(), msg);
585 events::MessageSendEvent::SendChannelReestablish { ref node_id, ref msg } => {
586 for dest in nodes.iter() {
587 if dest.get_our_node_id() == *node_id {
588 dest.handle_channel_reestablish(&nodes[$node].get_our_node_id(), msg);
592 events::MessageSendEvent::SendFundingLocked { .. } => {
593 // Can be generated as a reestablish response
595 events::MessageSendEvent::PaymentFailureNetworkUpdate { .. } => {
596 // Can be generated due to a payment forward being rejected due to a
597 // channel having previously failed a monitor update
599 events::MessageSendEvent::HandleError { action: ErrorAction::IgnoreError, .. } => {
600 // Can be generated at any processing step to send back an error, disconnect
601 // peer or just ignore
603 _ => panic!("Unhandled message event"),
609 macro_rules! drain_msg_events_on_disconnect {
610 ($counterparty_id: expr) => { {
611 if $counterparty_id == 0 {
612 for event in nodes[0].get_and_clear_pending_msg_events() {
614 events::MessageSendEvent::UpdateHTLCs { .. } => {},
615 events::MessageSendEvent::SendRevokeAndACK { .. } => {},
616 events::MessageSendEvent::SendChannelReestablish { .. } => {},
617 events::MessageSendEvent::SendFundingLocked { .. } => {},
618 events::MessageSendEvent::PaymentFailureNetworkUpdate { .. } => {},
619 events::MessageSendEvent::HandleError { action: ErrorAction::IgnoreError, .. } => {},
620 _ => panic!("Unhandled message event"),
625 for event in nodes[2].get_and_clear_pending_msg_events() {
627 events::MessageSendEvent::UpdateHTLCs { .. } => {},
628 events::MessageSendEvent::SendRevokeAndACK { .. } => {},
629 events::MessageSendEvent::SendChannelReestablish { .. } => {},
630 events::MessageSendEvent::SendFundingLocked { .. } => {},
631 events::MessageSendEvent::PaymentFailureNetworkUpdate { .. } => {},
632 events::MessageSendEvent::HandleError { action: ErrorAction::IgnoreError, .. } => {},
633 _ => panic!("Unhandled message event"),
638 let mut events = nodes[1].get_and_clear_pending_msg_events();
639 let drop_node_id = if $counterparty_id == 0 { nodes[0].get_our_node_id() } else { nodes[2].get_our_node_id() };
640 let msg_sink = if $counterparty_id == 0 { &mut bc_events } else { &mut ba_events };
641 for event in events.drain(..) {
642 let push = match event {
643 events::MessageSendEvent::UpdateHTLCs { ref node_id, .. } => {
644 if *node_id != drop_node_id { true } else { false }
646 events::MessageSendEvent::SendRevokeAndACK { ref node_id, .. } => {
647 if *node_id != drop_node_id { true } else { false }
649 events::MessageSendEvent::SendChannelReestablish { ref node_id, .. } => {
650 if *node_id != drop_node_id { true } else { false }
652 events::MessageSendEvent::SendFundingLocked { .. } => false,
653 events::MessageSendEvent::PaymentFailureNetworkUpdate { .. } => false,
654 events::MessageSendEvent::HandleError { action: ErrorAction::IgnoreError, .. } => false,
655 _ => panic!("Unhandled message event"),
657 if push { msg_sink.push(event); }
662 macro_rules! process_events {
663 ($node: expr, $fail: expr) => { {
664 // In case we get 256 payments we may have a hash collision, resulting in the
665 // second claim/fail call not finding the duplicate-hash HTLC, so we have to
666 // deduplicate the calls here.
667 let mut claim_set = HashSet::new();
668 let mut events = nodes[$node].get_and_clear_pending_events();
669 // Sort events so that PendingHTLCsForwardable get processed last. This avoids a
670 // case where we first process a PendingHTLCsForwardable, then claim/fail on a
671 // PaymentReceived, claiming/failing two HTLCs, but leaving a just-generated
672 // PaymentReceived event for the second HTLC in our pending_events (and breaking
673 // our claim_set deduplication).
674 events.sort_by(|a, b| {
675 if let events::Event::PaymentReceived { .. } = a {
676 if let events::Event::PendingHTLCsForwardable { .. } = b {
678 } else { Ordering::Equal }
679 } else if let events::Event::PendingHTLCsForwardable { .. } = a {
680 if let events::Event::PaymentReceived { .. } = b {
682 } else { Ordering::Equal }
683 } else { Ordering::Equal }
685 for event in events.drain(..) {
687 events::Event::PaymentReceived { payment_hash, payment_secret, amt } => {
688 if claim_set.insert(payment_hash.0) {
690 assert!(nodes[$node].fail_htlc_backwards(&payment_hash, &payment_secret));
692 assert!(nodes[$node].claim_funds(PaymentPreimage(payment_hash.0), &payment_secret, amt));
696 events::Event::PaymentSent { .. } => {},
697 events::Event::PaymentFailed { .. } => {},
698 events::Event::PendingHTLCsForwardable { .. } => {
699 nodes[$node].process_pending_htlc_forwards();
701 _ => panic!("Unhandled event"),
707 match get_slice!(1)[0] {
708 // In general, we keep related message groups close together in binary form, allowing
709 // bit-twiddling mutations to have similar effects. This is probably overkill, but no
712 0x00 => *monitor_a.update_ret.lock().unwrap() = Err(ChannelMonitorUpdateErr::TemporaryFailure),
713 0x01 => *monitor_b.update_ret.lock().unwrap() = Err(ChannelMonitorUpdateErr::TemporaryFailure),
714 0x02 => *monitor_c.update_ret.lock().unwrap() = Err(ChannelMonitorUpdateErr::TemporaryFailure),
715 0x04 => *monitor_a.update_ret.lock().unwrap() = Ok(()),
716 0x05 => *monitor_b.update_ret.lock().unwrap() = Ok(()),
717 0x06 => *monitor_c.update_ret.lock().unwrap() = Ok(()),
720 if let Some((id, _)) = monitor_a.latest_monitors.lock().unwrap().get(&chan_1_funding) {
721 nodes[0].channel_monitor_updated(&chan_1_funding, *id);
725 if let Some((id, _)) = monitor_b.latest_monitors.lock().unwrap().get(&chan_1_funding) {
726 nodes[1].channel_monitor_updated(&chan_1_funding, *id);
730 if let Some((id, _)) = monitor_b.latest_monitors.lock().unwrap().get(&chan_2_funding) {
731 nodes[1].channel_monitor_updated(&chan_2_funding, *id);
735 if let Some((id, _)) = monitor_c.latest_monitors.lock().unwrap().get(&chan_2_funding) {
736 nodes[2].channel_monitor_updated(&chan_2_funding, *id);
741 if !chan_a_disconnected {
742 nodes[0].peer_disconnected(&nodes[1].get_our_node_id(), false);
743 nodes[1].peer_disconnected(&nodes[0].get_our_node_id(), false);
744 chan_a_disconnected = true;
745 drain_msg_events_on_disconnect!(0);
749 if !chan_b_disconnected {
750 nodes[1].peer_disconnected(&nodes[2].get_our_node_id(), false);
751 nodes[2].peer_disconnected(&nodes[1].get_our_node_id(), false);
752 chan_b_disconnected = true;
753 drain_msg_events_on_disconnect!(2);
757 if chan_a_disconnected {
758 nodes[0].peer_connected(&nodes[1].get_our_node_id(), &Init { features: InitFeatures::empty() });
759 nodes[1].peer_connected(&nodes[0].get_our_node_id(), &Init { features: InitFeatures::empty() });
760 chan_a_disconnected = false;
764 if chan_b_disconnected {
765 nodes[1].peer_connected(&nodes[2].get_our_node_id(), &Init { features: InitFeatures::empty() });
766 nodes[2].peer_connected(&nodes[1].get_our_node_id(), &Init { features: InitFeatures::empty() });
767 chan_b_disconnected = false;
771 0x10 => process_msg_events!(0, true),
772 0x11 => process_msg_events!(0, false),
773 0x12 => process_events!(0, true),
774 0x13 => process_events!(0, false),
775 0x14 => process_msg_events!(1, true),
776 0x15 => process_msg_events!(1, false),
777 0x16 => process_events!(1, true),
778 0x17 => process_events!(1, false),
779 0x18 => process_msg_events!(2, true),
780 0x19 => process_msg_events!(2, false),
781 0x1a => process_events!(2, true),
782 0x1b => process_events!(2, false),
785 if !chan_a_disconnected {
786 nodes[1].peer_disconnected(&nodes[0].get_our_node_id(), false);
787 chan_a_disconnected = true;
788 drain_msg_events_on_disconnect!(0);
790 let (new_node_a, new_monitor_a) = reload_node!(node_a_ser, 0, monitor_a);
791 nodes[0] = new_node_a;
792 monitor_a = new_monitor_a;
795 if !chan_a_disconnected {
796 nodes[0].peer_disconnected(&nodes[1].get_our_node_id(), false);
797 chan_a_disconnected = true;
798 nodes[0].get_and_clear_pending_msg_events();
801 if !chan_b_disconnected {
802 nodes[2].peer_disconnected(&nodes[1].get_our_node_id(), false);
803 chan_b_disconnected = true;
804 nodes[2].get_and_clear_pending_msg_events();
807 let (new_node_b, new_monitor_b) = reload_node!(node_b_ser, 1, monitor_b);
808 nodes[1] = new_node_b;
809 monitor_b = new_monitor_b;
812 if !chan_b_disconnected {
813 nodes[1].peer_disconnected(&nodes[2].get_our_node_id(), false);
814 chan_b_disconnected = true;
815 drain_msg_events_on_disconnect!(2);
817 let (new_node_c, new_monitor_c) = reload_node!(node_c_ser, 2, monitor_c);
818 nodes[2] = new_node_c;
819 monitor_c = new_monitor_c;
822 // 1/10th the channel size:
823 0x20 => { send_payment(&nodes[0], &nodes[1], chan_a, 10_000_000, &mut payment_id); },
824 0x21 => { send_payment(&nodes[1], &nodes[0], chan_a, 10_000_000, &mut payment_id); },
825 0x22 => { send_payment(&nodes[1], &nodes[2], chan_b, 10_000_000, &mut payment_id); },
826 0x23 => { send_payment(&nodes[2], &nodes[1], chan_b, 10_000_000, &mut payment_id); },
827 0x24 => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 10_000_000, &mut payment_id); },
828 0x25 => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 10_000_000, &mut payment_id); },
830 0x26 => { send_payment_with_secret!(nodes[0], (&nodes[1], chan_a), (&nodes[2], chan_b)); },
831 0x27 => { send_payment_with_secret!(nodes[2], (&nodes[1], chan_b), (&nodes[0], chan_a)); },
833 0x28 => { send_payment(&nodes[0], &nodes[1], chan_a, 1_000_000, &mut payment_id); },
834 0x29 => { send_payment(&nodes[1], &nodes[0], chan_a, 1_000_000, &mut payment_id); },
835 0x2a => { send_payment(&nodes[1], &nodes[2], chan_b, 1_000_000, &mut payment_id); },
836 0x2b => { send_payment(&nodes[2], &nodes[1], chan_b, 1_000_000, &mut payment_id); },
837 0x2c => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 1_000_000, &mut payment_id); },
838 0x2d => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 1_000_000, &mut payment_id); },
840 0x30 => { send_payment(&nodes[0], &nodes[1], chan_a, 100_000, &mut payment_id); },
841 0x31 => { send_payment(&nodes[1], &nodes[0], chan_a, 100_000, &mut payment_id); },
842 0x32 => { send_payment(&nodes[1], &nodes[2], chan_b, 100_000, &mut payment_id); },
843 0x33 => { send_payment(&nodes[2], &nodes[1], chan_b, 100_000, &mut payment_id); },
844 0x34 => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 100_000, &mut payment_id); },
845 0x35 => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 100_000, &mut payment_id); },
847 0x38 => { send_payment(&nodes[0], &nodes[1], chan_a, 10_000, &mut payment_id); },
848 0x39 => { send_payment(&nodes[1], &nodes[0], chan_a, 10_000, &mut payment_id); },
849 0x3a => { send_payment(&nodes[1], &nodes[2], chan_b, 10_000, &mut payment_id); },
850 0x3b => { send_payment(&nodes[2], &nodes[1], chan_b, 10_000, &mut payment_id); },
851 0x3c => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 10_000, &mut payment_id); },
852 0x3d => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 10_000, &mut payment_id); },
854 0x40 => { send_payment(&nodes[0], &nodes[1], chan_a, 1_000, &mut payment_id); },
855 0x41 => { send_payment(&nodes[1], &nodes[0], chan_a, 1_000, &mut payment_id); },
856 0x42 => { send_payment(&nodes[1], &nodes[2], chan_b, 1_000, &mut payment_id); },
857 0x43 => { send_payment(&nodes[2], &nodes[1], chan_b, 1_000, &mut payment_id); },
858 0x44 => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 1_000, &mut payment_id); },
859 0x45 => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 1_000, &mut payment_id); },
861 0x48 => { send_payment(&nodes[0], &nodes[1], chan_a, 100, &mut payment_id); },
862 0x49 => { send_payment(&nodes[1], &nodes[0], chan_a, 100, &mut payment_id); },
863 0x4a => { send_payment(&nodes[1], &nodes[2], chan_b, 100, &mut payment_id); },
864 0x4b => { send_payment(&nodes[2], &nodes[1], chan_b, 100, &mut payment_id); },
865 0x4c => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 100, &mut payment_id); },
866 0x4d => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 100, &mut payment_id); },
868 0x50 => { send_payment(&nodes[0], &nodes[1], chan_a, 10, &mut payment_id); },
869 0x51 => { send_payment(&nodes[1], &nodes[0], chan_a, 10, &mut payment_id); },
870 0x52 => { send_payment(&nodes[1], &nodes[2], chan_b, 10, &mut payment_id); },
871 0x53 => { send_payment(&nodes[2], &nodes[1], chan_b, 10, &mut payment_id); },
872 0x54 => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 10, &mut payment_id); },
873 0x55 => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 10, &mut payment_id); },
875 0x58 => { send_payment(&nodes[0], &nodes[1], chan_a, 1, &mut payment_id); },
876 0x59 => { send_payment(&nodes[1], &nodes[0], chan_a, 1, &mut payment_id); },
877 0x5a => { send_payment(&nodes[1], &nodes[2], chan_b, 1, &mut payment_id); },
878 0x5b => { send_payment(&nodes[2], &nodes[1], chan_b, 1, &mut payment_id); },
879 0x5c => { send_hop_payment(&nodes[0], &nodes[1], chan_a, &nodes[2], chan_b, 1, &mut payment_id); },
880 0x5d => { send_hop_payment(&nodes[2], &nodes[1], chan_b, &nodes[0], chan_a, 1, &mut payment_id); },
885 node_a_ser.0.clear();
886 nodes[0].write(&mut node_a_ser).unwrap();
887 monitor_a.should_update_manager.store(false, atomic::Ordering::Relaxed);
888 node_b_ser.0.clear();
889 nodes[1].write(&mut node_b_ser).unwrap();
890 monitor_b.should_update_manager.store(false, atomic::Ordering::Relaxed);
891 node_c_ser.0.clear();
892 nodes[2].write(&mut node_c_ser).unwrap();
893 monitor_c.should_update_manager.store(false, atomic::Ordering::Relaxed);
897 pub fn chanmon_consistency_test<Out: test_logger::Output>(data: &[u8], out: Out) {
902 pub extern "C" fn chanmon_consistency_run(data: *const u8, datalen: usize) {
903 do_test(unsafe { std::slice::from_raw_parts(data, datalen) }, test_logger::DevNull{});