Concourse: 24 小时把一个 ERC-8004 agent 真的部署上链

status

Published

type

Post

0. TL;DR

用 1 天时间，把一个酒店做成 ERC-8004 trustless agent：

链上：3 个合约部署在 Base Sepolia，Basescan-verified，73 Foundry 测试 100% 覆盖

服务：Hono + Drizzle + better-sqlite3 模板，5 个酒店 skill，36 vitest 全过

上线：wumingchu.concourse.paking.xyz 跑在 Fly Tokyo，LetsEncrypt 自动 cert

上链：agentId=1 register 完成，浏览器实时 SHA-256 验证服务出的 card == 链上 commit

demo：17 秒 1920×1080 MP4，所有数字都是真链上 + 真服务返回的

任何人现在跑这条命令，就能验证 agent #1 在链上存在：

1. 为什么做这个

底层逻辑：今天每家 OTA（Booking、携程、Agoda）都有自己的 API、自己的格式、自己的认证。AI agent 想帮人订全球酒店、餐厅、景点，得对接几十种不同的 API——这是个 N × M 问题。

Concourse 押的赌注：让每个商家自己变成一个标准化的 agent，按 ERC-8004 + A2A Agent Card 在链上注册。任何 AI agent 拿到 agentId 就能直接跟这家商家对话——不用经过任何平台。

生态信号（不是 PPT 自嗨）：

ERC-8004 2026-01-29 在 Ethereum 主网上线

8004scan.io 由 AltLayer / Alt Research 维护，47000+ agents 已注册

Coinbase x402 (HTTP 402 payment) + Anthropic MCP + Google A2A 三家都在推自己的 agent 标准

a16z 公开发了 "Trustless Agents" 研究

赛道是真的。问题是：你在这条赛道上的位置。

2. 架构层级

三个原则：

协议层免费（ERC-8004 + A2A 完全开放）

托管层付费（自托管 / 平台托管二选一，平台托管按月收费）—— 这是 Stripe / Vercel / Supabase 模式

链上 hash 是最终真相（任何人浏览器算 SHA-256 就能验服务有没有被篡改）

3. 真实做了什么——Phase A 全部交付物

A.2 ERC-8004 合约（Solidity / Foundry）

evmVersion cancun、optimizer 200、73 个 Foundry 单元测试 + 模糊测试 100% 覆盖。Base Sepolia 部署地址：

IdentityRegistry: 0xBdE5A55D50d2062FF5529546d8c391f6a6eEA29f

ReputationRegistry: 0xcaC08083B58c7736bDf953dafeC3C3395f0D90c6

ValidationRegistry: 0x60B0E530621488C985A394686F3E54282D579107

A.3 Merchant-agent 开源模板

Hono + Drizzle + better-sqlite3 + viem + Zod + vitest。任何商家 30 分钟就能上线一个自己的 agent：

5 个酒店 skill：check_availability / get_rates / create_booking / get_room_types / get_cancellation_policy。每个都有严格的 Zod schema 和对应的 JSON Schema 描述（暴露给 LLM 做 tool calling 时用）。

A.5 第一个真 live agent

无名处·黄山隐世归朴酒店 部署在 Fly.io Tokyo，DNSPod CNAME 到自有域名 wumingchu.concourse.paking.xyz，LetsEncrypt 自动签 RSA + ECDSA 双证书。

打开 agent-card 就能看到这家酒店的所有信息——名字、地点、5 个 skill、3 个房型、价格、付款地址。

A.7 链上验证型前端

concourse.paking.xyz/explorer 直接用 ethers v6 读 IdentityRegistry——没有后端代理：

列出 totalAgents() 个 agent

每个 agent fetch 自己的 card

浏览器算 SHA-256(card bytes)，跟链上 hash 比对

一致才显示 ✓ verified 绿盾

点开模态框直接 POST 调 skill

任何客户端都能复用这套验证流程——这是协议级 trustless 的精髓。

4. 踩过的真实坑

这一天踩的坑都写进了 merchant-agent-template/TROUBLESHOOTING.md。挑几个有意思的：

⚠ pnpm 10 默认禁 install 脚本

better-sqlite3 是 native module，必须在 install 阶段编译。pnpm 10 出于安全考虑默认 skip 所有 install scripts。Docker 容器一启动就 Could not locate the bindings file 死循环。

修法：根 package.json 加：

⚠ Foundry vm.envUint 必须 0x 前缀

DEPLOYER_PRIVATE_KEY 用 cast wallet new 生成的没带 0x，直接 source 进 forge script 会 revert in simulation。

⚠ ABI tuple 解码 vs multi-return

getAgent(uint256) 返回的是 Solidity struct——ABI 编码是一个 tuple，不是 6 个分离值。写成 multi-return 的 ABI fragment 会让 ethers v6 报 BAD_DATA，viem 报 Number not in safe integer range（bytes32 hash 被错位读成 uint256）。

修法：ABI 用 tuple 包：