内容
# AI 证明我们
AI 证明我们是一个 **MCP-first 接收协议，用于人类与 AI 合作**。
它从一个简单的信念开始：当人们花费数小时与 AI 代理一起构建、调试、研究、编写和协调时，这项工作应该能够留下一份私有的、可移植的接收凭证。
AIPOU 为 Codex、Claude、Cursor、OpenClaw、本地模型和其他 MCP 兼容的客户端提供了一种共享的方式，创建签名、隐私保护的 AI 辅助任务接收凭证。
人类奖励循环是关键：人们可以保存他们与 AI 合作一整天的工作凭证，验证者批准的凭证可以在 Base 上申领 AIPOU。该协议旨在使该申领工作更加诚实、可移植和有用。
开发者界面故意设计得很小：凭证、哈希、生命周期钩子和 `workReceiptId` 互操作性。代理、市场和服务也可以引用 AIPOU 凭证或在双方同意使用时，自愿接受 AIPOU 作为结算凭证。
首个版本发布内容包括：
- 记录隐私保护的 AI 任务凭证的 MCP 服务器
- 可安装的 OpenClaw 技能，用于代理工作流程
- MCP 客户端、代理构建者、生命周期适配器、防滥用和未来证明设计的文档
- 将有效凭证转换为可申领排放的奖励模型
- Base 上的 ERC-20 奖励代币：`AI Proof of Use` (`AIPOU`)
核心思想很简单：
```txt
代理启动任务 -> MCP 创建随机数 -> AI 工作发生 -> 签名凭证 -> 验证者检查 -> 可选 AIPOU 申领
```
如果您正在构建或测试代理集成，请从此处开始：
- [AIPOU 用于 AI 代理](docs/for-agents.md)
- [框架生命周期适配器](docs/framework-lifecycle-adapter.md)
- [工作凭证边界](docs/work-receipt-boundaries.md)
- [receiptId 和 workReceiptId 互操作性](docs/receiptid-interoperability.md)
- [方案中立的外部证据链接](docs/external-evidence-links.md)
- [MCP 工具](docs/mcp-tools.md)
- [OpenClaw 技能](skills/aipou-farming/SKILL.md)
- [本地凭证模式演示](examples/local-receipt-mode/README.md)
- [生命周期适配器示例](examples/lifecycle-adapter/README.md)
- [AutoGen 干预示例](examples/autogen-intervention/README.md)
- [npm 发布检查清单](docs/npm-publication.md)
- [注册信任检查清单](docs/registry-trust.md)
- [已过时代币健康状况快照](docs/token-health-2026-07-10.md)
- [BaseScan 验证和代币信息](docs/basescan-verification.md)
- [llms.txt](llms.txt)，一个紧凑的机器可读项目地图
阅读 [从 AI 工作到链上奖励](docs/farming-and-claims.md)，了解完整的旅程、全局耕作工作流程、奖励计算和一键申领体验。
阅读 [人类奖励和代理支付](docs/human-rewards-and-agent-payments.md)，了解人类奖励循环和实验性代理支付框架。
阅读 [AIPOU 代币经济学和启动透明度](docs/tokenomics.md)，了解供应、池、奖励和实验性启动细节。
阅读 [AIPOU 资金和合作伙伴简报](docs/funding-and-partnerships.md)，了解公共 Base 资助、协议合作伙伴和负责任流动性提案。
在提出与凭证、来源、安全或支付项目相关的集成之前，请阅读 [证据边界](docs/evidence-boundaries.md) 和 [申领验证策略](docs/claim-validation-policy.md)。
官方网站：https://0xddneto.github.io/AI-Proof-of-Us/
公共解释器：https://huggingface.co/spaces/0xddneto/AI-Proof-of-Us
官方项目联系方式：aipou001@gmail.com
项目身份和作者身份：
- [起源和作者身份记录](docs/origin-and-authorship.md)
- [AIPOU 名称和徽标政策](TRADEMARKS.md)
- [版权和项目通知](NOTICE)
`AIPOU` 和 `AI Proof of Us` 目前是未注册的项目标识符。MIT 许可证涵盖了软件，但不允许将另一个代币、服务或包作为官方 AIPOU 项目。
这不是“AI 使用挖掘”，它不是为了奖励原始提示垃圾邮件或吸引被动代币投机。AIPOU 适用于与 AI 合作的人类和希望测试其工作是否可以跨代理客户端生成可移植凭证的开发者。
用简单语言来说：
```txt
人类与 AI 合作 -> 代理创建凭证 -> 批准的凭证申领 AIPOU -> 代理和市场可能接受 AIPOU 作为结算凭证。
```
## Base 主网部署
```txt
合约：0x55f0Cc5e51A1284D20337d6cbb18938C8A1ABCbB
链：Base 主网 (8453)
代币：AI Proof of Use (AIPOU)
供应量：100,000,000 AIPOU
上限：1,000,000,000 AIPOU
徽标：assets/token/aipou.png
```
- 合约：https://basescan.org/token/0x55f0Cc5e51A1284D20337d6cbb18938C8A1ABCbB
- 验证源：https://repo.sourcify.dev/contracts/full_match/8453/0x55f0Cc5e51A1284D20337d6cbb18938C8A1ABCbB/
- 代币列表：https://raw.githubusercontent.com/0xddneto/AI-Proof-of-Us/main/tokenlist.json
- BaseScan SVG 徽标：https://raw.githubusercontent.com/0xddneto/AI-Proof-of-Us/main/assets/token/aipou-32.svg
```txt
申领：0x4ca4C98fB784D20EdC8E2A7F531dAab4c6e53058
证明：EIP-712 + Ed25519 + Merkle
重放：被随机数和 receiptId 阻止
```
- 申领合约：https://basescan.org/address/0x4ca4C98fB784D20EdC8E2A7F531dAab4c6e53058
- 验证申领源：https://repo.sourcify.dev/contracts/full_match/8453/0x4ca4C98fB784D20EdC8E2A7F531dAab4c6e53058/
## Aerodrome 流动性池
```txt
池：0x3bEA7b68Af54Da779454f82148Ef848c76F78D02
对：AIPOU/WETH
类型：波动性
初始 LP：100,000,000 AIPOU + 0.000632035343416403 ETH
LP 锁定：0xc11197E32dFb2352f262D874acFc54467aee6B52
解锁：2027-07-08 20:16:49 UTC
```
- 池：https://basescan.org/address/0x3bEA7b68Af54Da779454f82148Ef848c76F78D02
- 验证流动性锁定：https://basescan.org/address/0xc11197E32dFb2352f262D874acFc54467aee6B52#code
- DEX Screener：https://dexscreener.com/base/0x3bea7b68af54da779454f82148ef848c76f78d02
该池最初以最小的 ETH 流动性启动，后来加深到大约 `99.23M AIPOU + 0.02957 WETH`。总共 `1,712.89145801936861611` 个 LP 代币，代表 `99.9999%` 的 LP 供应量，由一个不可变的锁定持有，直到 2027 年 7 月 8 日。锁定没有所有者、管理員或提前退出路径；到期后，任何人都可以触发释放，但 LP 代币只能返回到固定的受益人。
流动性仍然很小，其价格仍然波动。锁定防止协议钱包在发布期间移除锁定头寸；它不保证代币价值、交易量或未来流动性。
初始实验池购买后通过 Aerodrome 返回，以便大额早期购买不会作为误导性集中持有者余额。参见 [AIPOU 代币经济学和启动透明度](docs/tokenomics.md)。
## 仓库布局
```txt
contracts/ ERC-20 代币，部署脚本，Hardhat 测试
mcp-server/ 记录 AI 任务凭证的 MCP 服务器
docs/ 架构，防滥用模型，Base 启动说明
skills/ 可安装的代理技能，包括 OpenClaw
huggingface-space/ 静态公共协议解释器
```
## 代币
```txt
名称：AI Proof of Use
符号：AIPOU
链：Base
上限：1,000,000,000 AIPOU
```
代币排放控制器是 `AIPOUClaims`。它仅铸造包含在验证者发布的 Merkle 根中的凭证，并拒绝凭证 ID 在其首次申领后。
AIPOU 申领是批准凭证的可选结算。它们不证明隐藏的 AI 使用、客观任务价值、提供者认可、提供者推理（无需加密提供者证据）或安全策略合规。
## MCP 服务器
MCP 服务器公开用于创建任务凭证的工具：
- `get_aipou_contract`
- `get_aipou_identity`
- `estimate_ai_reward`
- `begin_ai_task`
- `complete_ai_task`
- `export_ai_receipts`
- `get_aipou_status` （记录、待处理、已申领和链上余额摘要）
- `settle_ai_rewards` （一个有限的验证者批次）
- `settle_all_ai_rewards` （所有待处理合格凭证的一键申领路径）
凭证存储哈希和元数据，而不是原始提示或模型输出。
专用耕作密钥在本地签署 EIP-712 授权。永远不要将其粘贴到聊天中或在主要钱包中使用。收集器具有单独的 Ed25519 密钥，无法移动资金。
框架不需要了解 Merkle 树、Base 或代币申领即可集成凭证层。最小适配器监视任务开始和任务结束，记录提供者/模型元数据和哈希，并将 AIPOU `receiptId` 公开为 `workReceiptId`，用于工作流元数据、跟踪、UI、审计导出、支付/会话记录或后续可选结算。
## 快速开始
### 创建已验证的本地凭证
这是最低摩擦的采用测试 - 一个命令，无需检查，无需设置：
```bash
npx -y aipou-mcp-server --demo
```
它创建了一个短暂的钱包，记录并加密验证一个本地凭证，打印 `workReceiptId` 集成对象，然后删除所有临时状态。它不需要钱包设置、资金、网络访问、申领或原始提示和输出存储。
### 创建持久的专用身份
在评估一次性演示后，使用以下命令初始化专用耕作钱包，而不打印其私钥：
```bash
npx -y aipou-mcp-server --init
```
该命令创建 `~/.aipou/agent-wallet.key`，并具有受限的文件访问权限，并打印一个准备好复制的 MCP 配置，该配置通过路径引用密钥。通过重新运行，它报告现有的身份，而不是覆盖密钥。
从源代码检出后，相同的检查运行：
```bash
npm install
npm run demo -w mcp-server
```
### 测试凭证适配器
这是维护人员和代理框架构建者的最快路径。它使用临时钱包创建本地凭证，并打印框架可以附加的 `workReceiptId` 对象，用于运行元数据、跟踪、审计导出或支付/会话元数据。
```bash
npm install
npm run build -w mcp-server
cd examples/lifecycle-adapter
npm install
npm run demo
```
不会发出申领。不会移动资金。不会上传原始提示或输出。
### 运行 MCP 服务器
安装依赖：
```bash
npm install
```
构建所有软件包：
```bash
npm run build
```
运行合约测试：
```bash
npm run test -w contracts
```
在本地运行 MCP 服务器：
```bash
npm run dev -w mcp-server
```
MCP 客户端可以使用发布的服务器启动：
```bash
npx -y aipou-mcp-server
```
版本 `aipou-mcp-server@0.3.1` 已在 npm 上发布，并在官方 MCP 注册表中标记为最新版本。它是从 GitHub Actions 通过 npm Trusted Publishing 与 SLSA 源代码证明发布的。参见 [docs/npm-publication.md](docs/npm-publication.md)。
## 本地 MCP 配置示例
将耕作私钥保存在 `.env` 文件中，并指向服务器：
```json
{
"mcpServers": {
"aipou": {
"command": "node",
"args": ["/path/to/AI-Proof-of-Us/mcp-server/dist/index.js"],
"env": {
"DOTENV_CONFIG_PATH": "/path/to/AI-Proof-of-Us/.env",
"AIPOU_DATA_DIR": "/path/to/AI-Proof-of-Us/.aipou"
}
}
}
}
```
优先使用 `--init` 生成的 `AIPOU_AGENT_KEY_FILE`，而不是在客户端配置中嵌入 `AIPOU_AGENT_PRIVATE_KEY`。`.env` 文件仍可以保存私钥以保持向后兼容，并且 `AIPOU_CLAIMS_ADDRESS`。在验证者机器上，将验证者密钥存储在单独的文件中，并使用 `AIPOU_VALIDATOR_KEY_FILE` 引用，以便仅限耕作进程永远不会加载它。
## 奖励流程
1. 代理调用 `begin_ai_task` 并使用其耕作钱包签署唯一的随机数。
2. 客户端收集使用情况并调用 `complete_ai_task`，并输出哈希。
3. MCP 派生信任等级并使用 Ed25519 签署凭证。
4. 验证者拒绝重复的随机数和重复的任务/输出证据。
5. `get_aipou_status` 让用户查看已记录、已申领和待处理的金额。
6. 在明确的结算请求后，`settle_all_ai_rewards` 以有限的批次处理所有当前合格的待处理凭证。
7. `AIPOUClaims` 拒绝已申领的凭证 ID，并向每个耕作钱包铸造 AIPOU。
用户通常应该首先请求状态，例如 `show my AIPOU status`，以查看已申领的奖励、待处理的凭证和耕作钱包的链上余额。诸如 `claim my AIPOU` 之类的显式请求仅在存在待处理合格凭证时触发结算。批量申领请求使用 `settle_all_ai_rewards`；`settle_ai_rewards` 仍然可用于单个有限批次。MCP 客户端及其用户对如何确认链上交易拥有最终决定权；服务器永远不会要求客户端跳过其自己的确认策略。验证者可以选择强制执行结算策略（每个凭证的最低工作底线，通过 `AIPOU_MIN_RECEIPT_TOKENS`，每个钱包的每日凭证限制，通过 `AIPOU_MAX_DAILY_RECEIPTS_PER_WALLET`）；两者默认情况下均已禁用。
信任等级由 MCP 派生，并由验证者重新计算。用户不能自我报告 `provider_signed`；提供者等级需要来自已配置的公钥的有效提供者签名。
参见 [docs/base-launch.md](docs/base-launch.md) 以获取部署检查清单。
## 公共启动
- Hugging Face Space：https://huggingface.co/spaces/0xddneto/AI-Proof-of-Us
- Reddit 公告：https://www.reddit.com/user/Any_Praline805/comments/1uklabn/i_built_an_open_mcp_protocol_that_rewards/
- 外联工具包：[docs/outreach](docs/outreach/README.md)
- 官方联系方式：aipou001@gmail.com
## 安全和滥用警告
AI 工作如果协议仅计算代币或会话时间，则很容易造假。AIPOU 应发展为更强的信号：
- 提供者签名的使用断言
- MCP 客户端签名
- 与实际工作链接的任务哈希
- 权益或奖励运营商的质押或削减
- 人类或社区对高价值申领的验证
代币可以提前发布，但排放应该从保守开始。
明确限制：
- AIPOU 不是 AI 使用检测器。
- AIPOU 不是扫描器或策略门。
- AIPOU 不信任地证明“有用工作”今天。
- 当前验证者是 `client_signed` 凭证的协议权威。
- AIPOU 工作凭证不替换更狭窄的工具调用、边界事件、支付或策略凭证；它们可以相互引用。
- AIPOU 不替换 SLSA 式源代码、代理安全扫描器或可观察性跟踪。
- AIPOU 不替换 x402、AP2、稳定币或钱包自动化。
- AIPOU 仅在参与者自愿接受时可用作支付。
- `client_signed` 凭证目前依赖于验证者策略和受信任的收集器指纹。
- 严重的采用应该将所有者和验证者权限转移到多重签名并发布明确的验证者规则。
