ETH Price: $1,979.14 (+0.13%)

Transaction Decoder

Block:
22412884 at May-04-2025 08:50:23 PM +UTC
Transaction Fee:
0.000030208 ETH $0.06
Gas Used:
30,208 Gas / 1 Gwei

Account State Difference:

  Address   Before After State Difference Code
0x290ca4DA...3d64d4E6A
2.48081588998389591 Eth
Nonce: 139741
2.48078568198389591 Eth
Nonce: 139742
0.000030208
(beaverbuild)
10.375666884654771021 Eth10.375686703058346317 Eth0.000019818403575296

Execution Trace

TransparentUpgradeableProxy.68747470( )
  • L1CustomGateway.68747470( )
    File 1 of 2: TransparentUpgradeableProxy
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    import "./UpgradeableProxy.sol";
    /**
     * @dev This contract implements a proxy that is upgradeable by an admin.
     *
     * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
     * clashing], which can potentially be used in an attack, this contract uses the
     * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
     * things that go hand in hand:
     *
     * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
     * that call matches one of the admin functions exposed by the proxy itself.
     * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
     * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
     * "admin cannot fallback to proxy target".
     *
     * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
     * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
     * to sudden errors when trying to call a function from the proxy implementation.
     *
     * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
     * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
     */
    contract TransparentUpgradeableProxy is UpgradeableProxy {
        /**
         * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
         * optionally initialized with `_data` as explained in {UpgradeableProxy-constructor}.
         */
        constructor(address _logic, address admin_, bytes memory _data) public payable UpgradeableProxy(_logic, _data) {
            assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
            _setAdmin(admin_);
        }
        /**
         * @dev Emitted when the admin account has changed.
         */
        event AdminChanged(address previousAdmin, address newAdmin);
        /**
         * @dev Storage slot with the admin of the contract.
         * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
         * validated in the constructor.
         */
        bytes32 private constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
        /**
         * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
         */
        modifier ifAdmin() {
            if (msg.sender == _admin()) {
                _;
            } else {
                _fallback();
            }
        }
        /**
         * @dev Returns the current admin.
         *
         * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
         *
         * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
         * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
         * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
         */
        function admin() external ifAdmin returns (address admin_) {
            admin_ = _admin();
        }
        /**
         * @dev Returns the current implementation.
         *
         * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
         *
         * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
         * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
         * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
         */
        function implementation() external ifAdmin returns (address implementation_) {
            implementation_ = _implementation();
        }
        /**
         * @dev Changes the admin of the proxy.
         *
         * Emits an {AdminChanged} event.
         *
         * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.
         */
        function changeAdmin(address newAdmin) external virtual ifAdmin {
            require(newAdmin != address(0), "TransparentUpgradeableProxy: new admin is the zero address");
            emit AdminChanged(_admin(), newAdmin);
            _setAdmin(newAdmin);
        }
        /**
         * @dev Upgrade the implementation of the proxy.
         *
         * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
         */
        function upgradeTo(address newImplementation) external virtual ifAdmin {
            _upgradeTo(newImplementation);
        }
        /**
         * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
         * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
         * proxied contract.
         *
         * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
         */
        function upgradeToAndCall(address newImplementation, bytes calldata data) external payable virtual ifAdmin {
            _upgradeTo(newImplementation);
            Address.functionDelegateCall(newImplementation, data);
        }
        /**
         * @dev Returns the current admin.
         */
        function _admin() internal view virtual returns (address adm) {
            bytes32 slot = _ADMIN_SLOT;
            // solhint-disable-next-line no-inline-assembly
            assembly {
                adm := sload(slot)
            }
        }
        /**
         * @dev Stores a new address in the EIP1967 admin slot.
         */
        function _setAdmin(address newAdmin) private {
            bytes32 slot = _ADMIN_SLOT;
            // solhint-disable-next-line no-inline-assembly
            assembly {
                sstore(slot, newAdmin)
            }
        }
        /**
         * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
         */
        function _beforeFallback() internal virtual override {
            require(msg.sender != _admin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
            super._beforeFallback();
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    import "./Proxy.sol";
    import "../utils/Address.sol";
    /**
     * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
     * implementation address that can be changed. This address is stored in storage in the location specified by
     * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
     * implementation behind the proxy.
     *
     * Upgradeability is only provided internally through {_upgradeTo}. For an externally upgradeable proxy see
     * {TransparentUpgradeableProxy}.
     */
    contract UpgradeableProxy is Proxy {
        /**
         * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
         *
         * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
         * function call, and allows initializating the storage of the proxy like a Solidity constructor.
         */
        constructor(address _logic, bytes memory _data) public payable {
            assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
            _setImplementation(_logic);
            if(_data.length > 0) {
                Address.functionDelegateCall(_logic, _data);
            }
        }
        /**
         * @dev Emitted when the implementation is upgraded.
         */
        event Upgraded(address indexed implementation);
        /**
         * @dev Storage slot with the address of the current implementation.
         * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
         * validated in the constructor.
         */
        bytes32 private constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
        /**
         * @dev Returns the current implementation address.
         */
        function _implementation() internal view virtual override returns (address impl) {
            bytes32 slot = _IMPLEMENTATION_SLOT;
            // solhint-disable-next-line no-inline-assembly
            assembly {
                impl := sload(slot)
            }
        }
        /**
         * @dev Upgrades the proxy to a new implementation.
         *
         * Emits an {Upgraded} event.
         */
        function _upgradeTo(address newImplementation) internal virtual {
            _setImplementation(newImplementation);
            emit Upgraded(newImplementation);
        }
        /**
         * @dev Stores a new address in the EIP1967 implementation slot.
         */
        function _setImplementation(address newImplementation) private {
            require(Address.isContract(newImplementation), "UpgradeableProxy: new implementation is not a contract");
            bytes32 slot = _IMPLEMENTATION_SLOT;
            // solhint-disable-next-line no-inline-assembly
            assembly {
                sstore(slot, newImplementation)
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
     * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
     * be specified by overriding the virtual {_implementation} function.
     *
     * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
     * different contract through the {_delegate} function.
     *
     * The success and return data of the delegated call will be returned back to the caller of the proxy.
     */
    abstract contract Proxy {
        /**
         * @dev Delegates the current call to `implementation`.
         *
         * This function does not return to its internall call site, it will return directly to the external caller.
         */
        function _delegate(address implementation) internal virtual {
            // solhint-disable-next-line no-inline-assembly
            assembly {
                // Copy msg.data. We take full control of memory in this inline assembly
                // block because it will not return to Solidity code. We overwrite the
                // Solidity scratch pad at memory position 0.
                calldatacopy(0, 0, calldatasize())
                // Call the implementation.
                // out and outsize are 0 because we don't know the size yet.
                let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                // Copy the returned data.
                returndatacopy(0, 0, returndatasize())
                switch result
                // delegatecall returns 0 on error.
                case 0 { revert(0, returndatasize()) }
                default { return(0, returndatasize()) }
            }
        }
        /**
         * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function
         * and {_fallback} should delegate.
         */
        function _implementation() internal view virtual returns (address);
        /**
         * @dev Delegates the current call to the address returned by `_implementation()`.
         *
         * This function does not return to its internall call site, it will return directly to the external caller.
         */
        function _fallback() internal virtual {
            _beforeFallback();
            _delegate(_implementation());
        }
        /**
         * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
         * function in the contract matches the call data.
         */
        fallback () external payable virtual {
            _fallback();
        }
        /**
         * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
         * is empty.
         */
        receive () external payable virtual {
            _fallback();
        }
        /**
         * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
         * call, or as part of the Solidity `fallback` or `receive` functions.
         *
         * If overriden should call `super._beforeFallback()`.
         */
        function _beforeFallback() internal virtual {
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.2 <0.8.0;
    /**
     * @dev Collection of functions related to the address type
     */
    library Address {
        /**
         * @dev Returns true if `account` is a contract.
         *
         * [IMPORTANT]
         * ====
         * It is unsafe to assume that an address for which this function returns
         * false is an externally-owned account (EOA) and not a contract.
         *
         * Among others, `isContract` will return false for the following
         * types of addresses:
         *
         *  - an externally-owned account
         *  - a contract in construction
         *  - an address where a contract will be created
         *  - an address where a contract lived, but was destroyed
         * ====
         */
        function isContract(address account) internal view returns (bool) {
            // This method relies on extcodesize, which returns 0 for contracts in
            // construction, since the code is only stored at the end of the
            // constructor execution.
            uint256 size;
            // solhint-disable-next-line no-inline-assembly
            assembly { size := extcodesize(account) }
            return size > 0;
        }
        /**
         * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
         * `recipient`, forwarding all available gas and reverting on errors.
         *
         * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
         * of certain opcodes, possibly making contracts go over the 2300 gas limit
         * imposed by `transfer`, making them unable to receive funds via
         * `transfer`. {sendValue} removes this limitation.
         *
         * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
         *
         * IMPORTANT: because control is transferred to `recipient`, care must be
         * taken to not create reentrancy vulnerabilities. Consider using
         * {ReentrancyGuard} or the
         * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            require(address(this).balance >= amount, "Address: insufficient balance");
            // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
            (bool success, ) = recipient.call{ value: amount }("");
            require(success, "Address: unable to send value, recipient may have reverted");
        }
        /**
         * @dev Performs a Solidity function call using a low level `call`. A
         * plain`call` is an unsafe replacement for a function call: use this
         * function instead.
         *
         * If `target` reverts with a revert reason, it is bubbled up by this
         * function (like regular Solidity function calls).
         *
         * Returns the raw returned data. To convert to the expected return value,
         * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
         *
         * Requirements:
         *
         * - `target` must be a contract.
         * - calling `target` with `data` must not revert.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data) internal returns (bytes memory) {
          return functionCall(target, data, "Address: low-level call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
         * `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
            return functionCallWithValue(target, data, 0, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but also transferring `value` wei to `target`.
         *
         * Requirements:
         *
         * - the calling contract must have an ETH balance of at least `value`.
         * - the called Solidity function must be `payable`.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
            return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
        }
        /**
         * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
         * with `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
            require(address(this).balance >= value, "Address: insufficient balance for call");
            require(isContract(target), "Address: call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.call{ value: value }(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
            return functionStaticCall(target, data, "Address: low-level static call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
            require(isContract(target), "Address: static call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.staticcall(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a delegate call.
         *
         * _Available since v3.4._
         */
        function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
            return functionDelegateCall(target, data, "Address: low-level delegate call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a delegate call.
         *
         * _Available since v3.4._
         */
        function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
            require(isContract(target), "Address: delegate call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.delegatecall(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
            if (success) {
                return returndata;
            } else {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
    }
    

    File 2 of 2: L1CustomGateway
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import { ArbitrumEnabledToken } from "../ICustomToken.sol";
    import "./L1ArbitrumExtendedGateway.sol";
    import "../../arbitrum/gateway/L2CustomGateway.sol";
    import "../../libraries/gateway/ICustomGateway.sol";
    import "@openzeppelin/contracts/utils/Address.sol";
    import "arb-bridge-eth/contracts/libraries/Whitelist.sol";
    /**
     * @title Gatway for "custom" bridging functionality
     * @notice Handles some (but not all!) custom Gateway needs.
     */
    contract L1CustomGateway is L1ArbitrumExtendedGateway, ICustomGateway {
        using Address for address;
        // stores addresses of L2 tokens to be used
        mapping(address => address) public override l1ToL2Token;
        // owner is able to force add custom mappings
        address public owner;
        // whitelist not used anymore
        address public whitelist;
        // start of inline reentrancy guard
        // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/v3.4.2/contracts/utils/ReentrancyGuard.sol
        uint256 private constant _NOT_ENTERED = 1;
        uint256 private constant _ENTERED = 2;
        uint256 private _status;
        modifier nonReentrant() {
            // On the first call to nonReentrant, _notEntered will be true
            require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
            // Any calls to nonReentrant after this point will fail
            _status = _ENTERED;
            _;
            _status = _NOT_ENTERED;
        }
        modifier onlyOwner() {
            require(msg.sender == owner, "ONLY_OWNER");
            _;
        }
        function outboundTransferCustomRefund(
            address _l1Token,
            address _refundTo,
            address _to,
            uint256 _amount,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes calldata _data
        ) public payable override nonReentrant returns (bytes memory res) {
            return
                super.outboundTransferCustomRefund(
                    _l1Token,
                    _refundTo,
                    _to,
                    _amount,
                    _maxGas,
                    _gasPriceBid,
                    _data
                );
        }
        function finalizeInboundTransfer(
            address _token,
            address _from,
            address _to,
            uint256 _amount,
            bytes calldata _data
        ) public payable override nonReentrant {
            // the superclass checks onlyCounterpartGateway
            super.finalizeInboundTransfer(_token, _from, _to, _amount, _data);
        }
        function initialize(
            address _l1Counterpart,
            address _l1Router,
            address _inbox,
            address _owner
        ) public {
            L1ArbitrumGateway._initialize(_l1Counterpart, _l1Router, _inbox);
            owner = _owner;
            // disable whitelist by default
            whitelist = address(0);
            // reentrancy guard
            _status = _NOT_ENTERED;
        }
        /**
         * @notice Calculate the address used when bridging an ERC20 token
         * @dev the L1 and L2 address oracles may not always be in sync.
         * For example, a custom token may have been registered but not deploy or the contract self destructed.
         * @param l1ERC20 address of L1 token
         * @return L2 address of a bridged ERC20 token
         */
        function calculateL2TokenAddress(address l1ERC20) public view override returns (address) {
            return l1ToL2Token[l1ERC20];
        }
        /**
         * @notice Allows L1 Token contract to trustlessly register its custom L2 counterpart. (other registerTokenToL2 method allows excess eth recovery from _maxSubmissionCost and is recommended)
         * @param _l2Address counterpart address of L1 token
         * @param _maxGas max gas for L2 retryable exrecution
         * @param _gasPriceBid gas price for L2 retryable ticket
         * @param  _maxSubmissionCost base submission cost  L2 retryable tick3et
         * @return Retryable ticket ID
         */
        function registerTokenToL2(
            address _l2Address,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            uint256 _maxSubmissionCost
        ) external payable returns (uint256) {
            return registerTokenToL2(_l2Address, _maxGas, _gasPriceBid, _maxSubmissionCost, msg.sender);
        }
        /**
         * @notice Allows L1 Token contract to trustlessly register its custom L2 counterpart.
         * param _l2Address counterpart address of L1 token
         * param _maxGas max gas for L2 retryable exrecution
         * param _gasPriceBid gas price for L2 retryable ticket
         * param  _maxSubmissionCost base submission cost  L2 retryable tick3et
         * param _creditBackAddress address for crediting back overpayment of _maxSubmissionCost
         * return Retryable ticket ID
         */
        function registerTokenToL2(
            address _l2Address,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            uint256 _maxSubmissionCost,
            address _creditBackAddress
        ) public payable returns (uint256) {
            require(
                ArbitrumEnabledToken(msg.sender).isArbitrumEnabled() == uint8(0xa4b1),
                "NOT_ARB_ENABLED"
            );
            address currL2Addr = l1ToL2Token[msg.sender];
            if (currL2Addr != address(0)) {
                // if token is already set, don't allow it to set a different L2 address
                require(currL2Addr == _l2Address, "NO_UPDATE_TO_DIFFERENT_ADDR");
            }
            l1ToL2Token[msg.sender] = _l2Address;
            address[] memory l1Addresses = new address[](1);
            address[] memory l2Addresses = new address[](1);
            l1Addresses[0] = msg.sender;
            l2Addresses[0] = _l2Address;
            emit TokenSet(l1Addresses[0], l2Addresses[0]);
            bytes memory _data = abi.encodeWithSelector(
                L2CustomGateway.registerTokenFromL1.selector,
                l1Addresses,
                l2Addresses
            );
            return
                sendTxToL2(
                    inbox,
                    counterpartGateway,
                    _creditBackAddress,
                    msg.value,
                    0,
                    _maxSubmissionCost,
                    _maxGas,
                    _gasPriceBid,
                    _data
                );
        }
        function setOwner(address newOwner) external onlyOwner {
            require(newOwner != address(0), "INVALID_OWNER");
            owner = newOwner;
        }
        /**
         * @notice Allows owner to force register a custom L1/L2 token pair.
         * @dev _l1Addresses[i] counterpart is assumed to be _l2Addresses[i]
         * @param _l1Addresses array of L1 addresses
         * @param _l2Addresses array of L2 addresses
         * @param _maxGas max gas for L2 retryable exrecution
         * @param _gasPriceBid gas price for L2 retryable ticket
         * @param  _maxSubmissionCost base submission cost  L2 retryable tick3et
         * @return Retryable ticket ID
         */
        function forceRegisterTokenToL2(
            address[] calldata _l1Addresses,
            address[] calldata _l2Addresses,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            uint256 _maxSubmissionCost
        ) external payable onlyOwner returns (uint256) {
            require(_l1Addresses.length == _l2Addresses.length, "INVALID_LENGTHS");
            for (uint256 i = 0; i < _l1Addresses.length; i++) {
                // here we assume the owner checked both addresses offchain before force registering
                // require(address(_l1Addresses[i]).isContract(), "MUST_BE_CONTRACT");
                l1ToL2Token[_l1Addresses[i]] = _l2Addresses[i];
                emit TokenSet(_l1Addresses[i], _l2Addresses[i]);
            }
            bytes memory _data = abi.encodeWithSelector(
                L2CustomGateway.registerTokenFromL1.selector,
                _l1Addresses,
                _l2Addresses
            );
            return
                sendTxToL2(
                    inbox,
                    counterpartGateway,
                    msg.sender,
                    msg.value,
                    0,
                    _maxSubmissionCost,
                    _maxGas,
                    _gasPriceBid,
                    _data
                );
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    interface ArbitrumEnabledToken {
        /// @notice should return `0xa4b1` if token is enabled for arbitrum gateways
        function isArbitrumEnabled() external view returns (uint8);
    }
    /**
     * @title Minimum expected interface for L1 custom token (see TestCustomTokenL1.sol for an example implementation)
     */
    interface ICustomToken is ArbitrumEnabledToken {
        /**
         * @notice Should make an external call to EthERC20Bridge.registerCustomL2Token
         */
        function registerTokenOnL2(
            address l2CustomTokenAddress,
            uint256 maxSubmissionCostForCustomBridge,
            uint256 maxSubmissionCostForRouter,
            uint256 maxGasForCustomBridge,
            uint256 maxGasForRouter,
            uint256 gasPriceBid,
            uint256 valueForGateway,
            uint256 valueForRouter,
            address creditBackAddress
        ) external payable;
        function transferFrom(
            address sender,
            address recipient,
            uint256 amount
        ) external returns (bool);
        function balanceOf(address account) external view returns (uint256);
    }
    interface L1MintableToken is ICustomToken {
        function bridgeMint(address account, uint256 amount) external;
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "../../libraries/ITransferAndCall.sol";
    import "./L1ArbitrumGateway.sol";
    interface ITradeableExitReceiver {
        function onExitTransfer(
            address sender,
            uint256 exitNum,
            bytes calldata data
        ) external returns (bool);
    }
    abstract contract L1ArbitrumExtendedGateway is L1ArbitrumGateway {
        struct ExitData {
            bool isExit;
            address _newTo;
            bytes _newData;
        }
        mapping(bytes32 => ExitData) public redirectedExits;
        event WithdrawRedirected(
            address indexed from,
            address indexed to,
            uint256 indexed exitNum,
            bytes newData,
            bytes data,
            bool madeExternalCall
        );
        /**
         * @notice Allows a user to redirect their right to claim a withdrawal to another address.
         * @dev This method also allows you to make an arbitrary call after the transfer.
         * This does not validate if the exit was already triggered. It is assumed the `_exitNum` is
         * validated off-chain to ensure this was not yet triggered.
         * @param _exitNum Sequentially increasing exit counter determined by the L2 bridge
         * @param _initialDestination address the L2 withdrawal call initially set as the destination.
         * @param _newDestination address the L1 will now call instead of the previously set destination
         * @param _newData data to be used in inboundEscrowAndCall
         * @param _data optional data for external call upon transfering the exit
         */
        function transferExitAndCall(
            uint256 _exitNum,
            address _initialDestination,
            address _newDestination,
            bytes calldata _newData,
            bytes calldata _data
        ) external {
            // the initial data doesn't make a difference when transfering you exit
            // since the L2 bridge gives a unique exit ID to each exit
            (address expectedSender, ) = getExternalCall(_exitNum, _initialDestination, "");
            // if you want to transfer your exit, you must be the current destination
            require(msg.sender == expectedSender, "NOT_EXPECTED_SENDER");
            // the inboundEscrowAndCall functionality has been disabled, so no data is allowed
            require(_newData.length == 0, "NO_DATA_ALLOWED");
            setRedirectedExit(_exitNum, _initialDestination, _newDestination, _newData);
            if (_data.length > 0) {
                require(_newDestination.isContract(), "TO_NOT_CONTRACT");
                bool success = ITradeableExitReceiver(_newDestination).onExitTransfer(
                    expectedSender,
                    _exitNum,
                    _data
                );
                require(success, "TRANSFER_HOOK_FAIL");
            }
            emit WithdrawRedirected(
                expectedSender,
                _newDestination,
                _exitNum,
                _newData,
                _data,
                _data.length > 0
            );
        }
        /// @notice this does not verify if the external call was already done
        function getExternalCall(
            uint256 _exitNum,
            address _initialDestination,
            bytes memory _initialData
        ) public view virtual override returns (address target, bytes memory data) {
            // this function is virtual so that subclasses can override it with custom logic where necessary
            bytes32 withdrawData = encodeWithdrawal(_exitNum, _initialDestination);
            ExitData storage exit = redirectedExits[withdrawData];
            // here we don't authenticate `_initialData`. we could hash it into `withdrawData` but would increase gas costs
            // this is safe because if the exit isn't overriden, the _initialData coming from L2 is trusted
            // but if the exit is traded, all we care about is the latest user calldata
            if (exit.isExit) {
                return (exit._newTo, exit._newData);
            } else {
                return (_initialDestination, _initialData);
            }
        }
        function setRedirectedExit(
            uint256 _exitNum,
            address _initialDestination,
            address _newDestination,
            bytes memory _newData
        ) internal {
            bytes32 withdrawData = encodeWithdrawal(_exitNum, _initialDestination);
            redirectedExits[withdrawData] = ExitData(true, _newDestination, _newData);
        }
        function encodeWithdrawal(uint256 _exitNum, address _initialDestination)
            public
            pure
            returns (bytes32)
        {
            // here we assume the L2 bridge gives a unique exitNum to each exit
            return keccak256(abi.encode(_exitNum, _initialDestination));
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "./L2ArbitrumGateway.sol";
    import "../../libraries/gateway/ICustomGateway.sol";
    import "@openzeppelin/contracts/math/SafeMath.sol";
    import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
    contract L2CustomGateway is L2ArbitrumGateway, ICustomGateway {
        // stores addresses of L2 tokens to be used
        mapping(address => address) public override l1ToL2Token;
        function initialize(address _l1Counterpart, address _router) public {
            L2ArbitrumGateway._initialize(_l1Counterpart, _router);
        }
        /**
         * @notice internal utility function used to handle when no contract is deployed at expected address
         */
        function handleNoContract(
            address _l1Token,
            address, /* expectedL2Address */
            address _from,
            address, /* _to */
            uint256 _amount,
            bytes memory /* gatewayData */
        ) internal override returns (bool shouldHalt) {
            // it is assumed that the custom token is deployed in the L2 before deposits are made
            // trigger withdrawal
            // we don't need the return value from triggerWithdrawal since this is forcing a withdrawal back to the L1
            // instead of composing with a L2 dapp
            triggerWithdrawal(_l1Token, address(this), _from, _amount, "");
            return true;
        }
        function outboundEscrowTransfer(
            address _l2Token,
            address _from,
            uint256 _amount
        ) internal override returns (uint256 amountBurnt) {
            uint256 prevBalance = IERC20(_l2Token).balanceOf(_from);
            // in the custom gateway, we do the same behaviour as the superclass, but actually check
            // for the balances of tokens to ensure that inflationary / deflationary changes in the amount
            // are taken into account
            // we ignore the return value since we actually query the token before and after to calculate
            // the amount of tokens that were burnt
            super.outboundEscrowTransfer(_l2Token, _from, _amount);
            uint256 postBalance = IERC20(_l2Token).balanceOf(_from);
            return SafeMath.sub(prevBalance, postBalance);
        }
        /**
         * @notice Calculate the address used when bridging an ERC20 token
         * @dev the L1 and L2 address oracles may not always be in sync.
         * For example, a custom token may have been registered but not deploy or the contract self destructed.
         * @param l1ERC20 address of L1 token
         * @return L2 address of a bridged ERC20 token
         */
        function calculateL2TokenAddress(address l1ERC20) public view override returns (address) {
            return l1ToL2Token[l1ERC20];
        }
        function registerTokenFromL1(address[] calldata l1Address, address[] calldata l2Address)
            external
            onlyCounterpartGateway
        {
            // we assume both arrays are the same length, safe since its encoded by the L1
            for (uint256 i = 0; i < l1Address.length; i++) {
                // here we don't check if l2Address is a contract and instead deal with that behaviour
                // in `handleNoContract` this way we keep the l1 and l2 address oracles in sync
                l1ToL2Token[l1Address[i]] = l2Address[i];
                emit TokenSet(l1Address[i], l2Address[i]);
            }
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    // import "./ITokenGateway.sol";
    interface ICustomGateway {
        function l1ToL2Token(address _l1Token) external view returns (address _l2Token);
        event TokenSet(address indexed l1Address, address indexed l2Address);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.2 <0.8.0;
    /**
     * @dev Collection of functions related to the address type
     */
    library Address {
        /**
         * @dev Returns true if `account` is a contract.
         *
         * [IMPORTANT]
         * ====
         * It is unsafe to assume that an address for which this function returns
         * false is an externally-owned account (EOA) and not a contract.
         *
         * Among others, `isContract` will return false for the following
         * types of addresses:
         *
         *  - an externally-owned account
         *  - a contract in construction
         *  - an address where a contract will be created
         *  - an address where a contract lived, but was destroyed
         * ====
         */
        function isContract(address account) internal view returns (bool) {
            // This method relies on extcodesize, which returns 0 for contracts in
            // construction, since the code is only stored at the end of the
            // constructor execution.
            uint256 size;
            // solhint-disable-next-line no-inline-assembly
            assembly { size := extcodesize(account) }
            return size > 0;
        }
        /**
         * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
         * `recipient`, forwarding all available gas and reverting on errors.
         *
         * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
         * of certain opcodes, possibly making contracts go over the 2300 gas limit
         * imposed by `transfer`, making them unable to receive funds via
         * `transfer`. {sendValue} removes this limitation.
         *
         * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
         *
         * IMPORTANT: because control is transferred to `recipient`, care must be
         * taken to not create reentrancy vulnerabilities. Consider using
         * {ReentrancyGuard} or the
         * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            require(address(this).balance >= amount, "Address: insufficient balance");
            // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
            (bool success, ) = recipient.call{ value: amount }("");
            require(success, "Address: unable to send value, recipient may have reverted");
        }
        /**
         * @dev Performs a Solidity function call using a low level `call`. A
         * plain`call` is an unsafe replacement for a function call: use this
         * function instead.
         *
         * If `target` reverts with a revert reason, it is bubbled up by this
         * function (like regular Solidity function calls).
         *
         * Returns the raw returned data. To convert to the expected return value,
         * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
         *
         * Requirements:
         *
         * - `target` must be a contract.
         * - calling `target` with `data` must not revert.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data) internal returns (bytes memory) {
          return functionCall(target, data, "Address: low-level call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
         * `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
            return functionCallWithValue(target, data, 0, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but also transferring `value` wei to `target`.
         *
         * Requirements:
         *
         * - the calling contract must have an ETH balance of at least `value`.
         * - the called Solidity function must be `payable`.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
            return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
        }
        /**
         * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
         * with `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
            require(address(this).balance >= value, "Address: insufficient balance for call");
            require(isContract(target), "Address: call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.call{ value: value }(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
            return functionStaticCall(target, data, "Address: low-level static call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
            require(isContract(target), "Address: static call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.staticcall(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a delegate call.
         *
         * _Available since v3.4._
         */
        function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
            return functionDelegateCall(target, data, "Address: low-level delegate call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a delegate call.
         *
         * _Available since v3.4._
         */
        function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
            require(isContract(target), "Address: delegate call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.delegatecall(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
            if (success) {
                return returndata;
            } else {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    abstract contract WhitelistConsumer {
        address public whitelist;
        event WhitelistSourceUpdated(address newSource);
        modifier onlyWhitelisted() {
            if (whitelist != address(0)) {
                require(Whitelist(whitelist).isAllowed(msg.sender), "NOT_WHITELISTED");
            }
            _;
        }
        function updateWhitelistSource(address newSource) external {
            require(msg.sender == whitelist, "NOT_FROM_LIST");
            whitelist = newSource;
            emit WhitelistSourceUpdated(newSource);
        }
    }
    contract Whitelist {
        address public owner;
        mapping(address => bool) public isAllowed;
        event OwnerUpdated(address newOwner);
        event WhitelistUpgraded(address newWhitelist, address[] targets);
        constructor() public {
            owner = msg.sender;
        }
        modifier onlyOwner() {
            require(msg.sender == owner, "ONLY_OWNER");
            _;
        }
        function setOwner(address newOwner) external onlyOwner {
            owner = newOwner;
            emit OwnerUpdated(newOwner);
        }
        function setWhitelist(address[] memory user, bool[] memory val) external onlyOwner {
            require(user.length == val.length, "INVALID_INPUT");
            for (uint256 i = 0; i < user.length; i++) {
                isAllowed[user[i]] = val[i];
            }
        }
        // set new whitelist to address(0) to disable whitelist
        function triggerConsumers(address newWhitelist, address[] memory targets) external onlyOwner {
            for (uint256 i = 0; i < targets.length; i++) {
                WhitelistConsumer(targets[i]).updateWhitelistSource(newWhitelist);
            }
            emit WhitelistUpgraded(newWhitelist, targets);
        }
    }
    // SPDX-License-Identifier: MIT
    // solhint-disable-next-line compiler-version
    pragma solidity >0.6.0 <0.8.0;
    import "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol";
    interface ITransferAndCall is IERC20Upgradeable {
        function transferAndCall(
            address to,
            uint256 value,
            bytes memory data
        ) external returns (bool success);
        event Transfer(address indexed from, address indexed to, uint256 value, bytes data);
    }
    /**
     * @notice note that implementation of ITransferAndCallReceiver is not expected to return a success bool
     */
    interface ITransferAndCallReceiver {
        function onTokenTransfer(
            address _sender,
            uint256 _value,
            bytes memory _data
        ) external;
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
    import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
    import "@openzeppelin/contracts/utils/Create2.sol";
    import "@openzeppelin/contracts/utils/Address.sol";
    import "@openzeppelin/contracts/math/SafeMath.sol";
    import "arb-bridge-eth/contracts/bridge/interfaces/IInbox.sol";
    import "arb-bridge-eth/contracts/libraries/ProxyUtil.sol";
    import "../L1ArbitrumMessenger.sol";
    import "../../libraries/gateway/GatewayMessageHandler.sol";
    import "../../libraries/gateway/TokenGateway.sol";
    import "./IL1ArbitrumGateway.sol";
    import "../../libraries/ITransferAndCall.sol";
    import "../../libraries/ERC165.sol";
    /**
     * @title Common interface for gatways on L1 messaging to Arbitrum.
     */
    abstract contract L1ArbitrumGateway is
        L1ArbitrumMessenger,
        TokenGateway,
        ERC165,
        IL1ArbitrumGateway
    {
        using SafeERC20 for IERC20;
        using Address for address;
        address public override inbox;
        event DepositInitiated(
            address l1Token,
            address indexed _from,
            address indexed _to,
            uint256 indexed _sequenceNumber,
            uint256 _amount
        );
        event WithdrawalFinalized(
            address l1Token,
            address indexed _from,
            address indexed _to,
            uint256 indexed _exitNum,
            uint256 _amount
        );
        modifier onlyCounterpartGateway() override {
            address _inbox = inbox;
            // a message coming from the counterpart gateway was executed by the bridge
            address bridge = address(super.getBridge(_inbox));
            require(msg.sender == bridge, "NOT_FROM_BRIDGE");
            // and the outbox reports that the L2 address of the sender is the counterpart gateway
            address l2ToL1Sender = super.getL2ToL1Sender(_inbox);
            require(l2ToL1Sender == counterpartGateway, "ONLY_COUNTERPART_GATEWAY");
            _;
        }
        function postUpgradeInit() external {
            // it is assumed the L1 Arbitrum Gateway contract is behind a Proxy controlled by a proxy admin
            // this function can only be called by the proxy admin contract
            address proxyAdmin = ProxyUtil.getProxyAdmin();
            require(msg.sender == proxyAdmin, "NOT_FROM_ADMIN");
            // this has no other logic since the current upgrade doesn't require this logic
        }
        function _initialize(
            address _l2Counterpart,
            address _router,
            address _inbox
        ) internal {
            TokenGateway._initialize(_l2Counterpart, _router);
            // L1 gateway must have a router
            require(_router != address(0), "BAD_ROUTER");
            require(_inbox != address(0), "BAD_INBOX");
            inbox = _inbox;
        }
        /**
         * @notice Finalizes a withdrawal via Outbox message; callable only by L2Gateway.outboundTransfer
         * @param _token L1 address of token being withdrawn from
         * @param _from initiator of withdrawal
         * @param _to address the L2 withdrawal call set as the destination.
         * @param _amount Token amount being withdrawn
         * @param _data encoded exitNum (Sequentially increasing exit counter determined by the L2Gateway) and additinal hook data
         */
        function finalizeInboundTransfer(
            address _token,
            address _from,
            address _to,
            uint256 _amount,
            bytes calldata _data
        ) public payable virtual override onlyCounterpartGateway {
            // this function is marked as virtual so superclasses can override it to add modifiers
            (uint256 exitNum, bytes memory callHookData) = GatewayMessageHandler.parseToL1GatewayMsg(
                _data
            );
            if (callHookData.length != 0) {
                // callHookData should always be 0 since inboundEscrowAndCall is disabled
                callHookData = bytes("");
            }
            // we ignore the returned data since the callHook feature is now disabled
            (_to, ) = getExternalCall(exitNum, _to, callHookData);
            inboundEscrowTransfer(_token, _to, _amount);
            emit WithdrawalFinalized(_token, _from, _to, exitNum, _amount);
        }
        function getExternalCall(
            uint256, /* _exitNum */
            address _initialDestination,
            bytes memory _initialData
        ) public view virtual returns (address target, bytes memory data) {
            // this method is virtual so the destination of a call can be changed
            // using tradeable exits in a subclass (L1ArbitrumExtendedGateway)
            target = _initialDestination;
            data = _initialData;
        }
        function inboundEscrowTransfer(
            address _l1Token,
            address _dest,
            uint256 _amount
        ) internal virtual {
            // this method is virtual since different subclasses can handle escrow differently
            IERC20(_l1Token).safeTransfer(_dest, _amount);
        }
        /**
         * @dev Only excess gas is refunded to the _refundTo account, l2 call value is always returned to the _to account
         */
        function createOutboundTxCustomRefund(
            address _refundTo,
            address _from,
            uint256, /* _tokenAmount */
            uint256 _maxGas,
            uint256 _gasPriceBid,
            uint256 _maxSubmissionCost,
            bytes memory _outboundCalldata
        ) internal virtual returns (uint256) {
            // We make this function virtual since outboundTransfer logic is the same for many gateways
            // but sometimes (ie weth) you construct the outgoing message differently.
            // msg.value is sent, but 0 is set to the L2 call value
            // the eth sent is used to pay for the tx's gas
            return
                sendTxToL2CustomRefund(
                    inbox,
                    counterpartGateway,
                    _refundTo,
                    _from,
                    msg.value, // we forward the L1 call value to the inbox
                    0, // l2 call value 0 by default
                    L2GasParams({
                        _maxSubmissionCost: _maxSubmissionCost,
                        _maxGas: _maxGas,
                        _gasPriceBid: _gasPriceBid
                    }),
                    _outboundCalldata
                );
        }
        /**
         * @notice DEPRECATED - look at createOutboundTxCustomRefund instead
         */
        function createOutboundTx(
            address _from,
            uint256 _tokenAmount,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            uint256 _maxSubmissionCost,
            bytes memory _outboundCalldata
        ) internal returns (uint256) {
            return
                createOutboundTxCustomRefund(
                    _from,
                    _from,
                    _tokenAmount,
                    _maxGas,
                    _gasPriceBid,
                    _maxSubmissionCost,
                    _outboundCalldata
                );
        }
        /**
         * @notice DEPRECATED - look at outboundTransferCustomRefund instead
         */
        function outboundTransfer(
            address _l1Token,
            address _to,
            uint256 _amount,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes calldata _data
        ) public payable override returns (bytes memory res) {
            return
                outboundTransferCustomRefund(_l1Token, _to, _to, _amount, _maxGas, _gasPriceBid, _data);
        }
        /**
         * @notice Deposit ERC20 token from Ethereum into Arbitrum. If L2 side hasn't been deployed yet, includes name/symbol/decimals data for initial L2 deploy. Initiate by GatewayRouter.
         * @dev L2 address alias will not be applied to the following types of addresses on L1:
         *      - an externally-owned account
         *      - a contract in construction
         *      - an address where a contract will be created
         *      - an address where a contract lived, but was destroyed
         * @param _l1Token L1 address of ERC20
         * @param _refundTo Account, or its L2 alias if it have code in L1, to be credited with excess gas refund in L2
         * @param _to Account to be credited with the tokens in the L2 (can be the user's L2 account or a contract), not subject to L2 aliasing
                      This account, or its L2 alias if it have code in L1, will also be able to cancel the retryable ticket and receive callvalue refund
         * @param _amount Token Amount
         * @param _maxGas Max gas deducted from user's L2 balance to cover L2 execution
         * @param _gasPriceBid Gas price for L2 execution
         * @param _data encoded data from router and user
         * @return res abi encoded inbox sequence number
         */
        //  * @param maxSubmissionCost Max gas deducted from user's L2 balance to cover base submission fee
        function outboundTransferCustomRefund(
            address _l1Token,
            address _refundTo,
            address _to,
            uint256 _amount,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes calldata _data
        ) public payable virtual override returns (bytes memory res) {
            require(isRouter(msg.sender), "NOT_FROM_ROUTER");
            // This function is set as public and virtual so that subclasses can override
            // it and add custom validation for callers (ie only whitelisted users)
            address _from;
            uint256 seqNum;
            bytes memory extraData;
            {
                uint256 _maxSubmissionCost;
                if (super.isRouter(msg.sender)) {
                    // router encoded
                    (_from, extraData) = GatewayMessageHandler.parseFromRouterToGateway(_data);
                } else {
                    _from = msg.sender;
                    extraData = _data;
                }
                // user encoded
                (_maxSubmissionCost, extraData) = abi.decode(extraData, (uint256, bytes));
                // the inboundEscrowAndCall functionality has been disabled, so no data is allowed
                require(extraData.length == 0, "EXTRA_DATA_DISABLED");
                require(_l1Token.isContract(), "L1_NOT_CONTRACT");
                address l2Token = calculateL2TokenAddress(_l1Token);
                require(l2Token != address(0), "NO_L2_TOKEN_SET");
                _amount = outboundEscrowTransfer(_l1Token, _from, _amount);
                // we override the res field to save on the stack
                res = getOutboundCalldata(_l1Token, _from, _to, _amount, extraData);
                seqNum = createOutboundTxCustomRefund(
                    _refundTo,
                    _from,
                    _amount,
                    _maxGas,
                    _gasPriceBid,
                    _maxSubmissionCost,
                    res
                );
            }
            emit DepositInitiated(_l1Token, _from, _to, seqNum, _amount);
            return abi.encode(seqNum);
        }
        function outboundEscrowTransfer(
            address _l1Token,
            address _from,
            uint256 _amount
        ) internal virtual returns (uint256 amountReceived) {
            // this method is virtual since different subclasses can handle escrow differently
            // user funds are escrowed on the gateway using this function
            uint256 prevBalance = IERC20(_l1Token).balanceOf(address(this));
            IERC20(_l1Token).safeTransferFrom(_from, address(this), _amount);
            uint256 postBalance = IERC20(_l1Token).balanceOf(address(this));
            return SafeMath.sub(postBalance, prevBalance);
        }
        function getOutboundCalldata(
            address _l1Token,
            address _from,
            address _to,
            uint256 _amount,
            bytes memory _data
        ) public view virtual override returns (bytes memory outboundCalldata) {
            // this function is public so users can query how much calldata will be sent to the L2
            // before execution
            // it is virtual since different gateway subclasses can build this calldata differently
            // ( ie the standard ERC20 gateway queries for a tokens name/symbol/decimals )
            bytes memory emptyBytes = "";
            outboundCalldata = abi.encodeWithSelector(
                ITokenGateway.finalizeInboundTransfer.selector,
                _l1Token,
                _from,
                _to,
                _amount,
                GatewayMessageHandler.encodeToL2GatewayMsg(emptyBytes, _data)
            );
            return outboundCalldata;
        }
        function supportsInterface(bytes4 interfaceId)
            public
            view
            virtual
            override(ERC165, IERC165)
            returns (bool)
        {
            // registering interfaces that is added after arb-bridge-peripherals >1.0.11
            // using function selector instead of single function interfaces to reduce bloat
            return
                interfaceId == this.outboundTransferCustomRefund.selector ||
                super.supportsInterface(interfaceId);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev Interface of the ERC20 standard as defined in the EIP.
     */
    interface IERC20Upgradeable {
        /**
         * @dev Returns the amount of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the amount of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves `amount` tokens from the caller's account to `recipient`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address recipient, uint256 amount) external returns (bool);
        /**
         * @dev Returns the remaining number of tokens that `spender` will be
         * allowed to spend on behalf of `owner` through {transferFrom}. This is
         * zero by default.
         *
         * This value changes when {approve} or {transferFrom} are called.
         */
        function allowance(address owner, address spender) external view returns (uint256);
        /**
         * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * IMPORTANT: Beware that changing an allowance with this method brings the risk
         * that someone may use both the old and the new allowance by unfortunate
         * transaction ordering. One possible solution to mitigate this race
         * condition is to first reduce the spender's allowance to 0 and set the
         * desired value afterwards:
         * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
         *
         * Emits an {Approval} event.
         */
        function approve(address spender, uint256 amount) external returns (bool);
        /**
         * @dev Moves `amount` tokens from `sender` to `recipient` using the
         * allowance mechanism. `amount` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    import "../../utils/Context.sol";
    import "./IERC20.sol";
    import "../../math/SafeMath.sol";
    /**
     * @dev Implementation of the {IERC20} interface.
     *
     * This implementation is agnostic to the way tokens are created. This means
     * that a supply mechanism has to be added in a derived contract using {_mint}.
     * For a generic mechanism see {ERC20PresetMinterPauser}.
     *
     * TIP: For a detailed writeup see our guide
     * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
     * to implement supply mechanisms].
     *
     * We have followed general OpenZeppelin guidelines: functions revert instead
     * of returning `false` on failure. This behavior is nonetheless conventional
     * and does not conflict with the expectations of ERC20 applications.
     *
     * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
     * This allows applications to reconstruct the allowance for all accounts just
     * by listening to said events. Other implementations of the EIP may not emit
     * these events, as it isn't required by the specification.
     *
     * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
     * functions have been added to mitigate the well-known issues around setting
     * allowances. See {IERC20-approve}.
     */
    contract ERC20 is Context, IERC20 {
        using SafeMath for uint256;
        mapping (address => uint256) private _balances;
        mapping (address => mapping (address => uint256)) private _allowances;
        uint256 private _totalSupply;
        string private _name;
        string private _symbol;
        uint8 private _decimals;
        /**
         * @dev Sets the values for {name} and {symbol}, initializes {decimals} with
         * a default value of 18.
         *
         * To select a different value for {decimals}, use {_setupDecimals}.
         *
         * All three of these values are immutable: they can only be set once during
         * construction.
         */
        constructor (string memory name_, string memory symbol_) public {
            _name = name_;
            _symbol = symbol_;
            _decimals = 18;
        }
        /**
         * @dev Returns the name of the token.
         */
        function name() public view virtual returns (string memory) {
            return _name;
        }
        /**
         * @dev Returns the symbol of the token, usually a shorter version of the
         * name.
         */
        function symbol() public view virtual returns (string memory) {
            return _symbol;
        }
        /**
         * @dev Returns the number of decimals used to get its user representation.
         * For example, if `decimals` equals `2`, a balance of `505` tokens should
         * be displayed to a user as `5,05` (`505 / 10 ** 2`).
         *
         * Tokens usually opt for a value of 18, imitating the relationship between
         * Ether and Wei. This is the value {ERC20} uses, unless {_setupDecimals} is
         * called.
         *
         * NOTE: This information is only used for _display_ purposes: it in
         * no way affects any of the arithmetic of the contract, including
         * {IERC20-balanceOf} and {IERC20-transfer}.
         */
        function decimals() public view virtual returns (uint8) {
            return _decimals;
        }
        /**
         * @dev See {IERC20-totalSupply}.
         */
        function totalSupply() public view virtual override returns (uint256) {
            return _totalSupply;
        }
        /**
         * @dev See {IERC20-balanceOf}.
         */
        function balanceOf(address account) public view virtual override returns (uint256) {
            return _balances[account];
        }
        /**
         * @dev See {IERC20-transfer}.
         *
         * Requirements:
         *
         * - `recipient` cannot be the zero address.
         * - the caller must have a balance of at least `amount`.
         */
        function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
            _transfer(_msgSender(), recipient, amount);
            return true;
        }
        /**
         * @dev See {IERC20-allowance}.
         */
        function allowance(address owner, address spender) public view virtual override returns (uint256) {
            return _allowances[owner][spender];
        }
        /**
         * @dev See {IERC20-approve}.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function approve(address spender, uint256 amount) public virtual override returns (bool) {
            _approve(_msgSender(), spender, amount);
            return true;
        }
        /**
         * @dev See {IERC20-transferFrom}.
         *
         * Emits an {Approval} event indicating the updated allowance. This is not
         * required by the EIP. See the note at the beginning of {ERC20}.
         *
         * Requirements:
         *
         * - `sender` and `recipient` cannot be the zero address.
         * - `sender` must have a balance of at least `amount`.
         * - the caller must have allowance for ``sender``'s tokens of at least
         * `amount`.
         */
        function transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool) {
            _transfer(sender, recipient, amount);
            _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount, "ERC20: transfer amount exceeds allowance"));
            return true;
        }
        /**
         * @dev Atomically increases the allowance granted to `spender` by the caller.
         *
         * This is an alternative to {approve} that can be used as a mitigation for
         * problems described in {IERC20-approve}.
         *
         * Emits an {Approval} event indicating the updated allowance.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
            _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
            return true;
        }
        /**
         * @dev Atomically decreases the allowance granted to `spender` by the caller.
         *
         * This is an alternative to {approve} that can be used as a mitigation for
         * problems described in {IERC20-approve}.
         *
         * Emits an {Approval} event indicating the updated allowance.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         * - `spender` must have allowance for the caller of at least
         * `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 Moves tokens `amount` from `sender` to `recipient`.
         *
         * This is internal function is equivalent to {transfer}, and can be used to
         * e.g. implement automatic token fees, slashing mechanisms, etc.
         *
         * Emits a {Transfer} event.
         *
         * Requirements:
         *
         * - `sender` cannot be the zero address.
         * - `recipient` cannot be the zero address.
         * - `sender` must have a balance of at least `amount`.
         */
        function _transfer(address sender, address recipient, uint256 amount) internal virtual {
            require(sender != address(0), "ERC20: transfer from the zero address");
            require(recipient != address(0), "ERC20: transfer to the zero address");
            _beforeTokenTransfer(sender, recipient, amount);
            _balances[sender] = _balances[sender].sub(amount, "ERC20: transfer amount exceeds balance");
            _balances[recipient] = _balances[recipient].add(amount);
            emit Transfer(sender, recipient, amount);
        }
        /** @dev Creates `amount` tokens and assigns them to `account`, increasing
         * the total supply.
         *
         * Emits a {Transfer} event with `from` set to the zero address.
         *
         * Requirements:
         *
         * - `to` cannot be the zero address.
         */
        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 Destroys `amount` tokens from `account`, reducing the
         * total supply.
         *
         * Emits a {Transfer} event with `to` set to the zero address.
         *
         * Requirements:
         *
         * - `account` cannot be the zero address.
         * - `account` must have at least `amount` tokens.
         */
        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 Sets `amount` as the allowance of `spender` over the `owner` s tokens.
         *
         * This internal function is equivalent to `approve`, and can be used to
         * e.g. set automatic allowances for certain subsystems, etc.
         *
         * Emits an {Approval} event.
         *
         * Requirements:
         *
         * - `owner` cannot be the zero address.
         * - `spender` cannot be the zero address.
         */
        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;
            emit Approval(owner, spender, amount);
        }
        /**
         * @dev Sets {decimals} to a value other than the default one of 18.
         *
         * WARNING: This function should only be called from the constructor. Most
         * applications that interact with token contracts will not expect
         * {decimals} to ever change, and may work incorrectly if it does.
         */
        function _setupDecimals(uint8 decimals_) internal virtual {
            _decimals = decimals_;
        }
        /**
         * @dev Hook that is called before any transfer of tokens. This includes
         * minting and burning.
         *
         * Calling conditions:
         *
         * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
         * will be to transferred to `to`.
         * - when `from` is zero, `amount` tokens will be minted for `to`.
         * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual { }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    import "./IERC20.sol";
    import "../../math/SafeMath.sol";
    import "../../utils/Address.sol";
    /**
     * @title SafeERC20
     * @dev Wrappers around ERC20 operations that throw on failure (when the token
     * contract returns false). Tokens that return no value (and instead revert or
     * throw on failure) are also supported, non-reverting calls are assumed to be
     * successful.
     * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
     * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
     */
    library SafeERC20 {
        using SafeMath for uint256;
        using Address for address;
        function safeTransfer(IERC20 token, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
        }
        function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
        }
        /**
         * @dev Deprecated. This function has issues similar to the ones found in
         * {IERC20-approve}, and its usage is discouraged.
         *
         * Whenever possible, use {safeIncreaseAllowance} and
         * {safeDecreaseAllowance} instead.
         */
        function safeApprove(IERC20 token, address spender, uint256 value) internal {
            // safeApprove should only be called when setting an initial allowance,
            // or when resetting it to zero. To increase and decrease it, use
            // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
            // solhint-disable-next-line max-line-length
            require((value == 0) || (token.allowance(address(this), spender) == 0),
                "SafeERC20: approve from non-zero to non-zero allowance"
            );
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
        }
        function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 newAllowance = token.allowance(address(this), spender).add(value);
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
        function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
        /**
         * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
         * on the return value: the return value is optional (but if data is returned, it must not be false).
         * @param token The token targeted by the call.
         * @param data The call data (encoded using abi.encode or one of its variants).
         */
        function _callOptionalReturn(IERC20 token, bytes memory data) private {
            // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
            // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
            // the target address contains contract code and also asserts for success in the low-level call.
            bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
            if (returndata.length > 0) { // Return data is optional
                // solhint-disable-next-line max-line-length
                require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev Helper to make usage of the `CREATE2` EVM opcode easier and safer.
     * `CREATE2` can be used to compute in advance the address where a smart
     * contract will be deployed, which allows for interesting new mechanisms known
     * as 'counterfactual interactions'.
     *
     * See the https://eips.ethereum.org/EIPS/eip-1014#motivation[EIP] for more
     * information.
     */
    library Create2 {
        /**
         * @dev Deploys a contract using `CREATE2`. The address where the contract
         * will be deployed can be known in advance via {computeAddress}.
         *
         * The bytecode for a contract can be obtained from Solidity with
         * `type(contractName).creationCode`.
         *
         * Requirements:
         *
         * - `bytecode` must not be empty.
         * - `salt` must have not been used for `bytecode` already.
         * - the factory must have a balance of at least `amount`.
         * - if `amount` is non-zero, `bytecode` must have a `payable` constructor.
         */
        function deploy(uint256 amount, bytes32 salt, bytes memory bytecode) internal returns (address) {
            address addr;
            require(address(this).balance >= amount, "Create2: insufficient balance");
            require(bytecode.length != 0, "Create2: bytecode length is zero");
            // solhint-disable-next-line no-inline-assembly
            assembly {
                addr := create2(amount, add(bytecode, 0x20), mload(bytecode), salt)
            }
            require(addr != address(0), "Create2: Failed on deploy");
            return addr;
        }
        /**
         * @dev Returns the address where a contract will be stored if deployed via {deploy}. Any change in the
         * `bytecodeHash` or `salt` will result in a new destination address.
         */
        function computeAddress(bytes32 salt, bytes32 bytecodeHash) internal view returns (address) {
            return computeAddress(salt, bytecodeHash, address(this));
        }
        /**
         * @dev Returns the address where a contract will be stored if deployed via {deploy} from a contract located at
         * `deployer`. If `deployer` is this contract's address, returns the same value as {computeAddress}.
         */
        function computeAddress(bytes32 salt, bytes32 bytecodeHash, address deployer) internal pure returns (address) {
            bytes32 _data = keccak256(
                abi.encodePacked(bytes1(0xff), deployer, salt, bytecodeHash)
            );
            return address(uint160(uint256(_data)));
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev Wrappers over Solidity's arithmetic operations with added overflow
     * checks.
     *
     * Arithmetic operations in Solidity wrap on overflow. This can easily result
     * in bugs, because programmers usually assume that an overflow raises an
     * error, which is the standard behavior in high level programming languages.
     * `SafeMath` restores this intuition by reverting the transaction when an
     * operation overflows.
     *
     * Using this library instead of the unchecked operations eliminates an entire
     * class of bugs, so it's recommended to use it always.
     */
    library SafeMath {
        /**
         * @dev Returns the addition of two unsigned integers, with an overflow flag.
         *
         * _Available since v3.4._
         */
        function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            uint256 c = a + b;
            if (c < a) return (false, 0);
            return (true, c);
        }
        /**
         * @dev Returns the substraction of two unsigned integers, with an overflow flag.
         *
         * _Available since v3.4._
         */
        function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            if (b > a) return (false, 0);
            return (true, a - b);
        }
        /**
         * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
         *
         * _Available since v3.4._
         */
        function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) return (true, 0);
            uint256 c = a * b;
            if (c / a != b) return (false, 0);
            return (true, c);
        }
        /**
         * @dev Returns the division of two unsigned integers, with a division by zero flag.
         *
         * _Available since v3.4._
         */
        function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            if (b == 0) return (false, 0);
            return (true, a / b);
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
         *
         * _Available since v3.4._
         */
        function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            if (b == 0) return (false, 0);
            return (true, a % b);
        }
        /**
         * @dev Returns the addition of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `+` operator.
         *
         * Requirements:
         *
         * - Addition cannot overflow.
         */
        function add(uint256 a, uint256 b) internal pure returns (uint256) {
            uint256 c = a + b;
            require(c >= a, "SafeMath: addition overflow");
            return c;
        }
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting on
         * overflow (when the result is negative).
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         *
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b) internal pure returns (uint256) {
            require(b <= a, "SafeMath: subtraction overflow");
            return a - b;
        }
        /**
         * @dev Returns the multiplication of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `*` operator.
         *
         * Requirements:
         *
         * - Multiplication cannot overflow.
         */
        function mul(uint256 a, uint256 b) internal pure returns (uint256) {
            if (a == 0) return 0;
            uint256 c = a * b;
            require(c / a == b, "SafeMath: multiplication overflow");
            return c;
        }
        /**
         * @dev Returns the integer division of two unsigned integers, reverting on
         * division by zero. The result is rounded towards zero.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b) internal pure returns (uint256) {
            require(b > 0, "SafeMath: division by zero");
            return a / b;
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * reverting when dividing by zero.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b) internal pure returns (uint256) {
            require(b > 0, "SafeMath: modulo by zero");
            return a % b;
        }
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
         * overflow (when the result is negative).
         *
         * CAUTION: This function is deprecated because it requires allocating memory for the error
         * message unnecessarily. For custom revert reasons use {trySub}.
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         *
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b <= a, errorMessage);
            return a - b;
        }
        /**
         * @dev Returns the integer division of two unsigned integers, reverting with custom message on
         * division by zero. The result is rounded towards zero.
         *
         * CAUTION: This function is deprecated because it requires allocating memory for the error
         * message unnecessarily. For custom revert reasons use {tryDiv}.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b > 0, errorMessage);
            return a / b;
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * reverting with custom message when dividing by zero.
         *
         * CAUTION: This function is deprecated because it requires allocating memory for the error
         * message unnecessarily. For custom revert reasons use {tryMod}.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b > 0, errorMessage);
            return a % b;
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    import "./IBridge.sol";
    import "./IMessageProvider.sol";
    interface IInbox is IMessageProvider {
        function sendL2Message(bytes calldata messageData) external returns (uint256);
        function sendUnsignedTransaction(
            uint256 maxGas,
            uint256 gasPriceBid,
            uint256 nonce,
            address destAddr,
            uint256 amount,
            bytes calldata data
        ) external returns (uint256);
        function sendContractTransaction(
            uint256 maxGas,
            uint256 gasPriceBid,
            address destAddr,
            uint256 amount,
            bytes calldata data
        ) external returns (uint256);
        function sendL1FundedUnsignedTransaction(
            uint256 maxGas,
            uint256 gasPriceBid,
            uint256 nonce,
            address destAddr,
            bytes calldata data
        ) external payable returns (uint256);
        function sendL1FundedContractTransaction(
            uint256 maxGas,
            uint256 gasPriceBid,
            address destAddr,
            bytes calldata data
        ) external payable returns (uint256);
        function createRetryableTicket(
            address destAddr,
            uint256 arbTxCallValue,
            uint256 maxSubmissionCost,
            address submissionRefundAddress,
            address valueRefundAddress,
            uint256 maxGas,
            uint256 gasPriceBid,
            bytes calldata data
        ) external payable returns (uint256);
        function unsafeCreateRetryableTicket(
            address destAddr,
            uint256 arbTxCallValue,
            uint256 maxSubmissionCost,
            address submissionRefundAddress,
            address valueRefundAddress,
            uint256 maxGas,
            uint256 gasPriceBid,
            bytes calldata data
        ) external payable returns (uint256);
        function depositEth(uint256 maxSubmissionCost) external payable returns (uint256);
        function bridge() external view returns (IBridge);
        function pauseCreateRetryables() external;
        function unpauseCreateRetryables() external;
        function startRewriteAddress() external;
        function stopRewriteAddress() external;
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    library ProxyUtil {
        function getProxyAdmin() internal view returns (address admin) {
            // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/v3.4.0/contracts/proxy/TransparentUpgradeableProxy.sol#L48
            // Storage slot with the admin of the proxy contract.
            // This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
            bytes32 slot = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
            assembly {
                admin := sload(slot)
            }
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "arb-bridge-eth/contracts/bridge/interfaces/IInbox.sol";
    import "arb-bridge-eth/contracts/bridge/interfaces/IOutbox.sol";
    /// @notice L1 utility contract to assist with L1 <=> L2 interactions
    /// @dev this is an abstract contract instead of library so the functions can be easily overriden when testing
    abstract contract L1ArbitrumMessenger {
        event TxToL2(address indexed _from, address indexed _to, uint256 indexed _seqNum, bytes _data);
        struct L2GasParams {
            uint256 _maxSubmissionCost;
            uint256 _maxGas;
            uint256 _gasPriceBid;
        }
        function sendTxToL2CustomRefund(
            address _inbox,
            address _to,
            address _refundTo,
            address _user,
            uint256 _l1CallValue,
            uint256 _l2CallValue,
            L2GasParams memory _l2GasParams,
            bytes memory _data
        ) internal returns (uint256) {
            // alternative function entry point when struggling with the stack size
            return
                sendTxToL2CustomRefund(
                    _inbox,
                    _to,
                    _refundTo,
                    _user,
                    _l1CallValue,
                    _l2CallValue,
                    _l2GasParams._maxSubmissionCost,
                    _l2GasParams._maxGas,
                    _l2GasParams._gasPriceBid,
                    _data
                );
        }
        function sendTxToL2(
            address _inbox,
            address _to,
            address _user,
            uint256 _l1CallValue,
            uint256 _l2CallValue,
            L2GasParams memory _l2GasParams,
            bytes memory _data
        ) internal returns (uint256) {
            // alternative function entry point when struggling with the stack size
            return
                sendTxToL2(
                    _inbox,
                    _to,
                    _user,
                    _l1CallValue,
                    _l2CallValue,
                    _l2GasParams._maxSubmissionCost,
                    _l2GasParams._maxGas,
                    _l2GasParams._gasPriceBid,
                    _data
                );
        }
        function sendTxToL2CustomRefund(
            address _inbox,
            address _to,
            address _refundTo,
            address _user,
            uint256 _l1CallValue,
            uint256 _l2CallValue,
            uint256 _maxSubmissionCost,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes memory _data
        ) internal returns (uint256) {
            uint256 seqNum = IInbox(_inbox).createRetryableTicket{ value: _l1CallValue }(
                _to,
                _l2CallValue,
                _maxSubmissionCost,
                _refundTo, // only refund excess fee to the custom address
                _user, // user can cancel the retryable and receive call value refund
                _maxGas,
                _gasPriceBid,
                _data
            );
            emit TxToL2(_user, _to, seqNum, _data);
            return seqNum;
        }
        function sendTxToL2(
            address _inbox,
            address _to,
            address _user,
            uint256 _l1CallValue,
            uint256 _l2CallValue,
            uint256 _maxSubmissionCost,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes memory _data
        ) internal returns (uint256) {
            return
                sendTxToL2CustomRefund(
                    _inbox,
                    _to,
                    _user,
                    _user,
                    _l1CallValue,
                    _l2CallValue,
                    _maxSubmissionCost,
                    _maxGas,
                    _gasPriceBid,
                    _data
                );
        }
        function getBridge(address _inbox) internal view returns (IBridge) {
            return IInbox(_inbox).bridge();
        }
        /// @dev the l2ToL1Sender behaves as the tx.origin, the msg.sender should be validated to protect against reentrancies
        function getL2ToL1Sender(address _inbox) internal view returns (address) {
            IOutbox outbox = IOutbox(getBridge(_inbox).activeOutbox());
            address l2ToL1Sender = outbox.l2ToL1Sender();
            require(l2ToL1Sender != address(0), "NO_SENDER");
            return l2ToL1Sender;
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    /// @notice this library manages encoding and decoding of gateway communication
    library GatewayMessageHandler {
        // these are for communication from L1 to L2 gateway
        function encodeToL2GatewayMsg(bytes memory gatewayData, bytes memory callHookData)
            internal
            pure
            returns (bytes memory res)
        {
            res = abi.encode(gatewayData, callHookData);
        }
        function parseFromL1GatewayMsg(bytes calldata _data)
            internal
            pure
            returns (bytes memory gatewayData, bytes memory callHookData)
        {
            // abi decode may revert, but the encoding is done by L1 gateway, so we trust it
            (gatewayData, callHookData) = abi.decode(_data, (bytes, bytes));
        }
        // these are for communication from L2 to L1 gateway
        function encodeFromL2GatewayMsg(uint256 exitNum, bytes memory callHookData)
            internal
            pure
            returns (bytes memory res)
        {
            res = abi.encode(exitNum, callHookData);
        }
        function parseToL1GatewayMsg(bytes calldata _data)
            internal
            pure
            returns (uint256 exitNum, bytes memory callHookData)
        {
            // abi decode may revert, but the encoding is done by L1 gateway, so we trust it
            (exitNum, callHookData) = abi.decode(_data, (uint256, bytes));
        }
        // these are for communication from router to gateway
        function encodeFromRouterToGateway(address _from, bytes calldata _data)
            internal
            pure
            returns (bytes memory res)
        {
            // abi decode may revert, but the encoding is done by L1 gateway, so we trust it
            return abi.encode(_from, _data);
        }
        function parseFromRouterToGateway(bytes calldata _data)
            internal
            pure
            returns (address, bytes memory res)
        {
            // abi decode may revert, but the encoding is done by L1 gateway, so we trust it
            return abi.decode(_data, (address, bytes));
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "./ITokenGateway.sol";
    import "@openzeppelin/contracts/utils/Address.sol";
    abstract contract TokenGateway is ITokenGateway {
        using Address for address;
        address public counterpartGateway;
        address public router;
        // This modifier is overriden in gateways to validate the message sender
        // For L1 to L2 messages need to be validated against the aliased counterpartGateway
        // For L2 to L1 messages need to be validated against the bridge and L2ToL1Sender
        // prettier-ignore
        modifier onlyCounterpartGateway() virtual;
        function _initialize(address _counterpartGateway, address _router) internal virtual {
            // This initializes internal variables of the abstract contract it can be chained together with other functions.
            // It is virtual so subclasses can override or wrap around this logic.
            // An example where this is useful is different subclasses that validate the router address differently
            require(_counterpartGateway != address(0), "INVALID_COUNTERPART");
            require(counterpartGateway == address(0), "ALREADY_INIT");
            counterpartGateway = _counterpartGateway;
            router = _router;
        }
        function isRouter(address _target) internal view returns (bool isTargetRouter) {
            return _target == router;
        }
        /**
         * @notice Calculate the address used when bridging an ERC20 token
         * @dev the L1 and L2 address oracles may not always be in sync.
         * For example, a custom token may have been registered but not deploy or the contract self destructed.
         * @param l1ERC20 address of L1 token
         * @return L2 address of a bridged ERC20 token
         */
        function calculateL2TokenAddress(address l1ERC20)
            public
            view
            virtual
            override
            returns (address);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    import "../../libraries/gateway/ITokenGateway.sol";
    import "../../libraries/IERC165.sol";
    /**
     * @title Common interface for gatways on L1 messaging to Arbitrum.
     */
    interface IL1ArbitrumGateway is ITokenGateway, IERC165 {
        function inbox() external view returns (address);
        /**
         * @notice Deposit ERC20 token from Ethereum into Arbitrum. If L2 side hasn't been deployed yet, includes name/symbol/decimals data for initial L2 deploy. Initiate by GatewayRouter.
         * @dev L2 address alias will not be applied to the following types of addresses on L1:
         *      - an externally-owned account
         *      - a contract in construction
         *      - an address where a contract will be created
         *      - an address where a contract lived, but was destroyed
         * @param _l1Token L1 address of ERC20
         * @param _refundTo Account, or its L2 alias if it have code in L1, to be credited with excess gas refund in L2
         * @param _to Account to be credited with the tokens in the L2 (can be the user's L2 account or a contract), not subject to L2 aliasing
                      This account, or its L2 alias if it have code in L1, will also be able to cancel the retryable ticket and receive callvalue refund
         * @param _amount Token Amount
         * @param _maxGas Max gas deducted from user's L2 balance to cover L2 execution
         * @param _gasPriceBid Gas price for L2 execution
         * @param _data encoded data from router and user
         * @return res abi encoded inbox sequence number
         */
        //  * @param maxSubmissionCost Max gas deducted from user's L2 balance to cover base submission fee
        function outboundTransferCustomRefund(
            address _l1Token,
            address _refundTo,
            address _to,
            uint256 _amount,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes calldata _data
        ) external payable returns (bytes memory);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
    // With pragma modification to support ^0.6.11
    // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/release-v4.6/contracts/utils/introspection/ERC165.sol
    pragma solidity ^0.6.11;
    import "./IERC165.sol";
    /**
     * @dev Implementation of the {IERC165} interface.
     *
     * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
     * for the additional interface id that will be supported. For example:
     *
     * ```solidity
     * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
     *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
     * }
     * ```
     *
     * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
     */
    abstract contract ERC165 is IERC165 {
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
            return interfaceId == type(IERC165).interfaceId;
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /*
     * @dev Provides information about the current execution context, including the
     * sender of the transaction and its data. While these are generally available
     * via msg.sender and msg.data, they should not be accessed in such a direct
     * manner, since when dealing with GSN meta-transactions the account sending and
     * paying for execution may not be the actual sender (as far as an application
     * is concerned).
     *
     * This contract is only required for intermediate, library-like contracts.
     */
    abstract contract Context {
        function _msgSender() internal view virtual returns (address payable) {
            return msg.sender;
        }
        function _msgData() internal view virtual returns (bytes memory) {
            this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
            return msg.data;
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev Interface of the ERC20 standard as defined in the EIP.
     */
    interface IERC20 {
        /**
         * @dev Returns the amount of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the amount of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves `amount` tokens from the caller's account to `recipient`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address recipient, uint256 amount) external returns (bool);
        /**
         * @dev Returns the remaining number of tokens that `spender` will be
         * allowed to spend on behalf of `owner` through {transferFrom}. This is
         * zero by default.
         *
         * This value changes when {approve} or {transferFrom} are called.
         */
        function allowance(address owner, address spender) external view returns (uint256);
        /**
         * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * IMPORTANT: Beware that changing an allowance with this method brings the risk
         * that someone may use both the old and the new allowance by unfortunate
         * transaction ordering. One possible solution to mitigate this race
         * condition is to first reduce the spender's allowance to 0 and set the
         * desired value afterwards:
         * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
         *
         * Emits an {Approval} event.
         */
        function approve(address spender, uint256 amount) external returns (bool);
        /**
         * @dev Moves `amount` tokens from `sender` to `recipient` using the
         * allowance mechanism. `amount` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    interface IBridge {
        event MessageDelivered(
            uint256 indexed messageIndex,
            bytes32 indexed beforeInboxAcc,
            address inbox,
            uint8 kind,
            address sender,
            bytes32 messageDataHash
        );
        event BridgeCallTriggered(
            address indexed outbox,
            address indexed destAddr,
            uint256 amount,
            bytes data
        );
        event InboxToggle(address indexed inbox, bool enabled);
        event OutboxToggle(address indexed outbox, bool enabled);
        function deliverMessageToInbox(
            uint8 kind,
            address sender,
            bytes32 messageDataHash
        ) external payable returns (uint256);
        function executeCall(
            address destAddr,
            uint256 amount,
            bytes calldata data
        ) external returns (bool success, bytes memory returnData);
        // These are only callable by the admin
        function setInbox(address inbox, bool enabled) external;
        function setOutbox(address inbox, bool enabled) external;
        // View functions
        function activeOutbox() external view returns (address);
        function allowedInboxes(address inbox) external view returns (bool);
        function allowedOutboxes(address outbox) external view returns (bool);
        function inboxAccs(uint256 index) external view returns (bytes32);
        function messageCount() external view returns (uint256);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    interface IMessageProvider {
        event InboxMessageDelivered(uint256 indexed messageNum, bytes data);
        event InboxMessageDeliveredFromOrigin(uint256 indexed messageNum);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    interface IOutbox {
        event OutboxEntryCreated(
            uint256 indexed batchNum,
            uint256 outboxEntryIndex,
            bytes32 outputRoot,
            uint256 numInBatch
        );
        event OutBoxTransactionExecuted(
            address indexed destAddr,
            address indexed l2Sender,
            uint256 indexed outboxEntryIndex,
            uint256 transactionIndex
        );
        function l2ToL1Sender() external view returns (address);
        function l2ToL1Block() external view returns (uint256);
        function l2ToL1EthBlock() external view returns (uint256);
        function l2ToL1Timestamp() external view returns (uint256);
        function l2ToL1BatchNum() external view returns (uint256);
        function l2ToL1OutputId() external view returns (bytes32);
        function processOutgoingMessages(bytes calldata sendsData, uint256[] calldata sendLengths)
            external;
        function outboxEntryExists(uint256 batchNum) external view returns (bool);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    interface ITokenGateway {
        /// @notice event deprecated in favor of DepositInitiated and WithdrawalInitiated
        // event OutboundTransferInitiated(
        //     address token,
        //     address indexed _from,
        //     address indexed _to,
        //     uint256 indexed _transferId,
        //     uint256 _amount,
        //     bytes _data
        // );
        /// @notice event deprecated in favor of DepositFinalized and WithdrawalFinalized
        // event InboundTransferFinalized(
        //     address token,
        //     address indexed _from,
        //     address indexed _to,
        //     uint256 indexed _transferId,
        //     uint256 _amount,
        //     bytes _data
        // );
        function outboundTransfer(
            address _token,
            address _to,
            uint256 _amount,
            uint256 _maxGas,
            uint256 _gasPriceBid,
            bytes calldata _data
        ) external payable returns (bytes memory);
        function finalizeInboundTransfer(
            address _token,
            address _from,
            address _to,
            uint256 _amount,
            bytes calldata _data
        ) external payable;
        /**
         * @notice Calculate the address used when bridging an ERC20 token
         * @dev the L1 and L2 address oracles may not always be in sync.
         * For example, a custom token may have been registered but not deploy or the contract self destructed.
         * @param l1ERC20 address of L1 token
         * @return L2 address of a bridged ERC20 token
         */
        function calculateL2TokenAddress(address l1ERC20) external view returns (address);
        function getOutboundCalldata(
            address _token,
            address _from,
            address _to,
            uint256 _amount,
            bytes memory _data
        ) external view returns (bytes memory);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
    // With pragma modification to allow interface compatibility with >=0.6.9 <0.9.0
    // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/release-v4.6/contracts/utils/introspection/IERC165.sol
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    /**
     * @dev Interface of the ERC165 standard, as defined in the
     * https://eips.ethereum.org/EIPS/eip-165[EIP].
     *
     * Implementers can declare support of contract interfaces, which can then be
     * queried by others ({ERC165Checker}).
     *
     * For an implementation, see {ERC165}.
     */
    interface IERC165 {
        /**
         * @dev Returns true if this contract implements the interface defined by
         * `interfaceId`. See the corresponding
         * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
         * to learn more about how these ids are created.
         *
         * This function call must use less than 30 000 gas.
         */
        function supportsInterface(bytes4 interfaceId) external view returns (bool);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "@openzeppelin/contracts/utils/Address.sol";
    import "arb-bridge-eth/contracts/libraries/BytesLib.sol";
    import "arb-bridge-eth/contracts/libraries/ProxyUtil.sol";
    import "arb-bridge-eth/contracts/libraries/AddressAliasHelper.sol";
    import "../IArbToken.sol";
    import "../L2ArbitrumMessenger.sol";
    import "../../libraries/gateway/GatewayMessageHandler.sol";
    import "../../libraries/gateway/TokenGateway.sol";
    /**
     * @title Common interface for gatways on Arbitrum messaging to L1.
     */
    abstract contract L2ArbitrumGateway is L2ArbitrumMessenger, TokenGateway {
        using Address for address;
        uint256 public exitNum;
        event DepositFinalized(
            address indexed l1Token,
            address indexed _from,
            address indexed _to,
            uint256 _amount
        );
        event WithdrawalInitiated(
            address l1Token,
            address indexed _from,
            address indexed _to,
            uint256 indexed _l2ToL1Id,
            uint256 _exitNum,
            uint256 _amount
        );
        modifier onlyCounterpartGateway() override {
            require(
                msg.sender == AddressAliasHelper.applyL1ToL2Alias(counterpartGateway),
                "ONLY_COUNTERPART_GATEWAY"
            );
            _;
        }
        function postUpgradeInit() external {
            // it is assumed the L2 Arbitrum Gateway contract is behind a Proxy controlled by a proxy admin
            // this function can only be called by the proxy admin contract
            address proxyAdmin = ProxyUtil.getProxyAdmin();
            require(msg.sender == proxyAdmin, "NOT_FROM_ADMIN");
            // this has no other logic since the current upgrade doesn't require this logic
        }
        function _initialize(address _l1Counterpart, address _router) internal override {
            TokenGateway._initialize(_l1Counterpart, _router);
            // L1 gateway must have a router
            require(_router != address(0), "BAD_ROUTER");
        }
        function createOutboundTx(
            address _from,
            uint256, /* _tokenAmount */
            bytes memory _outboundCalldata
        ) internal virtual returns (uint256) {
            // We make this function virtual since outboundTransfer logic is the same for many gateways
            // but sometimes (ie weth) you construct the outgoing message differently.
            // exitNum incremented after being included in _outboundCalldata
            exitNum++;
            return
                sendTxToL1(
                    // default to sending no callvalue to the L1
                    0,
                    _from,
                    counterpartGateway,
                    _outboundCalldata
                );
        }
        function getOutboundCalldata(
            address _token,
            address _from,
            address _to,
            uint256 _amount,
            bytes memory _data
        ) public view override returns (bytes memory outboundCalldata) {
            outboundCalldata = abi.encodeWithSelector(
                ITokenGateway.finalizeInboundTransfer.selector,
                _token,
                _from,
                _to,
                _amount,
                GatewayMessageHandler.encodeFromL2GatewayMsg(exitNum, _data)
            );
            return outboundCalldata;
        }
        function outboundTransfer(
            address _l1Token,
            address _to,
            uint256 _amount,
            bytes calldata _data
        ) public payable returns (bytes memory) {
            return outboundTransfer(_l1Token, _to, _amount, 0, 0, _data);
        }
        /**
         * @notice Initiates a token withdrawal from Arbitrum to Ethereum
         * @param _l1Token l1 address of token
         * @param _to destination address
         * @param _amount amount of tokens withdrawn
         * @return res encoded unique identifier for withdrawal
         */
        function outboundTransfer(
            address _l1Token,
            address _to,
            uint256 _amount,
            uint256, /* _maxGas */
            uint256, /* _gasPriceBid */
            bytes calldata _data
        ) public payable override returns (bytes memory res) {
            // This function is set as public and virtual so that subclasses can override
            // it and add custom validation for callers (ie only whitelisted users)
            // the function is marked as payable to conform to the inheritance setup
            // this particular code path shouldn't have a msg.value > 0
            // TODO: remove this invariant for execution markets
            require(msg.value == 0, "NO_VALUE");
            address _from;
            bytes memory _extraData;
            {
                if (isRouter(msg.sender)) {
                    (_from, _extraData) = GatewayMessageHandler.parseFromRouterToGateway(_data);
                } else {
                    _from = msg.sender;
                    _extraData = _data;
                }
            }
            // the inboundEscrowAndCall functionality has been disabled, so no data is allowed
            require(_extraData.length == 0, "EXTRA_DATA_DISABLED");
            uint256 id;
            {
                address l2Token = calculateL2TokenAddress(_l1Token);
                require(l2Token.isContract(), "TOKEN_NOT_DEPLOYED");
                require(IArbToken(l2Token).l1Address() == _l1Token, "NOT_EXPECTED_L1_TOKEN");
                _amount = outboundEscrowTransfer(l2Token, _from, _amount);
                id = triggerWithdrawal(_l1Token, _from, _to, _amount, _extraData);
            }
            return abi.encode(id);
        }
        function triggerWithdrawal(
            address _l1Token,
            address _from,
            address _to,
            uint256 _amount,
            bytes memory _data
        ) internal returns (uint256) {
            // exit number used for tradeable exits
            uint256 currExitNum = exitNum;
            // unique id used to identify the L2 to L1 tx
            uint256 id = createOutboundTx(
                _from,
                _amount,
                getOutboundCalldata(_l1Token, _from, _to, _amount, _data)
            );
            emit WithdrawalInitiated(_l1Token, _from, _to, id, currExitNum, _amount);
            return id;
        }
        function outboundEscrowTransfer(
            address _l2Token,
            address _from,
            uint256 _amount
        ) internal virtual returns (uint256 amountBurnt) {
            // this method is virtual since different subclasses can handle escrow differently
            // user funds are escrowed on the gateway using this function
            // burns L2 tokens in order to release escrowed L1 tokens
            IArbToken(_l2Token).bridgeBurn(_from, _amount);
            // by default we assume that the amount we send to bridgeBurn is the amount burnt
            // this might not be the case for every token
            return _amount;
        }
        function inboundEscrowTransfer(
            address _l2Address,
            address _dest,
            uint256 _amount
        ) internal virtual {
            // this method is virtual since different subclasses can handle escrow differently
            IArbToken(_l2Address).bridgeMint(_dest, _amount);
        }
        /**
         * @notice Mint on L2 upon L1 deposit.
         * If token not yet deployed and symbol/name/decimal data is included, deploys StandardArbERC20
         * @dev Callable only by the L1ERC20Gateway.outboundTransfer method. For initial deployments of a token the L1 L1ERC20Gateway
         * is expected to include the deployData. If not a L1 withdrawal is automatically triggered for the user
         * @param _token L1 address of ERC20
         * @param _from account that initiated the deposit in the L1
         * @param _to account to be credited with the tokens in the L2 (can be the user's L2 account or a contract)
         * @param _amount token amount to be minted to the user
         * @param _data encoded symbol/name/decimal data for deploy, in addition to any additional callhook data
         */
        function finalizeInboundTransfer(
            address _token,
            address _from,
            address _to,
            uint256 _amount,
            bytes calldata _data
        ) external payable override onlyCounterpartGateway {
            (bytes memory gatewayData, bytes memory callHookData) = GatewayMessageHandler
                .parseFromL1GatewayMsg(_data);
            if (callHookData.length != 0) {
                // callHookData should always be 0 since inboundEscrowAndCall is disabled
                callHookData = bytes("");
            }
            address expectedAddress = calculateL2TokenAddress(_token);
            if (!expectedAddress.isContract()) {
                bool shouldHalt = handleNoContract(
                    _token,
                    expectedAddress,
                    _from,
                    _to,
                    _amount,
                    gatewayData
                );
                if (shouldHalt) return;
            }
            // ignores gatewayData if token already deployed
            {
                // validate if L1 address supplied matches that of the expected L2 address
                (bool success, bytes memory _l1AddressData) = expectedAddress.staticcall(
                    abi.encodeWithSelector(IArbToken.l1Address.selector)
                );
                bool shouldWithdraw;
                if (!success || _l1AddressData.length < 32) {
                    shouldWithdraw = true;
                } else {
                    // we do this in the else branch since we want to avoid reverts
                    // and `toAddress` reverts if _l1AddressData has a short length
                    // `_l1AddressData` should be 12 bytes of padding then 20 bytes for the address
                    address expectedL1Address = BytesLib.toAddress(_l1AddressData, 12);
                    if (expectedL1Address != _token) {
                        shouldWithdraw = true;
                    }
                }
                if (shouldWithdraw) {
                    // we don't need the return value from triggerWithdrawal since this is forcing
                    // a withdrawal back to the L1 instead of composing with a L2 dapp
                    triggerWithdrawal(_token, address(this), _from, _amount, "");
                    return;
                }
            }
            inboundEscrowTransfer(expectedAddress, _to, _amount);
            emit DepositFinalized(_token, _from, _to, _amount);
            return;
        }
        // returns if function should halt after
        function handleNoContract(
            address _l1Token,
            address expectedL2Address,
            address _from,
            address _to,
            uint256 _amount,
            bytes memory gatewayData
        ) internal virtual returns (bool shouldHalt);
    }
    // SPDX-License-Identifier: MIT
    /*
     * @title Solidity Bytes Arrays Utils
     * @author Gonçalo Sá <goncalo.sa@consensys.net>
     *
     * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.
     *      The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.
     */
    pragma solidity ^0.6.11;
    /* solhint-disable no-inline-assembly */
    library BytesLib {
        function toAddress(bytes memory _bytes, uint256 _start) internal pure returns (address) {
            require(_bytes.length >= (_start + 20), "Read out of bounds");
            address tempAddress;
            assembly {
                tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)
            }
            return tempAddress;
        }
        function toUint8(bytes memory _bytes, uint256 _start) internal pure returns (uint8) {
            require(_bytes.length >= (_start + 1), "Read out of bounds");
            uint8 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x1), _start))
            }
            return tempUint;
        }
        function toUint(bytes memory _bytes, uint256 _start) internal pure returns (uint256) {
            require(_bytes.length >= (_start + 32), "Read out of bounds");
            uint256 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x20), _start))
            }
            return tempUint;
        }
        function toBytes32(bytes memory _bytes, uint256 _start) internal pure returns (bytes32) {
            require(_bytes.length >= (_start + 32), "Read out of bounds");
            bytes32 tempBytes32;
            assembly {
                tempBytes32 := mload(add(add(_bytes, 0x20), _start))
            }
            return tempBytes32;
        }
    }
    /* solhint-enable no-inline-assembly */
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2019-2021, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    library AddressAliasHelper {
        uint160 constant offset = uint160(0x1111000000000000000000000000000000001111);
        /// @notice Utility function that converts the address in the L1 that submitted a tx to
        /// the inbox to the msg.sender viewed in the L2
        /// @param l1Address the address in the L1 that triggered the tx to L2
        /// @return l2Address L2 address as viewed in msg.sender
        function applyL1ToL2Alias(address l1Address) internal pure returns (address l2Address) {
            l2Address = address(uint160(l1Address) + offset);
        }
        /// @notice Utility function that converts the msg.sender viewed in the L2 to the
        /// address in the L1 that submitted a tx to the inbox
        /// @param l2Address L2 address as viewed in msg.sender
        /// @return l1Address the address in the L1 that triggered the tx to L2
        function undoL1ToL2Alias(address l2Address) internal pure returns (address l1Address) {
            l1Address = address(uint160(l2Address) - offset);
        }
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    /**
     * @title Minimum expected interface for L2 token that interacts with the L2 token bridge (this is the interface necessary
     * for a custom token that interacts with the bridge, see TestArbCustomToken.sol for an example implementation).
     */
    // solhint-disable-next-line compiler-version
    pragma solidity >=0.6.9 <0.9.0;
    interface IArbToken {
        /**
         * @notice should increase token supply by amount, and should (probably) only be callable by the L1 bridge.
         */
        function bridgeMint(address account, uint256 amount) external;
        /**
         * @notice should decrease token supply by amount, and should (probably) only be callable by the L1 bridge.
         */
        function bridgeBurn(address account, uint256 amount) external;
        /**
         * @return address of layer 1 token
         */
        function l1Address() external view returns (address);
    }
    // SPDX-License-Identifier: Apache-2.0
    /*
     * Copyright 2020, Offchain Labs, Inc.
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
     * You may obtain a copy of the License at
     *
     *    http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software
     * distributed under the License is distributed on an "AS IS" BASIS,
     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     * See the License for the specific language governing permissions and
     * limitations under the License.
     */
    pragma solidity ^0.6.11;
    import "arbos-precompiles/arbos/builtin/ArbSys.sol";
    /// @notice L2 utility contract to assist with L1 <=> L2 interactions
    /// @dev this is an abstract contract instead of library so the functions can be easily overriden when testing
    abstract contract L2ArbitrumMessenger {
        address internal constant ARB_SYS_ADDRESS = address(100);
        event TxToL1(address indexed _from, address indexed _to, uint256 indexed _id, bytes _data);
        function sendTxToL1(
            uint256 _l1CallValue,
            address _from,
            address _to,
            bytes memory _data
        ) internal returns (uint256) {
            uint256 _id = ArbSys(ARB_SYS_ADDRESS).sendTxToL1{ value: _l1CallValue }(_to, _data);
            emit TxToL1(_from, _to, _id, _data);
            return _id;
        }
    }
    pragma solidity >=0.6.9 <0.9.0;
    /**
     * @title Precompiled contract that exists in every Arbitrum chain at address(100), 0x0000000000000000000000000000000000000064. Exposes a variety of system-level functionality.
     */
    interface ArbSys {
        /**
         * @notice Get internal version number identifying an ArbOS build
         * @return version number as int
         */
        function arbOSVersion() external pure returns (uint256);
        function arbChainID() external view returns (uint256);
        /**
         * @notice Get Arbitrum block number (distinct from L1 block number; Arbitrum genesis block has block number 0)
         * @return block number as int
         */
        function arbBlockNumber() external view returns (uint256);
        /**
         * @notice Send given amount of Eth to dest from sender.
         * This is a convenience function, which is equivalent to calling sendTxToL1 with empty calldataForL1.
         * @param destination recipient address on L1
         * @return unique identifier for this L2-to-L1 transaction.
         */
        function withdrawEth(address destination) external payable returns (uint256);
        /**
         * @notice Send a transaction to L1
         * @param destination recipient address on L1
         * @param calldataForL1 (optional) calldata for L1 contract call
         * @return a unique identifier for this L2-to-L1 transaction.
         */
        function sendTxToL1(address destination, bytes calldata calldataForL1)
            external
            payable
            returns (uint256);
        /**
         * @notice get the number of transactions issued by the given external account or the account sequence number of the given contract
         * @param account target account
         * @return the number of transactions issued by the given external account or the account sequence number of the given contract
         */
        function getTransactionCount(address account) external view returns (uint256);
        /**
         * @notice get the value of target L2 storage slot
         * This function is only callable from address 0 to prevent contracts from being able to call it
         * @param account target account
         * @param index target index of storage slot
         * @return stotage value for the given account at the given index
         */
        function getStorageAt(address account, uint256 index) external view returns (uint256);
        /**
         * @notice check if current call is coming from l1
         * @return true if the caller of this was called directly from L1
         */
        function isTopLevelCall() external view returns (bool);
        /**
         * @notice check if the caller (of this caller of this) is an aliased L1 contract address
         * @return true iff the caller's address is an alias for an L1 contract address
         */
        function wasMyCallersAddressAliased() external view returns (bool);
        /**
         * @notice return the address of the caller (of this caller of this), without applying L1 contract address aliasing
         * @return address of the caller's caller, without applying L1 contract address aliasing
         */
        function myCallersAddressWithoutAliasing() external view returns (address);
        /**
         * @notice map L1 sender contract address to its L2 alias
         * @param sender sender address
         * @param dest destination address
         * @return aliased sender address
         */
        function mapL1SenderContractAddressToL2Alias(address sender, address dest)
            external
            pure
            returns (address);
        /**
         * @notice get the caller's amount of available storage gas
         * @return amount of storage gas available to the caller
         */
        function getStorageGasAvailable() external view returns (uint256);
        event L2ToL1Transaction(
            address caller,
            address indexed destination,
            uint256 indexed uniqueId,
            uint256 indexed batchNumber,
            uint256 indexInBatch,
            uint256 arbBlockNum,
            uint256 ethBlockNum,
            uint256 timestamp,
            uint256 callvalue,
            bytes data
        );
    }