ERC-20 合约详解

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

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

    /**
     * @dev 当通过调用{approve}设置`spender`对`owner`的授权额度时触发。`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[如何实现供应机制]。
 *
 * 我们遵循了通用的欧本齐柏林指南：函数在失败时回退（revert）而不是返回`false`。尽管如此，这种行为是常规的，并且不与ERC-20应用程序的期望冲突。
 *
 * 此外，在调用{transferFrom}时会触发{Approval}事件。
 * 这允许应用程序仅通过监听所述事件来重建所有账户的授权额度。EIP的其他实现可能不会触发这些事件，因为规范并未要求。
 *
 * 最后，添加了非标准的{decreaseAllowance}和{increaseAllowance}函数，以缓解围绕设置授权额度的众所周知的问题。请参见{IERC20-approve}。
 */

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

        _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`的余额。
     * - 调用者必须对``sender``的代币具有至少`amount`的授权额度。
     */
    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 将`amount`设置为`spender`对`owner`代币的授权额度。
     *
     * 这个内部函数等同于`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 在任何代币转账之前调用的钩子（Hook）。这包括铸造和销毁。
     *
     * 调用条件：
     *
     * - 当`from`和`to`都不为零时，``from``的`amount`数量的代币将被转账到`to`。
     * - 当`from`为零时，将为`to`铸造`amount`数量的代币。
     * - 当`to`为零时，``from``的`amount`数量的代币将被销毁。
     * - `from`和`to`永远不会同时为零。
     *
     * 要了解有关钩子的更多信息，请前往xref:ROOT:extending-contracts.adoc#using-hooks[使用钩子]。
     */
    function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual { }
}