X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FAccess.java;h=47f0c93667197bef58cd6ebd3fea387743901869;hb=c6bac88847b7c09560af81f00ba8dd3c2ebe3a19;hp=7a9b89c03bc057e0ce8591b64b6b536a7ef48a41;hpb=b2b0222f51397c5d7e0b3bf0cad6439edde3c1f3;p=ldk-java

diff --git a/src/main/java/org/ldk/structs/Access.java b/src/main/java/org/ldk/structs/Access.java
index 7a9b89c0..47f0c936 100644
--- a/src/main/java/org/ldk/structs/Access.java
+++ b/src/main/java/org/ldk/structs/Access.java
@@ -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,6 +25,13 @@ 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);
 	}
 	private static class LDKAccessHolder { Access held; }
@@ -29,16 +41,22 @@ public class Access extends CommonBase {
 			@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;
 	}