provenonce

@provenonce/mcp

Provenonce Skill — 让任何 AI Agent 在不到 60 秒内获得加密身份。

将此技能添加到你的 Agent，即可获得：

• 永久加密哈希（身份）
• SIGIL（经验证的身份类别 + 等级）
• 签名护照（任何第三方均可离线验证）
• 心跳（持续存活证明）
• Beats 证明（计算工作证据）
• 血统（完整的祖先链）

快速开始

Claude Desktop / Claude Code

添加到 ~/.claude/claude_desktop_config.json：

{
  "mcpServers": {
    "provenonce": {
      "command": "npx",
      "args": ["-y", "@provenonce/mcp"]
    }
  }
}

就是这样。首次使用时，你的 Agent 会调用 provenonce_register 并获得永久身份。

使用现有凭据

{
  "mcpServers": {
    "provenonce": {
      "command": "npx",
      "args": ["-y", "@provenonce/mcp"],
      "env": {
        "PROVENONCE_API_KEY": "pvn_...",
        "PROVENONCE_AGENT_HASH": "0x..."
      }
    }
  }
}

作为技能开发者（赚取分成）

如果你是将此技能嵌入框架的开发者，请附上你的合作伙伴推荐令牌：

{
  "env": {
    "PROVENONCE_SKILL_REF": "your16hextoken"
  }
}

你部署的 Agent 每购买一个 SIGIL，你都能获得 30% 的收益分成。在 POST /api/v1/skill/register 注册。

11 个工具

工具	功能	是否需要身份验证
provenonce_register	自动注册 Agent，获取哈希 + API 密钥	否
provenonce_status	完整的当前状态（SIGIL、余额、提示）	是
provenonce_purchase_sigil	购买 SIGIL，解锁心跳 + 护照	是 + SOL 交易
provenonce_heartbeat	提交存活证明	是 + SOL 交易
provenonce_batch_heartbeat	一次调用为多个子 Agent 发送心跳	是 + SOL 交易
provenonce_get_passport	获取签名身份文档	是
provenonce_beats_proof	计算工作证明，获取收据（用于生成子 Agent / 重新同步）	否
provenonce_submit_beats	计算 VDF beats 并计入终身 beats 数量	是
provenonce_verify_agent	检查另一个 Agent 的身份	否
provenonce_spawn	生成子 Agent	是
provenonce_get_lineage	获取完整的祖先链	否

使用示例

示例 1：注册并检查状态

用户提示词：“使用 Provenonce 注册并显示我的身份。”

预期行为：

• Agent 使用可选名称调用 provenonce_register
• 收到永久加密哈希（例如 0xabcd...）和 API 密钥
• 凭据保存到 ~/.provenonce/config.json
• Agent 调用 provenonce_status，显示身份、余额和后续步骤
• 状态响应包含 _hint，建议 Agent 购买 SIGIL

示例 2：信任另一个 Agent 之前先验证它

用户提示词：“检查 Agent 0xf7dad8f4...b6fd 是否可信。”

预期行为：

• Agent 使用目标哈希调用 provenonce_verify_agent
• 返回该 Agent 的 SIGIL、身份类别、等级、注册日期和存活分数
• Agent 报告目标是否拥有有效 SIGIL，以及近期是否发送过心跳
• 无需身份验证——这是一个公开验证端点

示例 3：完整生命周期——SIGIL、心跳和护照

用户提示词：“帮我获取 SIGIL、发送心跳并导出护照。”

预期行为：

• Agent 在不提供 payment_tx 的情况下调用 provenonce_purchase_sigil，以获取费用说明（SOL 金额 + ops 钱包地址）
• 用户发送 SOL 付款并提供交易签名
• Agent 再次调用 provenonce_purchase_sigil，并提供 payment_tx 以完成购买
• Agent 调用 provenonce_heartbeat（采用相同的付款流程）以证明存活
• Agent 调用 provenonce_get_passport，接收经过加密签名的身份文档
• 任何第三方都可以使用 Provenonce authority 公钥离线验证护照

Agent 流程

Day 1:  provenonce_register      → hash minted, credentials saved
        provenonce_beats_proof   → works immediately, no SIGIL needed
        provenonce_status        → { sigil: null, _hint: "Call provenonce_purchase_sigil..." }

Day 7:  provenonce_purchase_sigil → pay SOL, SIGIL issued
        provenonce_heartbeat     → now unlocked
        provenonce_get_passport  → signed identity doc, share with anyone
        provenonce_verify_agent  → verify a counterparty before trusting them

环境变量

变量	描述	默认值
PROVENONCE_API_KEY	Agent API 密钥（pvn_...）	从 ~/.provenonce/config.json 读取
PROVENONCE_AGENT_HASH	Agent 哈希（0x...）	从 ~/.provenonce/config.json 读取
PROVENONCE_SKILL_REF	你的合作伙伴推荐令牌（用于收益分成）	无
PROVENONCE_REGISTRY_URL	注册表 URL 覆盖值	https://provenonce.io

不依赖框架的用法

import { PROVENONCE_TOOLS } from '@provenonce/mcp/tools';

// OpenAI
const tools = PROVENONCE_TOOLS.map(t => ({ type: 'function', function: t }));

// LangChain / custom — use PROVENONCE_TOOLS for schema, implement handlers yourself

凭据存储

凭据存储在 ~/.provenonce/config.json 中，权限设置为 chmod 600（Unix）。

在 Windows 上，请使用环境变量（PROVENONCE_API_KEY + PROVENONCE_AGENT_HASH）——文件权限不会强制执行。

隐私政策

Provenonce 仅收集提供加密身份服务所需的最少数据：

• 收集的数据： Agent 名称（可选）、加密哈希（生成）、API 密钥、SIGIL 元数据、心跳时间戳，以及用于付款的 Solana 交易签名。
• 数据用途： 维护 Agent 身份注册表、验证 Agent 是否在线，以及签发签名护照。不会向第三方出售数据。
• 存储： Agent 状态存储在 Supabase（PostgreSQL）中。防篡改时间戳锚定在 Solana 区块链上，形式为 SPL Memo 交易。
• 第三方共享： 链上备忘录（注册、SIGIL）在 Solana 上公开可见。不会向第三方共享其他数据。
• 保留期限： Agent 记录作为溯源链的一部分永久保留。已撤销的 Agent 会标记为已撤销，但不会删除。
• 联系： [email protected]

完整隐私政策：provenonce.dev/legal/privacy

支持

• 文档：provenonce.dev
• 问题：github.com/ProvenonceAI/provenonce-mcp/issues
• 邮箱：[email protected]

即将推出

• provenonce_kyc — KYC / 身份类别升级
• 自动心跳计时器（可选择启用）
• Python SDK（provenonce-py）

许可证

MIT — 参见 LICENSE

链接

• 注册表：provenonce.io
• 文档：provenonce.dev
• API：provenonce.io/openapi.yaml