EIP-20ERC代币标准Final（2015-11-19）

可替代代币标准

同质化代币的最小接口：6 个函数 + 2 个事件。稳定币、治理币、LP 代币、质押凭证几乎都由它派生。

适用链：全部 EVM 链 + 各 L2

为什么重要：因为接口统一，钱包、交易所、区块浏览器、DEX 才能「一套代码对接所有代币」。看懂 ERC-20 是看懂整个 DeFi 的前置条件：approve 与 transferFrom 的机制就是后来一切授权钓鱼的根源。

函数签名与选择器

选择器是签名的 keccak256 前 4 字节；事件则是完整的 32 字节 topic0。点一下即可复制。

签名 / 字段	选择器 / topic0	说明
totalSupply()		当前流通总量。若支持增发/销毁则是动态值。
balanceOf(address)		查询某地址余额。注意它链上没有隐私性。
transfer(address,uint256)		从调用者转出。返回 bool，但不少老币不返回或永远返回 true。
approve(address,uint256)		授权 spender 可动用不超过 value 的额度，是覆盖而非累加。
allowance(address,address)		查询剩余授权额度，撤销授权的检查依据。
transferFrom(address,address,uint256)		代扣：从 from 转给 to，消耗调用者的授权额度。
event Transfer(address,address,uint256)事件		前两个参数 indexed，铸造用 from = address(0)，销毁用 to = address(0)。
event Approval(address,address,uint256)事件		owner 授权 spender。索引器靠它重建授权清单。

代码模板

最小可用实现（零依赖，可直接编译部署）

最小可用实现（零依赖，可直接编译部署）Solidity

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

/**
 * 教学用最小 ERC-20。故意不依赖 OpenZeppelin，方便逐行读懂。
 * 生产环境请用 OpenZeppelin 的 ERC20 + ERC20Permit，它们额外处理了
 * 非标准返回值代币、EIP-2612 无 Gas 授权等兼容性问题。
 */
contract MinimalERC20 {
    string public name = "Academy Token";
    string public symbol = "ACD";
    uint8 public constant decimals = 18;

    uint256 public totalSupply;
    mapping(address => uint256) public balanceOf;
    mapping(address => mapping(address => uint256)) public allowance;

    event Transfer(address indexed from, address indexed to, uint256 value);
    event Approval(address indexed owner, address indexed spender, uint256 value);

    error InsufficientBalance(uint256 available, uint256 required);
    error InsufficientAllowance(uint256 available, uint256 required);
    error ZeroAddress();

    constructor(uint256 initialSupply) {
        _mint(msg.sender, initialSupply);
    }

    function transfer(address to, uint256 value) external returns (bool) {
        _transfer(msg.sender, to, value);
        return true;
    }

    function approve(address spender, uint256 value) external returns (bool) {
        allowance[msg.sender][spender] = value;
        emit Approval(msg.sender, spender, value);
        return true;
    }

    function transferFrom(address from, address to, uint256 value) external returns (bool) {
        uint256 allowed = allowance[from][msg.sender];

        // type(uint256).max 视作「无限授权」，直接跳过扣减：
        // 既是 gas 优化，也是与 OZ / USDC 等主流实现保持一致的惯例
        if (allowed != type(uint256).max) {
            if (allowed < value) revert InsufficientAllowance(allowed, value);
            allowance[from][msg.sender] = allowed - value;
        }

        _transfer(from, to, value);
        return true;
    }

    function _transfer(address from, address to, uint256 value) internal {
        if (to == address(0)) revert ZeroAddress();

        uint256 bal = balanceOf[from];
        if (bal < value) revert InsufficientBalance(bal, value);

        unchecked {
            // 依赖不变量：所有余额之和恒等于 totalSupply，因此这里的加法不可能溢出
            balanceOf[from] = bal - value;
            balanceOf[to] += value;
        }

        emit Transfer(from, to, value);
    }

    function _mint(address to, uint256 value) internal {
        if (to == address(0)) revert ZeroAddress();

        totalSupply += value;
        unchecked {
            balanceOf[to] += value;
        }

        emit Transfer(address(0), to, value);
    }
}

decimals 必须是常量且为 18 之外的值时要在文档里写明（USDC 是 6）。前端硬编码 18 会把 1 USDC 显示成 0.000001。

用 ethers v6 读余额与授权

用 ethers v6 读余额与授权JavaScript

import { Contract, JsonRpcProvider, formatUnits, MaxUint256 } from 'ethers';

const ABI = [
  'function name() view returns (string)',
  'function symbol() view returns (string)',
  'function decimals() view returns (uint8)',
  'function balanceOf(address) view returns (uint256)',
  'function allowance(address owner, address spender) view returns (uint256)',
  'function approve(address spender, uint256 value) returns (bool)',
];

const provider = new JsonRpcProvider(RPC);
const token = new Contract(TOKEN, ABI, provider);

const [dec, bal, allowed] = await Promise.all([
  token.decimals(),
  token.balanceOf(user),
  token.allowance(user, SPENDER),
]);

// 判断是否是「无限授权」——这是安全体检里最该报警的一项
const isUnlimited = allowed === MaxUint256;

console.log({
  balance: formatUnits(bal, dec),
  allowance: isUnlimited ? '无限授权' : formatUnits(allowed, dec),
});

实现与使用时的常见陷阱

✕approve 是覆盖写，不是累加。把 100 覆盖成 50 之前，老代码里「先置 0 再设值」的双交易写法是为了绕过某些老币的竞态保护。
✕兼容非标准代币：有些币（BNB 早期的 BEP-20 实现）transfer 不返回 bool，直接 require(token.transfer()) 会失败。要判断返回数据长度。
✕不要用 transfer 给合约地址转账后指望它有回调——ERC-20 没有钩子，转进去就是永久锁死。
✕无限授权是最大的安全隐患。定期用区块浏览器或授权管理工具检查并撤销。
✕不要依赖 decimals() 的调用结果做链下硬编码以外的假设，代币不会在同一交易里改它，但代理合约理论上可以。

可替代代币标准

函数签名与选择器

代码模板

实现与使用时的常见陷阱

相关标准