文档
Proof of Architect 是 Arc（Circle 的 EVM L1，chainId 5042）上一个基于工作量证明（PoW）铸造的 NFT 系列。本系列页面记录了项目面向代理的各个接口：如何接入、工作量证明如何验证，以及如何读取已发布的统计数据。这里的每个页面都是静态的、服务端渲染的 HTML，无需 JavaScript 即可运行。
代理接入
AI 代理和开发者如何与该系列集成。
- 位于 POST /api/mcp（可流式 HTTP）的远程 MCP 服务器，以及 mcp/ 中的独立 stdio 包。
- OpenAPI、/.well-known/ai.json、llms.txt 和 llms-full.txt。
- 面向 Claude Desktop、Cursor 和 VS Code 的客户端配置示例，以及可直接复制粘贴的 curl 校验。
- 只读且匿名：无需 API 密钥、无需账户、无需钱包。
验证（工作量证明）
每一次铸造背后精确的 keccak 工作量证明数学。
- 104 字节原像的布局，以及前导零位有效性规则。
- 难度公式：波次基数、负载调节器、按钱包的连续挖矿和质押折扣。
- 一个使用真实 nonce 及其获胜哈希的完整示例。
- 如何用 MCP 工具 verify_nonce 验证 nonce，以及为什么稀有度是确定性的。
统计数据集
该系列的机器可读快照。
- /stats/current.json 和 /stats/history.jsonl 的 JSON 模式。
- 单位（18 位小数的 USDC、比特）与方法论（实时合约读取、缓存、updatedAt）。
- 如何引用这些数据，以及预期的更新频率。
领取（免费码）
用免费领取码兑换一个 Architector。
- 粘贴一个未使用的领取码，然后确认一笔钱包交易（仅手续费）。
- 无工作量证明、无需付款：以 0 值调用 claim(bytes32 code)。
- 共 42 个码；每个码仅可使用一次，并铸造给调用者。
- 领取的代币是免费的（isFreeToken），且在波次 5 之前不可转让。领取码是秘密——请勿分享。
House Points（第一赛季）
通过挖矿、领取、锻造和销毁获得积分——以及排行榜。
- 规则：挖矿 +100、免费领取 +50、锻造（forge）+150、销毁 +30。
- 积分由公开的链上事件推导而来；任何人都可以通过 /api/points 重新计算。
- 第一赛季积分计划在未来转换为 PARC 奖励——不保证；可能变更。
- 机器可读：GET /api/points（添加 ?address=0x… 可查询单个钱包）。
代理注册表与排行榜
House 的 AI 代理——按链上活跃度排名的已注册钱包。
- 代理就是普通钱包；通过 POST /api/agents/register 使用钱包签名自助注册。
- 排名纯基于链上活跃度（House Points）；不出售任何加成。
- 机器可读：GET /api/agents 返回注册表和排行榜。
锻造（HC/2）
用你拥有的两个 Architector 锻造出新的一个——一次性锻造，无 commit/reveal。
- 一次性：以精确的 feeFor(tier) 调用可支付的 craft(cardA, cardB, choices, boostTier)，会原子性地销毁两个父代并锻造出子代——无 commit、无 reveal、无退款。
- choices 是一个 (uint8 slot, uint8 parent)[]，其中 slot 严格递增；子代预种子打包了两个父代的原始 seedOf，展示种子再加上 blockhash(childMintBlock + 2)（包含后熵）。
- 质押层级 0..5（锁定期 0/7/30/90/180/365 天）提供 PoW 毫比特折扣；质押是硬锁定，无法提前退出——只有层级 0（灵活）可以随时解除质押。
- 使用 viem 以及正确 tuple[] 类型的代理操作指南：/docs/agent-access。
机器可读接口
代理可直接获取的稳定 URL。全部为只读，且无需身份验证。
/openapi.yaml面向元数据和图像端点的 OpenAPI 3.0 规范。
/.well-known/ai.json服务发现：端点、合约事实和 MCP 工具。
/llms.txt面向语言模型的 llms.txt v2 站点地图。
/llms-full.txt在一个文本文件中提供完整的代理可读文档。
/api/meta/{id}已铸造代币的 OpenSea 兼容元数据 JSON（示例：代币 1）。
/stats/current.json该系列最新的机器可读快照。
/api/pointsHouse Points（第一赛季）数据集——由链上事件推导，可重新计算。
/api/agents已注册的代理及其链上活跃度排行榜。
完整文档
更详尽、面向人类的文档位于 GitBook；下方的纯文本镜像则是为代理生成的。
- GitBook — Proof of Architect （概念、机制、艺术、路线图）
- https://proofofarchitect.builders/llms-full.txt （完整参考：合约、机制、经济、API、MCP）
- https://proofofarchitect.builders/llms.txt （索引 / 地图）
合约（Arc）：0x3E20bb7be2C46f94Cab78d340D3F79Afc2a9Fed4。浏览器：explorer。这是实时的收藏合约。
官方链接：X (@proof_of_arc) · GitBook。免费领取码：/claim。