Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Is this a proxy?
• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import {ITokenDeposit} from "./interfaces/ITokenDeposit.sol";
import {ITokenPairs} from "./interfaces/ITokenPairs.sol";
import {IProofVerifier} from "./interfaces/IProofVerifier.sol";
import {IStateOracle} from "./interfaces/IStateOracle.sol";
import {IProvingContract} from "./interfaces/IProvingContract.sol";
import {UsdcDepositExtension} from "./UsdcDepositExtension.sol";
import {EurcDepositExtension} from "./EurcDepositExtension.sol";
import {UsdtDepositExtension} from "./UsdtDepositExtension.sol";
import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
import {ReentrancyGuardTransientUpgradeable} from "@openzeppelin/contracts-upgradeable/utils/ReentrancyGuardTransientUpgradeable.sol";

using SafeERC20 for IERC20;

/// The L1 part of the bridge. Allows to initiate depositing tokens to the L2.
/// Allows to claim withdrawal initiated on the L2 chain.
/// @custom:security-contact [email protected]
contract TokenDeposit is IProvingContract, ITokenDeposit, UUPSUpgradeable, OwnableUpgradeable, UsdcDepositExtension, EurcDepositExtension, UsdtDepositExtension, ReentrancyGuardTransientUpgradeable {
    uint256 private _gap;
    mapping (uint256 depositId => bytes32 senderTokenAmount) public deposits; // slot index 7
    mapping (uint256 withdrawalId => bool isClaimed) public claims; // claimed withdraws, slot index 8

    address public override(ITokenDeposit, IProvingContract) proofVerifier; // for verification of proofs from L2 chain
    address public exitAdministrator; // for withdrawals while the bridge is dead
    address public immutable bridge; // Bridge contract on the L2 chain
    address public immutable tokenPairs; // TokenPairs contract
    address public immutable stateOracle; // StateOracle contract
    bytes32 public deadState; // Last state root when the bridge died

    uint256 private constant TIME_UNTIL_DEAD = 200 days;
    uint256 private constant TIME_UNTIL_OFFLINE = 24 hours;

    event Deposit(uint256 indexed id, address indexed owner, address token, uint256 amount);
    event Claim(uint256 id, address indexed owner, address token, uint256 amount);
    event WithdrawnWhileDead(address indexed owner, address token, uint256 amount);
    event CancelledWhileDead(uint256 id, address indexed owner, address token, uint256 amount);
    event ProofVerifierSet(address proofVerifier);
    event BridgeDied();
    event ExitAdministratorSet(address _exitAdministrator);

    /// @custom:oz-upgrades-unsafe-allow constructor
    constructor(address _bridge, address _tokenPairs, address _stateOracle)
            UsdcDepositExtension(_tokenPairs) EurcDepositExtension(_tokenPairs) UsdtDepositExtension(_tokenPairs) {
        require(_bridge != address(0), "Bridge address not set");
        require(_tokenPairs != address(0), "TokenPairs not set");
        require(_stateOracle != address(0), "StateOracle not set");
        bridge = _bridge;
        tokenPairs = _tokenPairs;
        stateOracle = _stateOracle;
        _disableInitializers();
    }

    /// Initialize contract after the deployment.
    function initialize(address _proofVerifier, address _owner, address _exitAdministrator) external initializer {
        require(_proofVerifier != address(0), "ProofVerifier not set");
        __Ownable_init(_owner);
        __UUPSUpgradeable_init();
        __ReentrancyGuardTransient_init();
        proofVerifier = _proofVerifier;
        exitAdministrator = _exitAdministrator;
    }

    function _authorizeUpgrade(address newImplementation) internal override onlyOwner {}

    /// Deposits tokens on L1.
    function deposit(uint96 uid, address token, uint256 amount) external nonReentrant {
        uint256 id = userOperationId(msg.sender, uid);
        require(deposits[id] == 0, "Deposit id is already used");
        require(ITokenPairs(tokenPairs).originalToMintedTerminable(token) != address(0), "Not supported token");
        require(isOnline(), "Bridge is offline");

        uint256 balanceBefore = IERC20(token).balanceOf(address(this));
        IERC20(token).safeTransferFrom(msg.sender, address(this), amount);
        uint256 realAmount = IERC20(token).balanceOf(address(this)) - balanceBefore;
        require(realAmount > 0, "No tokens were transferred");

        deposits[id] = hash(msg.sender, token, realAmount);
        emit Deposit(id, msg.sender, token, realAmount);
    }

    /// Claim deposited L1 tokens burned on L2.
    function claim(uint256 id, address token, uint256 amount, bytes calldata proof) external {
        require(claims[id] == false, "Already claimed");

        bytes32 expectedHash = hash(msg.sender, token, amount);
        IProofVerifier(proofVerifier).verifyProof(bridge, getWithdrawalSlotIndex(id), expectedHash, lastValidState(), proof);
        // the withdrawal exists on the L2

        claims[id] = true; // write before other contract call (reentrancy!)
        IERC20(token).safeTransfer(msg.sender, amount);
        emit Claim(id, msg.sender, token, amount);
    }

    /// When the bridge is dead, ExitAdministrator can release tokens from the deposit to appropriate owners.
    function withdrawWhileDead(address recipient, address token, uint256 amount) external {
        require(recipient != address(0), "Recipient is zero");
        require(msg.sender == exitAdministrator, "Not exit administrator");
        require(fetchDeadStatus(), "Bridge is not dead");
        IERC20(token).safeTransfer(recipient, amount);
        emit WithdrawnWhileDead(recipient, token, amount);
    }

    /// When the bridge is dead, cancel not-claimed deposit.
    /// Use proof of not-claimed state of the deposit on L2.
    function cancelDepositWhileDead(uint256 id, address token, uint256 amount, bytes calldata proof) external {
        require(deposits[id] == hash(msg.sender, token, amount), "No deposit to cancel");
        require(fetchDeadStatus(), "Bridge is not dead");

        IProofVerifier(proofVerifier).verifyProof(bridge, getClaimSlotIndex(id), bytes32(0), lastValidState(), proof);
        // claimed state is false in the last state root

        delete deposits[id]; // write before other contract call (reentrancy!)
        IERC20(token).safeTransfer(msg.sender, amount);
        emit CancelledWhileDead(id, msg.sender, token, amount);
    }

    /// Calculate slotId for withdrawal in the Bridge L2 contract.
    function getWithdrawalSlotIndex(uint256 id) pure public returns (bytes32) {
        return keccak256(abi.encode(id, uint8(1))); // withdrawals mapping is at slot index 1
    }

    /// Get deposit/withdrawal hash.
    function hash(address sender, address token, uint256 amount) pure public returns (bytes32) {
        return keccak256(abi.encode(sender, token, amount));
    }

    /// Calculate mapping key for user operation.
    /// Combines calling user identity and user-chosen value into a single key.
    function userOperationId(address sender, uint96 uid) pure public returns (uint256) {
        return (uint256(uint160(sender)) << 96) + uint256(uid);
    }

    /// Calculate slotId for claim in the Bridge L2 contract.
    function getClaimSlotIndex(uint256 id) pure public returns (bytes32) {
        return keccak256(abi.encode(id, uint8(2))); // claims mapping is at slot index 2
    }

    /// Fetch the dead status of the bridge.
    function fetchDeadStatus() public returns (bool) {
        if (deadState != 0) {
            return true;
        }
        if (exitAdministrator == address(0)) {
            return false; // The dying mechanism is disabled if no exitAdministrator is set.
        }
        uint256 lastUpdateTime = IStateOracle(stateOracle).lastUpdateTime();
        if (lastUpdateTime != 0 && lastUpdateTime < block.timestamp - TIME_UNTIL_DEAD) {
            deadState = IStateOracle(stateOracle).lastState();
            emit BridgeDied();
            return true;
        }
        return false;
    }

    function isOnline() private view returns (bool) {
        if (deadState != 0) {
            return false;
        }
        return IStateOracle(stateOracle).lastUpdateTime() >= block.timestamp - TIME_UNTIL_OFFLINE;
    }

    /// Get the last state root that is valid for the token deposit.
    function lastValidState() private view returns (bytes32) {
        if (deadState != 0) {
            return deadState;
        }
        return IStateOracle(stateOracle).lastState();
    }

    /// Set new proof verifier (callable by UpdateManager)
    function setProofVerifier(address _proofVerifier) external onlyOwner {
        proofVerifier = _proofVerifier;
        emit ProofVerifierSet(_proofVerifier);
    }

    /// Set new exit administrator (callable by UpdateManager)
    function setExitAdministrator(address _exitAdministrator) external onlyOwner {
        exitAdministrator = _exitAdministrator;
        emit ExitAdministratorSet(_exitAdministrator);
    }

}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

import {ContextUpgradeable} from "../utils/ContextUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is set to the address provided by the deployer. This can
 * later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
    /// @custom:storage-location erc7201:openzeppelin.storage.Ownable
    struct OwnableStorage {
        address _owner;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Ownable")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant OwnableStorageLocation = 0x9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300;

    function _getOwnableStorage() private pure returns (OwnableStorage storage $) {
        assembly {
            $.slot := OwnableStorageLocation
        }
    }

    /**
     * @dev The caller account is not authorized to perform an operation.
     */
    error OwnableUnauthorizedAccount(address account);

    /**
     * @dev The owner is not a valid owner account. (eg. `address(0)`)
     */
    error OwnableInvalidOwner(address owner);

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    function __Ownable_init(address initialOwner) internal onlyInitializing {
        __Ownable_init_unchained(initialOwner);
    }

    function __Ownable_init_unchained(address initialOwner) internal onlyInitializing {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        OwnableStorage storage $ = _getOwnableStorage();
        return $._owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        OwnableStorage storage $ = _getOwnableStorage();
        address oldOwner = $._owner;
        $._owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol)

pragma solidity ^0.8.20;

/**
 * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
 * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
 * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
 * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
 *
 * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
 * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
 * case an upgrade adds a module that needs to be initialized.
 *
 * For example:
 *
 * [.hljs-theme-light.nopadding]
 * ```solidity
 * contract MyToken is ERC20Upgradeable {
 *     function initialize() initializer public {
 *         __ERC20_init("MyToken", "MTK");
 *     }
 * }
 *
 * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
 *     function initializeV2() reinitializer(2) public {
 *         __ERC20Permit_init("MyToken");
 *     }
 * }
 * ```
 *
 * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
 * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
 *
 * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
 * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
 *
 * [CAUTION]
 * ====
 * Avoid leaving a contract uninitialized.
 *
 * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
 * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
 * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
 *
 * [.hljs-theme-light.nopadding]
 * ```
 * /// @custom:oz-upgrades-unsafe-allow constructor
 * constructor() {
 *     _disableInitializers();
 * }
 * ```
 * ====
 */
abstract contract Initializable {
    /**
     * @dev Storage of the initializable contract.
     *
     * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions
     * when using with upgradeable contracts.
     *
     * @custom:storage-location erc7201:openzeppelin.storage.Initializable
     */
    struct InitializableStorage {
        /**
         * @dev Indicates that the contract has been initialized.
         */
        uint64 _initialized;
        /**
         * @dev Indicates that the contract is in the process of being initialized.
         */
        bool _initializing;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;

    /**
     * @dev The contract is already initialized.
     */
    error InvalidInitialization();

    /**
     * @dev The contract is not initializing.
     */
    error NotInitializing();

    /**
     * @dev Triggered when the contract has been initialized or reinitialized.
     */
    event Initialized(uint64 version);

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts.
     *
     * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any
     * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in
     * production.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        // solhint-disable-next-line var-name-mixedcase
        InitializableStorage storage $ = _getInitializableStorage();

        // Cache values to avoid duplicated sloads
        bool isTopLevelCall = !$._initializing;
        uint64 initialized = $._initialized;

        // Allowed calls:
        // - initialSetup: the contract is not in the initializing state and no previous version was
        //                 initialized
        // - construction: the contract is initialized at version 1 (no reininitialization) and the
        //                 current contract is just being deployed
        bool initialSetup = initialized == 0 && isTopLevelCall;
        bool construction = initialized == 1 && address(this).code.length == 0;

        if (!initialSetup && !construction) {
            revert InvalidInitialization();
        }
        $._initialized = 1;
        if (isTopLevelCall) {
            $._initializing = true;
        }
        _;
        if (isTopLevelCall) {
            $._initializing = false;
            emit Initialized(1);
        }
    }

    /**
     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
     * used to initialize parent contracts.
     *
     * A reinitializer may be used after the original initialization step. This is essential to configure modules that
     * are added through upgrades and that require initialization.
     *
     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
     * cannot be nested. If one is invoked in the context of another, execution will revert.
     *
     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
     * a contract, executing them in the right order is up to the developer or operator.
     *
     * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint64 version) {
        // solhint-disable-next-line var-name-mixedcase
        InitializableStorage storage $ = _getInitializableStorage();

        if ($._initializing || $._initialized >= version) {
            revert InvalidInitialization();
        }
        $._initialized = version;
        $._initializing = true;
        _;
        $._initializing = false;
        emit Initialized(version);
    }

    /**
     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
     * {initializer} and {reinitializer} modifiers, directly or indirectly.
     */
    modifier onlyInitializing() {
        _checkInitializing();
        _;
    }

    /**
     * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.
     */
    function _checkInitializing() internal view virtual {
        if (!_isInitializing()) {
            revert NotInitializing();
        }
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     *
     * Emits an {Initialized} event the first time it is successfully executed.
     */
    function _disableInitializers() internal virtual {
        // solhint-disable-next-line var-name-mixedcase
        InitializableStorage storage $ = _getInitializableStorage();

        if ($._initializing) {
            revert InvalidInitialization();
        }
        if ($._initialized != type(uint64).max) {
            $._initialized = type(uint64).max;
            emit Initialized(type(uint64).max);
        }
    }

    /**
     * @dev Returns the highest version that has been initialized. See {reinitializer}.
     */
    function _getInitializedVersion() internal view returns (uint64) {
        return _getInitializableStorage()._initialized;
    }

    /**
     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
     */
    function _isInitializing() internal view returns (bool) {
        return _getInitializableStorage()._initializing;
    }

    /**
     * @dev Returns a pointer to the storage namespace.
     */
    // solhint-disable-next-line var-name-mixedcase
    function _getInitializableStorage() private pure returns (InitializableStorage storage $) {
        assembly {
            $.slot := INITIALIZABLE_STORAGE
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (proxy/utils/UUPSUpgradeable.sol)

pragma solidity ^0.8.20;

import {IERC1822Proxiable} from "@openzeppelin/contracts/interfaces/draft-IERC1822.sol";
import {ERC1967Utils} from "@openzeppelin/contracts/proxy/ERC1967/ERC1967Utils.sol";
import {Initializable} from "./Initializable.sol";

/**
 * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
 * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
 *
 * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
 * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
 * `UUPSUpgradeable` with a custom implementation of upgrades.
 *
 * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
 */
abstract contract UUPSUpgradeable is Initializable, IERC1822Proxiable {
    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
    address private immutable __self = address(this);

    /**
     * @dev The version of the upgrade interface of the contract. If this getter is missing, both `upgradeTo(address)`
     * and `upgradeToAndCall(address,bytes)` are present, and `upgradeTo` must be used if no function should be called,
     * while `upgradeToAndCall` will invoke the `receive` function if the second argument is the empty byte string.
     * If the getter returns `"5.0.0"`, only `upgradeToAndCall(address,bytes)` is present, and the second argument must
     * be the empty byte string if no function should be called, making it impossible to invoke the `receive` function
     * during an upgrade.
     */
    string public constant UPGRADE_INTERFACE_VERSION = "5.0.0";

    /**
     * @dev The call is from an unauthorized context.
     */
    error UUPSUnauthorizedCallContext();

    /**
     * @dev The storage `slot` is unsupported as a UUID.
     */
    error UUPSUnsupportedProxiableUUID(bytes32 slot);

    /**
     * @dev Check that the execution is being performed through a delegatecall call and that the execution context is
     * a proxy contract with an implementation (as defined in ERC-1967) pointing to self. This should only be the case
     * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
     * function through ERC-1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
     * fail.
     */
    modifier onlyProxy() {
        _checkProxy();
        _;
    }

    /**
     * @dev Check that the execution is not being performed through a delegate call. This allows a function to be
     * callable on the implementing contract but not through proxies.
     */
    modifier notDelegated() {
        _checkNotDelegated();
        _;
    }

    function __UUPSUpgradeable_init() internal onlyInitializing {
    }

    function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
    }
    /**
     * @dev Implementation of the ERC-1822 {proxiableUUID} function. This returns the storage slot used by the
     * implementation. It is used to validate the implementation's compatibility when performing an upgrade.
     *
     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
     * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
     */
    function proxiableUUID() external view virtual notDelegated returns (bytes32) {
        return ERC1967Utils.IMPLEMENTATION_SLOT;
    }

    /**
     * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
     * encoded in `data`.
     *
     * Calls {_authorizeUpgrade}.
     *
     * Emits an {Upgraded} event.
     *
     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall
     */
    function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
        _authorizeUpgrade(newImplementation);
        _upgradeToAndCallUUPS(newImplementation, data);
    }

    /**
     * @dev Reverts if the execution is not performed via delegatecall or the execution
     * context is not of a proxy with an ERC-1967 compliant implementation pointing to self.
     * See {_onlyProxy}.
     */
    function _checkProxy() internal view virtual {
        if (
            address(this) == __self || // Must be called through delegatecall
            ERC1967Utils.getImplementation() != __self // Must be called through an active proxy
        ) {
            revert UUPSUnauthorizedCallContext();
        }
    }

    /**
     * @dev Reverts if the execution is performed via delegatecall.
     * See {notDelegated}.
     */
    function _checkNotDelegated() internal view virtual {
        if (address(this) != __self) {
            // Must not be called through delegatecall
            revert UUPSUnauthorizedCallContext();
        }
    }

    /**
     * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
     * {upgradeToAndCall}.
     *
     * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
     *
     * ```solidity
     * function _authorizeUpgrade(address) internal onlyOwner {}
     * ```
     */
    function _authorizeUpgrade(address newImplementation) internal virtual;

    /**
     * @dev Performs an implementation upgrade with a security check for UUPS proxies, and additional setup call.
     *
     * As a security check, {proxiableUUID} is invoked in the new implementation, and the return value
     * is expected to be the implementation slot in ERC-1967.
     *
     * Emits an {IERC1967-Upgraded} event.
     */
    function _upgradeToAndCallUUPS(address newImplementation, bytes memory data) private {
        try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
            if (slot != ERC1967Utils.IMPLEMENTATION_SLOT) {
                revert UUPSUnsupportedProxiableUUID(slot);
            }
            ERC1967Utils.upgradeToAndCall(newImplementation, data);
        } catch {
            // The implementation is not UUPS
            revert ERC1967Utils.ERC1967InvalidImplementation(newImplementation);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)

pragma solidity ^0.8.20;
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @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 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 ContextUpgradeable is Initializable {
    function __Context_init() internal onlyInitializing {
    }

    function __Context_init_unchained() internal onlyInitializing {
    }
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }

    function _contextSuffixLength() internal view virtual returns (uint256) {
        return 0;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/ReentrancyGuardTransient.sol)

pragma solidity ^0.8.24;

import {TransientSlot} from "@openzeppelin/contracts/utils/TransientSlot.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @dev Variant of {ReentrancyGuard} that uses transient storage.
 *
 * NOTE: This variant only works on networks where EIP-1153 is available.
 *
 * _Available since v5.1._
 */
abstract contract ReentrancyGuardTransientUpgradeable is Initializable {
    using TransientSlot for *;

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ReentrancyGuard")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant REENTRANCY_GUARD_STORAGE =
        0x9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00;

    /**
     * @dev Unauthorized reentrant call.
     */
    error ReentrancyGuardReentrantCall();

    /**
     * @dev Prevents a contract from calling itself, directly or indirectly.
     * Calling a `nonReentrant` function from another `nonReentrant`
     * function is not supported. It is possible to prevent this from happening
     * by making the `nonReentrant` function external, and making it call a
     * `private` function that does the actual work.
     */
    modifier nonReentrant() {
        _nonReentrantBefore();
        _;
        _nonReentrantAfter();
    }

    function __ReentrancyGuardTransient_init() internal onlyInitializing {
    }

    function __ReentrancyGuardTransient_init_unchained() internal onlyInitializing {
    }
    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, _status will be NOT_ENTERED
        if (_reentrancyGuardEntered()) {
            revert ReentrancyGuardReentrantCall();
        }

        // Any calls to nonReentrant after this point will fail
        REENTRANCY_GUARD_STORAGE.asBoolean().tstore(true);
    }

    function _nonReentrantAfter() private {
        REENTRANCY_GUARD_STORAGE.asBoolean().tstore(false);
    }

    /**
     * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
     * `nonReentrant` function in the call stack.
     */
    function _reentrancyGuardEntered() internal view returns (bool) {
        return REENTRANCY_GUARD_STORAGE.asBoolean().tload();
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/draft-IERC1822.sol)

pragma solidity ^0.8.20;

/**
 * @dev ERC-1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
 * proxy whose upgrades are fully controlled by the current implementation.
 */
interface IERC1822Proxiable {
    /**
     * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
     * address.
     *
     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
     * function revert if invoked through a proxy.
     */
    function proxiableUUID() external view returns (bytes32);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1363.sol)

pragma solidity ^0.8.20;

import {IERC20} from "./IERC20.sol";
import {IERC165} from "./IERC165.sol";

/**
 * @title IERC1363
 * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].
 *
 * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract
 * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.
 */
interface IERC1363 is IERC20, IERC165 {
    /*
     * Note: the ERC-165 identifier for this interface is 0xb0202a11.
     * 0xb0202a11 ===
     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^
     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^
     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^
     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^
     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^
     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))
     */

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferAndCall(address to, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @param data Additional data with no specified format, sent in call to `to`.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param from The address which you want to send tokens from.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param from The address which you want to send tokens from.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @param data Additional data with no specified format, sent in call to `to`.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.
     * @param spender The address which will spend the funds.
     * @param value The amount of tokens to be spent.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function approveAndCall(address spender, uint256 value) external returns (bool);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.
     * @param spender The address which will spend the funds.
     * @param value The amount of tokens to be spent.
     * @param data Additional data with no specified format, sent in call to `spender`.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../utils/introspection/IERC165.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC1967.sol)

pragma solidity ^0.8.20;

/**
 * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
 */
interface IERC1967 {
    /**
     * @dev Emitted when the implementation is upgraded.
     */
    event Upgraded(address indexed implementation);

    /**
     * @dev Emitted when the admin account has changed.
     */
    event AdminChanged(address previousAdmin, address newAdmin);

    /**
     * @dev Emitted when the beacon is changed.
     */
    event BeaconUpgraded(address indexed beacon);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC20.sol)

pragma solidity ^0.8.20;

import {IERC20} from "../token/ERC20/IERC20.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)

pragma solidity ^0.8.20;

/**
 * @dev This is the interface that {BeaconProxy} expects of its beacon.
 */
interface IBeacon {
    /**
     * @dev Must return an address that can be used as a delegate call target.
     *
     * {UpgradeableBeacon} will check that this address is a contract.
     */
    function implementation() external view returns (address);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (proxy/ERC1967/ERC1967Utils.sol)

pragma solidity ^0.8.21;

import {IBeacon} from "../beacon/IBeacon.sol";
import {IERC1967} from "../../interfaces/IERC1967.sol";
import {Address} from "../../utils/Address.sol";
import {StorageSlot} from "../../utils/StorageSlot.sol";

/**
 * @dev This library provides getters and event emitting update functions for
 * https://eips.ethereum.org/EIPS/eip-1967[ERC-1967] slots.
 */
library ERC1967Utils {
    /**
     * @dev Storage slot with the address of the current implementation.
     * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
     */
    // solhint-disable-next-line private-vars-leading-underscore
    bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;

    /**
     * @dev The `implementation` of the proxy is invalid.
     */
    error ERC1967InvalidImplementation(address implementation);

    /**
     * @dev The `admin` of the proxy is invalid.
     */
    error ERC1967InvalidAdmin(address admin);

    /**
     * @dev The `beacon` of the proxy is invalid.
     */
    error ERC1967InvalidBeacon(address beacon);

    /**
     * @dev An upgrade function sees `msg.value > 0` that may be lost.
     */
    error ERC1967NonPayable();

    /**
     * @dev Returns the current implementation address.
     */
    function getImplementation() internal view returns (address) {
        return StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value;
    }

    /**
     * @dev Stores a new address in the ERC-1967 implementation slot.
     */
    function _setImplementation(address newImplementation) private {
        if (newImplementation.code.length == 0) {
            revert ERC1967InvalidImplementation(newImplementation);
        }
        StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
    }

    /**
     * @dev Performs implementation upgrade with additional setup call if data is nonempty.
     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
     * to avoid stuck value in the contract.
     *
     * Emits an {IERC1967-Upgraded} event.
     */
    function upgradeToAndCall(address newImplementation, bytes memory data) internal {
        _setImplementation(newImplementation);
        emit IERC1967.Upgraded(newImplementation);

        if (data.length > 0) {
            Address.functionDelegateCall(newImplementation, data);
        } else {
            _checkNonPayable();
        }
    }

    /**
     * @dev Storage slot with the admin of the contract.
     * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
     */
    // solhint-disable-next-line private-vars-leading-underscore
    bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;

    /**
     * @dev Returns the current admin.
     *
     * TIP: To get this value clients can read directly from the storage slot shown below (specified by ERC-1967) using
     * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
     * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
     */
    function getAdmin() internal view returns (address) {
        return StorageSlot.getAddressSlot(ADMIN_SLOT).value;
    }

    /**
     * @dev Stores a new address in the ERC-1967 admin slot.
     */
    function _setAdmin(address newAdmin) private {
        if (newAdmin == address(0)) {
            revert ERC1967InvalidAdmin(address(0));
        }
        StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
    }

    /**
     * @dev Changes the admin of the proxy.
     *
     * Emits an {IERC1967-AdminChanged} event.
     */
    function changeAdmin(address newAdmin) internal {
        emit IERC1967.AdminChanged(getAdmin(), newAdmin);
        _setAdmin(newAdmin);
    }

    /**
     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
     * This is the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
     */
    // solhint-disable-next-line private-vars-leading-underscore
    bytes32 internal constant BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;

    /**
     * @dev Returns the current beacon.
     */
    function getBeacon() internal view returns (address) {
        return StorageSlot.getAddressSlot(BEACON_SLOT).value;
    }

    /**
     * @dev Stores a new beacon in the ERC-1967 beacon slot.
     */
    function _setBeacon(address newBeacon) private {
        if (newBeacon.code.length == 0) {
            revert ERC1967InvalidBeacon(newBeacon);
        }

        StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;

        address beaconImplementation = IBeacon(newBeacon).implementation();
        if (beaconImplementation.code.length == 0) {
            revert ERC1967InvalidImplementation(beaconImplementation);
        }
    }

    /**
     * @dev Change the beacon and trigger a setup call if data is nonempty.
     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
     * to avoid stuck value in the contract.
     *
     * Emits an {IERC1967-BeaconUpgraded} event.
     *
     * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
     * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
     * efficiency.
     */
    function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
        _setBeacon(newBeacon);
        emit IERC1967.BeaconUpgraded(newBeacon);

        if (data.length > 0) {
            Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
        } else {
            _checkNonPayable();
        }
    }

    /**
     * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
     * if an upgrade doesn't perform an initialization call.
     */
    function _checkNonPayable() private {
        if (msg.value > 0) {
            revert ERC1967NonPayable();
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC-20 standard as defined in the ERC.
 */
interface IERC20 {
    /**
     * @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);

    /**
     * @dev Returns the value of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the value of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 value) 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 a `value` amount of tokens 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 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the
     * allowance mechanism. `value` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(address from, address to, uint256 value) external returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/utils/SafeERC20.sol)

pragma solidity ^0.8.20;

import {IERC20} from "../IERC20.sol";
import {IERC1363} from "../../../interfaces/IERC1363.sol";
import {Address} from "../../../utils/Address.sol";

/**
 * @title SafeERC20
 * @dev Wrappers around ERC-20 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 {
    /**
     * @dev An operation with an ERC-20 token failed.
     */
    error SafeERC20FailedOperation(address token);

    /**
     * @dev Indicates a failed `decreaseAllowance` request.
     */
    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);

    /**
     * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
     * non-reverting calls are assumed to be successful.
     */
    function safeTransfer(IERC20 token, address to, uint256 value) internal {
        _callOptionalReturn(token, abi.encodeCall(token.transfer, (to, value)));
    }

    /**
     * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
     * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
     */
    function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
        _callOptionalReturn(token, abi.encodeCall(token.transferFrom, (from, to, value)));
    }

    /**
     * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
     * non-reverting calls are assumed to be successful.
     *
     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the "client"
     * smart contract uses ERC-7674 to set temporary allowances, then the "client" smart contract should avoid using
     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract
     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.
     */
    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
        uint256 oldAllowance = token.allowance(address(this), spender);
        forceApprove(token, spender, oldAllowance + value);
    }

    /**
     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no
     * value, non-reverting calls are assumed to be successful.
     *
     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the "client"
     * smart contract uses ERC-7674 to set temporary allowances, then the "client" smart contract should avoid using
     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract
     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.
     */
    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {
        unchecked {
            uint256 currentAllowance = token.allowance(address(this), spender);
            if (currentAllowance < requestedDecrease) {
                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);
            }
            forceApprove(token, spender, currentAllowance - requestedDecrease);
        }
    }

    /**
     * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
     * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval
     * to be set to zero before setting it to a non-zero value, such as USDT.
     *
     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function
     * only sets the "standard" allowance. Any temporary allowance will remain active, in addition to the value being
     * set here.
     */
    function forceApprove(IERC20 token, address spender, uint256 value) internal {
        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));

        if (!_callOptionalReturnBool(token, approvalCall)) {
            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));
            _callOptionalReturn(token, approvalCall);
        }
    }

    /**
     * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no
     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
     * targeting contracts.
     *
     * Reverts if the returned value is other than `true`.
     */
    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {
        if (to.code.length == 0) {
            safeTransfer(token, to, value);
        } else if (!token.transferAndCall(to, value, data)) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target
     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
     * targeting contracts.
     *
     * Reverts if the returned value is other than `true`.
     */
    function transferFromAndCallRelaxed(
        IERC1363 token,
        address from,
        address to,
        uint256 value,
        bytes memory data
    ) internal {
        if (to.code.length == 0) {
            safeTransferFrom(token, from, to, value);
        } else if (!token.transferFromAndCall(from, to, value, data)) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no
     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
     * targeting contracts.
     *
     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.
     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}
     * once without retrying, and relies on the returned value to be true.
     *
     * Reverts if the returned value is other than `true`.
     */
    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {
        if (to.code.length == 0) {
            forceApprove(token, to, value);
        } else if (!token.approveAndCall(to, value, data)) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @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).
     *
     * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.
     */
    function _callOptionalReturn(IERC20 token, bytes memory data) private {
        uint256 returnSize;
        uint256 returnValue;
        assembly ("memory-safe") {
            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
            // bubble errors
            if iszero(success) {
                let ptr := mload(0x40)
                returndatacopy(ptr, 0, returndatasize())
                revert(ptr, returndatasize())
            }
            returnSize := returndatasize()
            returnValue := mload(0)
        }

        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @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).
     *
     * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.
     */
    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
        bool success;
        uint256 returnSize;
        uint256 returnValue;
        assembly ("memory-safe") {
            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
            returnSize := returndatasize()
            returnValue := mload(0)
        }
        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Address.sol)

pragma solidity ^0.8.20;

import {Errors} from "./Errors.sol";

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev There's no code at `target` (it is not a contract).
     */
    error AddressEmptyCode(address target);

    /**
     * @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://consensys.net/diligence/blog/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.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        if (address(this).balance < amount) {
            revert Errors.InsufficientBalance(address(this).balance, amount);
        }

        (bool success, ) = recipient.call{value: amount}("");
        if (!success) {
            revert Errors.FailedCall();
        }
    }

    /**
     * @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 or custom error, it is bubbled
     * up by this function (like regular Solidity function calls). However, if
     * the call reverted with no returned reason, this function reverts with a
     * {Errors.FailedCall} error.
     *
     * 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.
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0);
    }

    /**
     * @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`.
     */
    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
        if (address(this).balance < value) {
            revert Errors.InsufficientBalance(address(this).balance, value);
        }
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, success, returndata);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a delegate call.
     */
    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResultFromTarget(target, success, returndata);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
     * was not a contract or bubbling up the revert reason (falling back to {Errors.FailedCall}) in case
     * of an unsuccessful call.
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata
    ) internal view returns (bytes memory) {
        if (!success) {
            _revert(returndata);
        } else {
            // only check if target is a contract if the call was successful and the return data is empty
            // otherwise we already know that it was a contract
            if (returndata.length == 0 && target.code.length == 0) {
                revert AddressEmptyCode(target);
            }
            return returndata;
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
     * revert reason or with a default {Errors.FailedCall} error.
     */
    function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
        if (!success) {
            _revert(returndata);
        } else {
            return returndata;
        }
    }

    /**
     * @dev Reverts with returndata if present. Otherwise reverts with {Errors.FailedCall}.
     */
    function _revert(bytes memory returndata) private pure {
        // 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
            assembly ("memory-safe") {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert Errors.FailedCall();
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Errors.sol)

pragma solidity ^0.8.20;

/**
 * @dev Collection of common custom errors used in multiple contracts
 *
 * IMPORTANT: Backwards compatibility is not guaranteed in future versions of the library.
 * It is recommended to avoid relying on the error API for critical functionality.
 *
 * _Available since v5.1._
 */
library Errors {
    /**
     * @dev The ETH balance of the account is not enough to perform the operation.
     */
    error InsufficientBalance(uint256 balance, uint256 needed);

    /**
     * @dev A call to an address target failed. The target may have reverted.
     */
    error FailedCall();

    /**
     * @dev The deployment failed.
     */
    error FailedDeployment();

    /**
     * @dev A necessary precompile is missing.
     */
    error MissingPrecompile(address);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC-165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[ERC].
 *
 * 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[ERC 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: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.

pragma solidity ^0.8.20;

/**
 * @dev Library for reading and writing primitive types to specific storage slots.
 *
 * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
 * This library helps with reading and writing to such slots without the need for inline assembly.
 *
 * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
 *
 * Example usage to set ERC-1967 implementation slot:
 * ```solidity
 * contract ERC1967 {
 *     // Define the slot. Alternatively, use the SlotDerivation library to derive the slot.
 *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
 *
 *     function _getImplementation() internal view returns (address) {
 *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
 *     }
 *
 *     function _setImplementation(address newImplementation) internal {
 *         require(newImplementation.code.length > 0);
 *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
 *     }
 * }
 * ```
 *
 * TIP: Consider using this library along with {SlotDerivation}.
 */
library StorageSlot {
    struct AddressSlot {
        address value;
    }

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 value;
    }

    struct Int256Slot {
        int256 value;
    }

    struct StringSlot {
        string value;
    }

    struct BytesSlot {
        bytes value;
    }

    /**
     * @dev Returns an `AddressSlot` with member `value` located at `slot`.
     */
    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns a `BooleanSlot` with member `value` located at `slot`.
     */
    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns a `Bytes32Slot` with member `value` located at `slot`.
     */
    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns a `Uint256Slot` with member `value` located at `slot`.
     */
    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns a `Int256Slot` with member `value` located at `slot`.
     */
    function getInt256Slot(bytes32 slot) internal pure returns (Int256Slot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns a `StringSlot` with member `value` located at `slot`.
     */
    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
     */
    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
        assembly ("memory-safe") {
            r.slot := store.slot
        }
    }

    /**
     * @dev Returns a `BytesSlot` with member `value` located at `slot`.
     */
    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
        assembly ("memory-safe") {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
     */
    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
        assembly ("memory-safe") {
            r.slot := store.slot
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/TransientSlot.sol)
// This file was procedurally generated from scripts/generate/templates/TransientSlot.js.

pragma solidity ^0.8.24;

/**
 * @dev Library for reading and writing value-types to specific transient storage slots.
 *
 * Transient slots are often used to store temporary values that are removed after the current transaction.
 * This library helps with reading and writing to such slots without the need for inline assembly.
 *
 *  * Example reading and writing values using transient storage:
 * ```solidity
 * contract Lock {
 *     using TransientSlot for *;
 *
 *     // Define the slot. Alternatively, use the SlotDerivation library to derive the slot.
 *     bytes32 internal constant _LOCK_SLOT = 0xf4678858b2b588224636b8522b729e7722d32fc491da849ed75b3fdf3c84f542;
 *
 *     modifier locked() {
 *         require(!_LOCK_SLOT.asBoolean().tload());
 *
 *         _LOCK_SLOT.asBoolean().tstore(true);
 *         _;
 *         _LOCK_SLOT.asBoolean().tstore(false);
 *     }
 * }
 * ```
 *
 * TIP: Consider using this library along with {SlotDerivation}.
 */
library TransientSlot {
    /**
     * @dev UDVT that represent a slot holding a address.
     */
    type AddressSlot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a AddressSlot.
     */
    function asAddress(bytes32 slot) internal pure returns (AddressSlot) {
        return AddressSlot.wrap(slot);
    }

    /**
     * @dev UDVT that represent a slot holding a bool.
     */
    type BooleanSlot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a BooleanSlot.
     */
    function asBoolean(bytes32 slot) internal pure returns (BooleanSlot) {
        return BooleanSlot.wrap(slot);
    }

    /**
     * @dev UDVT that represent a slot holding a bytes32.
     */
    type Bytes32Slot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a Bytes32Slot.
     */
    function asBytes32(bytes32 slot) internal pure returns (Bytes32Slot) {
        return Bytes32Slot.wrap(slot);
    }

    /**
     * @dev UDVT that represent a slot holding a uint256.
     */
    type Uint256Slot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a Uint256Slot.
     */
    function asUint256(bytes32 slot) internal pure returns (Uint256Slot) {
        return Uint256Slot.wrap(slot);
    }

    /**
     * @dev UDVT that represent a slot holding a int256.
     */
    type Int256Slot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a Int256Slot.
     */
    function asInt256(bytes32 slot) internal pure returns (Int256Slot) {
        return Int256Slot.wrap(slot);
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(AddressSlot slot) internal view returns (address value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(AddressSlot slot, address value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(BooleanSlot slot) internal view returns (bool value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(BooleanSlot slot, bool value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(Bytes32Slot slot) internal view returns (bytes32 value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(Bytes32Slot slot, bytes32 value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(Uint256Slot slot) internal view returns (uint256 value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(Uint256Slot slot, uint256 value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(Int256Slot slot) internal view returns (int256 value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(Int256Slot slot, int256 value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

import {ITokenPairs} from "./interfaces/ITokenPairs.sol";
import {IMintedBurnableERC20} from "./interfaces/IMintedBurnableERC20.sol";

/// Extension of the TokenDeposit contract adding transition support of bridged EURC to native EURC.
/// @custom:security-contact [email protected]
abstract contract EurcDepositExtension {

    address private constant EURC_ADDRESS_L1 = 0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c;
    bytes32 public constant EURC_BURN_PREPARER_ROLE = keccak256("EURC_BURN_PREPARER_ROLE");

    ITokenPairs private immutable tokenPairs; // TokenPairs contract

    uint256 private eurcToBurn;
    address private eurcBurner;

    event BurningEurcPrepared(address burner, uint256 amount);

    constructor(address _tokenPairs) {
        require(_tokenPairs != address(0), "TokenPairs not set");
        tokenPairs = ITokenPairs(_tokenPairs);
    }

    /// Burn EURC in the contract. To be called by Circle.
    /// Burning must be prepared first by calling prepareBurningEURC().
    /// See https://github.com/circlefin/stablecoin-evm/blob/release-2024-06-21T005221/doc/bridged_USDC_standard.md
    function burnLockedEURC() external {
        require(msg.sender == eurcBurner, "Not EURC burner");
        uint256 amount = eurcToBurn;
        eurcToBurn = 0;
        IMintedBurnableERC20(EURC_ADDRESS_L1).burn(amount);
    }

    /// Prepare burning EURC in the contract. To be called by Sonic team.
    /// The EURC pair must be terminated first on both networks and the caller needs to have appropriate role assigned.
    /// @param burner The address defined by Circle allowed to call burnLockedEURC()
    /// @param amount The total supply of bridged EURC on the Sonic network - to by burned by burnLockedEURC() call.
    function prepareBurningEURC(address burner, uint256 amount) external {
        require(tokenPairs.originalToMinted(EURC_ADDRESS_L1) != address(0), "EURC not registered yet");
        require(tokenPairs.originalToMintedTerminable(EURC_ADDRESS_L1) == address(0), "EURC not terminated");
        require(tokenPairs.hasRole(EURC_BURN_PREPARER_ROLE, msg.sender), "Not burn preparer");
        eurcBurner = burner;
        eurcToBurn = amount;
        emit BurningEurcPrepared(burner, amount);
    }

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

/// Minted ERC-20 tokens represents an Ethereum ERC-20 tokens on L2.
/// @custom:security-contact [email protected]
interface IMintedBurnableERC20 {

    /**
     * @dev Mint `amount` of tokens to given `account`.
     */
    function mint(address account, uint256 amount) external returns (bool);

    /**
     * @dev Destroys a `value` amount of tokens from the caller.
     */
    function burn(uint256 value) external;

    /**
     * @dev Destroys a `value` amount of tokens from `account`, deducting from the caller's allowance.
     *
     * Requirements:
     *
     * - the caller must have allowance for ``accounts``'s tokens of at least `value`.
     */
    function burnFrom(address account, uint256 value) external;

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

/// Proof verifier allows to validate witness proof about a storage slot value on a different chain.
interface IProofVerifier {

    /// Verify witness proof - proof about storage slot value on a different chain.
    /// Reverts if the slot value does not match the expected value or if the proof is invalid.
    function verifyProof(address contractAddress, bytes32 slotIndex, bytes32 expectedValue, bytes32 stateRoot, bytes calldata proof) external view;

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

/// Proving contract represents a contract which use the proof verifier.
/// Used for updating the proof verifier address.
interface IProvingContract {
    function proofVerifier() external view returns(address);
    function setProofVerifier(address proofVerifier) external;
    function setExitAdministrator(address exitAdministrator) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

/// State oracle provides the hash of a different chain state.
interface IStateOracle {
    function lastState() external view returns (bytes32);
    function lastBlockNum() external view returns (uint256);
    function lastUpdateTime() external view returns (uint256);
    function chainId() external view returns (uint256);

    function update(uint256 blockNum, bytes32 stateRoot) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

/// Interface of a token deposit manageable (in case of the bridge death) by ExitAdministrator.
interface ITokenDeposit {
    function withdrawWhileDead(address recipient, address token, uint256 amount) external;
    function fetchDeadStatus() external returns (bool);
    function deadState() external view returns (bytes32);
    function proofVerifier() external view returns (address);
    function tokenPairs() external view returns (address);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

// The token pairs registry maps Ethereum ERC-20 tokens to L2 tokens minted by the bridge.
interface ITokenPairs {
    /// Map Ethereum token to L2 token - pairs can be only added into this mapping.
    function originalToMinted(address) external view returns (address);

    /// Map Ethereum token to L2 token - pairs can be removed from here to block new transfers.
    function originalToMintedTerminable(address) external view returns (address);

    /// Map L2 token to Ethereum token - pairs can be only added into this mapping.
    function mintedToOriginal(address) external view returns (address);

    /// Check if the account has given role - allows to use TokenPairs as an AccessManager for USDC burning ops.
    function hasRole(bytes32 role, address account) external view returns (bool);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

import {ITokenPairs} from "./interfaces/ITokenPairs.sol";
import {IMintedBurnableERC20} from "./interfaces/IMintedBurnableERC20.sol";

/// Extension of the TokenDeposit contract adding transition support of bridged USDC to native USDC.
/// @custom:security-contact [email protected]
abstract contract UsdcDepositExtension {

    address private constant USDC_ADDRESS_L1 = 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48;
    bytes32 public constant USDC_BURN_PREPARER_ROLE = keccak256("USDC_BURN_PREPARER_ROLE");

    ITokenPairs private immutable tokenPairs; // TokenPairs contract

    uint256 private usdcToBurn;
    address private usdcBurner;

    event BurningUsdcPrepared(address burner, uint256 amount);

    constructor(address _tokenPairs) {
        require(_tokenPairs != address(0), "TokenPairs not set");
        tokenPairs = ITokenPairs(_tokenPairs);
    }

    /// Burn USDC in the contract. To be called by Circle.
    /// Burning must be prepared first by calling prepareBurningUSDC().
    /// See https://github.com/circlefin/stablecoin-evm/blob/release-2024-06-21T005221/doc/bridged_USDC_standard.md
    function burnLockedUSDC() external {
        require(msg.sender == usdcBurner, "Not USDC burner");
        uint256 amount = usdcToBurn;
        usdcToBurn = 0;
        IMintedBurnableERC20(USDC_ADDRESS_L1).burn(amount);
    }

    /// Prepare burning USDC in the contract. To be called by Sonic team.
    /// The USDC pair must be terminated first on both networks and the caller needs to have appropriate role assigned.
    /// @param burner The address defined by Circle allowed to call burnLockedUSDC()
    /// @param amount The total supply of bridged USDC on the Sonic network - to by burned by burnLockedUSDC() call.
    function prepareBurningUSDC(address burner, uint256 amount) external {
        require(tokenPairs.originalToMinted(USDC_ADDRESS_L1) != address(0), "USDC not registered yet");
        require(tokenPairs.originalToMintedTerminable(USDC_ADDRESS_L1) == address(0), "USDC not terminated");
        require(tokenPairs.hasRole(USDC_BURN_PREPARER_ROLE, msg.sender), "Not burn preparer");
        usdcBurner = burner;
        usdcToBurn = amount;
        emit BurningUsdcPrepared(burner, amount);
    }

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.27;

import {ITokenPairs} from "./interfaces/ITokenPairs.sol";
import {IMintedBurnableERC20} from "./interfaces/IMintedBurnableERC20.sol";

/// Extension of the TokenDeposit contract adding transition support of bridged USDT to native USDT.
/// @custom:security-contact [email protected]
abstract contract UsdtDepositExtension {

    address private constant USDT_ADDRESS_L1 = 0xdAC17F958D2ee523a2206206994597C13D831ec7;
    bytes32 public constant USDT_BURN_PREPARER_ROLE = keccak256("USDT_BURN_PREPARER_ROLE");

    ITokenPairs private immutable tokenPairs; // TokenPairs contract

    uint256 private usdtToBurn;
    address private usdtBurner;

    event BurningUsdtPrepared(address burner, uint256 amount);

    constructor(address _tokenPairs) {
        require(_tokenPairs != address(0), "TokenPairs not set");
        tokenPairs = ITokenPairs(_tokenPairs);
    }

    /// Burn USDT in the contract. To be called by Tether.
    /// Burning must be prepared first by calling prepareBurningUSDT().
    function burnLockedUSDT() external {
        require(msg.sender == usdtBurner, "Not USDT burner");
        uint256 amount = usdtToBurn;
        usdtToBurn = 0;
        IMintedBurnableERC20(USDT_ADDRESS_L1).burn(amount);
    }

    /// Prepare burning USDT in the contract. To be called by Sonic team.
    /// The USDT pair must be terminated first on both networks and the caller needs to have appropriate role assigned.
    /// @param burner The address defined by Tether allowed to call burnLockedUSDT()
    /// @param amount The total supply of bridged USDT on the Sonic network - to by burned by burnLockedUSDT() call.
    function prepareBurningUSDT(address burner, uint256 amount) external {
        require(tokenPairs.originalToMinted(USDT_ADDRESS_L1) != address(0), "USDT not registered yet");
        require(tokenPairs.originalToMintedTerminable(USDT_ADDRESS_L1) == address(0), "USDT not terminated");
        require(tokenPairs.hasRole(USDT_BURN_PREPARER_ROLE, msg.sender), "Not burn preparer");
        usdtBurner = burner;
        usdtToBurn = amount;
        emit BurningUsdtPrepared(burner, amount);
    }

}

{
  "evmVersion": "cancun",
  "optimizer": {
    "enabled": true,
    "runs": 200
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"_bridge","type":"address"},{"internalType":"address","name":"_tokenPairs","type":"address"},{"internalType":"address","name":"_stateOracle","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[{"internalType":"address","name":"implementation","type":"address"}],"name":"ERC1967InvalidImplementation","type":"error"},{"inputs":[],"name":"ERC1967NonPayable","type":"error"},{"inputs":[],"name":"FailedCall","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"inputs":[],"name":"UUPSUnauthorizedCallContext","type":"error"},{"inputs":[{"internalType":"bytes32","name":"slot","type":"bytes32"}],"name":"UUPSUnsupportedProxiableUUID","type":"error"},{"anonymous":false,"inputs":[],"name":"BridgeDied","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"burner","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"BurningEurcPrepared","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"burner","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"BurningUsdcPrepared","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"burner","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"BurningUsdtPrepared","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"CancelledWhileDead","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Claim","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"_exitAdministrator","type":"address"}],"name":"ExitAdministratorSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"proofVerifier","type":"address"}],"name":"ProofVerifierSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"WithdrawnWhileDead","type":"event"},{"inputs":[],"name":"EURC_BURN_PREPARER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"UPGRADE_INTERFACE_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"USDC_BURN_PREPARER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"USDT_BURN_PREPARER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"bridge","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"burnLockedEURC","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"burnLockedUSDC","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"burnLockedUSDT","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"proof","type":"bytes"}],"name":"cancelDepositWhileDead","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"proof","type":"bytes"}],"name":"claim","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"withdrawalId","type":"uint256"}],"name":"claims","outputs":[{"internalType":"bool","name":"isClaimed","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"deadState","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint96","name":"uid","type":"uint96"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"depositId","type":"uint256"}],"name":"deposits","outputs":[{"internalType":"bytes32","name":"senderTokenAmount","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"exitAdministrator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"fetchDeadStatus","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"getClaimSlotIndex","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"getWithdrawalSlotIndex","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"hash","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"_proofVerifier","type":"address"},{"internalType":"address","name":"_owner","type":"address"},{"internalType":"address","name":"_exitAdministrator","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"burner","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"prepareBurningEURC","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"burner","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"prepareBurningUSDC","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"burner","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"prepareBurningUSDT","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"proofVerifier","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_exitAdministrator","type":"address"}],"name":"setExitAdministrator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_proofVerifier","type":"address"}],"name":"setProofVerifier","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateOracle","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenPairs","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint96","name":"uid","type":"uint96"}],"name":"userOperationId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"recipient","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawWhileDead","outputs":[],"stateMutability":"nonpayable","type":"function"}]

61016060405230608052348015610014575f5ffd5b50604051612eb8380380612eb8833981016040819052610033916102fe565b8180806001600160a01b03811661007e5760405162461bcd60e51b815260206004820152601260248201525f516020612e985f395f51905f5260448201526064015b60405180910390fd5b6001600160a01b0390811660a05281166100c75760405162461bcd60e51b815260206004820152601260248201525f516020612e985f395f51905f526044820152606401610075565b6001600160a01b0390811660c05281166101105760405162461bcd60e51b815260206004820152601260248201525f516020612e985f395f51905f526044820152606401610075565b6001600160a01b0390811660e052831661016c5760405162461bcd60e51b815260206004820152601660248201527f4272696467652061646472657373206e6f7420736574000000000000000000006044820152606401610075565b6001600160a01b0382166101af5760405162461bcd60e51b815260206004820152601260248201525f516020612e985f395f51905f526044820152606401610075565b6001600160a01b0381166102055760405162461bcd60e51b815260206004820152601360248201527f53746174654f7261636c65206e6f7420736574000000000000000000000000006044820152606401610075565b6001600160a01b038084166101005282811661012052811661014052610229610231565b50505061033e565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff16156102815760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b03908116146102e05780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b80516001600160a01b03811681146102f9575f5ffd5b919050565b5f5f5f60608486031215610310575f5ffd5b610319846102e3565b9250610327602085016102e3565b9150610335604085016102e3565b90509250925092565b60805160a05160c05160e051610100516101205161014051612aa06103f85f395f8181610260015281816110920152818161113401528181612058015261229001525f818161021001526116ea01525f818161067b0152818161081c015261155901525f8181610da201528181610e940152610f8401525f818161121f01528181611311015261140101525f81816109ea01528181610adc0152610bcc01525f8181611e9f01528181611ec801526120070152612aa05ff3fe6080604052600436106101fb575f3560e01c80639901614211610113578063c0c53b8b1161009d578063e65e9ed71161006d578063e65e9ed714610637578063e78cea921461066a578063eb8006f71461069d578063eee2c7e1146106bc578063f2fde38b146106d0575f5ffd5b8063c0c53b8b146105bb578063c183bda0146105da578063de133013146105f9578063df6244db14610618575f5ffd5b8063abfd0d40116100e3578063abfd0d401461050b578063ad3cb1cc1461051f578063b02c43d01461055c578063b703ca8514610587578063baac0df0146105a6575f5ffd5b8063990161421461046c578063991b90211461048b5780639f635224146104be578063a888c2cd146104dd575f5ffd5b806369999dd2116101945780638a5e52bb116101645780638a5e52bb146103ba5780638ad1ef0b146103ce5780638affb822146103ed5780638da5cb5b146104115780638f20c36b1461044d575f5ffd5b806369999dd214610349578063715018a6146103685780637d059e4c1461037c5780637fa417b31461039b575f5ffd5b80634f1ef286116101cf5780634f1ef286146102e257806352d1902d146102f75780635eaf52601461030b5780636951588b1461032a575f5ffd5b8062d46014146101ff578063076d27f51461024f578063142a3f671461028257806335a6821c146102c3575b5f5ffd5b34801561020a575f5ffd5b506102327f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020015b60405180910390f35b34801561025a575f5ffd5b506102327f000000000000000000000000000000000000000000000000000000000000000081565b34801561028d575f5ffd5b506102b57fea9b585a6ebd9633ce15a00ac59a64be294805b254faeed18790c2161e44e71a81565b604051908152602001610246565b3480156102ce575f5ffd5b506102b56102dd36600461265d565b6106ef565b6102f56102f03660046126a4565b610724565b005b348015610302575f5ffd5b506102b5610743565b348015610316575f5ffd5b506102f561032536600461276a565b61075e565b348015610335575f5ffd5b506102f56103443660046127fa565b610910565b348015610354575f5ffd5b506102b5610363366004612815565b61096d565b348015610373575f5ffd5b506102f56109a4565b348015610387575f5ffd5b506102f561039636600461282c565b6109b7565b3480156103a6575f5ffd5b50600954610232906001600160a01b031681565b3480156103c5575f5ffd5b506102f5610cb9565b3480156103d9575f5ffd5b506102f56103e836600461282c565b610d6f565b3480156103f8575f5ffd5b5061040161106a565b6040519015158152602001610246565b34801561041c575f5ffd5b507f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b0316610232565b348015610458575f5ffd5b506102f561046736600461282c565b6111ec565b348015610477575f5ffd5b506102f561048636600461276a565b6114e7565b348015610496575f5ffd5b506102b57fcc83783a336c5977a84d3445de8848e96ef07372a420bac3d7f276ab3bcb0b4081565b3480156104c9575f5ffd5b506102f56104d8366004612856565b611658565b3480156104e8575f5ffd5b506104016104f7366004612815565b60086020525f908152604090205460ff1681565b348015610516575f5ffd5b506102f56119a0565b34801561052a575f5ffd5b5061054f604051806040016040528060058152602001640352e302e360dc1b81525081565b6040516102469190612892565b348015610567575f5ffd5b506102b5610576366004612815565b60076020525f908152604090205481565b348015610592575f5ffd5b50600a54610232906001600160a01b031681565b3480156105b1575f5ffd5b506102b5600b5481565b3480156105c6575f5ffd5b506102f56105d53660046128c7565b611a2c565b3480156105e5575f5ffd5b506102f56105f436600461290f565b611bca565b348015610604575f5ffd5b506102b5610613366004612815565b611d0f565b348015610623575f5ffd5b506102f56106323660046127fa565b611d2d565b348015610642575f5ffd5b506102b57f366e34e4dd9cacc5f69a0ea920636c292b34b8951987dd08682365f7701b86f681565b348015610675575f5ffd5b506102327f000000000000000000000000000000000000000000000000000000000000000081565b3480156106a8575f5ffd5b506102b56106b736600461290f565b611d83565b3480156106c7575f5ffd5b506102f5611dcc565b3480156106db575f5ffd5b506102f56106ea3660046127fa565b611e57565b5f61071b6bffffffffffffffffffffffff83166bffffffffffffffffffffffff19606086901b16612940565b90505b92915050565b61072c611e94565b61073582611f38565b61073f8282611f40565b5050565b5f61074c611ffc565b505f516020612a4b5f395f51905f5290565b610769338585611d83565b5f86815260076020526040902054146107c05760405162461bcd60e51b8152602060048201526014602482015273139bc819195c1bdcda5d081d1bc818d85b98d95b60621b60448201526064015b60405180910390fd5b6107c861106a565b6108095760405162461bcd60e51b8152602060048201526012602482015271109c9a5919d9481a5cc81b9bdd081919585960721b60448201526064016107b7565b6009546001600160a01b0316636a5310d07f000000000000000000000000000000000000000000000000000000000000000061084488611d0f565b5f61084d612045565b87876040518763ffffffff1660e01b815260040161087096959493929190612953565b5f6040518083038186803b158015610886575f5ffd5b505afa158015610898573d5f5f3e3d5ffd5b5050505f86815260076020526040812055506108be6001600160a01b03851633856120db565b604080518681526001600160a01b038616602082015290810184905233907f3a6343efe689b69f2bf6fa15c89c2f06f5ef55bbbb1e89aa0df0a4d3b9d2ef219060600160405180910390a25050505050565b61091861213a565b600a80546001600160a01b0319166001600160a01b0383169081179091556040519081527ff252bbb084318b31ee973c824c72d9985dbf8dac7371be00b3d4f712d5ffd66f906020015b60405180910390a150565b60408051602081018390526001918101919091525f906060015b604051602081830303815290604052805190602001209050919050565b6109ac61213a565b6109b55f612195565b565b60405163fe2f9dd760e01b815273a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4860048201525f906001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063fe2f9dd790602401602060405180830381865afa158015610a2f573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a5391906129a5565b6001600160a01b031603610aa95760405162461bcd60e51b815260206004820152601760248201527f55534443206e6f7420726567697374657265642079657400000000000000000060448201526064016107b7565b604051634b0f53e960e01b815273a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4860048201525f906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690634b0f53e990602401602060405180830381865afa158015610b21573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b4591906129a5565b6001600160a01b031614610b915760405162461bcd60e51b81526020600482015260136024820152721554d110c81b9bdd081d195c9b5a5b985d1959606a1b60448201526064016107b7565b604051632474521560e21b81527f366e34e4dd9cacc5f69a0ea920636c292b34b8951987dd08682365f7701b86f660048201523360248201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906391d1485490604401602060405180830381865afa158015610c19573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c3d91906129c0565b610c595760405162461bcd60e51b81526004016107b7906129df565b600180546001600160a01b0319166001600160a01b0384169081179091555f82905560408051918252602082018390527fb47ee5a7063eba721c041c66c9bc757510a4f35361ec729c57fff3709ec9d05691015b60405180910390a15050565b6001546001600160a01b03163314610d055760405162461bcd60e51b815260206004820152600f60248201526e2737ba102aa9a22190313ab93732b960891b60448201526064016107b7565b5f8054908055604051630852cd8d60e31b81526004810182905273a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48906342966c68906024015b5f604051808303815f87803b158015610d56575f5ffd5b505af1158015610d68573d5f5f3e3d5ffd5b5050505050565b60405163fe2f9dd760e01b815273dac17f958d2ee523a2206206994597c13d831ec760048201525f906001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063fe2f9dd790602401602060405180830381865afa158015610de7573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e0b91906129a5565b6001600160a01b031603610e615760405162461bcd60e51b815260206004820152601760248201527f55534454206e6f7420726567697374657265642079657400000000000000000060448201526064016107b7565b604051634b0f53e960e01b815273dac17f958d2ee523a2206206994597c13d831ec760048201525f906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690634b0f53e990602401602060405180830381865afa158015610ed9573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610efd91906129a5565b6001600160a01b031614610f495760405162461bcd60e51b81526020600482015260136024820152721554d115081b9bdd081d195c9b5a5b985d1959606a1b60448201526064016107b7565b604051632474521560e21b81527fcc83783a336c5977a84d3445de8848e96ef07372a420bac3d7f276ab3bcb0b4060048201523360248201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906391d1485490604401602060405180830381865afa158015610fd1573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610ff591906129c0565b6110115760405162461bcd60e51b81526004016107b7906129df565b600580546001600160a01b0319166001600160a01b038416908117909155600482905560408051918252602082018390527fb740908f42082ee9c7c27f28ccc46efeb3cdb3c7c78a1cb922c77d08d7e4c5d59101610cad565b600b545f901561107a5750600190565b600a546001600160a01b031661108f57505f90565b5f7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663c8f33c916040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110ec573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906111109190612a0a565b9050801580159061112d575061112a630107ac0042612a21565b81105b156111e5577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316632df802806040518163ffffffff1660e01b8152600401602060405180830381865afa15801561118e573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906111b29190612a0a565b600b556040517f62d06fdd7cbd752d149eb462b259ed89c5723ec8b3d78342e1613d0976803255905f90a1600191505090565b5f91505090565b60405163fe2f9dd760e01b8152731abaea1f7c830bd89acc67ec4af516284b1bc33c60048201525f906001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063fe2f9dd790602401602060405180830381865afa158015611264573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061128891906129a5565b6001600160a01b0316036112de5760405162461bcd60e51b815260206004820152601760248201527f45555243206e6f7420726567697374657265642079657400000000000000000060448201526064016107b7565b604051634b0f53e960e01b8152731abaea1f7c830bd89acc67ec4af516284b1bc33c60048201525f906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690634b0f53e990602401602060405180830381865afa158015611356573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061137a91906129a5565b6001600160a01b0316146113c65760405162461bcd60e51b815260206004820152601360248201527211555490c81b9bdd081d195c9b5a5b985d1959606a1b60448201526064016107b7565b604051632474521560e21b81527fea9b585a6ebd9633ce15a00ac59a64be294805b254faeed18790c2161e44e71a60048201523360248201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906391d1485490604401602060405180830381865afa15801561144e573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061147291906129c0565b61148e5760405162461bcd60e51b81526004016107b7906129df565b600380546001600160a01b0319166001600160a01b038416908117909155600282905560408051918252602082018390527fed33da0431b812765cb9d4b886f7495cb6f429854b6e530c8e2a10a83776bbe79101610cad565b5f8581526008602052604090205460ff16156115375760405162461bcd60e51b815260206004820152600f60248201526e105b1c9958591e4818db185a5b5959608a1b60448201526064016107b7565b5f611543338686611d83565b6009549091506001600160a01b0316636a5310d07f00000000000000000000000000000000000000000000000000000000000000006115818961096d565b8461158a612045565b88886040518763ffffffff1660e01b81526004016115ad96959493929190612953565b5f6040518083038186803b1580156115c3575f5ffd5b505afa1580156115d5573d5f5f3e3d5ffd5b5050505f878152600860205260409020805460ff19166001179055506116056001600160a01b03861633866120db565b604080518781526001600160a01b038716602082015290810185905233907fa27580a77a01c86ee8598d930ae5f9a0ec6f146c6e0e9e9f50b95bacb33787189060600160405180910390a2505050505050565b611660612205565b5f61166b33856106ef565b5f81815260076020526040902054909150156116c95760405162461bcd60e51b815260206004820152601a60248201527f4465706f73697420696420697320616c7265616479207573656400000000000060448201526064016107b7565b604051634b0f53e960e01b81526001600160a01b0384811660048301525f917f000000000000000000000000000000000000000000000000000000000000000090911690634b0f53e990602401602060405180830381865afa158015611731573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061175591906129a5565b6001600160a01b0316036117a15760405162461bcd60e51b81526020600482015260136024820152722737ba1039bab83837b93a32b2103a37b5b2b760691b60448201526064016107b7565b6117a9612272565b6117e95760405162461bcd60e51b8152602060048201526011602482015270427269646765206973206f66666c696e6560781b60448201526064016107b7565b6040516370a0823160e01b81523060048201525f906001600160a01b038516906370a0823190602401602060405180830381865afa15801561182d573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118519190612a0a565b90506118686001600160a01b038516333086612315565b6040516370a0823160e01b81523060048201525f9082906001600160a01b038716906370a0823190602401602060405180830381865afa1580156118ae573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118d29190612a0a565b6118dc9190612a21565b90505f811161192d5760405162461bcd60e51b815260206004820152601a60248201527f4e6f20746f6b656e732077657265207472616e7366657272656400000000000060448201526064016107b7565b611938338683611d83565b5f848152600760209081526040918290209290925580516001600160a01b0388168152918201839052339185917f2c0f148b435140de488c1b34647f1511c646f7077e87007bacf22ef9977a16d8910160405180910390a350505061199b612354565b505050565b6003546001600160a01b031633146119ec5760405162461bcd60e51b815260206004820152600f60248201526e2737ba1022aaa92190313ab93732b960891b60448201526064016107b7565b600280545f909155604051630852cd8d60e31b815260048101829052731abaea1f7c830bd89acc67ec4af516284b1bc33c906342966c6890602401610d3f565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff16159067ffffffffffffffff165f81158015611a715750825b90505f8267ffffffffffffffff166001148015611a8d5750303b155b905081158015611a9b575080155b15611ab95760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff191660011785558315611ae357845460ff60401b1916600160401b1785555b6001600160a01b038816611b315760405162461bcd60e51b8152602060048201526015602482015274141c9bdbd995995c9a599a595c881b9bdd081cd95d605a1b60448201526064016107b7565b611b3a8761237e565b611b4261238f565b611b4a61238f565b600980546001600160a01b03808b166001600160a01b031992831617909255600a8054928916929091169190911790558315611bc057845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b6001600160a01b038316611c145760405162461bcd60e51b8152602060048201526011602482015270526563697069656e74206973207a65726f60781b60448201526064016107b7565b600a546001600160a01b03163314611c675760405162461bcd60e51b81526020600482015260166024820152752737ba1032bc34ba1030b236b4b734b9ba3930ba37b960511b60448201526064016107b7565b611c6f61106a565b611cb05760405162461bcd60e51b8152602060048201526012602482015271109c9a5919d9481a5cc81b9bdd081919585960721b60448201526064016107b7565b611cc46001600160a01b03831684836120db565b604080516001600160a01b038481168252602082018490528516917fe3528bdf76e36b0132e2b17ecb978120666f4ea8968ad84090a9bdb16ebe51a6910160405180910390a2505050565b60408051602081018390526002918101919091525f90606001610987565b611d3561213a565b600980546001600160a01b0319166001600160a01b0383169081179091556040519081527fa37b8cc6237b398b43a500bcd66f67e927875d57cd10fde544af9cf61a1639e990602001610962565b604080516001600160a01b038086166020830152841691810191909152606081018290525f906080016040516020818303038152906040528051906020012090505b9392505050565b6005546001600160a01b03163314611e185760405162461bcd60e51b815260206004820152600f60248201526e2737ba102aa9a22a10313ab93732b960891b60448201526064016107b7565b600480545f8255604051630852cd8d60e31b81529182018190529073dac17f958d2ee523a2206206994597c13d831ec7906342966c6890602401610d3f565b611e5f61213a565b6001600160a01b038116611e8857604051631e4fbdf760e01b81525f60048201526024016107b7565b611e9181612195565b50565b306001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161480611f1a57507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316611f0e5f516020612a4b5f395f51905f52546001600160a01b031690565b6001600160a01b031614155b156109b55760405163703e46dd60e11b815260040160405180910390fd5b611e9161213a565b816001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015611f9a575060408051601f3d908101601f19168201909252611f9791810190612a0a565b60015b611fc257604051634c9c8ce360e01b81526001600160a01b03831660048201526024016107b7565b5f516020612a4b5f395f51905f528114611ff257604051632a87526960e21b8152600481018290526024016107b7565b61199b8383612397565b306001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146109b55760405163703e46dd60e11b815260040160405180910390fd5b600b545f90156120565750600b5490565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316632df802806040518163ffffffff1660e01b8152600401602060405180830381865afa1580156120b2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906120d69190612a0a565b905090565b6040516001600160a01b0383811660248301526044820183905261199b91859182169063a9059cbb906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b0383818316178352505050506123ec565b3361216c7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b031690565b6001600160a01b0316146109b55760405163118cdaa760e01b81523360048201526024016107b7565b7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c19930080546001600160a01b031981166001600160a01b03848116918217845560405192169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a3505050565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005c1561224557604051633ee5aeb560e01b815260040160405180910390fd5b6109b560017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005b90612458565b600b545f901561228157505f90565b61228e6201518042612a21565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663c8f33c916040518163ffffffff1660e01b8152600401602060405180830381865afa1580156122ea573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061230e9190612a0a565b1015905090565b6040516001600160a01b03848116602483015283811660448301526064820183905261234e9186918216906323b872dd90608401612108565b50505050565b6109b55f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0061226c565b61238661245f565b611e91816124a8565b6109b561245f565b6123a0826124b0565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b905f90a28051156123e45761199b8282612513565b61073f612585565b5f5f60205f8451602086015f885af18061240b576040513d5f823e3d81fd5b50505f513d9150811561242257806001141561242f565b6001600160a01b0384163b155b1561234e57604051635274afe760e01b81526001600160a01b03851660048201526024016107b7565b80825d5050565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff166109b557604051631afcd79f60e31b815260040160405180910390fd5b611e5f61245f565b806001600160a01b03163b5f036124e557604051634c9c8ce360e01b81526001600160a01b03821660048201526024016107b7565b5f516020612a4b5f395f51905f5280546001600160a01b0319166001600160a01b0392909216919091179055565b60605f5f846001600160a01b03168460405161252f9190612a34565b5f60405180830381855af49150503d805f8114612567576040519150601f19603f3d011682016040523d82523d5f602084013e61256c565b606091505b509150915061257c8583836125a4565b95945050505050565b34156109b55760405163b398979f60e01b815260040160405180910390fd5b6060826125b9576125b482612600565b611dc5565b81511580156125d057506001600160a01b0384163b155b156125f957604051639996b31560e01b81526001600160a01b03851660048201526024016107b7565b5080611dc5565b8051156126105780518082602001fd5b60405163d6bda27560e01b815260040160405180910390fd5b6001600160a01b0381168114611e91575f5ffd5b80356bffffffffffffffffffffffff81168114612658575f5ffd5b919050565b5f5f6040838503121561266e575f5ffd5b823561267981612629565b91506126876020840161263d565b90509250929050565b634e487b7160e01b5f52604160045260245ffd5b5f5f604083850312156126b5575f5ffd5b82356126c081612629565b9150602083013567ffffffffffffffff8111156126db575f5ffd5b8301601f810185136126eb575f5ffd5b803567ffffffffffffffff81111561270557612705612690565b604051601f8201601f19908116603f0116810167ffffffffffffffff8111828210171561273457612734612690565b60405281815282820160200187101561274b575f5ffd5b816020840160208301375f602083830101528093505050509250929050565b5f5f5f5f5f6080868803121561277e575f5ffd5b85359450602086013561279081612629565b935060408601359250606086013567ffffffffffffffff8111156127b2575f5ffd5b8601601f810188136127c2575f5ffd5b803567ffffffffffffffff8111156127d8575f5ffd5b8860208284010111156127e9575f5ffd5b959894975092955050506020019190565b5f6020828403121561280a575f5ffd5b8135611dc581612629565b5f60208284031215612825575f5ffd5b5035919050565b5f5f6040838503121561283d575f5ffd5b823561284881612629565b946020939093013593505050565b5f5f5f60608486031215612868575f5ffd5b6128718461263d565b9250602084013561288181612629565b929592945050506040919091013590565b602081525f82518060208401528060208501604085015e5f604082850101526040601f19601f83011684010191505092915050565b5f5f5f606084860312156128d9575f5ffd5b83356128e481612629565b925060208401356128f481612629565b9150604084013561290481612629565b809150509250925092565b5f5f5f60608486031215612921575f5ffd5b833561287181612629565b634e487b7160e01b5f52601160045260245ffd5b8082018082111561071e5761071e61292c565b60018060a01b038716815285602082015284604082015283606082015260a060808201528160a0820152818360c08301375f81830160c090810191909152601f909201601f1916010195945050505050565b5f602082840312156129b5575f5ffd5b8151611dc581612629565b5f602082840312156129d0575f5ffd5b81518015158114611dc5575f5ffd5b6020808252601190820152702737ba10313ab93710383932b830b932b960791b604082015260600190565b5f60208284031215612a1a575f5ffd5b5051919050565b8181038181111561071e5761071e61292c565b5f82518060208501845e5f92019182525091905056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbca2646970667358221220823629f929e6d712481540ef92e4968a2e806965604cb2f38d2717cd3e8c6efc64736f6c634300081b0033546f6b656e5061697273206e6f742073657400000000000000000000000000000000000000000000000000009ef7629f9b930168b76283add7120777b3c895b3000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e4000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f

0x6080604052600436106101fb575f3560e01c80639901614211610113578063c0c53b8b1161009d578063e65e9ed71161006d578063e65e9ed714610637578063e78cea921461066a578063eb8006f71461069d578063eee2c7e1146106bc578063f2fde38b146106d0575f5ffd5b8063c0c53b8b146105bb578063c183bda0146105da578063de133013146105f9578063df6244db14610618575f5ffd5b8063abfd0d40116100e3578063abfd0d401461050b578063ad3cb1cc1461051f578063b02c43d01461055c578063b703ca8514610587578063baac0df0146105a6575f5ffd5b8063990161421461046c578063991b90211461048b5780639f635224146104be578063a888c2cd146104dd575f5ffd5b806369999dd2116101945780638a5e52bb116101645780638a5e52bb146103ba5780638ad1ef0b146103ce5780638affb822146103ed5780638da5cb5b146104115780638f20c36b1461044d575f5ffd5b806369999dd214610349578063715018a6146103685780637d059e4c1461037c5780637fa417b31461039b575f5ffd5b80634f1ef286116101cf5780634f1ef286146102e257806352d1902d146102f75780635eaf52601461030b5780636951588b1461032a575f5ffd5b8062d46014146101ff578063076d27f51461024f578063142a3f671461028257806335a6821c146102c3575b5f5ffd5b34801561020a575f5ffd5b506102327f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e481565b6040516001600160a01b0390911681526020015b60405180910390f35b34801561025a575f5ffd5b506102327f000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f81565b34801561028d575f5ffd5b506102b57fea9b585a6ebd9633ce15a00ac59a64be294805b254faeed18790c2161e44e71a81565b604051908152602001610246565b3480156102ce575f5ffd5b506102b56102dd36600461265d565b6106ef565b6102f56102f03660046126a4565b610724565b005b348015610302575f5ffd5b506102b5610743565b348015610316575f5ffd5b506102f561032536600461276a565b61075e565b348015610335575f5ffd5b506102f56103443660046127fa565b610910565b348015610354575f5ffd5b506102b5610363366004612815565b61096d565b348015610373575f5ffd5b506102f56109a4565b348015610387575f5ffd5b506102f561039636600461282c565b6109b7565b3480156103a6575f5ffd5b50600954610232906001600160a01b031681565b3480156103c5575f5ffd5b506102f5610cb9565b3480156103d9575f5ffd5b506102f56103e836600461282c565b610d6f565b3480156103f8575f5ffd5b5061040161106a565b6040519015158152602001610246565b34801561041c575f5ffd5b507f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b0316610232565b348015610458575f5ffd5b506102f561046736600461282c565b6111ec565b348015610477575f5ffd5b506102f561048636600461276a565b6114e7565b348015610496575f5ffd5b506102b57fcc83783a336c5977a84d3445de8848e96ef07372a420bac3d7f276ab3bcb0b4081565b3480156104c9575f5ffd5b506102f56104d8366004612856565b611658565b3480156104e8575f5ffd5b506104016104f7366004612815565b60086020525f908152604090205460ff1681565b348015610516575f5ffd5b506102f56119a0565b34801561052a575f5ffd5b5061054f604051806040016040528060058152602001640352e302e360dc1b81525081565b6040516102469190612892565b348015610567575f5ffd5b506102b5610576366004612815565b60076020525f908152604090205481565b348015610592575f5ffd5b50600a54610232906001600160a01b031681565b3480156105b1575f5ffd5b506102b5600b5481565b3480156105c6575f5ffd5b506102f56105d53660046128c7565b611a2c565b3480156105e5575f5ffd5b506102f56105f436600461290f565b611bca565b348015610604575f5ffd5b506102b5610613366004612815565b611d0f565b348015610623575f5ffd5b506102f56106323660046127fa565b611d2d565b348015610642575f5ffd5b506102b57f366e34e4dd9cacc5f69a0ea920636c292b34b8951987dd08682365f7701b86f681565b348015610675575f5ffd5b506102327f0000000000000000000000009ef7629f9b930168b76283add7120777b3c895b381565b3480156106a8575f5ffd5b506102b56106b736600461290f565b611d83565b3480156106c7575f5ffd5b506102f5611dcc565b3480156106db575f5ffd5b506102f56106ea3660046127fa565b611e57565b5f61071b6bffffffffffffffffffffffff83166bffffffffffffffffffffffff19606086901b16612940565b90505b92915050565b61072c611e94565b61073582611f38565b61073f8282611f40565b5050565b5f61074c611ffc565b505f516020612a4b5f395f51905f5290565b610769338585611d83565b5f86815260076020526040902054146107c05760405162461bcd60e51b8152602060048201526014602482015273139bc819195c1bdcda5d081d1bc818d85b98d95b60621b60448201526064015b60405180910390fd5b6107c861106a565b6108095760405162461bcd60e51b8152602060048201526012602482015271109c9a5919d9481a5cc81b9bdd081919585960721b60448201526064016107b7565b6009546001600160a01b0316636a5310d07f0000000000000000000000009ef7629f9b930168b76283add7120777b3c895b361084488611d0f565b5f61084d612045565b87876040518763ffffffff1660e01b815260040161087096959493929190612953565b5f6040518083038186803b158015610886575f5ffd5b505afa158015610898573d5f5f3e3d5ffd5b5050505f86815260076020526040812055506108be6001600160a01b03851633856120db565b604080518681526001600160a01b038616602082015290810184905233907f3a6343efe689b69f2bf6fa15c89c2f06f5ef55bbbb1e89aa0df0a4d3b9d2ef219060600160405180910390a25050505050565b61091861213a565b600a80546001600160a01b0319166001600160a01b0383169081179091556040519081527ff252bbb084318b31ee973c824c72d9985dbf8dac7371be00b3d4f712d5ffd66f906020015b60405180910390a150565b60408051602081018390526001918101919091525f906060015b604051602081830303815290604052805190602001209050919050565b6109ac61213a565b6109b55f612195565b565b60405163fe2f9dd760e01b815273a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4860048201525f906001600160a01b037f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e4169063fe2f9dd790602401602060405180830381865afa158015610a2f573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610a5391906129a5565b6001600160a01b031603610aa95760405162461bcd60e51b815260206004820152601760248201527f55534443206e6f7420726567697374657265642079657400000000000000000060448201526064016107b7565b604051634b0f53e960e01b815273a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4860048201525f906001600160a01b037f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e41690634b0f53e990602401602060405180830381865afa158015610b21573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b4591906129a5565b6001600160a01b031614610b915760405162461bcd60e51b81526020600482015260136024820152721554d110c81b9bdd081d195c9b5a5b985d1959606a1b60448201526064016107b7565b604051632474521560e21b81527f366e34e4dd9cacc5f69a0ea920636c292b34b8951987dd08682365f7701b86f660048201523360248201527f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e46001600160a01b0316906391d1485490604401602060405180830381865afa158015610c19573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610c3d91906129c0565b610c595760405162461bcd60e51b81526004016107b7906129df565b600180546001600160a01b0319166001600160a01b0384169081179091555f82905560408051918252602082018390527fb47ee5a7063eba721c041c66c9bc757510a4f35361ec729c57fff3709ec9d05691015b60405180910390a15050565b6001546001600160a01b03163314610d055760405162461bcd60e51b815260206004820152600f60248201526e2737ba102aa9a22190313ab93732b960891b60448201526064016107b7565b5f8054908055604051630852cd8d60e31b81526004810182905273a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48906342966c68906024015b5f604051808303815f87803b158015610d56575f5ffd5b505af1158015610d68573d5f5f3e3d5ffd5b5050505050565b60405163fe2f9dd760e01b815273dac17f958d2ee523a2206206994597c13d831ec760048201525f906001600160a01b037f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e4169063fe2f9dd790602401602060405180830381865afa158015610de7573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e0b91906129a5565b6001600160a01b031603610e615760405162461bcd60e51b815260206004820152601760248201527f55534454206e6f7420726567697374657265642079657400000000000000000060448201526064016107b7565b604051634b0f53e960e01b815273dac17f958d2ee523a2206206994597c13d831ec760048201525f906001600160a01b037f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e41690634b0f53e990602401602060405180830381865afa158015610ed9573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610efd91906129a5565b6001600160a01b031614610f495760405162461bcd60e51b81526020600482015260136024820152721554d115081b9bdd081d195c9b5a5b985d1959606a1b60448201526064016107b7565b604051632474521560e21b81527fcc83783a336c5977a84d3445de8848e96ef07372a420bac3d7f276ab3bcb0b4060048201523360248201527f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e46001600160a01b0316906391d1485490604401602060405180830381865afa158015610fd1573d5f5f3e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610ff591906129c0565b6110115760405162461bcd60e51b81526004016107b7906129df565b600580546001600160a01b0319166001600160a01b038416908117909155600482905560408051918252602082018390527fb740908f42082ee9c7c27f28ccc46efeb3cdb3c7c78a1cb922c77d08d7e4c5d59101610cad565b600b545f901561107a5750600190565b600a546001600160a01b031661108f57505f90565b5f7f000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f6001600160a01b031663c8f33c916040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110ec573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906111109190612a0a565b9050801580159061112d575061112a630107ac0042612a21565b81105b156111e5577f000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f6001600160a01b0316632df802806040518163ffffffff1660e01b8152600401602060405180830381865afa15801561118e573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906111b29190612a0a565b600b556040517f62d06fdd7cbd752d149eb462b259ed89c5723ec8b3d78342e1613d0976803255905f90a1600191505090565b5f91505090565b60405163fe2f9dd760e01b8152731abaea1f7c830bd89acc67ec4af516284b1bc33c60048201525f906001600160a01b037f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e4169063fe2f9dd790602401602060405180830381865afa158015611264573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061128891906129a5565b6001600160a01b0316036112de5760405162461bcd60e51b815260206004820152601760248201527f45555243206e6f7420726567697374657265642079657400000000000000000060448201526064016107b7565b604051634b0f53e960e01b8152731abaea1f7c830bd89acc67ec4af516284b1bc33c60048201525f906001600160a01b037f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e41690634b0f53e990602401602060405180830381865afa158015611356573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061137a91906129a5565b6001600160a01b0316146113c65760405162461bcd60e51b815260206004820152601360248201527211555490c81b9bdd081d195c9b5a5b985d1959606a1b60448201526064016107b7565b604051632474521560e21b81527fea9b585a6ebd9633ce15a00ac59a64be294805b254faeed18790c2161e44e71a60048201523360248201527f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e46001600160a01b0316906391d1485490604401602060405180830381865afa15801561144e573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061147291906129c0565b61148e5760405162461bcd60e51b81526004016107b7906129df565b600380546001600160a01b0319166001600160a01b038416908117909155600282905560408051918252602082018390527fed33da0431b812765cb9d4b886f7495cb6f429854b6e530c8e2a10a83776bbe79101610cad565b5f8581526008602052604090205460ff16156115375760405162461bcd60e51b815260206004820152600f60248201526e105b1c9958591e4818db185a5b5959608a1b60448201526064016107b7565b5f611543338686611d83565b6009549091506001600160a01b0316636a5310d07f0000000000000000000000009ef7629f9b930168b76283add7120777b3c895b36115818961096d565b8461158a612045565b88886040518763ffffffff1660e01b81526004016115ad96959493929190612953565b5f6040518083038186803b1580156115c3575f5ffd5b505afa1580156115d5573d5f5f3e3d5ffd5b5050505f878152600860205260409020805460ff19166001179055506116056001600160a01b03861633866120db565b604080518781526001600160a01b038716602082015290810185905233907fa27580a77a01c86ee8598d930ae5f9a0ec6f146c6e0e9e9f50b95bacb33787189060600160405180910390a2505050505050565b611660612205565b5f61166b33856106ef565b5f81815260076020526040902054909150156116c95760405162461bcd60e51b815260206004820152601a60248201527f4465706f73697420696420697320616c7265616479207573656400000000000060448201526064016107b7565b604051634b0f53e960e01b81526001600160a01b0384811660048301525f917f000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e490911690634b0f53e990602401602060405180830381865afa158015611731573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061175591906129a5565b6001600160a01b0316036117a15760405162461bcd60e51b81526020600482015260136024820152722737ba1039bab83837b93a32b2103a37b5b2b760691b60448201526064016107b7565b6117a9612272565b6117e95760405162461bcd60e51b8152602060048201526011602482015270427269646765206973206f66666c696e6560781b60448201526064016107b7565b6040516370a0823160e01b81523060048201525f906001600160a01b038516906370a0823190602401602060405180830381865afa15801561182d573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118519190612a0a565b90506118686001600160a01b038516333086612315565b6040516370a0823160e01b81523060048201525f9082906001600160a01b038716906370a0823190602401602060405180830381865afa1580156118ae573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906118d29190612a0a565b6118dc9190612a21565b90505f811161192d5760405162461bcd60e51b815260206004820152601a60248201527f4e6f20746f6b656e732077657265207472616e7366657272656400000000000060448201526064016107b7565b611938338683611d83565b5f848152600760209081526040918290209290925580516001600160a01b0388168152918201839052339185917f2c0f148b435140de488c1b34647f1511c646f7077e87007bacf22ef9977a16d8910160405180910390a350505061199b612354565b505050565b6003546001600160a01b031633146119ec5760405162461bcd60e51b815260206004820152600f60248201526e2737ba1022aaa92190313ab93732b960891b60448201526064016107b7565b600280545f909155604051630852cd8d60e31b815260048101829052731abaea1f7c830bd89acc67ec4af516284b1bc33c906342966c6890602401610d3f565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff16159067ffffffffffffffff165f81158015611a715750825b90505f8267ffffffffffffffff166001148015611a8d5750303b155b905081158015611a9b575080155b15611ab95760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff191660011785558315611ae357845460ff60401b1916600160401b1785555b6001600160a01b038816611b315760405162461bcd60e51b8152602060048201526015602482015274141c9bdbd995995c9a599a595c881b9bdd081cd95d605a1b60448201526064016107b7565b611b3a8761237e565b611b4261238f565b611b4a61238f565b600980546001600160a01b03808b166001600160a01b031992831617909255600a8054928916929091169190911790558315611bc057845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b6001600160a01b038316611c145760405162461bcd60e51b8152602060048201526011602482015270526563697069656e74206973207a65726f60781b60448201526064016107b7565b600a546001600160a01b03163314611c675760405162461bcd60e51b81526020600482015260166024820152752737ba1032bc34ba1030b236b4b734b9ba3930ba37b960511b60448201526064016107b7565b611c6f61106a565b611cb05760405162461bcd60e51b8152602060048201526012602482015271109c9a5919d9481a5cc81b9bdd081919585960721b60448201526064016107b7565b611cc46001600160a01b03831684836120db565b604080516001600160a01b038481168252602082018490528516917fe3528bdf76e36b0132e2b17ecb978120666f4ea8968ad84090a9bdb16ebe51a6910160405180910390a2505050565b60408051602081018390526002918101919091525f90606001610987565b611d3561213a565b600980546001600160a01b0319166001600160a01b0383169081179091556040519081527fa37b8cc6237b398b43a500bcd66f67e927875d57cd10fde544af9cf61a1639e990602001610962565b604080516001600160a01b038086166020830152841691810191909152606081018290525f906080016040516020818303038152906040528051906020012090505b9392505050565b6005546001600160a01b03163314611e185760405162461bcd60e51b815260206004820152600f60248201526e2737ba102aa9a22a10313ab93732b960891b60448201526064016107b7565b600480545f8255604051630852cd8d60e31b81529182018190529073dac17f958d2ee523a2206206994597c13d831ec7906342966c6890602401610d3f565b611e5f61213a565b6001600160a01b038116611e8857604051631e4fbdf760e01b81525f60048201526024016107b7565b611e9181612195565b50565b306001600160a01b037f0000000000000000000000004cbd824685f1e21b119f230b54d65c5a7d2a5330161480611f1a57507f0000000000000000000000004cbd824685f1e21b119f230b54d65c5a7d2a53306001600160a01b0316611f0e5f516020612a4b5f395f51905f52546001600160a01b031690565b6001600160a01b031614155b156109b55760405163703e46dd60e11b815260040160405180910390fd5b611e9161213a565b816001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015611f9a575060408051601f3d908101601f19168201909252611f9791810190612a0a565b60015b611fc257604051634c9c8ce360e01b81526001600160a01b03831660048201526024016107b7565b5f516020612a4b5f395f51905f528114611ff257604051632a87526960e21b8152600481018290526024016107b7565b61199b8383612397565b306001600160a01b037f0000000000000000000000004cbd824685f1e21b119f230b54d65c5a7d2a533016146109b55760405163703e46dd60e11b815260040160405180910390fd5b600b545f90156120565750600b5490565b7f000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f6001600160a01b0316632df802806040518163ffffffff1660e01b8152600401602060405180830381865afa1580156120b2573d5f5f3e3d5ffd5b505050506040513d601f19601f820116820180604052508101906120d69190612a0a565b905090565b6040516001600160a01b0383811660248301526044820183905261199b91859182169063a9059cbb906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b0383818316178352505050506123ec565b3361216c7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b031690565b6001600160a01b0316146109b55760405163118cdaa760e01b81523360048201526024016107b7565b7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c19930080546001600160a01b031981166001600160a01b03848116918217845560405192169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a3505050565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005c1561224557604051633ee5aeb560e01b815260040160405180910390fd5b6109b560017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005b90612458565b600b545f901561228157505f90565b61228e6201518042612a21565b7f000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f6001600160a01b031663c8f33c916040518163ffffffff1660e01b8152600401602060405180830381865afa1580156122ea573d5f5f3e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061230e9190612a0a565b1015905090565b6040516001600160a01b03848116602483015283811660448301526064820183905261234e9186918216906323b872dd90608401612108565b50505050565b6109b55f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0061226c565b61238661245f565b611e91816124a8565b6109b561245f565b6123a0826124b0565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b905f90a28051156123e45761199b8282612513565b61073f612585565b5f5f60205f8451602086015f885af18061240b576040513d5f823e3d81fd5b50505f513d9150811561242257806001141561242f565b6001600160a01b0384163b155b1561234e57604051635274afe760e01b81526001600160a01b03851660048201526024016107b7565b80825d5050565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff166109b557604051631afcd79f60e31b815260040160405180910390fd5b611e5f61245f565b806001600160a01b03163b5f036124e557604051634c9c8ce360e01b81526001600160a01b03821660048201526024016107b7565b5f516020612a4b5f395f51905f5280546001600160a01b0319166001600160a01b0392909216919091179055565b60605f5f846001600160a01b03168460405161252f9190612a34565b5f60405180830381855af49150503d805f8114612567576040519150601f19603f3d011682016040523d82523d5f602084013e61256c565b606091505b509150915061257c8583836125a4565b95945050505050565b34156109b55760405163b398979f60e01b815260040160405180910390fd5b6060826125b9576125b482612600565b611dc5565b81511580156125d057506001600160a01b0384163b155b156125f957604051639996b31560e01b81526001600160a01b03851660048201526024016107b7565b5080611dc5565b8051156126105780518082602001fd5b60405163d6bda27560e01b815260040160405180910390fd5b6001600160a01b0381168114611e91575f5ffd5b80356bffffffffffffffffffffffff81168114612658575f5ffd5b919050565b5f5f6040838503121561266e575f5ffd5b823561267981612629565b91506126876020840161263d565b90509250929050565b634e487b7160e01b5f52604160045260245ffd5b5f5f604083850312156126b5575f5ffd5b82356126c081612629565b9150602083013567ffffffffffffffff8111156126db575f5ffd5b8301601f810185136126eb575f5ffd5b803567ffffffffffffffff81111561270557612705612690565b604051601f8201601f19908116603f0116810167ffffffffffffffff8111828210171561273457612734612690565b60405281815282820160200187101561274b575f5ffd5b816020840160208301375f602083830101528093505050509250929050565b5f5f5f5f5f6080868803121561277e575f5ffd5b85359450602086013561279081612629565b935060408601359250606086013567ffffffffffffffff8111156127b2575f5ffd5b8601601f810188136127c2575f5ffd5b803567ffffffffffffffff8111156127d8575f5ffd5b8860208284010111156127e9575f5ffd5b959894975092955050506020019190565b5f6020828403121561280a575f5ffd5b8135611dc581612629565b5f60208284031215612825575f5ffd5b5035919050565b5f5f6040838503121561283d575f5ffd5b823561284881612629565b946020939093013593505050565b5f5f5f60608486031215612868575f5ffd5b6128718461263d565b9250602084013561288181612629565b929592945050506040919091013590565b602081525f82518060208401528060208501604085015e5f604082850101526040601f19601f83011684010191505092915050565b5f5f5f606084860312156128d9575f5ffd5b83356128e481612629565b925060208401356128f481612629565b9150604084013561290481612629565b809150509250925092565b5f5f5f60608486031215612921575f5ffd5b833561287181612629565b634e487b7160e01b5f52601160045260245ffd5b8082018082111561071e5761071e61292c565b60018060a01b038716815285602082015284604082015283606082015260a060808201528160a0820152818360c08301375f81830160c090810191909152601f909201601f1916010195945050505050565b5f602082840312156129b5575f5ffd5b8151611dc581612629565b5f602082840312156129d0575f5ffd5b81518015158114611dc5575f5ffd5b6020808252601190820152702737ba10313ab93710383932b830b932b960791b604082015260600190565b5f60208284031215612a1a575f5ffd5b5051919050565b8181038181111561071e5761071e61292c565b5f82518060208501845e5f92019182525091905056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbca2646970667358221220823629f929e6d712481540ef92e4968a2e806965604cb2f38d2717cd3e8c6efc64736f6c634300081b0033

0000000000000000000000009ef7629f9b930168b76283add7120777b3c895b3000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e4000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f

-----Decoded View---------------
Arg [0] : _bridge (address): 0x9Ef7629F9B930168b76283AdD7120777b3c895b3
Arg [1] : _tokenPairs (address): 0xf2b1510c2709072C88C5b14db90Ec3b6297193e4
Arg [2] : _stateOracle (address): 0xB7e8CC3F5FeA12443136f0cc13D81F109B2dEd7f

-----Encoded View---------------
3 Constructor Arguments found :
Arg [0] : 0000000000000000000000009ef7629f9b930168b76283add7120777b3c895b3
Arg [1] : 000000000000000000000000f2b1510c2709072c88c5b14db90ec3b6297193e4
Arg [2] : 000000000000000000000000b7e8cc3f5fea12443136f0cc13d81f109b2ded7f