Add Mantle [don't merge] [duplicates fork]

.env.wsteth.mnt_goerli

@@ -0,0 +1,71 @@
+# Detailed info: https://github.com/lidofinance/lido-l2#Project-Configuration
+
+# ############################
+# RPCs
+# ############################
+
+RPC_ETH_GOERLI=https://eth-goerli.g.alchemy.com/v2/
+RPC_MNT_GOERLI=https://rpc.testnet.mantle.xyz
+
+# ############################
+# Etherscan
+# ############################
+
+ETHERSCAN_API_KEY_ETH=
+ETHERSCAN_API_KEY_MNT=
+
+# ############################
+# Bridge/Gateway Deployment
+# ############################
+
+# Address of the token to deploy the bridge/gateway for wstETH
+TOKEN=0x6320cd32aa674d2898a68ec82e869385fc5f7e2f
+
+# Name of the network environments used by deployment scripts.
+# Might be one of: "mainnet", "goerli".
+NETWORK=goerli
+
+# Private key of the deployer account used for deployment process
+ETH_DEPLOYER_PRIVATE_KEY=
+MNT_DEPLOYER_PRIVATE_KEY=
+
+L1_PROXY_ADMIN=0x4333218072D5d7008546737786663c38B4D561A4
+L1_BRIDGE_ADMIN=0x4333218072D5d7008546737786663c38B4D561A4
+L1_DEPOSITS_ENABLED=true
+L1_WITHDRAWALS_ENABLED=true
+L1_DEPOSITS_ENABLERS=["0x4333218072D5d7008546737786663c38B4D561A4"]
+L1_DEPOSITS_DISABLERS="["0x4333218072D5d7008546737786663c38B4D561A4", "0x7fE7fa4EF7D134Dbf8B616Ba7B675F26286BC2cd","0xa6688D0DcAd346eCc275cda98c91086fEC3fE31C"]"
+L1_WITHDRAWALS_ENABLERS=["0x4333218072D5d7008546737786663c38B4D561A4"]
+L1_WITHDRAWALS_DISABLERS="["0x4333218072D5d7008546737786663c38B4D561A4", "0x7fE7fa4EF7D134Dbf8B616Ba7B675F26286BC2cd","0xa6688D0DcAd346eCc275cda98c91086fEC3fE31C"]"
+
+L2_PROXY_ADMIN=0xaF3dcfddBbBC59E7d2ec6f6e4273f7F1a3C7B6fe
+L2_BRIDGE_ADMIN=0xaF3dcfddBbBC59E7d2ec6f6e4273f7F1a3C7B6fe
+L2_DEPOSITS_ENABLED=true
+L2_WITHDRAWALS_ENABLED=true
+L2_DEPOSITS_ENABLERS=["0x55C39356C714Cde16F8a80302c1Ce9DfAC6f5a35"]
+L2_DEPOSITS_DISABLERS="["0x55C39356C714Cde16F8a80302c1Ce9DfAC6f5a35", "0x7fE7fa4EF7D134Dbf8B616Ba7B675F26286BC2cd"]"
+L2_WITHDRAWALS_ENABLERS=["0x55C39356C714Cde16F8a80302c1Ce9DfAC6f5a35"]
+L2_WITHDRAWALS_DISABLERS="["0x55C39356C714Cde16F8a80302c1Ce9DfAC6f5a35", "0x7fE7fa4EF7D134Dbf8B616Ba7B675F26286BC2cd"]"
+
+# ############################
+# Integration & E2E Testing
+# ############################
+
+TESTING_MNT_NETWORK=goerli
+TESTING_MNT_L1_TOKEN=0x6320cd32aa674d2898a68ec82e869385fc5f7e2f
+TESTING_MNT_L2_TOKEN=0xe8964a99d5DE7cEE2743B20113a52C953b0916E9
+TESTING_MNT_L1_ERC20_TOKEN_BRIDGE=0xDdC89Bd27F9A1C47A5c20dF0783dE52f55513598
+TESTING_MNT_L2_ERC20_TOKEN_BRIDGE=0x423702bC3Fb92f59Be440354456f0481934bF1f5
+
+# ############################
+# Integration Testing
+# ############################
+
+TESTING_USE_DEPLOYED_CONTRACTS=true
+TESTING_L1_TOKENS_HOLDER=
+
+# ############################
+# E2E Testing
+# ############################
+
+TESTING_PRIVATE_KEY=

.env.wsteth.mnt_mainnet

@@ -0,0 +1,74 @@
+# Detailed info: https://github.com/lidofinance/lido-l2#Project-Configuration
+
+# ############################
+# RPCs
+# ############################
+
+RPC_ETH_MAINNET=
+RPC_OPT_MAINNET=
+
+# ############################
+# Etherscan
+# ############################
+
+ETHERSCAN_API_KEY_ETH=
+ETHERSCAN_API_KEY_OPT=
+
+# ############################
+# Bridge/Gateway Deployment
+# ############################
+
+# Address of the token to deploy the bridge/gateway for
+TOKEN=0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0
+
+# Name of the network environments used by deployment scripts.
+# Might be one of: "mainnet", "goerli".
+NETWORK=mainnet
+
+# Run deployment in the forking network instead of public ones
+FORKING=true
+
+# Private key of the deployer account used for deployment process
+ETH_DEPLOYER_PRIVATE_KEY=
+OPT_DEPLOYER_PRIVATE_KEY=
+
+L1_PROXY_ADMIN=0x3e40D73EB977Dc6a537aF587D48316feE66E9C8c
+L1_BRIDGE_ADMIN=0x3e40D73EB977Dc6a537aF587D48316feE66E9C8c
+L1_DEPOSITS_ENABLED=false
+L1_WITHDRAWALS_ENABLED=true
+L1_DEPOSITS_ENABLERS=["0x3e40D73EB977Dc6a537aF587D48316feE66E9C8c","0x3cd9F71F80AB08ea5a7Dca348B5e94BC595f26A0"]
+L1_DEPOSITS_DISABLERS=["0x3e40D73EB977Dc6a537aF587D48316feE66E9C8c","0x73b047fe6337183A454c5217241D780a932777bD"]
+L1_WITHDRAWALS_ENABLERS=["0x3e40D73EB977Dc6a537aF587D48316feE66E9C8c"]
+L1_WITHDRAWALS_DISABLERS=["0x3e40D73EB977Dc6a537aF587D48316feE66E9C8c","0x73b047fe6337183A454c5217241D780a932777bD"]
+
+L2_PROXY_ADMIN=0xEfa0dB536d2c8089685630fafe88CF7805966FC3
+L2_BRIDGE_ADMIN=0xEfa0dB536d2c8089685630fafe88CF7805966FC3
+L2_DEPOSITS_ENABLED=true
+L2_WITHDRAWALS_ENABLED=true
+L2_DEPOSITS_ENABLERS=["0xEfa0dB536d2c8089685630fafe88CF7805966FC3"]
+L2_DEPOSITS_DISABLERS=["0xEfa0dB536d2c8089685630fafe88CF7805966FC3","0x4Cf8fE0A4c2539F7EFDD2047d8A5D46F14613088"]
+L2_WITHDRAWALS_ENABLERS=["0xEfa0dB536d2c8089685630fafe88CF7805966FC3"]
+L2_WITHDRAWALS_DISABLERS=["0xEfa0dB536d2c8089685630fafe88CF7805966FC3","0x4Cf8fE0A4c2539F7EFDD2047d8A5D46F14613088"]
+
+# ############################
+# Integration Acceptance & E2E Testing
+# ############################
+
+TESTING_OPT_NETWORK=mainnet
+TESTING_OPT_L1_TOKEN=0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0
+TESTING_OPT_L2_TOKEN=0x1F32b1c2345538c0c6f582fCB022739c4A194Ebb
+TESTING_OPT_L1_ERC20_TOKEN_BRIDGE=0x76943C0D61395d8F2edF9060e1533529cAe05dE6
+TESTING_OPT_L2_ERC20_TOKEN_BRIDGE=0x8E01013243a96601a86eb3153F0d9Fa4fbFb6957
+
+# ############################
+# Integration Testing
+# ############################
+
+TESTING_USE_DEPLOYED_CONTRACTS=true
+TESTING_L1_TOKENS_HOLDER=
+
+# ############################
+# E2E Testing
+# ############################
+
+TESTING_PRIVATE_KEY=

.solcover.js

@@ -1,3 +1,3 @@
 module.exports = {
- skipFiles: ["stubs", "optimism/stubs", "proxy/stubs", "arbitrum/stubs"],
+ skipFiles: ["stubs", "optimism/stubs", "proxy/stubs", "arbitrum/stubs", "mantle/stubs"],
 };

contracts/mantle/CrossDomainEnabled.sol

@@ -0,0 +1,46 @@
+// SPDX-FileCopyrightText: 2022 Lido <info@lido.fi>
+// SPDX-License-Identifier: GPL-3.0
+
+pragma solidity 0.8.10;
+
+import {ICrossDomainMessenger} from "./interfaces/ICrossDomainMessenger.sol";
+
+/// @dev Helper contract for contracts performing cross-domain communications
+contract CrossDomainEnabled {
+ /// @notice Messenger contract used to send and receive messages from the other domain
+ ICrossDomainMessenger public immutable messenger;
+
+ /// @param messenger_ Address of the CrossDomainMessenger on the current layer
+ constructor(address messenger_) {
+ messenger = ICrossDomainMessenger(messenger_);
+ }
+
+ /// @dev Sends a message to an account on another domain
+ /// @param crossDomainTarget_ Intended recipient on the destination domain
+ /// @param message_ Data to send to the target (usually calldata to a function with
+ /// `onlyFromCrossDomainAccount()`)
+ /// @param gasLimit_ gasLimit for the receipt of the message on the target domain.
+ function sendCrossDomainMessage(
+ address crossDomainTarget_,
+ uint32 gasLimit_,
+ bytes memory message_
+ ) internal {
+ messenger.sendMessage(crossDomainTarget_, message_, gasLimit_);
+ }
+
+ /// @dev Enforces that the modified function is only callable by a specific cross-domain account
+ /// @param sourceDomainAccount_ The only account on the originating domain which is
+ /// authenticated to call this function
+ modifier onlyFromCrossDomainAccount(address sourceDomainAccount_) {
+ if (msg.sender != address(messenger)) {
+ revert ErrorUnauthorizedMessenger();
+ }
+ if (messenger.xDomainMessageSender() != sourceDomainAccount_) {
+ revert ErrorWrongCrossDomainSender();
+ }
+ _;
+ }
+
+ error ErrorUnauthorizedMessenger();
+ error ErrorWrongCrossDomainSender();
+}

contracts/mantle/L1ERC20TokenBridge.sol

@@ -0,0 +1,150 @@
+// SPDX-FileCopyrightText: 2022 Lido <info@lido.fi>
+// SPDX-License-Identifier: GPL-3.0
+
+pragma solidity 0.8.10;
+
+import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+import {Address} from "@openzeppelin/contracts/utils/Address.sol";
+import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
+
+import {IL1ERC20Bridge} from "./interfaces/IL1ERC20Bridge.sol";
+import {IL2ERC20Bridge} from "./interfaces/IL2ERC20Bridge.sol";
+
+import {BridgingManager} from "../BridgingManager.sol";
+import {BridgeableTokens} from "../BridgeableTokens.sol";
+import {CrossDomainEnabled} from "./CrossDomainEnabled.sol";
+
+/// @author psirex
+/// @notice The L1 ERC20 token bridge locks bridged tokens on the L1 side, sends deposit messages
+/// on the L2 side, and finalizes token withdrawals from L2. Additionally, adds the methods for
+/// bridging management: enabling and disabling withdrawals/deposits
+contract L1ERC20TokenBridge is
+ IL1ERC20Bridge,
+ BridgingManager,
+ BridgeableTokens,
+ CrossDomainEnabled
+{
+ using SafeERC20 for IERC20;
+
+ /// @inheritdoc IL1ERC20Bridge
+ address public immutable l2TokenBridge;
+
+ /// @param messenger_ L1 messenger address being used for cross-chain communications
+ /// @param l2TokenBridge_ Address of the corresponding L2 bridge
+ /// @param l1Token_ Address of the bridged token in the L1 chain
+ /// @param l2Token_ Address of the token minted on the L2 chain when token bridged
+ constructor(
+ address messenger_,
+ address l2TokenBridge_,
+ address l1Token_,
+ address l2Token_
+ ) CrossDomainEnabled(messenger_) BridgeableTokens(l1Token_, l2Token_) {
+ l2TokenBridge = l2TokenBridge_;
+ }
+
+ /// @inheritdoc IL1ERC20Bridge
+ function depositERC20(
+ address l1Token_,
+ address l2Token_,
+ uint256 amount_,
+ uint32 l2Gas_,
+ bytes calldata data_
+ )
+ external
+ whenDepositsEnabled
+ onlySupportedL1Token(l1Token_)
+ onlySupportedL2Token(l2Token_)
+ {
+ if (Address.isContract(msg.sender)) {
+ revert ErrorSenderNotEOA();
+ }
+ _initiateERC20Deposit(msg.sender, msg.sender, amount_, l2Gas_, data_);
+ }
+
+ /// @inheritdoc IL1ERC20Bridge
+ function depositERC20To(
+ address l1Token_,
+ address l2Token_,
+ address to_,
+ uint256 amount_,
+ uint32 l2Gas_,
+ bytes calldata data_
+ )
+ external
+ whenDepositsEnabled
+ onlyNonZeroAccount(to_)
+ onlySupportedL1Token(l1Token_)
+ onlySupportedL2Token(l2Token_)
+ {
+ _initiateERC20Deposit(msg.sender, to_, amount_, l2Gas_, data_);
+ }
+
+ /// @inheritdoc IL1ERC20Bridge
+ function finalizeERC20Withdrawal(
+ address l1Token_,
+ address l2Token_,
+ address from_,
+ address to_,
+ uint256 amount_,
+ bytes calldata data_
+ )
+ external
+ whenWithdrawalsEnabled
+ onlySupportedL1Token(l1Token_)
+ onlySupportedL2Token(l2Token_)
+ onlyFromCrossDomainAccount(l2TokenBridge)
+ {
+ IERC20(l1Token_).safeTransfer(to_, amount_);
+
+ emit ERC20WithdrawalFinalized(
+ l1Token_,
+ l2Token_,
+ from_,
+ to_,
+ amount_,
+ data_
+ );
+ }
+
+ /// @dev Performs the logic for deposits by informing the L2 token bridge contract
+ /// of the deposit and calling safeTransferFrom to lock the L1 funds.
+ /// @param from_ Account to pull the deposit from on L1
+ /// @param to_ Account to give the deposit to on L2
+ /// @param amount_ Amount of the ERC20 to deposit.
+ /// @param l2Gas_ Gas limit required to complete the deposit on L2.
+ /// @param data_ Optional data to forward to L2. This data is provided
+ /// solely as a convenience for external contracts. Aside from enforcing a maximum
+ /// length, these contracts provide no guarantees about its content.
+ function _initiateERC20Deposit(
+ address from_,
+ address to_,
+ uint256 amount_,
+ uint32 l2Gas_,
+ bytes calldata data_
+ ) internal {
+ IERC20(l1Token).safeTransferFrom(from_, address(this), amount_);
+
+ bytes memory message = abi.encodeWithSelector(
+ IL2ERC20Bridge.finalizeDeposit.selector,
+ l1Token,
+ l2Token,
+ from_,
+ to_,
+ amount_,
+ data_
+ );
+
+ sendCrossDomainMessage(l2TokenBridge, l2Gas_, message);
+
+ emit ERC20DepositInitiated(
+ l1Token,
+ l2Token,
+ from_,
+ to_,
+ amount_,
+ data_
+ );
+ }
+
+ error ErrorSenderNotEOA();
+}