[Java] Update auto-generated bindings to LDK-C-Bindings 0.0.123.1

[ldk-java] / src / main / java / org / ldk / structs / DecodeError.java

diff --git a/src/main/java/org/ldk/structs/DecodeError.java b/src/main/java/org/ldk/structs/DecodeError.java
index 0dc34a05f7d2458b6984e6db86a9f96f2b571574..39e16610a7a25467be48b58a3fdbaa0321e7c54e 100644 (file)
--- a/src/main/java/org/ldk/structs/DecodeError.java
+++ b/src/main/java/org/ldk/structs/DecodeError.java
@@ -42,12 +42,16 @@ public class DecodeError extends CommonBase {
                if (raw_val.getClass() == bindings.LDKDecodeError.UnsupportedCompression.class) {
                        return new UnsupportedCompression(ptr, (bindings.LDKDecodeError.UnsupportedCompression)raw_val);
                }
+               if (raw_val.getClass() == bindings.LDKDecodeError.DangerousValue.class) {
+                       return new DangerousValue(ptr, (bindings.LDKDecodeError.DangerousValue)raw_val);
+               }
                assert false; return null; // Unreachable without extending the (internal) bindings interface
        }
 
        /**
         * A version byte specified something we don't know how to handle.
-        * Includes unknown realm byte in an OnionHopData packet
+        * 
+        * Includes unknown realm byte in an onion hop data packet.
         */
        public final static class UnknownVersion extends DecodeError {
                private UnknownVersion(long ptr, bindings.LDKDecodeError.UnknownVersion obj) {
@@ -55,7 +59,7 @@ public class DecodeError extends CommonBase {
                }
        }
        /**
-        * Unknown feature mandating we fail to parse message (eg TLV with an even, unknown type)
+        * Unknown feature mandating we fail to parse message (e.g., TLV with an even, unknown type)
         */
        public final static class UnknownRequiredFeature extends DecodeError {
                private UnknownRequiredFeature(long ptr, bindings.LDKDecodeError.UnknownRequiredFeature obj) {
@@ -63,9 +67,11 @@ public class DecodeError extends CommonBase {
                }
        }
        /**
-        * Value was invalid, eg a byte which was supposed to be a bool was something other than a 0
+        * Value was invalid.
+        * 
+        * For example, a byte which was supposed to be a bool was something other than a 0
         * or 1, a public key/private key/signature was invalid, text wasn't UTF-8, TLV was
-        * syntactically incorrect, etc
+        * syntactically incorrect, etc.
         */
        public final static class InvalidValue extends DecodeError {
                private InvalidValue(long ptr, bindings.LDKDecodeError.InvalidValue obj) {
@@ -73,7 +79,7 @@ public class DecodeError extends CommonBase {
                }
        }
        /**
-        * Buffer too short
+        * The buffer to be read was too short.
         */
        public final static class ShortRead extends DecodeError {
                private ShortRead(long ptr, bindings.LDKDecodeError.ShortRead obj) {
@@ -81,7 +87,7 @@ public class DecodeError extends CommonBase {
                }
        }
        /**
-        * A length descriptor in the packet didn't describe the later data correctly
+        * A length descriptor in the packet didn't describe the later data correctly.
         */
        public final static class BadLengthDescriptor extends DecodeError {
                private BadLengthDescriptor(long ptr, bindings.LDKDecodeError.BadLengthDescriptor obj) {
@@ -89,7 +95,7 @@ public class DecodeError extends CommonBase {
                }
        }
        /**
-        * Error from std::io
+        * Error from [`std::io`].
         */
        public final static class Io extends DecodeError {
                public final org.ldk.enums.IOError io;
@@ -106,6 +112,22 @@ public class DecodeError extends CommonBase {
                        super(null, ptr);
                }
        }
+       /**
+        * Value is validly encoded but is dangerous to use.
+        * 
+        * This is used for things like [`ChannelManager`] deserialization where we want to ensure
+        * that we don't use a [`ChannelManager`] which is in out of sync with the [`ChannelMonitor`].
+        * This indicates that there is a critical implementation flaw in the storage implementation
+        * and it's unsafe to continue.
+        * 
+        * [`ChannelManager`]: crate::ln::channelmanager::ChannelManager
+        * [`ChannelMonitor`]: crate::chain::channelmonitor::ChannelMonitor
+        */
+       public final static class DangerousValue extends DecodeError {
+               private DangerousValue(long ptr, bindings.LDKDecodeError.DangerousValue obj) {
+                       super(null, ptr);
+               }
+       }
        long clone_ptr() {
                long ret = bindings.DecodeError_clone_ptr(this.ptr);
                Reference.reachabilityFence(this);
@@ -202,12 +224,35 @@ public class DecodeError extends CommonBase {
                return ret_hu_conv;
        }
 
+       /**
+        * Utility method to constructs a new DangerousValue-variant DecodeError
+        */
+       public static DecodeError dangerous_value() {
+               long ret = bindings.DecodeError_dangerous_value();
+               if (ret >= 0 && ret <= 4096) { return null; }
+               org.ldk.structs.DecodeError ret_hu_conv = org.ldk.structs.DecodeError.constr_from_ptr(ret);
+               if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
+               return ret_hu_conv;
+       }
+
+       /**
+        * Generates a non-cryptographic 64-bit hash of the DecodeError.
+        */
+       public long hash() {
+               long ret = bindings.DecodeError_hash(this.ptr);
+               Reference.reachabilityFence(this);
+               return ret;
+       }
+
+       @Override public int hashCode() {
+               return (int)this.hash();
+       }
        /**
         * Checks if two DecodeErrors contain equal inner contents.
         * This ignores pointers and is_owned flags and looks at the values in fields.
         */
        public boolean eq(org.ldk.structs.DecodeError b) {
-               boolean ret = bindings.DecodeError_eq(this.ptr, b == null ? 0 : b.ptr);
+               boolean ret = bindings.DecodeError_eq(this.ptr, b.ptr);
                Reference.reachabilityFence(this);
                Reference.reachabilityFence(b);
                return ret;
@@ -217,4 +262,13 @@ public class DecodeError extends CommonBase {
                if (!(o instanceof DecodeError)) return false;
                return this.eq((DecodeError)o);
        }
+       /**
+        * Get the string representation of a DecodeError object
+        */
+       public String to_str() {
+               String ret = bindings.DecodeError_to_str(this.ptr);
+               Reference.reachabilityFence(this);
+               return ret;
+       }
+
 }