AOTrust Notarization & Evidence Server

AOTrust — AI Agent 的存在性加密证明

AOTrust 签发 PDR（来源数据记录）——239 字节的加密收据，用于证明某个数字制品在特定时间已经存在。通过 x402 支付 0.01 美元 USDC——可在 Base（EVM）或 Solana（SVM，通过 MCP）上付款。每天锚定到 NEAR 区块链。无需账户。支持普通签名（v0x03）和双边签名（v0x04）。

定位：独立的外部来源检查点。 原生证明（Sigstore、GitHub 制品证明）会在生成制品的 CI 系统内部验证构建。AOTrust 对此提供补充：它在 GitHub/Microsoft 基础设施之外签发签名证书，并每天将其锚定到 NEAR 区块链——因此，即使仓库被改写、CI 日志消失或证明存储不可用，来源信息仍然有效。两者都要使用。

Agent 检查点（新增）

只需 60 秒即可连接你的 AI 编码 Agent，并让它为计划/补丁/发布设置公证检查点——免费套餐，无需账户： agent-checkpoint/ — 适用于 Cursor、Cline 和任意 MCP 客户端的 mcp.json 配置片段，以及可直接复制粘贴的 AGENTS.md 代码块 （在提交中添加 Provenance: <Shield ID>）。

作者身份声明（双边签名）

除 Agent 工作流外，AOTrust 还支持双边 PDR（v0x04）：制品由你（Ed25519）签名，并且由公证方会签——绑定哈希将你的公钥与内容关联起来。这让“我最先创作/发布了这个”成为针对任何数字制品的可验证声明：手稿、设计、照片、研究笔记、法律往来。任何人都可以在 https://verify.aotrust.link 上公开验证——读者无需账户，也无需安装软件。 签名指南（Ed25519、NEP-413）：SKILL.md → 双边签名。 有关绑定哈希的构造，请参阅 pdr-spec.md §v2.4。

快速入门

想要一键配置？ 请参阅 INTEGRATIONS.md——其中提供适用于 Cursor、Windsurf、Cline、Claude Desktop 的现成 MCP 配置，以及供助手使用的“提交前公证”规则和 LangChain/CrewAI 示例。

# 1. Compute SHA-256 hash of your artifact
HASH=$(echo -n "Hello AOTrust" | sha256sum | cut -d' ' -f1)

# 2. Request notarization → get 402 payment details
curl -X POST https://api.aotrust.link/notarize \
  -H "Content-Type: application/json" \
  -d "{\"work_hash\":\"$HASH\",\"agent_sig\":\"\",\"agent_pubkey\":\"\"}"

# 3. Pay $0.01 USDC on Base (EIP-3009), then POST with x-payment header
# Full example: see SKILL.md → "Step 3: Pay"

完整的 EIP-3009 签名代码（Python 和 ethers.js 示例）请参阅 SKILL.md。

接口

接口	最适合	身份验证
HTTP API	开发者、脚本、CI/CD	x402 付款（无需 API 密钥）；免费套餐为每个 IP 每天 5 次
MCP	AI Agent（Claude、Cursor、Cline）	发现和免费工具无需身份验证（notary_free 每个 IP 每天 5 次）

身份验证与密钥

公证无需密钥。 标准公证（免费套餐和 x402 小额支付）始终不需要 API 密钥——付款通过带内方式完成（x402 x-payment 标头），免费调用则按 IP 限流。

AO_TRUST_KEY 可选，仅由 GitHub Action （action/notarize.py）使用，用于解锁专用 CI 速率限制（每个密钥每 24 小时 50 次，通过 /v1/shield/free 上的 X-Api-Key），而不是共享的按 IP 免费限制 （每 24 小时 5 次）。它是供 CI 流水线选择使用的便利功能——除此之外没有其他程序会读取它，也不会有任何密钥进入 PDR。

端点：

• API：https://api.aotrust.link/notarize
• MCP：https://api.aotrust.link/mcp
• 验证：https://verify.aotrust.link
• 文档：https://docs.aotrust.link

验证 API（公开、可嵌入）

验证是一个独立的公开 API——无需账户、没有速率限制，也无需付费。可将其嵌入你的产品（仪表板、审计工具、托管流程），或从终端调用：

# Verify a PDR (base64url-encoded bundle):
curl https://api.aotrust.link/v1/pdr/verify/<pdr_b64url>
# → {"valid": true, "checks": {...}, "error": null}

# Look up a PDR by Shield ID (8 hex chars):
curl https://api.aotrust.link/v1/shield/lookup/<shield_id>
# → {"found": true, "pdr_b64": "...", "shield_id": "..."}

# Get the notary public key for offline verification:
curl https://api.aotrust.link/v1/notary/pubkey

更偏好完全离线的信任验证？pdr_parser.py 可在本地验证任何 PDR——零依赖、无需网络，也无需信任我们的服务。

离线 Merkle 验证（已锚定的收据）

已锚定的 PDR 包含每日 Merkle 根，该根已提交到 NEAR 合约 notary-node.near——可通过任何公开的 NEAR RPC读取，永久有效，且独立于我们的服务。对于已锚定的 PDR，验证 API 会返回 merkle_proof、merkle_index、merkle_leaf 和 merkle_tree_size。 保存验证 JSON 响应——之后即可永久离线验证：

# (once) save the verify response when the receipt is fresh:
curl https://api.aotrust.link/v1/pdr/verify/<pdr_b64url> > verify.json

# (any time, no AOTrust server needed) check inclusion:
python3 verify_merkle_inclusion.py \
  --leaf <merkle_leaf> --proof <comma-joined merkle_proof> \
  --index <merkle_index> --root <merkle_root> \
  --tree-size <merkle_tree_size>
# → VALID

# the root can always be re-checked against the chain itself via any
# NEAR RPC: contract notary-node.near, method get_root({"seq": N})

verify_merkle_inclusion.py 是独立脚本，零依赖（采用 RFC 9162 §2.1.3.2 遍历方式，哈希算法与锚定引擎相同）。tree_size 必须取自验证响应（或已发布的锚定快照），不能由验证者自行选择。

PDR 规范与工具

• pdr-spec.md — PDR v2.3/v2.4 二进制格式（Internal 193B + External 239B，普通 + 双边）
• pdr_parser.py — 独立解析器，零依赖，离线验证
• aotrust-notarize/SKILL.md — 面向 AI Agent 的完整集成指南

对比

特性	AOTrust	Chainlink	OpenTimestamps	Notary.fyi
价格/PDR	$0.01	$0.25+	免费（速度慢）	$0.50+
支付方式	x402 USDC	LINK	Bitcoin TX	Stripe
PDR 格式	239B 二进制	Oracle 数据	OTS 文件	PDF
原生支持 AI Agent	MCP + HTTP	否	否	否
区块链锚定	NEAR（每日）	Ethereum	Bitcoin	无
离线验证	是（pdr_parser.py）	否	是	否

GitHub Action

在 CI/CD 中直接为构建产物或 AI 生成的文件公证——免费，无需钱包。

- uses: GitSerge-crypto/[email protected]
  with:
    files: dist/*

输出：shield_id、verify_url、pdr_b64。结果会以包含验证链接的 Markdown 表格形式显示在 $GITHUB_STEP_SUMMARY 中。

工作流示例

name: Release
on:
  release:
    types: [published]

jobs:
  notarize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: GitSerge-crypto/[email protected]
        with:
          files: dist/*
      - name: Show shield ID
        run: echo "Shield ID: ${{ steps.notarize.outputs.shield_id }}"

许可证

MIT