_ Git - ldk-java/blob - c_sharp/src/org/ldk/structs/PaymentParameters.cs

   1 using org.ldk.impl;
   2 using org.ldk.enums;
   3 using org.ldk.util;
   4 using System;
   5
   6 namespace org { namespace ldk { namespace structs {
   7
   8
   9 /**
  10  * Information used to route a payment.
  11  */
  12 public class PaymentParameters : CommonBase {
  13         internal PaymentParameters(object _dummy, long ptr) : base(ptr) { }
  14         ~PaymentParameters() {
  15                 if (ptr != 0) { bindings.PaymentParameters_free(ptr); }
  16         }
  17
  18         /**
  19          * Information about the payee, such as their features and route hints for their channels.
  20          */
  21         public Payee get_payee() {
  22                 long ret = bindings.PaymentParameters_get_payee(this.ptr);
  23                 GC.KeepAlive(this);
  24                 if (ret >= 0 && ret <= 4096) { return null; }
  25                 org.ldk.structs.Payee ret_hu_conv = org.ldk.structs.Payee.constr_from_ptr(ret);
  26                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
  27                 return ret_hu_conv;
  28         }
  29
  30         /**
  31          * Information about the payee, such as their features and route hints for their channels.
  32          */
  33         public void set_payee(org.ldk.structs.Payee val) {
  34                 bindings.PaymentParameters_set_payee(this.ptr, val.ptr);
  35                 GC.KeepAlive(this);
  36                 GC.KeepAlive(val);
  37                 if (this != null) { this.ptrs_to.AddLast(val); };
  38         }
  39
  40         /**
  41          * Expiration of a payment to the payee, in seconds relative to the UNIX epoch.
  42          */
  43         public Option_u64Z get_expiry_time() {
  44                 long ret = bindings.PaymentParameters_get_expiry_time(this.ptr);
  45                 GC.KeepAlive(this);
  46                 if (ret >= 0 && ret <= 4096) { return null; }
  47                 org.ldk.structs.Option_u64Z ret_hu_conv = org.ldk.structs.Option_u64Z.constr_from_ptr(ret);
  48                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
  49                 return ret_hu_conv;
  50         }
  51
  52         /**
  53          * Expiration of a payment to the payee, in seconds relative to the UNIX epoch.
  54          */
  55         public void set_expiry_time(org.ldk.structs.Option_u64Z val) {
  56                 bindings.PaymentParameters_set_expiry_time(this.ptr, val.ptr);
  57                 GC.KeepAlive(this);
  58                 GC.KeepAlive(val);
  59                 if (this != null) { this.ptrs_to.AddLast(val); };
  60         }
  61
  62         /**
  63          * The maximum total CLTV delta we accept for the route.
  64          * Defaults to [`DEFAULT_MAX_TOTAL_CLTV_EXPIRY_DELTA`].
  65          */
  66         public int get_max_total_cltv_expiry_delta() {
  67                 int ret = bindings.PaymentParameters_get_max_total_cltv_expiry_delta(this.ptr);
  68                 GC.KeepAlive(this);
  69                 return ret;
  70         }
  71
  72         /**
  73          * The maximum total CLTV delta we accept for the route.
  74          * Defaults to [`DEFAULT_MAX_TOTAL_CLTV_EXPIRY_DELTA`].
  75          */
  76         public void set_max_total_cltv_expiry_delta(int val) {
  77                 bindings.PaymentParameters_set_max_total_cltv_expiry_delta(this.ptr, val);
  78                 GC.KeepAlive(this);
  79                 GC.KeepAlive(val);
  80         }
  81
  82         /**
  83          * The maximum number of paths that may be used by (MPP) payments.
  84          * Defaults to [`DEFAULT_MAX_PATH_COUNT`].
  85          */
  86         public byte get_max_path_count() {
  87                 byte ret = bindings.PaymentParameters_get_max_path_count(this.ptr);
  88                 GC.KeepAlive(this);
  89                 return ret;
  90         }
  91
  92         /**
  93          * The maximum number of paths that may be used by (MPP) payments.
  94          * Defaults to [`DEFAULT_MAX_PATH_COUNT`].
  95          */
  96         public void set_max_path_count(byte val) {
  97                 bindings.PaymentParameters_set_max_path_count(this.ptr, val);
  98                 GC.KeepAlive(this);
  99                 GC.KeepAlive(val);
 100         }
 101
 102         /**
 103          * Selects the maximum share of a channel's total capacity which will be sent over a channel,
 104          * as a power of 1/2. A higher value prefers to send the payment using more MPP parts whereas
 105          * a lower value prefers to send larger MPP parts, potentially saturating channels and
 106          * increasing failure probability for those paths.
 107          *
 108          * Note that this restriction will be relaxed during pathfinding after paths which meet this
 109          * restriction have been found. While paths which meet this criteria will be searched for, it
 110          * is ultimately up to the scorer to select them over other paths.
 111          *
 112          * A value of 0 will allow payments up to and including a channel's total announced usable
 113          * capacity, a value of one will only use up to half its capacity, two 1/4, etc.
 114          *
 115          * Default value: 2
 116          */
 117         public byte get_max_channel_saturation_power_of_half() {
 118                 byte ret = bindings.PaymentParameters_get_max_channel_saturation_power_of_half(this.ptr);
 119                 GC.KeepAlive(this);
 120                 return ret;
 121         }
 122
 123         /**
 124          * Selects the maximum share of a channel's total capacity which will be sent over a channel,
 125          * as a power of 1/2. A higher value prefers to send the payment using more MPP parts whereas
 126          * a lower value prefers to send larger MPP parts, potentially saturating channels and
 127          * increasing failure probability for those paths.
 128          *
 129          * Note that this restriction will be relaxed during pathfinding after paths which meet this
 130          * restriction have been found. While paths which meet this criteria will be searched for, it
 131          * is ultimately up to the scorer to select them over other paths.
 132          *
 133          * A value of 0 will allow payments up to and including a channel's total announced usable
 134          * capacity, a value of one will only use up to half its capacity, two 1/4, etc.
 135          *
 136          * Default value: 2
 137          */
 138         public void set_max_channel_saturation_power_of_half(byte val) {
 139                 bindings.PaymentParameters_set_max_channel_saturation_power_of_half(this.ptr, val);
 140                 GC.KeepAlive(this);
 141                 GC.KeepAlive(val);
 142         }
 143
 144         /**
 145          * A list of SCIDs which this payment was previously attempted over and which caused the
 146          * payment to fail. Future attempts for the same payment shouldn't be relayed through any of
 147          * these SCIDs.
 148          *
 149          * Returns a copy of the field.
 150          */
 151         public long[] get_previously_failed_channels() {
 152                 long ret = bindings.PaymentParameters_get_previously_failed_channels(this.ptr);
 153                 GC.KeepAlive(this);
 154                 if (ret >= 0 && ret <= 4096) { return null; }
 155                 long[] ret_conv = InternalUtils.decodeUint64Array(ret);
 156                 return ret_conv;
 157         }
 158
 159         /**
 160          * A list of SCIDs which this payment was previously attempted over and which caused the
 161          * payment to fail. Future attempts for the same payment shouldn't be relayed through any of
 162          * these SCIDs.
 163          */
 164         public void set_previously_failed_channels(long[] val) {
 165                 bindings.PaymentParameters_set_previously_failed_channels(this.ptr, InternalUtils.encodeUint64Array(val));
 166                 GC.KeepAlive(this);
 167                 GC.KeepAlive(val);
 168         }
 169
 170         /**
 171          * A list of indices corresponding to blinded paths in [`Payee::Blinded::route_hints`] which this
 172          * payment was previously attempted over and which caused the payment to fail. Future attempts
 173          * for the same payment shouldn't be relayed through any of these blinded paths.
 174          *
 175          * Returns a copy of the field.
 176          */
 177         public long[] get_previously_failed_blinded_path_idxs() {
 178                 long ret = bindings.PaymentParameters_get_previously_failed_blinded_path_idxs(this.ptr);
 179                 GC.KeepAlive(this);
 180                 if (ret >= 0 && ret <= 4096) { return null; }
 181                 long[] ret_conv = InternalUtils.decodeUint64Array(ret);
 182                 return ret_conv;
 183         }
 184
 185         /**
 186          * A list of indices corresponding to blinded paths in [`Payee::Blinded::route_hints`] which this
 187          * payment was previously attempted over and which caused the payment to fail. Future attempts
 188          * for the same payment shouldn't be relayed through any of these blinded paths.
 189          */
 190         public void set_previously_failed_blinded_path_idxs(long[] val) {
 191                 bindings.PaymentParameters_set_previously_failed_blinded_path_idxs(this.ptr, InternalUtils.encodeUint64Array(val));
 192                 GC.KeepAlive(this);
 193                 GC.KeepAlive(val);
 194         }
 195
 196         /**
 197          * Constructs a new PaymentParameters given each field
 198          */
 199         public static PaymentParameters of(org.ldk.structs.Payee payee_arg, org.ldk.structs.Option_u64Z expiry_time_arg, int max_total_cltv_expiry_delta_arg, byte max_path_count_arg, byte max_channel_saturation_power_of_half_arg, long[] previously_failed_channels_arg, long[] previously_failed_blinded_path_idxs_arg) {
 200                 long ret = bindings.PaymentParameters_new(payee_arg.ptr, expiry_time_arg.ptr, max_total_cltv_expiry_delta_arg, max_path_count_arg, max_channel_saturation_power_of_half_arg, InternalUtils.encodeUint64Array(previously_failed_channels_arg), InternalUtils.encodeUint64Array(previously_failed_blinded_path_idxs_arg));
 201                 GC.KeepAlive(payee_arg);
 202                 GC.KeepAlive(expiry_time_arg);
 203                 GC.KeepAlive(max_total_cltv_expiry_delta_arg);
 204                 GC.KeepAlive(max_path_count_arg);
 205                 GC.KeepAlive(max_channel_saturation_power_of_half_arg);
 206                 GC.KeepAlive(previously_failed_channels_arg);
 207                 GC.KeepAlive(previously_failed_blinded_path_idxs_arg);
 208                 if (ret >= 0 && ret <= 4096) { return null; }
 209                 org.ldk.structs.PaymentParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PaymentParameters(null, ret); }
 210                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(ret_hu_conv); };
 211                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(payee_arg); };
 212                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(expiry_time_arg); };
 213                 return ret_hu_conv;
 214         }
 215
 216         internal long clone_ptr() {
 217                 long ret = bindings.PaymentParameters_clone_ptr(this.ptr);
 218                 GC.KeepAlive(this);
 219                 return ret;
 220         }
 221
 222         /**
 223          * Creates a copy of the PaymentParameters
 224          */
 225         public PaymentParameters clone() {
 226                 long ret = bindings.PaymentParameters_clone(this.ptr);
 227                 GC.KeepAlive(this);
 228                 if (ret >= 0 && ret <= 4096) { return null; }
 229                 org.ldk.structs.PaymentParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PaymentParameters(null, ret); }
 230                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(this); };
 231                 return ret_hu_conv;
 232         }
 233
 234         /**
 235          * Generates a non-cryptographic 64-bit hash of the PaymentParameters.
 236          */
 237         public long hash() {
 238                 long ret = bindings.PaymentParameters_hash(this.ptr);
 239                 GC.KeepAlive(this);
 240                 return ret;
 241         }
 242
 243         public override int GetHashCode() {
 244                 return (int)this.hash();
 245         }
 246         /**
 247          * Checks if two PaymentParameterss contain equal inner contents.
 248          * This ignores pointers and is_owned flags and looks at the values in fields.
 249          * Two objects with NULL inner values will be considered "equal" here.
 250          */
 251         public bool eq(org.ldk.structs.PaymentParameters b) {
 252                 bool ret = bindings.PaymentParameters_eq(this.ptr, b == null ? 0 : b.ptr);
 253                 GC.KeepAlive(this);
 254                 GC.KeepAlive(b);
 255                 if (this != null) { this.ptrs_to.AddLast(b); };
 256                 return ret;
 257         }
 258
 259         public override bool Equals(object o) {
 260                 if (!(o is PaymentParameters)) return false;
 261                 return this.eq((PaymentParameters)o);
 262         }
 263         /**
 264          * Serialize the PaymentParameters object into a byte array which can be read by PaymentParameters_read
 265          */
 266         public byte[] write() {
 267                 long ret = bindings.PaymentParameters_write(this.ptr);
 268                 GC.KeepAlive(this);
 269                 if (ret >= 0 && ret <= 4096) { return null; }
 270                 byte[] ret_conv = InternalUtils.decodeUint8Array(ret);
 271                 return ret_conv;
 272         }
 273
 274         /**
 275          * Read a PaymentParameters from a byte array, created by PaymentParameters_write
 276          */
 277         public static Result_PaymentParametersDecodeErrorZ read(byte[] ser, int arg) {
 278                 long ret = bindings.PaymentParameters_read(InternalUtils.encodeUint8Array(ser), arg);
 279                 GC.KeepAlive(ser);
 280                 GC.KeepAlive(arg);
 281                 if (ret >= 0 && ret <= 4096) { return null; }
 282                 Result_PaymentParametersDecodeErrorZ ret_hu_conv = Result_PaymentParametersDecodeErrorZ.constr_from_ptr(ret);
 283                 return ret_hu_conv;
 284         }
 285
 286         /**
 287          * Creates a payee with the node id of the given `pubkey`.
 288          *
 289          * The `final_cltv_expiry_delta` should match the expected final CLTV delta the recipient has
 290          * provided.
 291          */
 292         public static PaymentParameters from_node_id(byte[] payee_pubkey, int final_cltv_expiry_delta) {
 293                 long ret = bindings.PaymentParameters_from_node_id(InternalUtils.encodeUint8Array(InternalUtils.check_arr_len(payee_pubkey, 33)), final_cltv_expiry_delta);
 294                 GC.KeepAlive(payee_pubkey);
 295                 GC.KeepAlive(final_cltv_expiry_delta);
 296                 if (ret >= 0 && ret <= 4096) { return null; }
 297                 org.ldk.structs.PaymentParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PaymentParameters(null, ret); }
 298                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(ret_hu_conv); };
 299                 return ret_hu_conv;
 300         }
 301
 302         /**
 303          * Creates a payee with the node id of the given `pubkey` to use for keysend payments.
 304          *
 305          * The `final_cltv_expiry_delta` should match the expected final CLTV delta the recipient has
 306          * provided.
 307          *
 308          * Note that MPP keysend is not widely supported yet. The `allow_mpp` lets you choose
 309          * whether your router will be allowed to find a multi-part route for this payment. If you
 310          * set `allow_mpp` to true, you should ensure a payment secret is set on send, likely via
 311          * [`RecipientOnionFields::secret_only`].
 312          *
 313          * [`RecipientOnionFields::secret_only`]: crate::ln::channelmanager::RecipientOnionFields::secret_only
 314          */
 315         public static PaymentParameters for_keysend(byte[] payee_pubkey, int final_cltv_expiry_delta, bool allow_mpp) {
 316                 long ret = bindings.PaymentParameters_for_keysend(InternalUtils.encodeUint8Array(InternalUtils.check_arr_len(payee_pubkey, 33)), final_cltv_expiry_delta, allow_mpp);
 317                 GC.KeepAlive(payee_pubkey);
 318                 GC.KeepAlive(final_cltv_expiry_delta);
 319                 GC.KeepAlive(allow_mpp);
 320                 if (ret >= 0 && ret <= 4096) { return null; }
 321                 org.ldk.structs.PaymentParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PaymentParameters(null, ret); }
 322                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(ret_hu_conv); };
 323                 return ret_hu_conv;
 324         }
 325
 326         /**
 327          * Creates parameters for paying to a blinded payee from the provided invoice. Sets
 328          * [`Payee::Blinded::route_hints`], [`Payee::Blinded::features`], and
 329          * [`PaymentParameters::expiry_time`].
 330          */
 331         public static PaymentParameters from_bolt12_invoice(org.ldk.structs.Bolt12Invoice invoice) {
 332                 long ret = bindings.PaymentParameters_from_bolt12_invoice(invoice == null ? 0 : invoice.ptr);
 333                 GC.KeepAlive(invoice);
 334                 if (ret >= 0 && ret <= 4096) { return null; }
 335                 org.ldk.structs.PaymentParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PaymentParameters(null, ret); }
 336                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(ret_hu_conv); };
 337                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(invoice); };
 338                 return ret_hu_conv;
 339         }
 340
 341         /**
 342          * Creates parameters for paying to a blinded payee from the provided blinded route hints.
 343          */
 344         public static PaymentParameters blinded(TwoTuple_BlindedPayInfoBlindedPathZ[] blinded_route_hints) {
 345                 long ret = bindings.PaymentParameters_blinded(InternalUtils.encodeUint64Array(InternalUtils.mapArray(blinded_route_hints, blinded_route_hints_conv_37 => blinded_route_hints_conv_37 != null ? blinded_route_hints_conv_37.ptr : 0)));
 346                 GC.KeepAlive(blinded_route_hints);
 347                 if (ret >= 0 && ret <= 4096) { return null; }
 348                 org.ldk.structs.PaymentParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.PaymentParameters(null, ret); }
 349                 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.AddLast(ret_hu_conv); };
 350                 return ret_hu_conv;
 351         }
 352
 353 }
 354 } } }