Skip to content

Latest commit

 

History

History
22 lines (15 loc) · 1.22 KB

15.md

File metadata and controls

22 lines (15 loc) · 1.22 KB
Raw

LUD-15: balanceNotify: services hurrying up the withdraw process.

author: fiatjaf author: lafaire discussion: https://t.me/lnurl/9729

balanceNotify

This optional property works together with balanceCheck to make it instant. It works as follows:

  • If LN SERVICE supports balanceCheck, then LN WALLET may decide to send an query-string-encoded HTTP URL along with the payment request when first making a withdrawal.
  • LN SERVICE may store that URL and make a blank HTTP POST call to it the next time the given user has a balance in its account on the service.
  • Upon receiving that HTTP POST, the wallet may decide to perform a balance check and withdraw the funds immediately.
  • The scheme works for custodial wallets, Lightning nodes that that have a domain name and an always-online online presence, and also for noncustodial mobile wallets that have a friendly server online that is able to receive that HTTP POST and notify them somehow.

The callback URL sent by the WALLET is modified as follows:

-<callback><?|&>k1=<k1>&pr=<lightning invoice>
+<callback><?|&>k1=<k1>&pr=<lightning invoice>&balanceNotify=<URL>