Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE

More Options

• Similar
• Submit Audit
• Compare

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

import "../v1/NameRegistry.sol";
import "./INameRegistryV2.sol";

// import "hardhat/console.sol";

contract NameRegistryV2 is NameRegistry, INameRegistryV2 {

    using EnumerableSet for EnumerableSet.StringSet;
    using StringLib for string;

    /**
     * @notice Used to managed the regisgered status of ownerName and appName
     * @param registered true if registered before
     * @param DID matched DID
     */
    struct OwnerNameInfo {
        bool registered;
        address DID;
    }
    
    /**
     * @notice DID to owner name
     */
    mapping (address => string) internal _didOwnerName;

    /**
     * @notice owner name registered status
     * @dev Owner name is unique in the contract. 1:1 matched to the DID
     */
    mapping (string => OwnerNameInfo) internal _ownerNameInfo;

    /**
     * @notice DID to App name list
     */
    mapping (address => EnumerableSet.StringSet) internal _didApps;

    /**
     * @notice Meta data list of a DID's appName
     * @dev App name is unique in a DID's app name list. DID => app name => 
     */
    mapping (address => mapping(string => AppMetaDataItem[])) internal _didAppMetaData;

    /**
     * @notice Verida token address
     * @dev Used to pay the fees while registering an application
     */
    IERC20Upgradeable internal vdaToken;

    /**
     * @notice Fee for registering app
     */
    uint internal appRegisterFee;

    bool internal _isAppRegisterEnabled;

    /*
     * @notice Gap for later use
     */
    uint256[50] private __gap;

    error AppRegisterNotEnabled();
    error InvalidOwnerName();
    error DuplicatedOwnerName();
    error InvalidAppName();
    error DuplicatedAppName();
    error InvalidDomainName();
    error AppNotFound(bool isInvalidOwner, bool isInvalidApp);
    error NoDomainInAppMetaData();
    error InvalidValue();
    error TokenAddressNotSet();
    error AppRegisterFeeNotSet();

    /**
     * @notice Check a lower-cased string whether contains [a-z] and allowed special characters
     * @param input Lower-cased string
     * @param allowedCharacters String of allowed special characters
     * @return bool true if valid
     */
    function _isValidString(string memory input, string memory allowedCharacters) internal pure virtual returns(bool) {
        bytes memory inputBytes = bytes(input);
        uint len = inputBytes.length;
        bytes1 char;
        if (len == 0) {
            return false;
        }
        bytes memory specialChars = bytes(allowedCharacters);
        uint specLen = specialChars.length;

        unchecked {
            for (uint i; i < len;) {
                char = inputBytes[i];
                if (!(char >= 0x61 && char <= 0x7a) && !(char >= 0x30 && char <= 0x39)) {
                    bool isSpecChar;
                    for (uint j; j < specLen;) {
                        if (char == specialChars[j]) {
                            isSpecChar = true;
                            break;
                        }
                        ++j;
                    }
                    if (!isSpecChar) {
                        return false;
                    }
                }
                ++i;
            }
        }

        return true;
    }

    /**
     * @notice Validate the owner name in the `registerApp()` function
     * @param did DID
     * @param ownerName Wwner name to be registered
     * @return string Lowercased owner name
     */
    function _validateOwnerName(address did, string calldata ownerName) internal virtual returns(string memory) {
        string memory _ownerName;
        _ownerName = ownerName.lower();

        // Check validity of characters
        if (!_isValidString(_ownerName, " ")) {
            revert InvalidOwnerName();
        }
        
        OwnerNameInfo storage status = _ownerNameInfo[_ownerName];
        // Check owner name is registered
        if (status.registered) {
            if (status.DID == did) {
                return _ownerName;
            } else {
                revert DuplicatedOwnerName();
            }
        }

        // Check DID has an owner name
        if (bytes(_didOwnerName[did]).length != 0) {
            // If DID has no owner name registered
            revert InvalidOwnerName();
        }

        return _ownerName;
    }

    /**
     * @notice Validate the app name in the `registerApp()` function
     * @param did DID
     * @param appName App name to be registered
     * @return string Lowercased app name
     */
    function _validateAppName(address did, string calldata appName) internal virtual returns(string memory) {
        string memory _appName;
        // Check validity of characters
        _appName = appName.lower();

        if (!_isValidString(_appName, " ")) {
            revert InvalidAppName();
        }

        if (_didApps[did].contains(_appName)) {
            revert DuplicatedAppName();
        }

        return _appName;
    }

    /**
     * @notice Validate `metadata` of the `registerApp()` function and returns packed data
     * @dev The packed meta data is used to verify the request
     * @param metadata App meta data
     * @return bytes Packed meta data
     */
    function _getAppMetaDataPacked(AppMetaDataItem[] calldata metadata) internal pure virtual returns(bytes memory) {
        uint len = metadata.length;
        bytes memory ret;
        bool isDomainIncluded;

        bytes32 domainKey = keccak256(bytes("domain"));

        for (uint i; i < len;) {
            if (keccak256(bytes(metadata[i].key)) == domainKey) {
                isDomainIncluded = true;
                if (!_isValidString(metadata[i].value, "_-")) {
                    revert InvalidDomainName();
                }
            }
            ret = abi.encodePacked(ret, metadata[i].key, metadata[i].value);
            unchecked {
                ++i;
            }
        }

        if (!isDomainIncluded) {
            revert NoDomainInAppMetaData();
        }

        return ret;
    }

    /**
     * @notice Verify whether a given request is valid. Verifies the nonce of the DID making the request.
     * @dev Verify the signature & proof signed by valid signers
     * @param did DID that made the request. Nonce will be incremented against this DID to avoid replay attacks.
     * @param params Parameters of the message.
     * @param signature A signature that matches sign(${didSignAddress}, params)
     * @param proof Proof A signature that matches sign(did, `${didAddress}${didSignAddress}`)
     */
    function verifyRequest(
        address did, 
        bytes memory params, 
        bytes memory signature, 
        bytes memory proof
    ) internal virtual {
        // Verify the nonce is valid by including it in the unsignedData to be checked
        uint didNonce = _nonce[did];
        bytes memory unsignedParams = abi.encodePacked(
            params,
            didNonce
        );

        address[] memory signers = new address[](1);
        signers[0] = did;

        // Verify the params were signed by the DID making the request
        VeridaDataVerificationLib.verifyDataWithSigners(
            unsignedParams,
            signature,
            proof,
            signers
        );

        // Increment the nonce to prevent replay attacks
        ++_nonce[did];
    }

    /**
     * @notice Receive App registering fee
     * @dev Used in the `registerApp()` function
     *      No need to check token address here because `enableAppRegister()` checked it
     * @param from Address that pays the fee
     */
    function _receiveAppFee(address from) internal virtual {
        // To-do check fee can be 0
        if (appRegisterFee > 0) {
            vdaToken.transferFrom(from, address(this), appRegisterFee);
        }
    }

    /**
     * @notice Register app info to storage
     * @dev Used in the `registerApp()` function
     */
    function _registerAppInfo(
        address did,
        string memory ownerName,
        string memory appName,
        AppMetaDataItem[] calldata metadata
    ) internal virtual {
        // Register owner name
        _didOwnerName[did] = ownerName;
        _ownerNameInfo[ownerName].registered = true;
        _ownerNameInfo[ownerName].DID = did;

        // Register app name
        _didApps[did].add(appName);

        AppMetaDataItem[] storage appData = _didAppMetaData[did][appName];
        uint len = metadata.length;
        for (uint i; i < len;) {
            appData.push(metadata[i]);
            unchecked {
                ++i;
            }
        }
    }
    
    /**
     * @dev See {INameRegistryV2}
     */
    function registerApp(
        address did,
        string calldata ownerName,
        string calldata appName,
        AppMetaDataItem[] calldata metadata,
        bytes calldata requestSignature,
        bytes calldata requestProof
    ) external virtual override {
        string memory _ownerName;
        string memory _appName;

        if (!_isAppRegisterEnabled) {
            revert AppRegisterNotEnabled();
        }

        // Check input values and verify request
        {
            _ownerName = _validateOwnerName(did, ownerName);
            _appName = _validateAppName(did, appName);

            bytes memory params = _getAppMetaDataPacked(metadata);
            params = abi.encodePacked(did, ownerName, appName, params);

            verifyRequest(did, params, requestSignature, requestProof);
        }
        
        _receiveAppFee(tx.origin);

        _registerAppInfo(did, _ownerName, _appName, metadata);

        emit RegisterApp(did, ownerName, appName, metadata);
    }

    /**
     * @notice Check the owner name & app name are registered to the DID
     * @dev Used in `deregisterApp()` and `updateApp()` functions
     * @param did DID
     * @param ownerName Owner name - lowercased
     * @param appName App name - lowercased
     */
    function _validateExistingApp(
        address did,
        string memory ownerName,
        string memory appName
    ) internal view {

        if (_ownerNameInfo[ownerName].DID != did) {
            revert AppNotFound(true, false);
        }

        if (!_didApps[did].contains(appName)) {
            revert AppNotFound(false, true);
        }
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function deregisterApp(
        address did, 
        string calldata ownerName, 
        string calldata appName,
        bytes calldata requestSignature,
        bytes calldata requestProof
    ) external virtual override {
        string memory _ownerName;
        string memory _appName;

        _ownerName = ownerName.lower();
        _appName = appName.lower();

        
        // verify request
        {
            _validateExistingApp(did, _ownerName, _appName);

            bytes memory params = abi.encodePacked(did, ownerName, appName);
            verifyRequest(did, params, requestSignature, requestProof);
        }

        // de-register
        delete _didOwnerName[did];
        delete _ownerNameInfo[_ownerName];

        _didApps[did].remove(_appName);
        delete _didAppMetaData[did][_appName];

        emit DeregisterApp(did, _ownerName, _appName);
    }

    /**
     * @notice Compare 2 strings
     * @param left string
     * @param right string
     * @return bool true if equal
     */
    function _isSameString(string memory left, string memory right) internal pure returns(bool) {
        return keccak256(abi.encodePacked(left)) == keccak256(abi.encodePacked(right));
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function updateApp(
        address did, 
        string calldata ownerName,
        string calldata appName,
        AppMetaDataItem calldata item,
        bytes calldata requestSignature,
        bytes calldata requestProof
    ) external virtual override {
        string memory _ownerName;
        string memory _appName;

        _ownerName = ownerName.lower();
        _appName = appName.lower();

        
        // verify request
        {
            _validateExistingApp(did, _ownerName, _appName);

            bytes memory params = abi.encodePacked(did, ownerName, appName);
            params = abi.encodePacked(params, item.key, item.value);
            verifyRequest(did, params, requestSignature, requestProof);
        }

        AppMetaDataItem[] storage itemList = _didAppMetaData[did][_appName];
        uint len = itemList.length;
        bool isExistingItem;
        for (uint i; i < len;) {
            if (_isSameString(itemList[i].key, item.key)) {
                isExistingItem = true;
                itemList[i].value = item.value;
                break;
            }
            unchecked {
                ++i;
            }
        }
        if (!isExistingItem) {
            itemList.push(item);
        }

        emit UpdateApp(did, _ownerName, _appName, item);
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function getApp(string calldata ownerName, string calldata appName) external view virtual override returns(address, AppMetaDataItem[] memory) {
        string memory _ownerName;
        string memory _appName;
        _ownerName = ownerName.lower();
        _appName = appName.lower();


        if (!_ownerNameInfo[_ownerName].registered) {
            revert InvalidOwnerName();
        }

        address did;
        did = _ownerNameInfo[_ownerName].DID;

        if (!_didApps[did].contains(_appName)) {
            revert InvalidAppName();
        }

        return (did, _didAppMetaData[did][_appName]);
    }


    /**
     * @dev See {INameRegistryV2}
     *      Once token address is set, it will never be set as zero address
     */
    function setTokenAddress(IERC20Upgradeable tokenAddr) external virtual payable override onlyOwner {
        assembly {
            if iszero(tokenAddr) {
                let ptr := mload(0x40)
                mstore(ptr, 0xaa7feadc00000000000000000000000000000000000000000000000000000000)
                revert(ptr, 0x4) //revert InvalidValue()
            }
        }

        if (address(vdaToken) == address(tokenAddr)) {
            revert InvalidValue();
        }

        vdaToken = tokenAddr;

        emit SetTokenAddress(address(tokenAddr));
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function getTokenAddress() external view virtual override returns(address) {
        return address(vdaToken);
    }

    /**
     * @dev See {INameRegistryV2}
     *      Once fee is set, it will never be updated as 0
     */
    function updateAppRegisterFee(uint feeAmount) external virtual payable override onlyOwner {
        if (feeAmount == appRegisterFee || feeAmount == 0) {
            revert InvalidValue();
        }

        uint orgFee = appRegisterFee;
        appRegisterFee = feeAmount;

        emit UpdateAppRegisterFee(orgFee, appRegisterFee);
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function getAppRegisterFee() external view virtual override returns(uint) {
        return appRegisterFee;
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function setAppRegisterEnabled(bool isEnabled) external virtual payable override onlyOwner {
        if (_isAppRegisterEnabled == isEnabled) {
            revert InvalidValue();
        }

        if (isEnabled) {
            address tokenAddr =  address(vdaToken);
            assembly {
                if iszero(tokenAddr) {
                    let ptr := mload(0x40)
                    mstore(ptr, 0x898921d600000000000000000000000000000000000000000000000000000000)
                    revert(ptr, 0x4) //revert TokenAddressNotSet()
                }
            }
        }

        if (appRegisterFee == 0) {
            revert AppRegisterFeeNotSet();
        }

        _isAppRegisterEnabled = isEnabled;

        emit AppRegisterEnabled(_isAppRegisterEnabled);
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function isAppRegisterEnabled() external view virtual override returns(bool) {
        return _isAppRegisterEnabled;
    }

    /**
     * @dev See {INameRegistryV2}
     */
    function getVersion() external pure virtual override returns(string memory) {
        return "2.0";
    }
}

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

pragma solidity ^0.8.0;

import "../utils/ContextUpgradeable.sol";
import "../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.
 *
 * By default, the owner account will be the one that deploys the contract. 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 {
    address private _owner;

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

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

    function __Ownable_init_unchained() internal onlyInitializing {
        _transferOwnership(_msgSender());
    }

    /**
     * @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 {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions anymore. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby removing 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 {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _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);
    }

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[49] private __gap;
}

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

pragma solidity ^0.8.2;

import "../../utils/AddressUpgradeable.sol";

/**
 * @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]
 * ```
 * 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 Indicates that the contract has been initialized.
     * @custom:oz-retyped-from bool
     */
    uint8 private _initialized;

    /**
     * @dev Indicates that the contract is in the process of being initialized.
     */
    bool private _initializing;

    /**
     * @dev Triggered when the contract has been initialized or reinitialized.
     */
    event Initialized(uint8 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 functions marked with `initializer` can be nested in the context of a
     * constructor.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        bool isTopLevelCall = !_initializing;
        require(
            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
            "Initializable: contract is already initialized"
        );
        _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 255 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint8 version) {
        require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
        _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() {
        require(_initializing, "Initializable: contract is not initializing");
        _;
    }

    /**
     * @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 {
        require(!_initializing, "Initializable: contract is initializing");
        if (_initialized < type(uint8).max) {
            _initialized = type(uint8).max;
            emit Initialized(type(uint8).max);
        }
    }

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

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

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

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20Upgradeable {
    /**
     * @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 amount of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

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

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

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 amount) external returns (bool);

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

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

pragma solidity ^0.8.1;

/**
 * @dev Collection of functions related to the address type
 */
library AddressUpgradeable {
    /**
     * @dev Returns true if `account` is a contract.
     *
     * [IMPORTANT]
     * ====
     * It is unsafe to assume that an address for which this function returns
     * false is an externally-owned account (EOA) and not a contract.
     *
     * Among others, `isContract` will return false for the following
     * types of addresses:
     *
     *  - an externally-owned account
     *  - a contract in construction
     *  - an address where a contract will be created
     *  - an address where a contract lived, but was destroyed
     * ====
     *
     * [IMPORTANT]
     * ====
     * You shouldn't rely on `isContract` to protect against flash loan attacks!
     *
     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
     * constructor.
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize/address.code.length, which returns 0
        // for contracts in construction, since the code is only stored at the end
        // of the constructor execution.

        return account.code.length > 0;
    }

    /**
     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
     * `recipient`, forwarding all available gas and reverting on errors.
     *
     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
     * of certain opcodes, possibly making contracts go over the 2300 gas limit
     * imposed by `transfer`, making them unable to receive funds via
     * `transfer`. {sendValue} removes this limitation.
     *
     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
     *
     * IMPORTANT: because control is transferred to `recipient`, care must be
     * taken to not create reentrancy vulnerabilities. Consider using
     * {ReentrancyGuard} or the
     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        require(address(this).balance >= amount, "Address: insufficient balance");

        (bool success, ) = recipient.call{value: amount}("");
        require(success, "Address: unable to send value, recipient may have reverted");
    }

    /**
     * @dev Performs a Solidity function call using a low level `call`. A
     * plain `call` is an unsafe replacement for a function call: use this
     * function instead.
     *
     * If `target` reverts with a revert reason, it is bubbled up by this
     * function (like regular Solidity function calls).
     *
     * Returns the raw returned data. To convert to the expected return value,
     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
     *
     * Requirements:
     *
     * - `target` must be a contract.
     * - calling `target` with `data` must not revert.
     *
     * _Available since v3.1._
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, "Address: low-level call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
     * `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
    }

    /**
     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
     * with `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(address(this).balance >= value, "Address: insufficient balance for call");
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        return functionStaticCall(target, data, "Address: low-level static call failed");
    }

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

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) 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(errorMessage);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;
import "../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;
    }

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[50] private __gap;
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/ECDSA.sol)

pragma solidity ^0.8.0;

import "../StringsUpgradeable.sol";

/**
 * @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 ECDSAUpgradeable {
    enum RecoverError {
        NoError,
        InvalidSignature,
        InvalidSignatureLength,
        InvalidSignatureS,
        InvalidSignatureV // Deprecated in v4.8
    }

    function _throwError(RecoverError error) private pure {
        if (error == RecoverError.NoError) {
            return; // no error: do nothing
        } else if (error == RecoverError.InvalidSignature) {
            revert("ECDSA: invalid signature");
        } else if (error == RecoverError.InvalidSignatureLength) {
            revert("ECDSA: invalid signature length");
        } else if (error == RecoverError.InvalidSignatureS) {
            revert("ECDSA: invalid signature 's' value");
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature` or error string. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode 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 {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]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
        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);
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature`. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode 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 {toEthSignedMessageHash} on it.
     */
    function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, signature);
        _throwError(error);
        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]
     *
     * _Available since v4.3._
     */
    function tryRecover(
        bytes32 hash,
        bytes32 r,
        bytes32 vs
    ) internal pure returns (address, RecoverError) {
        bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
        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.
     *
     * _Available since v4.2._
     */
    function recover(
        bytes32 hash,
        bytes32 r,
        bytes32 vs
    ) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, r, vs);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
     * `r` and `s` signature fields separately.
     *
     * _Available since v4.3._
     */
    function tryRecover(
        bytes32 hash,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) internal pure returns (address, RecoverError) {
        // 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);
        }

        // 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);
        }

        return (signer, RecoverError.NoError);
    }

    /**
     * @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) = tryRecover(hash, v, r, s);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from a `hash`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
        // 32 is the length in bytes of hash,
        // enforced by the type signature above
        return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from `s`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", StringsUpgradeable.toString(s.length), s));
    }

    /**
     * @dev Returns an Ethereum Signed Typed Data, created from a
     * `domainSeparator` and a `structHash`. This produces hash corresponding
     * to the one signed with the
     * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
     * JSON-RPC method as part of EIP-712.
     *
     * See {recover}.
     */
    function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library MathUpgradeable {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

    /**
     * @dev Returns the largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

    /**
     * @dev Returns the smallest of two numbers.
     */
    function min(uint256 a, uint256 b) internal pure returns (uint256) {
        return a < b ? a : b;
    }

    /**
     * @dev Returns the average of two numbers. The result is rounded towards
     * zero.
     */
    function average(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b) / 2 can overflow.
        return (a & b) + (a ^ b) / 2;
    }

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

    /**
     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
     * with further edits by Uniswap Labs also under MIT license.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator
    ) internal pure returns (uint256 result) {
        unchecked {
            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2^256 + prod0.
            uint256 prod0; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod0 := mul(x, y)
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1);

            ///////////////////////////////////////////////
            // 512 by 256 division.
            ///////////////////////////////////////////////

            // Make division exact by subtracting the remainder from [prod1 prod0].
            uint256 remainder;
            assembly {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                prod1 := sub(prod1, gt(remainder, prod0))
                prod0 := sub(prod0, remainder)
            }

            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
            // See https://cs.stackexchange.com/q/138556/92363.

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [prod1 prod0] by twos.
                prod0 := div(prod0, twos)

                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                twos := add(div(sub(0, twos), twos), 1)
            }

            // Shift in bits from prod1 into prod0.
            prod0 |= prod1 * twos;

            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv = 1 mod 2^4.
            uint256 inverse = (3 * denominator) ^ 2;

            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
            // in modular arithmetic, doubling the correct bits in each step.
            inverse *= 2 - denominator * inverse; // inverse mod 2^8
            inverse *= 2 - denominator * inverse; // inverse mod 2^16
            inverse *= 2 - denominator * inverse; // inverse mod 2^32
            inverse *= 2 - denominator * inverse; // inverse mod 2^64
            inverse *= 2 - denominator * inverse; // inverse mod 2^128
            inverse *= 2 - denominator * inverse; // inverse mod 2^256

            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
            // is no longer required.
            result = prod0 * inverse;
            return result;
        }
    }

    /**
     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator,
        Rounding rounding
    ) internal pure returns (uint256) {
        uint256 result = mulDiv(x, y, denominator);
        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
     *
     * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        if (a == 0) {
            return 0;
        }

        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
        //
        // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
        //
        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
        //
        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
        uint256 result = 1 << (log2(a) >> 1);

        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
        // into the expected uint128 result.
        unchecked {
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            return min(result, a / result);
        }
    }

    /**
     * @notice Calculates sqrt(a), following the selected rounding direction.
     */
    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = sqrt(a);
            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 128;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 64;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 32;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 16;
            }
            if (value >> 8 > 0) {
                value >>= 8;
                result += 8;
            }
            if (value >> 4 > 0) {
                value >>= 4;
                result += 4;
            }
            if (value >> 2 > 0) {
                value >>= 2;
                result += 2;
            }
            if (value >> 1 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log2(value);
            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 10, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >= 10**64) {
                value /= 10**64;
                result += 64;
            }
            if (value >= 10**32) {
                value /= 10**32;
                result += 32;
            }
            if (value >= 10**16) {
                value /= 10**16;
                result += 16;
            }
            if (value >= 10**8) {
                value /= 10**8;
                result += 8;
            }
            if (value >= 10**4) {
                value /= 10**4;
                result += 4;
            }
            if (value >= 10**2) {
                value /= 10**2;
                result += 2;
            }
            if (value >= 10**1) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log10(value);
            return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 256, rounded down, of a positive value.
     * Returns 0 if given 0.
     *
     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
     */
    function log256(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 16;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 8;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 4;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 2;
            }
            if (value >> 8 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/MathUpgradeable.sol";

/**
 * @dev String operations.
 */
library StringsUpgradeable {
    bytes16 private constant _SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        unchecked {
            uint256 length = MathUpgradeable.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        unchecked {
            return toHexString(value, MathUpgradeable.log256(value) + 1);
        }
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        bytes memory buffer = new bytes(2 * length + 2);
        buffer[0] = "0";
        buffer[1] = "x";
        for (uint256 i = 2 * length + 1; i > 1; --i) {
            buffer[i] = _SYMBOLS[value & 0xf];
            value >>= 4;
        }
        require(value == 0, "Strings: hex length insufficient");
        return string(buffer);
    }

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
    }
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.18;

library EnumerableSet {
    struct StringSet {
        string[] _values;
        mapping(string => uint256) _indexes;
    }

    function add(StringSet storage set, string memory value) internal returns (bool) {
        if (!contains(set, value)) {
            set._values.push(value);
            // The value is stored at length-1, but we add 1 to all indexes
            // and use 0 as a sentinel value
            set._indexes[value] = set._values.length;
            return true;
        } else {
            return false;
        }
    }

    function remove(StringSet storage set, string memory value) internal returns (bool) {
        // We read and store the value's index to prevent multiple reads from the same storage slot
        uint256 valueIndex = set._indexes[value];

        if (valueIndex != 0) {
            // Equivalent to contains(set, value)
            // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
            // the array, and then remove the last element (sometimes called as 'swap and pop').
            // This modifies the order of the array, as noted in {at}.

            uint256 toDeleteIndex = valueIndex - 1;
            uint256 lastIndex = set._values.length - 1;

            if (lastIndex != toDeleteIndex) {
                string memory lastValue = set._values[lastIndex];

                // Move the last value to the index where the value to delete is
                set._values[toDeleteIndex] = lastValue;
                // Update the index for the moved value
                set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
            }

            // Delete the slot where the moved value was stored
            set._values.pop();

            // Delete the index for the deleted slot
            delete set._indexes[value];

            return true;
        } else {
            return false;
        }
    }

    function clear(StringSet storage set) internal {
        uint len = set._values.length;
        if (len > 0) {
            string memory value;
            for (uint i; i < len;) {
                value = set._values[i];
                delete set._indexes[value];
                unchecked { ++i; }
            }
            delete set._values;
        }
    }

    function contains(StringSet storage set, string memory value) internal view returns (bool) {
        return set._indexes[value] != 0;
    }

    function length(StringSet storage set) internal view returns (uint256) {
        return set._values.length;
    }

    function at(StringSet storage set, uint256 index) internal view returns (string memory) {
        return set._values[index];
    }

    function values(StringSet storage set) internal view returns (string[] memory) {
        return set._values;
    }

}

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

/**
 * Strings Library
 * 
 * In summary this is a simple library of string functions which make simple 
 * string operations less tedious in solidity.
 * 
 * Please be aware these functions can be quite gas heavy so use them only when
 * necessary not to clog the blockchain with expensive transactions.
 * 
 */
library StringLib {
    /**
     * Upper
     * 
     * Converts all the values of a string to their corresponding upper case
     * value.
     * 
     * @param _base When being used for a data type this is the extended object
     *              otherwise this is the string base to convert to upper case
     * @return string 
     */
    function upper(string memory _base)
        internal
        pure
        returns (string memory) {
        bytes memory _baseBytes = bytes(_base);
        for (uint i; i < _baseBytes.length;) {
            _baseBytes[i] = _upper(_baseBytes[i]);
            unchecked { ++i; }
        }
        return string(_baseBytes);
    }

    /**
     * Lower
     * 
     * Converts all the values of a string to their corresponding lower case
     * value.
     * 
     * @param _base When being used for a data type this is the extended object
     *              otherwise this is the string base to convert to lower case
     * @return string 
     */
    function lower(string memory _base)
        internal
        pure
        returns (string memory) {
        bytes memory _baseBytes = bytes(_base);
        for (uint i; i < _baseBytes.length;) {
            _baseBytes[i] = _lower(_baseBytes[i]);
            unchecked { ++i; }
        }
        return string(_baseBytes);
    }

    /**
     * Upper
     * 
     * Convert an alphabetic character to upper case and return the original
     * value when not alphabetic
     * 
     * @param _b1 The byte to be converted to upper case
     * @return bytes1 The converted value if the passed value was alphabetic
     *                and in a lower case otherwise returns the original value
     */
    function _upper(bytes1 _b1)
        private
        pure
        returns (bytes1) {

        if (_b1 >= 0x61 && _b1 <= 0x7A) {
            return bytes1(uint8(_b1) - 32);
        }

        return _b1;
    }

    /**
     * Lower
     * 
     * Convert an alphabetic character to lower case and return the original
     * value when not alphabetic
     * 
     * @param _b1 The byte to be converted to lower case
     * @return bytes1 The converted value if the passed value was alphabetic
     *                and in a upper case otherwise returns the original value
     */
    function _lower(bytes1 _b1)
        private
        pure
        returns (bytes1) {

        if (_b1 >= 0x41 && _b1 <= 0x5A) {
            return bytes1(uint8(_b1) + 32);
        }

        return _b1;
    }
}

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

interface INameRegistry {
    /**
     * @notice Emitted when a name is registered
     * @param name Registred name
     * @param DID DID that registered the `name`
     */
    event Register(string indexed name, address indexed DID);

    /**
     * @notice Emitted when a name is unregistered
     * @param name Unregistered name
     * @param DID DID that unregistered the `name`
     */
    event Unregister(string indexed name, address indexed DID);

    /**
     * @notice Emitted when the contract owner added a suffix
     * @param suffix Added suffix
     */
    event AddSuffix(string indexed suffix);

    /**
     * @notice Emitted when the contract owner update the maximum count of names per DID
     * @param from Previous value
     * @param to Updated value
     */
    event UpdateMaxNamesPerDID(uint from, uint to);

    /**
     * @notice Return the nonce of given DID
     * @param did DID address
     * @return uint nonce of the DID
     */
    function nonce(address did) external view returns(uint);

    /**
     * @notice Register a name
     * @dev Only the names with valid suffix, that is registered in the contract, are available
     * @param name Name to be registered
     * @param did DID address
     * @param signature Signature of parameters signed by the `did`'s private key

     */
    function register(string calldata name, address did, bytes calldata signature) external;

    /**
     * @notice Unregister a name
     * @param name Name to be unregistered. Should be registered before.
     * @param did DID address.
     * @param signature Signature of parameters signed by the `did`'s private key
     */
    function unregister(string calldata name, address did, bytes calldata signature) external;

    /**
     * @notice Find the DID of the given name
     * @dev If the `name` is not registered before, transaction will be reverted
     * @param name Name registered to a DID
     * @return address DID address of the given name
     */
    function findDID(string memory name) external view returns(address);

    /**
     * @notice Get the list of registered names
     * @dev If the `did` has no names registered before, the transaction will be reverted
     * @param did DID address
     * @return string[] List of names
     */
    function getUserNameList(address did) external view returns(string[] memory);

    /**
     * @notice Add a suffix
     * @dev Only the contract owner can add/remove a suffix.
     * @param suffix - Suffix to be added
     */
    function addSuffix(string memory suffix) external payable;

    /**
     * @notice Check the given suffix is valid
     * @param suffix Suffix to be checked
     * @return bool true if valid
     */
    function isValidSuffix(string calldata suffix) external view returns(bool);

    /**
     * @notice Return array of valid suffixes
     * @return string[] List of suffixes
     */
    function getSuffixList() external view returns(string[] memory);

    /**
     * @notice Update maximum number of names per DID
     * @param count Value to be updated
     */
    function updateMaxNamesPerDID(uint count) external payable;
}

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

import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";

// Verida contract dependencies
import "@verida/common-contract/contracts/EnumerableSet.sol";
import "@verida/common-contract/contracts/StringLib.sol";
import "./INameRegistry.sol";
import "../VeridaDataVerificationLib.sol";

/**
 * @title Verida NameRegistry contract
 */
contract NameRegistry is  INameRegistry, OwnableUpgradeable {

    using EnumerableSet for EnumerableSet.StringSet;
    using StringLib for string;

    /**
     * @notice nonce for did
     */
    mapping(address => uint) internal _nonce;

    /**
     * @notice username to did
     */
    mapping(string => address) internal _nameToDID;
    
    /** 
     * @notice DID to username list
     */
    mapping(address => EnumerableSet.StringSet) internal _DIDInfoList;

    /**
     * @notice Allowed suffix list
     */
    EnumerableSet.StringSet internal suffixList;

    /**
     * @notice Maximum names per DID.
     */
    uint public maxNamesPerDID;

    /**
     * @notice Gap for later use
     */
    uint256[20] private __gap;

    // Custom errors
    error InvalidAddress();
    error InvalidSuffix();
    // error InvalidSignature();
    error InvalidName();
    error LimitedNameCount();
    error InvalidNameCount();

    /**
     * @notice Initialize
     */
    function initialize() public initializer {
        __Ownable_init();

        maxNamesPerDID = 1;

        string memory suffix = "vda";
        suffixList.add(suffix);
        emit AddSuffix(suffix);
    }

    /**
     * @dev See {INameRegistry}
     */
    function nonce(address did) external view virtual override returns(uint) {
        return _nonce[did];
    }

    /**
     * @dev See {INameRegistry}
     */
    function register(string calldata name, address did, bytes calldata signature) external virtual override {
        assembly {
            if iszero(did) {
                let ptr := mload(0x40)
                mstore(ptr, 0xe6c4247b00000000000000000000000000000000000000000000000000000000)
                revert(ptr, 0x4) //revert InvalidAddress()
            }
        }
        if(!_isValidSuffix(name)) {
            revert InvalidSuffix();
        }

        {
            uint didNonce = _nonce[did];
            bytes memory paramData = abi.encodePacked(
                name,
                did,
                didNonce
            );

            if (!VeridaDataVerificationLib.validateSignature(paramData, signature, did)) {
                revert InvalidSignature();
            }
            ++_nonce[did];
        }

        string memory _name = name.lower();
        {
            // Check _nameToDID[_name] is zero
            address _nameDID = _nameToDID[_name];
            assembly {
                if eq(iszero(_nameDID), 0) {
                    let ptr := mload(0x40)
                    mstore(ptr, 0x430f13b300000000000000000000000000000000000000000000000000000000)
                    revert(ptr, 0x4) //revert InvalidName()
                }
            }
        }
        
        EnumerableSet.StringSet storage didUserNameList = _DIDInfoList[did];

        if (didUserNameList.length() >= maxNamesPerDID) {
            revert LimitedNameCount();
        }
        
        _nameToDID[_name] = did;
        didUserNameList.add(_name);

        emit Register(name, did);
    }

    /**
     * @dev See {INameRegistry}
     */
    function unregister(string calldata name, address did, bytes calldata signature) external virtual {
        assembly {
            if iszero(did) {
                let ptr := mload(0x40)
                mstore(ptr, 0xe6c4247b00000000000000000000000000000000000000000000000000000000)
                revert(ptr, 0x4) // revert InvalidAddress()
            }
        }
        
        {
            uint didNonce = _nonce[did];
            bytes memory paramData = abi.encodePacked(
                name,
                did,
                didNonce
            );

            if (!VeridaDataVerificationLib.validateSignature(paramData, signature, did)) {
                revert InvalidSignature();
            }
            ++_nonce[did];
        }
        
        string memory _name = name.lower();

        address nameDID = _nameToDID[_name];
        assembly {
            if iszero(nameDID) {
                let ptr := mload(0x40)
                mstore(ptr, 0x430f13b300000000000000000000000000000000000000000000000000000000)
                revert(ptr, 0x4) // revert InvalidName()
            }
        }

        if (nameDID != did) {
            revert InvalidAddress();
        }
        
        EnumerableSet.StringSet storage didUserNameList = _DIDInfoList[nameDID];

        delete _nameToDID[_name];
        didUserNameList.remove(_name);

        emit Unregister(name, nameDID);
    }

    /**
     * @dev See {INameRegistry}
     */
    function findDID(string memory name) external view virtual override returns(address) {
        name = name.lower();

        address nameDID = _nameToDID[name];
        assembly {
            if iszero(nameDID) {
                let ptr := mload(0x40)
                mstore(ptr, 0x430f13b300000000000000000000000000000000000000000000000000000000)
                revert(ptr, 0x4) // revert InvalidName()
            }
        }

        return nameDID;
    }

    /**
     * @dev See {INameRegistry}
     */
    function getUserNameList(address did) external view virtual override returns(string[] memory) {
        EnumerableSet.StringSet storage didUserNameList = _DIDInfoList[did];

        uint256 length = didUserNameList.length();
        if (length == 0) {
            revert InvalidAddress();
        }

        string[] memory userNameList = new string[](length);

        for (uint i; i < length;) {
            userNameList[i] = didUserNameList.at(i);
            unchecked { ++i; }
        }

        return userNameList;
    }

    /**
     * @dev See {INameRegistry}
     */
    function addSuffix(string memory suffix) external virtual payable override onlyOwner {
        suffix = suffix.lower();

        if (suffixList.contains(suffix)) {
            revert InvalidSuffix();
        }

        suffixList.add(suffix);

        emit AddSuffix(suffix);
    }

    /**
     * @notice Check whether name has valid suffix
     * @dev Check all the letters of name inside _getSuffix() function
     * @param name - name to check
     * @return result
     */
    function _isValidSuffix(string calldata name) internal view virtual returns(bool) {
        string memory suffix = _getSuffix(name);
        return suffixList.contains(suffix);
    }

    /**
     * @dev See {INameRegistry}
     */
    function isValidSuffix(string calldata suffix) external view virtual override returns(bool) {
        string memory lower = suffix.lower();
        return suffixList.contains(lower);
    }

    /**
     * @notice Get Suffix from name
     * @dev Rejected if name contains invalid characters or not found suffix.
     * @param name - Input name
     * @return suffix - return suffix in bytes32
     */
    function _getSuffix(string calldata name) internal pure virtual returns(string memory suffix) {
        string memory _name = name.lower();
        bytes memory nameBytes = bytes(_name);
        if (nameBytes.length == 0) {
            revert InvalidName();
        }

        uint len = nameBytes.length;

        uint startIndex = len;
        uint index;
        uint8 dotCount;
        while (index < len && dotCount < 2 && _isValidCharacter(nameBytes[index])) {
            // Find a "."
            unchecked {
                if (nameBytes[index] == 0x2E) {
                    startIndex = index + 1;
                    ++dotCount;
                }

                ++index;
            }
        }
        if (startIndex >= len) {
            revert InvalidName();
        }

        if (dotCount > 1 || index != len || startIndex <= 2 || startIndex >= 34) {
            revert InvalidName();
        }

        bytes memory suffixBytes = new bytes(len - startIndex);

        for (index = startIndex; index < len;) {
            suffixBytes[index - startIndex] = nameBytes[index];
            unchecked { ++index; }
        }

        suffix = string(suffixBytes);
    }

    /**
     * @dev See {INameRegistry}
     */
    function getSuffixList() external view virtual override returns(string[] memory) {
        uint len = suffixList.length();
        string[] memory list = new string[](len);
        for (uint i; i < len;) {
            list[i] = suffixList.at(i);
            unchecked {
                ++i;
            }
        }
        return list;
    }

    /**
     * @notice Check whether character is allowed in NameRegistry
     * @param char - one byte from name string value
     * @return - true if valid.
     */
    function _isValidCharacter(bytes1 char) internal pure virtual returns(bool) {
        if (char >= 0x61 && char <= 0x7a)
            return true;
        if (char >= 0x30 && char <= 0x39)
            return true;
        if (char ==0x5f || char == 0x2d || char == 0x2e)
            return true;
        return false;
    }

    /**
     * @dev See {INameRegistry}
     */
    function updateMaxNamesPerDID(uint count) external virtual payable onlyOwner {
        uint orgValue = maxNamesPerDID;
        if (count <= orgValue) {
            revert InvalidNameCount();
        }
        maxNamesPerDID = count;

        emit UpdateMaxNamesPerDID(orgValue, count);
    }
}

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

import "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol";

interface INameRegistryV2 {
    /**
     * @notice Struct for App meta data
     * @param key Key of item. Ex : "domain"
     * @param value Value of item. Ex: "verida.network"
     */
    struct AppMetaDataItem {
        string key;
        string value;
    }

    /**
     * @notice Emitted when a app is registered
     * @param did DID address
     * @param ownerName Owner name
     * @param appName App name
     * @param metadata Array of key/value pairs
     */
    event RegisterApp(
        address did,
        string ownerName,
        string appName,
        AppMetaDataItem[] metadata
    );

    /**
     * @notice Emitted when an App is de-registered
     * @param did DID address
     * @param ownerName Owner name
     * @param appName App name
     */
    event DeregisterApp(
        address did,
        string ownerName,
        string appName
    );

    /**
     * @notice Emitted when a meta data item of an App is updated
     * @param did DID address
     * @param ownerName Owner's name
     * @param appName App name
     * @param item Meta data item updated
     */
    event UpdateApp(
        address did, 
        string ownerName,
        string appName,
        AppMetaDataItem item
    );

    /**
     * @notice Emitted when the app registering feature enabled/disabled
     * @param enabled true if enabled.
     */
    event AppRegisterEnabled(bool enabled);

    /**
     * @notice Emitted when the token address set
     * @param tokenAddr Token address set
     */
    event SetTokenAddress(address tokenAddr);

    /**
     * @notice Emitted when the app registering fee is updated
     * @param from Original fee
     * @param to New fee
     */
    event UpdateAppRegisterFee(uint from, uint to);

    /**
     * @notice Register an app
     * @dev Need to deposit VDA token as fee. Fee is definec by Verida - Contract owner
     *      metadata should contain an item that the key is "domain".
     * @param did DID address
     * @param ownerName Owner's name. Only alphanumeric characters including spaces
     * @param appName App name. Only alphanumeric characters including space
     * @param metadata Array of key/value pairs
     * @param requestSignature The request parameters signed by the `didAddress` private key
     * @param requestProof Used to verify request
     */
    function registerApp(
        address did,
        string calldata ownerName,
        string calldata appName,
        AppMetaDataItem[] calldata metadata,
        bytes calldata requestSignature,
        bytes calldata requestProof
    ) external;

    /**
     * @notice Deregister an app
     * @param did DID address
     * @param ownerName Owner's name
     * @param appName App name
     * @param requestSignature The request parameters signed by the `didAddress` private key
     * @param requestProof Used to verify request
     */
    function deregisterApp(
        address did, 
        string calldata ownerName, 
        string calldata appName,
        bytes calldata requestSignature,
        bytes calldata requestProof
    ) external;

    /**
     * @notice Update the meta data item
     * @param did DID address
     * @param ownerName Owner's name
     * @param appName App name
     * @param item Meta data item to be updated
     * @param requestSignature The request parameters signed by the `didAddress` private key
     * @param requestProof Used to verify request
     */
    function updateApp(
        address did, 
        string calldata ownerName,
        string calldata appName,
        AppMetaDataItem calldata item,
        bytes calldata requestSignature,
        bytes calldata requestProof
    ) external;

    /**
     * @notice Get an app with given owner & app names
     * @param ownerName Owner's name
     * @param appName App name
     * @return address DID
     * @return AppMetaDataItem[] Array of meta data items
     */
    function getApp(string calldata ownerName, string calldata appName) external view returns(address, AppMetaDataItem[] memory);


    /**
     * @notice Set the Verida Token address
     * @dev Only the contract owner is allowed to call this function.
            This function is required because the original `NameRegistry` contract has no Token address
     * @param tokenAddr Address of Verida Token
     */
    function setTokenAddress(IERC20Upgradeable tokenAddr) external payable;

    /**
     * @notice Get the Verida token address
     * @return address Verida token address
     */
    function getTokenAddress() external view returns(address);

    /**
     * @notice Update fee for registering an app
     * @dev Only the contract owner is allowed
     * @param feeAmount Amount of VDA token
     */
    function updateAppRegisterFee(uint feeAmount) external payable;

    /**
     * @notice Return the fee for registering an app
     * @return uint Amount of tokens for fee
     */
    function getAppRegisterFee() external view returns(uint);

    /**
     * @notice Enable/disable the app registering feature
     * @dev Only the contract owner is allowe.
            The contract owner should enable the app registering feature after fee set.
     * @param isEnabled true if enabling, otherwise false
     */
    function setAppRegisterEnabled(bool isEnabled) external payable;

    /**
     * @notice Return whether App registering is enabled
     * @return bool true if enabled.
     */
    function isAppRegisterEnabled() external view returns(bool);

    /**
     * @notice Returns the contract version
     * @return string Contract version
     */
    function getVersion() external pure returns(string memory);

}

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

import "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol";

error NoSigners();
error InvalidSignature();

library VeridaDataVerificationLib {
  function getSignerAddress(
    bytes memory _unsignedData,
    bytes calldata _signature
  ) internal pure returns (address) {
    bytes32 unsignedDataHash = keccak256(_unsignedData);
    return ECDSAUpgradeable.recover(unsignedDataHash, _signature);
  }

  function validateSignature(
    bytes memory _unsignedData,
    bytes calldata _signature,
    address _signerAddress
  ) internal pure returns (bool result) {
    address signerAddress = getSignerAddress(_unsignedData, _signature);
    result = signerAddress == _signerAddress;
    assembly {
      if iszero(signerAddress) {
        result := false
      }
    }
  }

  /**
    * Verify any data is signed by a particular array of DID addresses
    * @dev Copied from `VDAVerificationContract` to verify request
    * @param data Any type of raw data
    * @param signature Data signed by a Verida application context signing key
    * @param proof Signed proof that a Verida DID controls a Verida application context signing key
    * @param validSigners Array of did addresses that are valid signers of data
    */
  function verifyDataWithSigners(
      bytes memory data, 
      bytes memory signature,
      bytes memory proof,
      address[] memory validSigners
  ) internal pure {
    if (validSigners.length == 0) {
        revert NoSigners();
    }

    if (data.length == 0 || signature.length == 0 || proof.length == 0) {
        revert InvalidSignature();
    }

    bytes32 dataHash = keccak256(data);
    address contextSigner = ECDSAUpgradeable.recover(dataHash, signature);
    string memory strContextSigner = StringsUpgradeable.toHexString(uint256(uint160(contextSigner)));

    bool isVerified;
    uint index;

    while (index < validSigners.length && !isVerified) {
        address account = validSigners[index];

        string memory strAccount = StringsUpgradeable.toHexString(uint256(uint160(account)));
        bytes memory proofString = abi.encodePacked(
            strAccount,
            strContextSigner
        );
        bytes32 proofHash = keccak256(proofString);
        address didSigner = ECDSAUpgradeable.recover(proofHash, proof);

        if (didSigner == account) {
            isVerified = true;
            break;
        }
        unchecked { ++index; }
    }

    if (!isVerified) {
        revert InvalidSignature();
    }
  }
}

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

[{"inputs":[{"internalType":"bool","name":"isInvalidOwner","type":"bool"},{"internalType":"bool","name":"isInvalidApp","type":"bool"}],"name":"AppNotFound","type":"error"},{"inputs":[],"name":"AppRegisterFeeNotSet","type":"error"},{"inputs":[],"name":"AppRegisterNotEnabled","type":"error"},{"inputs":[],"name":"DuplicatedAppName","type":"error"},{"inputs":[],"name":"DuplicatedOwnerName","type":"error"},{"inputs":[],"name":"InvalidAddress","type":"error"},{"inputs":[],"name":"InvalidAppName","type":"error"},{"inputs":[],"name":"InvalidDomainName","type":"error"},{"inputs":[],"name":"InvalidName","type":"error"},{"inputs":[],"name":"InvalidNameCount","type":"error"},{"inputs":[],"name":"InvalidOwnerName","type":"error"},{"inputs":[],"name":"InvalidSignature","type":"error"},{"inputs":[],"name":"InvalidSuffix","type":"error"},{"inputs":[],"name":"InvalidValue","type":"error"},{"inputs":[],"name":"LimitedNameCount","type":"error"},{"inputs":[],"name":"NoDomainInAppMetaData","type":"error"},{"inputs":[],"name":"NoSigners","type":"error"},{"inputs":[],"name":"TokenAddressNotSet","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"suffix","type":"string"}],"name":"AddSuffix","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"enabled","type":"bool"}],"name":"AppRegisterEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"did","type":"address"},{"indexed":false,"internalType":"string","name":"ownerName","type":"string"},{"indexed":false,"internalType":"string","name":"appName","type":"string"}],"name":"DeregisterApp","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"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":"string","name":"name","type":"string"},{"indexed":true,"internalType":"address","name":"DID","type":"address"}],"name":"Register","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"did","type":"address"},{"indexed":false,"internalType":"string","name":"ownerName","type":"string"},{"indexed":false,"internalType":"string","name":"appName","type":"string"},{"components":[{"internalType":"string","name":"key","type":"string"},{"internalType":"string","name":"value","type":"string"}],"indexed":false,"internalType":"struct INameRegistryV2.AppMetaDataItem[]","name":"metadata","type":"tuple[]"}],"name":"RegisterApp","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"tokenAddr","type":"address"}],"name":"SetTokenAddress","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"name","type":"string"},{"indexed":true,"internalType":"address","name":"DID","type":"address"}],"name":"Unregister","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"did","type":"address"},{"indexed":false,"internalType":"string","name":"ownerName","type":"string"},{"indexed":false,"internalType":"string","name":"appName","type":"string"},{"components":[{"internalType":"string","name":"key","type":"string"},{"internalType":"string","name":"value","type":"string"}],"indexed":false,"internalType":"struct INameRegistryV2.AppMetaDataItem","name":"item","type":"tuple"}],"name":"UpdateApp","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"from","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"to","type":"uint256"}],"name":"UpdateAppRegisterFee","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"from","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"to","type":"uint256"}],"name":"UpdateMaxNamesPerDID","type":"event"},{"inputs":[{"internalType":"string","name":"suffix","type":"string"}],"name":"addSuffix","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"did","type":"address"},{"internalType":"string","name":"ownerName","type":"string"},{"internalType":"string","name":"appName","type":"string"},{"internalType":"bytes","name":"requestSignature","type":"bytes"},{"internalType":"bytes","name":"requestProof","type":"bytes"}],"name":"deregisterApp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"}],"name":"findDID","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"ownerName","type":"string"},{"internalType":"string","name":"appName","type":"string"}],"name":"getApp","outputs":[{"internalType":"address","name":"","type":"address"},{"components":[{"internalType":"string","name":"key","type":"string"},{"internalType":"string","name":"value","type":"string"}],"internalType":"struct INameRegistryV2.AppMetaDataItem[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getAppRegisterFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getSuffixList","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTokenAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"did","type":"address"}],"name":"getUserNameList","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getVersion","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"isAppRegisterEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"suffix","type":"string"}],"name":"isValidSuffix","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxNamesPerDID","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"did","type":"address"}],"name":"nonce","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"address","name":"did","type":"address"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"register","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"did","type":"address"},{"internalType":"string","name":"ownerName","type":"string"},{"internalType":"string","name":"appName","type":"string"},{"components":[{"internalType":"string","name":"key","type":"string"},{"internalType":"string","name":"value","type":"string"}],"internalType":"struct INameRegistryV2.AppMetaDataItem[]","name":"metadata","type":"tuple[]"},{"internalType":"bytes","name":"requestSignature","type":"bytes"},{"internalType":"bytes","name":"requestProof","type":"bytes"}],"name":"registerApp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"isEnabled","type":"bool"}],"name":"setAppRegisterEnabled","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"contract IERC20Upgradeable","name":"tokenAddr","type":"address"}],"name":"setTokenAddress","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"address","name":"did","type":"address"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"unregister","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"did","type":"address"},{"internalType":"string","name":"ownerName","type":"string"},{"internalType":"string","name":"appName","type":"string"},{"components":[{"internalType":"string","name":"key","type":"string"},{"internalType":"string","name":"value","type":"string"}],"internalType":"struct INameRegistryV2.AppMetaDataItem","name":"item","type":"tuple"},{"internalType":"bytes","name":"requestSignature","type":"bytes"},{"internalType":"bytes","name":"requestProof","type":"bytes"}],"name":"updateApp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"feeAmount","type":"uint256"}],"name":"updateAppRegisterFee","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"count","type":"uint256"}],"name":"updateMaxNamesPerDID","outputs":[],"stateMutability":"payable","type":"function"}]

608060405234801561001057600080fd5b50614421806100206000396000f3fe6080604052600436106101965760003560e01c8063715018a6116100e157806394f6747b1161008a578063d851200f11610064578063d851200f14610468578063f2fde38b1461047b578063f37e1c651461049b578063fde07808146104ae57600080fd5b806394f6747b1461041f5780639a8fd7be146104325780639bd52f961461045257600080fd5b80638129fc1c116100bb5780638129fc1c146103cc5780638adf65cc146103e15780638da5cb5b1461040157600080fd5b8063715018a61461038f57806375042570146103a457806377856b72146103b757600080fd5b8063331b96ae116101435780636fc742111161011d5780636fc742111461030c57806370ae92d214610339578063714543a81461036f57600080fd5b8063331b96ae146102a45780635b43b9d7146102d45780636ce41b27146102f457600080fd5b806326a4e8d21161017457806326a4e8d2146102445780632972cd0c146102575780632e2b788c1461027657600080fd5b80630d8e6e2c1461019b57806310fe9ae8146101f05780631fe0aa9d14610222575b600080fd5b3480156101a757600080fd5b50604080518082018252600381527f322e300000000000000000000000000000000000000000000000000000000000602082015290516101e7919061352e565b60405180910390f35b3480156101fc57600080fd5b506083546001600160a01b03165b6040516001600160a01b0390911681526020016101e7565b34801561022e57600080fd5b5061024261023d3660046135a8565b6104ce565b005b61024261025236600461362d565b61072c565b34801561026357600080fd5b506084545b6040519081526020016101e7565b34801561028257600080fd5b5061029661029136600461364a565b6107db565b6040516101e79291906136b6565b3480156102b057600080fd5b506102c46102bf36600461374c565b610ad2565b60405190151581526020016101e7565b3480156102e057600080fd5b506102426102ef3660046137a6565b610b2b565b34801561030057600080fd5b5060855460ff166102c4565b34801561031857600080fd5b5061032c61032736600461362d565b610ea1565b6040516101e791906138a2565b34801561034557600080fd5b5061026861035436600461362d565b6001600160a01b031660009081526065602052604090205490565b34801561037b57600080fd5b5061024261038a3660046135a8565b610f7b565b34801561039b57600080fd5b50610242611196565b6102426103b236600461391a565b6111aa565b3480156103c357600080fd5b5061032c611233565b3480156103d857600080fd5b506102426112d5565b3480156103ed57600080fd5b506102426103fc3660046139cb565b61147a565b34801561040d57600080fd5b506033546001600160a01b031661020a565b61024261042d366004613ab2565b6116b9565b34801561043e57600080fd5b5061024261044d366004613b14565b6117b3565b34801561045e57600080fd5b50610268606a5481565b610242610476366004613c1b565b611926565b34801561048757600080fd5b5061024261049636600461362d565b6119ad565b6102426104a9366004613c1b565b611a3a565b3480156104ba57600080fd5b5061020a6104c936600461391a565b611aac565b826104e55760405163e6c4247b60e01b8152600481fd5b6104ef8585611afd565b61050c576040516360716f1b60e11b815260040160405180910390fd5b6001600160a01b038316600090815260656020908152604080832054905190929161053f91899189918991879101613c34565b604051602081830303815290604052905061055c81858588611b0a565b61057957604051638baa579f60e01b815260040160405180910390fd5b6001600160a01b0385166000908152606560205260408120805490919061059f90613c7a565b9091555050604080516020601f8801819004810282018101909252868152600092506105e5918890889081908401838280828437600092019190915250611b4292505050565b905060006066826040516105f99190613c93565b908152604051908190036020019020546001600160a01b03169050801561062c5760405163430f13b360e01b8152600481fd5b506001600160a01b0384166000908152606760205260409020606a54815410610681576040517f0ede5fd800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b846066836040516106929190613c93565b90815260405190819003602001902080546001600160a01b039290921673ffffffffffffffffffffffffffffffffffffffff199092169190911790556106d88183611bab565b50846001600160a01b031687876040516106f3929190613caf565b604051908190038120907f3e49fb7efebefffe4fc2e2c193820fac9b11de4bf185e0d14de13e0068c2ac3490600090a350505050505050565b610734611c0d565b8061074b57604051632a9ffab760e21b8152600481fd5b6083546001600160a01b0380831691160361077957604051632a9ffab760e21b815260040160405180910390fd5b6083805473ffffffffffffffffffffffffffffffffffffffff19166001600160a01b0383169081179091556040519081527f33a7e73920e7bb871d64f12f439f70e8d764c488da2188d67bd27ddb60205137906020015b60405180910390a150565b6000606080606061082188888080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b915061086286868080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b90506080826040516108749190613c93565b9081526040519081900360200190205460ff166108a457604051632984daf360e11b815260040160405180910390fd5b60006080836040516108b69190613c93565b90815260408051602092819003830190205461010090046001600160a01b03166000818152608190935291209091506108ef9083611c67565b61090c576040516314d811b560e11b815260040160405180910390fd5b6001600160a01b038116600090815260826020526040908190209051829190610936908590613c93565b908152602001604051809103902080805480602002602001604051908101604052809291908181526020016000905b82821015610abb578382906000526020600020906002020160405180604001604052908160008201805461099890613cbf565b80601f01602080910402602001604051908101604052809291908181526020018280546109c490613cbf565b8015610a115780601f106109e657610100808354040283529160200191610a11565b820191906000526020600020905b8154815290600101906020018083116109f457829003601f168201915b50505050508152602001600182018054610a2a90613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054610a5690613cbf565b8015610aa35780601f10610a7857610100808354040283529160200191610aa3565b820191906000526020600020905b815481529060010190602001808311610a8657829003601f168201915b50505050508152505081526020019060010190610965565b505050509050945094505050505b94509492505050565b600080610b1484848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b9050610b21606882611c67565b9150505b92915050565b606080610b6d8b8b8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b9150610bae89898080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b9050610bbb8c8383611c94565b60008c8c8c8c8c604051602001610bd6959493929190613cf3565b60408051601f19818403018152919052905080610bf38980613d36565b610c0060208c018c613d36565b604051602001610c14959493929190613d7d565b60408051601f198184030181526020601f8a018190048102840181019092528883529250610c95918f918491908b908b908190840183828082843760009201919091525050604080516020601f8d018190048102820181019092528b815292508b91508a9081908401838280828437600092019190915250611d4392505050565b506001600160a01b038c166000908152608260205260408082209051610cbc908490613c93565b90815260405190819003602001902080549091506000805b82811015610e2957610dd5848281548110610cf157610cf1613db3565b90600052602060002090600202016000018054610d0d90613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054610d3990613cbf565b8015610d865780601f10610d5b57610100808354040283529160200191610d86565b820191906000526020600020905b815481529060010190602001808311610d6957829003601f168201915b50505050508c8060000190610d9b9190613d36565b8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611e1392505050565b15610e215760019150610deb60208c018c613d36565b858381548110610dfd57610dfd613db3565b90600052602060002090600202016001019182610e1b929190613e17565b50610e29565b600101610cd4565b5080610e535782546001810184556000848152602090208b9160020201610e508282613ed8565b50505b7f7fcba871ff5d2e90a6568084983245b4770033c1d2eb1689d1660c2c2ce9f7398f86868d604051610e88949392919061407b565b60405180910390a1505050505050505050505050505050565b6001600160a01b0381166000908152606760205260408120606091610ec4825490565b905080600003610ee75760405163e6c4247b60e01b815260040160405180910390fd5b60008167ffffffffffffffff811115610f0257610f02613904565b604051908082528060200260200182016040528015610f3557816020015b6060815260200190600190039081610f205790505b50905060005b82811015610f7257610f4d8482611e6c565b828281518110610f5f57610f5f613db3565b6020908102919091010152600101610f3b565b50949350505050565b82610f925760405163e6c4247b60e01b8152600481fd5b6001600160a01b0383166000908152606560209081526040808320549051909291610fc591899189918991879101613c34565b6040516020818303038152906040529050610fe281858588611b0a565b610fff57604051638baa579f60e01b815260040160405180910390fd5b6001600160a01b0385166000908152606560205260408120805490919061102590613c7a565b9091555050604080516020601f88018190048102820181019092528681526000925061106b918890889081908401838280828437600092019190915250611b4292505050565b9050600060668260405161107f9190613c93565b908152604051908190036020019020546001600160a01b03169050806110b15760405163430f13b360e01b8152600481fd5b846001600160a01b0316816001600160a01b0316146110e35760405163e6c4247b60e01b815260040160405180910390fd5b6001600160a01b03811660009081526067602052604090819020905160669061110d908590613c93565b908152604051908190036020019020805473ffffffffffffffffffffffffffffffffffffffff191690556111418184611f1e565b50816001600160a01b0316888860405161115c929190613caf565b604051908190038120907ff5277d07faf1a81adcfef41a68d5bf53aecd8982a7c7f3c0df5efb97e43437b190600090a35050505050505050565b61119e611c0d565b6111a860006120dd565b565b6111b2611c0d565b6111bb81611b42565b90506111c8606882611c67565b156111e6576040516360716f1b60e11b815260040160405180910390fd5b6111f1606882611bab565b50806040516112009190613c93565b604051908190038120907f0f2e7a1cb3db636cf506883108bff2d2193b967ac6516b1e5d23e672e18a91c990600090a250565b6060600061124060685490565b905060008167ffffffffffffffff81111561125d5761125d613904565b60405190808252806020026020018201604052801561129057816020015b606081526020019060019003908161127b5790505b50905060005b828110156112ce576112a9606882611e6c565b8282815181106112bb576112bb613db3565b6020908102919091010152600101611296565b5092915050565b600054610100900460ff16158080156112f55750600054600160ff909116105b8061130f5750303b15801561130f575060005460ff166001145b6113865760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201527f647920696e697469616c697a656400000000000000000000000000000000000060648201526084015b60405180910390fd5b6000805460ff1916600117905580156113a9576000805461ff0019166101001790555b6113b161213c565b6001606a5560408051808201909152600381527f766461000000000000000000000000000000000000000000000000000000000060208201526113f5606882611bab565b50806040516114049190613c93565b604051908190038120907f0f2e7a1cb3db636cf506883108bff2d2193b967ac6516b1e5d23e672e18a91c990600090a2508015611477576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020016107d0565b50565b6060806114bc8a8a8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b91506114fd88888080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b905061150a8b8383611c94565b60008b8b8b8b8b604051602001611525959493929190613cf3565b60408051601f198184030181526020601f8a0181900481028401810190925288835292506115a6918e918491908b908b908190840183828082843760009201919091525050604080516020601f8d018190048102820181019092528b815292508b91508a9081908401838280828437600092019190915250611d4392505050565b506001600160a01b038b166000908152607f602052604081206115c891613443565b6080826040516115d89190613c93565b908152604080516020928190038301902080547fffffffffffffffffffffff0000000000000000000000000000000000000000001690556001600160a01b038d1660009081526081909252902061162f9082611f1e565b506001600160a01b038b16600090815260826020526040908190209051611657908390613c93565b90815260200160405180910390206000611671919061347d565b7f5d30b559c9ac785049268b06c2da392c7d2c2ad4c1de0b53c595d5746bff3bd68b83836040516116a4939291906140ce565b60405180910390a15050505050505050505050565b6116c1611c0d565b60855481151560ff9091161515036116ec57604051632a9ffab760e21b815260040160405180910390fd5b8015611730576083546001600160a01b03168061172e576040517f898921d6000000000000000000000000000000000000000000000000000000008152600481fd5b505b60845460000361176c576040517f696d345400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6085805460ff191682151590811790915560405160ff909116151581527fb164898f68dd2ab7792d2070410e53cd497b43598c9729ece99fce308f4006c4906020016107d0565b608554606090819060ff166117f4576040517f8ae8701800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6117ff8d8d8d6121af565b915061180c8d8b8b612302565b9050600061181a89896123e7565b90508d8d8d8d8d8560405160200161183796959493929190614102565b60405160208183030381529060405290506118bd8e8289898080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b815292508b91508a9081908401838280828437600092019190915250611d4392505050565b506118c732612647565b6118d48d83838b8b6126ec565b7f72ab7b65edc84e7d5aa420719091a44f9805119cae95b565507570ffd479a7ca8d8d8d8d8d8d8d60405161190f9796959493929190614161565b60405180910390a150505050505050505050505050565b61192e611c0d565b606a5480821161196a576040517f3425304300000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b606a82905560408051828152602081018490527f072c83ac7095da78eb85579bdaac6adb9c6cf5f129acbdb79644338d35a2b69691015b60405180910390a15050565b6119b5611c0d565b6001600160a01b038116611a315760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f6464726573730000000000000000000000000000000000000000000000000000606482015260840161137d565b611477816120dd565b611a42611c0d565b608454811480611a50575080155b15611a6e57604051632a9ffab760e21b815260040160405180910390fd5b608480549082905560408051828152602081018490527f9b994baf249698e35df03a9c0808f13808fd5c161aa8f8fa1b2a37093ddfcc6b91016119a1565b6000611ab782611b42565b91506000606683604051611acb9190613c93565b908152604051908190036020019020546001600160a01b0316905080610b255760405163430f13b360e01b8152600481fd5b600080610b148484612850565b600080611b18868686612a77565b9050826001600160a01b0316816001600160a01b031614915080610f725750600095945050505050565b60608160005b81518110156112ce57611b7a828281518110611b6657611b66613db3565b01602001516001600160f81b031916612acd565b828281518110611b8c57611b8c613db3565b60200101906001600160f81b031916908160001a905350600101611b48565b6000611bb78383611c67565b611c0557825460018101845560008481526020902001611bd7838261420e565b5082546040516001850190611bed908590613c93565b90815260405190819003602001902055506001610b25565b506000610b25565b6033546001600160a01b031633146111a85760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161137d565b60008260010182604051611c7b9190613c93565b9081526040519081900360200190205415159392505050565b826001600160a01b0316608083604051611cae9190613c93565b908152604051908190036020019020546001600160a01b036101009091041614611cf557604051630941c7df60e31b8152600160048201526000602482015260440161137d565b6001600160a01b0383166000908152608160205260409020611d179082611c67565b611d3e57604051630941c7df60e31b8152600060048201526001602482015260440161137d565b505050565b6001600160a01b0384166000908152606560209081526040808320549051909291611d729187918591016142ce565b60408051601f198184030181526001808452838301909252925060009190602080830190803683370190505090508681600081518110611db457611db4613db3565b60200260200101906001600160a01b031690816001600160a01b031681525050611de082868684612b54565b6001600160a01b03871660009081526065602052604081208054909190611e0690613c7a565b9091555050505050505050565b600081604051602001611e269190613c93565b6040516020818303038152906040528051906020012083604051602001611e4d9190613c93565b6040516020818303038152906040528051906020012014905092915050565b6060826000018281548110611e8357611e83613db3565b906000526020600020018054611e9890613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054611ec490613cbf565b8015611f115780601f10611ee657610100808354040283529160200191611f11565b820191906000526020600020905b815481529060010190602001808311611ef457829003601f168201915b5050505050905092915050565b6000808360010183604051611f339190613c93565b9081526020016040518091039020549050806000146120d3576000611f596001836142f0565b8554909150600090611f6d906001906142f0565b9050818114612074576000866000018281548110611f8d57611f8d613db3565b906000526020600020018054611fa290613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054611fce90613cbf565b801561201b5780601f10611ff05761010080835404028352916020019161201b565b820191906000526020600020905b815481529060010190602001808311611ffe57829003601f168201915b505050505090508087600001848154811061203857612038613db3565b90600052602060002001908161204e919061420e565b508387600101826040516120629190613c93565b90815260405190819003602001902055505b855486908061208557612085614303565b6001900381819060005260206000200160006120a19190613443565b905585600101856040516120b59190613c93565b90815260200160405180910390206000905560019350505050610b25565b6000915050610b25565b603380546001600160a01b0383811673ffffffffffffffffffffffffffffffffffffffff19831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166121a75760405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b606482015260840161137d565b6111a8612cd7565b6060806121f184848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b905061221681604051806040016040528060018152602001600160fd1b815250612d4b565b61223357604051632984daf360e11b815260040160405180910390fd5b60006080826040516122459190613c93565b908152604051908190036020019020805490915060ff16156122b45780546001600160a01b038088166101009092041603612282575090506122fb565b6040517f31d2352200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0386166000908152607f6020526040902080546122d790613cbf565b1590506122f757604051632984daf360e11b815260040160405180910390fd5b5090505b9392505050565b60608061234484848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b905061236981604051806040016040528060018152602001600160fd1b815250612d4b565b612386576040516314d811b560e11b815260040160405180910390fd5b6001600160a01b03851660009081526081602052604090206123a89082611c67565b156123df576040517fa087445900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b949350505050565b60408051808201909152600681527f646f6d61696e00000000000000000000000000000000000000000000000000006020909101526060818160007fc5d3ba30d3ac69f3f095a61e99369d9450502ca0c2f4768b2c39ee277faa631d815b84811015612604578188888381811061246057612460613db3565b90506020028101906124729190614319565b61247c9080613d36565b60405161248a929190613caf565b604051809103902003612575576001925061253f8888838181106124b0576124b0613db3565b90506020028101906124c29190614319565b6124d0906020810190613d36565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505060408051808201909152600281527f5f2d00000000000000000000000000000000000000000000000000000000000060208201529150612d4b9050565b612575576040517f3f71cb2500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8388888381811061258857612588613db3565b905060200281019061259a9190614319565b6125a49080613d36565b8a8a858181106125b6576125b6613db3565b90506020028101906125c89190614319565b6125d6906020810190613d36565b6040516020016125ea959493929190613d7d565b60408051601f198184030181529190529350600101612445565b508161263c576040517fe8296ea700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b509095945050505050565b60845415611477576083546084546040517f23b872dd0000000000000000000000000000000000000000000000000000000081526001600160a01b03848116600483015230602483015260448201929092529116906323b872dd906064016020604051808303816000875af11580156126c4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906126e8919061432f565b5050565b6001600160a01b0385166000908152607f6020526040902061270e858261420e565b5060016080856040516127219190613c93565b908152604051908190036020018120805492151560ff19909316929092179091558590608090612752908790613c93565b908152604080516020928190038301902080547fffffffffffffffffffffff0000000000000000000000000000000000000000ff166101006001600160a01b039586160217905591871660009081526081909152206127b19084611bab565b506001600160a01b03851660009081526082602052604080822090516127d8908690613c93565b90815260405190819003602001902090508160005b81811015612846578285858381811061280857612808613db3565b905060200281019061281a9190614319565b81546001810183556000928352602090922090916002020161283c8282613ed8565b50506001016127ed565b5050505050505050565b6060600061289384848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b805190915081906000036128ba5760405163430f13b360e01b815260040160405180910390fd5b8051806000805b83821080156128d3575060028160ff16105b801561290357506129038583815181106128ef576128ef613db3565b01602001516001600160f81b031916612e6c565b156129475784828151811061291a5761291a613db3565b01602001516001600160f81b031916601760f91b0361293c5760018083019350015b8160010191506128c1565b8383106129675760405163430f13b360e01b815260040160405180910390fd5b60018160ff1611806129795750838214155b80612985575060028311155b80612991575060228310155b156129af5760405163430f13b360e01b815260040160405180910390fd5b60006129bb84866142f0565b67ffffffffffffffff8111156129d3576129d3613904565b6040519080825280601f01601f1916602001820160405280156129fd576020820181803683370190505b5090508392505b84831015612a6a57858381518110612a1e57612a1e613db3565b01602001516001600160f81b03191681612a3886866142f0565b81518110612a4857612a48613db3565b60200101906001600160f81b031916908160001a905350826001019250612a04565b9998505050505050505050565b60008084805190602001209050612ac48185858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250612f6e92505050565b95945050505050565b60007f41000000000000000000000000000000000000000000000000000000000000006001600160f81b0319831610801590612b3357507f5a000000000000000000000000000000000000000000000000000000000000006001600160f81b0319831611155b15612b5057612b4760f883901c602061434c565b60f81b92915050565b5090565b8051600003612b8f576040517fc7af40f000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b83511580612b9c57508251155b80612ba657508151155b15612bc457604051638baa579f60e01b815260040160405180910390fd5b835160208501206000612bd78286612f6e565b90506000612bed826001600160a01b0316612f92565b90506000805b855181108015612c01575081155b15612cae576000868281518110612c1a57612c1a613db3565b602002602001015190506000612c38826001600160a01b0316612f92565b905060008186604051602001612c4f929190614365565b60408051601f19818403018152919052805160208201209091506000612c75828d612f6e565b9050846001600160a01b0316816001600160a01b031603612c9e57600196505050505050612cae565b8560010195505050505050612bf3565b81612ccc57604051638baa579f60e01b815260040160405180910390fd5b505050505050505050565b600054610100900460ff16612d425760405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b606482015260840161137d565b6111a8336120dd565b8151600090839082818103612d665760009350505050610b25565b8451859060005b84811015612e5d57858181518110612d8757612d87613db3565b01602001516001600160f81b0319169350606160f81b8410801590612dba5750603d60f91b6001600160f81b0319851611155b158015612df05750600360fc1b6001600160f81b0319851610801590612dee5750603960f81b6001600160f81b0319851611155b155b15612e55576000805b83811015612e3d57848181518110612e1357612e13613db3565b01602001516001600160f81b031990811690871603612e355760019150612e3d565b600101612df9565b5080612e53576000975050505050505050610b25565b505b600101612d6d565b50600198975050505050505050565b6000606160f81b6001600160f81b0319831610801590612e9a5750603d60f91b6001600160f81b0319831611155b15612ea757506001919050565b600360fc1b6001600160f81b0319831610801590612ed35750603960f81b6001600160f81b0319831611155b15612ee057506001919050565b7f5f000000000000000000000000000000000000000000000000000000000000006001600160f81b031983161480612f4157507f2d000000000000000000000000000000000000000000000000000000000000006001600160f81b03198316145b80612f595750601760f91b6001600160f81b03198316145b15612f6657506001919050565b506000919050565b6000806000612f7d8585612fa9565b91509150612f8a81612fee565b509392505050565b6060610b2582612fa184613153565b6001016131bd565b6000808251604103612fdf5760208301516040840151606085015160001a612fd387828585613382565b94509450505050612fe7565b506000905060025b9250929050565b600081600481111561300257613002614394565b0361300a5750565b600181600481111561301e5761301e614394565b0361306b5760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e61747572650000000000000000604482015260640161137d565b600281600481111561307f5761307f614394565b036130cc5760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e67746800604482015260640161137d565b60038160048111156130e0576130e0614394565b036114775760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c60448201527f7565000000000000000000000000000000000000000000000000000000000000606482015260840161137d565b600080608083901c1561316b5760809290921c916010015b604083901c156131805760409290921c916008015b602083901c156131955760209290921c916004015b601083901c156131aa5760109290921c916002015b600883901c15610b255760010192915050565b606060006131cc8360026143aa565b6131d79060026143c1565b67ffffffffffffffff8111156131ef576131ef613904565b6040519080825280601f01601f191660200182016040528015613219576020820181803683370190505b509050600360fc1b8160008151811061323457613234613db3565b60200101906001600160f81b031916908160001a9053507f78000000000000000000000000000000000000000000000000000000000000008160018151811061327f5761327f613db3565b60200101906001600160f81b031916908160001a90535060006132a38460026143aa565b6132ae9060016143c1565b90505b6001811115613333577f303132333435363738396162636465660000000000000000000000000000000085600f16601081106132ef576132ef613db3565b1a60f81b82828151811061330557613305613db3565b60200101906001600160f81b031916908160001a90535060049490941c9361332c816143d4565b90506132b1565b5083156122fb5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604482015260640161137d565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08311156133b95750600090506003610ac9565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa15801561340d573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b03811661343657600060019250925050610ac9565b9660009650945050505050565b50805461344f90613cbf565b6000825580601f1061345f575050565b601f016020900490600052602060002090810190611477919061349e565b508054600082556002029060005260206000209081019061147791906134b3565b5b80821115612b50576000815560010161349f565b80821115612b505760006134c78282613443565b6134d5600183016000613443565b506002016134b3565b60005b838110156134f95781810151838201526020016134e1565b50506000910152565b6000815180845261351a8160208601602086016134de565b601f01601f19169290920160200192915050565b6020815260006122fb6020830184613502565b60008083601f84011261355357600080fd5b50813567ffffffffffffffff81111561356b57600080fd5b602083019150836020828501011115612fe757600080fd5b6001600160a01b038116811461147757600080fd5b80356135a381613583565b919050565b6000806000806000606086880312156135c057600080fd5b853567ffffffffffffffff808211156135d857600080fd5b6135e489838a01613541565b9097509550602088013591506135f982613583565b9093506040870135908082111561360f57600080fd5b5061361c88828901613541565b969995985093965092949392505050565b60006020828403121561363f57600080fd5b81356122fb81613583565b6000806000806040858703121561366057600080fd5b843567ffffffffffffffff8082111561367857600080fd5b61368488838901613541565b9096509450602087013591508082111561369d57600080fd5b506136aa87828801613541565b95989497509550505050565b600060408083016001600160a01b03861684526020828186015281865180845260608701915060608160051b880101935082880160005b8281101561373d57888603605f190184528151805188885261371189890182613502565b91870151888303898901529190506137298183613502565b9750505092840192908401906001016136ed565b50939998505050505050505050565b6000806020838503121561375f57600080fd5b823567ffffffffffffffff81111561377657600080fd5b61378285828601613541565b90969095509350505050565b6000604082840312156137a057600080fd5b50919050565b60008060008060008060008060008060c08b8d0312156137c557600080fd5b6137ce8b613598565b995060208b013567ffffffffffffffff808211156137eb57600080fd5b6137f78e838f01613541565b909b50995060408d013591508082111561381057600080fd5b61381c8e838f01613541565b909950975060608d013591508082111561383557600080fd5b6138418e838f0161378e565b965060808d013591508082111561385757600080fd5b6138638e838f01613541565b909650945060a08d013591508082111561387c57600080fd5b506138898d828e01613541565b915080935050809150509295989b9194979a5092959850565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b828110156138f757603f198886030184526138e5858351613502565b945092850192908501906001016138c9565b5092979650505050505050565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561392c57600080fd5b813567ffffffffffffffff8082111561394457600080fd5b818401915084601f83011261395857600080fd5b81358181111561396a5761396a613904565b604051601f8201601f19908116603f0116810190838211818310171561399257613992613904565b816040528281528760208487010111156139ab57600080fd5b826020860160208301376000928101602001929092525095945050505050565b600080600080600080600080600060a08a8c0312156139e957600080fd5b89356139f481613583565b985060208a013567ffffffffffffffff80821115613a1157600080fd5b613a1d8d838e01613541565b909a50985060408c0135915080821115613a3657600080fd5b613a428d838e01613541565b909850965060608c0135915080821115613a5b57600080fd5b613a678d838e01613541565b909650945060808c0135915080821115613a8057600080fd5b50613a8d8c828d01613541565b915080935050809150509295985092959850929598565b801515811461147757600080fd5b600060208284031215613ac457600080fd5b81356122fb81613aa4565b60008083601f840112613ae157600080fd5b50813567ffffffffffffffff811115613af957600080fd5b6020830191508360208260051b8501011115612fe757600080fd5b600080600080600080600080600080600060c08c8e031215613b3557600080fd5b613b3e8c613598565b9a5067ffffffffffffffff8060208e01351115613b5a57600080fd5b613b6a8e60208f01358f01613541565b909b50995060408d0135811015613b8057600080fd5b613b908e60408f01358f01613541565b909950975060608d0135811015613ba657600080fd5b613bb68e60608f01358f01613acf565b909750955060808d0135811015613bcc57600080fd5b613bdc8e60808f01358f01613541565b909550935060a08d0135811015613bf257600080fd5b50613c038d60a08e01358e01613541565b81935080925050509295989b509295989b9093969950565b600060208284031215613c2d57600080fd5b5035919050565b8385823760609290921b6bffffffffffffffffffffffff1916919092019081526014810191909152603401919050565b634e487b7160e01b600052601160045260246000fd5b600060018201613c8c57613c8c613c64565b5060010190565b60008251613ca58184602087016134de565b9190910192915050565b8183823760009101908152919050565b600181811c90821680613cd357607f821691505b6020821081036137a057634e487b7160e01b600052602260045260246000fd5b6bffffffffffffffffffffffff198660601b1681528385601483013760008482016014810160008152848682375060009301601401928352509095945050505050565b6000808335601e19843603018112613d4d57600080fd5b83018035915067ffffffffffffffff821115613d6857600080fd5b602001915036819003821315612fe757600080fd5b60008651613d8f818460208b016134de565b82018587823760009086019081528385823760009301928352509095945050505050565b634e487b7160e01b600052603260045260246000fd5b601f821115611d3e57600081815260208120601f850160051c81016020861015613df05750805b601f850160051c820191505b81811015613e0f57828155600101613dfc565b505050505050565b67ffffffffffffffff831115613e2f57613e2f613904565b613e4383613e3d8354613cbf565b83613dc9565b6000601f841160018114613e775760008515613e5f5750838201355b600019600387901b1c1916600186901b178355613ed1565b600083815260209020601f19861690835b82811015613ea85786850135825560209485019460019092019101613e88565b5086821015613ec55760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b613ee28283613d36565b67ffffffffffffffff811115613efa57613efa613904565b613f0e81613f088554613cbf565b85613dc9565b6000601f821160018114613f425760008315613f2a5750838201355b600019600385901b1c1916600184901b178555613f9c565b600085815260209020601f19841690835b82811015613f735786850135825560209485019460019092019101613f53565b5084821015613f905760001960f88660031b161c19848701351681555b505060018360011b0185555b50505050613fad6020830183613d36565b613fbb818360018601613e17565b50505050565b6000808335601e19843603018112613fd857600080fd5b830160208101925035905067ffffffffffffffff811115613ff857600080fd5b803603821315612fe757600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b600061403c8283613fc1565b6040855261404e604086018284614007565b91505061405e6020840184613fc1565b8583036020870152614071838284614007565b9695505050505050565b6001600160a01b038516815260806020820152600061409d6080830186613502565b82810360408401526140af8186613502565b905082810360608401526140c38185614030565b979650505050505050565b6001600160a01b03841681526060602082015260006140f06060830185613502565b82810360408401526140718185613502565b6bffffffffffffffffffffffff198760601b1681528486601483013760008582016014810160008152858782375084810190506014810160008152845161414d8183602089016134de565b919091016014019998505050505050505050565b6001600160a01b03881681526000602060808184015261418560808401898b614007565b838103604085015261419881888a614007565b84810360608601528581529050818101600586901b82018301876000805b898110156141fa57858403601f190185528235368c9003603e190181126141db578283fd5b6141e7858d8301614030565b95880195945050918601916001016141b6565b50919e9d5050505050505050505050505050565b815167ffffffffffffffff81111561422857614228613904565b61423c816142368454613cbf565b84613dc9565b602080601f83116001811461427157600084156142595750858301515b600019600386901b1c1916600185901b178555613e0f565b600085815260208120601f198616915b828110156142a057888601518255948401946001909101908401614281565b50858210156142be5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b600083516142e08184602088016134de565b9190910191825250602001919050565b81810381811115610b2557610b25613c64565b634e487b7160e01b600052603160045260246000fd5b60008235603e19833603018112613ca557600080fd5b60006020828403121561434157600080fd5b81516122fb81613aa4565b60ff8181168382160190811115610b2557610b25613c64565b600083516143778184602088016134de565b83519083019061438b8183602088016134de565b01949350505050565b634e487b7160e01b600052602160045260246000fd5b8082028115828204841417610b2557610b25613c64565b80820180821115610b2557610b25613c64565b6000816143e3576143e3613c64565b50600019019056fea26469706673582212200d1b025d94b4e1bfdbbdabec85a906a6c3ef1679e8331212613dc8f30cf7862064736f6c63430008120033

0x6080604052600436106101965760003560e01c8063715018a6116100e157806394f6747b1161008a578063d851200f11610064578063d851200f14610468578063f2fde38b1461047b578063f37e1c651461049b578063fde07808146104ae57600080fd5b806394f6747b1461041f5780639a8fd7be146104325780639bd52f961461045257600080fd5b80638129fc1c116100bb5780638129fc1c146103cc5780638adf65cc146103e15780638da5cb5b1461040157600080fd5b8063715018a61461038f57806375042570146103a457806377856b72146103b757600080fd5b8063331b96ae116101435780636fc742111161011d5780636fc742111461030c57806370ae92d214610339578063714543a81461036f57600080fd5b8063331b96ae146102a45780635b43b9d7146102d45780636ce41b27146102f457600080fd5b806326a4e8d21161017457806326a4e8d2146102445780632972cd0c146102575780632e2b788c1461027657600080fd5b80630d8e6e2c1461019b57806310fe9ae8146101f05780631fe0aa9d14610222575b600080fd5b3480156101a757600080fd5b50604080518082018252600381527f322e300000000000000000000000000000000000000000000000000000000000602082015290516101e7919061352e565b60405180910390f35b3480156101fc57600080fd5b506083546001600160a01b03165b6040516001600160a01b0390911681526020016101e7565b34801561022e57600080fd5b5061024261023d3660046135a8565b6104ce565b005b61024261025236600461362d565b61072c565b34801561026357600080fd5b506084545b6040519081526020016101e7565b34801561028257600080fd5b5061029661029136600461364a565b6107db565b6040516101e79291906136b6565b3480156102b057600080fd5b506102c46102bf36600461374c565b610ad2565b60405190151581526020016101e7565b3480156102e057600080fd5b506102426102ef3660046137a6565b610b2b565b34801561030057600080fd5b5060855460ff166102c4565b34801561031857600080fd5b5061032c61032736600461362d565b610ea1565b6040516101e791906138a2565b34801561034557600080fd5b5061026861035436600461362d565b6001600160a01b031660009081526065602052604090205490565b34801561037b57600080fd5b5061024261038a3660046135a8565b610f7b565b34801561039b57600080fd5b50610242611196565b6102426103b236600461391a565b6111aa565b3480156103c357600080fd5b5061032c611233565b3480156103d857600080fd5b506102426112d5565b3480156103ed57600080fd5b506102426103fc3660046139cb565b61147a565b34801561040d57600080fd5b506033546001600160a01b031661020a565b61024261042d366004613ab2565b6116b9565b34801561043e57600080fd5b5061024261044d366004613b14565b6117b3565b34801561045e57600080fd5b50610268606a5481565b610242610476366004613c1b565b611926565b34801561048757600080fd5b5061024261049636600461362d565b6119ad565b6102426104a9366004613c1b565b611a3a565b3480156104ba57600080fd5b5061020a6104c936600461391a565b611aac565b826104e55760405163e6c4247b60e01b8152600481fd5b6104ef8585611afd565b61050c576040516360716f1b60e11b815260040160405180910390fd5b6001600160a01b038316600090815260656020908152604080832054905190929161053f91899189918991879101613c34565b604051602081830303815290604052905061055c81858588611b0a565b61057957604051638baa579f60e01b815260040160405180910390fd5b6001600160a01b0385166000908152606560205260408120805490919061059f90613c7a565b9091555050604080516020601f8801819004810282018101909252868152600092506105e5918890889081908401838280828437600092019190915250611b4292505050565b905060006066826040516105f99190613c93565b908152604051908190036020019020546001600160a01b03169050801561062c5760405163430f13b360e01b8152600481fd5b506001600160a01b0384166000908152606760205260409020606a54815410610681576040517f0ede5fd800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b846066836040516106929190613c93565b90815260405190819003602001902080546001600160a01b039290921673ffffffffffffffffffffffffffffffffffffffff199092169190911790556106d88183611bab565b50846001600160a01b031687876040516106f3929190613caf565b604051908190038120907f3e49fb7efebefffe4fc2e2c193820fac9b11de4bf185e0d14de13e0068c2ac3490600090a350505050505050565b610734611c0d565b8061074b57604051632a9ffab760e21b8152600481fd5b6083546001600160a01b0380831691160361077957604051632a9ffab760e21b815260040160405180910390fd5b6083805473ffffffffffffffffffffffffffffffffffffffff19166001600160a01b0383169081179091556040519081527f33a7e73920e7bb871d64f12f439f70e8d764c488da2188d67bd27ddb60205137906020015b60405180910390a150565b6000606080606061082188888080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b915061086286868080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b90506080826040516108749190613c93565b9081526040519081900360200190205460ff166108a457604051632984daf360e11b815260040160405180910390fd5b60006080836040516108b69190613c93565b90815260408051602092819003830190205461010090046001600160a01b03166000818152608190935291209091506108ef9083611c67565b61090c576040516314d811b560e11b815260040160405180910390fd5b6001600160a01b038116600090815260826020526040908190209051829190610936908590613c93565b908152602001604051809103902080805480602002602001604051908101604052809291908181526020016000905b82821015610abb578382906000526020600020906002020160405180604001604052908160008201805461099890613cbf565b80601f01602080910402602001604051908101604052809291908181526020018280546109c490613cbf565b8015610a115780601f106109e657610100808354040283529160200191610a11565b820191906000526020600020905b8154815290600101906020018083116109f457829003601f168201915b50505050508152602001600182018054610a2a90613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054610a5690613cbf565b8015610aa35780601f10610a7857610100808354040283529160200191610aa3565b820191906000526020600020905b815481529060010190602001808311610a8657829003601f168201915b50505050508152505081526020019060010190610965565b505050509050945094505050505b94509492505050565b600080610b1484848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b9050610b21606882611c67565b9150505b92915050565b606080610b6d8b8b8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b9150610bae89898080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b9050610bbb8c8383611c94565b60008c8c8c8c8c604051602001610bd6959493929190613cf3565b60408051601f19818403018152919052905080610bf38980613d36565b610c0060208c018c613d36565b604051602001610c14959493929190613d7d565b60408051601f198184030181526020601f8a018190048102840181019092528883529250610c95918f918491908b908b908190840183828082843760009201919091525050604080516020601f8d018190048102820181019092528b815292508b91508a9081908401838280828437600092019190915250611d4392505050565b506001600160a01b038c166000908152608260205260408082209051610cbc908490613c93565b90815260405190819003602001902080549091506000805b82811015610e2957610dd5848281548110610cf157610cf1613db3565b90600052602060002090600202016000018054610d0d90613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054610d3990613cbf565b8015610d865780601f10610d5b57610100808354040283529160200191610d86565b820191906000526020600020905b815481529060010190602001808311610d6957829003601f168201915b50505050508c8060000190610d9b9190613d36565b8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611e1392505050565b15610e215760019150610deb60208c018c613d36565b858381548110610dfd57610dfd613db3565b90600052602060002090600202016001019182610e1b929190613e17565b50610e29565b600101610cd4565b5080610e535782546001810184556000848152602090208b9160020201610e508282613ed8565b50505b7f7fcba871ff5d2e90a6568084983245b4770033c1d2eb1689d1660c2c2ce9f7398f86868d604051610e88949392919061407b565b60405180910390a1505050505050505050505050505050565b6001600160a01b0381166000908152606760205260408120606091610ec4825490565b905080600003610ee75760405163e6c4247b60e01b815260040160405180910390fd5b60008167ffffffffffffffff811115610f0257610f02613904565b604051908082528060200260200182016040528015610f3557816020015b6060815260200190600190039081610f205790505b50905060005b82811015610f7257610f4d8482611e6c565b828281518110610f5f57610f5f613db3565b6020908102919091010152600101610f3b565b50949350505050565b82610f925760405163e6c4247b60e01b8152600481fd5b6001600160a01b0383166000908152606560209081526040808320549051909291610fc591899189918991879101613c34565b6040516020818303038152906040529050610fe281858588611b0a565b610fff57604051638baa579f60e01b815260040160405180910390fd5b6001600160a01b0385166000908152606560205260408120805490919061102590613c7a565b9091555050604080516020601f88018190048102820181019092528681526000925061106b918890889081908401838280828437600092019190915250611b4292505050565b9050600060668260405161107f9190613c93565b908152604051908190036020019020546001600160a01b03169050806110b15760405163430f13b360e01b8152600481fd5b846001600160a01b0316816001600160a01b0316146110e35760405163e6c4247b60e01b815260040160405180910390fd5b6001600160a01b03811660009081526067602052604090819020905160669061110d908590613c93565b908152604051908190036020019020805473ffffffffffffffffffffffffffffffffffffffff191690556111418184611f1e565b50816001600160a01b0316888860405161115c929190613caf565b604051908190038120907ff5277d07faf1a81adcfef41a68d5bf53aecd8982a7c7f3c0df5efb97e43437b190600090a35050505050505050565b61119e611c0d565b6111a860006120dd565b565b6111b2611c0d565b6111bb81611b42565b90506111c8606882611c67565b156111e6576040516360716f1b60e11b815260040160405180910390fd5b6111f1606882611bab565b50806040516112009190613c93565b604051908190038120907f0f2e7a1cb3db636cf506883108bff2d2193b967ac6516b1e5d23e672e18a91c990600090a250565b6060600061124060685490565b905060008167ffffffffffffffff81111561125d5761125d613904565b60405190808252806020026020018201604052801561129057816020015b606081526020019060019003908161127b5790505b50905060005b828110156112ce576112a9606882611e6c565b8282815181106112bb576112bb613db3565b6020908102919091010152600101611296565b5092915050565b600054610100900460ff16158080156112f55750600054600160ff909116105b8061130f5750303b15801561130f575060005460ff166001145b6113865760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201527f647920696e697469616c697a656400000000000000000000000000000000000060648201526084015b60405180910390fd5b6000805460ff1916600117905580156113a9576000805461ff0019166101001790555b6113b161213c565b6001606a5560408051808201909152600381527f766461000000000000000000000000000000000000000000000000000000000060208201526113f5606882611bab565b50806040516114049190613c93565b604051908190038120907f0f2e7a1cb3db636cf506883108bff2d2193b967ac6516b1e5d23e672e18a91c990600090a2508015611477576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498906020016107d0565b50565b6060806114bc8a8a8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b91506114fd88888080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b905061150a8b8383611c94565b60008b8b8b8b8b604051602001611525959493929190613cf3565b60408051601f198184030181526020601f8a0181900481028401810190925288835292506115a6918e918491908b908b908190840183828082843760009201919091525050604080516020601f8d018190048102820181019092528b815292508b91508a9081908401838280828437600092019190915250611d4392505050565b506001600160a01b038b166000908152607f602052604081206115c891613443565b6080826040516115d89190613c93565b908152604080516020928190038301902080547fffffffffffffffffffffff0000000000000000000000000000000000000000001690556001600160a01b038d1660009081526081909252902061162f9082611f1e565b506001600160a01b038b16600090815260826020526040908190209051611657908390613c93565b90815260200160405180910390206000611671919061347d565b7f5d30b559c9ac785049268b06c2da392c7d2c2ad4c1de0b53c595d5746bff3bd68b83836040516116a4939291906140ce565b60405180910390a15050505050505050505050565b6116c1611c0d565b60855481151560ff9091161515036116ec57604051632a9ffab760e21b815260040160405180910390fd5b8015611730576083546001600160a01b03168061172e576040517f898921d6000000000000000000000000000000000000000000000000000000008152600481fd5b505b60845460000361176c576040517f696d345400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6085805460ff191682151590811790915560405160ff909116151581527fb164898f68dd2ab7792d2070410e53cd497b43598c9729ece99fce308f4006c4906020016107d0565b608554606090819060ff166117f4576040517f8ae8701800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6117ff8d8d8d6121af565b915061180c8d8b8b612302565b9050600061181a89896123e7565b90508d8d8d8d8d8560405160200161183796959493929190614102565b60405160208183030381529060405290506118bd8e8289898080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525050604080516020601f8d018190048102820181019092528b815292508b91508a9081908401838280828437600092019190915250611d4392505050565b506118c732612647565b6118d48d83838b8b6126ec565b7f72ab7b65edc84e7d5aa420719091a44f9805119cae95b565507570ffd479a7ca8d8d8d8d8d8d8d60405161190f9796959493929190614161565b60405180910390a150505050505050505050505050565b61192e611c0d565b606a5480821161196a576040517f3425304300000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b606a82905560408051828152602081018490527f072c83ac7095da78eb85579bdaac6adb9c6cf5f129acbdb79644338d35a2b69691015b60405180910390a15050565b6119b5611c0d565b6001600160a01b038116611a315760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f6464726573730000000000000000000000000000000000000000000000000000606482015260840161137d565b611477816120dd565b611a42611c0d565b608454811480611a50575080155b15611a6e57604051632a9ffab760e21b815260040160405180910390fd5b608480549082905560408051828152602081018490527f9b994baf249698e35df03a9c0808f13808fd5c161aa8f8fa1b2a37093ddfcc6b91016119a1565b6000611ab782611b42565b91506000606683604051611acb9190613c93565b908152604051908190036020019020546001600160a01b0316905080610b255760405163430f13b360e01b8152600481fd5b600080610b148484612850565b600080611b18868686612a77565b9050826001600160a01b0316816001600160a01b031614915080610f725750600095945050505050565b60608160005b81518110156112ce57611b7a828281518110611b6657611b66613db3565b01602001516001600160f81b031916612acd565b828281518110611b8c57611b8c613db3565b60200101906001600160f81b031916908160001a905350600101611b48565b6000611bb78383611c67565b611c0557825460018101845560008481526020902001611bd7838261420e565b5082546040516001850190611bed908590613c93565b90815260405190819003602001902055506001610b25565b506000610b25565b6033546001600160a01b031633146111a85760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161137d565b60008260010182604051611c7b9190613c93565b9081526040519081900360200190205415159392505050565b826001600160a01b0316608083604051611cae9190613c93565b908152604051908190036020019020546001600160a01b036101009091041614611cf557604051630941c7df60e31b8152600160048201526000602482015260440161137d565b6001600160a01b0383166000908152608160205260409020611d179082611c67565b611d3e57604051630941c7df60e31b8152600060048201526001602482015260440161137d565b505050565b6001600160a01b0384166000908152606560209081526040808320549051909291611d729187918591016142ce565b60408051601f198184030181526001808452838301909252925060009190602080830190803683370190505090508681600081518110611db457611db4613db3565b60200260200101906001600160a01b031690816001600160a01b031681525050611de082868684612b54565b6001600160a01b03871660009081526065602052604081208054909190611e0690613c7a565b9091555050505050505050565b600081604051602001611e269190613c93565b6040516020818303038152906040528051906020012083604051602001611e4d9190613c93565b6040516020818303038152906040528051906020012014905092915050565b6060826000018281548110611e8357611e83613db3565b906000526020600020018054611e9890613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054611ec490613cbf565b8015611f115780601f10611ee657610100808354040283529160200191611f11565b820191906000526020600020905b815481529060010190602001808311611ef457829003601f168201915b5050505050905092915050565b6000808360010183604051611f339190613c93565b9081526020016040518091039020549050806000146120d3576000611f596001836142f0565b8554909150600090611f6d906001906142f0565b9050818114612074576000866000018281548110611f8d57611f8d613db3565b906000526020600020018054611fa290613cbf565b80601f0160208091040260200160405190810160405280929190818152602001828054611fce90613cbf565b801561201b5780601f10611ff05761010080835404028352916020019161201b565b820191906000526020600020905b815481529060010190602001808311611ffe57829003601f168201915b505050505090508087600001848154811061203857612038613db3565b90600052602060002001908161204e919061420e565b508387600101826040516120629190613c93565b90815260405190819003602001902055505b855486908061208557612085614303565b6001900381819060005260206000200160006120a19190613443565b905585600101856040516120b59190613c93565b90815260200160405180910390206000905560019350505050610b25565b6000915050610b25565b603380546001600160a01b0383811673ffffffffffffffffffffffffffffffffffffffff19831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166121a75760405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b606482015260840161137d565b6111a8612cd7565b6060806121f184848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b905061221681604051806040016040528060018152602001600160fd1b815250612d4b565b61223357604051632984daf360e11b815260040160405180910390fd5b60006080826040516122459190613c93565b908152604051908190036020019020805490915060ff16156122b45780546001600160a01b038088166101009092041603612282575090506122fb565b6040517f31d2352200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0386166000908152607f6020526040902080546122d790613cbf565b1590506122f757604051632984daf360e11b815260040160405180910390fd5b5090505b9392505050565b60608061234484848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b905061236981604051806040016040528060018152602001600160fd1b815250612d4b565b612386576040516314d811b560e11b815260040160405180910390fd5b6001600160a01b03851660009081526081602052604090206123a89082611c67565b156123df576040517fa087445900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b949350505050565b60408051808201909152600681527f646f6d61696e00000000000000000000000000000000000000000000000000006020909101526060818160007fc5d3ba30d3ac69f3f095a61e99369d9450502ca0c2f4768b2c39ee277faa631d815b84811015612604578188888381811061246057612460613db3565b90506020028101906124729190614319565b61247c9080613d36565b60405161248a929190613caf565b604051809103902003612575576001925061253f8888838181106124b0576124b0613db3565b90506020028101906124c29190614319565b6124d0906020810190613d36565b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505060408051808201909152600281527f5f2d00000000000000000000000000000000000000000000000000000000000060208201529150612d4b9050565b612575576040517f3f71cb2500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8388888381811061258857612588613db3565b905060200281019061259a9190614319565b6125a49080613d36565b8a8a858181106125b6576125b6613db3565b90506020028101906125c89190614319565b6125d6906020810190613d36565b6040516020016125ea959493929190613d7d565b60408051601f198184030181529190529350600101612445565b508161263c576040517fe8296ea700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b509095945050505050565b60845415611477576083546084546040517f23b872dd0000000000000000000000000000000000000000000000000000000081526001600160a01b03848116600483015230602483015260448201929092529116906323b872dd906064016020604051808303816000875af11580156126c4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906126e8919061432f565b5050565b6001600160a01b0385166000908152607f6020526040902061270e858261420e565b5060016080856040516127219190613c93565b908152604051908190036020018120805492151560ff19909316929092179091558590608090612752908790613c93565b908152604080516020928190038301902080547fffffffffffffffffffffff0000000000000000000000000000000000000000ff166101006001600160a01b039586160217905591871660009081526081909152206127b19084611bab565b506001600160a01b03851660009081526082602052604080822090516127d8908690613c93565b90815260405190819003602001902090508160005b81811015612846578285858381811061280857612808613db3565b905060200281019061281a9190614319565b81546001810183556000928352602090922090916002020161283c8282613ed8565b50506001016127ed565b5050505050505050565b6060600061289384848080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250611b4292505050565b805190915081906000036128ba5760405163430f13b360e01b815260040160405180910390fd5b8051806000805b83821080156128d3575060028160ff16105b801561290357506129038583815181106128ef576128ef613db3565b01602001516001600160f81b031916612e6c565b156129475784828151811061291a5761291a613db3565b01602001516001600160f81b031916601760f91b0361293c5760018083019350015b8160010191506128c1565b8383106129675760405163430f13b360e01b815260040160405180910390fd5b60018160ff1611806129795750838214155b80612985575060028311155b80612991575060228310155b156129af5760405163430f13b360e01b815260040160405180910390fd5b60006129bb84866142f0565b67ffffffffffffffff8111156129d3576129d3613904565b6040519080825280601f01601f1916602001820160405280156129fd576020820181803683370190505b5090508392505b84831015612a6a57858381518110612a1e57612a1e613db3565b01602001516001600160f81b03191681612a3886866142f0565b81518110612a4857612a48613db3565b60200101906001600160f81b031916908160001a905350826001019250612a04565b9998505050505050505050565b60008084805190602001209050612ac48185858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250612f6e92505050565b95945050505050565b60007f41000000000000000000000000000000000000000000000000000000000000006001600160f81b0319831610801590612b3357507f5a000000000000000000000000000000000000000000000000000000000000006001600160f81b0319831611155b15612b5057612b4760f883901c602061434c565b60f81b92915050565b5090565b8051600003612b8f576040517fc7af40f000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b83511580612b9c57508251155b80612ba657508151155b15612bc457604051638baa579f60e01b815260040160405180910390fd5b835160208501206000612bd78286612f6e565b90506000612bed826001600160a01b0316612f92565b90506000805b855181108015612c01575081155b15612cae576000868281518110612c1a57612c1a613db3565b602002602001015190506000612c38826001600160a01b0316612f92565b905060008186604051602001612c4f929190614365565b60408051601f19818403018152919052805160208201209091506000612c75828d612f6e565b9050846001600160a01b0316816001600160a01b031603612c9e57600196505050505050612cae565b8560010195505050505050612bf3565b81612ccc57604051638baa579f60e01b815260040160405180910390fd5b505050505050505050565b600054610100900460ff16612d425760405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b606482015260840161137d565b6111a8336120dd565b8151600090839082818103612d665760009350505050610b25565b8451859060005b84811015612e5d57858181518110612d8757612d87613db3565b01602001516001600160f81b0319169350606160f81b8410801590612dba5750603d60f91b6001600160f81b0319851611155b158015612df05750600360fc1b6001600160f81b0319851610801590612dee5750603960f81b6001600160f81b0319851611155b155b15612e55576000805b83811015612e3d57848181518110612e1357612e13613db3565b01602001516001600160f81b031990811690871603612e355760019150612e3d565b600101612df9565b5080612e53576000975050505050505050610b25565b505b600101612d6d565b50600198975050505050505050565b6000606160f81b6001600160f81b0319831610801590612e9a5750603d60f91b6001600160f81b0319831611155b15612ea757506001919050565b600360fc1b6001600160f81b0319831610801590612ed35750603960f81b6001600160f81b0319831611155b15612ee057506001919050565b7f5f000000000000000000000000000000000000000000000000000000000000006001600160f81b031983161480612f4157507f2d000000000000000000000000000000000000000000000000000000000000006001600160f81b03198316145b80612f595750601760f91b6001600160f81b03198316145b15612f6657506001919050565b506000919050565b6000806000612f7d8585612fa9565b91509150612f8a81612fee565b509392505050565b6060610b2582612fa184613153565b6001016131bd565b6000808251604103612fdf5760208301516040840151606085015160001a612fd387828585613382565b94509450505050612fe7565b506000905060025b9250929050565b600081600481111561300257613002614394565b0361300a5750565b600181600481111561301e5761301e614394565b0361306b5760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e61747572650000000000000000604482015260640161137d565b600281600481111561307f5761307f614394565b036130cc5760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e67746800604482015260640161137d565b60038160048111156130e0576130e0614394565b036114775760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c60448201527f7565000000000000000000000000000000000000000000000000000000000000606482015260840161137d565b600080608083901c1561316b5760809290921c916010015b604083901c156131805760409290921c916008015b602083901c156131955760209290921c916004015b601083901c156131aa5760109290921c916002015b600883901c15610b255760010192915050565b606060006131cc8360026143aa565b6131d79060026143c1565b67ffffffffffffffff8111156131ef576131ef613904565b6040519080825280601f01601f191660200182016040528015613219576020820181803683370190505b509050600360fc1b8160008151811061323457613234613db3565b60200101906001600160f81b031916908160001a9053507f78000000000000000000000000000000000000000000000000000000000000008160018151811061327f5761327f613db3565b60200101906001600160f81b031916908160001a90535060006132a38460026143aa565b6132ae9060016143c1565b90505b6001811115613333577f303132333435363738396162636465660000000000000000000000000000000085600f16601081106132ef576132ef613db3565b1a60f81b82828151811061330557613305613db3565b60200101906001600160f81b031916908160001a90535060049490941c9361332c816143d4565b90506132b1565b5083156122fb5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604482015260640161137d565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08311156133b95750600090506003610ac9565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa15801561340d573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b03811661343657600060019250925050610ac9565b9660009650945050505050565b50805461344f90613cbf565b6000825580601f1061345f575050565b601f016020900490600052602060002090810190611477919061349e565b508054600082556002029060005260206000209081019061147791906134b3565b5b80821115612b50576000815560010161349f565b80821115612b505760006134c78282613443565b6134d5600183016000613443565b506002016134b3565b60005b838110156134f95781810151838201526020016134e1565b50506000910152565b6000815180845261351a8160208601602086016134de565b601f01601f19169290920160200192915050565b6020815260006122fb6020830184613502565b60008083601f84011261355357600080fd5b50813567ffffffffffffffff81111561356b57600080fd5b602083019150836020828501011115612fe757600080fd5b6001600160a01b038116811461147757600080fd5b80356135a381613583565b919050565b6000806000806000606086880312156135c057600080fd5b853567ffffffffffffffff808211156135d857600080fd5b6135e489838a01613541565b9097509550602088013591506135f982613583565b9093506040870135908082111561360f57600080fd5b5061361c88828901613541565b969995985093965092949392505050565b60006020828403121561363f57600080fd5b81356122fb81613583565b6000806000806040858703121561366057600080fd5b843567ffffffffffffffff8082111561367857600080fd5b61368488838901613541565b9096509450602087013591508082111561369d57600080fd5b506136aa87828801613541565b95989497509550505050565b600060408083016001600160a01b03861684526020828186015281865180845260608701915060608160051b880101935082880160005b8281101561373d57888603605f190184528151805188885261371189890182613502565b91870151888303898901529190506137298183613502565b9750505092840192908401906001016136ed565b50939998505050505050505050565b6000806020838503121561375f57600080fd5b823567ffffffffffffffff81111561377657600080fd5b61378285828601613541565b90969095509350505050565b6000604082840312156137a057600080fd5b50919050565b60008060008060008060008060008060c08b8d0312156137c557600080fd5b6137ce8b613598565b995060208b013567ffffffffffffffff808211156137eb57600080fd5b6137f78e838f01613541565b909b50995060408d013591508082111561381057600080fd5b61381c8e838f01613541565b909950975060608d013591508082111561383557600080fd5b6138418e838f0161378e565b965060808d013591508082111561385757600080fd5b6138638e838f01613541565b909650945060a08d013591508082111561387c57600080fd5b506138898d828e01613541565b915080935050809150509295989b9194979a5092959850565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b828110156138f757603f198886030184526138e5858351613502565b945092850192908501906001016138c9565b5092979650505050505050565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561392c57600080fd5b813567ffffffffffffffff8082111561394457600080fd5b818401915084601f83011261395857600080fd5b81358181111561396a5761396a613904565b604051601f8201601f19908116603f0116810190838211818310171561399257613992613904565b816040528281528760208487010111156139ab57600080fd5b826020860160208301376000928101602001929092525095945050505050565b600080600080600080600080600060a08a8c0312156139e957600080fd5b89356139f481613583565b985060208a013567ffffffffffffffff80821115613a1157600080fd5b613a1d8d838e01613541565b909a50985060408c0135915080821115613a3657600080fd5b613a428d838e01613541565b909850965060608c0135915080821115613a5b57600080fd5b613a678d838e01613541565b909650945060808c0135915080821115613a8057600080fd5b50613a8d8c828d01613541565b915080935050809150509295985092959850929598565b801515811461147757600080fd5b600060208284031215613ac457600080fd5b81356122fb81613aa4565b60008083601f840112613ae157600080fd5b50813567ffffffffffffffff811115613af957600080fd5b6020830191508360208260051b8501011115612fe757600080fd5b600080600080600080600080600080600060c08c8e031215613b3557600080fd5b613b3e8c613598565b9a5067ffffffffffffffff8060208e01351115613b5a57600080fd5b613b6a8e60208f01358f01613541565b909b50995060408d0135811015613b8057600080fd5b613b908e60408f01358f01613541565b909950975060608d0135811015613ba657600080fd5b613bb68e60608f01358f01613acf565b909750955060808d0135811015613bcc57600080fd5b613bdc8e60808f01358f01613541565b909550935060a08d0135811015613bf257600080fd5b50613c038d60a08e01358e01613541565b81935080925050509295989b509295989b9093969950565b600060208284031215613c2d57600080fd5b5035919050565b8385823760609290921b6bffffffffffffffffffffffff1916919092019081526014810191909152603401919050565b634e487b7160e01b600052601160045260246000fd5b600060018201613c8c57613c8c613c64565b5060010190565b60008251613ca58184602087016134de565b9190910192915050565b8183823760009101908152919050565b600181811c90821680613cd357607f821691505b6020821081036137a057634e487b7160e01b600052602260045260246000fd5b6bffffffffffffffffffffffff198660601b1681528385601483013760008482016014810160008152848682375060009301601401928352509095945050505050565b6000808335601e19843603018112613d4d57600080fd5b83018035915067ffffffffffffffff821115613d6857600080fd5b602001915036819003821315612fe757600080fd5b60008651613d8f818460208b016134de565b82018587823760009086019081528385823760009301928352509095945050505050565b634e487b7160e01b600052603260045260246000fd5b601f821115611d3e57600081815260208120601f850160051c81016020861015613df05750805b601f850160051c820191505b81811015613e0f57828155600101613dfc565b505050505050565b67ffffffffffffffff831115613e2f57613e2f613904565b613e4383613e3d8354613cbf565b83613dc9565b6000601f841160018114613e775760008515613e5f5750838201355b600019600387901b1c1916600186901b178355613ed1565b600083815260209020601f19861690835b82811015613ea85786850135825560209485019460019092019101613e88565b5086821015613ec55760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b613ee28283613d36565b67ffffffffffffffff811115613efa57613efa613904565b613f0e81613f088554613cbf565b85613dc9565b6000601f821160018114613f425760008315613f2a5750838201355b600019600385901b1c1916600184901b178555613f9c565b600085815260209020601f19841690835b82811015613f735786850135825560209485019460019092019101613f53565b5084821015613f905760001960f88660031b161c19848701351681555b505060018360011b0185555b50505050613fad6020830183613d36565b613fbb818360018601613e17565b50505050565b6000808335601e19843603018112613fd857600080fd5b830160208101925035905067ffffffffffffffff811115613ff857600080fd5b803603821315612fe757600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b600061403c8283613fc1565b6040855261404e604086018284614007565b91505061405e6020840184613fc1565b8583036020870152614071838284614007565b9695505050505050565b6001600160a01b038516815260806020820152600061409d6080830186613502565b82810360408401526140af8186613502565b905082810360608401526140c38185614030565b979650505050505050565b6001600160a01b03841681526060602082015260006140f06060830185613502565b82810360408401526140718185613502565b6bffffffffffffffffffffffff198760601b1681528486601483013760008582016014810160008152858782375084810190506014810160008152845161414d8183602089016134de565b919091016014019998505050505050505050565b6001600160a01b03881681526000602060808184015261418560808401898b614007565b838103604085015261419881888a614007565b84810360608601528581529050818101600586901b82018301876000805b898110156141fa57858403601f190185528235368c9003603e190181126141db578283fd5b6141e7858d8301614030565b95880195945050918601916001016141b6565b50919e9d5050505050505050505050505050565b815167ffffffffffffffff81111561422857614228613904565b61423c816142368454613cbf565b84613dc9565b602080601f83116001811461427157600084156142595750858301515b600019600386901b1c1916600185901b178555613e0f565b600085815260208120601f198616915b828110156142a057888601518255948401946001909101908401614281565b50858210156142be5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b600083516142e08184602088016134de565b9190910191825250602001919050565b81810381811115610b2557610b25613c64565b634e487b7160e01b600052603160045260246000fd5b60008235603e19833603018112613ca557600080fd5b60006020828403121561434157600080fd5b81516122fb81613aa4565b60ff8181168382160190811115610b2557610b25613c64565b600083516143778184602088016134de565b83519083019061438b8183602088016134de565b01949350505050565b634e487b7160e01b600052602160045260246000fd5b8082028115828204841417610b2557610b25613c64565b80820180821115610b2557610b25613c64565b6000816143e3576143e3613c64565b50600019019056fea26469706673582212200d1b025d94b4e1bfdbbdabec85a906a6c3ef1679e8331212613dc8f30cf7862064736f6c63430008120033