Soulprint — 面向 AI Agent 的去中心化身份协议

Soulprint 利用隐私保护的零知识证明（ZK proofs）证实任意 AI Bot 背后均为真实人类——不依赖中心化权威机构，亦无需将生物特征数据上传至云端。全部状态数据均存储于 Base Sepolia 区块链上。

GitHub： https://github.com/manuelariasfz/soulprint
npm： https://www.npmjs.com/package/soulprint-network
文档： https://soulprint.digital
网络： 在 Railway 上运行的 4 个验证节点（Base Sepolia 测试网）
版本： v0.6.4

架构（v0.6.4 — 以区块链为首要基础设施，本地执行 ZK 验证）

用户仅需完成一次验证 → ZK 证明在本地生成（无需爬取 Registraduría 数据）
→ Nullifier 上链注册（Base Sepolia）
→ 任意 Agent 可查询链上状态：isRegistered(nullifier) → true/false
无 P2P 同步，无中心服务器 —— 区块链即网络本身

Base Sepolia 上已部署合约：

• PeerRegistry：0x452fb66159dFCfC13f2fD9627aA4c56886BfB15b
• NullifierRegistry：（待部署 — 需测试网 ETH）
• ReputationRegistry：（待部署 — 需测试网 ETH）
• ProtocolThresholds：0xD8f78d65b35806101672A49801b57F743f2D2ab1
• MCPRegistry：0x59EA3c8f60ecbAe22B4c323A8dDc2b0BCd9D3C2a

适用场景

✅ 建议使用本能力的情形：

• “为 AI Agent 验证我的身份”
• “运行一个 Soulprint 验证节点”
• “在我的 MCP Server 或 API 中集成身份验证功能”
• “查询某个 Bot 或 DID 的声誉分数”
• “基于哥伦比亚 cédula 生成隐私保护证明”
• “将 cédula 与 Registraduría Nacional 进行核验”
• “发行或验证 SPT（Soulprint Token）”

❌ 不建议使用本能力的情形：

• 远程存储或传输生物特征数据（Soulprint 全流程 100% 本地运行）
• 验证尚未支持国家的身份（目前仅完整支持哥伦比亚）

快速入门

1. 验证您的身份（一次性操作）

npx soulprint install-deps   # 安装 OCR + 人脸识别依赖 — 仅需执行一次
npx soulprint verify-me      # 全程本地处理，无任何数据上传

2. 运行验证节点

npx soulprint-network
# 或
ADMIN_PRIVATE_KEY=0x... ADMIN_TOKEN=... PORT=4888 node dist/server.js

节点 API 接口：

GET  /info                      — 节点版本、网络信息、合约地址、支持能力
GET  /health                    — 代码完整性哈希值
POST /verify                    — 验证 ZK 证明
GET  /verify/cedula?numero=X&fechaNac=YYYY-MM-DD  — 调用 Registraduría 进行 cédula 核验
GET  /network/stats             — 实时统计（对等节点数、已验证数、MCP 数量）
GET  /mcps/verified             — 从链上 MCPRegistry 获取已验证的 MCP 列表
GET  /protocol/thresholds       — 查询链上协议阈值配置

在您自己的 API 中集成

MCP Server（仅需 3 行代码）

import { requireSoulprint } from "soulprint-mcp";

server.tool("premium-tool", requireSoulprint({ minScore: 80 }), async (args, ctx) => {
  const { did, score } = ctx.soulprint;
});

Express / Fastify

import { soulprintMiddleware } from "soulprint-express";
app.use(soulprintMiddleware({ minScore: 65 }));
// req.soulprint.did, req.soulprint.score

信任分数（0–100 分）

协议常量（通过 ProtocolThresholds 合约上链存储）

国家支持情况

npm 包列表

与 mcp-colombia 的集成

mcp-colombia-hub@1.3.0 原生集成 Soulprint —— 无需额外配置。

• soulprint_status 工具可直接在 mcp-colombia 中调用：用于检查链上身份与声誉状态
• trabajo_aplicar（求职申请）要求 Soulprint 分数 ≥ 40
• 在线验证节点地址：https://soulprint-node-production.up.railway.app

一并安装

# 添加至您的 MCP 配置：
npx mcp-colombia-hub     # 自动包含 soulprint_status 工具

# 首先完成身份验证（一次性）：
npx soulprint verify-me

完成验证后，您的 SPT Token 将自动适用于 mcp-colombia 中所有工具。