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 be notified of when blocks have been connected or disconnected
- * from the chain.
+ * The `Listen` trait is used to notify when blocks have been connected or disconnected from the
+ * chain.
*
- * Useful when needing to replay chain data upon startup or as new chain events occur.
+ * Useful when needing to replay chain data upon startup or as new chain events occur. Clients
+ * 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 {
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.
*/
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);
}
}