Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

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

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "./TweetToken.sol";
import "./ITweetToken.sol";
import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";

contract Router is Initializable, OwnableUpgradeable, UUPSUpgradeable {

    address public susdToken;
    uint256 public tweetTokenId;
    address public platformWallet;
    address public rewardContract;    

    // Events
    event TweetTokenPublished(uint256 indexed tweetTokenId);
    event TweetTokenBought(uint256 indexed tweetTokenId, address buyer, uint256 dollarIn, uint256 tokenOut);
    event TweetTokenSold(uint256 indexed tweetTokenId, address seller, uint256 tokenIn, uint256 dollarOut);
    event TweetTokenTierUpdated(uint256 indexed tweetTokenId, uint256 tier);
    event TweetTokenGraduated(uint256 indexed tweetTokenId);

    // Mappings
    mapping(uint256 => address) public tweetTokenAddress;
    mapping(string => mapping(string => bool)) public tweetTokenExists;
    mapping(string => mapping(string => uint256)) public tweetTokenIds;

    /// @custom:oz-upgrades-unsafe-allow constructor
    constructor() {
        _disableInitializers();
    }

    function initialize(
        address _susdToken,
        address _platformWallet,
        address _rewardContract
    ) public initializer {
        require(_susdToken != address(0), "Router: invalid SUSD token");
        require(_platformWallet != address(0), "Router: invalid platform wallet");
        require(_rewardContract != address(0), "Router: invalid reward contract");
        
        __Ownable_init(msg.sender);
        __UUPSUpgradeable_init();
        
        susdToken = _susdToken;
        platformWallet = _platformWallet;
        rewardContract = _rewardContract;
        tweetTokenId = 0;
    }

    // Structs to group related data
    struct FeeInfo {
        uint256 creatorShare;
        uint256 deployerShare;
        uint256 platformShare;
        uint256 fee;
        uint256 tokenOut;
        uint256 netDollarIn;
    }

    struct FeeDistribution {
        uint256 platformAmount;
        uint256 creatorAmount;
        uint256 deployerAmount;
    }

    function _calculateBuyFees(uint256 creatorShare, uint256 deployerShare, uint256 platformShare, uint256 fee) 
    internal pure returns (FeeDistribution memory) {
        return FeeDistribution({
            platformAmount: fee * platformShare / 10000,
            creatorAmount: fee * creatorShare / 10000,
            deployerAmount: fee * deployerShare / 10000
        });
    }

    function _calculateSellFees(uint256 creatorShare, uint256 deployerShare, uint256 platformShare, uint256 fee) 
    internal pure returns (FeeDistribution memory) {
        return FeeDistribution({
            platformAmount: fee * platformShare / 10000,
            creatorAmount: fee * creatorShare / 10000,
            deployerAmount: fee * deployerShare / 10000
        });
    }

    function _processBuyTransaction(
        address caller, 
        uint256 _dollarIn,
        uint256 netDollarIn,
        address _tweetTokenAddress
    ) internal {
        IERC20 dollar = IERC20(susdToken);
        dollar.transferFrom(caller, address(this), _dollarIn);
        dollar.transfer(_tweetTokenAddress, netDollarIn);
    }

    function _processSellTransaction(
        address caller,
        uint256 _amount,
        address _tweetTokenAddress
    ) internal {
        ITweetToken tweetToken = ITweetToken(_tweetTokenAddress);
        // First transfer tokens from user to the TweetToken contract
        tweetToken.transferFrom(caller, _tweetTokenAddress, _amount);
        // Then burn the tokens
        tweetToken.sell(_amount);
    }

    // State-changing functions
    function createTweetToken(
        string calldata tweetId,
        string calldata tweetUserId) external {

        require(tweetTokenExists[tweetId][tweetUserId] == false, "Router: TweetToken already exists");
        address deployer = msg.sender;

        // Deploy TweetToken
        TweetToken tweetToken = new TweetToken(tweetId, tweetUserId, susdToken, deployer, address(this));
    
        tweetTokenId++;
        tweetTokenAddress[tweetTokenId] = address(tweetToken);
        tweetTokenIds[tweetId][tweetUserId] = tweetTokenId;
        tweetTokenExists[tweetId][tweetUserId] = true;

        emit TweetTokenPublished(tweetTokenId);
    }

    function buyTweetToken(uint256 _tweetTokenId, uint256 _dollarIn) public {
        ITweetToken tweetToken = ITweetToken(tweetTokenAddress[_tweetTokenId]);
        uint256 oldTier = tweetToken.getTier();
        require(oldTier < 3, "TweetToken: cannot mint");     
        require(_dollarIn > 0.01 * 1e6, "TweetToken: invalid amount");  

        // Check balances and allowances
        IERC20 dollar = IERC20(susdToken); 
        require(dollar.balanceOf(msg.sender) >= _dollarIn, "USD: not enough balance");
        require(dollar.allowance(msg.sender, address(this)) >= _dollarIn, "USD: not enough allowance");        

        // Get fee information
        (uint256 creatorShare, uint256 deployerShare, uint256 platformShare) = tweetToken.getFeeInfo();
        (uint256 fee, uint256 tokenOut) = tweetToken.viewBuy(_dollarIn);
        
        // Calculate fees
        uint256 netDollarIn = _dollarIn - fee;
        FeeDistribution memory fees = _calculateBuyFees(creatorShare, deployerShare, platformShare, fee);

        // Process transaction
        _processBuyTransaction(msg.sender, _dollarIn, netDollarIn, address(tweetToken));
        
        // Distribute fees
        _handleFees(
            _tweetTokenId, 
            fees.platformAmount, 
            fees.creatorAmount, 
            fees.deployerAmount
        );

        // Mint tokens and emit events
        tweetToken.buy(msg.sender, tokenOut);
        emit TweetTokenBought(_tweetTokenId, msg.sender, _dollarIn, tokenOut);
        
        uint256 newTier = tweetToken.getTier();
        if (newTier > oldTier) {
            emit TweetTokenTierUpdated(_tweetTokenId, newTier);
        }
    }

    function sellTweetToken(uint256 _tweetTokenId, uint256 _amount) public {
        ITweetToken tweetToken = ITweetToken(tweetTokenAddress[_tweetTokenId]);
        require(tweetToken.getTier() < 3, "TweetToken: cannot burn");  
        require(_amount > 0, "TweetToken: invalid amount");    
        require(tweetToken.balanceOf(msg.sender) >= _amount, "TweetToken: not enough tokens");
        require(tweetToken.allowance(msg.sender, address(this)) >= _amount, "TweetToken: not enough allowance");

        // Get fee information
        (uint256 creatorShare, uint256 deployerShare, uint256 platformShare) = tweetToken.getFeeInfo();
        (uint256 fee, uint256 netDollarOut) = tweetToken.viewSell(_amount);
        require(netDollarOut > 0.01 * 1e6, string.concat(
            "TweetToken: invalid amount. NetDollarOut: ",
            _toString(netDollarOut)
        ));

        // Process token burn
        _processSellTransaction(msg.sender, _amount, address(tweetToken));

        // Calculate and distribute fees
        FeeDistribution memory fees = _calculateSellFees(creatorShare, deployerShare, platformShare, fee);
        _handleFees(_tweetTokenId, fees.platformAmount, fees.creatorAmount, fees.deployerAmount);

        // Transfer SUSD from TweetToken to user
        require(IERC20(susdToken).transferFrom(address(tweetToken), address(this), netDollarOut + fee), "Transfer from TweetToken failed");
        require(IERC20(susdToken).transfer(msg.sender, netDollarOut), "Transfer to user failed");
        
        emit TweetTokenSold(_tweetTokenId, msg.sender, _amount, netDollarOut);
    }    

    function _handleFees(uint256 _tweetTokenId, uint256 _platformAmount, uint256 _creatorAmount, uint256 _deployerAmount) internal {
        ITweetToken tweetToken = ITweetToken(tweetTokenAddress[_tweetTokenId]);
        string memory tweetUserId = tweetToken.tweetUserId();
        address deployerAddress = tweetToken.deployerAddress();
        if (_platformAmount > 0) {
            IERC20 dollar = IERC20(susdToken); 
            dollar.transfer(platformWallet, _platformAmount);
        }
        if (_creatorAmount > 0 && _deployerAmount > 0) {
            Reward(rewardContract).depositRewards(tweetUserId, _creatorAmount, deployerAddress, _deployerAmount);
        }          
    }

    function _toString(uint256 value) internal pure returns (string memory) {
        if (value == 0) {
            return "0";
        }
        uint256 temp = value;
        uint256 digits;
        while (temp != 0) {
            digits++;
            temp /= 10;
        }
        bytes memory buffer = new bytes(digits);
        while (value != 0) {
            digits -= 1;
            buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
            value /= 10;
        }
        return string(buffer);
    }

    // Admin functions
    function setRewardContract(address _rewardContract) external onlyOwner {
        require(_rewardContract != address(0), "Router: invalid reward contract");
        rewardContract = _rewardContract;
    }

    function setPlatformWallet(address _platformWallet) external onlyOwner {
        require(_platformWallet != address(0), "Router: invalid platform wallet");
        platformWallet = _platformWallet;
    }

    function increaseDollarAllowance() external onlyOwner {
        IERC20 dollar = IERC20(susdToken); 
        dollar.approve(rewardContract, type(uint256).max);
    }

    function _authorizeUpgrade(address newImplementation) internal override onlyOwner {}
}

// 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.0.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 ERC1967) 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 ERC1167 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 ERC1822 {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 ERC1967-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 ERC1967.
     *
     * 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.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

import {Context} from "../utils/Context.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 Ownable is Context {
    address private _owner;

    /**
     * @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.
     */
    constructor(address initialOwner) {
        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) {
        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 {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

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

pragma solidity ^0.8.20;

/**
 * @dev ERC1822: 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.0.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;

/**
 * @dev Standard ERC20 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
 */
interface IERC20Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC20InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC20InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     * @param allowance Amount of tokens a `spender` is allowed to operate with.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC20InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC20InvalidSpender(address spender);
}

/**
 * @dev Standard ERC721 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
 */
interface IERC721Errors {
    /**
     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
     * Used in balance queries.
     * @param owner Address of the current owner of a token.
     */
    error ERC721InvalidOwner(address owner);

    /**
     * @dev Indicates a `tokenId` whose `owner` is the zero address.
     * @param tokenId Identifier number of a token.
     */
    error ERC721NonexistentToken(uint256 tokenId);

    /**
     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param tokenId Identifier number of a token.
     * @param owner Address of the current owner of a token.
     */
    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC721InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC721InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param tokenId Identifier number of a token.
     */
    error ERC721InsufficientApproval(address operator, uint256 tokenId);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC721InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC721InvalidOperator(address operator);
}

/**
 * @dev Standard ERC1155 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
 */
interface IERC1155Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     * @param tokenId Identifier number of a token.
     */
    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC1155InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC1155InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param owner Address of the current owner of a token.
     */
    error ERC1155MissingApprovalForAll(address operator, address owner);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC1155InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC1155InvalidOperator(address operator);

    /**
     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
     * Used in batch transfers.
     * @param idsLength Length of the array of token identifiers
     * @param valuesLength Length of the array of token amounts
     */
    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}

// 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.0.0) (proxy/ERC1967/ERC1967Utils.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev This abstract contract provides getters and event emitting update functions for
 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
 */
library ERC1967Utils {
    // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
    // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
    /**
     * @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);

    /**
     * @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 EIP1967 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 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 EIP1967) 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 EIP1967 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 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 EIP1967 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 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.0.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.20;

import {IERC20} from "./IERC20.sol";
import {IERC20Metadata} from "./extensions/IERC20Metadata.sol";
import {Context} from "../../utils/Context.sol";
import {IERC20Errors} from "../../interfaces/draft-IERC6093.sol";

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * The default value of {decimals} is 18. To change this, you should override
 * this function so it returns a different value.
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC20
 * applications.
 *
 * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
 * This allows applications to reconstruct the allowance for all accounts just
 * by listening to said events. Other implementations of the EIP may not emit
 * these events, as it isn't required by the specification.
 */
abstract contract ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors {
    mapping(address account => uint256) private _balances;

    mapping(address account => mapping(address spender => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * All two of these values are immutable: they can only be set once during
     * construction.
     */
    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the default value returned by this function, unless
     * it's overridden.
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual returns (uint256) {
        return _totalSupply;
    }

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual returns (uint256) {
        return _balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `value`.
     */
    function transfer(address to, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, value);
        return true;
    }

    /**
     * @dev See {IERC20-allowance}.
     */
    function allowance(address owner, address spender) public view virtual returns (uint256) {
        return _allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, value);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `value`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `value`.
     */
    function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, value);
        _transfer(from, to, value);
        return true;
    }

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _transfer(address from, address to, uint256 value) internal {
        if (from == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        if (to == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(from, to, value);
    }

    /**
     * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
     * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
     * this function.
     *
     * Emits a {Transfer} event.
     */
    function _update(address from, address to, uint256 value) internal virtual {
        if (from == address(0)) {
            // Overflow check required: The rest of the code assumes that totalSupply never overflows
            _totalSupply += value;
        } else {
            uint256 fromBalance = _balances[from];
            if (fromBalance < value) {
                revert ERC20InsufficientBalance(from, fromBalance, value);
            }
            unchecked {
                // Overflow not possible: value <= fromBalance <= totalSupply.
                _balances[from] = fromBalance - value;
            }
        }

        if (to == address(0)) {
            unchecked {
                // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                _totalSupply -= value;
            }
        } else {
            unchecked {
                // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                _balances[to] += value;
            }
        }

        emit Transfer(from, to, value);
    }

    /**
     * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
     * Relies on the `_update` mechanism
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _mint(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(address(0), account, value);
    }

    /**
     * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
     * Relies on the `_update` mechanism.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead
     */
    function _burn(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        _update(account, address(0), value);
    }

    /**
     * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     *
     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
     */
    function _approve(address owner, address spender, uint256 value) internal {
        _approve(owner, spender, value, true);
    }

    /**
     * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
     *
     * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
     * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any
     * `Approval` event during `transferFrom` operations.
     *
     * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to
     * true using the following override:
     * ```
     * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
     *     super._approve(owner, spender, value, true);
     * }
     * ```
     *
     * Requirements are the same as {_approve}.
     */
    function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
        if (owner == address(0)) {
            revert ERC20InvalidApprover(address(0));
        }
        if (spender == address(0)) {
            revert ERC20InvalidSpender(address(0));
        }
        _allowances[owner][spender] = value;
        if (emitEvent) {
            emit Approval(owner, spender, value);
        }
    }

    /**
     * @dev Updates `owner` s allowance for `spender` based on spent `value`.
     *
     * Does not update the allowance value in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Does not emit an {Approval} event.
     */
    function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            if (currentAllowance < value) {
                revert ERC20InsufficientAllowance(spender, currentAllowance, value);
            }
            unchecked {
                _approve(owner, spender, currentAllowance - value, false);
            }
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/ERC20Burnable.sol)

pragma solidity ^0.8.20;

import {ERC20} from "../ERC20.sol";
import {Context} from "../../../utils/Context.sol";

/**
 * @dev Extension of {ERC20} that allows token holders to destroy both their own
 * tokens and those that they have an allowance for, in a way that can be
 * recognized off-chain (via event analysis).
 */
abstract contract ERC20Burnable is Context, ERC20 {
    /**
     * @dev Destroys a `value` amount of tokens from the caller.
     *
     * See {ERC20-_burn}.
     */
    function burn(uint256 value) public virtual {
        _burn(_msgSender(), value);
    }

    /**
     * @dev Destroys a `value` amount of tokens from `account`, deducting from
     * the caller's allowance.
     *
     * See {ERC20-_burn} and {ERC20-allowance}.
     *
     * Requirements:
     *
     * - the caller must have allowance for ``accounts``'s tokens of at least
     * `value`.
     */
    function burnFrom(address account, uint256 value) public virtual {
        _spendAllowance(account, _msgSender(), value);
        _burn(account, value);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the symbol of the token.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}

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

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
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.0.0) (utils/Address.sol)

pragma solidity ^0.8.20;

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev The ETH balance of the account is not enough to perform the operation.
     */
    error AddressInsufficientBalance(address account);

    /**
     * @dev There's no code at `target` (it is not a contract).
     */
    error AddressEmptyCode(address target);

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

    /**
     * @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 AddressInsufficientBalance(address(this));
        }

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

    /**
     * @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
     * {FailedInnerCall} 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 AddressInsufficientBalance(address(this));
        }
        (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 {FailedInnerCall}) 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 {FailedInnerCall} 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 {FailedInnerCall}.
     */
    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
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert FailedInnerCall();
        }
    }
}

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

pragma solidity ^0.8.20;

/**
 * @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 Context {
    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.0.0) (utils/cryptography/ECDSA.sol)

pragma solidity ^0.8.20;

/**
 * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
 *
 * These functions can be used to verify that a message was signed by the holder
 * of the private keys of a given address.
 */
library ECDSA {
    enum RecoverError {
        NoError,
        InvalidSignature,
        InvalidSignatureLength,
        InvalidSignatureS
    }

    /**
     * @dev The signature derives the `address(0)`.
     */
    error ECDSAInvalidSignature();

    /**
     * @dev The signature has an invalid length.
     */
    error ECDSAInvalidSignatureLength(uint256 length);

    /**
     * @dev The signature has an S value that is in the upper half order.
     */
    error ECDSAInvalidSignatureS(bytes32 s);

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with `signature` or an error. This will not
     * return address(0) without also returning an error description. Errors are documented using an enum (error type)
     * and a bytes32 providing additional information about the error.
     *
     * If no error is returned, then the address can be used for verification purposes.
     *
     * The `ecrecover` EVM precompile allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {MessageHashUtils-toEthSignedMessageHash} on it.
     *
     * Documentation for signature generation:
     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
     */
    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError, bytes32) {
        if (signature.length == 65) {
            bytes32 r;
            bytes32 s;
            uint8 v;
            // ecrecover takes the signature parameters, and the only way to get them
            // currently is to use assembly.
            /// @solidity memory-safe-assembly
            assembly {
                r := mload(add(signature, 0x20))
                s := mload(add(signature, 0x40))
                v := byte(0, mload(add(signature, 0x60)))
            }
            return tryRecover(hash, v, r, s);
        } else {
            return (address(0), RecoverError.InvalidSignatureLength, bytes32(signature.length));
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature`. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM precompile allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {MessageHashUtils-toEthSignedMessageHash} on it.
     */
    function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
        (address recovered, RecoverError error, bytes32 errorArg) = tryRecover(hash, signature);
        _throwError(error, errorArg);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
     *
     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
     */
    function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError, bytes32) {
        unchecked {
            bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
            // We do not check for an overflow here since the shift operation results in 0 or 1.
            uint8 v = uint8((uint256(vs) >> 255) + 27);
            return tryRecover(hash, v, r, s);
        }
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
     */
    function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
        (address recovered, RecoverError error, bytes32 errorArg) = tryRecover(hash, r, vs);
        _throwError(error, errorArg);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
     * `r` and `s` signature fields separately.
     */
    function tryRecover(
        bytes32 hash,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) internal pure returns (address, RecoverError, bytes32) {
        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
        // signatures from current libraries generate a unique signature with an s-value in the lower half order.
        //
        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
        // these malleable signatures as well.
        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
            return (address(0), RecoverError.InvalidSignatureS, s);
        }

        // If the signature is valid (and not malleable), return the signer address
        address signer = ecrecover(hash, v, r, s);
        if (signer == address(0)) {
            return (address(0), RecoverError.InvalidSignature, bytes32(0));
        }

        return (signer, RecoverError.NoError, bytes32(0));
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `v`,
     * `r` and `s` signature fields separately.
     */
    function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
        (address recovered, RecoverError error, bytes32 errorArg) = tryRecover(hash, v, r, s);
        _throwError(error, errorArg);
        return recovered;
    }

    /**
     * @dev Optionally reverts with the corresponding custom error according to the `error` argument provided.
     */
    function _throwError(RecoverError error, bytes32 errorArg) private pure {
        if (error == RecoverError.NoError) {
            return; // no error: do nothing
        } else if (error == RecoverError.InvalidSignature) {
            revert ECDSAInvalidSignature();
        } else if (error == RecoverError.InvalidSignatureLength) {
            revert ECDSAInvalidSignatureLength(uint256(errorArg));
        } else if (error == RecoverError.InvalidSignatureS) {
            revert ECDSAInvalidSignatureS(errorArg);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.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 ERC1967 implementation slot:
 * ```solidity
 * contract ERC1967 {
 *     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;
 *     }
 * }
 * ```
 */
library StorageSlot {
    struct AddressSlot {
        address value;
    }

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 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) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

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

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

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

    /**
     * @dev Returns an `StringSlot` with member `value` located at `slot`.
     */
    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            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) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` with member `value` located at `slot`.
     */
    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            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) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC20/IERC20.sol";

interface ITweetToken is IERC20 {
    // View functions for token info
    function getBalances() external view returns (uint256 virtualDollarReserve, uint256 tweetTokenReserve);
    function getTier() external view returns (uint256 tier);
    function getFeeRate() external view returns (uint256 feeRate);
    function getFeeInfo() external view returns (uint256 creatorShare, uint256 deployerShare, uint256 platformShare);
    
    // View functions for price calculation
    function viewBuy(uint256 dollarIn) external view returns (uint256 fee, uint256 tokenOut);
    function viewSell(uint256 tokenIn) external view returns (uint256 fee, uint256 dollarOut);
    
    // Public state variables
    function tweetId() external view returns (string memory);
    function tweetUserId() external view returns (string memory);
    function deployerAddress() external view returns (address);
    function susdToken() external view returns (address);
    function platformWallet() external view returns (address);
    function rewardContract() external view returns (address);
    function createdTimestamp() external view returns (uint256);
    function lastBuyTimestamp() external view returns (uint256);
    function lastSellTimestamp() external view returns (uint256);
    function isGraduated() external view returns (bool);

    function buy(address buyer, uint256 amount) external;
    function sell(uint256 amount) external;
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";

contract Reward is Initializable, OwnableUpgradeable, UUPSUpgradeable {

    // State variables
    address public susdToken;
    address public signerAddress;
    mapping(string => uint256) public creatorRewards;
    mapping(address => uint256) public deployerRewards;

    // Events
    event CreatorRewardClaimed(string indexed tweetUserId, address indexed recipient, uint256 amount);
    event DeployerRewardClaimed(address indexed deployerAddress, address indexed recipient, uint256 amount);


    /// @custom:oz-upgrades-unsafe-allow constructor
    constructor() {
        _disableInitializers();
    }

    function initialize(address _signerAddress, address _susdToken) public initializer {     
        require(_signerAddress != address(0), "Reward: invalid signer address");
        require(_susdToken != address(0), "Reward: invalid SUSD token");
        __Ownable_init(msg.sender);
        __UUPSUpgradeable_init();
        signerAddress = _signerAddress;
        susdToken = _susdToken;
    }

    function depositRewards(string calldata tweetUserId, uint256 tweetUserAmount, address deployerAddress, uint256 deployerAmount) external {
        IERC20 dollar = IERC20(susdToken);
        uint256 totalAmount = tweetUserAmount + deployerAmount;
        require(dollar.balanceOf(msg.sender) >= totalAmount, "Reward: not enough balance");
        require(dollar.transferFrom(msg.sender, address(this), totalAmount), "Reward: transfer failed");
        creatorRewards[tweetUserId] += tweetUserAmount;
        deployerRewards[deployerAddress] += deployerAmount;
    }

    function claimCreatorReward(string calldata tweetUserId, address payable to, bytes calldata signature) external {
        uint256 amount = creatorRewards[tweetUserId];
        require(amount > 0, "Reward: no reward available");

        // Verify signature
        bytes32 messageHash = keccak256(
            abi.encodePacked(
                "\x19Ethereum Signed Message:\n32",
                keccak256(
                    abi.encode(
                        address(this),    // Contract address for replay protection
                        tweetUserId,      // Tweet user ID
                        to,              // Recipient address
                        amount          // Amount being claimed
                    )
                )
            )
        );
        address recoveredSigner = ECDSA.recover(messageHash, signature);
        require(recoveredSigner == signerAddress, "RewardManager: invalid signature");

        creatorRewards[tweetUserId] = 0;
        IERC20 dollar = IERC20(susdToken);
        require(dollar.transfer(to, amount), "Reward: transfer failed");
        
        emit CreatorRewardClaimed(tweetUserId, to, amount);
    }

    function claimDeployerReward(address payable to) external {
        uint256 amount = deployerRewards[msg.sender];
        require(amount > 0, "Reward: no reward available");

        deployerRewards[msg.sender] = 0;
        IERC20 dollar = IERC20(susdToken);
        require(dollar.transfer(to, amount), "Reward: transfer failed");
        
        emit DeployerRewardClaimed(msg.sender, to, amount);
    }

    function setSignerAddress(address newSigner) external onlyOwner {
        require(newSigner != address(0), "Reward: invalid signer address");
        signerAddress = newSigner;
    }

    function getCreatorReward(string calldata tweetUserId) external view returns (uint256) {
        return creatorRewards[tweetUserId];
    }

    function getDeployerReward(address deployerAddress) external view returns (uint256) {
        return deployerRewards[deployerAddress];
    }

    function _authorizeUpgrade(address newImplementation) internal override onlyOwner {}
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Burnable.sol";
import "./Reward.sol";

contract TweetToken is ERC20, ERC20Burnable, Ownable {
    
    // State variables
    string public tweetId;
    string public tweetUserId;
    address public deployerAddress;
    address public susdToken;
    
    uint256 public createdTimestamp;
    uint256 public lastBuyTimestamp;
    uint256 public lastSellTimestamp;
    
    bool public isGraduated;

    // Fee rates for each tier (in basis points, 1% = 100)
    uint256 public constant START_FEE_RATE = 2000;   // 20%
    uint256 public constant FAMOUS_FEE_RATE = 1500;  // 15%
    uint256 public constant VIRAL_FEE_RATE = 1000;   // 10%

    // Platform shares for each tier (in basis points)
    uint256 public constant START_PLATFORM_SHARE = 8000;   // 80%
    uint256 public constant FAMOUS_PLATFORM_SHARE = 8000;  // 80%
    uint256 public constant VIRAL_PLATFORM_SHARE = 9200;   // 92%

    // Creator shares for each tier (in basis points)
    uint256 public constant START_CREATOR_SHARE = 1200;   // 12%
    uint256 public constant FAMOUS_CREATOR_SHARE = 1200;  // 12%
    uint256 public constant VIRAL_CREATOR_SHARE = 800;    // 8%

    // Deployer shares for each tier (in basis points)
    uint256 public constant START_DEPLOYER_SHARE = 800;   // 8%
    uint256 public constant FAMOUS_DEPLOYER_SHARE = 800;  // 8%
    uint256 public constant VIRAL_DEPLOYER_SHARE = 0;     // 0%

    // Graduate DEX distribution (in basis points)
    uint256 public constant GRADUATE_PLATFORM_SHARE = 9000;  // 90%
    uint256 public constant GRADUATE_CREATOR_SHARE = 750;    // 7.5%
    uint256 public constant GRADUATE_DEPLOYER_SHARE = 250;   // 2.5%

    // Graduate DEX configuration
    uint256 public constant GRADUATE_SUSD_AMOUNT = 35_000 * 1e6;  // 35,000 SUSD
    uint256 public constant GRADUATE_TOKEN_AMOUNT = 10_000 * 1e18; // 10,000 tokens

    // Virtual dollar thresholds
    uint256 public constant START_THRESHOLD = 10_000 * 1e6;    // 10,000 SUSD
    uint256 public constant FAMOUS_THRESHOLD = 20_000 * 1e6;  // 20,000 SUSD
    uint256 public constant VIRAL_THRESHOLD = 40_000 * 1e6;   // 40,000 SUSD
    uint256 public constant GRADUATE_THRESHOLD = 80_000 * 1e6; // 80,000 SUSD
    uint256 public constant K = (10_0000 * 1e6) * (1_000_000 * 1e18);

    // Events
    event TierUpdated(uint256 newTier_);    
    event TokensSold(uint256 amount, uint256 netDollarOut);

    constructor(
        string memory _tweetId, 
        string memory _tweetUserId, 
        address _susdToken, 
        address _deployerAddress,
        address _routerAddress
    ) ERC20(
            string.concat("Tweet Token -", _tweetId), 
            string.concat("TT-", _tweetId)
        ) Ownable(_routerAddress) {
        tweetId = _tweetId;
        tweetUserId = _tweetUserId;
        createdTimestamp = block.timestamp;
        lastBuyTimestamp = 0;
        lastSellTimestamp = 0;
        susdToken = _susdToken;
        deployerAddress = _deployerAddress;     
        isGraduated = false;  
        IERC20(susdToken).approve(_routerAddress, type(uint256).max);              
    }

    function getBalances() external view returns (uint256, uint256) {
        uint256 realDollarReserve = IERC20(susdToken).balanceOf(address(this));
        uint256 virtualDollarReserve = realDollarReserve + (10_000 * 1e6);
        uint256 tweetTokenReserve = balanceOf(address(this));
        return (virtualDollarReserve, tweetTokenReserve);
    }

    function getTier() external view returns (uint256) {
        uint256 realDollarReserve = IERC20(susdToken).balanceOf(address(this));
        uint256 virtualDollarReserve = realDollarReserve + (10_000 * 1e6);
        if (virtualDollarReserve >= GRADUATE_THRESHOLD) return 3; // Graduate
        if (virtualDollarReserve >= VIRAL_THRESHOLD) return 2;    // Viral
        if (virtualDollarReserve >= FAMOUS_THRESHOLD) return 1;   // Famous
        return 0; // Start
    }       

    function getFeeInfo() public view returns (uint256, uint256, uint256) {
        uint256 realDollarReserve = IERC20(susdToken).balanceOf(address(this));
        uint256 virtualDollarReserve = realDollarReserve + (10_000 * 1e6);        
        if (virtualDollarReserve >= GRADUATE_THRESHOLD) {
            return (GRADUATE_CREATOR_SHARE, GRADUATE_DEPLOYER_SHARE, GRADUATE_PLATFORM_SHARE);
        }
        else if (virtualDollarReserve >= VIRAL_THRESHOLD) {
            return (
                VIRAL_CREATOR_SHARE,
                VIRAL_DEPLOYER_SHARE,
                VIRAL_PLATFORM_SHARE
            );
        }
        else if (virtualDollarReserve >= FAMOUS_THRESHOLD) {
            return (
                FAMOUS_CREATOR_SHARE,
                FAMOUS_DEPLOYER_SHARE,
                FAMOUS_PLATFORM_SHARE
            );
        }
        else if (virtualDollarReserve >= START_THRESHOLD) {
            return (
                START_CREATOR_SHARE,
                START_DEPLOYER_SHARE,
                START_PLATFORM_SHARE
            );
        }
        return (0, 0, 0); // Below start threshold
    }    

    function getFeeRate() public view returns (uint256) {
        uint256 realDollarReserve = IERC20(susdToken).balanceOf(address(this));
        uint256 virtualDollarReserve = realDollarReserve + (10_000 * 1e6);        
        if (virtualDollarReserve >= VIRAL_THRESHOLD) {
            return (
                VIRAL_FEE_RATE
            );
        }
        else if (virtualDollarReserve >= FAMOUS_THRESHOLD) {
            return (
                FAMOUS_FEE_RATE
            );
        }
        else if (virtualDollarReserve >= START_THRESHOLD) {
            return (
                START_FEE_RATE
            );
        }
        return (0); // Below start threshold
    }        

    // View functions
    function viewBuy(uint256 _dollarIn) public view returns(uint256 fee_, uint256 tokenOut_) { 
        uint256 feeRate = this.getFeeRate();
        uint256 realDollarReserve = IERC20(susdToken).balanceOf(address(this));
        uint256 virtualDollarReserve = realDollarReserve + (10_000 * 1e6);     
        uint256 virtualTokenReserve = balanceOf(address(this)) + (1_000_000 * 1e18);        
        
        // Calculate fee and net input
        uint256 totalFee = (_dollarIn * feeRate) / 10000;
        uint256 netDollarIn = _dollarIn - totalFee;

        // Calculate AMM swap
        uint256 k = virtualDollarReserve * virtualTokenReserve;
        uint256 newDollarReserve = virtualDollarReserve + netDollarIn;
        uint256 newTokenReserve = k / newDollarReserve;
        uint256 tokenOut = virtualTokenReserve - newTokenReserve;

        return (totalFee, tokenOut);
    }

    function viewSell(uint256 _tokenIn) public view returns(uint256 fee_, uint256 dollarOut_) {
        uint256 feeRate = this.getFeeRate();
        uint256 realDollarReserve = IERC20(susdToken).balanceOf(address(this));
        uint256 virtualDollarReserve = realDollarReserve + (10_000 * 1e6);     
        uint256 tweetTokenReserve = balanceOf(address(this));    
        uint256 virtualTokenReserve = tweetTokenReserve + (1_000_000 * 1e18);        
  
        // Calculate AMM swap
        uint256 k = virtualDollarReserve * virtualTokenReserve;
        uint256 newTokenReserve = virtualTokenReserve + _tokenIn;
        uint256 newDollarReserve = k / newTokenReserve;
        uint256 grossDollarOut = virtualDollarReserve - newDollarReserve;
        
        // Calculate fee and net output
        uint256 fee = (grossDollarOut * feeRate) / 10000;
        uint256 netDollarOut = grossDollarOut - fee;

        return (fee, netDollarOut);
    }    

    function buy(address buyer, uint256 amount) public onlyOwner {
        _mint(buyer, amount);
        lastBuyTimestamp = block.timestamp;
    }

    function sell(uint256 _amount) public onlyOwner {
        require(_amount > 0, "TweetToken: invalid amount");
        require(balanceOf(address(this)) >= _amount, "TweetToken: not enough tokens");

        // Calculate output amount
        (uint256 fee, uint256 netDollarOut) = viewSell(_amount);
        require(netDollarOut > 0, "TweetToken: invalid output amount");

        // Burn tokens
        _burn(address(this), _amount);
        
        // Update state
        lastSellTimestamp = block.timestamp;
        
        // No need to transfer SUSD here - Router will handle it
        emit TokensSold(_amount, netDollarOut);
    }
}

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

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"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":"FailedInnerCall","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":"UUPSUnauthorizedCallContext","type":"error"},{"inputs":[{"internalType":"bytes32","name":"slot","type":"bytes32"}],"name":"UUPSUnsupportedProxiableUUID","type":"error"},{"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":true,"internalType":"uint256","name":"tweetTokenId","type":"uint256"},{"indexed":false,"internalType":"address","name":"buyer","type":"address"},{"indexed":false,"internalType":"uint256","name":"dollarIn","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"tokenOut","type":"uint256"}],"name":"TweetTokenBought","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tweetTokenId","type":"uint256"}],"name":"TweetTokenGraduated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tweetTokenId","type":"uint256"}],"name":"TweetTokenPublished","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tweetTokenId","type":"uint256"},{"indexed":false,"internalType":"address","name":"seller","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenIn","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"dollarOut","type":"uint256"}],"name":"TweetTokenSold","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tweetTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"tier","type":"uint256"}],"name":"TweetTokenTierUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"UPGRADE_INTERFACE_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tweetTokenId","type":"uint256"},{"internalType":"uint256","name":"_dollarIn","type":"uint256"}],"name":"buyTweetToken","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"tweetId","type":"string"},{"internalType":"string","name":"tweetUserId","type":"string"}],"name":"createTweetToken","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"increaseDollarAllowance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_susdToken","type":"address"},{"internalType":"address","name":"_platformWallet","type":"address"},{"internalType":"address","name":"_rewardContract","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"platformWallet","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":[],"name":"rewardContract","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tweetTokenId","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"sellTweetToken","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_platformWallet","type":"address"}],"name":"setPlatformWallet","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_rewardContract","type":"address"}],"name":"setRewardContract","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"susdToken","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":"uint256","name":"","type":"uint256"}],"name":"tweetTokenAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"string","name":"","type":"string"}],"name":"tweetTokenExists","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tweetTokenId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"string","name":"","type":"string"}],"name":"tweetTokenIds","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"}]

60a0604052306080523480156200001557600080fd5b506200002062000026565b620000da565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff1615620000775760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b0390811614620000d75780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b6080516144496200010460003960008181611c6901528181611c930152611e4601526144496000f3fe608060405260043610620001375760003560e01c80638831e9cf11620000ad578063ec6752eb116200006c578063ec6752eb1462000425578063f2fde38b146200043d578063f39690e41462000462578063fa2af9da1462000484578063ff2dd80314620004a657600080fd5b80638831e9cf14620003015780638da5cb5b1462000326578063ad3cb1cc1462000365578063bc14271f14620003a7578063c0c53b8b146200040057600080fd5b806351508f0a11620000fa57806351508f0a146200021d57806352d1902d146200024257806364796d5b146200025a5780636ea69d6214620002c7578063715018a614620002e957600080fd5b806315242d3f146200013c578063185febff14620001635780632d84950714620001ba5780633042937414620001e15780634f1ef2861462000206575b600080fd5b3480156200014957600080fd5b50620001616200015b3660046200216a565b620004cb565b005b3480156200017057600080fd5b506200019d620001823660046200218d565b6004602052600090815260409020546001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b348015620001c757600080fd5b50620001d260015481565b604051908152602001620001b1565b348015620001ee57600080fd5b5062000161620002003660046200216a565b62000ae0565b620001616200021736600462002275565b6200101e565b3480156200022a57600080fd5b50620001616200023c366004620022e0565b62001043565b3480156200024f57600080fd5b50620001d2620010c7565b3480156200026757600080fd5b50620002b66200027936600462002323565b8151602081840181018051600582529282019482019490942091909352815180830184018051928152908401929093019190912091525460ff1681565b6040519015158152602001620001b1565b348015620002d457600080fd5b506003546200019d906001600160a01b031681565b348015620002f657600080fd5b5062000161620010e7565b3480156200030e57600080fd5b506200016162000320366004620022e0565b620010ff565b3480156200033357600080fd5b507f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b03166200019d565b3480156200037257600080fd5b5062000398604051806040016040528060058152602001640352e302e360dc1b81525081565b604051620001b19190620023d8565b348015620003b457600080fd5b50620001d2620003c636600462002323565b8151602081840181018051600682529282019482019490942091909352815180830184018051928152908401929093019190912091525481565b3480156200040d57600080fd5b50620001616200041f366004620023ed565b62001183565b3480156200043257600080fd5b5062000161620013eb565b3480156200044a57600080fd5b50620001616200045c366004620022e0565b62001474565b3480156200046f57600080fd5b506000546200019d906001600160a01b031681565b3480156200049157600080fd5b506002546200019d906001600160a01b031681565b348015620004b357600080fd5b5062000161620004c53660046200248b565b620014b8565b600082815260046020818152604092839020548351632d6b80e160e11b815293516001600160a01b03909116936003938593635ad701c29383830193919290918290030181865afa15801562000525573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200054b9190620024fe565b106200059e5760405162461bcd60e51b815260206004820152601760248201527f5477656574546f6b656e3a2063616e6e6f74206275726e00000000000000000060448201526064015b60405180910390fd5b60008211620005f05760405162461bcd60e51b815260206004820152601a60248201527f5477656574546f6b656e3a20696e76616c696420616d6f756e74000000000000604482015260640162000595565b6040516370a0823160e01b815233600482015282906001600160a01b038316906370a0823190602401602060405180830381865afa15801562000637573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200065d9190620024fe565b1015620006ad5760405162461bcd60e51b815260206004820152601d60248201527f5477656574546f6b656e3a206e6f7420656e6f75676820746f6b656e73000000604482015260640162000595565b604051636eb1769f60e11b815233600482015230602482015282906001600160a01b0383169063dd62ed3e90604401602060405180830381865afa158015620006fa573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620007209190620024fe565b1015620007705760405162461bcd60e51b815260206004820181905260248201527f5477656574546f6b656e3a206e6f7420656e6f75676820616c6c6f77616e6365604482015260640162000595565b6000806000836001600160a01b03166202eab76040518163ffffffff1660e01b8152600401606060405180830381865afa158015620007b3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620007d9919062002518565b925092509250600080856001600160a01b0316634930983f886040518263ffffffff1660e01b81526004016200081191815260200190565b6040805180830381865afa1580156200082e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000854919062002547565b9150915061271081116200086882620016ce565b6040516020016200087a91906200256c565b60405160208183030381529060405290620008aa5760405162461bcd60e51b8152600401620005959190620023d8565b50620008b8338888620017ef565b6000620008c886868686620018c6565b9050620008e4898260000151836020015184604001516200195e565b6000546001600160a01b03166323b872dd8830620009038787620025dc565b6040516001600160e01b031960e086901b1681526001600160a01b03938416600482015292909116602483015260448201526064016020604051808303816000875af115801562000958573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200097e9190620025f2565b620009cc5760405162461bcd60e51b815260206004820152601f60248201527f5472616e736665722066726f6d205477656574546f6b656e206661696c656400604482015260640162000595565b60005460405163a9059cbb60e01b8152336004820152602481018490526001600160a01b039091169063a9059cbb906044016020604051808303816000875af115801562000a1e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000a449190620025f2565b62000a925760405162461bcd60e51b815260206004820152601760248201527f5472616e7366657220746f2075736572206661696c6564000000000000000000604482015260640162000595565b60408051338152602081018a905290810183905289907fad91a82cffe5e37ba0016957c6ff844926418edb7d217b29beee7f81dca46add9060600160405180910390a2505050505050505050565b6000828152600460208181526040808420548151632d6b80e160e11b815291516001600160a01b0390911694938593635ad701c293808301939192908290030181865afa15801562000b36573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000b5c9190620024fe565b90506003811062000bb05760405162461bcd60e51b815260206004820152601760248201527f5477656574546f6b656e3a2063616e6e6f74206d696e74000000000000000000604482015260640162000595565b612710831162000c035760405162461bcd60e51b815260206004820152601a60248201527f5477656574546f6b656e3a20696e76616c696420616d6f756e74000000000000604482015260640162000595565b6000546040516370a0823160e01b81523360048201526001600160a01b0390911690849082906370a0823190602401602060405180830381865afa15801562000c50573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000c769190620024fe565b101562000cc65760405162461bcd60e51b815260206004820152601760248201527f5553443a206e6f7420656e6f7567682062616c616e6365000000000000000000604482015260640162000595565b604051636eb1769f60e11b815233600482015230602482015284906001600160a01b0383169063dd62ed3e90604401602060405180830381865afa15801562000d13573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000d399190620024fe565b101562000d895760405162461bcd60e51b815260206004820152601960248201527f5553443a206e6f7420656e6f75676820616c6c6f77616e636500000000000000604482015260640162000595565b6000806000856001600160a01b03166202eab76040518163ffffffff1660e01b8152600401606060405180830381865afa15801562000dcc573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000df2919062002518565b925092509250600080876001600160a01b03166328ce60148a6040518263ffffffff1660e01b815260040162000e2a91815260200190565b6040805180830381865afa15801562000e47573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000e6d919062002547565b9092509050600062000e80838b62002616565b9050600062000e9287878787620018c6565b905062000ea2338c848d62001b5d565b62000ebc8c8260000151836020015184604001516200195e565b60405163cce7ec1360e01b8152336004820152602481018490526001600160a01b038b169063cce7ec1390604401600060405180830381600087803b15801562000f0557600080fd5b505af115801562000f1a573d6000803e3d6000fd5b505060408051338152602081018f90529081018690528e92507f9d1cc916e0bd9464ed4c9e74f6b36dd1c4cfe96ee87030f07fc4f21bcf7e85cb915060600160405180910390a260008a6001600160a01b0316635ad701c26040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000fa2573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000fc89190620024fe565b9050898111156200100f578c7f8d8a543df333b4c72ca5b1f562eaceb4caa9cd02bac609b4ef7076fd198d587e826040516200100691815260200190565b60405180910390a25b50505050505050505050505050565b6200102862001c5e565b620010338262001d07565b6200103f828262001d11565b5050565b6200104d62001ddd565b6001600160a01b038116620010a55760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c69642072657761726420636f6e747261637400604482015260640162000595565b600380546001600160a01b0319166001600160a01b0392909216919091179055565b6000620010d362001e3b565b50600080516020620043f483398151915290565b620010f162001ddd565b620010fd600062001e85565b565b6200110962001ddd565b6001600160a01b038116620011615760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c696420706c6174666f726d2077616c6c657400604482015260640162000595565b600280546001600160a01b0319166001600160a01b0392909216919091179055565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff16159067ffffffffffffffff16600081158015620011ca5750825b905060008267ffffffffffffffff166001148015620011e85750303b155b905081158015620011f7575080155b15620012165760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff1916600117855583156200124157845460ff60401b1916600160401b1785555b6001600160a01b038816620012995760405162461bcd60e51b815260206004820152601a60248201527f526f757465723a20696e76616c6964205355534420746f6b656e000000000000604482015260640162000595565b6001600160a01b038716620012f15760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c696420706c6174666f726d2077616c6c657400604482015260640162000595565b6001600160a01b038616620013495760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c69642072657761726420636f6e747261637400604482015260640162000595565b620013543362001ef6565b6200135e62001f0b565b600080546001600160a01b03808b166001600160a01b0319928316178355600280548b831690841617905560038054918a16919092161790556001558315620013e157845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b620013f562001ddd565b60005460035460405163095ea7b360e01b81526001600160a01b0391821660048201526000196024820152911690819063095ea7b3906044016020604051808303816000875af11580156200144e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200103f9190620025f2565b6200147e62001ddd565b6001600160a01b038116620014aa57604051631e4fbdf760e01b81526000600482015260240162000595565b620014b58162001e85565b50565b60058484604051620014cc9291906200262c565b90815260200160405180910390208282604051620014ec9291906200262c565b9081526040519081900360200190205460ff1615620015585760405162461bcd60e51b815260206004820152602160248201527f526f757465723a205477656574546f6b656e20616c72656164792065786973746044820152607360f81b606482015260840162000595565b600033905060008585858560008054906101000a90046001600160a01b0316863060405162001587906200215c565b62001599979695949392919062002665565b604051809103906000f080158015620015b6573d6000803e3d6000fd5b50600180549192506000620015cb83620026bd565b9091555050600180546000908152600460205260409081902080546001600160a01b0319166001600160a01b038516179055905490516006906200161390899089906200262c565b90815260200160405180910390208585604051620016339291906200262c565b9081526020016040518091039020819055506001600587876040516200165b9291906200262c565b908152602001604051809103902085856040516200167b9291906200262c565b908152604051908190036020018120805492151560ff1990931692909217909155600154907f3d61bbe11b5c57956c301876bc65294039345c2a491847f4db750b826a8df71890600090a2505050505050565b606081600003620016f65750506040805180820190915260018152600360fc1b602082015290565b8160005b81156200172657806200170d81620026bd565b91506200171e9050600a83620026ef565b9150620016fa565b60008167ffffffffffffffff811115620017445762001744620021bd565b6040519080825280601f01601f1916602001820160405280156200176f576020820181803683370190505b5090505b8415620017e7576200178760018362002616565b915062001796600a8662002706565b620017a3906030620025dc565b60f81b818381518110620017bb57620017bb6200271d565b60200101906001600160f81b031916908160001a905350620017df600a86620026ef565b945062001773565b949350505050565b6040516323b872dd60e01b81526001600160a01b0384811660048301528216602482018190526044820184905282916323b872dd906064016020604051808303816000875af115801562001847573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200186d9190620025f2565b506040516372424d9960e11b8152600481018490526001600160a01b0382169063e4849b3290602401600060405180830381600087803b158015620018b157600080fd5b505af1158015620013e1573d6000803e3d6000fd5b620018eb60405180606001604052806000815260200160008152602001600081525090565b6040518060600160405280612710858562001907919062002733565b620019139190620026ef565b815260200161271062001927888662002733565b620019339190620026ef565b815260200161271062001947878662002733565b620019539190620026ef565b905295945050505050565b60008481526004602081905260408083205481516312662cbb60e31b815291516001600160a01b039091169392849263933165d8928183019286928290030181865afa158015620019b3573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052620019dd91908101906200274d565b90506000826001600160a01b031663efdee94f6040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001a20573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001a469190620027cd565b9050851562001ad05760005460025460405163a9059cbb60e01b81526001600160a01b03918216600482015260248101899052911690819063a9059cbb906044016020604051808303816000875af115801562001aa7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001acd9190620025f2565b50505b60008511801562001ae15750600084115b1562001b5457600354604051635f0e148b60e01b81526001600160a01b0390911690635f0e148b9062001b1f908590899086908a90600401620027ed565b600060405180830381600087803b15801562001b3a57600080fd5b505af115801562001b4f573d6000803e3d6000fd5b505050505b50505050505050565b6000546040516323b872dd60e01b81526001600160a01b038681166004830152306024830152604482018690529091169081906323b872dd906064016020604051808303816000875af115801562001bb9573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001bdf9190620025f2565b5060405163a9059cbb60e01b81526001600160a01b0383811660048301526024820185905282169063a9059cbb906044016020604051808303816000875af115801562001c30573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001c569190620025f2565b505050505050565b306001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016148062001ce857507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031662001cdc600080516020620043f4833981519152546001600160a01b031690565b6001600160a01b031614155b15620010fd5760405163703e46dd60e11b815260040160405180910390fd5b620014b562001ddd565b816001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa92505050801562001d6e575060408051601f3d908101601f1916820190925262001d6b91810190620024fe565b60015b62001d9857604051634c9c8ce360e01b81526001600160a01b038316600482015260240162000595565b600080516020620043f4833981519152811462001dcc57604051632a87526960e21b81526004810182905260240162000595565b62001dd8838362001f15565b505050565b3362001e107f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b031690565b6001600160a01b031614620010fd5760405163118cdaa760e01b815233600482015260240162000595565b306001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614620010fd5760405163703e46dd60e11b815260040160405180910390fd5b7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c19930080546001600160a01b031981166001600160a01b03848116918217845560405192169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a3505050565b62001f0062001f72565b620014b58162001fbc565b620010fd62001f72565b62001f208262001fc6565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a280511562001f685762001dd882826200202e565b6200103f620020ac565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff16620010fd57604051631afcd79f60e31b815260040160405180910390fd5b6200147e62001f72565b806001600160a01b03163b60000362001ffe57604051634c9c8ce360e01b81526001600160a01b038216600482015260240162000595565b600080516020620043f483398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6060600080846001600160a01b0316846040516200204d919062002827565b600060405180830381855af49150503d80600081146200208a576040519150601f19603f3d011682016040523d82523d6000602084013e6200208f565b606091505b5091509150620020a1858383620020cc565b925050505b92915050565b3415620010fd5760405163b398979f60e01b815260040160405180910390fd5b606082620020e557620020df8262002132565b6200212b565b8151158015620020fd57506001600160a01b0384163b155b156200212857604051639996b31560e01b81526001600160a01b038516600482015260240162000595565b50805b9392505050565b805115620021435780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b611bae806200284683390190565b600080604083850312156200217e57600080fd5b50508035926020909101359150565b600060208284031215620021a057600080fd5b5035919050565b6001600160a01b0381168114620014b557600080fd5b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f1916810167ffffffffffffffff81118282101715620021ff57620021ff620021bd565b604052919050565b600067ffffffffffffffff821115620022245762002224620021bd565b50601f01601f191660200190565b600062002249620022438462002207565b620021d3565b90508281528383830111156200225e57600080fd5b828260208301376000602084830101529392505050565b600080604083850312156200228957600080fd5b82356200229681620021a7565b9150602083013567ffffffffffffffff811115620022b357600080fd5b8301601f81018513620022c557600080fd5b620022d68582356020840162002232565b9150509250929050565b600060208284031215620022f357600080fd5b81356200212b81620021a7565b600082601f8301126200231257600080fd5b6200212b8383356020850162002232565b600080604083850312156200233757600080fd5b823567ffffffffffffffff808211156200235057600080fd5b6200235e8683870162002300565b935060208501359150808211156200237557600080fd5b50620022d68582860162002300565b60005b83811015620023a157818101518382015260200162002387565b50506000910152565b60008151808452620023c481602086016020860162002384565b601f01601f19169290920160200192915050565b6020815260006200212b6020830184620023aa565b6000806000606084860312156200240357600080fd5b83356200241081620021a7565b925060208401356200242281620021a7565b915060408401356200243481620021a7565b809150509250925092565b60008083601f8401126200245257600080fd5b50813567ffffffffffffffff8111156200246b57600080fd5b6020830191508360208285010111156200248457600080fd5b9250929050565b60008060008060408587031215620024a257600080fd5b843567ffffffffffffffff80821115620024bb57600080fd5b620024c9888389016200243f565b90965094506020870135915080821115620024e357600080fd5b50620024f2878288016200243f565b95989497509550505050565b6000602082840312156200251157600080fd5b5051919050565b6000806000606084860312156200252e57600080fd5b8351925060208401519150604084015190509250925092565b600080604083850312156200255b57600080fd5b505080516020909101519092909150565b7f5477656574546f6b656e3a20696e76616c696420616d6f756e742e204e657444815269037b63630b927baba1d160b51b602082015260008251620025b981602a85016020870162002384565b91909101602a0192915050565b634e487b7160e01b600052601160045260246000fd5b80820180821115620020a657620020a6620025c6565b6000602082840312156200260557600080fd5b815180151581146200212b57600080fd5b81810381811115620020a657620020a6620025c6565b8183823760009101908152919050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60a0815260006200267b60a08301898b6200263c565b82810360208401526200269081888a6200263c565b6001600160a01b039687166040850152948616606084015250509216608090920191909152949350505050565b600060018201620026d257620026d2620025c6565b5060010190565b634e487b7160e01b600052601260045260246000fd5b600082620027015762002701620026d9565b500490565b600082620027185762002718620026d9565b500690565b634e487b7160e01b600052603260045260246000fd5b8082028115828204841417620020a657620020a6620025c6565b6000602082840312156200276057600080fd5b815167ffffffffffffffff8111156200277857600080fd5b8201601f810184136200278a57600080fd5b80516200279b620022438262002207565b818152856020838501011115620027b157600080fd5b620027c482602083016020860162002384565b95945050505050565b600060208284031215620027e057600080fd5b81516200212b81620021a7565b608081526000620028026080830187620023aa565b6020830195909552506001600160a01b03929092166040830152606090910152919050565b600082516200283b81846020870162002384565b919091019291505056fe60806040523480156200001157600080fd5b5060405162001bae38038062001bae8339810160408190526200003491620002ef565b808560405160200162000048919062000391565b604051602081830303815290604052866040516020016200006a9190620003c8565b60408051601f19818403018152919052600362000088838262000484565b50600462000097828262000484565b5050506001600160a01b038116620000c957604051631e4fbdf760e01b81526000600482015260240160405180910390fd5b620000d481620001b3565b506006620000e3868262000484565b506007620000f2858262000484565b5042600a556000600b819055600c55600980546001600160a01b03199081166001600160a01b038681169182179093556008805490921685841617909155600d805460ff1916905560405163095ea7b360e01b8152918316600483015260001960248301529063095ea7b3906044016020604051808303816000875af115801562000181573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620001a7919062000550565b5050505050506200057b565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015620002385781810151838201526020016200021e565b50506000910152565b600082601f8301126200025357600080fd5b81516001600160401b038082111562000270576200027062000205565b604051601f8301601f19908116603f011681019082821181831017156200029b576200029b62000205565b81604052838152866020858801011115620002b557600080fd5b620002c88460208301602089016200021b565b9695505050505050565b80516001600160a01b0381168114620002ea57600080fd5b919050565b600080600080600060a086880312156200030857600080fd5b85516001600160401b03808211156200032057600080fd5b6200032e89838a0162000241565b965060208801519150808211156200034557600080fd5b50620003548882890162000241565b9450506200036560408701620002d2565b92506200037560608701620002d2565b91506200038560808701620002d2565b90509295509295909350565b6c547765657420546f6b656e202d60981b815260008251620003bb81600d8501602087016200021b565b91909101600d0192915050565b6254542d60e81b815260008251620003e88160038501602087016200021b565b9190910160030192915050565b600181811c908216806200040a57607f821691505b6020821081036200042b57634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200047f57600081815260208120601f850160051c810160208610156200045a5750805b601f850160051c820191505b818110156200047b5782815560010162000466565b5050505b505050565b81516001600160401b03811115620004a057620004a062000205565b620004b881620004b18454620003f5565b8462000431565b602080601f831160018114620004f05760008415620004d75750858301515b600019600386901b1c1916600185901b1785556200047b565b600085815260208120601f198616915b82811015620005215788860151825594840194600190910190840162000500565b5085821015620005405787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6000602082840312156200056357600080fd5b815180151581146200057457600080fd5b9392505050565b611623806200058b6000396000f3fe608060405234801561001057600080fd5b506004361061030a5760003560e01c80637ff5eed11161019d578063c9196b2a116100e9578063e5ee2da2116100a2578063efdee94f1161007c578063efdee94f146105e5578063f2fde38b146105f8578063f39690e41461060b578063f92052c11461061e57600080fd5b8063e5ee2da2146103b4578063e675912d14610444578063ecb05814146105dc57600080fd5b8063c9196b2a1461056b578063c920607f14610574578063cce7ec131461057d578063d4e956dd1461056b578063dd62ed3e14610590578063e4849b32146105c957600080fd5b806395d89b4111610156578063a932492f11610130578063a932492f14610537578063b3ae5d5b1461054d578063b682ff3614610559578063b99f7b391461056257600080fd5b806395d89b411461050f5780639e5f260214610517578063a9059cbb1461052457600080fd5b80637ff5eed1146104be578063842e3004146104c657806384e5eed0146104d25780638da5cb5b146104da578063933165d8146104ff57806393a235c01461050757600080fd5b806342966c681161025c5780635121c4e0116102155780636f91ff2d116101ef5780636f91ff2d1461046e57806370a082311461047a578063715018a6146104a357806379cc6790146104ab57600080fd5b80635121c4e0146103b457806352d369e41461045e5780635ad701c21461046657600080fd5b806342966c68146104075780634930983f1461041c578063497818e21461042f5780634985746f1461043b5780634a04adf5146104445780634a9e6fab1461044d57600080fd5b806318160ddd116102c957806328ce6014116102a357806328ce6014146103d057806329a49e09146103e35780632be3f4ba146103ef578063313ce567146103f857600080fd5b806318160ddd146103ac578063200b5621146103b457806323b872dd146103bd57600080fd5b806202eab71461030f578062113e081461033757806302a77a871461035457806306fdde031461036b578063095ea7b31461038057806310309781146103a3575b600080fd5b610317610627565b604080519384526020840192909252908201526060015b60405180910390f35b61033f61073e565b6040805192835260208301919091520161032e565b61035d6105dc81565b60405190815260200161032e565b6103736107dd565b60405161032e91906113e7565b61039361038e366004611451565b61086f565b604051901515815260200161032e565b61035d600a5481565b60025461035d565b61035d61032081565b6103936103cb36600461147b565b610889565b61033f6103de3660046114b7565b6108ad565b61035d640826299e0081565b61035d6123f081565b6040516012815260200161032e565b61041a6104153660046114b7565b610a36565b005b61033f61042a3660046114b7565b610a43565b61035d6404a817c80081565b61035d600b5481565b61035d6104b081565b61035d69021e19e0c9bab240000081565b61035d60fa81565b61035d610bcc565b61035d6412a05f200081565b61035d6104883660046114d0565b6001600160a01b031660009081526020819052604090205490565b61041a610c9a565b61041a6104b9366004611451565b610cae565b610373610cc7565b61035d6409502f900081565b61035d610d55565b6005546001600160a01b03165b6040516001600160a01b03909116815260200161032e565b610373610e1d565b61035d600081565b610373610e2a565b600d546103939060ff1681565b610393610532366004611451565b610e39565b61035d6e13426172c74d822b878fe80000000081565b61035d6402540be40081565b61035d61232881565b61035d6107d081565b61035d611f4081565b61035d6103e881565b61041a61058b366004611451565b610e47565b61035d61059e3660046114f2565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b61041a6105d73660046114b7565b610e61565b61035d6102ee81565b6008546104e7906001600160a01b031681565b61041a6106063660046114d0565b610fd3565b6009546104e7906001600160a01b031681565b61035d600c5481565b6009546040516370a0823160e01b81523060048201526000918291829182916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610678573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061069c9190611525565b905060006106af826402540be400611554565b90506412a05f200081106106d057506102ee9460fa94506123289350915050565b6409502f900081106106ef575061032094600094506123f09350915050565b6404a817c800811061070f57506104b0946103209450611f409350915050565b6402540be400811061072f57506104b0946103209450611f409350915050565b50600094859450849350915050565b6009546040516370a0823160e01b8152306004820152600091829182916001600160a01b0316906370a0823190602401602060405180830381865afa15801561078b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107af9190611525565b905060006107c2826402540be400611554565b30600090815260208190526040902054909590945092505050565b6060600380546107ec90611567565b80601f016020809104026020016040519081016040528092919081815260200182805461081890611567565b80156108655780601f1061083a57610100808354040283529160200191610865565b820191906000526020600020905b81548152906001019060200180831161084857829003601f168201915b5050505050905090565b60003361087d81858561100e565b60019150505b92915050565b600033610897858285611020565b6108a285858561109e565b506001949350505050565b6000806000306001600160a01b03166384e5eed06040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108f0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109149190611525565b6009546040516370a0823160e01b81523060048201529192506000916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610962573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109869190611525565b90506000610999826402540be400611554565b30600090815260208190526040812054919250906109c19069d3c21bcecceda1000000611554565b905060006127106109d2868a6115a1565b6109dc91906115b8565b905060006109ea828a6115da565b905060006109f884866115a1565b90506000610a068387611554565b90506000610a1482846115b8565b90506000610a2282886115da565b959d959c50949a5050505050505050505050565b610a4033826110fd565b50565b6000806000306001600160a01b03166384e5eed06040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a86573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610aaa9190611525565b6009546040516370a0823160e01b81523060048201529192506000916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610af8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b1c9190611525565b90506000610b2f826402540be400611554565b30600090815260208190526040812054919250610b568269d3c21bcecceda1000000611554565b90506000610b6482856115a1565b90506000610b728a84611554565b90506000610b8082846115b8565b90506000610b8e82886115da565b90506000612710610b9f8b846115a1565b610ba991906115b8565b90506000610bb782846115da565b919e919d50909b505050505050505050505050565b6009546040516370a0823160e01b815230600482015260009182916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610c19573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c3d9190611525565b90506000610c50826402540be400611554565b90506412a05f20008110610c675760039250505090565b6409502f90008110610c7c5760029250505090565b6404a817c8008110610c915760019250505090565b60009250505090565b610ca2611133565b610cac6000611160565b565b610cb9823383611020565b610cc382826110fd565b5050565b60068054610cd490611567565b80601f0160208091040260200160405190810160405280929190818152602001828054610d0090611567565b8015610d4d5780601f10610d2257610100808354040283529160200191610d4d565b820191906000526020600020905b815481529060010190602001808311610d3057829003601f168201915b505050505081565b6009546040516370a0823160e01b815230600482015260009182916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610da2573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610dc69190611525565b90506000610dd9826402540be400611554565b90506409502f90008110610df1576103e89250505090565b6404a817c8008110610e07576105dc9250505090565b6402540be4008110610c91576107d09250505090565b60078054610cd490611567565b6060600480546107ec90611567565b60003361087d81858561109e565b610e4f611133565b610e5982826111b2565b505042600b55565b610e69611133565b60008111610ebe5760405162461bcd60e51b815260206004820152601a60248201527f5477656574546f6b656e3a20696e76616c696420616d6f756e7400000000000060448201526064015b60405180910390fd5b30600090815260208190526040902054811115610f1d5760405162461bcd60e51b815260206004820152601d60248201527f5477656574546f6b656e3a206e6f7420656e6f75676820746f6b656e730000006044820152606401610eb5565b600080610f2983610a43565b9150915060008111610f875760405162461bcd60e51b815260206004820152602160248201527f5477656574546f6b656e3a20696e76616c6964206f757470757420616d6f756e6044820152601d60fa1b6064820152608401610eb5565b610f9130846110fd565b42600c5560408051848152602081018390527f9745885914207e14787933537f5e0fc3685e9b3a89eeeecbc1d10207baa4c790910160405180910390a1505050565b610fdb611133565b6001600160a01b03811661100557604051631e4fbdf760e01b815260006004820152602401610eb5565b610a4081611160565b61101b83838360016111e8565b505050565b6001600160a01b038381166000908152600160209081526040808320938616835292905220546000198114611098578181101561108957604051637dc7a0d960e11b81526001600160a01b03841660048201526024810182905260448101839052606401610eb5565b611098848484840360006111e8565b50505050565b6001600160a01b0383166110c857604051634b637e8f60e11b815260006004820152602401610eb5565b6001600160a01b0382166110f25760405163ec442f0560e01b815260006004820152602401610eb5565b61101b8383836112bd565b6001600160a01b03821661112757604051634b637e8f60e11b815260006004820152602401610eb5565b610cc3826000836112bd565b6005546001600160a01b03163314610cac5760405163118cdaa760e01b8152336004820152602401610eb5565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6001600160a01b0382166111dc5760405163ec442f0560e01b815260006004820152602401610eb5565b610cc3600083836112bd565b6001600160a01b0384166112125760405163e602df0560e01b815260006004820152602401610eb5565b6001600160a01b03831661123c57604051634a1406b160e11b815260006004820152602401610eb5565b6001600160a01b038085166000908152600160209081526040808320938716835292905220829055801561109857826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040516112af91815260200190565b60405180910390a350505050565b6001600160a01b0383166112e85780600260008282546112dd9190611554565b9091555061135a9050565b6001600160a01b0383166000908152602081905260409020548181101561133b5760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610eb5565b6001600160a01b03841660009081526020819052604090209082900390555b6001600160a01b03821661137657600280548290039055611395565b6001600160a01b03821660009081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516113da91815260200190565b60405180910390a3505050565b600060208083528351808285015260005b81811015611414578581018301518582016040015282016113f8565b506000604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b038116811461144c57600080fd5b919050565b6000806040838503121561146457600080fd5b61146d83611435565b946020939093013593505050565b60008060006060848603121561149057600080fd5b61149984611435565b92506114a760208501611435565b9150604084013590509250925092565b6000602082840312156114c957600080fd5b5035919050565b6000602082840312156114e257600080fd5b6114eb82611435565b9392505050565b6000806040838503121561150557600080fd5b61150e83611435565b915061151c60208401611435565b90509250929050565b60006020828403121561153757600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156108835761088361153e565b600181811c9082168061157b57607f821691505b60208210810361159b57634e487b7160e01b600052602260045260246000fd5b50919050565b80820281158282048414176108835761088361153e565b6000826115d557634e487b7160e01b600052601260045260246000fd5b500490565b818103818111156108835761088361153e56fea2646970667358221220f5ca7424f5a55096c31e51e5b80718cebc2a521464354464b943345a7331cd4864736f6c63430008140033360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbca2646970667358221220ea87e2955edcbddf68f0cc3edf9fc0fadc4f6ff6ede938b0f738f05f0015736464736f6c63430008140033

0x608060405260043610620001375760003560e01c80638831e9cf11620000ad578063ec6752eb116200006c578063ec6752eb1462000425578063f2fde38b146200043d578063f39690e41462000462578063fa2af9da1462000484578063ff2dd80314620004a657600080fd5b80638831e9cf14620003015780638da5cb5b1462000326578063ad3cb1cc1462000365578063bc14271f14620003a7578063c0c53b8b146200040057600080fd5b806351508f0a11620000fa57806351508f0a146200021d57806352d1902d146200024257806364796d5b146200025a5780636ea69d6214620002c7578063715018a614620002e957600080fd5b806315242d3f146200013c578063185febff14620001635780632d84950714620001ba5780633042937414620001e15780634f1ef2861462000206575b600080fd5b3480156200014957600080fd5b50620001616200015b3660046200216a565b620004cb565b005b3480156200017057600080fd5b506200019d620001823660046200218d565b6004602052600090815260409020546001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b348015620001c757600080fd5b50620001d260015481565b604051908152602001620001b1565b348015620001ee57600080fd5b5062000161620002003660046200216a565b62000ae0565b620001616200021736600462002275565b6200101e565b3480156200022a57600080fd5b50620001616200023c366004620022e0565b62001043565b3480156200024f57600080fd5b50620001d2620010c7565b3480156200026757600080fd5b50620002b66200027936600462002323565b8151602081840181018051600582529282019482019490942091909352815180830184018051928152908401929093019190912091525460ff1681565b6040519015158152602001620001b1565b348015620002d457600080fd5b506003546200019d906001600160a01b031681565b348015620002f657600080fd5b5062000161620010e7565b3480156200030e57600080fd5b506200016162000320366004620022e0565b620010ff565b3480156200033357600080fd5b507f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b03166200019d565b3480156200037257600080fd5b5062000398604051806040016040528060058152602001640352e302e360dc1b81525081565b604051620001b19190620023d8565b348015620003b457600080fd5b50620001d2620003c636600462002323565b8151602081840181018051600682529282019482019490942091909352815180830184018051928152908401929093019190912091525481565b3480156200040d57600080fd5b50620001616200041f366004620023ed565b62001183565b3480156200043257600080fd5b5062000161620013eb565b3480156200044a57600080fd5b50620001616200045c366004620022e0565b62001474565b3480156200046f57600080fd5b506000546200019d906001600160a01b031681565b3480156200049157600080fd5b506002546200019d906001600160a01b031681565b348015620004b357600080fd5b5062000161620004c53660046200248b565b620014b8565b600082815260046020818152604092839020548351632d6b80e160e11b815293516001600160a01b03909116936003938593635ad701c29383830193919290918290030181865afa15801562000525573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200054b9190620024fe565b106200059e5760405162461bcd60e51b815260206004820152601760248201527f5477656574546f6b656e3a2063616e6e6f74206275726e00000000000000000060448201526064015b60405180910390fd5b60008211620005f05760405162461bcd60e51b815260206004820152601a60248201527f5477656574546f6b656e3a20696e76616c696420616d6f756e74000000000000604482015260640162000595565b6040516370a0823160e01b815233600482015282906001600160a01b038316906370a0823190602401602060405180830381865afa15801562000637573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200065d9190620024fe565b1015620006ad5760405162461bcd60e51b815260206004820152601d60248201527f5477656574546f6b656e3a206e6f7420656e6f75676820746f6b656e73000000604482015260640162000595565b604051636eb1769f60e11b815233600482015230602482015282906001600160a01b0383169063dd62ed3e90604401602060405180830381865afa158015620006fa573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620007209190620024fe565b1015620007705760405162461bcd60e51b815260206004820181905260248201527f5477656574546f6b656e3a206e6f7420656e6f75676820616c6c6f77616e6365604482015260640162000595565b6000806000836001600160a01b03166202eab76040518163ffffffff1660e01b8152600401606060405180830381865afa158015620007b3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620007d9919062002518565b925092509250600080856001600160a01b0316634930983f886040518263ffffffff1660e01b81526004016200081191815260200190565b6040805180830381865afa1580156200082e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000854919062002547565b9150915061271081116200086882620016ce565b6040516020016200087a91906200256c565b60405160208183030381529060405290620008aa5760405162461bcd60e51b8152600401620005959190620023d8565b50620008b8338888620017ef565b6000620008c886868686620018c6565b9050620008e4898260000151836020015184604001516200195e565b6000546001600160a01b03166323b872dd8830620009038787620025dc565b6040516001600160e01b031960e086901b1681526001600160a01b03938416600482015292909116602483015260448201526064016020604051808303816000875af115801562000958573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200097e9190620025f2565b620009cc5760405162461bcd60e51b815260206004820152601f60248201527f5472616e736665722066726f6d205477656574546f6b656e206661696c656400604482015260640162000595565b60005460405163a9059cbb60e01b8152336004820152602481018490526001600160a01b039091169063a9059cbb906044016020604051808303816000875af115801562000a1e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000a449190620025f2565b62000a925760405162461bcd60e51b815260206004820152601760248201527f5472616e7366657220746f2075736572206661696c6564000000000000000000604482015260640162000595565b60408051338152602081018a905290810183905289907fad91a82cffe5e37ba0016957c6ff844926418edb7d217b29beee7f81dca46add9060600160405180910390a2505050505050505050565b6000828152600460208181526040808420548151632d6b80e160e11b815291516001600160a01b0390911694938593635ad701c293808301939192908290030181865afa15801562000b36573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000b5c9190620024fe565b90506003811062000bb05760405162461bcd60e51b815260206004820152601760248201527f5477656574546f6b656e3a2063616e6e6f74206d696e74000000000000000000604482015260640162000595565b612710831162000c035760405162461bcd60e51b815260206004820152601a60248201527f5477656574546f6b656e3a20696e76616c696420616d6f756e74000000000000604482015260640162000595565b6000546040516370a0823160e01b81523360048201526001600160a01b0390911690849082906370a0823190602401602060405180830381865afa15801562000c50573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000c769190620024fe565b101562000cc65760405162461bcd60e51b815260206004820152601760248201527f5553443a206e6f7420656e6f7567682062616c616e6365000000000000000000604482015260640162000595565b604051636eb1769f60e11b815233600482015230602482015284906001600160a01b0383169063dd62ed3e90604401602060405180830381865afa15801562000d13573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000d399190620024fe565b101562000d895760405162461bcd60e51b815260206004820152601960248201527f5553443a206e6f7420656e6f75676820616c6c6f77616e636500000000000000604482015260640162000595565b6000806000856001600160a01b03166202eab76040518163ffffffff1660e01b8152600401606060405180830381865afa15801562000dcc573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000df2919062002518565b925092509250600080876001600160a01b03166328ce60148a6040518263ffffffff1660e01b815260040162000e2a91815260200190565b6040805180830381865afa15801562000e47573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000e6d919062002547565b9092509050600062000e80838b62002616565b9050600062000e9287878787620018c6565b905062000ea2338c848d62001b5d565b62000ebc8c8260000151836020015184604001516200195e565b60405163cce7ec1360e01b8152336004820152602481018490526001600160a01b038b169063cce7ec1390604401600060405180830381600087803b15801562000f0557600080fd5b505af115801562000f1a573d6000803e3d6000fd5b505060408051338152602081018f90529081018690528e92507f9d1cc916e0bd9464ed4c9e74f6b36dd1c4cfe96ee87030f07fc4f21bcf7e85cb915060600160405180910390a260008a6001600160a01b0316635ad701c26040518163ffffffff1660e01b8152600401602060405180830381865afa15801562000fa2573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000fc89190620024fe565b9050898111156200100f578c7f8d8a543df333b4c72ca5b1f562eaceb4caa9cd02bac609b4ef7076fd198d587e826040516200100691815260200190565b60405180910390a25b50505050505050505050505050565b6200102862001c5e565b620010338262001d07565b6200103f828262001d11565b5050565b6200104d62001ddd565b6001600160a01b038116620010a55760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c69642072657761726420636f6e747261637400604482015260640162000595565b600380546001600160a01b0319166001600160a01b0392909216919091179055565b6000620010d362001e3b565b50600080516020620043f483398151915290565b620010f162001ddd565b620010fd600062001e85565b565b6200110962001ddd565b6001600160a01b038116620011615760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c696420706c6174666f726d2077616c6c657400604482015260640162000595565b600280546001600160a01b0319166001600160a01b0392909216919091179055565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff16159067ffffffffffffffff16600081158015620011ca5750825b905060008267ffffffffffffffff166001148015620011e85750303b155b905081158015620011f7575080155b15620012165760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff1916600117855583156200124157845460ff60401b1916600160401b1785555b6001600160a01b038816620012995760405162461bcd60e51b815260206004820152601a60248201527f526f757465723a20696e76616c6964205355534420746f6b656e000000000000604482015260640162000595565b6001600160a01b038716620012f15760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c696420706c6174666f726d2077616c6c657400604482015260640162000595565b6001600160a01b038616620013495760405162461bcd60e51b815260206004820152601f60248201527f526f757465723a20696e76616c69642072657761726420636f6e747261637400604482015260640162000595565b620013543362001ef6565b6200135e62001f0b565b600080546001600160a01b03808b166001600160a01b0319928316178355600280548b831690841617905560038054918a16919092161790556001558315620013e157845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b620013f562001ddd565b60005460035460405163095ea7b360e01b81526001600160a01b0391821660048201526000196024820152911690819063095ea7b3906044016020604051808303816000875af11580156200144e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200103f9190620025f2565b6200147e62001ddd565b6001600160a01b038116620014aa57604051631e4fbdf760e01b81526000600482015260240162000595565b620014b58162001e85565b50565b60058484604051620014cc9291906200262c565b90815260200160405180910390208282604051620014ec9291906200262c565b9081526040519081900360200190205460ff1615620015585760405162461bcd60e51b815260206004820152602160248201527f526f757465723a205477656574546f6b656e20616c72656164792065786973746044820152607360f81b606482015260840162000595565b600033905060008585858560008054906101000a90046001600160a01b0316863060405162001587906200215c565b62001599979695949392919062002665565b604051809103906000f080158015620015b6573d6000803e3d6000fd5b50600180549192506000620015cb83620026bd565b9091555050600180546000908152600460205260409081902080546001600160a01b0319166001600160a01b038516179055905490516006906200161390899089906200262c565b90815260200160405180910390208585604051620016339291906200262c565b9081526020016040518091039020819055506001600587876040516200165b9291906200262c565b908152602001604051809103902085856040516200167b9291906200262c565b908152604051908190036020018120805492151560ff1990931692909217909155600154907f3d61bbe11b5c57956c301876bc65294039345c2a491847f4db750b826a8df71890600090a2505050505050565b606081600003620016f65750506040805180820190915260018152600360fc1b602082015290565b8160005b81156200172657806200170d81620026bd565b91506200171e9050600a83620026ef565b9150620016fa565b60008167ffffffffffffffff811115620017445762001744620021bd565b6040519080825280601f01601f1916602001820160405280156200176f576020820181803683370190505b5090505b8415620017e7576200178760018362002616565b915062001796600a8662002706565b620017a3906030620025dc565b60f81b818381518110620017bb57620017bb6200271d565b60200101906001600160f81b031916908160001a905350620017df600a86620026ef565b945062001773565b949350505050565b6040516323b872dd60e01b81526001600160a01b0384811660048301528216602482018190526044820184905282916323b872dd906064016020604051808303816000875af115801562001847573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200186d9190620025f2565b506040516372424d9960e11b8152600481018490526001600160a01b0382169063e4849b3290602401600060405180830381600087803b158015620018b157600080fd5b505af1158015620013e1573d6000803e3d6000fd5b620018eb60405180606001604052806000815260200160008152602001600081525090565b6040518060600160405280612710858562001907919062002733565b620019139190620026ef565b815260200161271062001927888662002733565b620019339190620026ef565b815260200161271062001947878662002733565b620019539190620026ef565b905295945050505050565b60008481526004602081905260408083205481516312662cbb60e31b815291516001600160a01b039091169392849263933165d8928183019286928290030181865afa158015620019b3573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052620019dd91908101906200274d565b90506000826001600160a01b031663efdee94f6040518163ffffffff1660e01b8152600401602060405180830381865afa15801562001a20573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001a469190620027cd565b9050851562001ad05760005460025460405163a9059cbb60e01b81526001600160a01b03918216600482015260248101899052911690819063a9059cbb906044016020604051808303816000875af115801562001aa7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001acd9190620025f2565b50505b60008511801562001ae15750600084115b1562001b5457600354604051635f0e148b60e01b81526001600160a01b0390911690635f0e148b9062001b1f908590899086908a90600401620027ed565b600060405180830381600087803b15801562001b3a57600080fd5b505af115801562001b4f573d6000803e3d6000fd5b505050505b50505050505050565b6000546040516323b872dd60e01b81526001600160a01b038681166004830152306024830152604482018690529091169081906323b872dd906064016020604051808303816000875af115801562001bb9573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001bdf9190620025f2565b5060405163a9059cbb60e01b81526001600160a01b0383811660048301526024820185905282169063a9059cbb906044016020604051808303816000875af115801562001c30573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001c569190620025f2565b505050505050565b306001600160a01b037f000000000000000000000000c5479e768e39a38c07891d7581114de4b81c202216148062001ce857507f000000000000000000000000c5479e768e39a38c07891d7581114de4b81c20226001600160a01b031662001cdc600080516020620043f4833981519152546001600160a01b031690565b6001600160a01b031614155b15620010fd5760405163703e46dd60e11b815260040160405180910390fd5b620014b562001ddd565b816001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa92505050801562001d6e575060408051601f3d908101601f1916820190925262001d6b91810190620024fe565b60015b62001d9857604051634c9c8ce360e01b81526001600160a01b038316600482015260240162000595565b600080516020620043f4833981519152811462001dcc57604051632a87526960e21b81526004810182905260240162000595565b62001dd8838362001f15565b505050565b3362001e107f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c199300546001600160a01b031690565b6001600160a01b031614620010fd5760405163118cdaa760e01b815233600482015260240162000595565b306001600160a01b037f000000000000000000000000c5479e768e39a38c07891d7581114de4b81c20221614620010fd5760405163703e46dd60e11b815260040160405180910390fd5b7f9016d09d72d40fdae2fd8ceac6b6234c7706214fd39c1cd1e609a0528c19930080546001600160a01b031981166001600160a01b03848116918217845560405192169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a3505050565b62001f0062001f72565b620014b58162001fbc565b620010fd62001f72565b62001f208262001fc6565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a280511562001f685762001dd882826200202e565b6200103f620020ac565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff16620010fd57604051631afcd79f60e31b815260040160405180910390fd5b6200147e62001f72565b806001600160a01b03163b60000362001ffe57604051634c9c8ce360e01b81526001600160a01b038216600482015260240162000595565b600080516020620043f483398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6060600080846001600160a01b0316846040516200204d919062002827565b600060405180830381855af49150503d80600081146200208a576040519150601f19603f3d011682016040523d82523d6000602084013e6200208f565b606091505b5091509150620020a1858383620020cc565b925050505b92915050565b3415620010fd5760405163b398979f60e01b815260040160405180910390fd5b606082620020e557620020df8262002132565b6200212b565b8151158015620020fd57506001600160a01b0384163b155b156200212857604051639996b31560e01b81526001600160a01b038516600482015260240162000595565b50805b9392505050565b805115620021435780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b611bae806200284683390190565b600080604083850312156200217e57600080fd5b50508035926020909101359150565b600060208284031215620021a057600080fd5b5035919050565b6001600160a01b0381168114620014b557600080fd5b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f1916810167ffffffffffffffff81118282101715620021ff57620021ff620021bd565b604052919050565b600067ffffffffffffffff821115620022245762002224620021bd565b50601f01601f191660200190565b600062002249620022438462002207565b620021d3565b90508281528383830111156200225e57600080fd5b828260208301376000602084830101529392505050565b600080604083850312156200228957600080fd5b82356200229681620021a7565b9150602083013567ffffffffffffffff811115620022b357600080fd5b8301601f81018513620022c557600080fd5b620022d68582356020840162002232565b9150509250929050565b600060208284031215620022f357600080fd5b81356200212b81620021a7565b600082601f8301126200231257600080fd5b6200212b8383356020850162002232565b600080604083850312156200233757600080fd5b823567ffffffffffffffff808211156200235057600080fd5b6200235e8683870162002300565b935060208501359150808211156200237557600080fd5b50620022d68582860162002300565b60005b83811015620023a157818101518382015260200162002387565b50506000910152565b60008151808452620023c481602086016020860162002384565b601f01601f19169290920160200192915050565b6020815260006200212b6020830184620023aa565b6000806000606084860312156200240357600080fd5b83356200241081620021a7565b925060208401356200242281620021a7565b915060408401356200243481620021a7565b809150509250925092565b60008083601f8401126200245257600080fd5b50813567ffffffffffffffff8111156200246b57600080fd5b6020830191508360208285010111156200248457600080fd5b9250929050565b60008060008060408587031215620024a257600080fd5b843567ffffffffffffffff80821115620024bb57600080fd5b620024c9888389016200243f565b90965094506020870135915080821115620024e357600080fd5b50620024f2878288016200243f565b95989497509550505050565b6000602082840312156200251157600080fd5b5051919050565b6000806000606084860312156200252e57600080fd5b8351925060208401519150604084015190509250925092565b600080604083850312156200255b57600080fd5b505080516020909101519092909150565b7f5477656574546f6b656e3a20696e76616c696420616d6f756e742e204e657444815269037b63630b927baba1d160b51b602082015260008251620025b981602a85016020870162002384565b91909101602a0192915050565b634e487b7160e01b600052601160045260246000fd5b80820180821115620020a657620020a6620025c6565b6000602082840312156200260557600080fd5b815180151581146200212b57600080fd5b81810381811115620020a657620020a6620025c6565b8183823760009101908152919050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60a0815260006200267b60a08301898b6200263c565b82810360208401526200269081888a6200263c565b6001600160a01b039687166040850152948616606084015250509216608090920191909152949350505050565b600060018201620026d257620026d2620025c6565b5060010190565b634e487b7160e01b600052601260045260246000fd5b600082620027015762002701620026d9565b500490565b600082620027185762002718620026d9565b500690565b634e487b7160e01b600052603260045260246000fd5b8082028115828204841417620020a657620020a6620025c6565b6000602082840312156200276057600080fd5b815167ffffffffffffffff8111156200277857600080fd5b8201601f810184136200278a57600080fd5b80516200279b620022438262002207565b818152856020838501011115620027b157600080fd5b620027c482602083016020860162002384565b95945050505050565b600060208284031215620027e057600080fd5b81516200212b81620021a7565b608081526000620028026080830187620023aa565b6020830195909552506001600160a01b03929092166040830152606090910152919050565b600082516200283b81846020870162002384565b919091019291505056fe60806040523480156200001157600080fd5b5060405162001bae38038062001bae8339810160408190526200003491620002ef565b808560405160200162000048919062000391565b604051602081830303815290604052866040516020016200006a9190620003c8565b60408051601f19818403018152919052600362000088838262000484565b50600462000097828262000484565b5050506001600160a01b038116620000c957604051631e4fbdf760e01b81526000600482015260240160405180910390fd5b620000d481620001b3565b506006620000e3868262000484565b506007620000f2858262000484565b5042600a556000600b819055600c55600980546001600160a01b03199081166001600160a01b038681169182179093556008805490921685841617909155600d805460ff1916905560405163095ea7b360e01b8152918316600483015260001960248301529063095ea7b3906044016020604051808303816000875af115801562000181573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620001a7919062000550565b5050505050506200057b565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015620002385781810151838201526020016200021e565b50506000910152565b600082601f8301126200025357600080fd5b81516001600160401b038082111562000270576200027062000205565b604051601f8301601f19908116603f011681019082821181831017156200029b576200029b62000205565b81604052838152866020858801011115620002b557600080fd5b620002c88460208301602089016200021b565b9695505050505050565b80516001600160a01b0381168114620002ea57600080fd5b919050565b600080600080600060a086880312156200030857600080fd5b85516001600160401b03808211156200032057600080fd5b6200032e89838a0162000241565b965060208801519150808211156200034557600080fd5b50620003548882890162000241565b9450506200036560408701620002d2565b92506200037560608701620002d2565b91506200038560808701620002d2565b90509295509295909350565b6c547765657420546f6b656e202d60981b815260008251620003bb81600d8501602087016200021b565b91909101600d0192915050565b6254542d60e81b815260008251620003e88160038501602087016200021b565b9190910160030192915050565b600181811c908216806200040a57607f821691505b6020821081036200042b57634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200047f57600081815260208120601f850160051c810160208610156200045a5750805b601f850160051c820191505b818110156200047b5782815560010162000466565b5050505b505050565b81516001600160401b03811115620004a057620004a062000205565b620004b881620004b18454620003f5565b8462000431565b602080601f831160018114620004f05760008415620004d75750858301515b600019600386901b1c1916600185901b1785556200047b565b600085815260208120601f198616915b82811015620005215788860151825594840194600190910190840162000500565b5085821015620005405787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6000602082840312156200056357600080fd5b815180151581146200057457600080fd5b9392505050565b611623806200058b6000396000f3fe608060405234801561001057600080fd5b506004361061030a5760003560e01c80637ff5eed11161019d578063c9196b2a116100e9578063e5ee2da2116100a2578063efdee94f1161007c578063efdee94f146105e5578063f2fde38b146105f8578063f39690e41461060b578063f92052c11461061e57600080fd5b8063e5ee2da2146103b4578063e675912d14610444578063ecb05814146105dc57600080fd5b8063c9196b2a1461056b578063c920607f14610574578063cce7ec131461057d578063d4e956dd1461056b578063dd62ed3e14610590578063e4849b32146105c957600080fd5b806395d89b4111610156578063a932492f11610130578063a932492f14610537578063b3ae5d5b1461054d578063b682ff3614610559578063b99f7b391461056257600080fd5b806395d89b411461050f5780639e5f260214610517578063a9059cbb1461052457600080fd5b80637ff5eed1146104be578063842e3004146104c657806384e5eed0146104d25780638da5cb5b146104da578063933165d8146104ff57806393a235c01461050757600080fd5b806342966c681161025c5780635121c4e0116102155780636f91ff2d116101ef5780636f91ff2d1461046e57806370a082311461047a578063715018a6146104a357806379cc6790146104ab57600080fd5b80635121c4e0146103b457806352d369e41461045e5780635ad701c21461046657600080fd5b806342966c68146104075780634930983f1461041c578063497818e21461042f5780634985746f1461043b5780634a04adf5146104445780634a9e6fab1461044d57600080fd5b806318160ddd116102c957806328ce6014116102a357806328ce6014146103d057806329a49e09146103e35780632be3f4ba146103ef578063313ce567146103f857600080fd5b806318160ddd146103ac578063200b5621146103b457806323b872dd146103bd57600080fd5b806202eab71461030f578062113e081461033757806302a77a871461035457806306fdde031461036b578063095ea7b31461038057806310309781146103a3575b600080fd5b610317610627565b604080519384526020840192909252908201526060015b60405180910390f35b61033f61073e565b6040805192835260208301919091520161032e565b61035d6105dc81565b60405190815260200161032e565b6103736107dd565b60405161032e91906113e7565b61039361038e366004611451565b61086f565b604051901515815260200161032e565b61035d600a5481565b60025461035d565b61035d61032081565b6103936103cb36600461147b565b610889565b61033f6103de3660046114b7565b6108ad565b61035d640826299e0081565b61035d6123f081565b6040516012815260200161032e565b61041a6104153660046114b7565b610a36565b005b61033f61042a3660046114b7565b610a43565b61035d6404a817c80081565b61035d600b5481565b61035d6104b081565b61035d69021e19e0c9bab240000081565b61035d60fa81565b61035d610bcc565b61035d6412a05f200081565b61035d6104883660046114d0565b6001600160a01b031660009081526020819052604090205490565b61041a610c9a565b61041a6104b9366004611451565b610cae565b610373610cc7565b61035d6409502f900081565b61035d610d55565b6005546001600160a01b03165b6040516001600160a01b03909116815260200161032e565b610373610e1d565b61035d600081565b610373610e2a565b600d546103939060ff1681565b610393610532366004611451565b610e39565b61035d6e13426172c74d822b878fe80000000081565b61035d6402540be40081565b61035d61232881565b61035d6107d081565b61035d611f4081565b61035d6103e881565b61041a61058b366004611451565b610e47565b61035d61059e3660046114f2565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b61041a6105d73660046114b7565b610e61565b61035d6102ee81565b6008546104e7906001600160a01b031681565b61041a6106063660046114d0565b610fd3565b6009546104e7906001600160a01b031681565b61035d600c5481565b6009546040516370a0823160e01b81523060048201526000918291829182916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610678573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061069c9190611525565b905060006106af826402540be400611554565b90506412a05f200081106106d057506102ee9460fa94506123289350915050565b6409502f900081106106ef575061032094600094506123f09350915050565b6404a817c800811061070f57506104b0946103209450611f409350915050565b6402540be400811061072f57506104b0946103209450611f409350915050565b50600094859450849350915050565b6009546040516370a0823160e01b8152306004820152600091829182916001600160a01b0316906370a0823190602401602060405180830381865afa15801561078b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107af9190611525565b905060006107c2826402540be400611554565b30600090815260208190526040902054909590945092505050565b6060600380546107ec90611567565b80601f016020809104026020016040519081016040528092919081815260200182805461081890611567565b80156108655780601f1061083a57610100808354040283529160200191610865565b820191906000526020600020905b81548152906001019060200180831161084857829003601f168201915b5050505050905090565b60003361087d81858561100e565b60019150505b92915050565b600033610897858285611020565b6108a285858561109e565b506001949350505050565b6000806000306001600160a01b03166384e5eed06040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108f0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109149190611525565b6009546040516370a0823160e01b81523060048201529192506000916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610962573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109869190611525565b90506000610999826402540be400611554565b30600090815260208190526040812054919250906109c19069d3c21bcecceda1000000611554565b905060006127106109d2868a6115a1565b6109dc91906115b8565b905060006109ea828a6115da565b905060006109f884866115a1565b90506000610a068387611554565b90506000610a1482846115b8565b90506000610a2282886115da565b959d959c50949a5050505050505050505050565b610a4033826110fd565b50565b6000806000306001600160a01b03166384e5eed06040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a86573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610aaa9190611525565b6009546040516370a0823160e01b81523060048201529192506000916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610af8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b1c9190611525565b90506000610b2f826402540be400611554565b30600090815260208190526040812054919250610b568269d3c21bcecceda1000000611554565b90506000610b6482856115a1565b90506000610b728a84611554565b90506000610b8082846115b8565b90506000610b8e82886115da565b90506000612710610b9f8b846115a1565b610ba991906115b8565b90506000610bb782846115da565b919e919d50909b505050505050505050505050565b6009546040516370a0823160e01b815230600482015260009182916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610c19573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c3d9190611525565b90506000610c50826402540be400611554565b90506412a05f20008110610c675760039250505090565b6409502f90008110610c7c5760029250505090565b6404a817c8008110610c915760019250505090565b60009250505090565b610ca2611133565b610cac6000611160565b565b610cb9823383611020565b610cc382826110fd565b5050565b60068054610cd490611567565b80601f0160208091040260200160405190810160405280929190818152602001828054610d0090611567565b8015610d4d5780601f10610d2257610100808354040283529160200191610d4d565b820191906000526020600020905b815481529060010190602001808311610d3057829003601f168201915b505050505081565b6009546040516370a0823160e01b815230600482015260009182916001600160a01b03909116906370a0823190602401602060405180830381865afa158015610da2573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610dc69190611525565b90506000610dd9826402540be400611554565b90506409502f90008110610df1576103e89250505090565b6404a817c8008110610e07576105dc9250505090565b6402540be4008110610c91576107d09250505090565b60078054610cd490611567565b6060600480546107ec90611567565b60003361087d81858561109e565b610e4f611133565b610e5982826111b2565b505042600b55565b610e69611133565b60008111610ebe5760405162461bcd60e51b815260206004820152601a60248201527f5477656574546f6b656e3a20696e76616c696420616d6f756e7400000000000060448201526064015b60405180910390fd5b30600090815260208190526040902054811115610f1d5760405162461bcd60e51b815260206004820152601d60248201527f5477656574546f6b656e3a206e6f7420656e6f75676820746f6b656e730000006044820152606401610eb5565b600080610f2983610a43565b9150915060008111610f875760405162461bcd60e51b815260206004820152602160248201527f5477656574546f6b656e3a20696e76616c6964206f757470757420616d6f756e6044820152601d60fa1b6064820152608401610eb5565b610f9130846110fd565b42600c5560408051848152602081018390527f9745885914207e14787933537f5e0fc3685e9b3a89eeeecbc1d10207baa4c790910160405180910390a1505050565b610fdb611133565b6001600160a01b03811661100557604051631e4fbdf760e01b815260006004820152602401610eb5565b610a4081611160565b61101b83838360016111e8565b505050565b6001600160a01b038381166000908152600160209081526040808320938616835292905220546000198114611098578181101561108957604051637dc7a0d960e11b81526001600160a01b03841660048201526024810182905260448101839052606401610eb5565b611098848484840360006111e8565b50505050565b6001600160a01b0383166110c857604051634b637e8f60e11b815260006004820152602401610eb5565b6001600160a01b0382166110f25760405163ec442f0560e01b815260006004820152602401610eb5565b61101b8383836112bd565b6001600160a01b03821661112757604051634b637e8f60e11b815260006004820152602401610eb5565b610cc3826000836112bd565b6005546001600160a01b03163314610cac5760405163118cdaa760e01b8152336004820152602401610eb5565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6001600160a01b0382166111dc5760405163ec442f0560e01b815260006004820152602401610eb5565b610cc3600083836112bd565b6001600160a01b0384166112125760405163e602df0560e01b815260006004820152602401610eb5565b6001600160a01b03831661123c57604051634a1406b160e11b815260006004820152602401610eb5565b6001600160a01b038085166000908152600160209081526040808320938716835292905220829055801561109857826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040516112af91815260200190565b60405180910390a350505050565b6001600160a01b0383166112e85780600260008282546112dd9190611554565b9091555061135a9050565b6001600160a01b0383166000908152602081905260409020548181101561133b5760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610eb5565b6001600160a01b03841660009081526020819052604090209082900390555b6001600160a01b03821661137657600280548290039055611395565b6001600160a01b03821660009081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516113da91815260200190565b60405180910390a3505050565b600060208083528351808285015260005b81811015611414578581018301518582016040015282016113f8565b506000604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b038116811461144c57600080fd5b919050565b6000806040838503121561146457600080fd5b61146d83611435565b946020939093013593505050565b60008060006060848603121561149057600080fd5b61149984611435565b92506114a760208501611435565b9150604084013590509250925092565b6000602082840312156114c957600080fd5b5035919050565b6000602082840312156114e257600080fd5b6114eb82611435565b9392505050565b6000806040838503121561150557600080fd5b61150e83611435565b915061151c60208401611435565b90509250929050565b60006020828403121561153757600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156108835761088361153e565b600181811c9082168061157b57607f821691505b60208210810361159b57634e487b7160e01b600052602260045260246000fd5b50919050565b80820281158282048414176108835761088361153e565b6000826115d557634e487b7160e01b600052601260045260246000fd5b500490565b818103818111156108835761088361153e56fea2646970667358221220f5ca7424f5a55096c31e51e5b80718cebc2a521464354464b943345a7331cd4864736f6c63430008140033360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbca2646970667358221220ea87e2955edcbddf68f0cc3edf9fc0fadc4f6ff6ede938b0f738f05f0015736464736f6c63430008140033