Update auto-generated bindings to 0.0.103
[ldk-java] / src / main / java / org / ldk / structs / Access.java
index 15b3d7423df26c1bb581c2a75b7393295ae382da..47f0c93667197bef58cd6ebd3fea387743901869 100644 (file)
@@ -4,7 +4,12 @@ import org.ldk.impl.bindings;
 import org.ldk.enums.*;
 import org.ldk.util.*;
 import java.util.Arrays;
+import javax.annotation.Nullable;
 
+/**
+ * The `Access` trait defines behavior for accessing chain data and state, such as blocks and
+ * UTXOs.
+ */
 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
 public class Access extends CommonBase {
        final bindings.LDKAccess bindings_instance;
@@ -20,22 +25,38 @@ public class Access extends CommonBase {
        }
 
        public static interface AccessInterface {
+               /**
+                * Returns the transaction output of a funding transaction encoded by [`short_channel_id`].
+                * Returns an error if `genesis_hash` is for a different chain or if such a transaction output
+                * is unknown.
+                * 
+                * [`short_channel_id`]: https://github.com/lightningnetwork/lightning-rfc/blob/master/07-routing-gossip.md#definition-of-short_channel_id
+                */
                Result_TxOutAccessErrorZ get_utxo(byte[] genesis_hash, long short_channel_id);
        }
-       public Access(AccessInterface arg) {
-               this(new bindings.LDKAccess() {
+       private static class LDKAccessHolder { Access held; }
+       public static Access new_impl(AccessInterface arg) {
+               final LDKAccessHolder impl_holder = new LDKAccessHolder();
+               impl_holder.held = new Access(new bindings.LDKAccess() {
                        @Override public long get_utxo(byte[] genesis_hash, long short_channel_id) {
                                Result_TxOutAccessErrorZ ret = arg.get_utxo(genesis_hash, short_channel_id);
                                long result = ret != null ? ret.ptr : 0;
-                               ret.ptr = 0;
                                return result;
                        }
                });
+               return impl_holder.held;
        }
+       /**
+        * Returns the transaction output of a funding transaction encoded by [`short_channel_id`].
+        * Returns an error if `genesis_hash` is for a different chain or if such a transaction output
+        * is unknown.
+        * 
+        * [`short_channel_id`]: https://github.com/lightningnetwork/lightning-rfc/blob/master/07-routing-gossip.md#definition-of-short_channel_id
+        */
        public Result_TxOutAccessErrorZ get_utxo(byte[] genesis_hash, long short_channel_id) {
                long ret = bindings.Access_get_utxo(this.ptr, genesis_hash, short_channel_id);
+               if (ret >= 0 && ret <= 4096) { return null; }
                Result_TxOutAccessErrorZ ret_hu_conv = Result_TxOutAccessErrorZ.constr_from_ptr(ret);
-               ret_hu_conv.ptrs_to.add(this);
                return ret_hu_conv;
        }