LNURL 協議

LNURL 編碼格式：

原始 URL：
https://example.com/api/lnurl?q=abc123

Bech32 編碼後：
LNURL1DP68GURN8GHJ7MRWW4EXCTNXD9SHG6NPVCHXXMMD9AKXUATJDSKHW6T5DPJ8YCTH

特點：
- 使用 bech32 編碼（與比特幣地址相同）
- 人類可讀部分：LNURL
- 內建錯誤檢測
- 不區分大小寫（方便手動輸入）

解碼流程：
1. 識別 LNURL 前綴
2. Bech32 解碼
3. 得到原始 HTTPS URL
4. 錢包請求該 URL

LNURL-pay 流程：

1. 錢包掃描 LNURL
         │
         ▼
2. GET 請求服務端
   GET https://example.com/lnurlp/alice
         │
         ▼
3. 服務返回支付參數
   {
     "callback": "https://example.com/lnurlp/alice/pay",
     "tag": "payRequest",
     "minSendable": 1000,      // 最小 1 sat (毫聰)
     "maxSendable": 100000000, // 最大 100,000 sats
     "metadata": "[["text/plain","Pay to Alice"]]",
     "commentAllowed": 140     // 可選：允許備註
   }
         │
         ▼
4. 用戶選擇金額（如 10,000 sats）
         │
         ▼
5. 錢包請求發票
   GET callback?amount=10000000&comment=Thanks
         │
         ▼
6. 服務返回發票
   {
     "pr": "lnbc100u1p...",  // BOLT 11 發票
     "routes": [],
     "successAction": {      // 可選：支付成功後的動作
       "tag": "message",
       "message": "Thank you!"
     }
   }
         │
         ▼
7. 錢包支付發票

LNURL-withdraw 流程：

1. 掃描提款 LNURL
         │
         ▼
2. GET 請求
   GET https://example.com/lnurlw/voucher123
         │
         ▼
3. 服務返回提款參數
   {
     "callback": "https://example.com/lnurlw/voucher123/claim",
     "tag": "withdrawRequest",
     "k1": "random_challenge",
     "minWithdrawable": 1000,
     "maxWithdrawable": 50000000,
     "defaultDescription": "Withdraw from Example.com"
   }
         │
         ▼
4. 用戶選擇金額
         │
         ▼
5. 錢包生成發票，發送給服務
   GET callback?k1=...&pr=lnbc500u1p...
         │
         ▼
6. 服務支付發票
   {
     "status": "OK"
   }
         │
         ▼
7. 用戶收到款項！

LNURL-auth 流程：

1. 網站顯示 LNURL-auth QR
         │
         ▼
2. GET 請求
   GET https://example.com/lnurlauth?tag=login&k1=challenge
         │
         ▼
3. 錢包解析登入請求
   {
     "tag": "login",
     "k1": "32_byte_random_challenge"
   }
         │
         ▼
4. 錢包派生特定網站的密鑰對
   linkingKey = derivePath(domain, walletSeed)
         │
         ▼
5. 簽名挑戰並發送
   GET callback?sig=signature&key=linkingPubKey
         │
         ▼
6. 服務驗證簽名
   - 驗證 sig 對 k1 有效
   - 記錄 linkingPubKey 為用戶身份
         │
         ▼
7. 登入成功！

安全特性：
- 每個網站有唯一的 linkingKey（隱私保護）
- 不洩露真實的節點公鑰
- 無需密碼，不可釣魚

LNURL-channel 流程：

1. 掃描通道請求 LNURL
         │
         ▼
2. 服務返回通道參數
   {
     "tag": "channelRequest",
     "uri": "nodeId@host:port",
     "callback": "...",
     "k1": "..."
   }
         │
         ▼
3. 錢包連接到服務節點
         │
         ▼
4. 請求開通道
   GET callback?k1=...&remoteid=walletNodeId&private=1
         │
         ▼
5. 服務開設通道給用戶

用途：
- 新用戶快速獲得入站流動性
- 交易所提供通道服務
- LSP 服務

Lightning Address 格式：

地址：[email protected]

解析流程：
1. 錢包識別 Lightning Address 格式
2. 將地址轉換為 LNURL-pay 端點：
   https://example.com/.well-known/lnurlp/alice
3. 後續流程與 LNURL-pay 相同

設置要求：
- 網站需要在 /.well-known/lnurlp/ 路徑
- 提供標準的 LNURL-pay 響應
- 支援 HTTPS

優勢：
- 易於記憶和分享
- 類似電子郵件，用戶熟悉
- 可以印在名片上
- 靜態地址，不需要更換

示例服務：
- Wallet of Satoshi
- Strike
- Alby
- 自建 LNbits

常用工具：

1. LNbits
   - 完整的 LNURL 插件
   - 支援所有子協議
   - https://lnbits.com

2. lnurl-node
   - Node.js 庫
   - 方便集成到現有應用
   - npm install lnurl

3. satdress
   - Lightning Address 服務
   - 自託管
   - https://github.com/fiatjaf/satdress

4. LNDhub + BlueWallet
   - 託管錢包解決方案
   - 支援 LNURL

簡單 LNURL-pay 端點範例（Node.js）：
app.get('/.well-known/lnurlp/:username', (req, res) => {
  res.json({
    callback: `https://${domain}/lnurlp/${req.params.username}/pay`,
    tag: 'payRequest',
    minSendable: 1000,
    maxSendable: 100000000,
    metadata: JSON.stringify([['text/plain', `Pay ${req.params.username}`]])
  });
});