[TS] Update auto-generated bindings to LDK-C-Bindings 0.0.123.1
[ldk-java] / src / main / java / org / ldk / structs / Listen.java
index d975ccaa6a46e535ee3aec2a84b2b73d55dcfb14..ada394d95c1f13fc8b3691b301207955e2260f14 100644 (file)
@@ -4,6 +4,8 @@ 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;
 
 /**
  * The `Listen` trait is used to notify when blocks have been connected or disconnected from the
@@ -13,6 +15,10 @@ import java.util.Arrays;
  * sourcing chain data using a block-oriented API should prefer this interface over [`Confirm`].
  * Such clients fetch the entire header chain whereas clients using [`Confirm`] only fetch headers
  * when needed.
+ * 
+ * By using [`Listen::filtered_block_connected`] this interface supports clients fetching the
+ * entire header chain and only blocks with matching transaction data using BIP 157 filters or
+ * other similar filtering.
  */
 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
 public class Listen extends CommonBase {
@@ -27,8 +33,25 @@ public class Listen extends CommonBase {
        protected void finalize() throws Throwable {
                if (ptr != 0) { bindings.Listen_free(ptr); } super.finalize();
        }
-
+       /**
+        * Destroys the object, freeing associated resources. After this call, any access
+        * to this object may result in a SEGFAULT or worse.
+        *
+        * You should generally NEVER call this method. You should let the garbage collector
+        * do this for you when it finalizes objects. However, it may be useful for types
+        * which represent locks and should be closed immediately to avoid holding locks
+        * until the GC runs.
+        */
+       public void destroy() {
+               if (ptr != 0) { bindings.Listen_free(ptr); }
+               ptr = 0;
+       }
        public static interface ListenInterface {
+               /**
+                * Notifies the listener that a block was added at the given height, with the transaction data
+                * possibly filtered.
+                */
+               void filtered_block_connected(byte[] header, TwoTuple_usizeTransactionZ[] txdata, int height);
                /**
                 * Notifies the listener that a block was added at the given height.
                 */
@@ -42,27 +65,59 @@ public class Listen extends CommonBase {
        public static Listen new_impl(ListenInterface arg) {
                final LDKListenHolder impl_holder = new LDKListenHolder();
                impl_holder.held = new Listen(new bindings.LDKListen() {
+                       @Override public void filtered_block_connected(byte[] header, long[] txdata, int height) {
+                               int txdata_conv_28_len = txdata.length;
+                               TwoTuple_usizeTransactionZ[] txdata_conv_28_arr = new TwoTuple_usizeTransactionZ[txdata_conv_28_len];
+                               for (int c = 0; c < txdata_conv_28_len; c++) {
+                                       long txdata_conv_28 = txdata[c];
+                                       TwoTuple_usizeTransactionZ txdata_conv_28_hu_conv = new TwoTuple_usizeTransactionZ(null, txdata_conv_28);
+                                       if (txdata_conv_28_hu_conv != null) { txdata_conv_28_hu_conv.ptrs_to.add(this); };
+                                       txdata_conv_28_arr[c] = txdata_conv_28_hu_conv;
+                               }
+                               arg.filtered_block_connected(header, txdata_conv_28_arr, height);
+                               Reference.reachabilityFence(arg);
+                       }
                        @Override public void block_connected(byte[] block, int height) {
                                arg.block_connected(block, height);
+                               Reference.reachabilityFence(arg);
                        }
                        @Override public void block_disconnected(byte[] header, int height) {
                                arg.block_disconnected(header, height);
+                               Reference.reachabilityFence(arg);
                        }
                });
                return impl_holder.held;
        }
+       /**
+        * Notifies the listener that a block was added at the given height, with the transaction data
+        * possibly filtered.
+        */
+       public void filtered_block_connected(byte[] header, TwoTuple_usizeTransactionZ[] txdata, int height) {
+               bindings.Listen_filtered_block_connected(this.ptr, InternalUtils.check_arr_len(header, 80), txdata != null ? Arrays.stream(txdata).mapToLong(txdata_conv_28 -> txdata_conv_28.ptr).toArray() : null, height);
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(header);
+               Reference.reachabilityFence(txdata);
+               Reference.reachabilityFence(height);
+       }
+
        /**
         * Notifies the listener that a block was added at the given height.
         */
        public void block_connected(byte[] block, int height) {
                bindings.Listen_block_connected(this.ptr, block, height);
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(block);
+               Reference.reachabilityFence(height);
        }
 
        /**
         * Notifies the listener that a block was removed at the given height.
         */
        public void block_disconnected(byte[] header, int height) {
-               bindings.Listen_block_disconnected(this.ptr, header, height);
+               bindings.Listen_block_disconnected(this.ptr, InternalUtils.check_arr_len(header, 80), height);
+               Reference.reachabilityFence(this);
+               Reference.reachabilityFence(header);
+               Reference.reachabilityFence(height);
        }
 
 }