ERC-20 合约详解

    /**
     * @dev 将 `spender` 对调用者代币的授权额度设置为 `amount`。
     *
     * 返回一个布尔值，表示操作是否成功。
     *
     * 重要提示：请注意，使用此方法更改授权额度会带来风险，
     * 有人可能因不利的交易排序而同时使用新旧两种授权额度。
     * 缓解此竞态条件的一个可行方案是，先将花费者的授权额度降至 0，
     * 然后再设置所需的值：
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * 触发一个 {Approval} 事件。
     */
    function approve(address spender, uint256 amount) external returns (bool);

    /**
     * @dev 使用
     * 授权机制将 `amount` 数量的代币从 `sender` 转移到 `recipient`。然后从调用者的授权额度中扣除 `amount`。
     *
     * 返回一个布尔值，表示操作是否成功。
     *
     * 触发一个 {Transfer} 事件。
     */
    function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);

    /**
     * @dev 当 `value` 数量的代币从一个帐户 (`from`) 转移到
     * 另一个 (`to`) 时触发。
     *
     * 请注意，`value` 可能为零。
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev 当通过
     * 调用 {approve} 为 `owner` 设置 `spender` 的授权额度时触发。`value` 是新的授权额度。
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);
}

/**
 * @dev {IERC20} 接口的实现。
 *
 * 此实现与代币的创建方式无关。这意味着
 * 必须使用 {_mint} 在派生合约中添加供应机制。
 * 有关通用机制，请参阅 {ERC20PresetMinterPauser}。
 *
 * 提示：有关详细的说明，请参阅我们的指南
 * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[如何
 * 实现供应机制]。
 *
 * 我们遵循了通用的 OpenZeppelin 指南：函数在失败时会还原，而
 * 不会返回 `false`。但是，此行为是常规行为，
 * 并且与 ERC20 应用程序的预期不冲突。
 *
 * 此外，在调用 {transferFrom} 时会触发 {Approval} 事件。
 * 这允许应用程序仅通过监听所述事件
 * 即可重建所有账户的授权额度。EIP 的其他实现
 * 可能不会触发这些事件，因为规范没有要求。
 *
 * 最后，添加了非标准的 {decreaseAllowance} 和 {increaseAllowance}
 * 函数，以缓解围绕设置
 * 授权额度的众所周知的问题。请参阅 {IERC20-approve}。
 */

    /**
     * @dev 设置 {name} 和 {symbol} 的值，用
     * 默认值 18 初始化 {decimals}。
     *
     * 要为 {decimals} 选择不同的值，请使用 {_setupDecimals}。
     *
     * 所有这三个值都是不可变的：它们只能在
     * 构造期间设置一次。
     */
    constructor (string memory name_, string memory symbol_) public {
        // In Solidity ≥0.7.0, 'public' is implicit and can be omitted.

        _name = name_;
        _symbol = symbol_;
        _decimals = 18;
    }

    /**
     * @dev 返回代币的名称。
     */
    function name() public view returns (string memory) {
        return _name;
    }

    /**
     * @dev 返回代币的符号，通常是
     * 名称的缩写。
     */
    function symbol() public view returns (string memory) {
        return _symbol;
    }

    /**
     * @dev 返回用于获取其用户表示的小数位数。
     * 例如，如果 `decimals` 等于 `2`，`505` 个代币的余额应
     * 向用户显示为 `5,05` (`505 / 10 ** 2`)。
     *
     * 代币通常选择值 18，模仿
     * 以太币和 wei 之间的关系。这是 {ERC20} 使用的值，除非
     * 调用 {_setupDecimals}。
     *
     * 注意：此信息仅用于_显示_目的：它
     * 绝不影响合约的任何算术，包括
     * {IERC20-balanceOf} 和 {IERC20-transfer}。
     */
    function decimals() public view returns (uint8) {
        return _decimals;
    }

    /**
     * @dev 请参阅 {IERC20-transfer}。
     *
     * 要求：
     *
     * - `recipient` 不能是零地址。
     * - 调用者必须拥有至少 `amount` 的余额。
     */
    function transfer(address recipient, uint256 amount) public virtual override returns (bool) {

    /**
     * @dev 请参阅 {IERC20-transferFrom}。
     *
     * 触发一个 {Approval} 事件，指示更新后的授权额度。EIP
     * 并未要求此项。请参阅 {ERC20} 开头的注释。
     *
     * 要求：
     *
     * - `sender` 和 `recipient` 不能是零地址。
     * - `sender` 必须拥有至少 `amount` 的余额。
     * - 调用者必须拥有至少 `amount` 的 ``sender`` 代币授权额度
     * 。
     */
    function transferFrom(address sender, address recipient, uint256 amount) public virtual
                                                override returns (bool) {
        _transfer(sender, recipient, amount);

    /**
     * @dev 以原子方式增加调用者授予 `spender` 的授权额度。
     *
     * 这是 {approve} 的替代方案，可用于缓解
     * {IERC20-approve} 中描述的问题。
     *
     * 触发一个 {Approval} 事件，指示更新后的授权额度。
     *
     * 要求：
     *
     * - `spender` 不能是零地址。
     */
    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
        _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
        return true;
    }

    /**
     * @dev 以原子方式减少调用者授予 `spender` 的授权额度。
     *
     * 这是 {approve} 的替代方案，可用于缓解
     * {IERC20-approve} 中描述的问题。
     *
     * 触发一个 {Approval} 事件，指示更新后的授权额度。
     *
     * 要求：
     *
     * - `spender` 不能是零地址。
     * - `spender` 必须拥有至少
     * `subtractedValue` 的调用者授权额度。
     */
    function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
        _approve(_msgSender(), spender, _allowances[_msgSender()][spender].sub(subtractedValue,
                "ERC20: decreased allowance below zero"));
        return true;
    }

    /**
     * @dev 将 `amount` 数量的代币从 `sender` 转移到 `recipient`。
     *
     * 这个内部函数等同于 {transfer}，可用于
     * 例如，实现自动代币费用、惩罚机制等。
     *
     * 触发一个 {Transfer} 事件。
     *
     * 要求：
     *
     * - `sender` 不能是零地址。
     * - `recipient` 不能是零地址。
     * - `sender` 必须拥有至少 `amount` 的余额。
     */
    function _transfer(address sender, address recipient, uint256 amount) internal virtual {

    /** @dev 创建 `amount` 数量的代币并将其分配给 `account`，增加
     * 总供应量。
     *
     * 触发一个 {Transfer} 事件，其中 `from` 设置为零地址。
     *
     * 要求：
     *
     * - `to` 不能是零地址。
     */
    function _mint(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: mint to the zero address");
        _beforeTokenTransfer(address(0), account, amount);
        _totalSupply = _totalSupply.add(amount);
        _balances[account] = _balances[account].add(amount);
        emit Transfer(address(0), account, amount);
    }

    /**
     * @dev 从 `account` 销毁 `amount` 数量的代币，减少
     * 总供应量。
     *
     * 触发一个 {Transfer} 事件，其中 `to` 设置为零地址。
     *
     * 要求：
     *
     * - `account` 不能是零地址。
     * - `account` 必须拥有至少 `amount` 的代币。
     */
    function _burn(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: burn from the zero address");

        _beforeTokenTransfer(account, address(0), amount);

        _balances[account] = _balances[account].sub(amount, "ERC20: burn amount exceeds balance");
        _totalSupply = _totalSupply.sub(amount);
        emit Transfer(account, address(0), amount);
    }

    /**
     * @dev 将 `spender` 对 `owner` 代币的授权额度设置为 `amount`。
     *
     * 此内部函数等同于 `approve`，可用于
     * 例如，为某些子系统设置自动授权额度等。
     *
     * 触发一个 {Approval} 事件。
     *
     * 要求：
     *
     * - `owner` 不能是零地址。
     * - `spender` 不能是零地址。
     */
    function _approve(address owner, address spender, uint256 amount) internal virtual {
        require(owner != address(0), "ERC20: approve from the zero address");
        require(spender != address(0), "ERC20: approve to the zero address");

        _allowances[owner][spender] = amount;

    /**
     * @dev 将 {decimals} 设置为不同于默认值 18 的值。
     *
     * 警告：此函数应仅从构造函数中调用。大多数
     * 与代币合约交互的应用程序不希望
     * {decimals} 发生变化，如果发生变化可能会导致工作不正常。
     */
    function _setupDecimals(uint8 decimals_) internal {
        _decimals = decimals_;
    }

    /**
     * @dev 在任何代币转移之前调用的钩子函数。这包括
     * 铸造和销毁。
     *
     * 调用条件：
     *
     * - 当 `from` 和 `to` 都非零时，`amount` 数量的 ``from`` 代币
     * 将被转移到 `to`。
     * - 当 `from` 为零时，将为 `to` 铸造 `amount` 数量的代币。
     * - 当 `to` 为零时，将销毁 `amount` 数量的 ``from`` 代币。
     * - `from` 和 `to` 永远不会都为零。
     *
     * 要了解有关钩子函数的更多信息，请转到 xref:ROOT:extending-contracts.adoc#using-hooks[使用钩子函数]。
     */
    function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual { }
}