用途:指导 AI 智能体按固定流程规划、构建并部署完整的 Ethereum dApp,适用于 Scaffold-ETH 2(SE2)项目。核心是把工作分为三阶段,不可跳过或合并:合约→前端→生产。
主要能力与用法: 阶段一在本地分叉链上快速迭代。用 npx create-eth@latest my-dapp 初始化,yarn fork --network base 分叉真实链(可获 Uniswap、USDC 等真实协议状态),yarn deploy 部署,前端用 yarn start。要求为外部合约维护 externalContracts.ts,测试覆盖率≥90%,并在进入前端前做合约审计。前端必须使用 Scaffold 钩子而非裸 wagmi,如 useScaffoldReadContract、useScaffoldWriteContract、useScaffoldEventHistory。代币交互遵循三按钮流程:切换网络→授权→执行,禁止同时显示授权与执行。 阶段二把合约部署到主网或 L2,使用真实钱包小额测试并打磨 UI,部署后立即 yarn verify。 阶段三部署前端到 IPFS(yarn ipfs)或 Vercel(yarn vercel),并在部署前完成 QA 清单,如 burnerWalletMode 设为 localNetworksOnly、元数据与 OG 图更新、多钱包与移动端测试。
限制与注意:deployedContracts.ts 自动生成不可编辑;scaffold.config.ts 会提交到 Git,禁止硬编码 API 密钥,须用环境变量;提交前用 grep 检查密钥,.gitignore 须包含 .env、*.key、broadcast/、cache/ 等。IPFS 仅支持静态内容。出现阶段三 bug 回退阶段二,阶段二合约 bug 回退阶段一,禁止在生产中绕过问题。