Update auto-updated Java files

[ldk-java] / src / main / java / org / ldk / structs / InvoicePayer.java

diff --git a/src/main/java/org/ldk/structs/InvoicePayer.java b/src/main/java/org/ldk/structs/InvoicePayer.java
index a54ee10b19506fcd2d2c0393704b5604aac149aa..d8a7022e2e4c6bffa2a1dbaddaefc4f2d040de5f 100644 (file)
--- a/src/main/java/org/ldk/structs/InvoicePayer.java
+++ b/src/main/java/org/ldk/structs/InvoicePayer.java
@@ -4,11 +4,16 @@ import org.ldk.impl.bindings;
 import org.ldk.enums.*;
 import org.ldk.util.*;
 import java.util.Arrays;
+import java.lang.ref.Reference;
 import javax.annotation.Nullable;
 
 
 /**
- * A utility for paying [`Invoice]`s.
+ * A utility for paying [`Invoice`]s and sending spontaneous payments.
+ * 
+ * See [module-level documentation] for details.
+ * 
+ * [module-level documentation]: crate::payment
  */
 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
 public class InvoicePayer extends CommonBase {
@@ -25,8 +30,14 @@ public class InvoicePayer extends CommonBase {
         * Will forward any [`Event::PaymentPathFailed`] events to the decorated `event_handler` once
         * `retry_attempts` has been exceeded for a given [`Invoice`].
         */
-       public static InvoicePayer of(Payer payer, Router router, LockableScore scorer, Logger logger, EventHandler event_handler, RetryAttempts retry_attempts) {
+       public static InvoicePayer of(Payer payer, Router router, MultiThreadedLockableScore scorer, Logger logger, EventHandler event_handler, RetryAttempts retry_attempts) {
                long ret = bindings.InvoicePayer_new(payer == null ? 0 : payer.ptr, router == null ? 0 : router.ptr, scorer == null ? 0 : scorer.ptr & ~1, logger == null ? 0 : logger.ptr, event_handler == null ? 0 : event_handler.ptr, retry_attempts == null ? 0 : retry_attempts.ptr & ~1);
+               Reference.reachabilityFence(payer);
+               Reference.reachabilityFence(router);
+               Reference.reachabilityFence(scorer);
+               Reference.reachabilityFence(logger);
+               Reference.reachabilityFence(event_handler);
+               Reference.reachabilityFence(retry_attempts);
                if (ret >= 0 && ret <= 4096) { return null; }
                InvoicePayer ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new InvoicePayer(null, ret); }
                ret_hu_conv.ptrs_to.add(ret_hu_conv);
@@ -47,6 +58,8 @@ public class InvoicePayer extends CommonBase {
         */
        public Result_PaymentIdPaymentErrorZ pay_invoice(Invoice invoice) {
                long ret = bindings.InvoicePayer_pay_invoice(this.ptr, invoice == null ? 0 : invoice.ptr & ~1);
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(invoice);
                if (ret >= 0 && ret <= 4096) { return null; }
                Result_PaymentIdPaymentErrorZ ret_hu_conv = Result_PaymentIdPaymentErrorZ.constr_from_ptr(ret);
                this.ptrs_to.add(invoice);
@@ -63,12 +76,34 @@ public class InvoicePayer extends CommonBase {
         */
        public Result_PaymentIdPaymentErrorZ pay_zero_value_invoice(Invoice invoice, long amount_msats) {
                long ret = bindings.InvoicePayer_pay_zero_value_invoice(this.ptr, invoice == null ? 0 : invoice.ptr & ~1, amount_msats);
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(invoice);
+               Reference.reachabilityFence(amount_msats);
                if (ret >= 0 && ret <= 4096) { return null; }
                Result_PaymentIdPaymentErrorZ ret_hu_conv = Result_PaymentIdPaymentErrorZ.constr_from_ptr(ret);
                this.ptrs_to.add(invoice);
                return ret_hu_conv;
        }
 
+       /**
+        * Pays `pubkey` an amount using the hash of the given preimage, caching it for later use in
+        * case a retry is needed.
+        * 
+        * You should ensure that `payment_preimage` is unique and that its `payment_hash` has never
+        * been paid before. Because [`InvoicePayer`] is stateless no effort is made to do so for you.
+        */
+       public Result_PaymentIdPaymentErrorZ pay_pubkey(byte[] pubkey, byte[] payment_preimage, long amount_msats, int final_cltv_expiry_delta) {
+               long ret = bindings.InvoicePayer_pay_pubkey(this.ptr, InternalUtils.check_arr_len(pubkey, 33), InternalUtils.check_arr_len(payment_preimage, 32), amount_msats, final_cltv_expiry_delta);
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(pubkey);
+               Reference.reachabilityFence(payment_preimage);
+               Reference.reachabilityFence(amount_msats);
+               Reference.reachabilityFence(final_cltv_expiry_delta);
+               if (ret >= 0 && ret <= 4096) { return null; }
+               Result_PaymentIdPaymentErrorZ ret_hu_conv = Result_PaymentIdPaymentErrorZ.constr_from_ptr(ret);
+               return ret_hu_conv;
+       }
+
        /**
         * Removes the payment cached by the given payment hash.
         * 
@@ -77,6 +112,8 @@ public class InvoicePayer extends CommonBase {
         */
        public void remove_cached_payment(byte[] payment_hash) {
                bindings.InvoicePayer_remove_cached_payment(this.ptr, InternalUtils.check_arr_len(payment_hash, 32));
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(payment_hash);
        }
 
        /**
@@ -85,6 +122,7 @@ public class InvoicePayer extends CommonBase {
         */
        public EventHandler as_EventHandler() {
                long ret = bindings.InvoicePayer_as_EventHandler(this.ptr);
+               Reference.reachabilityFence(this);
                if (ret >= 0 && ret <= 4096) { return null; }
                EventHandler ret_hu_conv = new EventHandler(null, ret);
                ret_hu_conv.ptrs_to.add(this);