X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FReplyChannelRange.java;h=10ca61a3c511c876873c1c270abd9791d23b9288;hb=7b75443b8305c6a24d3c08520e1785e9d39960e4;hp=5457ced59f164c18890f57c045a64ced8ee311b3;hpb=166ff04616cfee975ce991607ca0df88857193df;p=ldk-java diff --git a/src/main/java/org/ldk/structs/ReplyChannelRange.java b/src/main/java/org/ldk/structs/ReplyChannelRange.java index 5457ced5..10ca61a3 100644 --- a/src/main/java/org/ldk/structs/ReplyChannelRange.java +++ b/src/main/java/org/ldk/structs/ReplyChannelRange.java @@ -2,68 +2,207 @@ package org.ldk.structs; 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 [`reply_channel_range`] message is a reply to a [`QueryChannelRange`] + * message. + * + * Multiple `reply_channel_range` messages can be sent in reply + * to a single [`QueryChannelRange`] message. The query recipient makes a + * best effort to respond based on their local network view which may + * not be a perfect view of the network. The `short_channel_id`s in the + * reply are encoded. We only support `encoding_type=0` uncompressed + * serialization and do not support `encoding_type=1` zlib serialization. + * + * [`reply_channel_range`]: https://github.com/lightning/bolts/blob/master/07-routing-gossip.md#the-query_channel_range-and-reply_channel_range-messages + */ +@SuppressWarnings("unchecked") // We correctly assign various generic arrays public class ReplyChannelRange extends CommonBase { ReplyChannelRange(Object _dummy, long ptr) { super(ptr); } @Override @SuppressWarnings("deprecation") protected void finalize() throws Throwable { - bindings.ReplyChannelRange_free(ptr); super.finalize(); + super.finalize(); + if (ptr != 0) { bindings.ReplyChannelRange_free(ptr); } + } + + /** + * The genesis hash of the blockchain being queried + */ + public byte[] get_chain_hash() { + byte[] ret = bindings.ReplyChannelRange_get_chain_hash(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * The genesis hash of the blockchain being queried + */ + public void set_chain_hash(byte[] val) { + bindings.ReplyChannelRange_set_chain_hash(this.ptr, InternalUtils.check_arr_len(val, 32)); + Reference.reachabilityFence(this); + Reference.reachabilityFence(val); + } + + /** + * The height of the first block in the range of the reply + */ + public int get_first_blocknum() { + int ret = bindings.ReplyChannelRange_get_first_blocknum(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * The height of the first block in the range of the reply + */ + public void set_first_blocknum(int val) { + bindings.ReplyChannelRange_set_first_blocknum(this.ptr, val); + Reference.reachabilityFence(this); + Reference.reachabilityFence(val); } - public ReplyChannelRange(ReplyChannelRange orig) { - super(bindings.ReplyChannelRange_clone(orig.ptr & ~1)); - this.ptrs_to.add(orig); + /** + * The number of blocks included in the range of the reply + */ + public int get_number_of_blocks() { + int ret = bindings.ReplyChannelRange_get_number_of_blocks(this.ptr); + Reference.reachabilityFence(this); + return ret; + } + + /** + * The number of blocks included in the range of the reply + */ + public void set_number_of_blocks(int val) { + bindings.ReplyChannelRange_set_number_of_blocks(this.ptr, val); + Reference.reachabilityFence(this); + Reference.reachabilityFence(val); } - public byte[] get_chain_hash(ReplyChannelRange this_ptr) { - byte[] ret = bindings.ReplyChannelRange_get_chain_hash(this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * True when this is the final reply for a query + */ + public boolean get_sync_complete() { + boolean ret = bindings.ReplyChannelRange_get_sync_complete(this.ptr); + Reference.reachabilityFence(this); return ret; } - public void set_chain_hash(ReplyChannelRange this_ptr, byte[] val) { - bindings.ReplyChannelRange_set_chain_hash(this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * True when this is the final reply for a query + */ + public void set_sync_complete(boolean val) { + bindings.ReplyChannelRange_set_sync_complete(this.ptr, val); + Reference.reachabilityFence(this); + Reference.reachabilityFence(val); } - public int get_first_blocknum(ReplyChannelRange this_ptr) { - int ret = bindings.ReplyChannelRange_get_first_blocknum(this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * The `short_channel_id`s in the channel range + * + * Returns a copy of the field. + */ + public long[] get_short_channel_ids() { + long[] ret = bindings.ReplyChannelRange_get_short_channel_ids(this.ptr); + Reference.reachabilityFence(this); return ret; } - public void set_first_blocknum(ReplyChannelRange this_ptr, int val) { - bindings.ReplyChannelRange_set_first_blocknum(this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * The `short_channel_id`s in the channel range + */ + public void set_short_channel_ids(long[] val) { + bindings.ReplyChannelRange_set_short_channel_ids(this.ptr, val); + Reference.reachabilityFence(this); + Reference.reachabilityFence(val); } - public int get_number_of_blocks(ReplyChannelRange this_ptr) { - int ret = bindings.ReplyChannelRange_get_number_of_blocks(this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * Constructs a new ReplyChannelRange given each field + */ + public static ReplyChannelRange of(byte[] chain_hash_arg, int first_blocknum_arg, int number_of_blocks_arg, boolean sync_complete_arg, long[] short_channel_ids_arg) { + long ret = bindings.ReplyChannelRange_new(InternalUtils.check_arr_len(chain_hash_arg, 32), first_blocknum_arg, number_of_blocks_arg, sync_complete_arg, short_channel_ids_arg); + Reference.reachabilityFence(chain_hash_arg); + Reference.reachabilityFence(first_blocknum_arg); + Reference.reachabilityFence(number_of_blocks_arg); + Reference.reachabilityFence(sync_complete_arg); + Reference.reachabilityFence(short_channel_ids_arg); + if (ret >= 0 && ret <= 4096) { return null; } + org.ldk.structs.ReplyChannelRange ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.ReplyChannelRange(null, ret); } + if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); }; + return ret_hu_conv; + } + + long clone_ptr() { + long ret = bindings.ReplyChannelRange_clone_ptr(this.ptr); + Reference.reachabilityFence(this); return ret; } - public void set_number_of_blocks(ReplyChannelRange this_ptr, int val) { - bindings.ReplyChannelRange_set_number_of_blocks(this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + /** + * Creates a copy of the ReplyChannelRange + */ + public ReplyChannelRange clone() { + long ret = bindings.ReplyChannelRange_clone(this.ptr); + Reference.reachabilityFence(this); + if (ret >= 0 && ret <= 4096) { return null; } + org.ldk.structs.ReplyChannelRange ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.ReplyChannelRange(null, ret); } + if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); }; + return ret_hu_conv; } - public boolean get_full_information(ReplyChannelRange this_ptr) { - boolean ret = bindings.ReplyChannelRange_get_full_information(this_ptr.ptr & ~1); - this.ptrs_to.add(this_ptr); + /** + * Generates a non-cryptographic 64-bit hash of the ReplyChannelRange. + */ + public long hash() { + long ret = bindings.ReplyChannelRange_hash(this.ptr); + Reference.reachabilityFence(this); return ret; } - public void set_full_information(ReplyChannelRange this_ptr, boolean val) { - bindings.ReplyChannelRange_set_full_information(this_ptr.ptr & ~1, val); - this.ptrs_to.add(this_ptr); + @Override public int hashCode() { + return (int)this.hash(); + } + /** + * Checks if two ReplyChannelRanges contain equal inner contents. + * This ignores pointers and is_owned flags and looks at the values in fields. + * Two objects with NULL inner values will be considered "equal" here. + */ + public boolean eq(org.ldk.structs.ReplyChannelRange b) { + boolean ret = bindings.ReplyChannelRange_eq(this.ptr, b == null ? 0 : b.ptr); + Reference.reachabilityFence(this); + Reference.reachabilityFence(b); + if (this != null) { this.ptrs_to.add(b); }; + return ret; } - // Skipped ReplyChannelRange_set_short_channel_ids - // Skipped ReplyChannelRange_new - public ReplyChannelRange(byte[] ser) { - super(bindings.ReplyChannelRange_read(ser)); + @Override public boolean equals(Object o) { + if (!(o instanceof ReplyChannelRange)) return false; + return this.eq((ReplyChannelRange)o); + } + /** + * Read a ReplyChannelRange from a byte array, created by ReplyChannelRange_write + */ + public static Result_ReplyChannelRangeDecodeErrorZ read(byte[] ser) { + long ret = bindings.ReplyChannelRange_read(ser); + Reference.reachabilityFence(ser); + if (ret >= 0 && ret <= 4096) { return null; } + Result_ReplyChannelRangeDecodeErrorZ ret_hu_conv = Result_ReplyChannelRangeDecodeErrorZ.constr_from_ptr(ret); + return ret_hu_conv; + } + + /** + * Serialize the ReplyChannelRange object into a byte array which can be read by ReplyChannelRange_read + */ + public byte[] write() { + byte[] ret = bindings.ReplyChannelRange_write(this.ptr); + Reference.reachabilityFence(this); + return ret; } - // Skipped ReplyChannelRange_write }