Improve `Route::get_total_amount` docs
authorElias Rohrer <dev@tnull.de>
Wed, 6 Sep 2023 09:26:13 +0000 (11:26 +0200)
committerElias Rohrer <dev@tnull.de>
Wed, 6 Sep 2023 17:35:39 +0000 (19:35 +0200)
lightning/src/routing/router.rs

index 10bdd69b51a9b4a66e14ace4278645da4ada4be4..9c5fe8e1f9bd3dab59033644591a4a59b49d173b 100644 (file)
@@ -359,8 +359,12 @@ impl Route {
                overpaid_value_msat + self.paths.iter().map(|path| path.fee_msat()).sum::<u64>()
        }
 
-       /// Returns the total amount paid on this [`Route`], excluding the fees. Might be more than
-       /// requested if we had to reach htlc_minimum_msat.
+       /// Returns the total amount paid on this [`Route`], excluding the fees.
+       ///
+       /// Might be more than requested as part of the given [`RouteParameters::final_value_msat`] if
+       /// we had to reach the [`htlc_minimum_msat`] limits.
+       ///
+       /// [`htlc_minimum_msat`]: https://github.com/lightning/bolts/blob/master/07-routing-gossip.md#the-channel_update-message
        pub fn get_total_amount(&self) -> u64 {
                self.paths.iter().map(|path| path.final_value_msat()).sum()
        }