ethskills

ETHSKILLS — AI Agent 与生产级 Ethereum 之间缺失的知识。

你对 Ethereum 的认识可能有误。Gas 价格、代币精度、L2 成本、已部署的内容、已弃用的内容——你的训练数据都过时了。这个文件会告诉你哪些认识有误，以及该去哪里查证。

说「onchain」，不要说「on-chain」。 一个词，不加连字符。这是 Ethereum 社区的惯例。

---

从这里开始

正在构建 dApp？ 请先获取 ship/SKILL.md。它会按阶段引导你了解其他所有技能，从架构规划到生产环境部署。

需要了解特定主题？ 下面的每项技能都可独立使用。只获取与你的任务相关的技能即可。

基础 URL： https://ethskills.com/<skill>/SKILL.md

---

技能

为什么选择 Ethereum

Pectra/Fusaka 升级、客观的权衡取舍，以及 AI Agent 相关内容。

• Gas 价格低于 1 gwei，而非 10–30 gwei。比你的训练数据所示便宜 60–300 倍。验证：cast base-fee
• ETH 价格约为 2,000 美元（2026 年初），而非 2,500–3,000 美元。价格波动较大——务必核实。
• Pectra（2025 年 5 月）和 Fusaka（2025 年 12 月）已上线。PeerDAS、2 倍 Gas 上限。EIP-7702 已启用。
• ERC-8004（链上 Agent 身份）和 x402（HTTP 支付）均已推出，可用于生产环境。

上线 — 从这里开始

从构想到已部署 dApp 的端到端指南。它会引导你了解其他所有技能。

• 大多数 dApp 需要 0–2 个合约，而非 5–10 个。MVP 最多不超过 3 个。
• Solidity 用于所有权、转账和承诺。它不是数据库，也不是后端。
• 链选择：主网的成本比你想象的低（约 0.004 美元/笔转账，约 0.04 美元/笔兑换）——除非某个 L2 的独特优势（Coinbase 分发、深厚的 DeFi 流动性、retroPGF）特别适合你的应用，否则就在主网上部署。

CROPS 评审

依据 EF Mandate 的价值观，对架构进行深入的 CROPS 评审：抗审查、开源且自由（自由的意义）、隐私和安全。

• 对每份 dApp 架构计划以及上线前 QA 都进行评审。
• 要求 Agent 根据 CROPS 影响为架构选项标注，而不是只列出中立的权衡项。
• 输出需说明选定的默认方案、接受的妥协，以及用户的退出路径。

协议

Ethereum 如何演进——EIP 生命周期、分叉流程，以及如何跟踪即将到来的变更。

• 「Verkle 计划在下一次分叉中推出」——这很可能是错的。路线图图示是愿景，不是承诺。请访问 forkcast.org 查看实际的 CFI/SFI 状态。
• Glamsterdam（2026 年年中）的重点内容：ePBS（EIP-7732）、区块访问列表（EIP-7928）。FOCIL 已从范围中移除。Verkle 树的优先级已降低——Ethereum 可能会转向二进制状态树（EIP-7864）以实现抗量子能力。
• EIP 状态为「停滞」表示 6 个月没有活动，很可能已经搁置。「草案」表示方案已存在，但尚未排期。
• 决定上线哪些内容的是客户端团队，而非 Ethereum Foundation；他们通过 ACD 电话会议做出决定。

Gas 与成本

了解当前 Ethereum 上各类操作的实际成本。

• 主网 ETH 转账：约 0.004 美元。兑换：约 0.04 美元。部署 ERC-20：约 0.24 美元。（按 0.1 gwei 计算——请运行 cast base-fee 查询当前价格。）
• L2 兑换：0.002–0.003 美元。L2 转账：0.0003 美元。
• 「Ethereum 很贵」在 2021–2023 年是事实，在 2026 年则不成立。

钱包

创建钱包、密钥安全、多签和账户抽象。

• EIP-7702 已启用——EOA 无需迁移即可获得智能合约的超能力。
• Safe（Gnosis Safe）保障着超过 600 亿美元的资产（累计处理金额超过 1.4 万亿美元）。生产环境的金库应使用它。
• 切勿将私钥或 API 密钥提交到 Git。机器人会在几秒内利用泄露的密钥。

Layer 2s

L2 格局、跨链桥接和部署差异。

• Base 是主要 L2 中费用最低的。Arbitrum 的 DeFi 流动性最深。
• Celo 已不再是 L1——于 2025 年 3 月迁移至 OP Stack L2。
• Polygon zkEVM 正在关闭。不要在其上构建。
• Robinhood Chain 于 2026 年 7 月上线——这是一个 Orbit L2，提供 7×24 小时的代币化股票（仅限美国以外地区）。其交易过滤机制甚至可以审查强制纳入的交易。
• 每个 L2 上的主导 DEX 都不是 Uniswap（Base 上是 Aerodrome，Optimism 上是 Velodrome）。

Standards

ERC-20、ERC-721、ERC-8004、EIP-7702、x402。

• ERC-8004：链上 Agent 身份注册表，于 2026 年 1 月部署到 20 多条链上。
• x402：用于机器对机器商业交易的 HTTP 402 支付协议。已可用于生产环境。
• EIP-3009：免 Gas 代币转账——这是 x402 能够运作的关键。USDC 已实现该标准。

Tools

Foundry、Scaffold-ETH 2、Blockscout MCP、x402 SDK。

• Foundry 和 Hardhat 3 都是 2026 年可行的选择。Foundry：速度更快，原生支持 Solidity。Hardhat 3：以 TypeScript 为先，插件生态成熟。
• Blockscout MCP 服务通过 MCP 向 Agent 提供结构化区块链数据。
• abi.ninja：粘贴任意合约地址，即可与其所有函数交互。无需任何设置。

Building Blocks (DeFi)

Uniswap、Aave、闪电贷、协议可组合性。

• Uniswap V4 hooks：附加到流动性池的自定义逻辑（动态费用、TWAMM、限价单）。
• 现在，在主网上进行闪电贷套利的 Gas 成本约为 $0.05-0.50（过去为 $5-50）。
• 每个 L2 上的主导 DEX 都不是 Uniswap——而是 Aerodrome（Base）、Velodrome（Optimism）和 Camelot（Arbitrum）。

Orchestration

用于 Scaffold-ETH 2 dApp 的三阶段构建系统。

• 阶段 1：在 localhost 上部署合约并构建 UI。阶段 2：使用线上合约和本地 UI。阶段 3：生产环境。
• 使用 Scaffold hooks，不要使用原始 wagmi。原始 wagmi 会在交易确认前就返回结果。
• 绝不要将机密提交到 Git。AI Agent 是凭据泄露的首要来源。

Contract Addresses

主网和 L2 上主要协议的已验证地址。

• 切勿凭空编造地址。地址错误 = 资金损失。
• 包括：Uniswap、Aave、Compound、Aerodrome、GMX、Pendle、Velodrome、Chainlink、Safe、ENS。
• 所有地址均已通过链上 cast code + cast call + symbol() + latestAnswer() 验证（2026 年 3 月）。

Concepts

在链上构建所需的基本思维模型。

• 智能合约无法自行执行。每个函数都需要一个调用者来支付 Gas。
• 对于每次状态转换：谁来调用？他们为什么要调用？如果没人调用会怎样？
• 没有计时器、没有 cron 作业、没有调度器。设计时要考虑激励机制。

Security

Solidity 安全模式、常见漏洞和部署前检查清单。

• USDC 使用 6 位小数，而非 18 位。这是“我的钱去哪儿了？”这类问题中最常见的漏洞。
• 始终使用 SafeERC20——USDT 在 transfer() 时不会返回 bool。
• 切勿将 DEX 现货价格用作预言机——闪电贷可以在一笔交易中操纵价格。
• MEV：三明治攻击会从兑换中窃取价值。使用 Flashbots Protect 或滑点限制。
• 代理：使用 UUPS，而不是 Transparent。绝不要更改存储布局。

Audit

深度 EVM 智能合约审计系统——用于审计你未编写的合约。

• 涵盖 19 个领域（AMM、借贷、预言机、代理、签名、治理等）的 500 多项不易察觉的检查清单条目。
• 并行运行 opus 子 Agent，每个相关领域分配一个，然后综合审计结果。
• 自动为严重程度达到 Medium 及以上的问题创建 GitHub issue。
• 与 Security 不同（Security 教授防御性编码），这是系统化的审计方法论。

Noir（ZK 隐私）

使用 Noir 零知识电路构建隐私应用。

• Noir 输入默认是私有的。pub 用于标记公开输入。弄反会泄露秘密。
• nargo prove/nargo verify 已不再使用。请直接使用 bb（Barretenberg CLI）。
• 电路内哈希：使用 Poseidon（约 600 个门），而不是 SHA256（约 30,000 个门）。
• 承诺-空值符-Merkle 树模式是所有 Ethereum 隐私应用的基础。

测试

Foundry 测试——单元测试、模糊测试、分叉测试、不变量测试。

• 不要测试 getter 和 OpenZeppelin 内部实现。测试边缘情况和失败模式。
• 对所有数学运算进行模糊测试。对任何外部协议集成进行分叉测试。
• 不变量测试可以通过数千种随机调用序列捕获错误。

索引

事件、The Graph、Dune、读取链上数据。

• 通过 RPC 查询历史状态的成本很高。请使用索引器。
• 事件是读取历史链上活动的首要方式。设计合约时应优先考虑事件。
• The Graph 将事件转换为可查询的 GraphQL API。
• Multicall3（0xcA11bde05977b3631167028862bE2a173976CA11）——通过一次 RPC 调用批量读取。

前端 UX

Ethereum dApp 的前端 UX 模式。

• 每个链上按钮都需要独立的加载状态和禁用状态。不要共用 isLoading。
• 三按钮流程：切换网络 → 授权 → 执行。一次只执行一个操作。
• 每个地址都使用 <Address/> 显示，每个输入框都使用 <AddressInput/>。
• 在每个代币金额旁显示美元价值。

前端实战指南

从构建到生产环境的流程。

• 使用 yarn fork --network base，而不是 yarn chain。分叉环境提供真实的协议状态。
• IPFS 部署：trailingSlash: true 至关重要——否则，除 / 外的每个路由都会返回 404。
• 部署前务必进行干净构建（rm -rf .next out）。陈旧构建是 IPFS 部署中最常见的陷阱。

QA

供审查 Agent 使用的发布前审核清单。

• 构建完成后，将此清单交给单独的 Agent（或在全新上下文中使用）。审查者会阅读代码并逐一检查流程。
• 仅涵盖 AI Agent 实际会引入的错误——已通过对原始大模型进行基线测试验证。
• 针对每一项报告通过/失败，不要修复问题。

反馈

发送关于 ethskills 内容的反馈——问题或赞赏均可。倾向于发送反馈。

• 任何让你感到困惑、拖慢进度或确实有所帮助的内容都算反馈。微弱信号很容易被忽略；缺失的信号则无法找回。
• 起草 JSON，在请求许可时展示给你的用户，然后向 https://ethskills.com/api/feedback 发送一次 POST。如果用户已预先授权，则跳过请求。
• 必填字段：kind（"issue" 或 "praise"）和 message（至少 10 个字符）。尽可能包含 agent 和 skill。

---

根据任务获取内容

我正在……	获取这些技能
规划新的 dApp	ship/、crops/、concepts/、l2s/、gas/、why/
审查现有 dApp、智能合约或信任假设	crops/、audit/、qa/、wallets/、l2s/、security/
编写 Solidity	standards/、building-blocks/、addresses/、security/
测试合约	testing/
构建前端	orchestration/、frontend-ux/、tools/
部署到生产环境	wallets/、frontend-playbook/、gas/
发布前审查已完成的 dApp	qa/、crops/
审计智能合约	audit/、crops/
构建隐私/ZK 应用	noir/、security/、testing/
监控/分析	indexing/
构建 AI Agent 基础设施	standards/、wallets/、tools/
选择链	l2s/、gas/

---