جولة في عقد الجسر القياسي لشبكة أوبتيميزم

/**
 * @title IL1ERC20Bridge
 */
interface IL1ERC20Bridge {
    /**********
     * أحداث *
     **********/

    event ERC20DepositInitiated(

    /********************
     * دوال عامة *
     ********************/

    /**
     * @dev الحصول على عنوان عقد جسر طبقة 2 (L2) المقابل.
     * @return عنوان عقد جسر طبقة 2 (L2) المقابل.
     */
    function l2TokenBridge() external returns (address);

    /**
     * @dev إيداع مبلغ من ERC-20 في رصيد المتصل على طبقة 2 (L2).
     * @param _l1Token عنوان ERC-20 على طبقة 1 (L1) الذي نقوم بإيداعه
     * @param _l2Token عنوان ERC-20 على طبقة 2 (L2) المقابل لـ طبقة 1 (L1)
     * @param _amount مبلغ ERC-20 المراد إيداعه
     * @param _l2Gas حد الغاز المطلوب لإكمال الإيداع على طبقة 2 (L2).
     * @param _data بيانات اختيارية لإرسالها إلى طبقة 2 (L2). يتم توفير هذه البيانات
     *        فقط لراحة العقود الخارجية. بصرف النظر عن فرض حد أقصى
     *        للطول، لا تقدم هذه العقود أي ضمانات حول محتواها.
     */
    function depositERC20(
        address _l1Token,
        address _l2Token,
        uint256 _amount,
        uint32 _l2Gas,
        bytes calldata _data
    ) external;

    /**
     * @dev إيداع مبلغ من ERC-20 في رصيد المستلم على طبقة 2 (L2).
     * @param _l1Token عنوان ERC-20 على طبقة 1 (L1) الذي نقوم بإيداعه
     * @param _l2Token عنوان ERC-20 على طبقة 2 (L2) المقابل لـ طبقة 1 (L1)
     * @param _to عنوان طبقة 2 (L2) لإضافة السحب إليه.
     * @param _amount مبلغ ERC-20 المراد إيداعه.
     * @param _l2Gas حد الغاز المطلوب لإكمال الإيداع على طبقة 2 (L2).
     * @param _data بيانات اختيارية لإرسالها إلى طبقة 2 (L2). يتم توفير هذه البيانات
     *        فقط لراحة العقود الخارجية. بصرف النظر عن فرض حد أقصى
     *        للطول، لا تقدم هذه العقود أي ضمانات حول محتواها.
     */
    function depositERC20To(
        address _l1Token,
        address _l2Token,
        address _to,
        uint256 _amount,
        uint32 _l2Gas,
        bytes calldata _data
    ) external;

    /*************************
     * دوال عبر السلاسل *
     *************************/

    /**
     * @dev إكمال سحب من طبقة 2 (L2) إلى طبقة 1 (L1)، وإضافة الأموال إلى رصيد المستلم من
     * الرمز المميز ERC-20 على طبقة 1 (L1).
     * سيفشل هذا الاستدعاء إذا لم يتم الانتهاء من السحب المهيأ من طبقة 2 (L2).
     *
     * @param _l1Token عنوان الرمز المميز على طبقة 1 (L1) لإنهاء السحب (finalizeWithdrawal) له.
     * @param _l2Token عنوان الرمز المميز على طبقة 2 (L2) حيث تم بدء السحب.
     * @param _from عنوان طبقة 2 (L2) الذي بدأ التحويل.
     * @param _to عنوان طبقة 1 (L1) لإضافة السحب إليه.
     * @param _amount مبلغ ERC-20 المراد إيداعه.
     * @param _data البيانات المقدمة من المرسل على طبقة 2 (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 إيداع مبلغ من ETH في رصيد المتصل على طبقة 2 (L2).
            .
            .
            .
     */
    function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;

    /**
     * @dev إيداع مبلغ من ETH في رصيد المستلم على طبقة 2 (L2).
            .
            .
            .
     */
    function depositETHTo(
        address _to,
        uint32 _l2Gas,
        bytes calldata _data
    ) external payable;

    /*************************
     * دوال عبر السلاسل *
     *************************/

    /**
     * @dev إكمال سحب من طبقة 2 (L2) إلى طبقة 1 (L1)، وإضافة الأموال إلى رصيد المستلم من
     * الرمز المميز ETH على طبقة 1 (L1). نظرًا لأن 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()`)
     * @param _gasLimit حد الغاز (gasLimit) لاستلام الرسالة على النطاق الوجهة.
     */
    function sendCrossDomainMessage(
        address _crossDomainTarget,
        uint32 _gasLimit,
        bytes memory _message

/**
 * @title L1StandardBridge
 * @dev جسر ETH و ERC-20 على طبقة 1 (L1) هو عقد يخزن أموال طبقة 1 (L1) المودعة والرموز المميزة
 * القياسية المستخدمة على طبقة 2 (L2). يقوم بمزامنة جسر طبقة 2 (L2) المقابل، وإبلاغه بالإيداعات
 * والاستماع إليه لمعرفة عمليات السحب المنتهية حديثًا.
 *
 */
contract L1StandardBridge is IL1StandardBridge, CrossDomainEnabled {
    using SafeERC20 for IERC20;

    /******************
     * تهيئة *
     ******************/

    /**
     * @param _l1messenger عنوان مراسل طبقة 1 (L1) المستخدم للاتصالات عبر السلاسل.
     * @param _l2TokenBridge عنوان الجسر القياسي على طبقة 2 (L2).
     */
    // slither-disable-next-line external-function

    /**************
     * إيداع *
     **************/

    /** @dev مُعدِّل يشترط أن يكون المرسل حسابًا مملوكًا خارجيًا (EOA). يمكن تجاوز هذا التحقق بواسطة عقد
     *  ضار عبر كود التهيئة (initcode)، لكنه يعالج خطأ المستخدم الذي نريد تجنبه.
     */
    modifier onlyEOA() {
        // يستخدم لإيقاف الإيداعات من العقود (لتجنب فقدان الرموز المميزة عن طريق الخطأ)
        require(!Address.isContract(msg.sender), "Account not EOA");
        _;
    }

    /**
     * @dev يمكن استدعاء هذه الدالة بدون بيانات
     * لإيداع مبلغ من ETH في رصيد المتصل على طبقة 2 (L2).
     * نظرًا لأن دالة الاستلام (receive) لا تأخذ بيانات، يتم إرسال مبلغ
     * افتراضي محافظ إلى طبقة 2 (L2).
     */
    receive() external payable onlyEOA {
        _initiateETHDeposit(msg.sender, msg.sender, 200_000, bytes(""));
    }

    /**
     * @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 وإبلاغ بوابة ETH على طبقة 2 (L2) بـ
     * الإيداع.
     * @param _from الحساب الذي سيتم سحب الإيداع منه على طبقة 1 (L1).
     * @param _to الحساب الذي سيتم إعطاء الإيداع له على طبقة 2 (L2).
     * @param _l2Gas حد الغاز المطلوب لإكمال الإيداع على طبقة 2 (L2).
     * @param _data بيانات اختيارية لإرسالها إلى طبقة 2 (L2). يتم توفير هذه البيانات
     *        فقط لراحة العقود الخارجية. بصرف النظر عن فرض حد أقصى
     *        للطول، لا تقدم هذه العقود أي ضمانات حول محتواها.
     */
    function _initiateETHDeposit(
        address _from,
        address _to,
        uint32 _l2Gas,
        bytes memory _data
    ) internal {
        // بناء بيانات الاستدعاء لاستدعاء finalizeDeposit
        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 ينفذ منطق الإيداعات عن طريق إبلاغ عقد الرمز المميز المودع على طبقة 2 (L2)
     * بالإيداع واستدعاء معالج لقفل أموال طبقة 1 (L1). (مثل transferFrom)
     *
     * @param _l1Token عنوان ERC-20 على طبقة 1 (L1) الذي نقوم بإيداعه
     * @param _l2Token عنوان ERC-20 على طبقة 2 (L2) المقابل لـ طبقة 1 (L1)
     * @param _from الحساب الذي سيتم سحب الإيداع منه على طبقة 1 (L1)
     * @param _to الحساب الذي سيتم إعطاء الإيداع له على طبقة 2 (L2)
     * @param _amount مبلغ ERC-20 المراد إيداعه.
     * @param _l2Gas حد الغاز المطلوب لإكمال الإيداع على طبقة 2 (L2).
     * @param _data بيانات اختيارية لإرسالها إلى طبقة 2 (L2). يتم توفير هذه البيانات
     *        فقط لراحة العقود الخارجية. بصرف النظر عن فرض حد أقصى
     *        للطول، لا تقدم هذه العقود أي ضمانات حول محتواها.
     */
    function _initiateERC20Deposit(
        address _l1Token,
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        uint32 _l2Gas,
        bytes calldata _data
    ) internal {

        // بناء بيانات الاستدعاء لـ _l2Token.finalizeDeposit(_to, _amount)
        bytes memory message = abi.encodeWithSelector(
            IL2ERC20Bridge.finalizeDeposit.selector,
            _l1Token,
            _l2Token,
            _from,
            _to,
            _amount,
            _data
        );

        // إرسال بيانات الاستدعاء إلى طبقة 2 (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) {

        // عند الانتهاء من سحب على طبقة 1 (L1)، يقوم جسر طبقة 1 (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 المُرحل من
     * العقد القديم
     */
    function donateETH() external payable {}
}

    /**
     * @param _l2Bridge عنوان الجسر القياسي على طبقة 2 (L2).
     * @param _l1Token عنوان الرمز المميز المقابل على طبقة 1 (L1).
     * @param _name اسم ERC-20.
     * @param _symbol رمز ERC-20.
     */
    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 الجسر القياسي على طبقة 2 (L2) هو عقد يعمل مع الجسر القياسي على طبقة 1 (L1) لـ
 * تمكين انتقالات ETH و ERC-20 بين طبقة 1 (L1) و طبقة 2 (L2).
 * يعمل هذا العقد كأداة سك للرموز المميزة الجديدة عندما يسمع عن إيداعات في الجسر القياسي
 * على طبقة 1 (L1).
 * يعمل هذا العقد أيضًا كأداة حرق للرموز المميزة المخصصة لعمليات السحب، لإبلاغ جسر
 * طبقة 1 (L1) بتحرير أموال طبقة 1 (L1).
 */
contract L2StandardBridge is IL2ERC20Bridge, CrossDomainEnabled {
    /********************************
     * مراجع العقود الخارجية *
     ********************************/

    address public l1TokenBridge;

    /***************
     * مُنشئ *
     ***************/

    /**
     * @param _l2CrossDomainMessenger المراسل عبر النطاقات المستخدم بواسطة هذا العقد.
     * @param _l1TokenBridge عنوان جسر طبقة 1 (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 ينفذ منطق عمليات السحب عن طريق حرق الرمز المميز وإبلاغ
     *      بوابة الرمز المميز على طبقة 1 (L1) بـ سحب.
     * @param _l2Token عنوان الرمز المميز على طبقة 2 (L2) حيث تم بدء السحب.
     * @param _from الحساب الذي سيتم سحب السحب منه على طبقة 2 (L2).
     * @param _to الحساب الذي سيتم إعطاء السحب له على طبقة 1 (L1).
     * @param _amount مبلغ الرمز المميز المراد سحبه.
     * @param _l1Gas غير مستخدم، ولكنه مضمن لاعتبارات التوافق المستقبلي المحتملة.
     * @param _data بيانات اختيارية لإرسالها إلى طبقة 1 (L1). يتم توفير هذه البيانات
     *        فقط لراحة العقود الخارجية. بصرف النظر عن فرض حد أقصى
     *        للطول، لا تقدم هذه العقود أي ضمانات حول محتواها.
     */
    function _initiateWithdrawal(
        address _l2Token,
        address _from,
        address _to,
        uint256 _amount,
        uint32 _l1Gas,
        bytes calldata _data
    ) internal {
        // عند بدء سحب، نقوم بـ حرق أموال الساحب لمنع
        // الاستخدام اللاحق على طبقة 2 (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
            );
        }

        // إرسال رسالة إلى جسر طبقة 1 (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

        } else {
            // إما أن الرمز المميز على طبقة 2 (L2) الذي يتم الإيداع فيه يختلف حول العنوان الصحيح
            // للرمز المميز الخاص به على طبقة 1 (L1)، أو لا يدعم الواجهة الصحيحة.
            // يجب أن يحدث هذا فقط إذا كان هناك رمز مميز ضار على طبقة 2 (L2)، أو إذا قام مستخدم بطريقة ما
            // بتحديد عنوان الرمز المميز الخاطئ على طبقة 2 (L2) للإيداع فيه.
            // في كلتا الحالتين، نوقف العملية هنا ونقوم ببناء سحب
            // رسالة حتى يتمكن المستخدمون من إخراج أموالهم في بعض الحالات.
            // لا توجد طريقة لمنع عقود الرموز المميزة الضارة تمامًا، ولكن هذا يحد من
            // خطأ المستخدم ويخفف من بعض أشكال سلوك العقد الضار.

            bytes memory message = abi.encodeWithSelector(
                IL1ERC20Bridge.finalizeERC20Withdrawal.selector,
                _l1Token,
                _l2Token,
                _to, // تم تبديل _to و _from هنا لإرجاع الإيداع إلى المرسل
                _from,
                _amount,
                _data
            );

            // إرسال رسالة إلى جسر طبقة 1 (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);
        }
    }
}