Optimism標準ブリッジコントラクトのウォークスルー

/**
 * @title IL1ERC20Bridge
 */
interface IL1ERC20Bridge {
    /**********
     * イベント *
     **********/

    event ERC20DepositInitiated(

    /********************
     * 公開関数 *
     ********************/

    /**
     * @dev 対応するL2ブリッジコントラクトのアドレスを取得します。
     * @return 対応するL2ブリッジコントラクトのアドレス。
     */
    function l2TokenBridge() external returns (address);

    /**
     * @dev L2の呼び出し元残高にERC20の金額をデポジットします。
     * @param _l1Token デポジットするL1 ERC20のアドレス
     * @param _l2Token L1の各L2 ERC20のアドレス
     * @param _amount デポジットするERC20の金額
     * @param _l2Gas L2でデポジットを完了するために必要なガスリミット。
     * @param _data L2に転送するオプションのデータ。このデータは、外部コントラクトの便宜のためにのみ提供されます。
     *        最大長を強制する以外、これらのコントラクトはその内容について何の保証も提供しません。
     */
    function depositERC20(
        address _l1Token,
        address _l2Token,
        uint256 _amount,
        uint32 _l2Gas,
        bytes calldata _data
    ) external;

    /**
     * @dev L2の受取人の残高にERC20の金額をデポジットします。
     * @param _l1Token デポジットするL1 ERC20のアドレス
     * @param _l2Token L1の各L2 ERC20のアドレス
     * @param _to 引き出しの入金先L2アドレス。
     * @param _amount デポジットするERC20の金額。
     * @param _l2Gas L2でデポジットを完了するために必要なガスリミット。
     * @param _data L2に転送するオプションのデータ。このデータは、外部コントラクトの便宜のためにのみ提供されます。
     *        最大長を強制する以外、これらのコントラクトはその内容について何の保証も提供しません。
     */
    function depositERC20To(
        address _l1Token,
        address _l2Token,
        address _to,
        uint256 _amount,
        uint32 _l2Gas,
        bytes calldata _data
    ) external;

    /*************************
     * クロスチェーン関数 *
     *************************/

    /**
     * @dev L2からL1への引き出しを完了し、受取人のL1 ERC20トークン残高に資金を入金します。
     * この呼び出しは、L2からの初期化された引き出しが完了していない場合、失敗します。
     *
     * @param _l1Token finalizeWithdrawalの対象となるL1トークンのアドレス。
     * @param _l2Token 引き出しが開始されたL2トークンのアドレス。
     * @param _from 転送を開始するL2アドレス。
     * @param _to 引き出しの入金先L1アドレス。
     * @param _amount デポジットするERC20の金額。
     * @param _data L2の送信者から提供されたデータ。このデータは、外部コントラクトの便宜のためにのみ提供されます。
     *   最大長を強制する以外、これらのコントラクトはその内容について何の保証も提供しません。
     */
    function finalizeERC20Withdrawal(
        address _l1Token,
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        bytes calldata _data
    ) external;
}

// SPDX-License-Identifier: MIT
pragma solidity >0.5.0 <0.9.0;

import "./IL1ERC20Bridge.sol";

/**
 * @title IL1StandardBridge
 */
interface IL1StandardBridge is IL1ERC20Bridge {
    /**********
     * イベント *
     **********/
    event ETHDepositInitiated(
        address indexed _from,
        address indexed _to,
        uint256 _amount,
        bytes _data
    );

    event ETHWithdrawalFinalized(
        .
        .
        .
    );

    /********************
     * 公開関数 *
     ********************/

    /**
     * @dev L2の呼び出し元残高にETHの金額をデポジットします。
            .
            .
            .
     */
    function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;

    /**
     * @dev L2の受取人の残高にETHの金額をデポジットします。
            .
            .
            .
     */
    function depositETHTo(
        address _to,
        uint32 _l2Gas,
        bytes calldata _data
    ) external payable;

    /*************************
     * クロスチェーン関数 *
     *************************/

    /**
     * @dev L2からL1への引き出しを完了し、受取人のL1 ETHトークン残高に資金を入金します。
     * この関数はxDomainMessengerのみが呼び出せるため、引き出しが完了する前に呼び出されることはありません。
                .
                .
                .
     */
    function finalizeETHWithdrawal(
        address _from,
        address _to,
        uint256 _amount,
        bytes calldata _data
    ) external;
}

/**
 * @title CrossDomainEnabled
 * @dev クロスドメイン通信を実行するコントラクトのヘルパーコントラクト
 *
 * 使用されるコンパイラ: 継承するコントラクトによって定義
 */
contract CrossDomainEnabled {
    /*************
     * 変数 *
     *************/

    // 他のドメインからメッセージを送受信するために使用されるメッセンジャーコントラクト
    address public messenger;

    /***************
     * コンストラクタ *
     ***************/

    /**
     * @param _messenger 現在のレイヤー上のCrossDomainMessengerのアドレス
     */
    constructor(address _messenger) {
        messenger = _messenger;
    }

    /**********************
     * 関数修飾子 *
     **********************/

    /**
     * 変更された関数が特定のクロスドメインアカウントによってのみ呼び出し可能であることを強制します。
     * @param _sourceDomainAccount この関数を呼び出すことが認証されている、発信元ドメインの唯一のアカウント。
     */
    modifier onlyFromCrossDomainAccount(address _sourceDomainAccount) {

        _;
    }

    /**********************
     * 内部関数 *
     **********************/

    /**
     * 通常はストレージからメッセンジャーを取得します。この関数は、子コントラクトがオーバーライドする必要がある場合に公開されます。
     * @return 使用すべきクロスドメインメッセンジャーコントラクトのアドレス。
     */
    function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {
        return ICrossDomainMessenger(messenger);
    }

    /**
     * 他のドメインのアカウントにメッセージを送信します。
     * @param _crossDomainTarget 宛先ドメインの意図した受信者
     * @param _message ターゲットに送信するデータ(通常は`onlyFromCrossDomainAccount()`を持つ関数へのcalldata)
     * @param _gasLimit ターゲットドメインでのメッセージのレシートのgasLimit。
     */
    function sendCrossDomainMessage(
        address _crossDomainTarget,
        uint32 _gasLimit,
        bytes memory _message

    /******************
     * 初期化 *
     ******************/

    /**
     * @param _l1messenger クロスチェーン通信に使用されるL1メッセンジャーアドレス。
     * @param _l2TokenBridge L2標準ブリッジアドレス。
     */
    // slither-disable-next-line external-function

    /**************
     * デポジット *
     **************/

    /** @dev 送信者がEOAであることを要求する修飾子。このチェックは、悪意のあるコントラクトによって
     *  initcode経由で回避される可能性がありますが、私たちが避けたいユーザーエラーに対応します。
     */
    modifier onlyEOA() {
        // コントラクトからのデポジットを停止するために使用(誤って失われたトークンを避けるため)
        require(!Address.isContract(msg.sender), "Account not EOA");
        _;
    }

    /**
     * @inheritdoc IL1StandardBridge
     */
    function depositETH(uint32 _l2Gas, bytes calldata _data) external payable onlyEOA {
        _initiateETHDeposit(msg.sender, msg.sender, _l2Gas, _data);
    }

    /**
     * @inheritdoc IL1StandardBridge
     */
    function depositETHTo(
        address _to,
        uint32 _l2Gas,
        bytes calldata _data
    ) external payable {
        _initiateETHDeposit(msg.sender, _to, _l2Gas, _data);
    }

    /**
     * @dev ETHを保存し、L2 ETHゲートウェイにデポジットを通知することで、デポジットのロジックを実行します。
     * @param _from L1でデポジットを引き出すアカウント。
     * @param _to L2でデポジットを与えるアカウント。
     * @param _l2Gas L2でデポジットを完了するために必要なガスリミット。
     * @param _data L2に転送するオプションのデータ。このデータは、外部コントラクトの便宜のためにのみ提供されます。
     *        最大長を強制する以外、これらのコントラクトはその内容について何の保証も提供しません。
     */
    function _initiateETHDeposit(
        address _from,
        address _to,
        uint32 _l2Gas,
        bytes memory _data
    ) internal {
        // finalizeDeposit呼び出しのcalldataを構築
        bytes memory message = abi.encodeWithSelector(

    /**
     * @inheritdoc IL1ERC20Bridge
     */
    function depositERC20(
		.
		.
		.
    ) external virtual onlyEOA {
        _initiateERC20Deposit(_l1Token, _l2Token, msg.sender, msg.sender, _amount, _l2Gas, _data);
    }

    /**
     * @inheritdoc IL1ERC20Bridge
     */
    function depositERC20To(
		.
		.
		.
    ) external virtual {
        _initiateERC20Deposit(_l1Token, _l2Token, msg.sender, _to, _amount, _l2Gas, _data);
    }

    /**
     * @dev L2デポジットトークンコントラクトにデポジットを通知し、ハンドラを呼び出してL1資金をロックするロジックを実行します。(例: transferFrom)
     *
     * @param _l1Token デポジットするL1 ERC20のアドレス
     * @param _l2Token L1の各L2 ERC20のアドレス
     * @param _from L1でデポジットを引き出すアカウント
     * @param _to L2でデポジットを与えるアカウント
     * @param _amount デポジットするERC20の金額。
     * @param _l2Gas L2でデポジットを完了するために必要なガスリミット。
     * @param _data L2に転送するオプションのデータ。このデータは、外部コントラクトの便宜のためにのみ提供されます。
     *        最大長を強制する以外、これらのコントラクトはその内容について何の保証も提供しません。
     */
    function _initiateERC20Deposit(
        address _l1Token,
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        uint32 _l2Gas,
        bytes calldata _data
    ) internal {

        // _l2Token.finalizeDeposit(_to, _amount)のcalldataを構築
        bytes memory message = abi.encodeWithSelector(
            IL2ERC20Bridge.finalizeDeposit.selector,
            _l1Token,
            _l2Token,
            _from,
            _to,
            _amount,
            _data
        );

        // calldataをL2に送信
        // slither-disable-next-line reentrancy-events, reentrancy-benign
        sendCrossDomainMessage(l2TokenBridge, _l2Gas, message);

        // slither-disable-next-line reentrancy-benign
        deposits[_l1Token][_l2Token] = deposits[_l1Token][_l2Token] + _amount;

        // slither-disable-next-line reentrancy-events
        emit ERC20DepositInitiated(_l1Token, _l2Token, _from, _to, _amount, _data);
    }

    /*************************
     * クロスチェーン関数 *
     *************************/

    /**
     * @inheritdoc IL1StandardBridge
     */
    function finalizeETHWithdrawal(
        address _from,
        address _to,
        uint256 _amount,
        bytes calldata _data

    }

    /**
     * @inheritdoc IL1ERC20Bridge
     */
    function finalizeERC20Withdrawal(
        address _l1Token,
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        bytes calldata _data
    ) external onlyFromCrossDomainAccount(l2TokenBridge) {

        // L1で引き出しが完了すると、L1ブリッジは資金を引き出し人に転送します。
        // slither-disable-next-line reentrancy-events
        IERC20(_l1Token).safeTransfer(_to, _amount);

        // slither-disable-next-line reentrancy-events
        emit ERC20WithdrawalFinalized(_l1Token, _l2Token, _from, _to, _amount, _data);
    }


    /*****************************
     * 一時的 - ETHの移行 *
     *****************************/

    /**
     * @dev アカウントにETH残高を追加します。これは、古いゲートウェイから新しいゲートウェイにETHを移行できるようにすることを目的としています。
     * 注意: これは、古いコントラクトから移行されたETHを受け取ることができるように、1回のアップグレードのみに残されます。
     */
    function donateETH() external payable {}
}

    /**
     * @param _l2Bridge L2標準ブリッジのアドレス。
     * @param _l1Token 対応するL1トークンのアドレス。
     * @param _name ERC20名。
     * @param _symbol ERC20シンボル。
     */
    constructor(
        address _l2Bridge,
        address _l1Token,
        string memory _name,
        string memory _symbol
    ) ERC20(_name, _symbol) {
        l1Token = _l1Token;
        l2Bridge = _l2Bridge;
    }

    modifier onlyL2Bridge() {
        require(msg.sender == l2Bridge, "Only L2 Bridge can mint and burn");
        _;
    }


    // slither-disable-next-line external-function
    function supportsInterface(bytes4 _interfaceId) public pure returns (bool) {
        bytes4 firstSupportedInterface = bytes4(keccak256("supportsInterface(bytes4)")); // ERC165
        bytes4 secondSupportedInterface = IL2StandardERC20.l1Token.selector ^
            IL2StandardERC20.mint.selector ^
            IL2StandardERC20.burn.selector;
        return _interfaceId == firstSupportedInterface || _interfaceId == secondSupportedInterface;
    }

    // slither-disable-next-line external-function
    function mint(address _to, uint256 _amount) public virtual onlyL2Bridge {
        _mint(_to, _amount);

        emit Mint(_to, _amount);
    }

    // slither-disable-next-line external-function
    function burn(address _from, uint256 _amount) public virtual onlyL2Bridge {
        _burn(_from, _amount);

        emit Burn(_from, _amount);
    }
}

/* ライブラリのインポート */
import { ERC165Checker } from "@openzeppelin/contracts/utils/introspection/ERC165Checker.sol";
import { CrossDomainEnabled } from "../../libraries/bridge/CrossDomainEnabled.sol";
import { Lib_PredeployAddresses } from "../../libraries/constants/Lib_PredeployAddresses.sol";

/* コントラクトのインポート */
import { IL2StandardERC20 } from "../../standards/IL2StandardERC20.sol";

/**
 * @title L2StandardBridge
 * @dev L2標準ブリッジは、L1標準ブリッジと連携して、L1とL2間のETHおよびERC20の移行を可能にするコントラクトです。
 * このコントラクトは、L1標準ブリッジへのデポジットを聞くと、新しいトークンのミンターとして機能します。
 * このコントラクトは、引き出しを意図したトークンのバーナーとしても機能し、L1ブリッジにL1資金を解放するように通知します。
 */
contract L2StandardBridge is IL2ERC20Bridge, CrossDomainEnabled {
    /********************************
     * 外部コントラクト参照 *
     ********************************/

    address public l1TokenBridge;

    /***************
     * コンストラクタ *
     ***************/

    /**
     * @param _l2CrossDomainMessenger このコントラクトで使用されるクロスドメインメッセンジャー。
     * @param _l1TokenBridge メインチェーンにデプロイされたL1ブリッジのアドレス。
     */
    constructor(address _l2CrossDomainMessenger, address _l1TokenBridge)
        CrossDomainEnabled(_l2CrossDomainMessenger)
    {
        l1TokenBridge = _l1TokenBridge;
    }

    /***************
     * 引き出し *
     ***************/

    /**
     * @inheritdoc IL2ERC20Bridge
     */
    function withdraw(
        address _l2Token,
        uint256 _amount,
        uint32 _l1Gas,
        bytes calldata _data
    ) external virtual {
        _initiateWithdrawal(_l2Token, msg.sender, msg.sender, _amount, _l1Gas, _data);
    }

    /**
     * @inheritdoc IL2ERC20Bridge
     */
    function withdrawTo(
        address _l2Token,
        address _to,
        uint256 _amount,
        uint32 _l1Gas,
        bytes calldata _data
    ) external virtual {
        _initiateWithdrawal(_l2Token, msg.sender, _to, _amount, _l1Gas, _data);
    }

    /**
     * @dev トークンをバーンし、L1トークンゲートウェイに引き出しを通知することで、引き出しのロジックを実行します。
     * @param _l2Token 引き出しが開始されたL2トークンのアドレス。
     * @param _from L2で引き出しを引き出すアカウント。
     * @param _to L1で引き出しを与えるアカウント。
     * @param _amount 引き出すトークンの量。
     * @param _l1Gas 未使用ですが、将来の互換性の考慮事項のために含まれています。
     * @param _data L1に転送するオプションのデータ。このデータは、外部コントラクトの便宜のためにのみ提供されます。
     *        最大長を強制する以外、これらのコントラクトはその内容について何の保証も提供しません。
     */
    function _initiateWithdrawal(
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        uint32 _l1Gas,
        bytes calldata _data
    ) internal {
        // 引き出しが開始されると、その後のL2での使用を防ぐために、引き出し人の資金をバーンします。
        // slither-disable-next-line reentrancy-events
        IL2StandardERC20(_l2Token).burn(msg.sender, _amount);

            message = abi.encodeWithSelector(
                IL1StandardBridge.finalizeETHWithdrawal.selector,
                _from,
                _to,
                _amount,
                _data
            );
        } else {
            message = abi.encodeWithSelector(
                IL1ERC20Bridge.finalizeERC20Withdrawal.selector,
                l1Token,
                _l2Token,
                _from,
                _to,
                _amount,
                _data
            );
        }

        // メッセージをL1ブリッジに送信
        // slither-disable-next-line reentrancy-events
        sendCrossDomainMessage(l1TokenBridge, _l1Gas, message);

        // slither-disable-next-line reentrancy-events
        emit WithdrawalInitiated(l1Token, _l2Token, msg.sender, _to, _amount, _data);
    }

    /************************************
     * クロスチェーン関数: デポジット *
     ************************************/

    /**
     * @inheritdoc IL2ERC20Bridge
     */
    function finalizeDeposit(
        address _l1Token,
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        bytes calldata _data

            bytes memory message = abi.encodeWithSelector(
                IL1ERC20Bridge.finalizeERC20Withdrawal.selector,
                _l1Token,
                _l2Token,
                _to, // ここで_toと_fromを切り替えて、デポジットを送信者に跳ね返す
                _from,
                _amount,
                _data
            );

            // メッセージをL1ブリッジに送信
            // slither-disable-next-line reentrancy-events
            sendCrossDomainMessage(l1TokenBridge, 0, message);
            // slither-disable-next-line reentrancy-events
            emit DepositFailed(_l1Token, _l2Token, _from, _to, _amount, _data);
        }
    }
}