Struct lightning::routing::router::PaymentParameters

pub struct PaymentParameters {
    pub payee_pubkey: PublicKey,
    pub features: Option<InvoiceFeatures>,
    pub route_hints: Vec<RouteHint>,
    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>,
}

The recipient of a payment.

Fields

payee_pubkey: PublicKey

The node id of the payee.

features: Option<InvoiceFeatures>

Features supported by the payee.

May be set from the payee’s invoice or via for_keysend. May be None if the invoice does not contain any features.

route_hints: Vec<RouteHint>

Hints for routing to the payee, containing channels connecting the payee to public nodes.

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.

Implementations

impl PaymentParameters

pub fn from_node_id(payee_pubkey: PublicKey) -> Self

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

pub fn for_keysend(payee_pubkey: PublicKey) -> Self

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

pub fn with_features(self, features: InvoiceFeatures) -> Self

Includes the payee’s features.

(C-not exported) since bindings don’t support move semantics

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

Includes hints for routing to the payee.

(C-not exported) 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.

(C-not exported) 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

(C-not exported) 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.

(C-not exported) 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 number of payment paths that may be used.

(C-not exported) 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, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<PaymentParameters> 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: &PaymentParameters) -> bool

This method tests for !=.

impl Readable for PaymentParameters

fn read<R: Read>(reader: &mut R) -> 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 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.

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

Writes self out to a Vec

impl Eq for PaymentParameters

impl StructuralEq for PaymentParameters

impl StructuralPartialEq for PaymentParameters