projects
/
ldk-java
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Update auto-updated Java files
[ldk-java]
/
src
/
main
/
java
/
org
/
ldk
/
structs
/
Listen.java
diff --git
a/src/main/java/org/ldk/structs/Listen.java
b/src/main/java/org/ldk/structs/Listen.java
index 075137cbc3d63db05d038cf817e4625ddf0f9cb8..93c1fc228dc5d4e934bb306486397873123959f2 100644
(file)
--- a/
src/main/java/org/ldk/structs/Listen.java
+++ b/
src/main/java/org/ldk/structs/Listen.java
@@
-4,7
+4,18
@@
import org.ldk.impl.bindings;
import org.ldk.enums.*;
import org.ldk.util.*;
import java.util.Arrays;
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
+ * chain.
+ *
+ * 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.
+ */
@SuppressWarnings("unchecked") // We correctly assign various generic arrays
public class Listen extends CommonBase {
final bindings.LDKListen bindings_instance;
@SuppressWarnings("unchecked") // We correctly assign various generic arrays
public class Listen extends CommonBase {
final bindings.LDKListen bindings_instance;
@@
-20,7
+31,13
@@
public class Listen extends CommonBase {
}
public static interface ListenInterface {
}
public static interface ListenInterface {
+ /**
+ * Notifies the listener that a block was added at the given height.
+ */
void block_connected(byte[] block, int height);
void block_connected(byte[] block, int height);
+ /**
+ * Notifies the listener that a block was removed at the given height.
+ */
void block_disconnected(byte[] header, int height);
}
private static class LDKListenHolder { Listen held; }
void block_disconnected(byte[] header, int height);
}
private static class LDKListenHolder { Listen held; }
@@
-36,12
+53,24
@@
public class Listen extends CommonBase {
});
return impl_holder.held;
}
});
return impl_holder.held;
}
+ /**
+ * 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);
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) {
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);
}
}
}
}