Class Event.PaymentReceived

  • Enclosing class:
    Event

    public static final class Event.PaymentReceived
    extends Event
    Indicates we've received (an offer of) 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 should call [`ChannelManager::fail_htlc_backwards`] to free up resources for this HTLC and avoid network congestion. If you fail to call either [`ChannelManager::claim_funds`] or [`ChannelManager::fail_htlc_backwards`] within the HTLC's timeout, the HTLC will be automatically failed. # Note LDK will not stop an inbound payment from being paid multiple times, so multiple `PaymentReceived` events may be generated for the same payment. [`ChannelManager::claim_funds`]: crate::ln::channelmanager::ChannelManager::claim_funds [`ChannelManager::fail_htlc_backwards`]: crate::ln::channelmanager::ChannelManager::fail_htlc_backwards
    • Field Detail

      • payment_hash

        public final byte[] payment_hash
        The hash for which the preimage should be handed to the ChannelManager. Note that LDK will not stop you from registering duplicate payment hashes for inbound payments.
      • amount_msat

        public final long amount_msat
        The value, in thousandths of a satoshi, that this payment is for.
      • purpose

        public final PaymentPurpose purpose
        Information for claiming this received payment, based on whether the purpose of the payment is to pay an invoice or to send a spontaneous payment.