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} 的值，並將 {decimals} 初始化為預設值 18。
     *
     * 若要為 {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 之間的關係。這是 {ERC-20} 使用的值，除非呼叫了 {_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 所要求的。請參閱 {ERC-20} 開頭的注意事項。
     *
     * 要求：
     *
     * - `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[Using Hooks]。
     */
    function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual { }
}