1 package org.ldk.structs;
3 import org.ldk.impl.bindings;
4 import org.ldk.enums.*;
6 import java.util.Arrays;
7 import java.lang.ref.Reference;
8 import javax.annotation.Nullable;
11 * The `Listen` trait is used to notify when blocks have been connected or disconnected from the
14 * Useful when needing to replay chain data upon startup or as new chain events occur. Clients
15 * sourcing chain data using a block-oriented API should prefer this interface over [`Confirm`].
16 * Such clients fetch the entire header chain whereas clients using [`Confirm`] only fetch headers
19 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
20 public class Listen extends CommonBase {
21 final bindings.LDKListen bindings_instance;
22 Listen(Object _dummy, long ptr) { super(ptr); bindings_instance = null; }
23 private Listen(bindings.LDKListen arg) {
24 super(bindings.LDKListen_new(arg));
25 this.ptrs_to.add(arg);
26 this.bindings_instance = arg;
28 @Override @SuppressWarnings("deprecation")
29 protected void finalize() throws Throwable {
30 if (ptr != 0) { bindings.Listen_free(ptr); } super.finalize();
33 public static interface ListenInterface {
35 * Notifies the listener that a block was added at the given height.
37 void block_connected(byte[] block, int height);
39 * Notifies the listener that a block was removed at the given height.
41 void block_disconnected(byte[] header, int height);
43 private static class LDKListenHolder { Listen held; }
44 public static Listen new_impl(ListenInterface arg) {
45 final LDKListenHolder impl_holder = new LDKListenHolder();
46 impl_holder.held = new Listen(new bindings.LDKListen() {
47 @Override public void block_connected(byte[] block, int height) {
48 arg.block_connected(block, height);
49 Reference.reachabilityFence(arg);
51 @Override public void block_disconnected(byte[] header, int height) {
52 arg.block_disconnected(header, height);
53 Reference.reachabilityFence(arg);
56 return impl_holder.held;
59 * Notifies the listener that a block was added at the given height.
61 public void block_connected(byte[] block, int height) {
62 bindings.Listen_block_connected(this.ptr, block, height);
63 Reference.reachabilityFence(this);
64 Reference.reachabilityFence(block);
65 Reference.reachabilityFence(height);
69 * Notifies the listener that a block was removed at the given height.
71 public void block_disconnected(byte[] header, int height) {
72 bindings.Listen_block_disconnected(this.ptr, InternalUtils.check_arr_len(header, 80), height);
73 Reference.reachabilityFence(this);
74 Reference.reachabilityFence(header);
75 Reference.reachabilityFence(height);