Struct InterceptPaymentRequest 

pub struct InterceptPaymentRequest {
    pub payment_hash: Hash,
    pub amount_msat: u64,
    pub incoming_amount_msat: u64,
    pub expiry: u32,
    pub incoming_chan_id: u64,
    pub short_channel_id: Option<u64>,
    pub htlc_id: u64,
}

Fields

payment_hash: Hash

amount_msat: u64

The amount the HTLC claims to deliver. On the LND forward-intercept path this is the sender-written onion amt_to_forward, so it must never be trusted for funding decisions. On the HOLD-invoice and LDK paths it is the real received amount.

incoming_amount_msat: u64

The amount actually locked in the incoming HTLC – the real value the gateway receives on settlement. Funding and fee checks must use this.

expiry: u32

Block height at which the HTLC can no longer be claimed; 0 if unknown. On the LND forward-intercept path this is the HTLC’s raw incoming expiry instead, which the sender chooses and which LND fails back DefaultFinalCltvRejectDelta blocks before (19 since LND v0.21, 13 before).

incoming_chan_id: u64

short_channel_id: Option<u64>

htlc_id: u64

Implementations

impl InterceptPaymentRequest

pub fn incoming_circuit(&self) -> Option<(u64, u64)>

The incoming circuit of an intercepted forward, or None when the payment is held by a HOLD invoice or LDK (see NO_INCOMING_CIRCUIT).

pub fn lnv2_blocks_to_claim_deadline( &self, current_block_height: Option<u32>, ) -> u32

Blocks left before the gateway can no longer settle this payment, for deciding whether a fresh LNv2 incoming contract may be funded from it.

Honest LNv2 payments arrive through an LND HOLD invoice or an LDK claimable payment, never as an intercepted forward. A forward’s expiry is chosen by the sender and does not account for LND failing it back early, so it counts as having no time left. Without the current height the deadline cannot be checked, which counts the same.

Trait Implementations

impl Clone for InterceptPaymentRequest

fn clone(&self) -> InterceptPaymentRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InterceptPaymentRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InterceptPaymentRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InterceptPaymentRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.