Hướng dẫn hợp đồng cầu nối tiêu chuẩn Optimism

1// SPDX-License-Identifier: MIT
Sao chép

1pragma solidity >0.5.0 <0.9.0;
Sao chép

1/**
2 * @title IL1ERC20Bridge
3 */
4interface IL1ERC20Bridge {
5    /**********
6     * Các sự kiện *
7     **********/
8
9    event ERC20DepositInitiated(
Hiện tất cả
Sao chép

1        address indexed _l1Token,
2        address indexed _l2Token,
Sao chép

1        address indexed _from,
2        address _to,
3        uint256 _amount,
4        bytes _data
5    );
Sao chép

1    event ERC20WithdrawalFinalized(
2        address indexed _l1Token,
3        address indexed _l2Token,
4        address indexed _from,
5        address _to,
6        uint256 _amount,
7        bytes _data
8    );
Sao chép

1
2    /********************
3     * Các hàm công khai *
4     ********************/
5
6    /**
7     * @dev lấy địa chỉ của hợp đồng cầu nối L2 tương ứng.
8     * @return Địa chỉ của hợp đồng cầu nối L2 tương ứng.
9     */
10    function l2TokenBridge() external returns (address);
Hiện tất cả
Sao chép

1    /**
2     * @dev gửi một lượng ERC20 vào số dư của người gọi trên L2.
3     * @param _l1Token Địa chỉ của L1 ERC20 mà chúng ta đang gửi
4     * @param _l2Token Địa chỉ của ERC20 L2 tương ứng của L1
5     * @param _amount Lượng ERC20 cần gửi
6     * @param _l2Gas Giới hạn gas cần thiết để hoàn tất việc gửi tiền trên L2.
7     * @param _data Dữ liệu tùy chọn để chuyển tiếp đến L2. Dữ liệu này được cung cấp
8     *        chỉ để thuận tiện cho các hợp đồng bên ngoài. Ngoài việc thực thi một
9     *        độ dài tối đa, các hợp đồng này không cung cấp bất kỳ đảm bảo nào về nội dung của nó.
10     */
11    function depositERC20(
12        address _l1Token,
13        address _l2Token,
14        uint256 _amount,
15        uint32 _l2Gas,
16        bytes calldata _data
17    ) external;
Hiện tất cả
Sao chép

1    /**
2     * @dev gửi một lượng ERC20 vào số dư của người nhận trên L2.
3     * @param _l1Token Địa chỉ của L1 ERC20 mà chúng ta đang gửi
4     * @param _l2Token Địa chỉ của ERC20 L2 tương ứng của L1
5     * @param _to Địa chỉ L2 để ghi có khoản rút tiền.
6     * @param _amount Số lượng ERC20 cần gửi.
7     * @param _l2Gas Giới hạn gas cần thiết để hoàn tất việc gửi tiền trên L2.
8     * @param _data Dữ liệu tùy chọn để chuyển tiếp đến L2. Dữ liệu này được cung cấp
9     *        chỉ để thuận tiện cho các hợp đồng bên ngoài. Ngoài việc thực thi một
10     *        độ dài tối đa, các hợp đồng này không cung cấp bất kỳ đảm bảo nào về nội dung của nó.
11     */
12    function depositERC20To(
13        address _l1Token,
14        address _l2Token,
15        address _to,
16        uint256 _amount,
17        uint32 _l2Gas,
18        bytes calldata _data
19    ) external;
Hiện tất cả
Sao chép

1    /*************************
2     * Các hàm liên chuỗi *
3     *************************/
4
5    /**
6     * @dev Hoàn tất việc rút tiền từ L2 sang L1 và ghi có tiền vào số dư của người nhận
7     * token ERC20 L1.
8     * Lệnh gọi này sẽ thất bại nếu việc rút tiền đã được khởi tạo từ L2 chưa được hoàn tất.
9     *
10     * @param _l1Token Địa chỉ của token L1 để finalizeWithdrawal.
11     * @param _l2Token Địa chỉ của token L2 nơi việc rút tiền được khởi tạo.
12     * @param _from Địa chỉ L2 khởi tạo giao dịch chuyển tiền.
13     * @param _to Địa chỉ L1 để ghi có khoản rút tiền.
14     * @param _amount Số lượng ERC20 cần gửi.
15     * @param _data Dữ liệu do người gửi cung cấp trên L2. Dữ liệu này được cung cấp
16     *   chỉ để thuận tiện cho các hợp đồng bên ngoài. Ngoài việc thực thi một
17     *   độ dài tối đa, các hợp đồng này không cung cấp bất kỳ đảm bảo nào về nội dung của nó.
18     */
19    function finalizeERC20Withdrawal(
20        address _l1Token,
21        address _l2Token,
22        address _from,
23        address _to,
24        uint256 _amount,
25        bytes calldata _data
26    ) external;
27}
Hiện tất cả
Sao chép

1// SPDX-License-Identifier: MIT
2pragma solidity >0.5.0 <0.9.0;
3
4import "./IL1ERC20Bridge.sol";
5
6/**
7 * @title IL1StandardBridge
8 */
9interface IL1StandardBridge is IL1ERC20Bridge {
10    /**********
11     * Các sự kiện *
12     **********/
13    event ETHDepositInitiated(
14        address indexed _from,
15        address indexed _to,
16        uint256 _amount,
17        bytes _data
18    );
Hiện tất cả
Sao chép

1    event ETHWithdrawalFinalized(
2        .
3        .
4        .
5    );
6
7    /********************
8     * Các hàm công khai *
9     ********************/
10
11    /**
12     * @dev Gửi một lượng ETH vào số dư của người gọi trên L2.
13            .
14            .
15            .
16     */
17    function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;
18
19    /**
20     * @dev Gửi một lượng ETH vào số dư của người nhận trên L2.
21            .
22            .
23            .
24     */
25    function depositETHTo(
26        address _to,
27        uint32 _l2Gas,
28        bytes calldata _data
29    ) external payable;
30
31    /*************************
32     * Các hàm liên chuỗi *
33     *************************/
34
35    /**
36     * @dev Hoàn tất việc rút tiền từ L2 sang L1 và ghi có tiền vào số dư của người nhận
37     * token L1 ETH. Vì chỉ có xDomainMessenger mới có thể gọi hàm này, nên nó sẽ không bao giờ được gọi
38     * trước khi việc rút tiền được hoàn tất.
39                .
40                .
41                .
42     */
43    function finalizeETHWithdrawal(
44        address _from,
45        address _to,
46        uint256 _amount,
47        bytes calldata _data
48    ) external;
49}
Hiện tất cả
Sao chép

1// SPDX-License-Identifier: MIT
2pragma solidity >0.5.0 <0.9.0;
3
4/* Interface Imports */
5import { ICrossDomainMessenger } from "./ICrossDomainMessenger.sol";
Sao chép

1/**
2 * @title CrossDomainEnabled
3 * @dev Hợp đồng trợ giúp cho các hợp đồng thực hiện giao tiếp liên miền
4 *
5 * Trình biên dịch được sử dụng: được định nghĩa bởi hợp đồng kế thừa
6 */
7contract CrossDomainEnabled {
8    /*************
9     * Biến *
10     *************/
11
12    // Hợp đồng Messenger được sử dụng để gửi và nhận thông điệp từ miền khác.
13    address public messenger;
14
15    /***************
16     * Hàm dựng *
17     ***************/
18
19    /**
20     * @param _messenger Địa chỉ của CrossDomainMessenger trên lớp hiện tại.
21     */
22    constructor(address _messenger) {
23        messenger = _messenger;
24    }
Hiện tất cả
Sao chép

1
2    /**********************
3     * Bổ ngữ hàm *
4     **********************/
5
6    /**
7     * @dev Chỉ cho phép hàm được sửa đổi được gọi bởi một tài khoản liên miền cụ thể.
8     * @param _sourceDomainAccount Tài khoản duy nhất trên miền gốc được
9     *  xác thực để gọi hàm này.
10     */
11    modifier onlyFromCrossDomainAccount(address _sourceDomainAccount) {
Hiện tất cả
Sao chép

1        require(
2            msg.sender == address(getCrossDomainMessenger()),
3            "OVM_XCHAIN: messenger contract unauthenticated"
4        );
Sao chép

1
2        require(
3            getCrossDomainMessenger().xDomainMessageSender() == _sourceDomainAccount,
4            "OVM_XCHAIN: wrong sender of cross-domain message"
5        );
Sao chép

1
2        _;
3    }
4
5    /**********************
6     * Các hàm nội bộ *
7     **********************/
8
9    /**
10     * @dev Lấy trình nhắn tin, thường từ bộ nhớ lưu trữ. Hàm này được hiển thị trong trường hợp một hợp đồng con
11     * cần ghi đè.
12     * @return Địa chỉ của hợp đồng trình nhắn tin liên miền nên được sử dụng.
13     */
14    function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {
15        return ICrossDomainMessenger(messenger);
16    }
Hiện tất cả
Sao chép

1
2    /**
3     * Gửi một thông điệp đến một tài khoản trên một miền khác
4     * @param _crossDomainTarget Người nhận dự định trên miền đích
5     * @param _message Dữ liệu để gửi đến mục tiêu (thường là calldata cho một hàm với
6     *  `onlyFromCrossDomainAccount()`)
7     * @param _gasLimit gasLimit cho việc nhận thông điệp trên miền đích.
8     */
9    function sendCrossDomainMessage(
10        address _crossDomainTarget,
11        uint32 _gasLimit,
12        bytes memory _message
Hiện tất cả
Sao chép

1    ) internal {
2        // slither-disable-next-line reentrancy-events, reentrancy-benign
Sao chép

1        getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);
2    }
3}
Sao chép

1// SPDX-License-Identifier: MIT
2pragma solidity ^0.8.9;
Sao chép

1/* Interface Imports */
2import { IL1StandardBridge } from "./IL1StandardBridge.sol";
3import { IL1ERC20Bridge } from "./IL1ERC20Bridge.sol";
Sao chép

1import { IL2ERC20Bridge } from "../../L2/messaging/IL2ERC20Bridge.sol";
Sao chép

1import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
Sao chép

1/* Library Imports */
2import { CrossDomainEnabled } from "../../libraries/bridge/CrossDomainEnabled.sol";
Sao chép

1import { Lib_PredeployAddresses } from "../../libraries/constants/Lib_PredeployAddresses.sol";
Sao chép

1import { Address } from "@openzeppelin/contracts/utils/Address.sol";
Sao chép

1import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
Sao chép

1/**
2 * @title L1StandardBridge
3 * @dev Cầu nối L1 ETH và ERC20 là một hợp đồng lưu trữ các khoản tiền L1 đã gửi và các token tiêu chuẩn
4 * đang được sử dụng trên L2. Nó đồng bộ hóa một Cầu nối L2 tương ứng, thông báo cho nó về các khoản tiền gửi
5 * và lắng nghe nó về các khoản rút tiền mới được hoàn tất.
6 *
7 */
8contract L1StandardBridge is IL1StandardBridge, CrossDomainEnabled {
9    using SafeERC20 for IERC20;
Hiện tất cả
Sao chép

1
2    /********************************
3     * Tham chiếu Hợp đồng Bên ngoài *
4     ********************************/
5
6    address public l2TokenBridge;
Sao chép

1
2    // Ánh xạ token L1 đến token L2 đến số dư của token L1 đã gửi
3    mapping(address => mapping(address => uint256)) public deposits;
Sao chép

1
2    /***************
3     * Hàm dựng *
4     ***************/
5
6    // Hợp đồng này hoạt động đằng sau một proxy, vì vậy các tham số của hàm dựng sẽ không được sử dụng.
7    constructor() CrossDomainEnabled(address(0)) {}
Sao chép

1    /******************
2     * Khởi tạo *
3     ******************/
4
5    /**
6     * @param _l1messenger Địa chỉ L1 Messenger đang được sử dụng để giao tiếp liên chuỗi.
7     * @param _l2TokenBridge Địa chỉ cầu nối tiêu chuẩn L2.
8     */
9    // slither-disable-next-line external-function
Hiện tất cả
Sao chép

1    function initialize(address _l1messenger, address _l2TokenBridge) public {
2        require(messenger == address(0), "Contract has already been initialized.");
Sao chép

1        messenger = _l1messenger;
2        l2TokenBridge = _l2TokenBridge;
3    }
Sao chép

1
2    /**************
3     * Gửi tiền *
4     **************/
5
6    /** @dev Bổ ngữ yêu cầu người gửi phải là EOA. Kiểm tra này có thể bị bỏ qua bởi một hợp đồng
7     * độc hại thông qua initcode, nhưng nó xử lý lỗi người dùng mà chúng tôi muốn tránh.
8     */
9    modifier onlyEOA() {
10        // Được sử dụng để ngăn chặn việc gửi tiền từ các hợp đồng (tránh mất token do nhầm lẫn)
11        require(!Address.isContract(msg.sender), "Account not EOA");
12        _;
13    }
Hiện tất cả
Sao chép

1    /**
2     * @dev Hàm này có thể được gọi mà không có dữ liệu
3     * để gửi một lượng ETH vào số dư của người gọi trên L2.
4     * Vì hàm nhận không lấy dữ liệu, một lượng
5     * mặc định thận trọng được chuyển tiếp đến L2.
6     */
7    receive() external payable onlyEOA {
8        _initiateETHDeposit(msg.sender, msg.sender, 200_000, bytes(""));
9    }
Hiện tất cả
Sao chép

1    /**
2     * @inheritdoc IL1StandardBridge
3     */
4    function depositETH(uint32 _l2Gas, bytes calldata _data) external payable onlyEOA {
5        _initiateETHDeposit(msg.sender, msg.sender, _l2Gas, _data);
6    }
7
8    /**
9     * @inheritdoc IL1StandardBridge
10     */
11    function depositETHTo(
12        address _to,
13        uint32 _l2Gas,
14        bytes calldata _data
15    ) external payable {
16        _initiateETHDeposit(msg.sender, _to, _l2Gas, _data);
17    }
Hiện tất cả
Sao chép

1    /**
2     * @dev Thực hiện logic gửi tiền bằng cách lưu trữ ETH và thông báo cho Cổng ETH L2
3     * về việc gửi tiền.
4     * @param _from Tài khoản để lấy tiền gửi từ L1.
5     * @param _to Tài khoản để cấp tiền gửi trên L2.
6     * @param _l2Gas Giới hạn gas cần thiết để hoàn tất việc gửi tiền trên L2.
7     * @param _data Dữ liệu tùy chọn để chuyển tiếp đến L2. Dữ liệu này được cung cấp
8     *        chỉ để thuận tiện cho các hợp đồng bên ngoài. Ngoài việc thực thi một
9     *        độ dài tối đa, các hợp đồng này không cung cấp bất kỳ đảm bảo nào về nội dung của nó.
10     */
11    function _initiateETHDeposit(
12        address _from,
13        address _to,
14        uint32 _l2Gas,
15        bytes memory _data
16    ) internal {
17        // Xây dựng calldata cho lệnh gọi finalizeDeposit
18        bytes memory message = abi.encodeWithSelector(
Hiện tất cả
Sao chép

1            IL2ERC20Bridge.finalizeDeposit.selector,
2            address(0),
3            Lib_PredeployAddresses.OVM_ETH,
4            _from,
5            _to,
6            msg.value,
7            _data
8        );
Sao chép

1        // Gửi calldata vào L2
2        // slither-disable-next-line reentrancy-events
3        sendCrossDomainMessage(l2TokenBridge, _l2Gas, message);
Sao chép

1        // slither-disable-next-line reentrancy-events
2        emit ETHDepositInitiated(_from, _to, msg.value, _data);
3    }
Sao chép

1    /**
2     * @inheritdoc IL1ERC20Bridge
3     */
4    function depositERC20(
5		.
6		.
7		.
8    ) external virtual onlyEOA {
9        _initiateERC20Deposit(_l1Token, _l2Token, msg.sender, msg.sender, _amount, _l2Gas, _data);
10    }
11
12    /**
13     * @inheritdoc IL1ERC20Bridge
14     */
15    function depositERC20To(
16		.
17		.
18		.
19    ) external virtual {
20        _initiateERC20Deposit(_l1Token, _l2Token, msg.sender, _to, _amount, _l2Gas, _data);
21    }
Hiện tất cả
Sao chép

1    /**
2     * @dev Thực hiện logic gửi tiền bằng cách thông báo cho Token đã gửi L2
3     * hợp đồng về việc gửi tiền và gọi một trình xử lý để khóa các khoản tiền L1. (ví dụ, transferFrom)
4     *
5     * @param _l1Token Địa chỉ của L1 ERC20 chúng ta đang gửi
6     * @param _l2Token Địa chỉ của ERC20 L2 tương ứng của L1
7     * @param _from Tài khoản để lấy tiền gửi từ L1
8     * @param _to Tài khoản để cấp tiền gửi trên L2
9     * @param _amount Số lượng ERC20 cần gửi.
10     * @param _l2Gas Giới hạn gas cần thiết để hoàn tất việc gửi tiền trên L2.
11     * @param _data Dữ liệu tùy chọn để chuyển tiếp đến L2. Dữ liệu này được cung cấp
12     *        chỉ để thuận tiện cho các hợp đồng bên ngoài. Ngoài việc thực thi một
13     *        độ dài tối đa, các hợp đồng này không cung cấp bất kỳ đảm bảo nào về nội dung của nó.
14     */
15    function _initiateERC20Deposit(
16        address _l1Token,
17        address _l2Token,
18        address _from,
19        address _to,
20        uint256 _amount,
21        uint32 _l2Gas,
22        bytes calldata _data
23    ) internal {
Hiện tất cả
Sao chép

1        // Khi một khoản tiền gửi được khởi tạo trên L1, Cầu nối L1 sẽ chuyển tiền vào chính nó cho các khoản
2        // rút tiền trong tương lai. safeTransferFrom cũng kiểm tra xem hợp đồng có mã hay không, vì vậy điều này sẽ thất bại nếu
3        // _from là một EOA hoặc address(0).
4        // slither-disable-next-line reentrancy-events, reentrancy-benign
5        IERC20(_l1Token).safeTransferFrom(_from, address(this), _amount);
Sao chép

1        // Xây dựng calldata cho _l2Token.finalizeDeposit(_to, _amount)
2        bytes memory message = abi.encodeWithSelector(
3            IL2ERC20Bridge.finalizeDeposit.selector,
4            _l1Token,
5            _l2Token,
6            _from,
7            _to,
8            _amount,
9            _data
10        );
11
12        // Gửi calldata vào L2
13        // slither-disable-next-line reentrancy-events, reentrancy-benign
14        sendCrossDomainMessage(l2TokenBridge, _l2Gas, message);
15
16        // slither-disable-next-line reentrancy-benign
17        deposits[_l1Token][_l2Token] = deposits[_l1Token][_l2Token] + _amount;
Hiện tất cả
Sao chép

1
2        // slither-disable-next-line reentrancy-events
3        emit ERC20DepositInitiated(_l1Token, _l2Token, _from, _to, _amount, _data);
4    }
5
6    /*************************
7     * Các hàm liên chuỗi *
8     *************************/
9
10    /**
11     * @inheritdoc IL1StandardBridge
12     */
13    function finalizeETHWithdrawal(
14        address _from,
15        address _to,
16        uint256 _amount,
17        bytes calldata _data
Hiện tất cả
Sao chép

1    ) external onlyFromCrossDomainAccount(l2TokenBridge) {
Sao chép

1        // slither-disable-next-line reentrancy-events
2        (bool success, ) = _to.call{ value: _amount }(new bytes(0));
Sao chép

1        require(success, "TransferHelper::safeTransferETH: ETH transfer failed");
2
3        // slither-disable-next-line reentrancy-events
4        emit ETHWithdrawalFinalized(_from, _to, _amount, _data);
Sao chép

1    }
2
3    /**
4     * @inheritdoc IL1ERC20Bridge
5     */
6    function finalizeERC20Withdrawal(
7        address _l1Token,
8        address _l2Token,
9        address _from,
10        address _to,
11        uint256 _amount,
12        bytes calldata _data
13    ) external onlyFromCrossDomainAccount(l2TokenBridge) {
Hiện tất cả
Sao chép

1        deposits[_l1Token][_l2Token] = deposits[_l1Token][_l2Token] - _amount;
Sao chép

1
2        // Khi một khoản rút tiền được hoàn tất trên L1, Cầu nối L1 sẽ chuyển tiền cho người rút
3        // slither-disable-next-line reentrancy-events
4        IERC20(_l1Token).safeTransfer(_to, _amount);
5
6        // slither-disable-next-line reentrancy-events
7        emit ERC20WithdrawalFinalized(_l1Token, _l2Token, _from, _to, _amount, _data);
8    }
9
10
11    /*****************************
12     * Tạm thời - Di chuyển ETH *
13     *****************************/
14
15    /**
16     * @dev Thêm số dư ETH vào tài khoản. Điều này nhằm cho phép ETH
17     * được di chuyển từ một cổng cũ sang một cổng mới.
18     * LƯU Ý: Điều này được để lại cho một lần nâng cấp duy nhất để chúng tôi có thể nhận được ETH đã di chuyển từ
19     * hợp đồng cũ
20     */
21    function donateETH() external payable {}
22}
Hiện tất cả
Sao chép

1// SPDX-License-Identifier: MIT
2pragma solidity ^0.8.9;
3
4import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
Sao chép

1import { IERC165 } from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
Sao chép

1interface IL2StandardERC20 is IERC20, IERC165 {
2    function l1Token() external returns (address);
Sao chép

1
2    function mint(address _to, uint256 _amount) external;
3
4    function burn(address _from, uint256 _amount) external;
5
6    event Mint(address indexed _account, uint256 _amount);
7    event Burn(address indexed _account, uint256 _amount);
8}
Sao chép

1// SPDX-License-Identifier: MIT
2pragma solidity ^0.8.9;
3
4import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
Sao chép

1import "./IL2StandardERC20.sol";
2
3contract L2StandardERC20 is IL2StandardERC20, ERC20 {
4    address public l1Token;
5    address public l2Bridge;
Sao chép

1
2    /**
3     * @param _l2Bridge Địa chỉ của cầu nối tiêu chuẩn L2.
4     * @param _l1Token Địa chỉ của token L1 tương ứng.
5     * @param _name Tên ERC20.
6     * @param _symbol Ký hiệu ERC20.
7     */
8    constructor(
9        address _l2Bridge,
10        address _l1Token,
11        string memory _name,
12        string memory _symbol
13    ) ERC20(_name, _symbol) {
14        l1Token = _l1Token;
15        l2Bridge = _l2Bridge;
16    }
Hiện tất cả
Sao chép

1
2    modifier onlyL2Bridge() {
3        require(msg.sender == l2Bridge, "Only L2 Bridge can mint and burn");
4        _;
5    }
6
7
8    // slither-disable-next-line external-function
9    function supportsInterface(bytes4 _interfaceId) public pure returns (bool) {
10        bytes4 firstSupportedInterface = bytes4(keccak256("supportsInterface(bytes4)")); // ERC165
11        bytes4 secondSupportedInterface = IL2StandardERC20.l1Token.selector ^
12            IL2StandardERC20.mint.selector ^
13            IL2StandardERC20.burn.selector;
14        return _interfaceId == firstSupportedInterface || _interfaceId == secondSupportedInterface;
15    }
Hiện tất cả
Sao chép

1    // slither-disable-next-line external-function
2    function mint(address _to, uint256 _amount) public virtual onlyL2Bridge {
3        _mint(_to, _amount);
4
5        emit Mint(_to, _amount);
6    }
7
8    // slither-disable-next-line external-function
9    function burn(address _from, uint256 _amount) public virtual onlyL2Bridge {
10        _burn(_from, _amount);
11
12        emit Burn(_from, _amount);
13    }
14}
Hiện tất cả
Sao chép

1// SPDX-License-Identifier: MIT
2pragma solidity ^0.8.9;
3
4/* Interface Imports */
5import { IL1StandardBridge } from "../../L1/messaging/IL1StandardBridge.sol";
6import { IL1ERC20Bridge } from "../../L1/messaging/IL1ERC20Bridge.sol";
7import { IL2ERC20Bridge } from "./IL2ERC20Bridge.sol";
Sao chép

1/* Library Imports */
2import { ERC165Checker } from "@openzeppelin/contracts/utils/introspection/ERC165Checker.sol";
3import { CrossDomainEnabled } from "../../libraries/bridge/CrossDomainEnabled.sol";
4import { Lib_PredeployAddresses } from "../../libraries/constants/Lib_PredeployAddresses.sol";
5
6/* Contract Imports */
7import { IL2StandardERC20 } from "../../standards/IL2StandardERC20.sol";
8
9/**
10 * @title L2StandardBridge
11 * @dev Cầu nối Tiêu chuẩn L2 là một hợp đồng hoạt động cùng với cầu nối Tiêu chuẩn L1 để
12 * cho phép chuyển đổi ETH và ERC20 giữa L1 và L2.
13 * Hợp đồng này hoạt động như một trình đúc các token mới khi nó nghe về các khoản tiền gửi vào cầu nối Tiêu chuẩn
14 * L1.
15 * Hợp đồng này cũng hoạt động như một trình đốt các token dự định rút, thông báo cho cầu nối L1
16 * để giải phóng các khoản tiền L1.
17 */
18contract L2StandardBridge is IL2ERC20Bridge, CrossDomainEnabled {
19    /********************************
20     * Tham chiếu Hợp đồng Bên ngoài *
21     ********************************/
22
23    address public l1TokenBridge;
Hiện tất cả
Sao chép

1
2    /***************
3     * Hàm dựng *
4     ***************/
5
6    /**
7     * @param _l2CrossDomainMessenger Trình nhắn tin liên miền được sử dụng bởi hợp đồng này.
8     * @param _l1TokenBridge Địa chỉ của cầu nối L1 được triển khai trên chuỗi chính.
9     */
10    constructor(address _l2CrossDomainMessenger, address _l1TokenBridge)
11        CrossDomainEnabled(_l2CrossDomainMessenger)
12    {
13        l1TokenBridge = _l1TokenBridge;
14    }
15
16    /***************
17     * Rút tiền *
18     ***************/
19
20    /**
21     * @inheritdoc IL2ERC20Bridge
22     */
23    function withdraw(
24        address _l2Token,
25        uint256 _amount,
26        uint32 _l1Gas,
27        bytes calldata _data
28    ) external virtual {
29        _initiateWithdrawal(_l2Token, msg.sender, msg.sender, _amount, _l1Gas, _data);
30    }
31
32    /**
33     * @inheritdoc IL2ERC20Bridge
34     */
35    function withdrawTo(
36        address _l2Token,
37        address _to,
38        uint256 _amount,
39        uint32 _l1Gas,
40        bytes calldata _data
41    ) external virtual {
42        _initiateWithdrawal(_l2Token, msg.sender, _to, _amount, _l1Gas, _data);
43    }
Hiện tất cả
Sao chép

1
2    /**
3     * @dev Thực hiện logic rút tiền bằng cách đốt token và thông báo
4     *      cho Cổng token L1 về việc rút tiền.
5     * @param _l2Token Địa chỉ của token L2 nơi việc rút tiền được khởi tạo.
6     * @param _from Tài khoản để lấy tiền rút từ L2.
7     * @param _to Tài khoản để cấp tiền rút trên L1.
8     * @param _amount Số lượng token cần rút.
9     * @param _l1Gas Không sử dụng, nhưng được bao gồm cho các cân nhắc tương thích về phía trước tiềm năng.
10     * @param _data Dữ liệu tùy chọn để chuyển tiếp đến L1. Dữ liệu này được cung cấp
11     *        chỉ để thuận tiện cho các hợp đồng bên ngoài. Ngoài việc thực thi một
12     *        độ dài tối đa, các hợp đồng này không cung cấp bất kỳ đảm bảo nào về nội dung của nó.
13     */
14    function _initiateWithdrawal(
15        address _l2Token,
16        address _from,
17        address _to,
18        uint256 _amount,
19        uint32 _l1Gas,
20        bytes calldata _data
21    ) internal {
22        // Khi một khoản rút tiền được khởi tạo, chúng tôi đốt tiền của người rút để ngăn chặn việc sử dụng L2
23        // sau đó
24        // slither-disable-next-line reentrancy-events
25        IL2StandardERC20(_l2Token).burn(msg.sender, _amount);
Hiện tất cả
Sao chép

1
2        // Xây dựng calldata cho l1TokenBridge.finalizeERC20Withdrawal(_to, _amount)
3        // slither-disable-next-line reentrancy-events
4        address l1Token = IL2StandardERC20(_l2Token).l1Token();
5        bytes memory message;
6
7        if (_l2Token == Lib_PredeployAddresses.OVM_ETH) {
Sao chép

1            message = abi.encodeWithSelector(
2                IL1StandardBridge.finalizeETHWithdrawal.selector,
3                _from,
4                _to,
5                _amount,
6                _data
7            );
8        } else {
9            message = abi.encodeWithSelector(
10                IL1ERC20Bridge.finalizeERC20Withdrawal.selector,
11                l1Token,
12                _l2Token,
13                _from,
14                _to,
15                _amount,
16                _data
17            );
18        }
19
20        // Gửi thông điệp lên cầu nối L1
21        // slither-disable-next-line reentrancy-events
22        sendCrossDomainMessage(l1TokenBridge, _l1Gas, message);
23
24        // slither-disable-next-line reentrancy-events
25        emit WithdrawalInitiated(l1Token, _l2Token, msg.sender, _to, _amount, _data);
26    }
27
28    /************************************
29     * Hàm liên chuỗi: Gửi tiền *
30     ************************************/
31
32    /**
33     * @inheritdoc IL2ERC20Bridge
34     */
35    function finalizeDeposit(
36        address _l1Token,
37        address _l2Token,
38        address _from,
39        address _to,
40        uint256 _amount,
41        bytes calldata _data
Hiện tất cả
Sao chép

1    ) external virtual onlyFromCrossDomainAccount(l1TokenBridge) {
Sao chép

1        // Kiểm tra token mục tiêu có tuân thủ và
2        // xác minh token đã gửi trên L1 khớp với biểu diễn token đã gửi L2 ở đây
3        if (
4            // slither-disable-next-line reentrancy-events
5            ERC165Checker.supportsInterface(_l2Token, 0x1d1d8b63) &&
6            _l1Token == IL2StandardERC20(_l2Token).l1Token()
Sao chép

1        ) {
2            // Khi một khoản tiền gửi được hoàn tất, chúng tôi ghi có vào tài khoản trên L2 với cùng một số lượng
3            // token.
4            // slither-disable-next-line reentrancy-events
5            IL2StandardERC20(_l2Token).mint(_to, _amount);
6            // slither-disable-next-line reentrancy-events
7            emit DepositFinalized(_l1Token, _l2Token, _from, _to, _amount, _data);
Sao chép

1        } else {
2            // Hoặc token L2 đang được gửi vào không đồng ý về địa chỉ chính xác
3            // của token L1 của nó, hoặc không hỗ trợ giao diện chính xác.
4            // Điều này chỉ nên xảy ra nếu có một token L2 độc hại, hoặc nếu người dùng bằng cách nào đó
5            // chỉ định sai địa chỉ token L2 để gửi vào.
6            // Trong cả hai trường hợp, chúng tôi dừng quá trình ở đây và xây dựng một thông điệp
7            // rút tiền để người dùng có thể lấy lại tiền của họ trong một số trường hợp.
8            // Không có cách nào để ngăn chặn hoàn toàn các hợp đồng token độc hại, nhưng điều này giới hạn
9            // lỗi người dùng và giảm thiểu một số hình thức hành vi hợp đồng độc hại.
Hiện tất cả
Sao chép

1            bytes memory message = abi.encodeWithSelector(
2                IL1ERC20Bridge.finalizeERC20Withdrawal.selector,
3                _l1Token,
4                _l2Token,
5                _to, // đã hoán đổi _to và _from ở đây để trả lại khoản tiền gửi cho người gửi
6                _from,
7                _amount,
8                _data
9            );
10
11            // Gửi thông điệp lên cầu nối L1
12            // slither-disable-next-line reentrancy-events
13            sendCrossDomainMessage(l1TokenBridge, 0, message);
14            // slither-disable-next-line reentrancy-events
15            emit DepositFailed(_l1Token, _l2Token, _from, _to, _amount, _data);
16        }
17    }
18}
Hiện tất cả
Sao chép