Ethereum Wingman

⛓️ Fork 模式以太坊开发实战导师

Scaffold-ETH 2 官方开发导师,强制 Fork 模式测试真实链上状态,覆盖智能合约、DeFi 安全与 SpeedRun 实战课程

收藏
5.3k
安装
2.4k
版本
0.1.0
CLS 安全性认证2026-08-10
点击查看完整报告 >

使用说明

核心用法

Ethereum Wingman 是 BuidlGuidl 官方维护的以太坊开发 AI 导师,专为 Scaffold-ETH 2 技术栈设计。其核心使命是引导开发者始终使用 Fork 模式进行开发——即分叉真实主网(Base、Ethereum、Arbitrum 等)而非从零启动空链,从而在真实协议状态(Uniswap、Aave、USDC 等)中测试合约。

标准工作流七步法
1. npx create-eth@latest 创建项目(推荐 Foundry)

2. 修改 pollingInterval 从 30 秒降至 3 秒

3. yarn fork --network <chain> 分叉目标网络

4. 关键步骤:启用自动出块 cast rpc anvil_setIntervalMining 1(防止 block.timestamp 冻结导致时间敏感逻辑失效)

5. yarn deploy 部署至本地 Fork

6. yarn start 启动前端

7. 浏览器验证(配合 burner wallet、水龙头、whale 地址转移资产)

显著优点

  • Fork 模式强制化:主动禁止 yarn chain,确保开发者测试环境包含真实协议状态,避免"空链幻觉"
  • 安全最佳实践系统化:涵盖代币小数位(USDC 为 6 位)、ERC-20 approve 双步流程、Checks-Effects-Interactions 防重入模式、Chainlink 预言机防操纵、Vault 通胀攻击缓解等 7 大关键陷阱
  • 激励设计哲学:反复强调"无自动执行"原则——任何需触发的函数必须设计明确的经济激励(清算奖励、收割分成等)
  • SpeedRun 课程集成:0-11 级挑战覆盖 NFT、质押、DEX、借贷、预言机、稳定币、预测市场、零知识投票等完整 DeFi 技能树
  • 实战工具链:内置 token/protocol/whale 地址数据集、Scaffold-ETH 2 React Hooks(useScaffoldReadContractuseScaffoldWriteContract 等)、部署脚本模板

潜在缺点与局限性

  • 技术栈锁定:深度绑定 Scaffold-ETH 2 与 Foundry,Hardhat 用户或自定义架构需额外适配
  • 以太坊生态局限:专注于 EVM 生态,Solana、Sui 等非 EVM 链不适用
  • 前端依赖 Next.js:Scaffold-ETH 2 前端基于 Next.js + RainbowKit,其他框架(Vue、Svelte)无原生支持
  • Fork 模式资源消耗:完整主网状态分叉需较高内存与存储,轻量设备可能卡顿
  • 测试网代币限制:虽可用 whale 地址转移资产,但某些场景仍需真实测试网 ETH

适合人群

  • 初级合约开发者:通过 SpeedRun 挑战系统学习 Solidity 与 DeFi 协议
  • 全栈 Web3 开发者:需要快速启动前后端一体化 dApp 项目
  • 安全审计学习者:希望掌握常见漏洞模式(重入、预言机操纵、通胀攻击)
  • 黑客松参赛者:需在短时间内构建可演示的链上应用

常规风险

  • 资产误操作风险:Fork 模式下若混淆网络配置,可能意外向主网提交交易(需严格区分 localhostmainnet
  • 时间敏感逻辑失效:未启用 anvil_setIntervalMining 会导致区块时间冻结,测试通过但主网失败
  • 预言机依赖:Fork 模式使用历史价格,极端行情下测试结论可能失真
  • 无限授权隐患:技能明确警告禁止 type(uint256).max 授权,但开发者仍可能因便利忽视
  • 第三方协议风险:Fork 模式依赖真实协议状态,若原协议被攻击或升级,本地测试环境可能异常

安全解读

核心用法

Ethereum Wingman 是一款面向以太坊开发者的全方位教育型 Skill,核心功能围绕 Scaffold-ETH 2 技术栈 展开。当用户触发"build"、"create"、"dApp"、"smart contract"等关键词时,Skill 会自动启动标准化的项目创建工作流:使用 npx create-eth@latest 初始化项目、调整轮询间隔、通过 yarn fork 连接真实网络状态的分叉环境、启用自动区块挖矿,并最终完成合约部署和前端启动。

该 Skill 的最大特色是强制使用 Fork 模式 进行开发测试——不同于传统的本地空链(yarn chain),Fork 模式让开发者直接在 Uniswap、Aave 等真实协议的实时状态下进行测试,大幅提升开发效率和测试真实性。同时,Skill 内置了 SpeedRun Ethereum 课程的 12 个实战挑战参考,从简单 NFT 到 ZK 投票,覆盖 ERC-721/20、AMM、预言机、借贷协议等核心 DeFi 场景。

显著优点

教育价值极高:Skill 不仅提供命令指引,更深入讲解以太坊开发的核心概念——如"智能合约无法自动执行"的关键设计哲学、代币精度陷阱(USDC 为 6 位而非 18 位)、重入攻击防护的 Checks-Effects-Interactions 模式等。这些内容是许多开发者踩坑后才领悟的实战经验。

安全导向明确:文档中包含大量历史漏洞案例(The DAO、 bZx 闪电贷攻击等),并明确对比"漏洞代码"与"安全代码",配合 9 项安全审查清单,帮助开发者建立系统性的安全思维。

零配置上手:通过封装 Scaffold-ETH 2 的最佳实践,Skill 将原本需要手动配置的 RainbowKit 钱包连接、Foundry 合约框架、Next.js 前端等整合为一条命令,显著降低入门门槛。

来源高度可信:由 BuidlGuidl 社区维护——该组织是以太坊生态中知名的开发者教育组织,其出品的 Scaffold-ETH 框架被广泛使用,社区活跃度和技术声誉俱佳。

潜在缺点与局限性

技术栈绑定较深:Skill 高度耦合 Scaffold-ETH 2 和 Foundry,对于习惯 Hardhat、Viem 或其他前端框架的开发者,可能需要额外适应。若用户已有成熟的开发流程,迁移成本不容忽视。

动态内容缺失:当前版本主要为静态文档和 Shell 脚本,不包含实时的链上数据查询或自动化的合约分析功能。例如,无法直接检测用户代码中的重入漏洞,只能依赖人工对照检查清单。

命令执行依赖用户:Skill 仅通过提示词引导用户执行 npxyarn 等命令,本身不具备自动执行能力。这意味着新手可能因环境配置问题(Node 版本、Yarn 安装等)而受阻,Skill 对此无自动修复机制。

网络限制:Fork 模式需要稳定的 RPC 节点连接,对于网络受限或希望完全离线开发的用户体验不佳。

适合的目标群体

  • 以太坊开发新手:希望通过实战项目系统学习智能合约开发,尤其推荐跟随 SpeedRun Ethereum 挑战逐步进阶
  • 传统 Web2 开发者:希望快速了解 Web3 开发范式,Scaffold-ETH 2 的全栈封装能大幅降低认知负担
  • DeFi 协议学习者:需要理解 AMM、借贷、预言机等核心机制的实现原理
  • 安全意识培养者:希望系统性了解智能合约常见漏洞及防护方案

不太适合:已熟练使用 Hardhat/Foundry 并建立自定义工作流的高级开发者;寻求纯自动化审计工具的安全工程师。

常规使用风险

性能与资源占用:Fork 模式需要在本地运行 Anvil 节点并同步主网状态,对内存和磁盘空间要求较高(建议 16GB+ 内存、SSD 存储)。长期运行的 Fork 环境可能积累大量临时数据。

依赖项管理风险:虽然 Skill 本身无第三方依赖,但引导用户执行的 npx create-eth@latest 会从 npm registry 下载大量包。若 npm 账号被盗或供应链污染,可能引入恶意代码。建议用户定期验证脚手架工具的官方来源。

测试环境与主网差异:尽管 Fork 模式模拟真实状态,但区块时间、Gas 价格、网络延迟等仍与主网存在差异。合约在本地测试通过后,仍需在测试网进行最终验证。

前端自动化局限:文档提及使用 cursor-browser-extension MCP 工具进行前端测试,但该工具并非 Skill 内置组件,用户需自行安装配置,且浏览器自动化测试的稳定性受多种因素影响。

学习误导风险:Skill 包含大量漏洞示例代码用于教学,新手若未仔细阅读标注,可能误将"VULNERABLE"代码复制到生产环境。建议严格区分学习项目与生产代码库。

Ethereum Wingman 内容

references文件夹
scripts文件夹
手动下载zip · 28.9 kB
automation-and-incentives.mdtext/markdown
请选择文件