NIP-57 Zaps

1. 發送方請求 Zap
   └─> 客戶端從收款方的 kind 0 取得 lud16（Lightning Address）

2. 取得發票
   └─> 向 LNURL 伺服器發送 Zap 請求（含 nostr 參數）
   └─> 伺服器回傳 BOLT11 發票

3. 支付發票
   └─> 發送方用閃電錢包支付

4. 產生 Zap 收據
   └─> LNURL 伺服器收到款項後
   └─> 發布 kind 9735 事件到 Nostr

5. 客戶端顯示
   └─> 訂閱者看到 Zap 收據並顯示

{
  "kind": 9734,
  "content": "Great post! ⚡",  // 可選的 Zap 訊息
  "tags": [
    ["p", "<收款方 pubkey>"],
    ["e", "<被 Zap 的事件 id>"],  // 可選
    ["amount", "21000"],          // 金額（毫聰）
    ["relays", "wss://relay1.com", "wss://relay2.com"],
    ["lnurl", "lnurl1..."]        // 原始 LNURL
  ],
  "pubkey": "<發送方 pubkey>",
  "created_at": 1234567890,
  "id": "...",
  "sig": "..."
}

{
  "kind": 9735,
  "content": "",
  "tags": [
    ["p", "<收款方 pubkey>"],
    ["P", "<發送方 pubkey>"],     // 大寫 P
    ["e", "<被 Zap 的事件 id>"],  // 可選
    ["bolt11", "lnbc210n1..."],   // BOLT11 發票
    ["description", "{...}"],     // 原始 zap request JSON
    ["preimage", "..."]           // 付款 preimage
  ],
  "pubkey": "<LNURL 伺服器 pubkey>",  // 注意：非發送方
  "created_at": 1234567890,
  "id": "...",
  "sig": "..."
}

// 在 kind 0 (metadata) 中設定
{
  "kind": 0,
  "content": JSON.stringify({
    "name": "Alice",
    "lud16": "[email protected]",  // Lightning Address
    // 或者使用 LNURL
    "lud06": "lnurl1..."
  }),
  "tags": [],
  ...
}

// LNURL-pay 回應必須包含
{
  "callback": "https://...",
  "minSendable": 1000,
  "maxSendable": 100000000,
  "nostrPubkey": "<伺服器用於簽署 zap receipt 的 pubkey>",
  "allowsNostr": true  // 關鍵！表示支援 NIP-57
}

import { nip57 } from 'nostr-tools'

async function sendZap({
  recipientPubkey,
  eventId,          // 可選：Zap 的事件
  amount,           // 毫聰
  comment,          // Zap 訊息
  relays,
  lightningAddress  // 如 [email protected]
}) {
  // 1. 取得 LNURL 資訊
  const lnurlData = await fetch(
    `https://${lightningAddress.split('@')[1]}/.well-known/lnurlp/${lightningAddress.split('@')[0]}`
  ).then(r => r.json())

  // 2. 檢查是否支援 Zaps
  if (!lnurlData.allowsNostr) {
    throw new Error('此 Lightning Address 不支援 Zaps')
  }

  // 3. 建立 Zap 請求
  const zapRequest = nip57.makeZapRequest({
    profile: recipientPubkey,
    event: eventId,
    amount: amount,
    comment: comment,
    relays: relays
  })

  // 4. 簽署 Zap 請求
  const signedZapRequest = await window.nostr.signEvent(zapRequest)

  // 5. 請求發票
  const callbackUrl = new URL(lnurlData.callback)
  callbackUrl.searchParams.set('amount', amount.toString())
  callbackUrl.searchParams.set('nostr', JSON.stringify(signedZapRequest))

  const invoiceResponse = await fetch(callbackUrl).then(r => r.json())

  // 6. 支付發票（使用 WebLN 或其他方式）
  if (window.webln) {
    await window.webln.sendPayment(invoiceResponse.pr)
    console.log('Zap 發送成功！')
  } else {
    // 返回發票讓用戶手動支付
    return invoiceResponse.pr
  }
}

import { nip57, verifyEvent } from 'nostr-tools'

function validateZapReceipt(zapReceipt, expectedLnurlPubkey) {
  // 1. 驗證簽名
  if (!verifyEvent(zapReceipt)) {
    return { valid: false, error: '簽名無效' }
  }

  // 2. 驗證發布者是 LNURL 伺服器
  if (zapReceipt.pubkey !== expectedLnurlPubkey) {
    return { valid: false, error: 'pubkey 不匹配' }
  }

  // 3. 解析 description（原始 zap request）
  const descriptionTag = zapReceipt.tags.find(t => t[0] === 'description')
  if (!descriptionTag) {
    return { valid: false, error: '缺少 description' }
  }

  const zapRequest = JSON.parse(descriptionTag[1])

  // 4. 驗證 zap request 簽名
  if (!verifyEvent(zapRequest)) {
    return { valid: false, error: 'zap request 簽名無效' }
  }

  // 5. 驗證金額匹配
  const bolt11Tag = zapReceipt.tags.find(t => t[0] === 'bolt11')
  const amountTag = zapRequest.tags.find(t => t[0] === 'amount')
  // 解析 bolt11 並比對金額...

  return {
    valid: true,
    sender: zapRequest.pubkey,
    recipient: zapReceipt.tags.find(t => t[0] === 'p')?.[1],
    amount: amountTag?.[1],
    comment: zapRequest.content
  }
}

// 訂閱收到的 Zaps
function subscribeToMyZaps(relay, myPubkey) {
  return relay.subscribe([{
    kinds: [9735],
    '#p': [myPubkey],  // 我是收款方
    since: Math.floor(Date.now() / 1000) - 86400  // 過去 24 小時
  }], {
    onevent(event) {
      const descTag = event.tags.find(t => t[0] === 'description')
      const zapRequest = JSON.parse(descTag[1])

      console.log(`收到 Zap！`)
      console.log(`發送者: ${zapRequest.pubkey}`)
      console.log(`訊息: ${zapRequest.content}`)
    }
  })
}

// 訂閱特定貼文的 Zaps
function subscribeToPostZaps(relay, eventId) {
  return relay.subscribe([{
    kinds: [9735],
    '#e': [eventId]
  }], {
    onevent(event) {
      console.log('此貼文收到一個 Zap')
    }
  })
}

// 計算總 Zap 金額
async function getTotalZaps(relay, eventId) {
  const zaps = await new Promise(resolve => {
    const results = []
    const sub = relay.subscribe([{
      kinds: [9735],
      '#e': [eventId]
    }])
    sub.on('event', e => results.push(e))
    sub.on('eose', () => {
      sub.close()
      resolve(results)
    })
  })

  let total = 0
  for (const zap of zaps) {
    const descTag = zap.tags.find(t => t[0] === 'description')
    const zapRequest = JSON.parse(descTag[1])
    const amountTag = zapRequest.tags.find(t => t[0] === 'amount')
    if (amountTag) {
      total += parseInt(amountTag[1])
    }
  }

  return total  // 毫聰
}

// 匿名 Zap：使用一次性密鑰對簽署 zap request
import { generateSecretKey, getPublicKey } from 'nostr-tools'

function createAnonymousZapRequest(params) {
  // 產生一次性密鑰對
  const anonPrivkey = generateSecretKey()
  const anonPubkey = getPublicKey(anonPrivkey)

  const zapRequest = {
    kind: 9734,
    pubkey: anonPubkey,  // 使用一次性公鑰
    content: params.comment || '',
    tags: [
      ['p', params.recipientPubkey],
      ['amount', params.amount.toString()],
      ['relays', ...params.relays],
      ['anon', '']  // 標記為匿名
    ],
    created_at: Math.floor(Date.now() / 1000)
  }

  // 用一次性私鑰簽署
  return signEvent(zapRequest, anonPrivkey)
}

// 檢查 Zap 是否匿名
function isAnonymousZap(zapReceipt) {
  const descTag = zapReceipt.tags.find(t => t[0] === 'description')
  const zapRequest = JSON.parse(descTag[1])
  return zapRequest.tags.some(t => t[0] === 'anon')
}