eip-reference

用途：为开发者与 LLM 提供以太坊 EIP 与 ERC 标准的权威参考，帮助写出正确的函数签名、域分隔符构造与实现细节，避免常见错误。

主要能力：

1. 区分 EIP 与 ERC：EIP 覆盖整个提案流程，ERC 是其中定义应用层标准（代币、签名、钱包）的子集；链级变更（如 EIP-1559）始终是 EIP。
2. 汇总常见误区：ERC-20 approve 竞态（先置 0 或用 increaseAllowance/decreaseAllowance 或 ERC-2612 permit；USDT 需先重置为 0）；ERC-721 transferFrom 不调用 onERC721Received，可能永久锁死代币，应优先用 safeTransferFrom；EIP-712 域分隔符必须包含 chainId 与 verifyingContract 以防跨链重放；ERC-4337 bundler 与 relayer 信任模型不同；EIP-1559 中 baseFee 由协议控制并销毁，priority fee 归验证者；ERC-4626 份额/资产换算需向金库方向取整以防通胀攻击；EIP-2612 permit 可被抢跑，调用前应检查 allowance；ERC-1155 只有 setApprovalForAll，无按 tokenId 授权；decimals() 属可选 IERC20Metadata，USDC 为 6、WBTC 为 8。
3. 按需查询任意 EIP/ERC：先判断类型，ERC 抓取 https://raw.githubusercontent.com/ethereum/ERCs/master/ERCS/erc-{number}.md，EIP 抓取 https://raw.githubusercontent.com/ethereum/EIPs/master/EIPS/eip-{number}.md；也可用 gh api repos/ethereum/ERCs/contents/ERCS/erc-{number}.md --jq '.content' | base64 -d 或对应 EIPs 仓库命令。解析 YAML frontmatter 与 Simple Summary、Abstract、Motivation、Specification、Rationale、Backwards Compatibility、Security Considerations 等章节，提取标题、状态、接口与安全注意事项。
4. 覆盖代币标准接口：ERC-20、ERC-721、ERC-1155、ERC-4626、ERC-2981 的接口定义与关键规则。
5. 覆盖签名与认证标准：EIP-712 类型化数据签名、ERC-2612 Permit、EIP-4361 SIWE、ERC-1271 合约签名验证。

使用方式：在需要正确接口、域分隔符构造或实现细节时调用；查询时按上述 URL 或 gh 命令抓取原始规范并总结。

适用场景：编写或审计以太坊智能合约、实现代币与金库、处理签名与授权、排查 LLM 生成代码中的标准误用。

限制：仅应依赖 Final 状态的 EIP 用于生产，Draft/Review 可能变更；ERC-2981 版税执行是自愿的，标准无法强制支付；并非所有 ERC-20 支持 permit，DAI 使用非标准 permit；资料未提供收费、价格与平台信息。