X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FBalance.java;h=1e59ef230b68c90633900f79bcde99723b967e49;hb=890e35a4387758c0447aab34166caa579bbf3a08;hp=fb2e5f474552a249fb7b624391fb24d35b48ff4a;hpb=a7653cf8717b1f9df4d3f4c4bd0b1f50f3bbc230;p=ldk-java

diff --git a/src/main/java/org/ldk/structs/Balance.java b/src/main/java/org/ldk/structs/Balance.java
index fb2e5f47..1e59ef23 100644
--- a/src/main/java/org/ldk/structs/Balance.java
+++ b/src/main/java/org/ldk/structs/Balance.java
@@ -4,6 +4,7 @@ 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;
 
 
@@ -32,12 +33,23 @@ public class Balance extends CommonBase {
 		if (raw_val.getClass() == bindings.LDKBalance.ContentiousClaimable.class) {
 			return new ContentiousClaimable(ptr, (bindings.LDKBalance.ContentiousClaimable)raw_val);
 		}
-		if (raw_val.getClass() == bindings.LDKBalance.MaybeClaimableHTLCAwaitingTimeout.class) {
-			return new MaybeClaimableHTLCAwaitingTimeout(ptr, (bindings.LDKBalance.MaybeClaimableHTLCAwaitingTimeout)raw_val);
+		if (raw_val.getClass() == bindings.LDKBalance.MaybeTimeoutClaimableHTLC.class) {
+			return new MaybeTimeoutClaimableHTLC(ptr, (bindings.LDKBalance.MaybeTimeoutClaimableHTLC)raw_val);
+		}
+		if (raw_val.getClass() == bindings.LDKBalance.MaybePreimageClaimableHTLC.class) {
+			return new MaybePreimageClaimableHTLC(ptr, (bindings.LDKBalance.MaybePreimageClaimableHTLC)raw_val);
+		}
+		if (raw_val.getClass() == bindings.LDKBalance.CounterpartyRevokedOutputClaimable.class) {
+			return new CounterpartyRevokedOutputClaimable(ptr, (bindings.LDKBalance.CounterpartyRevokedOutputClaimable)raw_val);
 		}
 		assert false; return null; // Unreachable without extending the (internal) bindings interface
 	}
 
+	/**
+	 * The channel is not yet closed (or the commitment or closing transaction has not yet
+	 * appeared in a block). The given balance is claimable (less on-chain fees) if the channel is
+	 * force-closed now.
+	 */
 	public final static class ClaimableOnChannelClose extends Balance {
 		/**
 		 * The amount available to claim, in satoshis, excluding the on-chain fees which will be
@@ -49,6 +61,10 @@ public class Balance extends CommonBase {
 			this.claimable_amount_satoshis = obj.claimable_amount_satoshis;
 		}
 	}
+	/**
+	 * The channel has been closed, and the given balance is ours but awaiting confirmations until
+	 * we consider it spendable.
+	 */
 	public final static class ClaimableAwaitingConfirmations extends Balance {
 		/**
 		 * The amount available to claim, in satoshis, possibly excluding the on-chain fees which
@@ -66,6 +82,15 @@ public class Balance extends CommonBase {
 			this.confirmation_height = obj.confirmation_height;
 		}
 	}
+	/**
+	 * The channel has been closed, and the given balance should be ours but awaiting spending
+	 * transaction confirmation. If the spending transaction does not confirm in time, it is
+	 * possible our counterparty can take the funds by broadcasting an HTLC timeout on-chain.
+	 * 
+	 * Once the spending transaction confirms, before it has reached enough confirmations to be
+	 * considered safe from chain reorganizations, the balance will instead be provided via
+	 * [`Balance::ClaimableAwaitingConfirmations`].
+	 */
 	public final static class ContentiousClaimable extends Balance {
 		/**
 		 * The amount available to claim, in satoshis, excluding the on-chain fees which will be
@@ -83,10 +108,15 @@ public class Balance extends CommonBase {
 			this.timeout_height = obj.timeout_height;
 		}
 	}
-	public final static class MaybeClaimableHTLCAwaitingTimeout extends Balance {
+	/**
+	 * HTLCs which we sent to our counterparty which are claimable after a timeout (less on-chain
+	 * fees) if the counterparty does not know the preimage for the HTLCs. These are somewhat
+	 * likely to be claimed by our counterparty before we do.
+	 */
+	public final static class MaybeTimeoutClaimableHTLC extends Balance {
 		/**
-		 * The amount available to claim, in satoshis, excluding the on-chain fees which will be
-		 * required to do so.
+		 * The amount potentially available to claim, in satoshis, excluding the on-chain fees
+		 * which will be required to do so.
 		*/
 		public final long claimable_amount_satoshis;
 		/**
@@ -94,20 +124,69 @@ public class Balance extends CommonBase {
 		 * done so.
 		*/
 		public final int claimable_height;
-		private MaybeClaimableHTLCAwaitingTimeout(long ptr, bindings.LDKBalance.MaybeClaimableHTLCAwaitingTimeout obj) {
+		private MaybeTimeoutClaimableHTLC(long ptr, bindings.LDKBalance.MaybeTimeoutClaimableHTLC obj) {
 			super(null, ptr);
 			this.claimable_amount_satoshis = obj.claimable_amount_satoshis;
 			this.claimable_height = obj.claimable_height;
 		}
 	}
+	/**
+	 * HTLCs which we received from our counterparty which are claimable with a preimage which we
+	 * do not currently have. This will only be claimable if we receive the preimage from the node
+	 * to which we forwarded this HTLC before the timeout.
+	 */
+	public final static class MaybePreimageClaimableHTLC extends Balance {
+		/**
+		 * The amount potentially available to claim, in satoshis, excluding the on-chain fees
+		 * which will be required to do so.
+		*/
+		public final long claimable_amount_satoshis;
+		/**
+		 * The height at which our counterparty will be able to claim the balance if we have not
+		 * yet received the preimage and claimed it ourselves.
+		*/
+		public final int expiry_height;
+		private MaybePreimageClaimableHTLC(long ptr, bindings.LDKBalance.MaybePreimageClaimableHTLC obj) {
+			super(null, ptr);
+			this.claimable_amount_satoshis = obj.claimable_amount_satoshis;
+			this.expiry_height = obj.expiry_height;
+		}
+	}
+	/**
+	 * The channel has been closed, and our counterparty broadcasted a revoked commitment
+	 * transaction.
+	 * 
+	 * Thus, we're able to claim all outputs in the commitment transaction, one of which has the
+	 * following amount.
+	 */
+	public final static class CounterpartyRevokedOutputClaimable extends Balance {
+		/**
+		 * The amount, in satoshis, of the output which we can claim.
+		 * 
+		 * Note that for outputs from HTLC balances this may be excluding some on-chain fees that
+		 * were already spent.
+		*/
+		public final long claimable_amount_satoshis;
+		private CounterpartyRevokedOutputClaimable(long ptr, bindings.LDKBalance.CounterpartyRevokedOutputClaimable obj) {
+			super(null, ptr);
+			this.claimable_amount_satoshis = obj.claimable_amount_satoshis;
+		}
+	}
+	long clone_ptr() {
+		long ret = bindings.Balance_clone_ptr(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
 	/**
 	 * Creates a copy of the Balance
 	 */
 	public Balance clone() {
 		long ret = bindings.Balance_clone(this.ptr);
-		if (ret < 1024) { return null; }
-		Balance ret_hu_conv = Balance.constr_from_ptr(ret);
-		ret_hu_conv.ptrs_to.add(this);
+		Reference.reachabilityFence(this);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); };
 		return ret_hu_conv;
 	}
 
@@ -116,9 +195,10 @@ public class Balance extends CommonBase {
 	 */
 	public static Balance claimable_on_channel_close(long claimable_amount_satoshis) {
 		long ret = bindings.Balance_claimable_on_channel_close(claimable_amount_satoshis);
-		if (ret < 1024) { return null; }
-		Balance ret_hu_conv = Balance.constr_from_ptr(ret);
-		ret_hu_conv.ptrs_to.add(ret_hu_conv);
+		Reference.reachabilityFence(claimable_amount_satoshis);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
 		return ret_hu_conv;
 	}
 
@@ -127,9 +207,11 @@ public class Balance extends CommonBase {
 	 */
 	public static Balance claimable_awaiting_confirmations(long claimable_amount_satoshis, int confirmation_height) {
 		long ret = bindings.Balance_claimable_awaiting_confirmations(claimable_amount_satoshis, confirmation_height);
-		if (ret < 1024) { return null; }
-		Balance ret_hu_conv = Balance.constr_from_ptr(ret);
-		ret_hu_conv.ptrs_to.add(ret_hu_conv);
+		Reference.reachabilityFence(claimable_amount_satoshis);
+		Reference.reachabilityFence(confirmation_height);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
 		return ret_hu_conv;
 	}
 
@@ -138,20 +220,49 @@ public class Balance extends CommonBase {
 	 */
 	public static Balance contentious_claimable(long claimable_amount_satoshis, int timeout_height) {
 		long ret = bindings.Balance_contentious_claimable(claimable_amount_satoshis, timeout_height);
-		if (ret < 1024) { return null; }
-		Balance ret_hu_conv = Balance.constr_from_ptr(ret);
-		ret_hu_conv.ptrs_to.add(ret_hu_conv);
+		Reference.reachabilityFence(claimable_amount_satoshis);
+		Reference.reachabilityFence(timeout_height);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
 		return ret_hu_conv;
 	}
 
 	/**
-	 * Utility method to constructs a new MaybeClaimableHTLCAwaitingTimeout-variant Balance
+	 * Utility method to constructs a new MaybeTimeoutClaimableHTLC-variant Balance
 	 */
-	public static Balance maybe_claimable_htlcawaiting_timeout(long claimable_amount_satoshis, int claimable_height) {
-		long ret = bindings.Balance_maybe_claimable_htlcawaiting_timeout(claimable_amount_satoshis, claimable_height);
-		if (ret < 1024) { return null; }
-		Balance ret_hu_conv = Balance.constr_from_ptr(ret);
-		ret_hu_conv.ptrs_to.add(ret_hu_conv);
+	public static Balance maybe_timeout_claimable_htlc(long claimable_amount_satoshis, int claimable_height) {
+		long ret = bindings.Balance_maybe_timeout_claimable_htlc(claimable_amount_satoshis, claimable_height);
+		Reference.reachabilityFence(claimable_amount_satoshis);
+		Reference.reachabilityFence(claimable_height);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
+		return ret_hu_conv;
+	}
+
+	/**
+	 * Utility method to constructs a new MaybePreimageClaimableHTLC-variant Balance
+	 */
+	public static Balance maybe_preimage_claimable_htlc(long claimable_amount_satoshis, int expiry_height) {
+		long ret = bindings.Balance_maybe_preimage_claimable_htlc(claimable_amount_satoshis, expiry_height);
+		Reference.reachabilityFence(claimable_amount_satoshis);
+		Reference.reachabilityFence(expiry_height);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
+		return ret_hu_conv;
+	}
+
+	/**
+	 * Utility method to constructs a new CounterpartyRevokedOutputClaimable-variant Balance
+	 */
+	public static Balance counterparty_revoked_output_claimable(long claimable_amount_satoshis) {
+		long ret = bindings.Balance_counterparty_revoked_output_claimable(claimable_amount_satoshis);
+		Reference.reachabilityFence(claimable_amount_satoshis);
+		if (ret >= 0 && ret <= 4096) { return null; }
+		org.ldk.structs.Balance ret_hu_conv = org.ldk.structs.Balance.constr_from_ptr(ret);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
 		return ret_hu_conv;
 	}
 
@@ -160,9 +271,14 @@ public class Balance extends CommonBase {
 	 * This ignores pointers and is_owned flags and looks at the values in fields.
 	 */
 	public boolean eq(Balance b) {
-		boolean ret = bindings.Balance_eq(this.ptr, b == null ? 0 : b.ptr & ~1);
-		this.ptrs_to.add(b);
+		boolean ret = bindings.Balance_eq(this.ptr, b == null ? 0 : b.ptr);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(b);
 		return ret;
 	}
 
+	@Override public boolean equals(Object o) {
+		if (!(o instanceof Balance)) return false;
+		return this.eq((Balance)o);
+	}
 }