ChainlessChain 文档

主题

Nostr 桥接 (nostr) ​

Headless 命令 — 不依赖桌面 GUI，直接使用核心包运行。适用于服务器、CI/CD、容器化等无桌面环境。

核心特性 ​

  • 📡 中继管理: 添加和管理 Nostr 中继节点
  • 📝 事件发布: 发布文本笔记和自定义类型事件
  • 🔑 密钥生成: 生成 Nostr 密钥对（公钥 + 私钥）
  • 🆔 DID 映射: 将 DID 身份映射到 Nostr 公钥

概述 ​

ChainlessChain CLI Nostr 桥接模块实现了与 Nostr 去中心化社交协议的集成。Nostr 使用基于 NIP-01 的事件结构，通过中继（relay）网络进行消息传播。

relays 和 add-relay 管理中继节点连接。publish 发布事件到所有已连接的中继，支持 NIP-01 定义的 kind 类型（kind=1 为文本笔记）。events 查看已接收的事件。keygen 生成 Nostr 密钥对。map-did 建立 ChainlessChain DID 身份与 Nostr 公钥的双向映射。

命令参考 ​

nostr relays — 查看中继 ​

bash
chainlesschain nostr relays
chainlesschain nostr relays --json

列出所有已配置的 Nostr 中继，显示 URL、状态和事件计数。

nostr add-relay — 添加中继 ​

bash
chainlesschain nostr add-relay <url>
chainlesschain nostr add-relay wss://relay.damus.io
chainlesschain nostr add-relay wss://nos.lol

添加一个 Nostr 中继节点。

nostr publish — 发布事件 ​

bash
chainlesschain nostr publish <content>
chainlesschain nostr publish "Hello Nostr from ChainlessChain!"
chainlesschain nostr publish "自定义事件" -k 30023 -p npub1...

发布一个 Nostr 事件。--kind 指定事件类型（默认 1 = 文本笔记），--pubkey 指定作者公钥。

NIP-01 事件结构：

json
{
  "id": "<sha256 hash>",
  "pubkey": "<author public key>",
  "created_at": 1234567890,
  "kind": 1,
  "content": "Hello Nostr!",
  "tags": [],
  "sig": "<signature>"
}

nostr events — 查看事件 ​

bash
chainlesschain nostr events
chainlesschain nostr events -k 1 -n 20
chainlesschain nostr events --json

列出已接收的事件，支持按 kind 过滤和限制返回数量。

nostr keygen — 生成密钥对 ​

bash
chainlesschain nostr keygen
chainlesschain nostr keygen --json

生成一个 Nostr 密钥对，包含公钥和私钥。

nostr map-did — DID 映射 ​

bash
chainlesschain nostr map-did <did> <pubkey>
chainlesschain nostr map-did "did:chainless:abc123" "npub1xyz..."

将 ChainlessChain DID 身份映射到 Nostr 公钥，建立跨协议身份关联。

数据库表 ​

表名说明
nostr_relays中继节点（URL、状态、事件计数、最后连接时间）
nostr_events事件记录（事件 ID、公钥、类型、内容、标签、签名、时间戳）

系统架构 ​

用户命令 → nostr.js (Commander) → nostr-bridge.js
                                         │
                ┌───────────────────────┼───────────────────────┐
                ▼                       ▼                       ▼
          中继管理                 事件引擎                 身份桥接
     (添加/列出)           (发布/查询/过滤)          (密钥生成/DID映射)
                ▼                       ▼
         nostr_relays            nostr_events

关键文件 ​

  • packages/cli/src/commands/nostr.js — 命令实现
  • packages/cli/src/lib/nostr-bridge.js — Nostr 桥接库

测试 ​

bash
npx vitest run __tests__/unit/nostr-bridge.test.js
# 22 tests, all pass

使用示例 ​

场景 1：连接中继并发布 ​

bash
# 添加中继节点
chainlesschain nostr add-relay wss://relay.damus.io
chainlesschain nostr add-relay wss://nos.lol

# 生成密钥对
chainlesschain nostr keygen --json

# 发布文本笔记
chainlesschain nostr publish "第一条 Nostr 消息！" -p npub1...

# 查看事件
chainlesschain nostr events -k 1

场景 2：DID 身份映射 ​

bash
# 创建 DID 身份
chainlesschain did create

# 生成 Nostr 密钥对
chainlesschain nostr keygen

# 建立 DID ↔ Nostr 映射
chainlesschain nostr map-did "did:chainless:abc123" "npub1xyz..."

# 查看中继状态
chainlesschain nostr relays --json

故障排查 ​

症状可能原因解决方案
"No relays configured"未添加中继使用 nostr add-relay <url>
发布事件后 sentCount=0中继不可达检查中继 URL 和网络连接
事件列表为空未发布或中继无事件先发布事件或更换中继

安全考虑 ​

  • 密钥安全: 私钥存储在加密数据库中，终端输出仅显示截断的私钥
  • 签名验证: 所有事件使用 Schnorr 签名，确保事件完整性
  • DID 绑定: DID 映射建立可验证的跨协议身份链
  • 中继冗余: 支持多中继配置，消息同步发布到所有中继

相关文档 ​

基于 MIT 许可发布

Copyright © 2024-2026 ChainlessChain Team