git.bitcoin.ninja Git - rust-lightning/blob - lightning/src/ln/blinded_payment_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 use bitcoin::secp256k1::{PublicKey, Secp256k1, SecretKey};
  11 use crate::blinded_path::BlindedPath;
  12 use crate::blinded_path::payment::{ForwardNode, ForwardTlvs, PaymentConstraints, PaymentRelay, ReceiveTlvs};
  13 use crate::events::{HTLCDestination, MessageSendEvent, MessageSendEventsProvider};
  14 use crate::ln::PaymentSecret;
  15 use crate::ln::channelmanager;
  16 use crate::ln::channelmanager::{PaymentId, RecipientOnionFields};
  17 use crate::ln::features::BlindedHopFeatures;
  18 use crate::ln::functional_test_utils::*;
  19 use crate::ln::msgs;
  20 use crate::ln::msgs::ChannelMessageHandler;
  21 use crate::ln::onion_utils;
  22 use crate::ln::onion_utils::INVALID_ONION_BLINDING;
  23 use crate::ln::outbound_payment::Retry;
  24 use crate::prelude::*;
  25 use crate::routing::router::{PaymentParameters, RouteParameters};
  26 use crate::util::config::UserConfig;
  27 use crate::util::test_utils;
  28
  29 pub fn get_blinded_route_parameters(
  30         amt_msat: u64, payment_secret: PaymentSecret, node_ids: Vec<PublicKey>,
  31         channel_upds: &[&msgs::UnsignedChannelUpdate], keys_manager: &test_utils::TestKeysInterface
  32 ) -> RouteParameters {
  33         let mut intermediate_nodes = Vec::new();
  34         for (node_id, chan_upd) in node_ids.iter().zip(channel_upds) {
  35                 intermediate_nodes.push(ForwardNode {
  36                         node_id: *node_id,
  37                         tlvs: ForwardTlvs {
  38                                 short_channel_id: chan_upd.short_channel_id,
  39                                 payment_relay: PaymentRelay {
  40                                         cltv_expiry_delta: chan_upd.cltv_expiry_delta,
  41                                         fee_proportional_millionths: chan_upd.fee_proportional_millionths,
  42                                         fee_base_msat: chan_upd.fee_base_msat,
  43                                 },
  44                                 payment_constraints: PaymentConstraints {
  45                                         max_cltv_expiry: u32::max_value(),
  46                                         htlc_minimum_msat: chan_upd.htlc_minimum_msat,
  47                                 },
  48                                 features: BlindedHopFeatures::empty(),
  49                         },
  50                         htlc_maximum_msat: chan_upd.htlc_maximum_msat,
  51                 });
  52         }
  53         let payee_tlvs = ReceiveTlvs {
  54                 payment_secret,
  55                 payment_constraints: PaymentConstraints {
  56                         max_cltv_expiry: u32::max_value(),
  57                         htlc_minimum_msat: channel_upds.last().unwrap().htlc_minimum_msat,
  58                 },
  59         };
  60         let mut secp_ctx = Secp256k1::new();
  61         let blinded_path = BlindedPath::new_for_payment(
  62                 &intermediate_nodes[..], *node_ids.last().unwrap(), payee_tlvs,
  63                 channel_upds.last().unwrap().htlc_maximum_msat, keys_manager, &secp_ctx
  64         ).unwrap();
  65
  66         RouteParameters::from_payment_params_and_value(
  67                 PaymentParameters::blinded(vec![blinded_path]), amt_msat
  68         )
  69 }
  70
  71 #[test]
  72 fn one_hop_blinded_path() {
  73         do_one_hop_blinded_path(true);
  74         do_one_hop_blinded_path(false);
  75 }
  76
  77 fn do_one_hop_blinded_path(success: bool) {
  78         let chanmon_cfgs = create_chanmon_cfgs(2);
  79         let node_cfgs = create_node_cfgs(2, &chanmon_cfgs);
  80         let node_chanmgrs = create_node_chanmgrs(2, &node_cfgs, &[None, None]);
  81         let nodes = create_network(2, &node_cfgs, &node_chanmgrs);
  82         let chan_upd = create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0).0.contents;
  83
  84         let amt_msat = 5000;
  85         let (payment_preimage, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[1], Some(amt_msat), None);
  86         let payee_tlvs = ReceiveTlvs {
  87                 payment_secret,
  88                 payment_constraints: PaymentConstraints {
  89                         max_cltv_expiry: u32::max_value(),
  90                         htlc_minimum_msat: chan_upd.htlc_minimum_msat,
  91                 },
  92         };
  93         let mut secp_ctx = Secp256k1::new();
  94         let blinded_path = BlindedPath::one_hop_for_payment(
  95                 nodes[1].node.get_our_node_id(), payee_tlvs, &chanmon_cfgs[1].keys_manager, &secp_ctx
  96         ).unwrap();
  97
  98         let route_params = RouteParameters::from_payment_params_and_value(
  99                 PaymentParameters::blinded(vec![blinded_path]),
 100                 amt_msat,
 101         );
 102         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(),
 103         PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 104         check_added_monitors(&nodes[0], 1);
 105         pass_along_route(&nodes[0], &[&[&nodes[1]]], amt_msat, payment_hash, payment_secret);
 106         if success {
 107                 claim_payment(&nodes[0], &[&nodes[1]], payment_preimage);
 108         } else {
 109                 fail_payment(&nodes[0], &[&nodes[1]], payment_hash);
 110         }
 111 }
 112
 113 #[test]
 114 fn mpp_to_one_hop_blinded_path() {
 115         let chanmon_cfgs = create_chanmon_cfgs(4);
 116         let node_cfgs = create_node_cfgs(4, &chanmon_cfgs);
 117         let node_chanmgrs = create_node_chanmgrs(4, &node_cfgs, &[None, None, None, None]);
 118         let nodes = create_network(4, &node_cfgs, &node_chanmgrs);
 119         let mut secp_ctx = Secp256k1::new();
 120
 121         create_announced_chan_between_nodes(&nodes, 0, 1);
 122         create_announced_chan_between_nodes(&nodes, 0, 2);
 123         let chan_upd_1_3 = create_announced_chan_between_nodes(&nodes, 1, 3).0.contents;
 124         create_announced_chan_between_nodes(&nodes, 2, 3).0.contents;
 125
 126         let amt_msat = 15_000_000;
 127         let (payment_preimage, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[3], Some(amt_msat), None);
 128         let payee_tlvs = ReceiveTlvs {
 129                 payment_secret,
 130                 payment_constraints: PaymentConstraints {
 131                         max_cltv_expiry: u32::max_value(),
 132                         htlc_minimum_msat: chan_upd_1_3.htlc_minimum_msat,
 133                 },
 134         };
 135         let blinded_path = BlindedPath::one_hop_for_payment(
 136                 nodes[3].node.get_our_node_id(), payee_tlvs, &chanmon_cfgs[3].keys_manager, &secp_ctx
 137         ).unwrap();
 138
 139         let bolt12_features =
 140                 channelmanager::provided_bolt12_invoice_features(&UserConfig::default());
 141         let route_params = RouteParameters::from_payment_params_and_value(
 142                 PaymentParameters::blinded(vec![blinded_path]).with_bolt12_features(bolt12_features).unwrap(),
 143                 amt_msat,
 144         );
 145         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(), PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 146         check_added_monitors(&nodes[0], 2);
 147
 148         let expected_route: &[&[&Node]] = &[&[&nodes[1], &nodes[3]], &[&nodes[2], &nodes[3]]];
 149         let mut events = nodes[0].node.get_and_clear_pending_msg_events();
 150         assert_eq!(events.len(), 2);
 151
 152         let ev = remove_first_msg_event_to_node(&nodes[1].node.get_our_node_id(), &mut events);
 153         pass_along_path(&nodes[0], expected_route[0], amt_msat, payment_hash.clone(),
 154                 Some(payment_secret), ev.clone(), false, None);
 155
 156         let ev = remove_first_msg_event_to_node(&nodes[2].node.get_our_node_id(), &mut events);
 157         pass_along_path(&nodes[0], expected_route[1], amt_msat, payment_hash.clone(),
 158                 Some(payment_secret), ev.clone(), true, None);
 159         claim_payment_along_route(&nodes[0], expected_route, false, payment_preimage);
 160 }
 161
 162 enum ForwardCheckFail {
 163         // Fail a check on the inbound onion payload. In this case, we underflow when calculating the
 164         // outgoing cltv_expiry.
 165         InboundOnionCheck,
 166         // The forwarding node's payload is encoded as a receive, i.e. the next hop HMAC is [0; 32].
 167         ForwardPayloadEncodedAsReceive,
 168         // Fail a check on the outbound channel. In this case, our next-hop peer is offline.
 169         OutboundChannelCheck,
 170 }
 171
 172 #[test]
 173 fn forward_checks_failure() {
 174         do_forward_checks_failure(ForwardCheckFail::InboundOnionCheck);
 175         do_forward_checks_failure(ForwardCheckFail::ForwardPayloadEncodedAsReceive);
 176         do_forward_checks_failure(ForwardCheckFail::OutboundChannelCheck);
 177 }
 178
 179 fn do_forward_checks_failure(check: ForwardCheckFail) {
 180         // Ensure we'll fail backwards properly if a forwarding check fails on initial update_add
 181         // receipt.
 182         let chanmon_cfgs = create_chanmon_cfgs(3);
 183         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
 184         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
 185         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
 186         // We need the session priv to construct a bogus onion packet later.
 187         *nodes[0].keys_manager.override_random_bytes.lock().unwrap() = Some([3; 32]);
 188         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0);
 189         let chan_upd_1_2 = create_announced_chan_between_nodes_with_value(&nodes, 1, 2, 1_000_000, 0).0.contents;
 190
 191         let amt_msat = 5000;
 192         let (_, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[2], Some(amt_msat), None);
 193         let route_params = get_blinded_route_parameters(amt_msat, payment_secret,
 194                 nodes.iter().skip(1).map(|n| n.node.get_our_node_id()).collect(), &[&chan_upd_1_2],
 195                 &chanmon_cfgs[2].keys_manager);
 196
 197         let route = get_route(&nodes[0], &route_params).unwrap();
 198         node_cfgs[0].router.expect_find_route(route_params.clone(), Ok(route.clone()));
 199         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(), PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 200         check_added_monitors(&nodes[0], 1);
 201
 202         let mut events = nodes[0].node.get_and_clear_pending_msg_events();
 203         assert_eq!(events.len(), 1);
 204         let ev = remove_first_msg_event_to_node(&nodes[1].node.get_our_node_id(), &mut events);
 205         let mut payment_event = SendEvent::from_event(ev);
 206
 207         let mut update_add = &mut payment_event.msgs[0];
 208         match check {
 209                 ForwardCheckFail::InboundOnionCheck => {
 210                         update_add.cltv_expiry = 10; // causes outbound CLTV expiry to underflow
 211                 },
 212                 ForwardCheckFail::ForwardPayloadEncodedAsReceive => {
 213                         let session_priv = SecretKey::from_slice(&[3; 32]).unwrap();
 214                         let onion_keys = onion_utils::construct_onion_keys(&Secp256k1::new(), &route.paths[0], &session_priv).unwrap();
 215                         let cur_height = nodes[0].best_block_info().1;
 216                         let (mut onion_payloads, ..) = onion_utils::build_onion_payloads(
 217                                 &route.paths[0], amt_msat, RecipientOnionFields::spontaneous_empty(), cur_height, &None).unwrap();
 218                         // Remove the receive payload so the blinded forward payload is encoded as a final payload
 219                         // (i.e. next_hop_hmac == [0; 32])
 220                         onion_payloads.pop();
 221                         update_add.onion_routing_packet = onion_utils::construct_onion_packet(onion_payloads, onion_keys, [0; 32], &payment_hash).unwrap();
 222                 },
 223                 ForwardCheckFail::OutboundChannelCheck => {
 224                         // The intro node will see that the next-hop peer is disconnected and fail the HTLC backwards.
 225                         nodes[1].node.peer_disconnected(&nodes[2].node.get_our_node_id());
 226                 },
 227         }
 228         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
 229         check_added_monitors!(nodes[1], 0);
 230         do_commitment_signed_dance(&nodes[1], &nodes[0], &payment_event.commitment_msg, true, true);
 231
 232         let mut updates = get_htlc_update_msgs!(nodes[1], nodes[0].node.get_our_node_id());
 233         nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &updates.update_fail_htlcs[0]);
 234         do_commitment_signed_dance(&nodes[0], &nodes[1], &updates.commitment_signed, false, false);
 235         expect_payment_failed_conditions(&nodes[0], payment_hash, false,
 236                 PaymentFailedConditions::new().expected_htlc_error_data(INVALID_ONION_BLINDING, &[0; 32]));
 237 }
 238
 239 #[test]
 240 fn failed_backwards_to_intro_node() {
 241         // Ensure the intro node will error backwards properly even if the downstream node did not blind
 242         // their error.
 243         let chanmon_cfgs = create_chanmon_cfgs(3);
 244         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
 245         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
 246         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
 247         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0);
 248         let chan_upd_1_2 = create_announced_chan_between_nodes_with_value(&nodes, 1, 2, 1_000_000, 0).0.contents;
 249
 250         let amt_msat = 5000;
 251         let (_, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[2], Some(amt_msat), None);
 252         let route_params = get_blinded_route_parameters(amt_msat, payment_secret,
 253                 nodes.iter().skip(1).map(|n| n.node.get_our_node_id()).collect(), &[&chan_upd_1_2],
 254                 &chanmon_cfgs[2].keys_manager);
 255
 256         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(), PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 257         check_added_monitors(&nodes[0], 1);
 258
 259         let mut events = nodes[0].node.get_and_clear_pending_msg_events();
 260         assert_eq!(events.len(), 1);
 261         let ev = remove_first_msg_event_to_node(&nodes[1].node.get_our_node_id(), &mut events);
 262         let mut payment_event = SendEvent::from_event(ev);
 263
 264         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
 265         check_added_monitors!(nodes[1], 0);
 266         do_commitment_signed_dance(&nodes[1], &nodes[0], &payment_event.commitment_msg, false, false);
 267         expect_pending_htlcs_forwardable!(nodes[1]);
 268         check_added_monitors!(&nodes[1], 1);
 269
 270         let mut events = nodes[1].node.get_and_clear_pending_msg_events();
 271         assert_eq!(events.len(), 1);
 272         let ev = remove_first_msg_event_to_node(&nodes[2].node.get_our_node_id(), &mut events);
 273         let mut payment_event = SendEvent::from_event(ev);
 274
 275         // Ensure the final node fails to handle the HTLC.
 276         payment_event.msgs[0].onion_routing_packet.hop_data[0] ^= 1;
 277         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), &payment_event.msgs[0]);
 278         check_added_monitors!(nodes[2], 0);
 279         do_commitment_signed_dance(&nodes[2], &nodes[1], &payment_event.commitment_msg, true, true);
 280         nodes[2].node.process_pending_htlc_forwards();
 281
 282         let mut updates = get_htlc_update_msgs!(nodes[2], nodes[1].node.get_our_node_id());
 283         let mut update_malformed = &mut updates.update_fail_malformed_htlcs[0];
 284         // Check that the final node encodes its failure correctly.
 285         assert_eq!(update_malformed.failure_code, INVALID_ONION_BLINDING);
 286         assert_eq!(update_malformed.sha256_of_onion, [0; 32]);
 287
 288         // Modify such the final hop does not correctly blind their error so we can ensure the intro node
 289         // converts it to the correct error.
 290         update_malformed.sha256_of_onion = [1; 32];
 291         nodes[1].node.handle_update_fail_malformed_htlc(&nodes[2].node.get_our_node_id(), update_malformed);
 292         do_commitment_signed_dance(&nodes[1], &nodes[2], &updates.commitment_signed, true, false);
 293
 294         let mut updates = get_htlc_update_msgs!(nodes[1], nodes[0].node.get_our_node_id());
 295         nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &updates.update_fail_htlcs[0]);
 296         do_commitment_signed_dance(&nodes[0], &nodes[1], &updates.commitment_signed, false, false);
 297         expect_payment_failed_conditions(&nodes[0], payment_hash, false,
 298                 PaymentFailedConditions::new().expected_htlc_error_data(INVALID_ONION_BLINDING, &[0; 32]));
 299 }
 300
 301 enum ProcessPendingHTLCsCheck {
 302         FwdPeerDisconnected,
 303         FwdChannelClosed,
 304 }
 305
 306 #[test]
 307 fn forward_fail_in_process_pending_htlc_fwds() {
 308         do_forward_fail_in_process_pending_htlc_fwds(ProcessPendingHTLCsCheck::FwdPeerDisconnected);
 309         do_forward_fail_in_process_pending_htlc_fwds(ProcessPendingHTLCsCheck::FwdChannelClosed);
 310 }
 311 fn do_forward_fail_in_process_pending_htlc_fwds(check: ProcessPendingHTLCsCheck) {
 312         // Ensure the intro node will error backwards properly if the HTLC fails in
 313         // process_pending_htlc_forwards.
 314         let chanmon_cfgs = create_chanmon_cfgs(3);
 315         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
 316         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
 317         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
 318         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0);
 319         let (chan_upd_1_2, channel_id) = {
 320                 let chan = create_announced_chan_between_nodes_with_value(&nodes, 1, 2, 1_000_000, 0);
 321                 (chan.0.contents, chan.2)
 322         };
 323
 324         let amt_msat = 5000;
 325         let (_, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[2], Some(amt_msat), None);
 326         let route_params = get_blinded_route_parameters(amt_msat, payment_secret,
 327                 nodes.iter().skip(1).map(|n| n.node.get_our_node_id()).collect(), &[&chan_upd_1_2],
 328                 &chanmon_cfgs[2].keys_manager);
 329
 330         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(), PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 331         check_added_monitors(&nodes[0], 1);
 332
 333         let mut events = nodes[0].node.get_and_clear_pending_msg_events();
 334         assert_eq!(events.len(), 1);
 335         let ev = remove_first_msg_event_to_node(&nodes[1].node.get_our_node_id(), &mut events);
 336         let mut payment_event = SendEvent::from_event(ev);
 337
 338         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
 339         check_added_monitors!(nodes[1], 0);
 340         do_commitment_signed_dance(&nodes[1], &nodes[0], &payment_event.commitment_msg, false, false);
 341
 342         match check {
 343                 ProcessPendingHTLCsCheck::FwdPeerDisconnected => {
 344                         // Disconnect the next-hop peer so when we go to forward in process_pending_htlc_forwards, the
 345                         // intro node will error backwards.
 346                         nodes[1].node.peer_disconnected(&nodes[2].node.get_our_node_id());
 347                         expect_pending_htlcs_forwardable!(nodes[1]);
 348                         expect_pending_htlcs_forwardable_and_htlc_handling_failed_ignore!(nodes[1],
 349                                 vec![HTLCDestination::NextHopChannel { node_id: Some(nodes[2].node.get_our_node_id()), channel_id }]);
 350                 },
 351                 ProcessPendingHTLCsCheck::FwdChannelClosed => {
 352                         // Force close the next-hop channel so when we go to forward in process_pending_htlc_forwards,
 353                         // the intro node will error backwards.
 354                         nodes[1].node.force_close_broadcasting_latest_txn(&channel_id, &nodes[2].node.get_our_node_id()).unwrap();
 355                         let events = nodes[1].node.get_and_clear_pending_events();
 356                         match events[0] {
 357                                 crate::events::Event::PendingHTLCsForwardable { .. } => {},
 358                                 _ => panic!("Unexpected event {:?}", events),
 359                         };
 360                         match events[1] {
 361                                 crate::events::Event::ChannelClosed { .. } => {},
 362                                 _ => panic!("Unexpected event {:?}", events),
 363                         }
 364
 365                         nodes[1].node.process_pending_htlc_forwards();
 366                         expect_pending_htlcs_forwardable_and_htlc_handling_failed_ignore!(nodes[1],
 367                                 vec![HTLCDestination::UnknownNextHop { requested_forward_scid: chan_upd_1_2.short_channel_id }]);
 368                         check_closed_broadcast(&nodes[1], 1, true);
 369                         check_added_monitors!(nodes[1], 1);
 370                         nodes[1].node.process_pending_htlc_forwards();
 371                 },
 372         }
 373
 374         let mut updates = get_htlc_update_msgs!(nodes[1], nodes[0].node.get_our_node_id());
 375         nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &updates.update_fail_htlcs[0]);
 376         check_added_monitors!(nodes[1], 1);
 377         do_commitment_signed_dance(&nodes[0], &nodes[1], &updates.commitment_signed, false, false);
 378
 379         expect_payment_failed_conditions(&nodes[0], payment_hash, false,
 380                 PaymentFailedConditions::new().expected_htlc_error_data(INVALID_ONION_BLINDING, &[0; 32]));
 381 }
 382
 383 #[test]
 384 fn blinded_intercept_payment() {
 385         let chanmon_cfgs = create_chanmon_cfgs(3);
 386         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
 387         let mut intercept_forwards_config = test_default_channel_config();
 388         intercept_forwards_config.accept_intercept_htlcs = true;
 389         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, Some(intercept_forwards_config), None]);
 390         let nodes = create_network(3, &node_cfgs, &node_chanmgrs);
 391         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0);
 392         let chan_upd = create_announced_chan_between_nodes_with_value(&nodes, 1, 2, 1_000_000, 0).0.contents;
 393
 394         let amt_msat = 5000;
 395         let (_, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[2], Some(amt_msat), None);
 396         let intercept_scid = nodes[1].node.get_intercept_scid();
 397         let mut intercept_chan_upd = chan_upd;
 398         intercept_chan_upd.short_channel_id = intercept_scid;
 399         let route_params = get_blinded_route_parameters(amt_msat, payment_secret,
 400                 nodes.iter().skip(1).map(|n| n.node.get_our_node_id()).collect(), &[&intercept_chan_upd],
 401                 &chanmon_cfgs[2].keys_manager);
 402
 403         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(),
 404         PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 405         check_added_monitors(&nodes[0], 1);
 406         let payment_event = {
 407                 let mut events = nodes[0].node.get_and_clear_pending_msg_events();
 408                 assert_eq!(events.len(), 1);
 409                 SendEvent::from_event(events.remove(0))
 410         };
 411         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event.msgs[0]);
 412         commitment_signed_dance!(nodes[1], nodes[0], &payment_event.commitment_msg, false, true);
 413
 414         let events = nodes[1].node.get_and_clear_pending_events();
 415         assert_eq!(events.len(), 1);
 416         let intercept_id = match events[0] {
 417                 crate::events::Event::HTLCIntercepted {
 418                         intercept_id, payment_hash: pmt_hash,
 419                         requested_next_hop_scid: short_channel_id, ..
 420                 } => {
 421                         assert_eq!(pmt_hash, payment_hash);
 422                         assert_eq!(short_channel_id, intercept_scid);
 423                         intercept_id
 424                 },
 425                 _ => panic!()
 426         };
 427
 428         nodes[1].node.fail_intercepted_htlc(intercept_id).unwrap();
 429         expect_pending_htlcs_forwardable_and_htlc_handling_failed_ignore!(nodes[1], vec![HTLCDestination::UnknownNextHop { requested_forward_scid: intercept_scid }]);
 430         nodes[1].node.process_pending_htlc_forwards();
 431         let update_fail = get_htlc_update_msgs!(nodes[1], nodes[0].node.get_our_node_id());
 432         check_added_monitors!(&nodes[1], 1);
 433         assert!(update_fail.update_fail_htlcs.len() == 1);
 434         let fail_msg = update_fail.update_fail_htlcs[0].clone();
 435         nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &fail_msg);
 436         commitment_signed_dance!(nodes[0], nodes[1], update_fail.commitment_signed, false);
 437         expect_payment_failed_conditions(&nodes[0], payment_hash, false,
 438                 PaymentFailedConditions::new().expected_htlc_error_data(INVALID_ONION_BLINDING, &[0; 32]));
 439 }
 440
 441 #[test]
 442 fn two_hop_blinded_path_success() {
 443         let chanmon_cfgs = create_chanmon_cfgs(3);
 444         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
 445         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
 446         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
 447         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0);
 448         let chan_upd_1_2 = create_announced_chan_between_nodes_with_value(&nodes, 1, 2, 1_000_000, 0).0.contents;
 449
 450         let amt_msat = 5000;
 451         let (payment_preimage, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[2], Some(amt_msat), None);
 452         let route_params = get_blinded_route_parameters(amt_msat, payment_secret,
 453                 nodes.iter().skip(1).map(|n| n.node.get_our_node_id()).collect(), &[&chan_upd_1_2],
 454                 &chanmon_cfgs[2].keys_manager);
 455
 456         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(), PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 457         check_added_monitors(&nodes[0], 1);
 458         pass_along_route(&nodes[0], &[&[&nodes[1], &nodes[2]]], amt_msat, payment_hash, payment_secret);
 459         claim_payment(&nodes[0], &[&nodes[1], &nodes[2]], payment_preimage);
 460 }
 461
 462 #[derive(PartialEq)]
 463 enum ReceiveCheckFail {
 464         // The recipient fails the payment upon `PaymentClaimable`.
 465         RecipientFail,
 466         // Failure to decode the recipient's onion payload.
 467         OnionDecodeFail,
 468         // The incoming HTLC did not satisfy our requirements; in this case it underpaid us according to
 469         // the expected receive amount in the onion.
 470         ReceiveRequirements,
 471         // The incoming HTLC errors when added to the Channel, in this case due to the HTLC being
 472         // delivered out-of-order with a shutdown message.
 473         ChannelCheck,
 474 }
 475
 476 #[test]
 477 fn multi_hop_receiver_fail() {
 478         do_multi_hop_receiver_fail(ReceiveCheckFail::RecipientFail);
 479         do_multi_hop_receiver_fail(ReceiveCheckFail::OnionDecodeFail);
 480         do_multi_hop_receiver_fail(ReceiveCheckFail::ReceiveRequirements);
 481         do_multi_hop_receiver_fail(ReceiveCheckFail::ChannelCheck);
 482 }
 483
 484 fn do_multi_hop_receiver_fail(check: ReceiveCheckFail) {
 485         // Test that the receiver to a multihop blinded path fails back correctly.
 486         let chanmon_cfgs = create_chanmon_cfgs(3);
 487         let node_cfgs = create_node_cfgs(3, &chanmon_cfgs);
 488         let node_chanmgrs = create_node_chanmgrs(3, &node_cfgs, &[None, None, None]);
 489         let mut nodes = create_network(3, &node_cfgs, &node_chanmgrs);
 490         // We need the session priv to construct an invalid onion packet later.
 491         let session_priv = [3; 32];
 492         *nodes[0].keys_manager.override_random_bytes.lock().unwrap() = Some(session_priv);
 493         create_announced_chan_between_nodes_with_value(&nodes, 0, 1, 1_000_000, 0);
 494         let (chan_upd_1_2, chan_id_1_2) = {
 495                 let (chan_upd, _, channel_id, ..) = create_announced_chan_between_nodes_with_value(
 496                         &nodes, 1, 2, 1_000_000, 0
 497                 );
 498                 (chan_upd.contents, channel_id)
 499         };
 500
 501         let amt_msat = 5000;
 502         let (_, payment_hash, payment_secret) = get_payment_preimage_hash(&nodes[2], Some(amt_msat), None);
 503         let route_params = get_blinded_route_parameters(amt_msat, payment_secret,
 504                 nodes.iter().skip(1).map(|n| n.node.get_our_node_id()).collect(), &[&chan_upd_1_2],
 505                 &chanmon_cfgs[2].keys_manager);
 506
 507         let route = find_route(&nodes[0], &route_params).unwrap();
 508         node_cfgs[0].router.expect_find_route(route_params.clone(), Ok(route.clone()));
 509         nodes[0].node.send_payment(payment_hash, RecipientOnionFields::spontaneous_empty(), PaymentId(payment_hash.0), route_params, Retry::Attempts(0)).unwrap();
 510         check_added_monitors(&nodes[0], 1);
 511
 512         let mut payment_event_0_1 = {
 513                 let mut events = nodes[0].node.get_and_clear_pending_msg_events();
 514                 assert_eq!(events.len(), 1);
 515                 let ev = remove_first_msg_event_to_node(&nodes[1].node.get_our_node_id(), &mut events);
 516                 SendEvent::from_event(ev)
 517         };
 518         nodes[1].node.handle_update_add_htlc(&nodes[0].node.get_our_node_id(), &payment_event_0_1.msgs[0]);
 519         check_added_monitors!(nodes[1], 0);
 520         do_commitment_signed_dance(&nodes[1], &nodes[0], &payment_event_0_1.commitment_msg, false, false);
 521         expect_pending_htlcs_forwardable!(nodes[1]);
 522         check_added_monitors!(&nodes[1], 1);
 523
 524         let mut payment_event_1_2 = {
 525                 let mut events = nodes[1].node.get_and_clear_pending_msg_events();
 526                 assert_eq!(events.len(), 1);
 527                 let ev = remove_first_msg_event_to_node(&nodes[2].node.get_our_node_id(), &mut events);
 528                 SendEvent::from_event(ev)
 529         };
 530
 531         match check {
 532                 ReceiveCheckFail::RecipientFail => {
 533                         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), &payment_event_1_2.msgs[0]);
 534                         check_added_monitors!(nodes[2], 0);
 535                         do_commitment_signed_dance(&nodes[2], &nodes[1], &payment_event_1_2.commitment_msg, true, true);
 536                         expect_pending_htlcs_forwardable!(nodes[2]);
 537                         check_payment_claimable(
 538                                 &nodes[2].node.get_and_clear_pending_events()[0], payment_hash, payment_secret, amt_msat,
 539                                 None, nodes[2].node.get_our_node_id()
 540                         );
 541                         nodes[2].node.fail_htlc_backwards(&payment_hash);
 542                         expect_pending_htlcs_forwardable_conditions(
 543                                 nodes[2].node.get_and_clear_pending_events(), &[HTLCDestination::FailedPayment { payment_hash }]
 544                         );
 545                         nodes[2].node.process_pending_htlc_forwards();
 546                         check_added_monitors!(nodes[2], 1);
 547                 },
 548                 ReceiveCheckFail::OnionDecodeFail => {
 549                         let session_priv = SecretKey::from_slice(&session_priv).unwrap();
 550                         let mut onion_keys = onion_utils::construct_onion_keys(&Secp256k1::new(), &route.paths[0], &session_priv).unwrap();
 551                         let cur_height = nodes[0].best_block_info().1;
 552                         let (mut onion_payloads, ..) = onion_utils::build_onion_payloads(
 553                                 &route.paths[0], amt_msat, RecipientOnionFields::spontaneous_empty(), cur_height, &None).unwrap();
 554
 555                         let update_add = &mut payment_event_1_2.msgs[0];
 556                         onion_payloads.last_mut().map(|p| {
 557                                 if let msgs::OutboundOnionPayload::BlindedReceive { ref mut intro_node_blinding_point, .. } = p {
 558                                         // The receiver should error if both the update_add blinding_point and the
 559                                         // intro_node_blinding_point are set.
 560                                         assert!(intro_node_blinding_point.is_none() && update_add.blinding_point.is_some());
 561                                         *intro_node_blinding_point = Some(PublicKey::from_slice(&[2; 33]).unwrap());
 562                                 } else { panic!() }
 563                         });
 564                         update_add.onion_routing_packet = onion_utils::construct_onion_packet(
 565                                 vec![onion_payloads.pop().unwrap()], vec![onion_keys.pop().unwrap()], [0; 32],
 566                                 &payment_hash
 567                         ).unwrap();
 568                         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), update_add);
 569                         check_added_monitors!(nodes[2], 0);
 570                         do_commitment_signed_dance(&nodes[2], &nodes[1], &payment_event_1_2.commitment_msg, true, true);
 571                 },
 572                 ReceiveCheckFail::ReceiveRequirements => {
 573                         let update_add = &mut payment_event_1_2.msgs[0];
 574                         update_add.amount_msat -= 1;
 575                         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), update_add);
 576                         check_added_monitors!(nodes[2], 0);
 577                         do_commitment_signed_dance(&nodes[2], &nodes[1], &payment_event_1_2.commitment_msg, true, true);
 578                 },
 579                 ReceiveCheckFail::ChannelCheck => {
 580                         nodes[2].node.close_channel(&chan_id_1_2, &nodes[1].node.get_our_node_id()).unwrap();
 581                         let node_2_shutdown = get_event_msg!(nodes[2], MessageSendEvent::SendShutdown, nodes[1].node.get_our_node_id());
 582                         nodes[1].node.handle_shutdown(&nodes[2].node.get_our_node_id(), &node_2_shutdown);
 583                         let node_1_shutdown = get_event_msg!(nodes[1], MessageSendEvent::SendShutdown, nodes[2].node.get_our_node_id());
 584
 585                         nodes[2].node.handle_update_add_htlc(&nodes[1].node.get_our_node_id(), &payment_event_1_2.msgs[0]);
 586                         nodes[2].node.handle_commitment_signed(&nodes[1].node.get_our_node_id(), &payment_event_1_2.commitment_msg);
 587                         check_added_monitors!(nodes[2], 1);
 588
 589                         nodes[2].node.handle_shutdown(&nodes[1].node.get_our_node_id(), &node_1_shutdown);
 590                         commitment_signed_dance!(nodes[2], nodes[1], (), false, true, false, false);
 591                 }
 592         }
 593
 594         let updates_2_1 = get_htlc_update_msgs!(nodes[2], nodes[1].node.get_our_node_id());
 595         assert_eq!(updates_2_1.update_fail_malformed_htlcs.len(), 1);
 596         let update_malformed = &updates_2_1.update_fail_malformed_htlcs[0];
 597         assert_eq!(update_malformed.sha256_of_onion, [0; 32]);
 598         assert_eq!(update_malformed.failure_code, INVALID_ONION_BLINDING);
 599         nodes[1].node.handle_update_fail_malformed_htlc(&nodes[2].node.get_our_node_id(), update_malformed);
 600         do_commitment_signed_dance(&nodes[1], &nodes[2], &updates_2_1.commitment_signed, true, false);
 601
 602         let updates_1_0 = if check == ReceiveCheckFail::ChannelCheck {
 603                 let events = nodes[1].node.get_and_clear_pending_msg_events();
 604                 assert_eq!(events.len(), 2);
 605                 events.into_iter().find_map(|ev| {
 606                         match ev {
 607                                 MessageSendEvent:: UpdateHTLCs { node_id, updates } => {
 608                                         assert_eq!(node_id, nodes[0].node.get_our_node_id());
 609                                         return Some(updates)
 610                                 },
 611                                 MessageSendEvent::SendClosingSigned { .. } => None,
 612                                 _ => panic!()
 613                         }
 614                 }).unwrap()
 615         } else { get_htlc_update_msgs!(nodes[1], nodes[0].node.get_our_node_id()) };
 616         assert_eq!(updates_1_0.update_fail_htlcs.len(), 1);
 617         nodes[0].node.handle_update_fail_htlc(&nodes[1].node.get_our_node_id(), &updates_1_0.update_fail_htlcs[0]);
 618         do_commitment_signed_dance(&nodes[0], &nodes[1], &updates_1_0.commitment_signed, false, false);
 619         expect_payment_failed_conditions(&nodes[0], payment_hash, false,
 620                 PaymentFailedConditions::new().expected_htlc_error_data(INVALID_ONION_BLINDING, &[0; 32]));
 621 }