Skip to content

Commit fc1c75c

Browse files
TheBlueMattTheBlueMatt
committed
Move test_dup_htlc_onchain_fails_on_reload to payment_tests
test_dup_htlc_onchain_fails_on_reload is now more of a payment_test than a functional_test, testing for handling of pending payments.
1 parent d2d150d commit fc1c75c

File tree

2 files changed

+172
-170
lines changed

2 files changed

+172
-170
lines changed

‎lightning/src/ln/functional_tests.rs

Lines changed: 1 addition & 166 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
//! claim outputs on-chain.
1313
1414
use chain;
15-
use chain::{Confirm, Listen, Watch, ChannelMonitorUpdateErr};
15+
use chain::{Confirm, Listen, Watch};
1616
use chain::channelmonitor;
1717
use chain::channelmonitor::{ChannelMonitor, CLTV_CLAIM_BUFFER, LATENCY_GRACE_PERIOD_BLOCKS, ANTI_REORG_DELAY};
1818
use chain::transaction::OutPoint;
@@ -4100,171 +4100,6 @@ fn test_no_txn_manager_serialize_deserialize() {
41004100
send_payment(&nodes[0], &[&nodes[1]], 1000000);
41014101
}
41024102

4103-
fn do_test_dup_htlc_onchain_fails_on_reload(persist_manager_post_event: bool, confirm_commitment_tx: bool, payment_timeout: bool) {
4104-
// When a Channel is closed, any outbound HTLCs which were relayed through it are simply
4105-
// dropped when the Channel is. From there, the ChannelManager relies on the ChannelMonitor
4106-
// having a copy of the relevant fail-/claim-back data and processes the HTLC fail/claim when
4107-
// the ChannelMonitor tells it to.
4108-
//
4109-
// If, due to an on-chain event, an HTLC is failed/claimed, we should avoid providing the
4110-
// ChannelManager the HTLC event until after the monitor is re-persisted. This should prevent a
4111-
// duplicate HTLC fail/claim (e.g. via a PaymentPathFailed event).
4112-
let chanmon_cfgs = create_chanmon_cfgs(2);
4113-
let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
4114-
let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
4115-
let persister: test_utils::TestPersister;
4116-
let new_chain_monitor: test_utils::TestChainMonitor;
4117-
let nodes_0_deserialized: ChannelManager<EnforcingSigner, &test_utils::TestChainMonitor, &test_utils::TestBroadcaster, &test_utils::TestKeysInterface, &test_utils::TestFeeEstimator, &test_utils::TestLogger>;
4118-
let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
4119-
4120-
let (_, _, chan_id, funding_tx) = create_announced_chan_between_nodes(&nodes, 0, 1, InitFeatures::known(), InitFeatures::known());
4121-
4122-
// Route a payment, but force-close the channel before the HTLC fulfill message arrives at
4123-
// nodes[0].
4124-
let (payment_preimage, payment_hash, _) = route_payment(&nodes[0], &[&nodes[1]], 10000000);
4125-
nodes[0].node.force_close_channel(&nodes[0].node.list_channels()[0].channel_id).unwrap();
4126-
check_closed_broadcast!(nodes[0], true);
4127-
check_added_monitors!(nodes[0], 1);
4128-
check_closed_event!(nodes[0], 1, ClosureReason::HolderForceClosed);
4129-
4130-
nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id(), false);
4131-
nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id(), false);
4132-
4133-
// Connect blocks until the CLTV timeout is up so that we get an HTLC-Timeout transaction
4134-
connect_blocks(&nodes[0], TEST_FINAL_CLTV + LATENCY_GRACE_PERIOD_BLOCKS + 1);
4135-
let node_txn = nodes[0].tx_broadcaster.txn_broadcasted.lock().unwrap().split_off(0);
4136-
assert_eq!(node_txn.len(), 3);
4137-
assert_eq!(node_txn[0], node_txn[1]);
4138-
check_spends!(node_txn[1], funding_tx);
4139-
check_spends!(node_txn[2], node_txn[1]);
4140-
let timeout_txn = vec![node_txn[2].clone()];
4141-
4142-
assert!(nodes[1].node.claim_funds(payment_preimage));
4143-
check_added_monitors!(nodes[1], 1);
4144-
4145-
let mut header = BlockHeader { version: 0x20000000, prev_blockhash: nodes[1].best_block_hash(), merkle_root: Default::default(), time: 42, bits: 42, nonce: 42 };
4146-
connect_block(&nodes[1], &Block { header, txdata: vec![node_txn[1].clone()]});
4147-
check_closed_broadcast!(nodes[1], true);
4148-
check_added_monitors!(nodes[1], 1);
4149-
check_closed_event!(nodes[1], 1, ClosureReason::CommitmentTxConfirmed);
4150-
let claim_txn = nodes[1].tx_broadcaster.txn_broadcasted.lock().unwrap().split_off(0);
4151-
4152-
header.prev_blockhash = nodes[0].best_block_hash();
4153-
connect_block(&nodes[0], &Block { header, txdata: vec![node_txn[1].clone()]});
4154-
4155-
if confirm_commitment_tx {
4156-
connect_blocks(&nodes[0], BREAKDOWN_TIMEOUT as u32 - 1);
4157-
}
4158-
4159-
header.prev_blockhash = nodes[0].best_block_hash();
4160-
let claim_block = Block { header, txdata: if payment_timeout { timeout_txn } else { claim_txn } };
4161-
4162-
if payment_timeout {
4163-
assert!(confirm_commitment_tx); // Otherwise we're spending below our CSV!
4164-
connect_block(&nodes[0], &claim_block);
4165-
connect_blocks(&nodes[0], ANTI_REORG_DELAY - 2);
4166-
}
4167-
4168-
// Now connect the HTLC claim transaction with the ChainMonitor-generated ChannelMonitor update
4169-
// returning TemporaryFailure. This should cause the claim event to never make its way to the
4170-
// ChannelManager.
4171-
chanmon_cfgs[0].persister.chain_sync_monitor_persistences.lock().unwrap().clear();
4172-
chanmon_cfgs[0].persister.set_update_ret(Err(ChannelMonitorUpdateErr::TemporaryFailure));
4173-
4174-
if payment_timeout {
4175-
connect_blocks(&nodes[0], 1);
4176-
} else {
4177-
connect_block(&nodes[0], &claim_block);
4178-
}
4179-
4180-
let funding_txo = OutPoint { txid: funding_tx.txid(), index: 0 };
4181-
let mon_updates: Vec<_> = chanmon_cfgs[0].persister.chain_sync_monitor_persistences.lock().unwrap()
4182-
.get_mut(&funding_txo).unwrap().drain().collect();
4183-
assert_eq!(mon_updates.len(), 1);
4184-
assert!(nodes[0].chain_monitor.release_pending_monitor_events().is_empty());
4185-
assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
4186-
4187-
// If we persist the ChannelManager here, we should get the PaymentSent event after
4188-
// deserialization.
4189-
let mut chan_manager_serialized = test_utils::TestVecWriter(Vec::new());
4190-
if !persist_manager_post_event {
4191-
nodes[0].node.write(&mut chan_manager_serialized).unwrap();
4192-
}
4193-
4194-
// Now persist the ChannelMonitor and inform the ChainMonitor that we're done, generating the
4195-
// payment sent event.
4196-
chanmon_cfgs[0].persister.set_update_ret(Ok(()));
4197-
let mut chan_0_monitor_serialized = test_utils::TestVecWriter(Vec::new());
4198-
get_monitor!(nodes[0], chan_id).write(&mut chan_0_monitor_serialized).unwrap();
4199-
nodes[0].chain_monitor.chain_monitor.channel_monitor_updated(funding_txo, mon_updates[0]).unwrap();
4200-
if payment_timeout {
4201-
expect_payment_failed!(nodes[0], payment_hash, true);
4202-
} else {
4203-
expect_payment_sent!(nodes[0], payment_preimage);
4204-
}
4205-
4206-
// If we persist the ChannelManager after we get the PaymentSent event, we shouldn't get it
4207-
// twice.
4208-
if persist_manager_post_event {
4209-
nodes[0].node.write(&mut chan_manager_serialized).unwrap();
4210-
}
4211-
4212-
// Now reload nodes[0]...
4213-
persister = test_utils::TestPersister::new();
4214-
let keys_manager = &chanmon_cfgs[0].keys_manager;
4215-
new_chain_monitor = test_utils::TestChainMonitor::new(Some(nodes[0].chain_source), nodes[0].tx_broadcaster.clone(), nodes[0].logger, node_cfgs[0].fee_estimator, &persister, keys_manager);
4216-
nodes[0].chain_monitor = &new_chain_monitor;
4217-
let mut chan_0_monitor_read = &chan_0_monitor_serialized.0[..];
4218-
let (_, mut chan_0_monitor) = <(BlockHash, ChannelMonitor<EnforcingSigner>)>::read(
4219-
&mut chan_0_monitor_read, keys_manager).unwrap();
4220-
assert!(chan_0_monitor_read.is_empty());
4221-
4222-
let (_, nodes_0_deserialized_tmp) = {
4223-
let mut channel_monitors = HashMap::new();
4224-
channel_monitors.insert(chan_0_monitor.get_funding_txo().0, &mut chan_0_monitor);
4225-
<(BlockHash, ChannelManager<EnforcingSigner, &test_utils::TestChainMonitor, &test_utils::TestBroadcaster, &test_utils::TestKeysInterface, &test_utils::TestFeeEstimator, &test_utils::TestLogger>)>
4226-
::read(&mut io::Cursor::new(&chan_manager_serialized.0[..]), ChannelManagerReadArgs {
4227-
default_config: Default::default(),
4228-
keys_manager,
4229-
fee_estimator: node_cfgs[0].fee_estimator,
4230-
chain_monitor: nodes[0].chain_monitor,
4231-
tx_broadcaster: nodes[0].tx_broadcaster.clone(),
4232-
logger: nodes[0].logger,
4233-
channel_monitors,
4234-
}).unwrap()
4235-
};
4236-
nodes_0_deserialized = nodes_0_deserialized_tmp;
4237-
4238-
assert!(nodes[0].chain_monitor.watch_channel(chan_0_monitor.get_funding_txo().0, chan_0_monitor).is_ok());
4239-
check_added_monitors!(nodes[0], 1);
4240-
nodes[0].node = &nodes_0_deserialized;
4241-
4242-
if persist_manager_post_event {
4243-
assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
4244-
} else if payment_timeout {
4245-
expect_payment_failed!(nodes[0], payment_hash, true);
4246-
} else {
4247-
expect_payment_sent!(nodes[0], payment_preimage);
4248-
}
4249-
4250-
// Note that if we re-connect the block which exposed nodes[0] to the payment preimage (but
4251-
// which the current ChannelMonitor has not seen), the ChannelManager's de-duplication of
4252-
// payment events should kick in, leaving us with no pending events here.
4253-
let height = nodes[0].blocks.lock().unwrap().len() as u32 - 1;
4254-
nodes[0].chain_monitor.chain_monitor.block_connected(&claim_block, height);
4255-
assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
4256-
}
4257-
4258-
#[test]
4259-
fn test_dup_htlc_onchain_fails_on_reload() {
4260-
do_test_dup_htlc_onchain_fails_on_reload(true, true, true);
4261-
do_test_dup_htlc_onchain_fails_on_reload(true, true, false);
4262-
do_test_dup_htlc_onchain_fails_on_reload(true, false, false);
4263-
do_test_dup_htlc_onchain_fails_on_reload(false, true, true);
4264-
do_test_dup_htlc_onchain_fails_on_reload(false, true, false);
4265-
do_test_dup_htlc_onchain_fails_on_reload(false, false, false);
4266-
}
4267-
42684103
#[test]
42694104
fn test_manager_serialize_deserialize_events() {
42704105
// This test makes sure the events field in ChannelManager survives de/serialization

‎lightning/src/ln/payment_tests.rs

Lines changed: 171 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,11 @@
1111
//! serialization ordering between ChannelManager/ChannelMonitors and ensuring we can still retry
1212
//! payments thereafter.
1313
14-
use chain::{Confirm, Watch};
15-
use chain::channelmonitor::ChannelMonitor;
14+
use chain::{ChannelMonitorUpdateErr, Confirm, Listen, Watch};
15+
use chain::channelmonitor::{ANTI_REORG_DELAY, ChannelMonitor, LATENCY_GRACE_PERIOD_BLOCKS};
16+
use chain::transaction::OutPoint;
1617
use ln::{PaymentPreimage, PaymentHash};
17-
use ln::channelmanager::{ChannelManager, ChannelManagerReadArgs, PaymentId, PaymentSendFailure};
18+
use ln::channelmanager::{BREAKDOWN_TIMEOUT, ChannelManager, ChannelManagerReadArgs, PaymentId, PaymentSendFailure};
1819
use ln::features::InitFeatures;
1920
use ln::msgs;
2021
use ln::msgs::{ChannelMessageHandler, ErrorAction};
@@ -23,10 +24,11 @@ use util::test_utils;
2324
use util::errors::APIError;
2425
use util::enforcing_trait_impls::EnforcingSigner;
2526
use util::ser::{ReadableArgs, Writeable};
27+
use io;
2628

2729
use bitcoin::hashes::sha256::Hash as Sha256;
2830
use bitcoin::hashes::Hash;
29-
use bitcoin::BlockHash;
31+
use bitcoin::{Block, BlockHeader, BlockHash};
3032

3133
use prelude::*;
3234

@@ -458,3 +460,168 @@ fn retry_with_no_persist() {
458460
do_retry_with_no_persist(true);
459461
do_retry_with_no_persist(false);
460462
}
463+
464+
fn do_test_dup_htlc_onchain_fails_on_reload(persist_manager_post_event: bool, confirm_commitment_tx: bool, payment_timeout: bool) {
465+
// When a Channel is closed, any outbound HTLCs which were relayed through it are simply
466+
// dropped when the Channel is. From there, the ChannelManager relies on the ChannelMonitor
467+
// having a copy of the relevant fail-/claim-back data and processes the HTLC fail/claim when
468+
// the ChannelMonitor tells it to.
469+
//
470+
// If, due to an on-chain event, an HTLC is failed/claimed, we should avoid providing the
471+
// ChannelManager the HTLC event until after the monitor is re-persisted. This should prevent a
472+
// duplicate HTLC fail/claim (e.g. via a PaymentPathFailed event).
473+
let chanmon_cfgs = create_chanmon_cfgs(2);
474+
let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
475+
let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
476+
let persister: test_utils::TestPersister;
477+
let new_chain_monitor: test_utils::TestChainMonitor;
478+
let nodes_0_deserialized: ChannelManager<EnforcingSigner, &test_utils::TestChainMonitor, &test_utils::TestBroadcaster, &test_utils::TestKeysInterface, &test_utils::TestFeeEstimator, &test_utils::TestLogger>;
479+
let mut nodes = create_network(2, &node_cfgs, &node_chanmgrs);
480+
481+
let (_, _, chan_id, funding_tx) = create_announced_chan_between_nodes(&nodes, 0, 1, InitFeatures::known(), InitFeatures::known());
482+
483+
// Route a payment, but force-close the channel before the HTLC fulfill message arrives at
484+
// nodes[0].
485+
let (payment_preimage, payment_hash, _) = route_payment(&nodes[0], &[&nodes[1]], 10000000);
486+
nodes[0].node.force_close_channel(&nodes[0].node.list_channels()[0].channel_id).unwrap();
487+
check_closed_broadcast!(nodes[0], true);
488+
check_added_monitors!(nodes[0], 1);
489+
check_closed_event!(nodes[0], 1, ClosureReason::HolderForceClosed);
490+
491+
nodes[0].node.peer_disconnected(&nodes[1].node.get_our_node_id(), false);
492+
nodes[1].node.peer_disconnected(&nodes[0].node.get_our_node_id(), false);
493+
494+
// Connect blocks until the CLTV timeout is up so that we get an HTLC-Timeout transaction
495+
connect_blocks(&nodes[0], TEST_FINAL_CLTV + LATENCY_GRACE_PERIOD_BLOCKS + 1);
496+
let node_txn = nodes[0].tx_broadcaster.txn_broadcasted.lock().unwrap().split_off(0);
497+
assert_eq!(node_txn.len(), 3);
498+
assert_eq!(node_txn[0], node_txn[1]);
499+
check_spends!(node_txn[1], funding_tx);
500+
check_spends!(node_txn[2], node_txn[1]);
501+
let timeout_txn = vec![node_txn[2].clone()];
502+
503+
assert!(nodes[1].node.claim_funds(payment_preimage));
504+
check_added_monitors!(nodes[1], 1);
505+
506+
let mut header = BlockHeader { version: 0x20000000, prev_blockhash: nodes[1].best_block_hash(), merkle_root: Default::default(), time: 42, bits: 42, nonce: 42 };
507+
connect_block(&nodes[1], &Block { header, txdata: vec![node_txn[1].clone()]});
508+
check_closed_broadcast!(nodes[1], true);
509+
check_added_monitors!(nodes[1], 1);
510+
check_closed_event!(nodes[1], 1, ClosureReason::CommitmentTxConfirmed);
511+
let claim_txn = nodes[1].tx_broadcaster.txn_broadcasted.lock().unwrap().split_off(0);
512+
513+
header.prev_blockhash = nodes[0].best_block_hash();
514+
connect_block(&nodes[0], &Block { header, txdata: vec![node_txn[1].clone()]});
515+
516+
if confirm_commitment_tx {
517+
connect_blocks(&nodes[0], BREAKDOWN_TIMEOUT as u32 - 1);
518+
}
519+
520+
header.prev_blockhash = nodes[0].best_block_hash();
521+
let claim_block = Block { header, txdata: if payment_timeout { timeout_txn } else { claim_txn } };
522+
523+
if payment_timeout {
524+
assert!(confirm_commitment_tx); // Otherwise we're spending below our CSV!
525+
connect_block(&nodes[0], &claim_block);
526+
connect_blocks(&nodes[0], ANTI_REORG_DELAY - 2);
527+
}
528+
529+
// Now connect the HTLC claim transaction with the ChainMonitor-generated ChannelMonitor update
530+
// returning TemporaryFailure. This should cause the claim event to never make its way to the
531+
// ChannelManager.
532+
chanmon_cfgs[0].persister.chain_sync_monitor_persistences.lock().unwrap().clear();
533+
chanmon_cfgs[0].persister.set_update_ret(Err(ChannelMonitorUpdateErr::TemporaryFailure));
534+
535+
if payment_timeout {
536+
connect_blocks(&nodes[0], 1);
537+
} else {
538+
connect_block(&nodes[0], &claim_block);
539+
}
540+
541+
let funding_txo = OutPoint { txid: funding_tx.txid(), index: 0 };
542+
let mon_updates: Vec<_> = chanmon_cfgs[0].persister.chain_sync_monitor_persistences.lock().unwrap()
543+
.get_mut(&funding_txo).unwrap().drain().collect();
544+
assert_eq!(mon_updates.len(), 1);
545+
assert!(nodes[0].chain_monitor.release_pending_monitor_events().is_empty());
546+
assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
547+
548+
// If we persist the ChannelManager here, we should get the PaymentSent event after
549+
// deserialization.
550+
let mut chan_manager_serialized = test_utils::TestVecWriter(Vec::new());
551+
if !persist_manager_post_event {
552+
nodes[0].node.write(&mut chan_manager_serialized).unwrap();
553+
}
554+
555+
// Now persist the ChannelMonitor and inform the ChainMonitor that we're done, generating the
556+
// payment sent event.
557+
chanmon_cfgs[0].persister.set_update_ret(Ok(()));
558+
let mut chan_0_monitor_serialized = test_utils::TestVecWriter(Vec::new());
559+
get_monitor!(nodes[0], chan_id).write(&mut chan_0_monitor_serialized).unwrap();
560+
nodes[0].chain_monitor.chain_monitor.channel_monitor_updated(funding_txo, mon_updates[0]).unwrap();
561+
if payment_timeout {
562+
expect_payment_failed!(nodes[0], payment_hash, true);
563+
} else {
564+
expect_payment_sent!(nodes[0], payment_preimage);
565+
}
566+
567+
// If we persist the ChannelManager after we get the PaymentSent event, we shouldn't get it
568+
// twice.
569+
if persist_manager_post_event {
570+
nodes[0].node.write(&mut chan_manager_serialized).unwrap();
571+
}
572+
573+
// Now reload nodes[0]...
574+
persister = test_utils::TestPersister::new();
575+
let keys_manager = &chanmon_cfgs[0].keys_manager;
576+
new_chain_monitor = test_utils::TestChainMonitor::new(Some(nodes[0].chain_source), nodes[0].tx_broadcaster.clone(), nodes[0].logger, node_cfgs[0].fee_estimator, &persister, keys_manager);
577+
nodes[0].chain_monitor = &new_chain_monitor;
578+
let mut chan_0_monitor_read = &chan_0_monitor_serialized.0[..];
579+
let (_, mut chan_0_monitor) = <(BlockHash, ChannelMonitor<EnforcingSigner>)>::read(
580+
&mut chan_0_monitor_read, keys_manager).unwrap();
581+
assert!(chan_0_monitor_read.is_empty());
582+
583+
let (_, nodes_0_deserialized_tmp) = {
584+
let mut channel_monitors = HashMap::new();
585+
channel_monitors.insert(chan_0_monitor.get_funding_txo().0, &mut chan_0_monitor);
586+
<(BlockHash, ChannelManager<EnforcingSigner, &test_utils::TestChainMonitor, &test_utils::TestBroadcaster, &test_utils::TestKeysInterface, &test_utils::TestFeeEstimator, &test_utils::TestLogger>)>
587+
::read(&mut io::Cursor::new(&chan_manager_serialized.0[..]), ChannelManagerReadArgs {
588+
default_config: Default::default(),
589+
keys_manager,
590+
fee_estimator: node_cfgs[0].fee_estimator,
591+
chain_monitor: nodes[0].chain_monitor,
592+
tx_broadcaster: nodes[0].tx_broadcaster.clone(),
593+
logger: nodes[0].logger,
594+
channel_monitors,
595+
}).unwrap()
596+
};
597+
nodes_0_deserialized = nodes_0_deserialized_tmp;
598+
599+
assert!(nodes[0].chain_monitor.watch_channel(chan_0_monitor.get_funding_txo().0, chan_0_monitor).is_ok());
600+
check_added_monitors!(nodes[0], 1);
601+
nodes[0].node = &nodes_0_deserialized;
602+
603+
if persist_manager_post_event {
604+
assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
605+
} else if payment_timeout {
606+
expect_payment_failed!(nodes[0], payment_hash, true);
607+
} else {
608+
expect_payment_sent!(nodes[0], payment_preimage);
609+
}
610+
611+
// Note that if we re-connect the block which exposed nodes[0] to the payment preimage (but
612+
// which the current ChannelMonitor has not seen), the ChannelManager's de-duplication of
613+
// payment events should kick in, leaving us with no pending events here.
614+
let height = nodes[0].blocks.lock().unwrap().len() as u32 - 1;
615+
nodes[0].chain_monitor.chain_monitor.block_connected(&claim_block, height);
616+
assert!(nodes[0].node.get_and_clear_pending_events().is_empty());
617+
}
618+
619+
#[test]
620+
fn test_dup_htlc_onchain_fails_on_reload() {
621+
do_test_dup_htlc_onchain_fails_on_reload(true, true, true);
622+
do_test_dup_htlc_onchain_fails_on_reload(true, true, false);
623+
do_test_dup_htlc_onchain_fails_on_reload(true, false, false);
624+
do_test_dup_htlc_onchain_fails_on_reload(false, true, true);
625+
do_test_dup_htlc_onchain_fails_on_reload(false, true, false);
626+
do_test_dup_htlc_onchain_fails_on_reload(false, false, false);
627+
}

0 commit comments

Comments
 (0)