Struct lightning::routing::router::PaymentParameters

pub struct PaymentParameters {
    pub payee: Payee,
    pub expiry_time: Option<u64>,
    pub max_total_cltv_expiry_delta: u32,
    pub max_path_count: u8,
    pub max_channel_saturation_power_of_half: u8,
    pub previously_failed_channels: Vec<u64>,
    pub previously_failed_blinded_path_idxs: Vec<u64>,
}

Information used to route a payment.

Fields

payee: Payee

Information about the payee, such as their features and route hints for their channels.

expiry_time: Option<u64>

Expiration of a payment to the payee, in seconds relative to the UNIX epoch.

max_total_cltv_expiry_delta: u32

The maximum total CLTV delta we accept for the route. Defaults to DEFAULT_MAX_TOTAL_CLTV_EXPIRY_DELTA.

max_path_count: u8

The maximum number of paths that may be used by (MPP) payments. Defaults to DEFAULT_MAX_PATH_COUNT.

max_channel_saturation_power_of_half: u8

Selects the maximum share of a channel’s total capacity which will be sent over a channel, as a power of 1/2. A higher value prefers to send the payment using more MPP parts whereas a lower value prefers to send larger MPP parts, potentially saturating channels and increasing failure probability for those paths.

Note that this restriction will be relaxed during pathfinding after paths which meet this restriction have been found. While paths which meet this criteria will be searched for, it is ultimately up to the scorer to select them over other paths.

A value of 0 will allow payments up to and including a channel’s total announced usable capacity, a value of one will only use up to half its capacity, two 1/4, etc.

Default value: 2

previously_failed_channels: Vec<u64>

A list of SCIDs which this payment was previously attempted over and which caused the payment to fail. Future attempts for the same payment shouldn’t be relayed through any of these SCIDs.

previously_failed_blinded_path_idxs: Vec<u64>

A list of indices corresponding to blinded paths in Payee::Blinded::route_hints which this payment was previously attempted over and which caused the payment to fail. Future attempts for the same payment shouldn’t be relayed through any of these blinded paths.

Implementations

impl PaymentParameters

pub fn from_node_id( payee_pubkey: PublicKey, final_cltv_expiry_delta: u32 ) -> Self

Creates a payee with the node id of the given pubkey.

The final_cltv_expiry_delta should match the expected final CLTV delta the recipient has provided.

pub fn for_keysend( payee_pubkey: PublicKey, final_cltv_expiry_delta: u32, allow_mpp: bool ) -> Self

Creates a payee with the node id of the given pubkey to use for keysend payments.

The final_cltv_expiry_delta should match the expected final CLTV delta the recipient has provided.

Note that MPP keysend is not widely supported yet. The allow_mpp lets you choose whether your router will be allowed to find a multi-part route for this payment. If you set allow_mpp to true, you should ensure a payment secret is set on send, likely via RecipientOnionFields::secret_only.

pub fn from_bolt12_invoice(invoice: &Bolt12Invoice) -> Self

Creates parameters for paying to a blinded payee from the provided invoice. Sets Payee::Blinded::route_hints, Payee::Blinded::features, and PaymentParameters::expiry_time.

pub fn blinded(blinded_route_hints: Vec<(BlindedPayInfo, BlindedPath)>) -> Self

Creates parameters for paying to a blinded payee from the provided blinded route hints.

pub fn with_bolt12_features( self, features: Bolt12InvoiceFeatures ) -> Result<Self, ()>

Includes the payee’s features. Errors if the parameters were not initialized with PaymentParameters::from_bolt12_invoice.

This is not exported to bindings users since bindings don’t support move semantics

pub fn with_bolt11_features( self, features: Bolt11InvoiceFeatures ) -> Result<Self, ()>

Includes the payee’s features. Errors if the parameters were initialized with PaymentParameters::from_bolt12_invoice.

This is not exported to bindings users since bindings don’t support move semantics

pub fn with_route_hints(self, route_hints: Vec<RouteHint>) -> Result<Self, ()>

Includes hints for routing to the payee. Errors if the parameters were initialized with PaymentParameters::from_bolt12_invoice.

This is not exported to bindings users since bindings don’t support move semantics

pub fn with_expiry_time(self, expiry_time: u64) -> Self

Includes a payment expiration in seconds relative to the UNIX epoch.

This is not exported to bindings users since bindings don’t support move semantics

pub fn with_max_total_cltv_expiry_delta( self, max_total_cltv_expiry_delta: u32 ) -> Self

Includes a limit for the total CLTV expiry delta which is considered during routing

This is not exported to bindings users since bindings don’t support move semantics

pub fn with_max_path_count(self, max_path_count: u8) -> Self

Includes a limit for the maximum number of payment paths that may be used.

This is not exported to bindings users since bindings don’t support move semantics

pub fn with_max_channel_saturation_power_of_half( self, max_channel_saturation_power_of_half: u8 ) -> Self

Includes a limit for the maximum share of a channel’s total capacity that can be sent over, as a power of 1/2. See PaymentParameters::max_channel_saturation_power_of_half.

This is not exported to bindings users since bindings don’t support move semantics

Trait Implementations

impl Clone for PaymentParameters

fn clone(&self) -> PaymentParameters

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PaymentParameters

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

Formats the value using the given formatter.

impl Hash for PaymentParameters

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PaymentParameters

fn eq(&self, other: &PaymentParameters) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ReadableArgs<u32> for PaymentParameters

fn read<R: Read>( reader: &mut R, default_final_cltv_expiry_delta: u32 ) -> Result<Self, DecodeError>

Reads a Self in from the given Read.

impl Writeable for PaymentParameters

fn write<W: Writer>(&self, writer: &mut W) -> Result<(), Error>

Writes self out to the given Writer.

fn encode(&self) -> Vec<u8>

Writes self out to a Vec<u8>.

fn serialized_length(&self) -> usize

Gets the length of this object after it has been serialized. This can be overridden to optimize cases where we prepend an object with its length.

impl Eq for PaymentParameters

impl StructuralPartialEq for PaymentParameters