X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FProbabilisticScoringParameters.java;h=30694c53537d3a937665f1eb0c7c1d785b4231e2;hb=300b54d26fe5ed89f472ef821ebf67d56c917e49;hp=96e66ac929b3c9062441c962483271a0aab5ff81;hpb=47341beaeecf907f422f126500baf586d54a0d41;p=ldk-java

diff --git a/src/main/java/org/ldk/structs/ProbabilisticScoringParameters.java b/src/main/java/org/ldk/structs/ProbabilisticScoringParameters.java
index 96e66ac9..30694c53 100644
--- a/src/main/java/org/ldk/structs/ProbabilisticScoringParameters.java
+++ b/src/main/java/org/ldk/structs/ProbabilisticScoringParameters.java
@@ -13,6 +13,9 @@ import javax.annotation.Nullable;
  * 
  * Used to configure base, liquidity, and amount penalties, the sum of which comprises the channel
  * penalty (i.e., the amount in msats willing to be paid to avoid routing through the channel).
+ * 
+ * The penalty applied to any channel by the [`ProbabilisticScorer`] is the sum of each of the
+ * parameters here.
  */
 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
 public class ProbabilisticScoringParameters extends CommonBase {
@@ -45,9 +48,50 @@ public class ProbabilisticScoringParameters extends CommonBase {
 		Reference.reachabilityFence(val);
 	}
 
+	/**
+	 * A multiplier used with the payment amount to calculate a fixed penalty applied to each
+	 * channel, in excess of the [`base_penalty_msat`].
+	 * 
+	 * The purpose of the amount penalty is to avoid having fees dominate the channel cost (i.e.,
+	 * fees plus penalty) for large payments. The penalty is computed as the product of this
+	 * multiplier and `2^30`ths of the payment amount.
+	 * 
+	 * ie `base_penalty_amount_multiplier_msat * amount_msat / 2^30`
+	 * 
+	 * Default value: 8,192 msat
+	 * 
+	 * [`base_penalty_msat`]: Self::base_penalty_msat
+	 */
+	public long get_base_penalty_amount_multiplier_msat() {
+		long ret = bindings.ProbabilisticScoringParameters_get_base_penalty_amount_multiplier_msat(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
+	/**
+	 * A multiplier used with the payment amount to calculate a fixed penalty applied to each
+	 * channel, in excess of the [`base_penalty_msat`].
+	 * 
+	 * The purpose of the amount penalty is to avoid having fees dominate the channel cost (i.e.,
+	 * fees plus penalty) for large payments. The penalty is computed as the product of this
+	 * multiplier and `2^30`ths of the payment amount.
+	 * 
+	 * ie `base_penalty_amount_multiplier_msat * amount_msat / 2^30`
+	 * 
+	 * Default value: 8,192 msat
+	 * 
+	 * [`base_penalty_msat`]: Self::base_penalty_msat
+	 */
+	public void set_base_penalty_amount_multiplier_msat(long val) {
+		bindings.ProbabilisticScoringParameters_set_base_penalty_amount_multiplier_msat(this.ptr, val);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(val);
+	}
+
 	/**
 	 * A multiplier used in conjunction with the negative `log10` of the channel's success
-	 * probability for a payment to determine the liquidity penalty.
+	 * probability for a payment, as determined by our latest estimates of the channel's
+	 * liquidity, to determine the liquidity penalty.
 	 * 
 	 * The penalty is based in part on the knowledge learned from prior successful and unsuccessful
 	 * payments. This knowledge is decayed over time based on [`liquidity_offset_half_life`]. The
@@ -56,7 +100,9 @@ public class ProbabilisticScoringParameters extends CommonBase {
 	 * uncertainty bounds of the channel liquidity balance. Amounts above the upper bound will
 	 * result in a `u64::max_value` penalty, however.
 	 * 
-	 * Default value: 40,000 msat
+	 * `-log10(success_probability) * liquidity_penalty_multiplier_msat`
+	 * 
+	 * Default value: 30,000 msat
 	 * 
 	 * [`liquidity_offset_half_life`]: Self::liquidity_offset_half_life
 	 */
@@ -68,7 +114,8 @@ public class ProbabilisticScoringParameters extends CommonBase {
 
 	/**
 	 * A multiplier used in conjunction with the negative `log10` of the channel's success
-	 * probability for a payment to determine the liquidity penalty.
+	 * probability for a payment, as determined by our latest estimates of the channel's
+	 * liquidity, to determine the liquidity penalty.
 	 * 
 	 * The penalty is based in part on the knowledge learned from prior successful and unsuccessful
 	 * payments. This knowledge is decayed over time based on [`liquidity_offset_half_life`]. The
@@ -77,7 +124,9 @@ public class ProbabilisticScoringParameters extends CommonBase {
 	 * uncertainty bounds of the channel liquidity balance. Amounts above the upper bound will
 	 * result in a `u64::max_value` penalty, however.
 	 * 
-	 * Default value: 40,000 msat
+	 * `-log10(success_probability) * liquidity_penalty_multiplier_msat`
+	 * 
+	 * Default value: 30,000 msat
 	 * 
 	 * [`liquidity_offset_half_life`]: Self::liquidity_offset_half_life
 	 */
@@ -88,14 +137,20 @@ public class ProbabilisticScoringParameters extends CommonBase {
 	}
 
 	/**
-	 * The time required to elapse before any knowledge learned about channel liquidity balances is
-	 * cut in half.
+	 * Whenever this amount of time elapses since the last update to a channel's liquidity bounds,
+	 * the distance from the bounds to \"zero\" is cut in half. In other words, the lower-bound on
+	 * the available liquidity is halved and the upper-bound moves half-way to the channel's total
+	 * capacity.
+	 * 
+	 * Because halving the liquidity bounds grows the uncertainty on the channel's liquidity,
+	 * the penalty for an amount within the new bounds may change. See the [`ProbabilisticScorer`]
+	 * struct documentation for more info on the way the liquidity bounds are used.
 	 * 
-	 * The bounds are defined in terms of offsets and are initially zero. Increasing the offsets
-	 * gives tighter bounds on the channel liquidity balance. Thus, halving the offsets decreases
-	 * the certainty of the channel liquidity balance.
+	 * For example, if the channel's capacity is 1 million sats, and the current upper and lower
+	 * liquidity bounds are 200,000 sats and 600,000 sats, after this amount of time the upper
+	 * and lower liquidity bounds will be decayed to 100,000 and 800,000 sats.
 	 * 
-	 * Default value: 1 hour
+	 * Default value: 6 hours
 	 * 
 	 * # Note
 	 * 
@@ -109,14 +164,20 @@ public class ProbabilisticScoringParameters extends CommonBase {
 	}
 
 	/**
-	 * The time required to elapse before any knowledge learned about channel liquidity balances is
-	 * cut in half.
+	 * Whenever this amount of time elapses since the last update to a channel's liquidity bounds,
+	 * the distance from the bounds to \"zero\" is cut in half. In other words, the lower-bound on
+	 * the available liquidity is halved and the upper-bound moves half-way to the channel's total
+	 * capacity.
 	 * 
-	 * The bounds are defined in terms of offsets and are initially zero. Increasing the offsets
-	 * gives tighter bounds on the channel liquidity balance. Thus, halving the offsets decreases
-	 * the certainty of the channel liquidity balance.
+	 * Because halving the liquidity bounds grows the uncertainty on the channel's liquidity,
+	 * the penalty for an amount within the new bounds may change. See the [`ProbabilisticScorer`]
+	 * struct documentation for more info on the way the liquidity bounds are used.
 	 * 
-	 * Default value: 1 hour
+	 * For example, if the channel's capacity is 1 million sats, and the current upper and lower
+	 * liquidity bounds are 200,000 sats and 600,000 sats, after this amount of time the upper
+	 * and lower liquidity bounds will be decayed to 100,000 and 800,000 sats.
+	 * 
+	 * Default value: 6 hours
 	 * 
 	 * # Note
 	 * 
@@ -131,14 +192,15 @@ public class ProbabilisticScoringParameters extends CommonBase {
 
 	/**
 	 * A multiplier used in conjunction with a payment amount and the negative `log10` of the
-	 * channel's success probability for the payment to determine the amount penalty.
+	 * channel's success probability for the payment, as determined by our latest estimates of the
+	 * channel's liquidity, to determine the amount penalty.
 	 * 
 	 * The purpose of the amount penalty is to avoid having fees dominate the channel cost (i.e.,
 	 * fees plus penalty) for large payments. The penalty is computed as the product of this
 	 * multiplier and `2^20`ths of the payment amount, weighted by the negative `log10` of the
 	 * success probability.
 	 * 
-	 * `-log10(success_probability) * amount_penalty_multiplier_msat * amount_msat / 2^20`
+	 * `-log10(success_probability) * liquidity_penalty_amount_multiplier_msat * amount_msat / 2^20`
 	 * 
 	 * In practice, this means for 0.1 success probability (`-log10(0.1) == 1`) each `2^20`th of
 	 * the amount will result in a penalty of the multiplier. And, as the success probability
@@ -146,24 +208,25 @@ public class ProbabilisticScoringParameters extends CommonBase {
 	 * probabilities, the multiplier will have a decreasing effect as the negative `log10` will
 	 * fall below `1`.
 	 * 
-	 * Default value: 256 msat
+	 * Default value: 192 msat
 	 */
-	public long get_amount_penalty_multiplier_msat() {
-		long ret = bindings.ProbabilisticScoringParameters_get_amount_penalty_multiplier_msat(this.ptr);
+	public long get_liquidity_penalty_amount_multiplier_msat() {
+		long ret = bindings.ProbabilisticScoringParameters_get_liquidity_penalty_amount_multiplier_msat(this.ptr);
 		Reference.reachabilityFence(this);
 		return ret;
 	}
 
 	/**
 	 * A multiplier used in conjunction with a payment amount and the negative `log10` of the
-	 * channel's success probability for the payment to determine the amount penalty.
+	 * channel's success probability for the payment, as determined by our latest estimates of the
+	 * channel's liquidity, to determine the amount penalty.
 	 * 
 	 * The purpose of the amount penalty is to avoid having fees dominate the channel cost (i.e.,
 	 * fees plus penalty) for large payments. The penalty is computed as the product of this
 	 * multiplier and `2^20`ths of the payment amount, weighted by the negative `log10` of the
 	 * success probability.
 	 * 
-	 * `-log10(success_probability) * amount_penalty_multiplier_msat * amount_msat / 2^20`
+	 * `-log10(success_probability) * liquidity_penalty_amount_multiplier_msat * amount_msat / 2^20`
 	 * 
 	 * In practice, this means for 0.1 success probability (`-log10(0.1) == 1`) each `2^20`th of
 	 * the amount will result in a penalty of the multiplier. And, as the success probability
@@ -171,27 +234,218 @@ public class ProbabilisticScoringParameters extends CommonBase {
 	 * probabilities, the multiplier will have a decreasing effect as the negative `log10` will
 	 * fall below `1`.
 	 * 
-	 * Default value: 256 msat
+	 * Default value: 192 msat
+	 */
+	public void set_liquidity_penalty_amount_multiplier_msat(long val) {
+		bindings.ProbabilisticScoringParameters_set_liquidity_penalty_amount_multiplier_msat(this.ptr, val);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(val);
+	}
+
+	/**
+	 * A multiplier used in conjunction with the negative `log10` of the channel's success
+	 * probability for the payment, as determined based on the history of our estimates of the
+	 * channel's available liquidity, to determine a penalty.
+	 * 
+	 * This penalty is similar to [`liquidity_penalty_multiplier_msat`], however, instead of using
+	 * only our latest estimate for the current liquidity available in the channel, it estimates
+	 * success probability based on the estimated liquidity available in the channel through
+	 * history. Specifically, every time we update our liquidity bounds on a given channel, we
+	 * track which of several buckets those bounds fall into, exponentially decaying the
+	 * probability of each bucket as new samples are added.
+	 * 
+	 * Default value: 10,000 msat
+	 * 
+	 * [`liquidity_penalty_multiplier_msat`]: Self::liquidity_penalty_multiplier_msat
 	 */
-	public void set_amount_penalty_multiplier_msat(long val) {
-		bindings.ProbabilisticScoringParameters_set_amount_penalty_multiplier_msat(this.ptr, val);
+	public long get_historical_liquidity_penalty_multiplier_msat() {
+		long ret = bindings.ProbabilisticScoringParameters_get_historical_liquidity_penalty_multiplier_msat(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
+	/**
+	 * A multiplier used in conjunction with the negative `log10` of the channel's success
+	 * probability for the payment, as determined based on the history of our estimates of the
+	 * channel's available liquidity, to determine a penalty.
+	 * 
+	 * This penalty is similar to [`liquidity_penalty_multiplier_msat`], however, instead of using
+	 * only our latest estimate for the current liquidity available in the channel, it estimates
+	 * success probability based on the estimated liquidity available in the channel through
+	 * history. Specifically, every time we update our liquidity bounds on a given channel, we
+	 * track which of several buckets those bounds fall into, exponentially decaying the
+	 * probability of each bucket as new samples are added.
+	 * 
+	 * Default value: 10,000 msat
+	 * 
+	 * [`liquidity_penalty_multiplier_msat`]: Self::liquidity_penalty_multiplier_msat
+	 */
+	public void set_historical_liquidity_penalty_multiplier_msat(long val) {
+		bindings.ProbabilisticScoringParameters_set_historical_liquidity_penalty_multiplier_msat(this.ptr, val);
 		Reference.reachabilityFence(this);
 		Reference.reachabilityFence(val);
 	}
 
 	/**
-	 * Constructs a new ProbabilisticScoringParameters given each field
+	 * A multiplier used in conjunction with the payment amount and the negative `log10` of the
+	 * channel's success probability for the payment, as determined based on the history of our
+	 * estimates of the channel's available liquidity, to determine a penalty.
+	 * 
+	 * The purpose of the amount penalty is to avoid having fees dominate the channel cost for
+	 * large payments. The penalty is computed as the product of this multiplier and the `2^20`ths
+	 * of the payment amount, weighted by the negative `log10` of the success probability.
+	 * 
+	 * This penalty is similar to [`liquidity_penalty_amount_multiplier_msat`], however, instead
+	 * of using only our latest estimate for the current liquidity available in the channel, it
+	 * estimates success probability based on the estimated liquidity available in the channel
+	 * through history. Specifically, every time we update our liquidity bounds on a given
+	 * channel, we track which of several buckets those bounds fall into, exponentially decaying
+	 * the probability of each bucket as new samples are added.
+	 * 
+	 * Default value: 64 msat
+	 * 
+	 * [`liquidity_penalty_amount_multiplier_msat`]: Self::liquidity_penalty_amount_multiplier_msat
 	 */
-	public static ProbabilisticScoringParameters of(long base_penalty_msat_arg, long liquidity_penalty_multiplier_msat_arg, long liquidity_offset_half_life_arg, long amount_penalty_multiplier_msat_arg) {
-		long ret = bindings.ProbabilisticScoringParameters_new(base_penalty_msat_arg, liquidity_penalty_multiplier_msat_arg, liquidity_offset_half_life_arg, amount_penalty_multiplier_msat_arg);
-		Reference.reachabilityFence(base_penalty_msat_arg);
-		Reference.reachabilityFence(liquidity_penalty_multiplier_msat_arg);
-		Reference.reachabilityFence(liquidity_offset_half_life_arg);
-		Reference.reachabilityFence(amount_penalty_multiplier_msat_arg);
-		if (ret >= 0 && ret <= 4096) { return null; }
-		org.ldk.structs.ProbabilisticScoringParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.ProbabilisticScoringParameters(null, ret); }
-		ret_hu_conv.ptrs_to.add(ret_hu_conv);
-		return ret_hu_conv;
+	public long get_historical_liquidity_penalty_amount_multiplier_msat() {
+		long ret = bindings.ProbabilisticScoringParameters_get_historical_liquidity_penalty_amount_multiplier_msat(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
+	/**
+	 * A multiplier used in conjunction with the payment amount and the negative `log10` of the
+	 * channel's success probability for the payment, as determined based on the history of our
+	 * estimates of the channel's available liquidity, to determine a penalty.
+	 * 
+	 * The purpose of the amount penalty is to avoid having fees dominate the channel cost for
+	 * large payments. The penalty is computed as the product of this multiplier and the `2^20`ths
+	 * of the payment amount, weighted by the negative `log10` of the success probability.
+	 * 
+	 * This penalty is similar to [`liquidity_penalty_amount_multiplier_msat`], however, instead
+	 * of using only our latest estimate for the current liquidity available in the channel, it
+	 * estimates success probability based on the estimated liquidity available in the channel
+	 * through history. Specifically, every time we update our liquidity bounds on a given
+	 * channel, we track which of several buckets those bounds fall into, exponentially decaying
+	 * the probability of each bucket as new samples are added.
+	 * 
+	 * Default value: 64 msat
+	 * 
+	 * [`liquidity_penalty_amount_multiplier_msat`]: Self::liquidity_penalty_amount_multiplier_msat
+	 */
+	public void set_historical_liquidity_penalty_amount_multiplier_msat(long val) {
+		bindings.ProbabilisticScoringParameters_set_historical_liquidity_penalty_amount_multiplier_msat(this.ptr, val);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(val);
+	}
+
+	/**
+	 * If we aren't learning any new datapoints for a channel, the historical liquidity bounds
+	 * tracking can simply live on with increasingly stale data. Instead, when a channel has not
+	 * seen a liquidity estimate update for this amount of time, the historical datapoints are
+	 * decayed by half.
+	 * 
+	 * Note that after 16 or more half lives all historical data will be completely gone.
+	 * 
+	 * Default value: 14 days
+	 */
+	public long get_historical_no_updates_half_life() {
+		long ret = bindings.ProbabilisticScoringParameters_get_historical_no_updates_half_life(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
+	/**
+	 * If we aren't learning any new datapoints for a channel, the historical liquidity bounds
+	 * tracking can simply live on with increasingly stale data. Instead, when a channel has not
+	 * seen a liquidity estimate update for this amount of time, the historical datapoints are
+	 * decayed by half.
+	 * 
+	 * Note that after 16 or more half lives all historical data will be completely gone.
+	 * 
+	 * Default value: 14 days
+	 */
+	public void set_historical_no_updates_half_life(long val) {
+		bindings.ProbabilisticScoringParameters_set_historical_no_updates_half_life(this.ptr, val);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(val);
+	}
+
+	/**
+	 * This penalty is applied when `htlc_maximum_msat` is equal to or larger than half of the
+	 * channel's capacity, which makes us prefer nodes with a smaller `htlc_maximum_msat`. We
+	 * treat such nodes preferentially as this makes balance discovery attacks harder to execute,
+	 * thereby creating an incentive to restrict `htlc_maximum_msat` and improve privacy.
+	 * 
+	 * Default value: 250 msat
+	 */
+	public long get_anti_probing_penalty_msat() {
+		long ret = bindings.ProbabilisticScoringParameters_get_anti_probing_penalty_msat(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
+	/**
+	 * This penalty is applied when `htlc_maximum_msat` is equal to or larger than half of the
+	 * channel's capacity, which makes us prefer nodes with a smaller `htlc_maximum_msat`. We
+	 * treat such nodes preferentially as this makes balance discovery attacks harder to execute,
+	 * thereby creating an incentive to restrict `htlc_maximum_msat` and improve privacy.
+	 * 
+	 * Default value: 250 msat
+	 */
+	public void set_anti_probing_penalty_msat(long val) {
+		bindings.ProbabilisticScoringParameters_set_anti_probing_penalty_msat(this.ptr, val);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(val);
+	}
+
+	/**
+	 * This penalty is applied when the amount we're attempting to send over a channel exceeds our
+	 * current estimate of the channel's available liquidity.
+	 * 
+	 * Note that in this case all other penalties, including the
+	 * [`liquidity_penalty_multiplier_msat`] and [`liquidity_penalty_amount_multiplier_msat`]-based
+	 * penalties, as well as the [`base_penalty_msat`] and the [`anti_probing_penalty_msat`], if
+	 * applicable, are still included in the overall penalty.
+	 * 
+	 * If you wish to avoid creating paths with such channels entirely, setting this to a value of
+	 * `u64::max_value()` will guarantee that.
+	 * 
+	 * Default value: 1_0000_0000_000 msat (1 Bitcoin)
+	 * 
+	 * [`liquidity_penalty_multiplier_msat`]: Self::liquidity_penalty_multiplier_msat
+	 * [`liquidity_penalty_amount_multiplier_msat`]: Self::liquidity_penalty_amount_multiplier_msat
+	 * [`base_penalty_msat`]: Self::base_penalty_msat
+	 * [`anti_probing_penalty_msat`]: Self::anti_probing_penalty_msat
+	 */
+	public long get_considered_impossible_penalty_msat() {
+		long ret = bindings.ProbabilisticScoringParameters_get_considered_impossible_penalty_msat(this.ptr);
+		Reference.reachabilityFence(this);
+		return ret;
+	}
+
+	/**
+	 * This penalty is applied when the amount we're attempting to send over a channel exceeds our
+	 * current estimate of the channel's available liquidity.
+	 * 
+	 * Note that in this case all other penalties, including the
+	 * [`liquidity_penalty_multiplier_msat`] and [`liquidity_penalty_amount_multiplier_msat`]-based
+	 * penalties, as well as the [`base_penalty_msat`] and the [`anti_probing_penalty_msat`], if
+	 * applicable, are still included in the overall penalty.
+	 * 
+	 * If you wish to avoid creating paths with such channels entirely, setting this to a value of
+	 * `u64::max_value()` will guarantee that.
+	 * 
+	 * Default value: 1_0000_0000_000 msat (1 Bitcoin)
+	 * 
+	 * [`liquidity_penalty_multiplier_msat`]: Self::liquidity_penalty_multiplier_msat
+	 * [`liquidity_penalty_amount_multiplier_msat`]: Self::liquidity_penalty_amount_multiplier_msat
+	 * [`base_penalty_msat`]: Self::base_penalty_msat
+	 * [`anti_probing_penalty_msat`]: Self::anti_probing_penalty_msat
+	 */
+	public void set_considered_impossible_penalty_msat(long val) {
+		bindings.ProbabilisticScoringParameters_set_considered_impossible_penalty_msat(this.ptr, val);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(val);
 	}
 
 	long clone_ptr() {
@@ -208,10 +462,21 @@ public class ProbabilisticScoringParameters extends CommonBase {
 		Reference.reachabilityFence(this);
 		if (ret >= 0 && ret <= 4096) { return null; }
 		org.ldk.structs.ProbabilisticScoringParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.ProbabilisticScoringParameters(null, ret); }
-		ret_hu_conv.ptrs_to.add(this);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); };
 		return ret_hu_conv;
 	}
 
+	/**
+	 * Marks all nodes in the given list as banned, i.e.,
+	 * they will be avoided during path finding.
+	 */
+	public void add_banned_from_list(NodeId[] node_ids) {
+		bindings.ProbabilisticScoringParameters_add_banned_from_list(this.ptr, node_ids != null ? Arrays.stream(node_ids).mapToLong(node_ids_conv_8 -> node_ids_conv_8 == null ? 0 : node_ids_conv_8.ptr).toArray() : null);
+		Reference.reachabilityFence(this);
+		Reference.reachabilityFence(node_ids);
+		for (NodeId node_ids_conv_8: node_ids) { if (this != null) { this.ptrs_to.add(node_ids_conv_8); }; };
+	}
+
 	/**
 	 * Creates a "default" ProbabilisticScoringParameters. See struct and individual field documentaiton for details on which values are used.
 	 */
@@ -219,7 +484,7 @@ public class ProbabilisticScoringParameters extends CommonBase {
 		long ret = bindings.ProbabilisticScoringParameters_default();
 		if (ret >= 0 && ret <= 4096) { return null; }
 		org.ldk.structs.ProbabilisticScoringParameters ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.ProbabilisticScoringParameters(null, ret); }
-		ret_hu_conv.ptrs_to.add(ret_hu_conv);
+		if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
 		return ret_hu_conv;
 	}