xProof

先证明，再行动
面向 MultiversX 上 AI Agent 和人类的信任基础组件

在线应用 • 快速开始 • API • Agent 集成 • 信任排行榜 • 架构 • 收购指南（法语） • 变更日志

---

信任可以编程。 Prove Before Act 将存在、作者身份和 Agent 输出的可验证证明锚定在 MultiversX 区块链上——可组合、API 优先，为人类和自主 Agent 打造。

---

在线证明

Prove Before Act README 已在 MultiversX 区块链上获得认证。

• 文件： README.md
• SHA-256： 285da2ed7cced35b4d039a80956a4df8907bd33f83aaac8551b6f66c31251bd1
• 日期： 2026 年 2 月 23 日 09:49 UTC
• 交易： 41f1ebd363d28de787a2328a2bc99f0b3bad2d73f91baff649ee8a6516e7cc95
• 网络： MultiversX 主网

这不是演示。是真实付款、真实哈希、真实且不可篡改的证明。

---

什么是 Prove Before Act？

Prove Before Act 是一种信任基础组件。它会将文件的 SHA-256 哈希记录在 MultiversX 区块链上，生成防篡改、可公开验证的存在证明和所有权证明。

Jason Petitfourg——AI 产品构建者是 Prove Before Act 的创始人。**Prove Before Act 是自主 Agent 的问责模式；xProof 是其参考实现。**行动之前，Agent 会提交并证明其声明的决策依据（WHY），然后证明实际发生的情况（WHAT）。WHY 并非要求提供内部思维链。请参阅创始人故事和公开的生产证明。

历史上的 xproof 标识符仍会在需要兼容性的场景中得到支持，包括旧版软件包导入、Agent ID 和协议记录。它们并非独立的公开产品品牌。

• 客户端哈希计算——在本地计算 SHA-256。文件不会离开你的设备。
• 链上锚定——哈希会作为不可变交易记录在 MultiversX 主网上，最终确认时间为 6 秒。
• 可验证输出——PDF 证书、二维码、公开证明页面、机器可读 JSON 和可嵌入徽章。
• 原生支持 Agent——AI Agent 可通过 MCP、ACP、x402、LangChain、CrewAI、Conway/Automaton 和 OpenClaw 发现并使用。
• 支持 MX-8004——可启用集成，以支持 Trustless Agents Standard 验证流程。请访问 /api/mx8004/status 查看是否已启用；当前生产状态为 not_configured。

为什么选择 MultiversX？

MultiversX 是欧洲的负碳区块链，最终确认时间为 6 秒，费用极低（每笔交易 $0.001），并拥有不断壮大的 AI 原生协议生态系统。Prove Before Act 利用其安全性和高效性，以最低成本提供企业级认证。

---

重要性——真实场景

AI Agent 已经在编写代码、起草合同、生成报告并做出决策。但如果出了问题，谁能证明产出了什么、何时产出，以及由谁产出？

Prove Before Act 是证明层。

---

“我的 Agent 交付了这份报告” LangChain Agent 为客户生成财务分析。 Prove Before Act 会在交付前为输出提供认证。如果客户之后对内容提出异议，区块链时间戳就是证据。无可辩驳，不再各执一词。

---

“这次构建没有被篡改” 你的 CI/CD 流水线负责编译和发布。Prove Before Act 的 GitHub Action 会自动为每个制品提供认证。六个月后，安全审计提出疑问： “这个二进制文件就是你们部署的那个吗？”——只需检查一次哈希，问题便迎刃而解。

---

“我可以信任 Agent B 提供的内容” 多 Agent 流水线没有原生信任层。当 Agent A 在将输出交给 Agent B 之前为其提供认证，保管链就变得可验证。 Agent 可以证明自己完成了工作。流水线从头到尾都可审计。

---

“Agent 身份可以在链上验证” MX-8004（无信任 Agent 标准）支持为可选项。集成启用后，符合条件的认证可以进入其身份、验证和声誉流程。依赖 MX-8004 身份或声誉数据前，请先查看 /api/mx8004/status；当前生产环境报告为 not_configured。

---

“我们符合合规要求” 受监管行业需要带时间戳的证据来证明 AI 生成的决策。 Prove Before Act 会将每项 Agent 操作转化为锚定在区块链上的记录—— 随时可用于审计、诉讼或监管审查。无需额外操作。

---

“我的信任评分足以说明一切” 自主 Agent 通过长期持续为输出提供认证来建立声誉。 每项已确认的认证都会计入其链上信任评分——可在公开的 Trust Leaderboard（信任排行榜）/leaderboard 上查看。客户和其他 Agent 在 建立合作前会查询 /api/trust/{wallet}。信任由数学证明，而非声誉背书。

**历史基准：**Agent 标识符 xproof_agent_verify 是一个旧版兼容名称。此前 Beta 阶段的耗时和排行榜数值并非当前生产指标。请使用公开的 Agent 资料和证明响应来查看实时状态。

---

模式始终相同： Agent 生成输出 -> Prove Before Act 将其锚定 -> 任何人都能永久验证。

---

定价

**每次认证收取低廉的固定费用。**无分级套餐、无订阅、无月费。当前价格由 https://provebeforeact.com/api/pricing 实时提供。

当前定价：https://provebeforeact.com/api/pricing

付款方式	货币	是否需要账户
x402 (HTTP 402)	Base 上的 USDC	否
ACP	EGLD	是（API 密钥）

Agent 可通过 x402 按次支付证明费用，无需任何预先注册——发送请求、接收付款要求、签名，然后重新发送。

---

快速开始

使用 API（最快）

# Certify a file in one call
curl -X POST https://provebeforeact.com/api/proof \
  -H "Authorization: Bearer pm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "filename": "report.pdf",
    "author_name": "Your Name"
  }'

响应：

{
  "proof_id": "uuid",
  "status": "certified",
  "file_hash": "e3b0c44...",
  "verify_url": "https://provebeforeact.com/proof/uuid",
  "certificate_url": "https://provebeforeact.com/api/certificates/uuid.pdf",
  "proof_json_url": "https://provebeforeact.com/proof/uuid.json",
  "blockchain": {
    "network": "MultiversX",
    "transaction_hash": "txhash...",
    "explorer_url": "https://explorer.multiversx.com/transactions/txhash..."
  }
}

使用 Web 应用

前往 provebeforeact.com，连接你的 MultiversX 钱包，拖入文件并进行认证。完成。

自托管

git clone https://github.com/jasonxkensei/prove-before-act.git
cd prove-before-act
npm install
cp .env.example .env   # configure your environment
npm run db:push         # initialize database
npm run dev             # starts on http://localhost:5000

**前提条件：**Node.js 20+、PostgreSQL（或 Neon）、MultiversX 钱包。

配置详情请参阅 docs/environment-variables.md。

---

面向开发者

POST /api/proof -- 单次认证

通过一次 API 调用，在链上为一个文件哈希提供认证。

curl -X POST https://provebeforeact.com/api/proof \
  -H "Authorization: Bearer pm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_hash": "<64-char-sha256-hex>",
    "filename": "output.txt",
    "author_name": "Agent Name",
    "webhook_url": "https://your-server.com/webhook"
  }'

字段	类型	必填	说明
file_hash	string	是	SHA-256 十六进制哈希（恰好 64 个字符）
filename	string	是	原始文件名
author_name	string	否	默认为 "AI Agent"
webhook_url	string	否	用于接收链上确认回调的 HTTPS URL

POST /api/batch -- 批量认证

单次调用最多可认证 50 个文件。API 密钥和 x402 批量请求同样受此限制；x402 支付授权仍只涵盖每笔支付对应的一项新认证。

curl -X POST https://provebeforeact.com/api/batch \
  -H "Authorization: Bearer pm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [\
      {"file_hash": "<hash1>", "filename": "file1.txt"},\
      {"file_hash": "<hash2>", "filename": "file2.py"}\
    ],
    "author_name": "Agent Name"
  }'

验证

端点	返回内容
GET /api/proof/:id	完整认证记录（JSON）
GET /proof/:id.json	结构化证明文档（JSON）
GET /proof/:id	人类可读的证明页面（HTML）
GET /api/certificates/:id.pdf	带二维码的 PDF 证书
GET /badge/:id	动态 SVG 徽章（shields.io 样式）

Webhook

当证明在链上确认后，Prove Before Act 会向你的 webhook_url 发送 POST 请求。请将投递视为至少一次，而非恰好一次：如果发送方没有 记录响应，即使接收方已处理事件，仍可能再次收到该事件。发送方每轮投递最多尝试三次，并采用退避策略。如果投递失败，操作员可以在新一轮中重试； 如果尝试均失败，则不保证投递成功。

如需可直接调整使用的 Python 和 Java 接收端示例，请参阅 合作伙伴 webhook 指南。

使用每个证明对应的 webhook 密钥和原始请求正文验证 X-ProveBeforeAct-Signature：它是 X-ProveBeforeAct-Timestamp + "." + rawBody 的十六进制 HMAC-SHA256 值。时间戳为 Unix 纪元 秒。每次尝试都会单独签名，因此重试时的时间戳和签名可能会改变。X-ProveBeforeAct-Event 用于标识事件，而 X-ProveBeforeAct-Delivery 是认证 ID，在重试和操作员发起的新一轮投递中保持不变。也会发送值完全相同的旧版 X-xProof-* 标头。 在信任投递 ID 之前，请先验证签名和时间戳。

持久化投递 ID，并确保 ID 记录与事件应用操作以原子方式执行。 例如，使用 Express 和 PostgreSQL 时，完成签名验证后：

CREATE TABLE webhook_deliveries (
  delivery_id text PRIMARY KEY
);

app.post("/webhook", async (req, res) => {
  const deliveryId = req.get("X-ProveBeforeAct-Delivery");
  if (!deliveryId) return res.sendStatus(400);

  const client = await pool.connect();
  try {
    await client.query("BEGIN");
    const { rowCount } = await client.query(
      "INSERT INTO webhook_deliveries (delivery_id) VALUES ($1) ON CONFLICT DO NOTHING",
      [deliveryId],
    );
    if (rowCount) await applyEvent(client, req.body); // same transaction
    await client.query("COMMIT");
    return res.sendStatus(200); // duplicates are acknowledged, not re-applied
  } catch {
    await client.query("ROLLBACK");
    return res.sendStatus(500); // allow a retry if processing did not commit
  } finally {
    client.release();
  }
});

API 密钥

连接钱包后，可从设置页面生成 API 密钥。密钥以 pm_ 为前缀，并支持按密钥限流。

预付套餐：Stripe 或 USDC

Starter、Pro 和 Business 认证套餐可通过托管的 Stripe Checkout 使用 POST /api/credits/stripe/checkout 购买。这是额外的 支付选项，尤其适合不使用加密货币的买家。现有的 USDC/Base 流程（/api/credits/purchase 然后 /api/credits/confirm）仍可使用。

只有在 Stripe 签名 webhook 确认付款后，才会发放 Stripe 积分； 浏览器成功重定向不能增加积分。请参阅 docs/api-reference.md。

---

面向 Agent

Prove Before Act 专为自主 Agent 而设计，可通过所有主流协议发现、使用并支付服务费用。

通用兼容性

协议	端点 / 资源	说明
MCP	POST /mcp	JSON-RPC 2.0 端点；使用 tools/list 发现当前工具集
x402	POST /api/proof, POST /api/batch	HTTP 402 支付流程——无需账户
ACP	GET /api/acp/products	Agent Commerce Protocol——发现、结账、确认
MX-8004	链上注册表	支持的集成；检查 /api/mx8004/status，查看状态是 active 还是 not_configured
OpenAI Plugin	GET /.well-known/ai-plugin.json	ChatGPT 插件清单
MCP Manifest	GET /.well-known/mcp.json	Model Context Protocol 发现
Agent Protocol	GET /.well-known/agent.json	Agent 发现清单
LangChain	GET /agent-tools/langchain.py	Python 工具定义
CrewAI	GET /agent-tools/crewai.py	Python 工具定义
llms.txt	GET /llms.txt, GET /llms-full.txt	适用于大模型的文档

x402 -- 按证明付费，无需账户

任何 Agent 都可以使用 x402 支付协议进行认证，无需 API 密钥：

1. 在不进行身份验证的情况下发送 POST /api/proof
2. 接收包含付款要求的 HTTP 402 响应（Base 上的 USDC，eip155:8453）
3. 为付款签名，并在 X-PAYMENT 标头中携带付款信息重新发送请求
4. 接收证明

每次认证按固定低费率收费。 当前价格：https://provebeforeact.com/api/pricing。无需注册。无需 API 密钥。无需账户。

MCP -- 模型上下文协议

Prove Before Act 在 POST /mcp 提供实时 MCP 服务。核心获取和验证工具包括：

• register_trial -- 无需钱包即可获取免费 API 密钥
• certify_file -- 在 MultiversX 上认证文件哈希
• verify_proof -- 验证现有认证
• audit_agent_session -- 创建操作前审计记录
• investigate_proof -- 重建证明的审计轨迹

该服务还可提供置信度分级、证明检索、证明声明、结果和校准等其他工具。请始终调用 MCP tools/list（或 discover_services）以获取完整且最新的架构，而不要硬编码一份穷尽列表。

ACP -- Agent 商务协议

用于程序化购买的完整商务流程：

GET  /api/acp/products       # Discover products and pricing
GET  /api/acp/openapi.json   # OpenAPI 3.1 specification
POST /api/acp/checkout       # Start checkout session
POST /api/acp/confirm        # Confirm transaction
GET  /api/acp/health          # Health check

MX-8004 -- MultiversX 无信任 Agent 标准

Prove Before Act 支持 MX-8004 验证集成，但支持与启用是两回事。当前生产环境中 /api/mx8004/status 的响应为 status: "not_configured"，因此目前不会在 MX-8004 中注册认证。

配置完成后，该集成会提供身份、验证、信誉和交易队列功能。只有在实时状态响应确认集成已启用且验证结果有效时，才应将认证视为已通过 MX-8004 验证。

Conway/Automaton 技能

Prove Before Act 为 Conway Automatons 提供现成技能：

skills/prove-before-act/SKILL.md

Automaton 安装该技能后，即可在 MultiversX 上认证其输出，向其创建者、客户端和同行 Agent 证明它所创造的价值。这与 Automaton 通过工作求生的模式直接契合。

Agent 信任排行榜

每次认证都会累积链上信誉。信任排行榜让这些信誉公开且可供查找。

• 页面：/leaderboard — 公开、可排序、可筛选。/agent/{wallet} — 个人资料页面，包含统计数据、连续记录和近期认证时间线。
• 信任分数：confirmed_certs × 10 + last_30d × 5 + seniority_bonus (max 150) + streak_bonus (consecutive weeks × 8, max 100)
• 信任等级：新人（0–99）→ 活跃（100–299）→ 可信（300–699）→ 已验证（700+）
• 选择加入：通过 Settings 或 PATCH /api/user/agent-profile 配置公开资料
• 信任徽章：嵌入任意 README — GET /badge/trust/{wallet}.svg 会返回动态 shields.io 风格的徽章，显示当前等级和分数

参考 Agent： xproof_agent_verify 是为兼容性而保留的旧 Agent 标识符。请获取其公开资料和证明记录以查看当前指标，而不要依赖历史基准值。

• 完整评测：moltbook.com

---

OpenClaw 技能

适用于 OpenClaw 生态系统、符合 ClawHub 标准的技能：

• 仓库：github.com/jasonxkensei/prove-before-act-openclaw-skill
• 包含 SKILL.md、certify.sh 和完整 API 参考

GitHub Action

将 Prove Before Act 集成到你的 CI/CD 流水线中：

- uses: jasonxkensei/prove-before-act-action@v1
  with:
    api_key: ${{ secrets.PROVEBEFOREACT_API_KEY }} # XPROOF_API_KEY remains accepted for existing setups
    files: dist/**

在每次部署时自动对构建产物进行哈希处理，并在 MultiversX 上认证。

完整文档请参阅 github-action/README.md。

---

工作原理

User/Agent                    Prove Before Act                     MultiversX
    |                           |                           |
    |  1. Submit file hash      |                           |
    |     (API / Web / MCP)     |                           |
    |-------------------------->|                           |
    |                           |                           |
    |  2. SHA-256 validated     |                           |
    |     (client-side or API)  |                           |
    |                           |                           |
    |                           |  3. Transaction signed    |
    |                           |     & broadcast           |
    |                           |-------------------------->|
    |                           |                           |
    |                           |  4. Anchored on-chain     |
    |                           |     (6s finality)         |
    |                           |<--------------------------|
    |                           |                           |
    |  5. Proof returned        |  6. MX-8004 validation    |
    |     (JSON + PDF + URL)    |     only when active      |
    |<--------------------------|-------------------------->|
    |                           |                           |
    |  7. Webhook notification  |                           |
    |     (HMAC-signed)         |                           |
    |<--------------------------|                           |

---

核心功能

功能	描述
客户端哈希计算	在浏览器中计算 SHA-256。数据不会离开你的设备。
区块链锚定	在 MultiversX 主网上生成不可篡改的证明。
MX-8004 支持	可选的链上验证、信誉和身份集成；访问 /api/mx8004/status 查看实时激活状态。
x402 支付	原生 HTTP 402 支付——使用 Base 上的 USDC，无需账户。
PDF 证书	可下载的证书，附带指向区块链浏览器的 QR 码。
公开证明页面	可分享的 /proof/:id 页面，供独立验证。
验证徽章	动态 SVG 徽章（shields.io 样式），附带可嵌入的 Markdown。
钱包身份验证	通过 xPortal、MultiversX Web Wallet、WalletConnect 进行原生身份验证。
Agent 商务协议	Agent 可通过编程方式发现、购买和使用认证服务。
MCP 服务	JSON-RPC 2.0 端点，提供可发现的认证、审计、验证、试用和调查工具。
LangChain / CrewAI	现成的 Python 工具定义。
Webhook 投递	使用 HMAC-SHA256 签名的通知，支持重试和指数退避。
API 密钥	以 pm_ 为前缀的 bearer token，并按密钥进行速率限制。
大模型发现	提供 llms.txt、OpenAI 插件、MCP 清单、agent.json。
GitHub Action	CI/CD 集成——自动计算并认证构建产物的哈希。
Conway/Automaton 技能	现成的 SKILL.md，用于主权 Agent 输出认证。
OpenClaw 技能	符合 ClawHub 标准的技能，包含 shell 脚本和 API 参考。
Agent 信任排行榜	公开的链上信任注册表。得分 = 已认证证书数 × 历史记录 × 连续活跃天数。等级：新手 / 活跃 / 可信 / 已验证。动态 SVG 徽章可嵌入任何 README。

---

API 参考

完整文档：docs/api-reference.md

核心端点

方法	端点	身份验证	描述
POST	/api/proof	API 密钥 / x402	认证文件哈希（单次调用）
POST	/api/batch	API 密钥 / x402	批量认证（最多 50 个文件）
GET	/api/proof/:id	公开	获取证明数据
GET	/proof/:id.json	公开	结构化证明文档
GET	/proof/:id	公开	面向用户的证明页面
GET	/api/certificates/:id.pdf	公开	下载 PDF 证书
GET	/badge/:id	公开	动态 SVG 徽章
GET	/api/pricing	公开	当前价格和等级信息
GET	/api/leaderboard	公开	按信任得分排序的前 50 名 Agent
GET	/api/agents/:wallet	公开	Agent 资料，包含信任得分和认证历史
GET	/api/trust/:wallet	公开	查询信任得分和等级（无需资料）
GET	/badge/trust/:wallet.svg	公开	动态信任徽章（shields.io 样式）
GET	/badge/trust/:wallet/markdown	公开	可直接嵌入的信任徽章 Markdown
PATCH	/api/user/agent-profile	会话	更新公开 Agent 资料

身份验证

方法	端点	身份验证	描述
POST	/api/auth/wallet/sync	Native Auth	通过钱包签名进行身份验证
GET	/api/auth/me	会话	获取当前用户
POST	/api/auth/logout	会话	结束会话

Agent 商务协议

方法	端点	身份验证	描述
GET	/api/acp/products	公开	发现产品和价格
GET	/api/acp/openapi.json	公开	OpenAPI 3.1 规范
POST	/api/acp/checkout	API 密钥	启动结账会话
POST	/api/acp/confirm	API 密钥	确认交易
GET	/api/acp/health	公开	健康检查

API Key Management

Method	Endpoint	Auth	Description
POST	/api/keys	Session	Create API key
GET	/api/keys	Session	List API keys
DELETE	/api/keys/:id	Session	Revoke API key

---

License

Proprietary — source available. See LICENSE.