Async Payments

[valentinewallace]

Async-receive:

• Support being the async receiver’s channel counterparty (eg LSP) per the spec PR
  • Support store-and-forward mailbox for onion messages Onion Message Mailbox #2950
  • Notify sender via OM when receiver comes online
• Support being the always-online (for now) sender
  • Notify the receiver that an HTLC is being held for them Support paying static invoices #3140
  • Send HTLC when notified by the receiver Support paying static invoices #3140, Include invoice requests in async payment onions #3207
  • Support manual handling for static invoices
  • Time out async payments prior to invoice expiry (cc Support paying static invoices #3140 (comment))
  • Don't take() invoice requests on retry (cc Support paying static invoices #3140 (comment)): Add static invoice creation utils to ChannelManager #3408
• Support being the async receiver
  • Support receiving keysend payments to blinded paths Support keysend to blinded paths #2935, Verify blinded keysend PaymentSecrets #2956, Verify blinded keysend payments #3383
  • Support creating a AP BOLT12 offer + keysend invoice that signals that the recipient is often-offline + their LSP’s contact info Add static invoice creation utils to ChannelManager #3408
  • Support receiving async payments to static invoices Async receive prefactor  #3517, Support receiving async payments #3440
  • Spec the above Support async payments in BOLT 12 lightning/bolts#1149
    • Update the spec for static invoices having a different default relative expiry than non-static
  • Authenticate async payment blinded payment paths, cc Add static invoice creation utils to ChannelManager #3408 (comment): fixed in Authenticate blinded payment paths #3435
  • Time out held_htlc_available OM paths, cc Add static invoice creation utils to ChannelManager #3408 (comment)
• Fuzz StaticInvoice message

Async-send:

• Trampoline Trampoline #2299
• Router for LSP clients that routes to LSP node as the direct Trampoline hop
• Parse AP BOLT12 invoices
• Support sending an async HTLC and corresponding OM
• Support retrying the OM or spec out+implement an ACK OM
• Generate event when an async payment is pending (see Support paying static invoices #3140 (comment))
• Add RecentPaymentDetails variant for async payments (see Support paying static invoices #3140 (comment))
• Support shortening the HTLC’s CLTV at sending-time

[TheBlueMatt]

Also #3140 (comment) and #3140 (comment)