[Java] Update auto-generated bindings to 0.0.115
[ldk-java] / src / main / java / org / ldk / structs / RouteHop.java
index 46b749c1714623c3f172a60c3f2db450ac134080..f48bc6c8888a02877ecc592d3a30cf6b66e72488 100644 (file)
@@ -9,7 +9,8 @@ import javax.annotation.Nullable;
 
 
 /**
- * A hop in a route
+ * A hop in a route, and additional metadata about it. \"Hop\" is defined as a node and the channel
+ * that leads to it.
  */
 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
 public class RouteHop extends CommonBase {
@@ -106,8 +107,11 @@ public class RouteHop extends CommonBase {
 
        /**
         * The fee taken on this hop (for paying for the use of the *next* channel in the path).
-        * For the last hop, this should be the full value of the payment (might be more than
-        * requested if we had to match htlc_minimum_msat).
+        * If this is the last hop in [`Path::hops`]:
+        * if we're sending to a [`BlindedPath`], this is the fee paid for use of the entire blinded path
+        * otherwise, this is the full value of this [`Path`]'s part of the payment
+        * 
+        * [`BlindedPath`]: crate::blinded_path::BlindedPath
         */
        public long get_fee_msat() {
                long ret = bindings.RouteHop_get_fee_msat(this.ptr);
@@ -117,8 +121,11 @@ public class RouteHop extends CommonBase {
 
        /**
         * The fee taken on this hop (for paying for the use of the *next* channel in the path).
-        * For the last hop, this should be the full value of the payment (might be more than
-        * requested if we had to match htlc_minimum_msat).
+        * If this is the last hop in [`Path::hops`]:
+        * if we're sending to a [`BlindedPath`], this is the fee paid for use of the entire blinded path
+        * otherwise, this is the full value of this [`Path`]'s part of the payment
+        * 
+        * [`BlindedPath`]: crate::blinded_path::BlindedPath
         */
        public void set_fee_msat(long val) {
                bindings.RouteHop_set_fee_msat(this.ptr, val);
@@ -127,8 +134,12 @@ public class RouteHop extends CommonBase {
        }
 
        /**
-        * The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
-        * expected at the destination, in excess of the current block height.
+        * The CLTV delta added for this hop.
+        * If this is the last hop in [`Path::hops`]:
+        * if we're sending to a [`BlindedPath`], this is the CLTV delta for the entire blinded path
+        * otherwise, this is the CLTV delta expected at the destination
+        * 
+        * [`BlindedPath`]: crate::blinded_path::BlindedPath
         */
        public int get_cltv_expiry_delta() {
                int ret = bindings.RouteHop_get_cltv_expiry_delta(this.ptr);
@@ -137,8 +148,12 @@ public class RouteHop extends CommonBase {
        }
 
        /**
-        * The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
-        * expected at the destination, in excess of the current block height.
+        * The CLTV delta added for this hop.
+        * If this is the last hop in [`Path::hops`]:
+        * if we're sending to a [`BlindedPath`], this is the CLTV delta for the entire blinded path
+        * otherwise, this is the CLTV delta expected at the destination
+        * 
+        * [`BlindedPath`]: crate::blinded_path::BlindedPath
         */
        public void set_cltv_expiry_delta(int val) {
                bindings.RouteHop_set_cltv_expiry_delta(this.ptr, val);
@@ -184,7 +199,7 @@ public class RouteHop extends CommonBase {
        }
 
        /**
-        * Checks if two RouteHops contain equal inner contents.
+        * Generates a non-cryptographic 64-bit hash of the RouteHop.
         */
        public long hash() {
                long ret = bindings.RouteHop_hash(this.ptr);