Parse inbound TrampolineEntrypoint payload

Check inbound onion payloads for the presence of an inner onion, which
we will later also need to decrypt to handle Trampoline payments.

Author: arik-so

lightning/src/ln/msgs.rs

@@ -1811,6 +1811,17 @@ mod fuzzy_internal_msgs {
 		pub outgoing_cltv_value: u32,
 	}
 
+	#[allow(unused)]
+	pub struct InboundTrampolineEntrypointPayload {
+		pub amt_to_forward: u64,
+		pub outgoing_cltv_value: u32,
+		pub multipath_trampoline_data: Option<FinalOnionHopData>,
+		pub trampoline_packet: TrampolineOnionPacket,
+		/// The blinding point this hop needs to decrypt its Trampoline onion.
+		/// This is used for Trampoline hops that are not the blinded path intro hop.
+		pub current_path_key: Option<PublicKey>
+	}
+
 	pub struct InboundOnionReceivePayload {
 		pub payment_data: Option<FinalOnionHopData>,
 		pub payment_metadata: Option<Vec<u8>>,
@@ -1842,6 +1853,8 @@ mod fuzzy_internal_msgs {
 
 	pub enum InboundOnionPayload {
 		Forward(InboundOnionForwardPayload),
+		#[allow(unused)]
+		TrampolineEntrypoint(InboundTrampolineEntrypointPayload),
 		Receive(InboundOnionReceivePayload),
 		BlindedForward(InboundOnionBlindedForwardPayload),
 		BlindedReceive(InboundOnionBlindedReceivePayload),
@@ -2932,6 +2945,7 @@ impl<NS: Deref> ReadableArgs<(Option<PublicKey>, NS)> for InboundOnionPayload wh
 		let mut payment_metadata: Option<WithoutLength<Vec<u8>>> = None;
 		let mut total_msat = None;
 		let mut keysend_preimage: Option<PaymentPreimage> = None;
+		let mut trampoline_onion_packet: Option<TrampolineOnionPacket> = None;
 		let mut invoice_request: Option<InvoiceRequest> = None;
 		let mut custom_tlvs = Vec::new();
 
@@ -2946,6 +2960,7 @@ impl<NS: Deref> ReadableArgs<(Option<PublicKey>, NS)> for InboundOnionPayload wh
 			(12, intro_node_blinding_point, option),
 			(16, payment_metadata, option),
 			(18, total_msat, (option, encoding: (u64, HighZeroBytesDroppedBigSize))),
+			(20, trampoline_onion_packet, option),
 			(77_777, invoice_request, option),
 			// See https://github.com/lightning/blips/blob/master/blip-0003.md
 			(5482373484, keysend_preimage, option)
@@ -2962,7 +2977,18 @@ impl<NS: Deref> ReadableArgs<(Option<PublicKey>, NS)> for InboundOnionPayload wh
 			return Err(DecodeError::InvalidValue)
 		}
 
-		if let Some(blinding_point) = intro_node_blinding_point.or(update_add_blinding_point) {
+		if let Some(trampoline_onion_packet) = trampoline_onion_packet {
+			if payment_metadata.is_some() || encrypted_tlvs_opt.is_some() ||
+				total_msat.is_some()
+			{ return Err(DecodeError::InvalidValue) }
+			Ok(Self::TrampolineEntrypoint(InboundTrampolineEntrypointPayload {
+				amt_to_forward: amt.ok_or(DecodeError::InvalidValue)?,
+				outgoing_cltv_value: cltv_value.ok_or(DecodeError::InvalidValue)?,
+				multipath_trampoline_data: payment_data,
+				trampoline_packet: trampoline_onion_packet,
+				current_path_key: intro_node_blinding_point
+			}))
+		} else if let Some(blinding_point) = intro_node_blinding_point.or(update_add_blinding_point) {
 			if short_id.is_some() || payment_data.is_some() || payment_metadata.is_some() {
 				return Err(DecodeError::InvalidValue)
 			}