⚡ NostrPulse(nostrpulse-mcp)
为 AI Agent 提供的自主微支付(Cashu eCash 与 NIP-61)与护栏
通过 Nostr、Cashu eCash(NIP-61)和 Model Context Protocol(MCP)为自主 AI Agent 打造的去中心化 Stripe 与 Radar。

NostrPulse 是一个面向自主 AI Agent 的开源支付与主权信任层,构建于 Freedom Tech Stack(Nostr + Bitcoin Lightning + Cashu Chaumian eCash + Model Context Protocol)之上。它为 Cursor、Claude Desktop 和自主 LLM 提供类似 Stripe 的结算能力(通过 NIP-61 NutZaps 实现的 M2M 微支付)以及达到 Stripe Radar 级别的反 Sybil 防护(Web-of-Trust 图距离 + 可验证的经济质押)。
探索实时浏览器 » • AI Agent 接口 • HRF Grant 路线图与验证 • 赏金板 • 方法论 • Relay 遥测 • 对比引擎
🤖 面向 AI Agent 的 MCP Server(面向 AI 的 Stripe)
NostrPulse 原生导出一个符合行业标准的 Model Context Protocol(MCP)server,基于 Stdio JSON-RPC。任何 AI 客户端(Claude Desktop、Cursor、Windsurf、LangChain、Vercel AI SDK)都能立即接入去中心化声誉、机器对机器微支付和分布式算力,无需 API key 或托管账户。
1. 零代码快速上手(Cursor 与 Claude Desktop)
将以下配置直接粘贴到你的 claude_desktop_config.json 或 .cursor/mcp.json 中:
{
"mcpServers": {
"nostrpulse": {
"command": "npx",
"args": ["-y", "nostrpulse-mcp"]
}
}
}
- Claude Desktop 配置文件位置:macOS:~/Library/Application Support/Claude/claude_desktop_config.json Windows:%APPDATA%\Claude\claude_desktop_config.json
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Cursor IDE:保存到项目根目录下的 .cursor/mcp.json,或在 Cursor Settings > Features > MCP 下添加。
⚡ 3 行 SDK 快速上手(统一 Agent 钱包)
面向希望获得自主 eCash/Lightning 支付通道、内置反 Sybil 雷达与支出限额、又不想直接管理 Nostr NIP 或 Cashu NUT 的 TypeScript/Node.js AI 开发者:
import { NostrPulseAgent } from "nostrpulse-mcp/sdk";
const wallet = new NostrPulseAgent({ maxDailySats: 5000, minTrustScore: 65 });
await wallet.deposit("cashuAeyJ0b2tlbiI6...");
const receipt = await wallet.pay({ to: "npub180cvv07tjdrrgpa0j7j7tmnyl2yr6yr7l8j4s3evf6u64th6gkwsyjh6w6", amountSats: 21, memo: "AI task settlement" });
// Bitcoin-native HTTP 402 Paywall Engine (L402 Lightning + Cashu NUT-24 X-Cashu)
const paidApi = await wallet.fetch402("https://api.example.com/paid-endpoint");
2. 通过 MCP Inspector 进行交互式测试
通过官方 Model Context Protocol Inspector 在浏览器中验证工具、检查 schema 并测试 prompt:
npx @modelcontextprotocol/inspector npx -y nostrpulse-mcp
3. 核心 MCP 工具速查表
文章标题:Show HN: NostrPulse – 面向 AI Agents 的 Bitcoin HTTP 402(L402 与 Cashu)MCP Server
| Tool 名称 | 类型 | 描述 |
|---|---|---|
| check_trust_score | Radar / Anti-Sybil | 面向 AI agents 的反欺诈雷达。在交互或付款前,评估 Web-of-Trust Ring-1(22 个 Root Anchors)、传递跳数以及经 Sybil 过滤的经济质押(sats)。 |
| pay_cashu_nutzap | Payment Rails(eCash) | 使用封装在元数据私密的 NIP-59 Gift Wrap 与 NIP-44 加密中的 Chaumian eCash(NIP-61 NutZap)进行即时机器对机器(M2M)结算。并带有预检支出护栏。 |
| request_nip90_job | 去中心化计算 | 将计算与数据处理任务分发到 Nostr relays 上的去中心化 NIP-90 Data Vending Machines(DVMs),并以本地 SQLite 缓存作为回退。 |
| pay_lightning_nwc | Payment Rails(Lightning) | 通过 NIP-47 Nostr Wallet Connect(Alby Hub、Phoenixd、Umbrel)经由自主节点直接结算 BOLT-11 Lightning invoices,并带有支出护栏。 |
| pay_with_nwc | Payment Rails(别名) | pay_lightning_nwc 的直接 NWC 支付执行器别名。 |
| audit_cashu_mint | Mint Radar | 使用 Web-of-Trust 图距离、NIP-05 主权域名验证以及管理员声誉,审计并评估 Cashu eCash Mint 的交易对手风险。 |
| route_cashu_mint | Mint Mesh | 从 WoT-Gated Dynamic Mint Mesh 中动态发现并路由到信任度最高、延迟最低的 Cashu Mint。 |
| get_agent_identity | 零配置身份 | 获取活跃的自主 AI agent 加密公钥身份(pubkey、npub、keystore 来源、临时状态)。自动引导本地密钥。 |
| get_spending_guardrails | 预算守门人 | 查询当前 AI agent 支出护栏、每日预算(500 sats 滚动)、24 小时已花费 satoshis、剩余额度以及每笔交易限额(50 sats)。 |
| get_agent_telemetry | 遥测与审计 | 检查自主 agent 支出指标、滚动 24 小时预算额度、已拦截的 Sybil 威胁以及 Stripe Radar 级别的近期遥测事件。 |
| fetch_with_402_payment | HTTP 402 付费墙 | 获取外部 REST APIs,并通过 Cashu NUT-24(X-Cashu)或 Lightning L402 透明地结算 HTTP 402 Payment Required 付费墙,同时带有 SSRF 与预算护栏。 |
4. 面向小型语言模型(SLMs:500M – 1.5B)的 Profiles
对于边缘设备、本地 SLMs(例如通过 Ollama 运行的 Qwen 2.5 0.5B/1.5B)或对成本敏感的 agent 循环,NostrPulse 支持经过上下文优化的 profiles,可将 prompt 开销从约 2,200 tokens 降至约 380 tokens:
# Launch with minimal profile (3 core tools: check_trust_score, pay_cashu_nutzap, get_spending_guardrails)
npx -y nostrpulse-mcp --profile=minimal
# Or via environment variable
NOSTRPULSE_PROFILE=minimal npx -y nostrpulse-mcp
| Profile | 启用的 Tools | Token 占用 | 推荐使用场景 |
|---|---|---|---|
| minimal | check_trust_score、pay_cashu_nutzap、get_spending_guardrails | ~380 tokens | 本地 SLMs(0.5B – 1.5B)、边缘设备、低成本循环 |
| radar | check_trust_score、audit_cashu_mint | ~240 tokens | 只读反 Sybil 筛查与 Mint 风险验证 |
| payment | pay_cashu_nutzap、pay_lightning_nwc、get_spending_guardrails | ~420 tokens | 仅支付的执行 daemons 与 bots |
| full | 全部 10 个 NostrPulse MCP tools | ~2,200 tokens | 旗舰 LLMs(Claude 3.7/Opus、GPT-4o、Gemini 2.5) |
5. 自主 Agent-to-Agent(A2A)协作网格
NostrPulse 包含一个用于自主 agent-to-agent 去中心化协商与微商业的参考实现(scripts/test-mesh-agent.ts):
[ Agent A: Requester / Buyer ] [ Agent B: Worker / Seller ]
│ │
├──► 1. Dispatch NIP-90 Job ('zap-analytics') ──►│
│ │
│ 2. Audit Requester WoT Anti-Sybil Score ◄───┤ (Requires Trust Score > 40)
│ (check_trust_score) │
│ │
│◄── 3. Acknowledge & Deliver Computation ───────┤
│ │
├──► 4. Inspect Budget Guardrails (assert 24h) │
│ │
├──► 5. Settle Cashu NutZap (Adaptive Fallback) ─►│
- Zero-Cloud Local Inference:无需云端 API 密钥,使用 Ollama (qwen2.5-coder:1.5b) 在本地运行展示:npm exec tsx scripts/test-mesh-agent.ts --ollama
npm exec tsx scripts/test-mesh-agent.ts --ollama
- Adaptive Spending Fallback:如果请求的微支付超出滚动 24 小时支出限额,代理会自动下调至剩余的安全额度,以结算最低费用,而不会崩溃或超支。
🌐 问题与自由解决方案
开放代理系统和去中心化协议消除了平台锁定,但引入了两个关键漏洞:
- Agent Impersonation & Sybil Floods:密码学密钥对 (npub) 的生成成本为 $0,导致垃圾机器人、克隆账户和刷量交易猖獗。
- Payment Fragility & KYC Lockouts:传统银行轨道 (Stripe/PayPal) 会冻结自主代理。当接收节点离线或缺少入站流动性通道时,同步 Lightning Zaps (NIP-57) 会失败。
范式转变
| 维度 | 传统 Web2 / Stripe | NostrPulse(自由技术栈) |
|---|---|---|
| 代理身份 | API 密钥、信用卡、KYC 封禁 | 密码学主权密钥对 ( NIP-01 / NIP-19 ) |
| 反欺诈(雷达) | 中心化黑盒启发式规则 | Web-of-Trust Ring-1(22 个锚点)+ Anti-Sybil Sats Stake |
| M2M 结算 | 30% 平台抽成、商户资金冻结 | Chaumian eCash (NIP-61 NutZaps):零费用、即时、私密 |
| 离线交付 | 需要同步连接 | 通过 NIP-59 Gift Wrap 与 Relays 的异步 NutZaps |
| 计算委托 | 专有云 API | NIP-90 Data Vending Machines(开放计算市场) |
| AI 协议 | 厂商自定义 REST 封装 | 通过 Model Context Protocol 的 Stdio JSON-RPC ( nostrpulse-mcp ) |
🏛️ 多层级系统流水线
| 1. 身份与发现 | 2. 声誉与反女巫 | 3. 多轨价值轨道 | 4. AI MCP 与 NIP-90 DVM |
|---|---|---|---|
| • NIP-01:P2P WebSocket 中继 • NIP-05:密码学 DNS • NIP-07:签名器 (Alby, nos2x) • NIP-65:中继 gossip 网格 | • 5 支柱评分(0–100 分) • 22 个根锚点 WoT 图 • Anti-Sybil Damping Guard • Mint Reputation Radar • 双轨经济质押 | • NIP-47:NWC Lightning Rail • NIP-61:Cashu NutZaps • NIP-57:Lightning Zaps • NIP-59:Gift Wrap 隐私 • NUT-06:动态 Mint 网格 | • MCP Stdio:JSON-RPC 服务器 • npm:nostrpulse-mcp • NIP-90:DVM Worker 守护进程 • 赏金:WoT 门控任务 |
🚀 关键创新与工程亮点
1. 🛡️ 5 支柱密码学信任评分与反女巫可视化器
NostrPulse 直接基于开放中继数据和根锚点图拓扑计算出客观的 0–100 分声誉指数:
文章标题:Show HN: NostrPulse – 面向 AI Agents 的 Bitcoin HTTP 402(L402 和 Cashu)MCP Server
| 支柱 | 验证信号 | 最高分 |
|---|---|---|
| 支柱 1 | NIP-05 密码学 DNS 绑定:针对公钥验证 .well-known/nostr.json(主权域名可获加分)。 | 25 分 |
| 支柱 2 | 信任网络(WoT)第一环邻近度:评估与 22 个已验证协议种子密钥( jack 、 fiatjaf 、 jb55 、 calle 、 odell 等)的图距离,并带有本地 SQLite 回退。 | 25 分 |
| 支柱 3 | Sats 加权入度(经济质押):分析已验证的 Zap 收据,并过滤掉自我 Zap 和机器人克隆。以双进度条可视化。 | 20 分 |
| 支柱 4 | 密钥对长寿性与多 Relay 深度:评估密钥对的成熟度以及在全局 relay 上的复制数量。 | 15 分 |
| 支柱 5 | 元数据丰富度与真实性:验证头像、简介和外部身份端点。 | 15 分 |
反女巫阻尼防护:缺少已验证 NIP-05 DNS 签名且与信任网络图隔离的账户,会被严格限制在 44 分(未验证 / 潜在机器人)。这会永久性地压制自动化机器人蜂群。
2. ⚡ 双轨价值对价值结算(Lightning + Cashu eCash)
一个统一的微交易接口,可在实时 Lightning 与离线 Chaumian eCash 之间无缝切换:
[ 一键应用内铸造与 NutZap 管道 ]
用户/Agent 选择 Sats ──► 请求 NUT-04 报价 ──► 通过 WebLN/QR 结算 ──► 轮询 Mint 并认领 Proofs ──► 加密 NIP-59/44 ──► 广播 Kind 9321
- 100% 异步 NutZaps(NIP-61):即使接收方的 Lightning 节点离线,发送方也能将不记名 eCash 代币交付给创作者。
- NIP-59 Gift Wrap 信封隐私:使用随机临时密钥对包裹 NutZaps,以向公共 relay 抓取者隐藏发送方、接收方和载荷元数据。
- 抢跑防御(NIP-44 v2 加密):Kind 9321 事件内的不记名代币使用接收方公钥加密。
- 原生 NUT-00 V4 CBOR 解码:零依赖二进制解析器,符合 RFC 8949,可读取旧版 cashuA(JSON Base64)和下一代 cashuB(CBOR)代币。
- 动态 Mint 路由器:可在 Minibits、Macadamia、Cashu Testnut 或私有自托管 Mint 端点之间切换。
3. ⚡ NIP-47 Nostr Wallet Connect(NWC)直连 Lightning 轨道
NostrPulse 集成了面向 NIP-47 Nostr Wallet Connect 的高性能、零内存泄漏客户端,使 AI agents 能够通过自托管自主节点(Alby Hub、Phoenixd、Umbrel、LNBits)直接支付 BOLT-11 Lightning 发票:
[ NIP-47 直连 Lightning 结算管道 ]
Agent 收到发票 ──► 解析 NWC URI ──► 加密载荷(NIP-04/44)──► 发布 Kind 23194 ──► 监听 Kind 23195(按 #e 标记)──► 提取 Preimage 和费用 ──► 销毁 Pool 与订阅
- 标准化连接 URI:无缝解析和生成 nostr+walletconnect://<wallet_pubkey>?relay=<relay_url>&secret=<client_secret>&lud16=<lightning_address>&encryption=<nip04|nip44>。
- 零泄漏订阅生命周期:在完成或超时后立即清理资源,销毁 relay 池和事件订阅,以防止长期运行的 agent daemon 中发生内存滞留。
- 双加密握手:透明回退支持旧版 NIP-04 共享密钥和下一代 ChaCha20-Poly1305 NIP-44 v2 加密。
- 自主 MCP 执行:以 pay_lightning_nwc 的形式暴露(别名为 pay_with_nwc),供自主 agents 一步完成结算。
4. 🛡️ WoT 门控动态 Mint 网格与对手方风险雷达(NUT-06)
Cashu Mints 带有对手方风险。NostrPulse 通过 auditCashuMint 和 selectBestMint 充当客观、实时的 Mint 雷达:
[ 5 支柱 Mint 风险审计与动态网格路由 ]
目标 Mint URL ──► 探测 NUT-06 /v1/info ──► 提取管理员联系方式 ──► 解析 WoT 与 NIP-05 ──► 计算 5 支柱 Mint 评分 ──► 分类风险(LOW / MODERATE / HIGH_RISK)──► 路由到最优 Mint
Show HN:NostrPulse – 面向 AI Agents 的 Bitcoin HTTP 402(L402 与 Cashu)MCP Server
- NUT-06 探测与能力审计:评估 mint 的正常运行时间、操作响应延迟以及支持的协议能力(NUT-04 Mint、NUT-05 Melt、NUT-07 StateCheck、NUT-08 FeeReturn、NUT-10 DLEQ Proofs、NUT-11 P2PK)。
- 加密管理员身份发现:从联系人元数据中提取 Nostr 运营者公钥、NIP-05 主权域名签名或 Nostr URI,并解析到 22 个 Root Anchors 的可传递 WoT 图距离。
- 三层交易对手风险画像(MintRiskProfile):LOW(信任评分 ≥ 75):TRUSTED(运营者经直接验证、低延迟、完全符合 NUT)。MODERATE(信任评分 45–74):USE_WITH_CAP(社区 mint,正常运行时间与 WoT 连通性可接受)。HIGH_RISK(信任评分 < 45 或管理员未验证):AVOID(匿名、不安全的 HTTP、高延迟或孤立密钥对)。
- LOW(信任评分 ≥ 75):TRUSTED(运营者经直接验证、低延迟、完全符合 NUT)。
- MODERATE(信任评分 45–74):USE_WITH_CAP(社区 mint,正常运行时间与 WoT 连通性可接受)。
- HIGH_RISK(信任评分 < 45 或管理员未验证):AVOID(匿名、不安全的 HTTP、高延迟或孤立密钥对)。
- 自主 Mesh 选择(selectBestMint):并发评估候选 mint 列表,并动态选择信任度最高、延迟最低的 mint 用于 proof 创建和支付路由。
5. 🤖 自主机器货币 Agent(/agent)
一个展示自主 agent 商务的专用界面:
- 交互式 AI 支付者:配备 Chaumian eCash 钱包的 agent,能够根据质量提示词自动向创作者付款。
- 连接 MCP 弹窗:为 Claude Desktop 和 Cursor IDE 提供一键复制的配置。
- 独立 NutZap Web Component(public/widget.js):轻量级
<nutzap-me npub="...">按钮,可直接嵌入任何博客、文档或静态站点。
6. 🤖 NIP-90 自主 DVM Worker 与去中心化赏金市场
- 自主信任评分 DVM Bot(scripts/dvm-worker.ts):后台 worker,监听带有 ["t", "trust-score"] 标签的 Kind 5000 任务请求,计算评分,并以 5-Sat 需求(["amount", "5000"])广播 Kind 6000。
- NIP-90 客户端 SDK(src/lib/nip90.ts):提供 publishJobRequest()、fetchOpenBounties() 和 subscribeJobFeedbackAndResult() 的工具库。
- 抗女巫赏金市场(/bounties):开放的分布式任务板,可按创作者信任评分筛选(All、Score ≥ 20、Score ≥ 50、Score ≥ 80)。
- 一键 Cashu NutZap 结算(TaskResultView.tsx):审计交付物,并通过 NIP-44/59 加密的 NutZaps 即时结算赏金。
7. 🛡️ 自主 Agent 消费护栏与预算管理器
为防止自主 agent 因无限循环、幻觉调用或提示词注入而耗尽余额,NostrPulse 强制执行实时消费护栏:
[ Agent Payment Request ] ──► Check maxSatsPerTx (50 sats) ──► Check Rolling 24h Spend (500 sats) ──► Resolve WoT Score (>= 40)
│ │ │
▼ (Any Violation) ▼ (Any Violation) ▼ (Any Violation)
[ Short-Circuit Block ] ◄────────────── [ Short-Circuit Block ] ◄───────── [ Short-Circuit Block ]
│
▼
Return { status: "blocked_by_guardrails" } (0 Sats Spent)
- 单笔交易上限(AGENT_MAX_SATS_PER_TX):将单次交易调用限制为 50 sats 的安全默认值。
- 24 小时滚动预算(AGENT_DAILY_LIMIT_SATS):查询 SQLite 表 agent_spending_log,以强制执行 500 sats 的滚动每日限额。
- 抗女巫交易对手关卡(AGENT_MIN_RECIPIENT_SCORE):通过 Web-of-Trust 图距离评估交易对手信任评分;向未验证或机器人身份(评分 < 40)的付款会被自动拦截并阻止。
- 非托管安全:拒绝时立即返回 { status: "blocked_by_guardrails", reason },不花费任何资金。
8. 🔑 零配置主权身份引导
消除了开发者在运行前需要手动生成、粘贴或暴露 nsec 私钥的摩擦:
[ Agent Initialization ]
│
├──► 1. Check process.env.NOSTR_SECRET_KEY / AGENT_NSEC (Hex or Bech32 nsec1...)
│ └── Found? ──► Use environment identity
│
├──► 2. Check Local Keystore (.nostrpulse/agent-identity.json)
│ └── Exists? ──► Restore persistent identity
│
└──► 3. Cryptographic CSPRNG Generation (nostr-tools/pure)
└── Generates secp256k1 keypair ──► Writes to .nostrpulse/ (Mode 0600)
- 自动持久化:密钥对被保存至 .nostrpulse/agent-identity.json,带有限制性权限,并通过 .gitignore 自动排除在 Git 提交之外。
- 即时就绪:诸如 get_agent_identity 之类的工具允许智能体开箱即用地查询其公开身份(pubkey、npub、source、ephemeral flag)。
9. 📊 开发者遥测与 Stripe Radar 审计追踪
一个全面的开发者可观测性层(src/lib/telemetry.ts),提供 Stripe 级审计追踪:
- 事件日志记录:将 payment、radar_block、job_settlement 和 mint_audit 的结构化 JSON 日志记录到 SQLite 表 agent_telemetry 中。
- 开发者摘要指标:在可配置的时间范围内(默认:24h)计算 totalSpentSats、txCount 和 blockedSybilAttacks。
- 双重访问:AI 智能体可通过 MCP 工具 get_agent_telemetry 直接消费,Web 仪表板可通过 Next.js REST API GET /api/telemetry 消费。
📜 协议规范(NIPs、NUTs 与 MCP)
| 规范 | 标准描述 | 状态 |
|---|---|---|
| MCP Stdio | 通过 Stdio JSON-RPC 的 Anthropic Model Context Protocol( nostrpulse-mcp ) | ✅ 活跃 |
| NIP-01 | 基础协议流程、事件签名以及多中继 WebSocket 订阅 | ✅ 活跃 |
| NIP-05 | 基于 DNS 的互联网标识符密码学映射( [email protected] ) | ✅ 活跃 |
| NIP-07 | 浏览器扩展签名器接口( window.nostr :Alby、nos2x) | ✅ 活跃 |
| NIP-19 | Bech32 实体编码( npub1 、 nsec1 、 note1 、 nprofile1 ) | ✅ 活跃 |
| NIP-44 | 版本化端到端载荷加密,用于安全令牌传输 | ✅ 活跃 |
| NIP-47 | Nostr Wallet Connect:通过 Kind 23194 请求与 Kind 23195 响应直接执行 Lightning 支付 | ✅ 活跃 |
| NIP-57 | Lightning Zaps( Kind 9734 Zap Request 与 Kind 9735 Zap Receipt) | ✅ 活跃 |
| NIP-59 | Gift Wrap 加密(临时密钥信封,实现无元数据泄漏的令牌投递) | ✅ 活跃 |
| NIP-61 | Cashu eCash NutZaps( Kind 9321 加密 Chaumian 令牌投递) | ✅ 活跃 |
| NIP-65 | 中继列表元数据( Kind 10002 ),用于动态 outbox 路由 | ✅ 活跃 |
| NIP-90 | 数据自动贩卖机( Kind 5000 Request、Kind 6000 Result、Kind 7000 Feedback) | ✅ 活跃 |
| WoT Ring-1 | 22 个根锚点图拓扑 + 本地 SQLite 回退缓存 | ✅ 活跃 |
| NUT-00 | Cashu 密码学与令牌格式:V3(JSON Base64)与 V4(CBOR 二进制) | ✅ 活跃 |
| NUT-04 | 通过 Lightning BOLT-11 报价和支付轮询进行铸造操作 | ✅ 活跃 |
| NUT-05 | 熔化操作:通过 Chaumian eCash 证明结算 BOLT-11 Lightning 发票 | ✅ 活跃 |
| NUT-06 | Mint 信息与健康端点:支持的 NUTs、联系 pubkey 以及延迟探测 | ✅ 活跃 |
🛠️ 技术栈与架构
- 框架:Next.js 16(App Router、Server Components 与流式 SSR)
- 智能体协议:@modelcontextprotocol/sdk(v1.30+)、OpenAI / Google Gemini AI SDK
- 语言:TypeScript 5(对所有密码学结构进行严格类型检查)
- 样式:Tailwind CSS v4、Base UI、Lucide Icons
- 协议库:nostr-tools(v2.25+)、@cashu/cashu-ts(v4.9+)、@noble/hashes
文章标题:Show HN: NostrPulse – 面向 AI Agents 的 Bitcoin HTTP 402(L402 与 Cashu)MCP Server
正文:
- Zero-Buffer Client Engine:完全与 Node.js Buffer 全局对象解耦,使用浏览器原生 Uint8Array 原语,实现跨环境的通用兼容性。
- Non-Blocking Resilience:所有网络查询都使用 AbortSignal.timeout() 和 Promise.race() 回退进行包装,以消除 UI 卡死。
⚡ 快速开始与本地搭建
前置条件
- Node.js >= 20.0.0
- npm、pnpm 或 yarn
1. 克隆并安装
git clone https://github.com/PHONGUIT22/nostrpulse-full.git
cd nostrpulse-full
npm install
2. 运行开发服务器
在浏览器中打开 http://localhost:3000 以浏览实时仪表盘。
3. 构建并运行 MCP Server
# Build the production standalone MCP server bundle
npm run build:mcp
# Launch MCP server locally over stdio JSON-RPC
npx tsx src/mcp-entry.ts
# Or run the published npm package directly
npx -y nostrpulse-mcp
4. 运行验证与测试套件
# Test Agent Spending Guardrails, Budget Limits & Zero-Config Identity
npx tsx scripts/test-guardrails.ts
# Test Developer Telemetry & Audit Trail data layer
npx tsx scripts/test-agent-telemetry.ts
# Test full MCP Stdio JSON-RPC integration (all 10 tools discovered & tested)
npx tsx scripts/test-mcp-stdio.ts
# Test NIP-47 NWC payment execution, URI parsing, and timeout guards
npx tsx scripts/test-nwc-pay.ts
# Test WoT-Gated Cashu Mint Mesh (Testnut & Minibits /v1/info audit & trust verification)
npx tsx scripts/test-mint-mesh.ts
# Test autonomous Agent-to-Agent (A2A) Collaborative Mesh (Local SLM / Ollama)
npm exec tsx scripts/test-mesh-agent.ts --ollama
# Test A2A Mesh against the published npm package over Stdio JSON-RPC
npm exec tsx scripts/test-mesh-agent.ts --ollama --npm
# Test 5-Stage Autonomous Mini-Agent Showcase (Ollama Minimal Profile or Gemini)
npm exec tsx scripts/test-mini-agent.ts --ollama --profile=minimal
# Test self-contained NIP-59 Gift Wrap encryption & decryption
npx tsx scripts/test-nip59-encryption.ts
# Strict TypeScript type check (zero errors)
npx tsc --noEmit
🗺️ 路线图与里程碑
- 阶段 1:确定性 5-Pillar 信任评分引擎与反 Sybil 阻尼防护。
- 阶段 2:与 WebLN 集成的 NIP-57 Lightning Zap,以及实时回执流式传输。
- 阶段 3:NIP-61 NutZap 双模式引擎,具备 NUT-00 V4 CBOR 解码与 NIP-44 加密。
- 阶段 4:NIP-65 动态中继同步与浏览器 WebSocket 遥测。
- 阶段 5:NIP-90 数据售卖机:自主信任评分 worker 机器人与去中心化 /bounties 市场。
- 阶段 6:用于交付物验收与即时付款的 1-Tap Cashu NutZap 结算。
- 阶段 7:MCP Stdio Server 与 npm 包部署(npm registry 上的 nostrpulse-mcp)。
- 阶段 8:NIP-47 Nostr Wallet Connect(NWC)直连 Lightning 通道,用于自主节点结算。
- 阶段 9:WoT-Gated 动态 Mint Mesh 与 NUT-06 5-Pillar 交易对手风险雷达。
- 阶段 10:Agent 支出护栏(单笔交易上限与 24 小时限额)、零配置身份引导与开发者遥测数据层。
- 阶段 11:自主 Agent-to-Agent(A2A)协作网格、SLM 配置(--profile=minimal)与自适应支出回退。
- 阶段 12:独立的 @nostrpulse/sdk,具备 Zero-Buffer RFC 8949 CBOR、双 Bundle 构建与统一测试套件运行器。
⚖️ 许可证与非托管免责声明
依据 MIT License 分发。NostrPulse 是严格的非托管软件:它绝不生成、存储或请求用户私钥(nsec),也不托管用户资金。