]> git.bitcoin.ninja Git - rust-lightning/commitdiff
Comments updated for PaymentReceived 2018-10-221-whitespace
authorYuntai Kyong <yuntai.kyong@gmail.com>
Thu, 25 Oct 2018 22:35:09 +0000 (07:35 +0900)
committerMatt Corallo <git@bluematt.me>
Fri, 26 Oct 2018 00:15:21 +0000 (20:15 -0400)
src/util/events.rs

index e11e4e82c1ccbf2b735c804ab288c4ea215bc13e..ccfe0f8ac1527795aa157c5d6163f54c506110be 100644 (file)
@@ -50,8 +50,11 @@ pub enum Event {
        },
        /// Indicates we've received money! Just gotta dig out that payment preimage and feed it to
        /// ChannelManager::claim_funds to get it....
-       /// Note that if the preimage is not known, you must call ChannelManager::fail_htlc_backwards
-       /// to free up resources for this HTLC.
+       /// Note that if the preimage is not known or the amount paid is incorrect, you must call
+       /// ChannelManager::fail_htlc_backwards with PaymentFailReason::PreimageUnknown or
+       /// PaymentFailReason::AmountMismatch, respectively, to free up resources for this HTLC.
+       /// The amount paid should be considered 'incorrect' when it is less than or more than twice
+       /// the amount expected.
        PaymentReceived {
                /// The hash for which the preimage should be handed to the ChannelManager.
                payment_hash: [u8; 32],