NIP-05 域名驗證

NIP-05 驗證流程：

用戶 NIP-05: [email protected]

1. 客戶端解析識別符
   name = "alice"
   domain = "example.com"

2. 查詢驗證端點
   GET https://example.com/.well-known/nostr.json?name=alice

3. 伺服器回應
   {
     "names": {
       "alice": "abc123..."  // 公鑰（十六進制）
     },
     "relays": {
       "abc123...": ["wss://relay1.com", "wss://relay2.com"]
     }
   }

4. 客戶端驗證
   - 檢查回應中的公鑰是否匹配
   - 如果匹配，顯示驗證標記 ✓

5. 可選：使用推薦的中繼器
   - relays 欄位提供該用戶偏好的中繼器

在你的網站設定 NIP-05：

1. 創建檔案
   路徑: /.well-known/nostr.json

2. 檔案內容
   {
     "names": {
       "alice": "你的公鑰十六進制",
       "_": "根域名用戶的公鑰"  // 可選：@example.com
     },
     "relays": {
       "你的公鑰": [
         "wss://relay.damus.io",
         "wss://nos.lol"
       ]
     }
   }

3. 設定 CORS
   Access-Control-Allow-Origin: *

4. 設定 Content-Type
   Content-Type: application/json

Nginx 配置範例:
location /.well-known/nostr.json {
    add_header 'Access-Control-Allow-Origin' '*';
    add_header 'Content-Type' 'application/json';
}

使用伺服器端腳本動態生成：

Node.js / Express 範例:
app.get('/.well-known/nostr.json', (req, res) => {
  const name = req.query.name;

  // 從資料庫查詢
  const user = db.getUserByName(name);

  if (!user) {
    return res.status(404).json({ error: 'Not found' });
  }

  res.set('Access-Control-Allow-Origin', '*');
  res.json({
    names: {
      [name]: user.pubkey
    },
    relays: {
      [user.pubkey]: user.relays
    }
  });
});

優點：
- 支援多用戶
- 可以動態更新
- 可以加入驗證邏輯

在個人資料中設定 NIP-05：

更新 kind:0 (Metadata) 事件：
{
  "kind": 0,
  "content": JSON.stringify({
    "name": "Alice",
    "about": "Just a Nostr user",
    "picture": "https://example.com/avatar.jpg",
    "nip05": "[email protected]"  // 添加 NIP-05
  })
}

客戶端行為：
1. 讀取用戶的 kind:0 事件
2. 解析 nip05 欄位
3. 向域名發送驗證請求
4. 比對回應中的公鑰
5. 顯示驗證狀態

驗證結果：
✓ 驗證成功 - 顯示綠色勾號
✗ 驗證失敗 - 不顯示或顯示警告
? 無法驗證 - 域名無法連接

JavaScript 驗證實現：

async function verifyNip05(nip05, expectedPubkey) {
  // 解析識別符
  const [name, domain] = nip05.split('@');
  if (!name || !domain) {
    throw new Error('Invalid NIP-05 format');
  }

  // 查詢端點
  const url = `https://${domain}/.well-known/nostr.json?name=${name}`;

  try {
    const response = await fetch(url);
    if (!response.ok) {
      return { valid: false, reason: 'Failed to fetch' };
    }

    const data = await response.json();
    const pubkey = data.names?.[name];

    if (!pubkey) {
      return { valid: false, reason: 'Name not found' };
    }

    if (pubkey.toLowerCase() !== expectedPubkey.toLowerCase()) {
      return { valid: false, reason: 'Pubkey mismatch' };
    }

    return {
      valid: true,
      relays: data.relays?.[pubkey] || []
    };
  } catch (error) {
    return { valid: false, reason: error.message };
  }
}

// 使用 nostr-tools
import { nip05 } from 'nostr-tools'

const profile = await nip05.queryProfile('[email protected]')
// 回傳 { pubkey: '...', relays: [...] } 或 null

使用 "_" 作為根域名用戶：

nostr.json:
{
  "names": {
    "_": "公鑰..."  // @example.com
  }
}

NIP-05 地址: [email protected] 或簡寫 example.com

客戶端可能顯示為:
- example.com ✓
- @example.com ✓

在同一域名下支援多用戶：

nostr.json:
{
  "names": {
    "_": "admin_pubkey",
    "alice": "alice_pubkey",
    "bob": "bob_pubkey",
    "team": "team_pubkey"
  },
  "relays": {
    "admin_pubkey": ["wss://relay1.com"],
    "alice_pubkey": ["wss://relay2.com"],
    "bob_pubkey": ["wss://relay1.com", "wss://relay2.com"]
  }
}

對應的 NIP-05 地址:
- [email protected] (或 example.com)
- [email protected]
- [email protected]
- [email protected]