From cfd6dc4f7807f92fe1a19f8e1c5258064c9253d0 Mon Sep 17 00:00:00 2001
From: Johns Beharry <johns@peakshift.com>
Date: Tue, 27 Oct 2020 02:23:52 +0300
Subject: [PATCH] docs(lightning): gather use cases for lnurl

---
 lightning/lnurl.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 lightning/lnurl.md

diff --git a/lightning/lnurl.md b/lightning/lnurl.md
new file mode 100644
index 0000000..e651d0b
--- /dev/null
+++ b/lightning/lnurl.md
@@ -0,0 +1,29 @@
+# LNURL
+
+- [ ] research AMP payments
+- [ ] https://medium.com/breez-technology/introducing-lightning-service-providers-fe9fb1665d5f
+
+## Components
+
+- lnurl-pay
+- lnurl-withdraw
+- lnurl-auth
+
+## Use Case
+
+lnurl-pay as an standard for online services to interact with each other automatically.
+
+```mermaid
+sequenceDiagram
+    User->>Lottery: Deposits Money (lnurl-pay)
+    Lottery-->>User: 💰 You won the prize!!
+    User->>Lottery: Where's my money?
+    User->>Custodial Storage: Secure my 💰
+    Note over User, Custodial Storage: Here's the lnurl-withdraw to call
+    Custodial Storage-->>Lottery: (lnurl-withdraw)
+    Note over User, Custodial Storage: Don't want to forget my funds in the Lottery
+    Custodial Storage-->>Phone Top Up: 10% (I make lots of calls)
+    Custodial Storage-->>OnChain: 20% to HODL
+```
+
+— credit fiatjaf
\ No newline at end of file