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) {
}
}
/**
- * 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) {
}
}
/**
- * 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) {
}
}
/**
- * 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) {
}
}
/**
- * 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) {
}
}
/**
- * Error from std::io
+ * Error from [`std::io`].
*/
public final static class Io extends DecodeError {
public final org.ldk.enums.IOError io;
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);
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(DecodeError b) {
- boolean ret = bindings.DecodeError_eq(this.ptr, b == null ? 0 : b.ptr);
+ public boolean eq(org.ldk.structs.DecodeError b) {
+ boolean ret = bindings.DecodeError_eq(this.ptr, b.ptr);
Reference.reachabilityFence(this);
Reference.reachabilityFence(b);
return ret;
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;
+ }
+
}