Lightning Address 閃電地址

傳統閃電發票：

lnbc100n1pj9...（很長的字符串）

問題：
├── 難以記憶和分享
├── 每次支付需要新發票
├── 發票有過期時間
└── 需要線上生成

Lightning Address：

[email protected]

優點：
├── 人類可讀，像電子郵件
├── 固定地址，可重複使用
├── 可以印在名片上
└── 接收方可以離線（服務器處理）

類比：
BOLT11 發票 ≈ 銀行轉賬號 + 附言（每次不同）
Lightning Address ≈ PayPal 電子郵件地址（固定）

Lightning Address 協議流程：

地址格式：[email protected]

步驟 1：解析地址
├── 用戶名：user
└── 域名：domain.com

步驟 2：構造 LNURL-pay 端點
https://domain.com/.well-known/lnurlp/user

步驟 3：錢包請求端點
GET https://domain.com/.well-known/lnurlp/user

響應：
{
  "callback": "https://domain.com/api/lnurl/pay/user",
  "maxSendable": 100000000,      // 最大 1 BTC (毫聰)
  "minSendable": 1000,            // 最小 1 sat
  "metadata": "[["text/plain","Payment to user"]]",
  "tag": "payRequest"
}

步驟 4：發送支付請求
GET https://domain.com/api/lnurl/pay/user?amount=10000

響應：
{
  "pr": "lnbc100n1...",          // BOLT11 發票
  "routes": []
}

步驟 5：錢包支付發票
└── 正常的閃電網路支付流程

設置自己的 Lightning Address：

方法 1：靜態重定向（Nginx）

# 將請求轉發到錢包服務
location /.well-known/lnurlp/satoshi {
    return 301 https://getalby.com/.well-known/lnurlp/你的alby用戶名;
}

結果：satoshi@你的域名.com → 你的 Alby 錢包

方法 2：使用 Satdress（自託管代理）

# 配置 satdress.yml
domain: 你的域名.com
users:
  satoshi:
    kind: lnd
    host: 你的lnd:10009
    macaroon: ...

結果：satoshi@你的域名.com → 你的 LND 節點

方法 3：BTCPay Server

1. 在 BTCPay 啟用 Lightning Address
2. 配置用戶名
3. 設置 DNS 或反向代理

結果：用戶名@你的btcpay域名.com

Lightning Address 擴展功能：

1. 評論/備註 (commentAllowed)
{
  "callback": "...",
  "commentAllowed": 140,  // 允許 140 字符評論
  ...
}

發送方可以附加訊息：
?amount=10000&comment=感謝你的精彩內容！

2. 支付者資料 (payerData)
{
  "payerData": {
    "name": { "mandatory": false },
    "email": { "mandatory": false }
  }
}

用於需要知道支付者身份的場景（如購物）

3. 成功動作 (successAction)
支付成功後的響應：
{
  "successAction": {
    "tag": "message",
    "message": "感謝您的支付！"
  }
}

或提供下載鏈接：
{
  "successAction": {
    "tag": "url",
    "description": "下載您購買的內容",
    "url": "https://example.com/download/abc123"
  }
}

4. Nostr 整合 (NIP-57)
Lightning Address 可以與 Nostr 整合：
├── 通過 nostr 欄位指定 Nostr 公鑰
├── 啟用 allowsNostr 標誌
└── 支持 Zaps（Nostr 上的打賞）

// 解析 Lightning Address 並獲取發票

async function payToLightningAddress(address, amountMsats) {
  // 1. 解析地址
  const [user, domain] = address.split('@');

  // 2. 獲取 LNURL-pay 端點
  const response = await fetch(
    `https://${domain}/.well-known/lnurlp/${user}`
  );
  const data = await response.json();

  // 3. 驗證金額範圍
  if (amountMsats < data.minSendable ||
      amountMsats > data.maxSendable) {
    throw new Error('金額超出範圍');
  }

  // 4. 請求發票
  const invoiceResponse = await fetch(
    `${data.callback}?amount=${amountMsats}`
  );
  const invoiceData = await invoiceResponse.json();

  // 5. 返回發票
  return invoiceData.pr;
}

// 使用示例
const invoice = await payToLightningAddress(
  '[email protected]',
  10000  // 10 sats in msats
);
// 然後用錢包支付 invoice

Lightning Address vs BOLT 12 Offers：

Lightning Address (LNURL-pay)：
├── 基於 HTTP/HTTPS
├── 需要域名和 Web 服務器
├── 第三方服務可以代管
├── 已廣泛採用
└── 依賴 DNS 和 TLS

BOLT 12 Offers：
├── 純閃電網路協議
├── 不需要 Web 服務器
├── 使用 Onion Messages 通訊
├── 更去中心化
├── 原生支持重複支付
└── 仍在推廣中

未來可能共存：
├── Lightning Address 用於簡單場景
├── BOLT 12 用於更高級的隱私需求
└── 錢包可能同時支持兩種