{"file_path":"contracts/StablecoinV2.sol","creation_status":"success","source_code":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.24;\n\nimport {ERC20Upgradeable} from \"@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol\";\nimport {ECDSAUpgradeable} from \"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\";\nimport {IERC20} from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport {SafeERC20} from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport {Stablecoin} from \"./Stablecoin.sol\";\nimport {IERC3009} from \"./interfaces/IERC3009.sol\";\n\n/**\n * @title StablecoinV2\n * @notice V2 implementation that adds EIP-3009 support and frozen-funds admin controls.\n * @dev This contract inherits the legacy V1 storage layout and stores all newly added mutable state in an\n *      EIP-7201-style storage slot to avoid collisions during proxy upgrades.\n */\ncontract StablecoinV2 is Stablecoin, IERC3009 {\n    using SafeERC20 for IERC20;\n\n    // ==================================================\n    // ===================== Structs ====================\n    // ==================================================\n\n    /// @custom:storage-location erc7201:openzeppelin.storage.StablecoinV2\n    struct StablecoinV2Storage {\n        mapping(address authorizer => mapping(bytes32 nonce => bool)) authorizationStates;\n    }\n\n    enum AuthorizationCancellability {\n        Cancelable,\n        Used,\n        InvalidSignature\n    }\n\n    // ==================================================\n    // ==================== Constants ===================\n    // ==================================================\n\n    // solhint-disable-next-line max-line-length\n    /// @notice keccak256(\"TransferWithAuthorization(address from,address to,uint256 value,uint256 validAfter,uint256 validBefore,bytes32 nonce)\")\n    bytes32 public constant TRANSFER_WITH_AUTHORIZATION_TYPEHASH =\n        0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267;\n\n    // solhint-disable-next-line max-line-length\n    /// @notice keccak256(\"ReceiveWithAuthorization(address from,address to,uint256 value,uint256 validAfter,uint256 validBefore,bytes32 nonce)\")\n    bytes32 public constant RECEIVE_WITH_AUTHORIZATION_TYPEHASH =\n        0xd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8;\n\n    /// @notice keccak256(\"CancelAuthorization(address authorizer,bytes32 nonce)\")\n    bytes32 public constant CANCEL_AUTHORIZATION_TYPEHASH =\n        0x158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a1597429;\n\n    uint8 private constant _VERSION = 2;\n    // USD1 EIP-712 signature domain version.\n    string private constant _EIP712_VERSION = \"1\";\n\n    bytes32 private constant _STABLECOIN_V2_STORAGE_LOCATION =\n        keccak256(abi.encode(uint256(keccak256(\"openzeppelin.storage.StablecoinV2\")) - 1)) & ~bytes32(uint256(0xff)); // solhint-disable-line max-line-length\n\n    string private constant _AUTHORIZATION_USED_ERROR = \"EIP3009: authorization is used\";\n    string private constant _AUTHORIZATION_NOT_YET_VALID_ERROR = \"EIP3009: authorization is not yet valid\";\n    string private constant _AUTHORIZATION_EXPIRED_ERROR = \"EIP3009: authorization is expired\";\n    string private constant _INVALID_SIGNATURE_ERROR = \"EIP3009: invalid signature\";\n    string private constant _INVALID_PAYEE_ERROR = \"EIP3009: caller must be the payee\";\n    string private constant _INVALID_BATCH_LENGTH_ERROR = \"EIP3009: invalid batch length\";\n    string private constant _ACCOUNT_NOT_FROZEN_ERROR = \"Account is not frozen\";\n    string private constant _INVALID_RECIPIENT_ERROR = \"Invalid recipient\";\n\n    // ==================================================\n    // ====================== Events ====================\n    // ==================================================\n\n    event FrozenAccountDrained(address indexed caller, address indexed account, uint256 amount);\n    event FrozenFundsReallocated(address indexed caller, address indexed from, address indexed to, uint256 amount);\n    event ERC20Recovered(address indexed caller, address indexed token, address indexed recipient, uint256 amount);\n\n    // ==================================================\n    // ==================== Constructor =================\n    // ==================================================\n\n    /// @custom:oz-upgrades-unsafe-allow constructor\n    constructor() {\n        _disableInitializers();\n    }\n\n    // ==================================================\n    // =================== Initializers =================\n    // ==================================================\n\n    /* solhint-disable ordering */\n\n    /// @custom:oz-upgrades-validate-as-initializer\n    function initialize(\n        address _initialOwner,\n        string memory _name,\n        string memory _symbol\n    ) public virtual override {\n        // There is no initializer modifier on this function, so we can call `initializeV2`\n        super.initialize(_initialOwner, _name, _symbol);\n        initializeV2();\n    }\n\n    /**\n     * @notice Marks the proxy as initialized for the V2 upgrade step.\n     * @dev Migrates EIP-712 state into the OpenZeppelin v4.9 storage layout.\n     */\n    /// @custom:oz-upgrades-validate-as-initializer\n    function initializeV2() public reinitializer(_VERSION) {\n        __EIP712_init(name(), _EIP712_VERSION);\n    }\n\n    // ==================================================\n    // ==================== Functions ===================\n    // ==================================================\n\n    /// @inheritdoc IERC3009\n    function transferWithAuthorization(\n        address from,\n        address to,\n        uint256 value,\n        uint256 validAfter,\n        uint256 validBefore,\n        bytes32 nonce,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external override notFrozen(_msgSender()) {\n        _transferWithAuthorization(\n            from,\n            to,\n            value,\n            validAfter,\n            validBefore,\n            nonce,\n            v,\n            r,\n            s,\n            TRANSFER_WITH_AUTHORIZATION_TYPEHASH\n        );\n    }\n\n    /* solhint-enable ordering */\n\n    /// @inheritdoc IERC3009\n    function receiveWithAuthorization(\n        address from,\n        address to,\n        uint256 value,\n        uint256 validAfter,\n        uint256 validBefore,\n        bytes32 nonce,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external override notFrozen(_msgSender()) {\n        require(to == _msgSender(), _INVALID_PAYEE_ERROR);\n        _transferWithAuthorization(\n            from,\n            to,\n            value,\n            validAfter,\n            validBefore,\n            nonce,\n            v,\n            r,\n            s,\n            RECEIVE_WITH_AUTHORIZATION_TYPEHASH\n        );\n    }\n\n    /// @inheritdoc IERC3009\n    function cancelAuthorization(\n        address authorizer,\n        bytes32 nonce,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external override notFrozen(_msgSender()) {\n        _requireAuthorizationCanBeCanceled(_getAuthorizationCancellability(authorizer, nonce, v, r, s));\n\n        _setAuthorizationAsUsed(authorizer, nonce);\n        emit AuthorizationCanceled(authorizer, nonce);\n    }\n\n    /**\n     * @notice Attempt to cancel multiple authorizations\n     * @dev When `_ignoreErrors` is true, entries that fail the preflight cancellation checks are skipped.\n     * @dev A frozen caller is still rejected before any per-item processing begins.\n     * @dev Malformed signatures do not bypass signature validation; they are treated as invalid entries and either\n     *      return `false` or revert depending on `_ignoreErrors`.\n     * @param _authorizerList Authorizer addresses\n     * @param _nonceList Authorization nonces\n     * @param _vList v values of the signatures\n     * @param _rList r values of the signatures\n     * @param _sList s values of the signatures\n     * @param _ignoreErrors True to continue past entries that fail the cancellability check without reverting\n     * @return _didCancelList Boolean results indicating which authorizations were canceled by this call\n     */\n    function batchCancelAuthorization(\n        address[] calldata _authorizerList,\n        bytes32[] calldata _nonceList,\n        uint8[] calldata _vList,\n        bytes32[] calldata _rList,\n        bytes32[] calldata _sList,\n        bool _ignoreErrors\n    )\n        external\n        notFrozen(_msgSender())\n        returns (bool[] memory _didCancelList)\n    {\n        uint256 authorizationCount = _authorizerList.length;\n        require(\n            authorizationCount == _nonceList.length &&\n                authorizationCount == _vList.length &&\n                authorizationCount == _rList.length &&\n                authorizationCount == _sList.length,\n            _INVALID_BATCH_LENGTH_ERROR\n        );\n\n        _didCancelList = new bool[](authorizationCount);\n\n        for (uint256 i; i < authorizationCount; ++i) {\n            _didCancelList[i] = _processBatchCancellation(\n                _authorizerList[i],\n                _nonceList[i],\n                _vList[i],\n                _rList[i],\n                _sList[i],\n                _ignoreErrors\n            );\n        }\n    }\n\n    /**\n     * @notice Moves the full token balance of a frozen account into owner custody.\n     * @dev This function requires the source account to already be frozen.\n     * @dev This function still respects the paused state and will revert while paused.\n     * @dev The transfer bypasses the source-account frozen check only so funds can be recovered from the frozen\n     *      account, but the destination must still satisfy the normal recipient freeze policy.\n     * @param _account The frozen account to drain.\n     */\n    function drain(address _account) external onlyOwner {\n        require(frozen[_account], _ACCOUNT_NOT_FROZEN_ERROR);\n\n        uint256 amount = balanceOf(_account);\n        _transferFromFrozenSource(_account, owner(), amount);\n\n        emit FrozenAccountDrained(_msgSender(), _account, amount);\n    }\n\n    /**\n     * @notice Recovers ERC-20 balances held by the token contract.\n     * @dev This function still respects the paused state and will revert while paused.\n     * @dev If `_token` is this token, recovery uses the contract's normal transfer path and therefore still applies\n     *      the standard frozen-account checks to the recipient.\n     * @param _token The token address to recover.\n     * @param _recipient The recipient of the recovered tokens.\n     * @param _amount The amount to recover, in the token's base units.\n     */\n    function recoverERC20(\n        address _token,\n        address _recipient,\n        uint256 _amount\n    ) external onlyOwner notFrozen(_recipient) {\n        require(_recipient != address(0), _INVALID_RECIPIENT_ERROR);\n        _requireNotPaused();\n\n        if (_token == address(this)) {\n            _transfer(address(this), _recipient, _amount);\n        } else {\n            IERC20(_token).safeTransfer(_recipient, _amount);\n        }\n\n        emit ERC20Recovered(_msgSender(), _token, _recipient, _amount);\n    }\n\n    /**\n     * @notice Reallocates tokens from a frozen source account into a replacement account.\n     * @dev This function requires `_from` to already be frozen and rejects a frozen replacement account.\n     * @dev This function still respects the paused state and will revert while paused.\n     * @dev The transfer bypasses the source-account frozen check only so funds can be moved out of the frozen source,\n     *      but the replacement account must still satisfy the normal recipient freeze policy.\n     * @param _from The frozen source account.\n     * @param _to The replacement account.\n     * @param _amount The amount to move, in token base units.\n     */\n    function reallocate(address _from, address _to, uint256 _amount) external onlyOwner {\n        require(frozen[_from], _ACCOUNT_NOT_FROZEN_ERROR);\n\n        _transferFromFrozenSource(_from, _to, _amount);\n        emit FrozenFundsReallocated(_msgSender(), _from, _to, _amount);\n    }\n\n    /// @inheritdoc IERC3009\n    function authorizationState(address authorizer, bytes32 nonce) external view override returns (bool) {\n        return _authorizationState(authorizer, nonce);\n    }\n\n    function version() external virtual view returns (uint8) {\n        return _VERSION;\n    }\n\n    // ==================================================\n    // ================= Internal Functions =============\n    // ==================================================\n\n    function _transfer(\n        address _from,\n        address _to,\n        uint256 _amount\n    ) internal override {\n        require(_to != address(this), _INVALID_RECIPIENT_ERROR);\n        super._transfer(_from, _to, _amount);\n    }\n\n    function _setAuthorizationAsUsed(address _authorizer, bytes32 _nonce) internal {\n        StablecoinV2Storage storage $ = _getStorage();\n        $.authorizationStates[_authorizer][_nonce] = true;\n    }\n\n    function _processBatchCancellation(\n        address _authorizer,\n        bytes32 _nonce,\n        uint8 _v,\n        bytes32 _r,\n        bytes32 _s,\n        bool _ignoreErrors\n    ) internal returns (bool) {\n        AuthorizationCancellability cancelability = _getAuthorizationCancellability(_authorizer, _nonce, _v, _r, _s);\n\n        if (cancelability != AuthorizationCancellability.Cancelable) {\n            if (!_ignoreErrors) {\n                _requireAuthorizationCanBeCanceled(cancelability);\n            }\n\n            return false;\n        }\n\n        _setAuthorizationAsUsed(_authorizer, _nonce);\n        emit AuthorizationCanceled(_authorizer, _nonce);\n        return true;\n    }\n\n    function _transferWithAuthorization(\n        address _from,\n        address _to,\n        uint256 _value,\n        uint256 _validAfter,\n        uint256 _validBefore,\n        bytes32 _nonce,\n        uint8 _v,\n        bytes32 _r,\n        bytes32 _s,\n        bytes32 _typehash\n    ) internal {\n        _requireValidAuthorization(_from, _nonce, _validAfter, _validBefore);\n        _requireValidSignature(\n            _from,\n            keccak256(abi.encode(_typehash, _from, _to, _value, _validAfter, _validBefore, _nonce)),\n            _v,\n            _r,\n            _s\n        );\n\n        _setAuthorizationAsUsed(_from, _nonce);\n        _transfer(_from, _to, _value);\n        emit AuthorizationUsed(_from, _nonce);\n    }\n\n    // Admin frozen-funds actions intentionally bypass only the source-account frozen check.\n    // They still obey the global paused state and the standard destination freeze policy.\n    function _transferFromFrozenSource(\n        address _from,\n        address _to,\n        uint256 _amount\n    ) internal whenNotPaused notFrozen(_to) {\n        // Call the ERC20 base implementation directly so frozen-funds admin flows can move funds out of a frozen source\n        // without bypassing the pause or frozen-recipient checks above.\n        ERC20Upgradeable._transfer(_from, _to, _amount);\n    }\n\n    function _authorizationState(address _authorizer, bytes32 _nonce) internal view returns (bool) {\n        StablecoinV2Storage storage $ = _getStorage();\n        return $.authorizationStates[_authorizer][_nonce];\n    }\n\n    function _requireValidAuthorization(\n        address _authorizer,\n        bytes32 _nonce,\n        uint256 _validAfter,\n        uint256 _validBefore\n    ) internal view {\n        require(block.timestamp > _validAfter, _AUTHORIZATION_NOT_YET_VALID_ERROR);\n        require(block.timestamp < _validBefore, _AUTHORIZATION_EXPIRED_ERROR);\n        _requireUnusedAuthorization(_authorizer, _nonce);\n    }\n\n    function _requireUnusedAuthorization(address _authorizer, bytes32 _nonce) internal view {\n        require(!_authorizationState(_authorizer, _nonce), _AUTHORIZATION_USED_ERROR);\n    }\n\n    function _requireValidSignature(\n        address _authorizer,\n        bytes32 _structHash,\n        uint8 _v,\n        bytes32 _r,\n        bytes32 _s\n    ) internal view {\n        require(_isValidSignature(_authorizer, _structHash, _v, _r, _s), _INVALID_SIGNATURE_ERROR);\n    }\n\n    function _getAuthorizationCancellability(address _authorizer, bytes32 _nonce, uint8 _v, bytes32 _r, bytes32 _s)\n        internal\n        view\n        returns (AuthorizationCancellability)\n    {\n        // Caller frozen policy is enforced at the external entrypoints. This helper only evaluates\n        // per-authorization state and signature validity.\n        if (_authorizationState(_authorizer, _nonce)) {\n            return AuthorizationCancellability.Used;\n        }\n        if (!_isValidSignature(_authorizer, _getCancelAuthorizationHash(_authorizer, _nonce), _v, _r, _s)) {\n            return AuthorizationCancellability.InvalidSignature;\n        }\n\n        return AuthorizationCancellability.Cancelable;\n    }\n\n    function _isValidSignature(\n        address _authorizer,\n        bytes32 _structHash,\n        uint8 _v,\n        bytes32 _r,\n        bytes32 _s\n    ) internal view returns (bool) {\n        bytes32 hash = _hashTypedDataV4(_structHash);\n        (address recovered, ECDSAUpgradeable.RecoverError recoverError) = ECDSAUpgradeable.tryRecover(hash, _v, _r, _s);\n        return recoverError == ECDSAUpgradeable.RecoverError.NoError && recovered == _authorizer;\n    }\n\n    function _requireAuthorizationCanBeCanceled(\n        AuthorizationCancellability _cancellability\n    ) internal pure {\n        if (_cancellability == AuthorizationCancellability.Used) {\n            revert(_AUTHORIZATION_USED_ERROR);\n        }\n        if (_cancellability == AuthorizationCancellability.InvalidSignature) {\n            revert(_INVALID_SIGNATURE_ERROR);\n        }\n    }\n\n    function _getCancelAuthorizationHash(address _authorizer, bytes32 _nonce) internal pure returns (bytes32) {\n        return keccak256(abi.encode(CANCEL_AUTHORIZATION_TYPEHASH, _authorizer, _nonce));\n    }\n\n    function _getStorage() private pure returns (StablecoinV2Storage storage $) {\n        bytes32 location = _STABLECOIN_V2_STORAGE_LOCATION;\n        // solhint-disable-next-line no-inline-assembly\n        assembly {\n            $.slot := location\n        }\n    }\n}\n","deployed_bytecode":"0x608060405234801561001057600080fd5b506004361061025e5760003560e01c80637f2eecc311610146578063a9059cbb116100c3578063e30c397811610087578063e30c397814610543578063e3ee160e14610554578063e94a010214610567578063ece531321461057a578063ef55bec61461058d578063f2fde38b146105a057600080fd5b8063a9059cbb146104bf578063d0516650146104d2578063d505accf146104f6578063d916948714610509578063dd62ed3e1461053057600080fd5b8063906571471161010a578063906571471461045757806395d89b411461046a578063a0712d6814610472578063a0cc6a6814610485578063a457c2d7146104ac57600080fd5b80637f2eecc3146103e05780638456cb591461040757806384b0196e1461040f5780638d1fdf2f1461042a5780638da5cb5b1461043d57600080fd5b806342966c68116101df5780635cd8a76b116101a35780635cd8a76b1461036c57806370a0823114610374578063715018a61461039d5780637893960c146103a557806379ba5097146103c55780637ecebe00146103cd57600080fd5b806342966c681461032057806345c8b1a61461033357806354fd4d50146103465780635a049a701461034d5780635c975abb1461036057600080fd5b8063308b8c0011610226578063308b8c00146102da578063313ce567146102ed5780633644e515146102fd57806339509351146103055780633f4ba83a1461031857600080fd5b806306fdde0314610263578063095ea7b3146102815780631171bda9146102a157806318160ddd146102b657806323b872dd146102c7575b600080fd5b61026b6105b3565b6040516102789190612699565b60405180910390f35b61029461028f3660046126eb565b610645565b6040516102789190612732565b6102b46102af366004612740565b61065f565b005b6035545b6040516102789190612796565b6102946102d5366004612740565b610799565b6102b46102e8366004612740565b6107bf565b60125b60405161027891906127ad565b6102ba61089d565b6102946103133660046126eb565b6108ac565b6102b46108ce565b61029461032e3660046127bb565b6108e0565b6102b46103413660046127dc565b610939565b60026102f0565b6102b461035b366004612811565b61098c565b6101305460ff16610294565b6102b4610a1a565b6102ba6103823660046127dc565b6001600160a01b031660009081526033602052604090205490565b6102b4610adc565b6103b86103b33660046128ee565b610afc565b6040516102789190612a73565b6102b4610cd9565b6102ba6103db3660046127dc565b610d11565b6102ba7fd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de881565b6102b4610d2f565b610417610d3f565b6040516102789796959493929190612ae7565b6102b46104383660046127dc565b610db5565b60cc546001600160a01b03165b6040516102789190612b56565b6102b4610465366004612c5a565b610e20565b61026b610e38565b6102946104803660046127bb565b610e47565b6102ba7f7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a226781565b6102946104ba3660046126eb565b610e8f565b6102946104cd3660046126eb565b610ed7565b6102946104e03660046127dc565b6101626020526000908152604090205460ff1681565b6102b4610504366004612cd6565b610ee5565b6102ba7f158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a159742981565b6102ba61053e366004612d75565b610fc7565b60fe546001600160a01b031661044a565b6102b4610562366004612da8565b610ff2565b6102946105753660046126eb565b611055565b6102b46105883660046127dc565b611061565b6102b461059b366004612da8565b61115a565b6102b46105ae3660046127dc565b61120a565b6060603680546105c290612e85565b80601f01602080910402602001604051908101604052809291908181526020018280546105ee90612e85565b801561063b5780601f106106105761010080835404028352916020019161063b565b820191906000526020600020905b81548152906001019060200180831161061e57829003601f168201915b5050505050905090565b60003361065381858561127b565b60019150505b92915050565b61066761130d565b6001600160a01b03821660009081526101626020526040902054829060ff16156106ac5760405162461bcd60e51b81526004016106a390612ed6565b60405180910390fd5b604080518082019091526011815270125b9d985b1a59081c9958da5c1a595b9d607a1b60208201526001600160a01b0384166106fb5760405162461bcd60e51b81526004016106a39190612699565b50610704611337565b306001600160a01b038516036107245761071f30848461135b565b610738565b6107386001600160a01b03851684846113b8565b826001600160a01b0316846001600160a01b03166107533390565b6001600160a01b03167f8816b49b19067a2d5520c96b81353ec05eea757a318795d5acdcbabe42b464078560405161078b9190612796565b60405180910390a450505050565b6000336107a785828561140e565b6107b285858561135b565b60019150505b9392505050565b6107c761130d565b6001600160a01b03831660009081526101626020908152604091829020548251808401909352601583527420b1b1b7bab73a1034b9903737ba10333937bd32b760591b9183019190915260ff166108315760405162461bcd60e51b81526004016106a39190612699565b5061083d838383611458565b816001600160a01b0316836001600160a01b03166108583390565b6001600160a01b03167f10aa54b8d21641b161adf6251c11512c46fcf822feaf6f66057c006dc29def4a846040516108909190612796565b60405180910390a4505050565b60006108a76114a7565b905090565b6000336106538185856108bf8383610fc7565b6108c99190612efc565b61127b565b6108d661130d565b6108de6114b1565b565b60006108ea61130d565b6108f433836114fe565b604051339081907fbac40739b0d4ca32fa2d82fc91630465ba3eddd1598da6fca393b26fb63b945390610928908690612796565b60405180910390a35060015b919050565b61094161130d565b6001600160a01b03811660008181526101626020526040808220805460ff191690555133917f4f3ab9ff0cc4f039268532098e01239544b0420171876e36889d01c62c784c7991a350565b336000818152610162602052604090205460ff16156109bd5760405162461bcd60e51b81526004016106a390612ed6565b6109d26109cd87878787876115c2565b61160a565b6109dc86866116d2565b60405185906001600160a01b038816907f1cdd46ff242716cdaa72d159d339a485b3438398348d68f09d7c8c0a59353d8190600090a3505050505050565b600054600290610100900460ff16158015610a3c575060005460ff8083169116105b610a585760405162461bcd60e51b81526004016106a390612f5d565b6000805461ffff191660ff831617610100179055610a96610a776105b3565b604051806040016040528060018152602001603160f81b81525061170d565b6000805461ff00191690556040517f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890610ad19083906127ad565b60405180910390a150565b610ae461130d565b60405162461bcd60e51b81526004016106a390612f8f565b33600081815261016260205260409020546060919060ff1615610b315760405162461bcd60e51b81526004016106a390612ed6565b8b8a81148015610b4057508089145b8015610b4b57508087145b8015610b5657508085145b6040518060400160405280601d81526020017f454950333030393a20696e76616c6964206261746368206c656e67746800000081525090610baa5760405162461bcd60e51b81526004016106a39190612699565b508067ffffffffffffffff811115610bc457610bc4612b64565b604051908082528060200260200182016040528015610bed578160200160208202803683370190505b50925060005b81811015610cc757610c9d8f8f83818110610c1057610c10612f9f565b9050602002016020810190610c2591906127dc565b8e8e84818110610c3757610c37612f9f565b905060200201358d8d85818110610c5057610c50612f9f565b9050602002016020810190610c659190612fb5565b8c8c86818110610c7757610c77612f9f565b905060200201358b8b87818110610c9057610c90612f9f565b905060200201358a611742565b848281518110610caf57610caf612f9f565b91151560209283029190910190910152600101610bf3565b5050509b9a5050505050505050505050565b60fe5433906001600160a01b03168114610d055760405162461bcd60e51b81526004016106a39061301c565b610d0e816117d5565b50565b6001600160a01b038116600090815260996020526040812054610659565b610d3761130d565b6108de6117ee565b6000606080600080600060606065546000801b148015610d5f5750606654155b610d7b5760405162461bcd60e51b81526004016106a390613058565b610d8361182c565b610d8b61183b565b60408051600080825260208201909252600f60f81b9b939a50919850469750309650945092509050565b610dbd61130d565b6001600160a01b038116600081815261016260205260409020805460ff19166001179055610de83390565b6001600160a01b03167f51d18786e9cb144f87d46e7b796309ea84c7c687d91e09c97f051eacf59bc52860405160405180910390a350565b610e2b83838361184a565b610e33610a1a565b505050565b6060603780546105c290612e85565b6000610e5161130d565b610e5b3383611947565b604051339081907fab8530f87dc9b59234c4623bf917212bb2536d647574c8e7e5da92c2ede0c9f890610928908690612796565b60003381610e9d8286610fc7565b905083811015610ebf5760405162461bcd60e51b81526004016106a3906130aa565b610ecc828686840361127b565b506001949350505050565b60003361065381858561135b565b83421115610f055760405162461bcd60e51b81526004016106a3906130ee565b60007f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9888888610f348c6119d1565b89604051602001610f4a969594939291906130fe565b6040516020818303038152906040528051906020012090506000610f6d826119f9565b90506000610f7d82878787611a26565b9050896001600160a01b0316816001600160a01b031614610fb05760405162461bcd60e51b81526004016106a390613181565b610fbb8a8a8a61127b565b50505050505050505050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b336000818152610162602052604090205460ff16156110235760405162461bcd60e51b81526004016106a390612ed6565b610fbb8a8a8a8a8a8a8a8a8a7f7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267611a50565b60006107b88383611af2565b61106961130d565b6001600160a01b03811660009081526101626020908152604091829020548251808401909352601583527420b1b1b7bab73a1034b9903737ba10333937bd32b760591b9183019190915260ff166110d35760405162461bcd60e51b81526004016106a39190612699565b506001600160a01b038116600090815260336020526040812054905061110b8261110560cc546001600160a01b031690565b83611458565b6001600160a01b038216336001600160a01b03167f76fa81ac53e82d7102caacc3866ae3ca5684caa4c24d995ff4d76ce8a10fbfef8360405161114e9190612796565b60405180910390a35050565b336000818152610162602052604090205460ff161561118b5760405162461bcd60e51b81526004016106a390612ed6565b336001600160a01b0316896001600160a01b031614604051806060016040528060218152602001613a6860219139906111d75760405162461bcd60e51b81526004016106a39190612699565b50610fbb8a8a8a8a8a8a8a8a8a7fd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8611a50565b61121261130d565b60fe80546001600160a01b0383166001600160a01b0319909116811790915561124360cc546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b611283611337565b6001600160a01b03831660009081526101626020526040902054839060ff16156112bf5760405162461bcd60e51b81526004016106a390612ed6565b6001600160a01b03831660009081526101626020526040902054839060ff16156112fb5760405162461bcd60e51b81526004016106a390612ed6565b611306858585611b2a565b5050505050565b60cc546001600160a01b031633146108de5760405162461bcd60e51b81526004016106a3906131c3565b6101305460ff16156108de5760405162461bcd60e51b81526004016106a3906131fa565b604080518082019091526011815270125b9d985b1a59081c9958da5c1a595b9d607a1b60208201526001600160a01b03831630036113ac5760405162461bcd60e51b81526004016106a39190612699565b50610e33838383611bd1565b610e338363a9059cbb60e01b84846040516024016113d792919061320a565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152611c95565b600061141a8484610fc7565b9050600019811461145257818110156114455760405162461bcd60e51b81526004016106a390613259565b611452848484840361127b565b50505050565b611460611337565b6001600160a01b03821660009081526101626020526040902054829060ff161561149c5760405162461bcd60e51b81526004016106a390612ed6565b611452848484611d27565b60006108a7611e17565b6114b9611e7b565b610130805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516114f49190612b56565b60405180910390a1565b6001600160a01b0382166115245760405162461bcd60e51b81526004016106a3906132a7565b6001600160a01b0382166000908152603360205260409020548181101561155d5760405162461bcd60e51b81526004016106a3906132f6565b6001600160a01b0383166000818152603360205260408082208585039055603580548690039055519091907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906115b5908690612796565b60405180910390a3505050565b60006115ce8686611af2565b156115db57506001611601565b6115f1866115e98888611e9e565b868686611ef4565b6115fd57506002611601565b5060005b95945050505050565b600181600281111561161e5761161e613306565b0361166e57604080518082018252601e81527f454950333030393a20617574686f72697a6174696f6e206973207573656400006020820152905162461bcd60e51b81526106a39190600401612699565b600281600281111561168257611682613306565b03610d0e57604080518082018252601a81527f454950333030393a20696e76616c6964207369676e61747572650000000000006020820152905162461bcd60e51b81526106a39190600401612699565b60006116dc611f55565b6001600160a01b0390931660009081526020938452604080822093825292909352509020805460ff19166001179055565b600054610100900460ff166117345760405162461bcd60e51b81526004016106a390613364565b61173e8282611fb5565b5050565b60008061175288888888886115c2565b9050600081600281111561176857611768613306565b14611785578261177b5761177b8161160a565b60009150506117cb565b61178f88886116d2565b60405187906001600160a01b038a16907f1cdd46ff242716cdaa72d159d339a485b3438398348d68f09d7c8c0a59353d8190600090a360019150505b9695505050505050565b60fe80546001600160a01b0319169055610d0e81612004565b6117f6611337565b610130805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586114e73390565b6060606780546105c290612e85565b6060606880546105c290612e85565b600054610100900460ff161580801561186a5750600054600160ff909116105b806118845750303b158015611884575060005460ff166001145b6118a05760405162461bcd60e51b81526004016106a390612f5d565b6000805460ff1916600117905580156118c3576000805461ff0019166101001790555b6118cb612056565b6118d5838361207d565b6118de836120ae565b6118e66120f8565b6118ee612127565b6118f7846117d5565b8015611452576000805461ff00191690556040517f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989061193990600190613391565b60405180910390a150505050565b6001600160a01b03821661196d5760405162461bcd60e51b81526004016106a3906133d3565b806035600082825461197f9190612efc565b90915550506001600160a01b038216600081815260336020526040808220805485019055517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9061114e908590612796565b6001600160a01b03811660009081526099602052604090208054600181018255905b50919050565b6000610659611a066114a7565b8360405161190160f01b8152600281019290925260228201526042902090565b6000806000611a3787878787612156565b91509150611a448161220d565b5090505b949350505050565b611a5c8a8689896122bc565b611a9b8a828c8c8c8c8c8c604051602001611a7d97969594939291906133e3565b6040516020818303038152906040528051906020012086868661233c565b611aa58a866116d2565b611ab08a8a8a61135b565b60405185906001600160a01b038c16907f98de503528ee59b575ef0c0a2576a82497bfc029a5685b209e9ec333479b10a590600090a350505050505050505050565b600080611afd611f55565b6001600160a01b038516600090815260209182526040808220868352909252205460ff1691505092915050565b6001600160a01b038316611b505760405162461bcd60e51b81526004016106a39061348c565b6001600160a01b038216611b765760405162461bcd60e51b81526004016106a3906134db565b6001600160a01b0380841660008181526034602090815260408083209487168084529490915290819020849055517f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906115b5908590612796565b611bd9611337565b6001600160a01b03831660009081526101626020526040902054839060ff1615611c155760405162461bcd60e51b81526004016106a390612ed6565b6001600160a01b03831660009081526101626020526040902054839060ff1615611c515760405162461bcd60e51b81526004016106a390612ed6565b336000818152610162602052604090205460ff1615611c825760405162461bcd60e51b81526004016106a390612ed6565b611c8d868686611d27565b505050505050565b6000611cea826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661239d9092919063ffffffff16565b9050805160001480611d0b575080806020019051810190611d0b91906134f6565b610e335760405162461bcd60e51b81526004016106a39061355e565b6001600160a01b038316611d4d5760405162461bcd60e51b81526004016106a3906135b0565b6001600160a01b038216611d735760405162461bcd60e51b81526004016106a390613600565b6001600160a01b03831660009081526033602052604090205481811015611dac5760405162461bcd60e51b81526004016106a390613653565b6001600160a01b0380851660008181526033602052604080822086860390559286168082529083902080548601905591517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90611e0a908690612796565b60405180910390a3611452565b60007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f611e426123ac565b611e4a612405565b4630604051602001611e60959493929190613663565b60405160208183030381529060405280519060200120905090565b6101305460ff166108de5760405162461bcd60e51b81526004016106a3906136d0565b604051600090611ed6907f158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a159742990859085906020016136e0565b60405160208183030381529060405280519060200120905092915050565b600080611f00866119f9565b9050600080611f1183888888612156565b90925090506000816004811115611f2a57611f2a613306565b148015611f485750886001600160a01b0316826001600160a01b0316145b9998505050505050505050565b60008060ff19611f8660017fb0ac339e0c6d2806b1f2ae5b24a6e21f3cf7aaaefdcc36d651ac38af5be9ce69613708565b604051602001611f969190612796565b60408051601f1981840301815291905280516020909101201692915050565b600054610100900460ff16611fdc5760405162461bcd60e51b81526004016106a390613364565b6067611fe883826137ac565b506068611ff582826137ac565b50506000606581905560665550565b60cc80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166108de5760405162461bcd60e51b81526004016106a390613364565b600054610100900460ff166120a45760405162461bcd60e51b81526004016106a390613364565b61173e8282612436565b600054610100900460ff166120d55760405162461bcd60e51b81526004016106a390613364565b610d0e81604051806040016040528060018152602001603160f81b815250611fb5565b600054610100900460ff1661211f5760405162461bcd60e51b81526004016106a390613364565b6108de612476565b600054610100900460ff1661214e5760405162461bcd60e51b81526004016106a390613364565b6108de6124a6565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561218d5750600090506003612204565b6000600187878787604051600081526020016040526040516121b2949392919061386f565b6020604051602081039080840390855afa1580156121d4573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166121fd57600060019250925050612204565b9150600090505b94509492505050565b600081600481111561222157612221613306565b036122295750565b600181600481111561223d5761223d613306565b0361225a5760405162461bcd60e51b81526004016106a3906138d8565b600281600481111561226e5761226e613306565b0361228b5760405162461bcd60e51b81526004016106a39061391c565b600381600481111561229f5761229f613306565b03610d0e5760405162461bcd60e51b81526004016106a39061396b565b814211604051806060016040528060278152602001613a4160279139906122f65760405162461bcd60e51b81526004016106a39190612699565b50804210604051806060016040528060218152602001613a8960219139906123315760405162461bcd60e51b81526004016106a39190612699565b5061145284846124da565b6123498585858585611ef4565b6040518060400160405280601a81526020017f454950333030393a20696e76616c6964207369676e617475726500000000000081525090611c8d5760405162461bcd60e51b81526004016106a39190612699565b6060611a488484600085612539565b6000806123b761182c565b8051909150156123ce578051602090910120919050565b60655480156123dd5792915050565b7fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4709250505090565b60008061241061183b565b805190915015612427578051602090910120919050565b60665480156123dd5792915050565b600054610100900460ff1661245d5760405162461bcd60e51b81526004016106a390613364565b603661246983826137ac565b506037610e3382826137ac565b600054610100900460ff1661249d5760405162461bcd60e51b81526004016106a390613364565b6108de336117d5565b600054610100900460ff166124cd5760405162461bcd60e51b81526004016106a390613364565b610130805460ff19169055565b6124e48282611af2565b156040518060400160405280601e81526020017f454950333030393a20617574686f72697a6174696f6e2069732075736564000081525090610e335760405162461bcd60e51b81526004016106a39190612699565b60608247101561255b5760405162461bcd60e51b81526004016106a3906139be565b600080866001600160a01b0316858760405161257791906139f0565b60006040518083038185875af1925050503d80600081146125b4576040519150601f19603f3d011682016040523d82523d6000602084013e6125b9565b606091505b50915091506125ca878383876125d5565b979650505050505050565b6060831561261457825160000361260d576001600160a01b0385163b61260d5760405162461bcd60e51b81526004016106a390613a30565b5081611a48565b611a4883838151156126295781518083602001fd5b8060405162461bcd60e51b81526004016106a39190612699565b60005b8381101561265e578181015183820152602001612646565b50506000910152565b6000612671825190565b808452602084019350612688818560208601612643565b601f01601f19169290920192915050565b602080825281016107b88184612667565b60006001600160a01b038216610659565b6126c4816126aa565b8114610d0e57600080fd5b8035610659816126bb565b806126c4565b8035610659816126da565b6000806040838503121561270157612701600080fd5b600061270d85856126cf565b925050602061271e858286016126e0565b9150509250929050565b8015155b82525050565b602081016106598284612728565b60008060006060848603121561275857612758600080fd5b600061276486866126cf565b9350506020612775868287016126cf565b9250506040612786868287016126e0565b9150509250925092565b8061272c565b602081016106598284612790565b60ff811661272c565b6020810161065982846127a4565b6000602082840312156127d0576127d0600080fd5b6000611a4884846126e0565b6000602082840312156127f1576127f1600080fd5b6000611a4884846126cf565b60ff81166126c4565b8035610659816127fd565b600080600080600060a0868803121561282c5761282c600080fd5b600061283888886126cf565b9550506020612849888289016126e0565b945050604061285a88828901612806565b935050606061286b888289016126e0565b925050608061287c888289016126e0565b9150509295509295909350565b60008083601f84011261289e5761289e600080fd5b50813567ffffffffffffffff8111156128b9576128b9600080fd5b6020830191508360208202830111156128d4576128d4600080fd5b9250929050565b8015156126c4565b8035610659816128db565b600080600080600080600080600080600060c08c8e03121561291257612912600080fd5b8b3567ffffffffffffffff81111561292c5761292c600080fd5b6129388e828f01612889565b9b509b505060208c013567ffffffffffffffff81111561295a5761295a600080fd5b6129668e828f01612889565b995099505060408c013567ffffffffffffffff81111561298857612988600080fd5b6129948e828f01612889565b975097505060608c013567ffffffffffffffff8111156129b6576129b6600080fd5b6129c28e828f01612889565b955095505060808c013567ffffffffffffffff8111156129e4576129e4600080fd5b6129f08e828f01612889565b935093505060a0612a038e828f016128e3565b9150509295989b509295989b9093969950565b6000612a228383612728565b505060200190565b6000612a34825190565b80845260209384019383018060005b83811015612a68578151612a578882612a16565b975060208301925050600101612a43565b509495945050505050565b602080825281016107b88184612a2a565b6001600160f81b0319811661272c565b61272c816126aa565b6000612a228383612790565b6000612ab3825190565b80845260209384019383018060005b83811015612a68578151612ad68882612a9d565b975060208301925050600101612ac2565b60e08101612af5828a612a84565b8181036020830152612b078189612667565b90508181036040830152612b1b8188612667565b9050612b2a6060830187612790565b612b376080830186612a94565b612b4460a0830185612790565b81810360c0830152611f488184612aa9565b602081016106598284612a94565b634e487b7160e01b600052604160045260246000fd5b601f19601f830116810181811067ffffffffffffffff82111715612ba057612ba0612b64565b6040525050565b6000612bb260405190565b90506109348282612b7a565b600067ffffffffffffffff821115612bd857612bd8612b64565b601f19601f83011660200192915050565b82818337506000910152565b6000612c08612c0384612bbe565b612ba7565b905082815260208101848484011115612c2357612c23600080fd5b612c2e848285612be9565b509392505050565b600082601f830112612c4a57612c4a600080fd5b8135611a48848260208601612bf5565b600080600060608486031215612c7257612c72600080fd5b6000612c7e86866126cf565b935050602084013567ffffffffffffffff811115612c9e57612c9e600080fd5b612caa86828701612c36565b925050604084013567ffffffffffffffff811115612cca57612cca600080fd5b61278686828701612c36565b600080600080600080600060e0888a031215612cf457612cf4600080fd5b6000612d008a8a6126cf565b9750506020612d118a828b016126cf565b9650506040612d228a828b016126e0565b9550506060612d338a828b016126e0565b9450506080612d448a828b01612806565b93505060a0612d558a828b016126e0565b92505060c0612d668a828b016126e0565b91505092959891949750929550565b60008060408385031215612d8b57612d8b600080fd5b6000612d9785856126cf565b925050602061271e858286016126cf565b60008060008060008060008060006101208a8c031215612dca57612dca600080fd5b6000612dd68c8c6126cf565b9950506020612de78c828d016126cf565b9850506040612df88c828d016126e0565b9750506060612e098c828d016126e0565b9650506080612e1a8c828d016126e0565b95505060a0612e2b8c828d016126e0565b94505060c0612e3c8c828d01612806565b93505060e0612e4d8c828d016126e0565b925050610100612e5f8c828d016126e0565b9150509295985092959850929598565b634e487b7160e01b600052602260045260246000fd5b600281046001821680612e9957607f821691505b6020821081036119f3576119f3612e6f565b601181526000602082017020b1b1b7bab73a1034b990333937bd32b760791b815291505b5060200190565b6020808252810161065981612eab565b634e487b7160e01b600052601160045260246000fd5b8082018082111561065957610659612ee6565b602e81526000602082017f496e697469616c697a61626c653a20636f6e747261637420697320616c72656181526d191e481a5b9a5d1a585b1a5e995960921b602082015291505b5060400190565b6020808252810161065981612f0f565b600b81526000602082016a155b9cdd5c1c1bdc9d195960aa1b81529150612ecf565b6020808252810161065981612f6d565b634e487b7160e01b600052603260045260246000fd5b600060208284031215612fca57612fca600080fd5b6000611a488484612806565b602981526000602082017f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865208152683732bb9037bbb732b960b91b60208201529150612f56565b6020808252810161065981612fd6565b60158152600060208201741152540dcc4c8e88155b9a5b9a5d1a585b1a5e9959605a1b81529150612ecf565b602080825281016106598161302c565b602581526000602082017f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77815264207a65726f60d81b60208201529150612f56565b6020808252810161065981613068565b601d81526000602082017f45524332305065726d69743a206578706972656420646561646c696e6500000081529150612ecf565b60208082528101610659816130ba565b60c0810161310c8289612790565b6131196020830188612a94565b6131266040830187612a94565b6131336060830186612790565b6131406080830185612790565b6125ca60a0830184612790565b601e81526000602082017f45524332305065726d69743a20696e76616c6964207369676e6174757265000081529150612ecf565b602080825281016106598161314d565b60208082527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657291019081526000612ecf565b6020808252810161065981613191565b601081526000602082016f14185d5cd8589b194e881c185d5cd95960821b81529150612ecf565b60208082528101610659816131d3565b604081016132188285612a94565b6107b86020830184612790565b601d81526000602082017f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000081529150612ecf565b6020808252810161065981613225565b602181526000602082017f45524332303a206275726e2066726f6d20746865207a65726f206164647265738152607360f81b60208201529150612f56565b6020808252810161065981613269565b602281526000602082017f45524332303a206275726e20616d6f756e7420657863656564732062616c616e815261636560f01b60208201529150612f56565b60208082528101610659816132b7565b634e487b7160e01b600052602160045260246000fd5b602b81526000602082017f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206981526a6e697469616c697a696e6760a81b60208201529150612f56565b602080825281016106598161331c565b600061065982613382565b90565b60ff1690565b61272c81613374565b602081016106598284613388565b601f81526000602082017f45524332303a206d696e7420746f20746865207a65726f20616464726573730081529150612ecf565b602080825281016106598161339f565b60e081016133f1828a612790565b6133fe6020830189612a94565b61340b6040830188612a94565b6134186060830187612790565b6134256080830186612790565b61343260a0830185612790565b61343f60c0830184612790565b98975050505050505050565b602481526000602082017f45524332303a20617070726f76652066726f6d20746865207a65726f206164648152637265737360e01b60208201529150612f56565b602080825281016106598161344b565b602281526000602082017f45524332303a20617070726f766520746f20746865207a65726f206164647265815261737360f01b60208201529150612f56565b602080825281016106598161349c565b8051610659816128db565b60006020828403121561350b5761350b600080fd5b6000611a4884846134eb565b602a81526000602082017f5361666545524332303a204552433230206f7065726174696f6e20646964206e8152691bdd081cdd58d8d9595960b21b60208201529150612f56565b6020808252810161065981613517565b602581526000602082017f45524332303a207472616e736665722066726f6d20746865207a65726f206164815264647265737360d81b60208201529150612f56565b602080825281016106598161356e565b602381526000602082017f45524332303a207472616e7366657220746f20746865207a65726f206164647281526265737360e81b60208201529150612f56565b60208082528101610659816135c0565b602681526000602082017f45524332303a207472616e7366657220616d6f756e7420657863656564732062815265616c616e636560d01b60208201529150612f56565b6020808252810161065981613610565b60a081016136718288612790565b61367e6020830187612790565b61368b6040830186612790565b6136986060830185612790565b6117cb6080830184612a94565b601481526000602082017314185d5cd8589b194e881b9bdd081c185d5cd95960621b81529150612ecf565b60208082528101610659816136a5565b606081016136ee8286612790565b6136fb6020830185612a94565b611a486040830184612790565b8181038181111561065957610659612ee6565b600061065961337f8381565b6137308361371b565b815460001960089490940293841b1916921b91909117905550565b6000610e33818484613727565b8181101561173e5761376b60008261374b565b600101613758565b601f821115610e33576000818152602090206020601f8501048101602085101561379a5750805b6113066020601f860104830182613758565b815167ffffffffffffffff8111156137c6576137c6612b64565b6137d08254612e85565b6137db828285613773565b6020601f83116001811461380f57600084156137f75750858201515b600019600886021c1981166002860217865550611c8d565b600085815260208120601f198616915b8281101561383f578885015182556020948501946001909201910161381f565b8683101561385b5784890151600019601f89166008021c191682555b600160028802018855505050505050505050565b6080810161387d8287612790565b61388a60208301866127a4565b6138976040830185612790565b6116016060830184612790565b601881526000602082017f45434453413a20696e76616c6964207369676e6174757265000000000000000081529150612ecf565b60208082528101610659816138a4565b601f81526000602082017f45434453413a20696e76616c6964207369676e6174757265206c656e6774680081529150612ecf565b60208082528101610659816138e8565b602281526000602082017f45434453413a20696e76616c6964207369676e6174757265202773272076616c815261756560f01b60208201529150612f56565b602080825281016106598161392c565b602681526000602082017f416464726573733a20696e73756666696369656e742062616c616e636520666f8152651c8818d85b1b60d21b60208201529150612f56565b602080825281016106598161397b565b60006139d8825190565b6139e6818560208601612643565b9290920192915050565b60006107b882846139ce565b601d81526000602082017f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000081529150612ecf565b60208082528101610659816139fc56fe454950333030393a20617574686f72697a6174696f6e206973206e6f74207965742076616c6964454950333030393a2063616c6c6572206d75737420626520746865207061796565454950333030393a20617574686f72697a6174696f6e2069732065787069726564a264697066735822122069272801a435453a1a74a38fffb27d7eb4a3a2ae7e0475a8b5df2c18d86e28e064736f6c63430008180033","optimization_enabled":true,"verified_twin_address_hash":null,"is_verified":true,"compiler_settings":{"evmVersion":"paris","libraries":{},"optimizer":{"details":{"yul":false},"enabled":true,"runs":200},"outputSelection":{"*":{"":["*"],"*":["*"]}}},"optimization_runs":200,"sourcify_repo_url":null,"decoded_constructor_args":null,"compiler_version":"v0.8.24+commit.e11b9ed9","is_verified_via_verifier_alliance":false,"verified_at":"2026-04-05T04:57:55.329548Z","implementations":[],"proxy_type":null,"external_libraries":[],"creation_bytecode":"0x60806040523480156200001157600080fd5b506200001c62000022565b62000111565b600054610100900460ff1615620000565760405162461bcd60e51b81526004016200004d90620000af565b60405180910390fd5b60005460ff90811614620000ad576000805460ff191660ff9081179091556040517f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249891620000a49162000101565b60405180910390a15b565b60208082528101620000fb81602781527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469602082015266616c697a696e6760c81b604082015260600190565b92915050565b60ff8216815260208101620000fb565b613adf80620001216000396000f3fe608060405234801561001057600080fd5b506004361061025e5760003560e01c80637f2eecc311610146578063a9059cbb116100c3578063e30c397811610087578063e30c397814610543578063e3ee160e14610554578063e94a010214610567578063ece531321461057a578063ef55bec61461058d578063f2fde38b146105a057600080fd5b8063a9059cbb146104bf578063d0516650146104d2578063d505accf146104f6578063d916948714610509578063dd62ed3e1461053057600080fd5b8063906571471161010a578063906571471461045757806395d89b411461046a578063a0712d6814610472578063a0cc6a6814610485578063a457c2d7146104ac57600080fd5b80637f2eecc3146103e05780638456cb591461040757806384b0196e1461040f5780638d1fdf2f1461042a5780638da5cb5b1461043d57600080fd5b806342966c68116101df5780635cd8a76b116101a35780635cd8a76b1461036c57806370a0823114610374578063715018a61461039d5780637893960c146103a557806379ba5097146103c55780637ecebe00146103cd57600080fd5b806342966c681461032057806345c8b1a61461033357806354fd4d50146103465780635a049a701461034d5780635c975abb1461036057600080fd5b8063308b8c0011610226578063308b8c00146102da578063313ce567146102ed5780633644e515146102fd57806339509351146103055780633f4ba83a1461031857600080fd5b806306fdde0314610263578063095ea7b3146102815780631171bda9146102a157806318160ddd146102b657806323b872dd146102c7575b600080fd5b61026b6105b3565b6040516102789190612699565b60405180910390f35b61029461028f3660046126eb565b610645565b6040516102789190612732565b6102b46102af366004612740565b61065f565b005b6035545b6040516102789190612796565b6102946102d5366004612740565b610799565b6102b46102e8366004612740565b6107bf565b60125b60405161027891906127ad565b6102ba61089d565b6102946103133660046126eb565b6108ac565b6102b46108ce565b61029461032e3660046127bb565b6108e0565b6102b46103413660046127dc565b610939565b60026102f0565b6102b461035b366004612811565b61098c565b6101305460ff16610294565b6102b4610a1a565b6102ba6103823660046127dc565b6001600160a01b031660009081526033602052604090205490565b6102b4610adc565b6103b86103b33660046128ee565b610afc565b6040516102789190612a73565b6102b4610cd9565b6102ba6103db3660046127dc565b610d11565b6102ba7fd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de881565b6102b4610d2f565b610417610d3f565b6040516102789796959493929190612ae7565b6102b46104383660046127dc565b610db5565b60cc546001600160a01b03165b6040516102789190612b56565b6102b4610465366004612c5a565b610e20565b61026b610e38565b6102946104803660046127bb565b610e47565b6102ba7f7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a226781565b6102946104ba3660046126eb565b610e8f565b6102946104cd3660046126eb565b610ed7565b6102946104e03660046127dc565b6101626020526000908152604090205460ff1681565b6102b4610504366004612cd6565b610ee5565b6102ba7f158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a159742981565b6102ba61053e366004612d75565b610fc7565b60fe546001600160a01b031661044a565b6102b4610562366004612da8565b610ff2565b6102946105753660046126eb565b611055565b6102b46105883660046127dc565b611061565b6102b461059b366004612da8565b61115a565b6102b46105ae3660046127dc565b61120a565b6060603680546105c290612e85565b80601f01602080910402602001604051908101604052809291908181526020018280546105ee90612e85565b801561063b5780601f106106105761010080835404028352916020019161063b565b820191906000526020600020905b81548152906001019060200180831161061e57829003601f168201915b5050505050905090565b60003361065381858561127b565b60019150505b92915050565b61066761130d565b6001600160a01b03821660009081526101626020526040902054829060ff16156106ac5760405162461bcd60e51b81526004016106a390612ed6565b60405180910390fd5b604080518082019091526011815270125b9d985b1a59081c9958da5c1a595b9d607a1b60208201526001600160a01b0384166106fb5760405162461bcd60e51b81526004016106a39190612699565b50610704611337565b306001600160a01b038516036107245761071f30848461135b565b610738565b6107386001600160a01b03851684846113b8565b826001600160a01b0316846001600160a01b03166107533390565b6001600160a01b03167f8816b49b19067a2d5520c96b81353ec05eea757a318795d5acdcbabe42b464078560405161078b9190612796565b60405180910390a450505050565b6000336107a785828561140e565b6107b285858561135b565b60019150505b9392505050565b6107c761130d565b6001600160a01b03831660009081526101626020908152604091829020548251808401909352601583527420b1b1b7bab73a1034b9903737ba10333937bd32b760591b9183019190915260ff166108315760405162461bcd60e51b81526004016106a39190612699565b5061083d838383611458565b816001600160a01b0316836001600160a01b03166108583390565b6001600160a01b03167f10aa54b8d21641b161adf6251c11512c46fcf822feaf6f66057c006dc29def4a846040516108909190612796565b60405180910390a4505050565b60006108a76114a7565b905090565b6000336106538185856108bf8383610fc7565b6108c99190612efc565b61127b565b6108d661130d565b6108de6114b1565b565b60006108ea61130d565b6108f433836114fe565b604051339081907fbac40739b0d4ca32fa2d82fc91630465ba3eddd1598da6fca393b26fb63b945390610928908690612796565b60405180910390a35060015b919050565b61094161130d565b6001600160a01b03811660008181526101626020526040808220805460ff191690555133917f4f3ab9ff0cc4f039268532098e01239544b0420171876e36889d01c62c784c7991a350565b336000818152610162602052604090205460ff16156109bd5760405162461bcd60e51b81526004016106a390612ed6565b6109d26109cd87878787876115c2565b61160a565b6109dc86866116d2565b60405185906001600160a01b038816907f1cdd46ff242716cdaa72d159d339a485b3438398348d68f09d7c8c0a59353d8190600090a3505050505050565b600054600290610100900460ff16158015610a3c575060005460ff8083169116105b610a585760405162461bcd60e51b81526004016106a390612f5d565b6000805461ffff191660ff831617610100179055610a96610a776105b3565b604051806040016040528060018152602001603160f81b81525061170d565b6000805461ff00191690556040517f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890610ad19083906127ad565b60405180910390a150565b610ae461130d565b60405162461bcd60e51b81526004016106a390612f8f565b33600081815261016260205260409020546060919060ff1615610b315760405162461bcd60e51b81526004016106a390612ed6565b8b8a81148015610b4057508089145b8015610b4b57508087145b8015610b5657508085145b6040518060400160405280601d81526020017f454950333030393a20696e76616c6964206261746368206c656e67746800000081525090610baa5760405162461bcd60e51b81526004016106a39190612699565b508067ffffffffffffffff811115610bc457610bc4612b64565b604051908082528060200260200182016040528015610bed578160200160208202803683370190505b50925060005b81811015610cc757610c9d8f8f83818110610c1057610c10612f9f565b9050602002016020810190610c2591906127dc565b8e8e84818110610c3757610c37612f9f565b905060200201358d8d85818110610c5057610c50612f9f565b9050602002016020810190610c659190612fb5565b8c8c86818110610c7757610c77612f9f565b905060200201358b8b87818110610c9057610c90612f9f565b905060200201358a611742565b848281518110610caf57610caf612f9f565b91151560209283029190910190910152600101610bf3565b5050509b9a5050505050505050505050565b60fe5433906001600160a01b03168114610d055760405162461bcd60e51b81526004016106a39061301c565b610d0e816117d5565b50565b6001600160a01b038116600090815260996020526040812054610659565b610d3761130d565b6108de6117ee565b6000606080600080600060606065546000801b148015610d5f5750606654155b610d7b5760405162461bcd60e51b81526004016106a390613058565b610d8361182c565b610d8b61183b565b60408051600080825260208201909252600f60f81b9b939a50919850469750309650945092509050565b610dbd61130d565b6001600160a01b038116600081815261016260205260409020805460ff19166001179055610de83390565b6001600160a01b03167f51d18786e9cb144f87d46e7b796309ea84c7c687d91e09c97f051eacf59bc52860405160405180910390a350565b610e2b83838361184a565b610e33610a1a565b505050565b6060603780546105c290612e85565b6000610e5161130d565b610e5b3383611947565b604051339081907fab8530f87dc9b59234c4623bf917212bb2536d647574c8e7e5da92c2ede0c9f890610928908690612796565b60003381610e9d8286610fc7565b905083811015610ebf5760405162461bcd60e51b81526004016106a3906130aa565b610ecc828686840361127b565b506001949350505050565b60003361065381858561135b565b83421115610f055760405162461bcd60e51b81526004016106a3906130ee565b60007f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9888888610f348c6119d1565b89604051602001610f4a969594939291906130fe565b6040516020818303038152906040528051906020012090506000610f6d826119f9565b90506000610f7d82878787611a26565b9050896001600160a01b0316816001600160a01b031614610fb05760405162461bcd60e51b81526004016106a390613181565b610fbb8a8a8a61127b565b50505050505050505050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b336000818152610162602052604090205460ff16156110235760405162461bcd60e51b81526004016106a390612ed6565b610fbb8a8a8a8a8a8a8a8a8a7f7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267611a50565b60006107b88383611af2565b61106961130d565b6001600160a01b03811660009081526101626020908152604091829020548251808401909352601583527420b1b1b7bab73a1034b9903737ba10333937bd32b760591b9183019190915260ff166110d35760405162461bcd60e51b81526004016106a39190612699565b506001600160a01b038116600090815260336020526040812054905061110b8261110560cc546001600160a01b031690565b83611458565b6001600160a01b038216336001600160a01b03167f76fa81ac53e82d7102caacc3866ae3ca5684caa4c24d995ff4d76ce8a10fbfef8360405161114e9190612796565b60405180910390a35050565b336000818152610162602052604090205460ff161561118b5760405162461bcd60e51b81526004016106a390612ed6565b336001600160a01b0316896001600160a01b031614604051806060016040528060218152602001613a6860219139906111d75760405162461bcd60e51b81526004016106a39190612699565b50610fbb8a8a8a8a8a8a8a8a8a7fd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8611a50565b61121261130d565b60fe80546001600160a01b0383166001600160a01b0319909116811790915561124360cc546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b611283611337565b6001600160a01b03831660009081526101626020526040902054839060ff16156112bf5760405162461bcd60e51b81526004016106a390612ed6565b6001600160a01b03831660009081526101626020526040902054839060ff16156112fb5760405162461bcd60e51b81526004016106a390612ed6565b611306858585611b2a565b5050505050565b60cc546001600160a01b031633146108de5760405162461bcd60e51b81526004016106a3906131c3565b6101305460ff16156108de5760405162461bcd60e51b81526004016106a3906131fa565b604080518082019091526011815270125b9d985b1a59081c9958da5c1a595b9d607a1b60208201526001600160a01b03831630036113ac5760405162461bcd60e51b81526004016106a39190612699565b50610e33838383611bd1565b610e338363a9059cbb60e01b84846040516024016113d792919061320a565b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152611c95565b600061141a8484610fc7565b9050600019811461145257818110156114455760405162461bcd60e51b81526004016106a390613259565b611452848484840361127b565b50505050565b611460611337565b6001600160a01b03821660009081526101626020526040902054829060ff161561149c5760405162461bcd60e51b81526004016106a390612ed6565b611452848484611d27565b60006108a7611e17565b6114b9611e7b565b610130805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516114f49190612b56565b60405180910390a1565b6001600160a01b0382166115245760405162461bcd60e51b81526004016106a3906132a7565b6001600160a01b0382166000908152603360205260409020548181101561155d5760405162461bcd60e51b81526004016106a3906132f6565b6001600160a01b0383166000818152603360205260408082208585039055603580548690039055519091907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906115b5908690612796565b60405180910390a3505050565b60006115ce8686611af2565b156115db57506001611601565b6115f1866115e98888611e9e565b868686611ef4565b6115fd57506002611601565b5060005b95945050505050565b600181600281111561161e5761161e613306565b0361166e57604080518082018252601e81527f454950333030393a20617574686f72697a6174696f6e206973207573656400006020820152905162461bcd60e51b81526106a39190600401612699565b600281600281111561168257611682613306565b03610d0e57604080518082018252601a81527f454950333030393a20696e76616c6964207369676e61747572650000000000006020820152905162461bcd60e51b81526106a39190600401612699565b60006116dc611f55565b6001600160a01b0390931660009081526020938452604080822093825292909352509020805460ff19166001179055565b600054610100900460ff166117345760405162461bcd60e51b81526004016106a390613364565b61173e8282611fb5565b5050565b60008061175288888888886115c2565b9050600081600281111561176857611768613306565b14611785578261177b5761177b8161160a565b60009150506117cb565b61178f88886116d2565b60405187906001600160a01b038a16907f1cdd46ff242716cdaa72d159d339a485b3438398348d68f09d7c8c0a59353d8190600090a360019150505b9695505050505050565b60fe80546001600160a01b0319169055610d0e81612004565b6117f6611337565b610130805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586114e73390565b6060606780546105c290612e85565b6060606880546105c290612e85565b600054610100900460ff161580801561186a5750600054600160ff909116105b806118845750303b158015611884575060005460ff166001145b6118a05760405162461bcd60e51b81526004016106a390612f5d565b6000805460ff1916600117905580156118c3576000805461ff0019166101001790555b6118cb612056565b6118d5838361207d565b6118de836120ae565b6118e66120f8565b6118ee612127565b6118f7846117d5565b8015611452576000805461ff00191690556040517f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989061193990600190613391565b60405180910390a150505050565b6001600160a01b03821661196d5760405162461bcd60e51b81526004016106a3906133d3565b806035600082825461197f9190612efc565b90915550506001600160a01b038216600081815260336020526040808220805485019055517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9061114e908590612796565b6001600160a01b03811660009081526099602052604090208054600181018255905b50919050565b6000610659611a066114a7565b8360405161190160f01b8152600281019290925260228201526042902090565b6000806000611a3787878787612156565b91509150611a448161220d565b5090505b949350505050565b611a5c8a8689896122bc565b611a9b8a828c8c8c8c8c8c604051602001611a7d97969594939291906133e3565b6040516020818303038152906040528051906020012086868661233c565b611aa58a866116d2565b611ab08a8a8a61135b565b60405185906001600160a01b038c16907f98de503528ee59b575ef0c0a2576a82497bfc029a5685b209e9ec333479b10a590600090a350505050505050505050565b600080611afd611f55565b6001600160a01b038516600090815260209182526040808220868352909252205460ff1691505092915050565b6001600160a01b038316611b505760405162461bcd60e51b81526004016106a39061348c565b6001600160a01b038216611b765760405162461bcd60e51b81526004016106a3906134db565b6001600160a01b0380841660008181526034602090815260408083209487168084529490915290819020849055517f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906115b5908590612796565b611bd9611337565b6001600160a01b03831660009081526101626020526040902054839060ff1615611c155760405162461bcd60e51b81526004016106a390612ed6565b6001600160a01b03831660009081526101626020526040902054839060ff1615611c515760405162461bcd60e51b81526004016106a390612ed6565b336000818152610162602052604090205460ff1615611c825760405162461bcd60e51b81526004016106a390612ed6565b611c8d868686611d27565b505050505050565b6000611cea826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661239d9092919063ffffffff16565b9050805160001480611d0b575080806020019051810190611d0b91906134f6565b610e335760405162461bcd60e51b81526004016106a39061355e565b6001600160a01b038316611d4d5760405162461bcd60e51b81526004016106a3906135b0565b6001600160a01b038216611d735760405162461bcd60e51b81526004016106a390613600565b6001600160a01b03831660009081526033602052604090205481811015611dac5760405162461bcd60e51b81526004016106a390613653565b6001600160a01b0380851660008181526033602052604080822086860390559286168082529083902080548601905591517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef90611e0a908690612796565b60405180910390a3611452565b60007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f611e426123ac565b611e4a612405565b4630604051602001611e60959493929190613663565b60405160208183030381529060405280519060200120905090565b6101305460ff166108de5760405162461bcd60e51b81526004016106a3906136d0565b604051600090611ed6907f158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a159742990859085906020016136e0565b60405160208183030381529060405280519060200120905092915050565b600080611f00866119f9565b9050600080611f1183888888612156565b90925090506000816004811115611f2a57611f2a613306565b148015611f485750886001600160a01b0316826001600160a01b0316145b9998505050505050505050565b60008060ff19611f8660017fb0ac339e0c6d2806b1f2ae5b24a6e21f3cf7aaaefdcc36d651ac38af5be9ce69613708565b604051602001611f969190612796565b60408051601f1981840301815291905280516020909101201692915050565b600054610100900460ff16611fdc5760405162461bcd60e51b81526004016106a390613364565b6067611fe883826137ac565b506068611ff582826137ac565b50506000606581905560665550565b60cc80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166108de5760405162461bcd60e51b81526004016106a390613364565b600054610100900460ff166120a45760405162461bcd60e51b81526004016106a390613364565b61173e8282612436565b600054610100900460ff166120d55760405162461bcd60e51b81526004016106a390613364565b610d0e81604051806040016040528060018152602001603160f81b815250611fb5565b600054610100900460ff1661211f5760405162461bcd60e51b81526004016106a390613364565b6108de612476565b600054610100900460ff1661214e5760405162461bcd60e51b81526004016106a390613364565b6108de6124a6565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561218d5750600090506003612204565b6000600187878787604051600081526020016040526040516121b2949392919061386f565b6020604051602081039080840390855afa1580156121d4573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166121fd57600060019250925050612204565b9150600090505b94509492505050565b600081600481111561222157612221613306565b036122295750565b600181600481111561223d5761223d613306565b0361225a5760405162461bcd60e51b81526004016106a3906138d8565b600281600481111561226e5761226e613306565b0361228b5760405162461bcd60e51b81526004016106a39061391c565b600381600481111561229f5761229f613306565b03610d0e5760405162461bcd60e51b81526004016106a39061396b565b814211604051806060016040528060278152602001613a4160279139906122f65760405162461bcd60e51b81526004016106a39190612699565b50804210604051806060016040528060218152602001613a8960219139906123315760405162461bcd60e51b81526004016106a39190612699565b5061145284846124da565b6123498585858585611ef4565b6040518060400160405280601a81526020017f454950333030393a20696e76616c6964207369676e617475726500000000000081525090611c8d5760405162461bcd60e51b81526004016106a39190612699565b6060611a488484600085612539565b6000806123b761182c565b8051909150156123ce578051602090910120919050565b60655480156123dd5792915050565b7fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4709250505090565b60008061241061183b565b805190915015612427578051602090910120919050565b60665480156123dd5792915050565b600054610100900460ff1661245d5760405162461bcd60e51b81526004016106a390613364565b603661246983826137ac565b506037610e3382826137ac565b600054610100900460ff1661249d5760405162461bcd60e51b81526004016106a390613364565b6108de336117d5565b600054610100900460ff166124cd5760405162461bcd60e51b81526004016106a390613364565b610130805460ff19169055565b6124e48282611af2565b156040518060400160405280601e81526020017f454950333030393a20617574686f72697a6174696f6e2069732075736564000081525090610e335760405162461bcd60e51b81526004016106a39190612699565b60608247101561255b5760405162461bcd60e51b81526004016106a3906139be565b600080866001600160a01b0316858760405161257791906139f0565b60006040518083038185875af1925050503d80600081146125b4576040519150601f19603f3d011682016040523d82523d6000602084013e6125b9565b606091505b50915091506125ca878383876125d5565b979650505050505050565b6060831561261457825160000361260d576001600160a01b0385163b61260d5760405162461bcd60e51b81526004016106a390613a30565b5081611a48565b611a4883838151156126295781518083602001fd5b8060405162461bcd60e51b81526004016106a39190612699565b60005b8381101561265e578181015183820152602001612646565b50506000910152565b6000612671825190565b808452602084019350612688818560208601612643565b601f01601f19169290920192915050565b602080825281016107b88184612667565b60006001600160a01b038216610659565b6126c4816126aa565b8114610d0e57600080fd5b8035610659816126bb565b806126c4565b8035610659816126da565b6000806040838503121561270157612701600080fd5b600061270d85856126cf565b925050602061271e858286016126e0565b9150509250929050565b8015155b82525050565b602081016106598284612728565b60008060006060848603121561275857612758600080fd5b600061276486866126cf565b9350506020612775868287016126cf565b9250506040612786868287016126e0565b9150509250925092565b8061272c565b602081016106598284612790565b60ff811661272c565b6020810161065982846127a4565b6000602082840312156127d0576127d0600080fd5b6000611a4884846126e0565b6000602082840312156127f1576127f1600080fd5b6000611a4884846126cf565b60ff81166126c4565b8035610659816127fd565b600080600080600060a0868803121561282c5761282c600080fd5b600061283888886126cf565b9550506020612849888289016126e0565b945050604061285a88828901612806565b935050606061286b888289016126e0565b925050608061287c888289016126e0565b9150509295509295909350565b60008083601f84011261289e5761289e600080fd5b50813567ffffffffffffffff8111156128b9576128b9600080fd5b6020830191508360208202830111156128d4576128d4600080fd5b9250929050565b8015156126c4565b8035610659816128db565b600080600080600080600080600080600060c08c8e03121561291257612912600080fd5b8b3567ffffffffffffffff81111561292c5761292c600080fd5b6129388e828f01612889565b9b509b505060208c013567ffffffffffffffff81111561295a5761295a600080fd5b6129668e828f01612889565b995099505060408c013567ffffffffffffffff81111561298857612988600080fd5b6129948e828f01612889565b975097505060608c013567ffffffffffffffff8111156129b6576129b6600080fd5b6129c28e828f01612889565b955095505060808c013567ffffffffffffffff8111156129e4576129e4600080fd5b6129f08e828f01612889565b935093505060a0612a038e828f016128e3565b9150509295989b509295989b9093969950565b6000612a228383612728565b505060200190565b6000612a34825190565b80845260209384019383018060005b83811015612a68578151612a578882612a16565b975060208301925050600101612a43565b509495945050505050565b602080825281016107b88184612a2a565b6001600160f81b0319811661272c565b61272c816126aa565b6000612a228383612790565b6000612ab3825190565b80845260209384019383018060005b83811015612a68578151612ad68882612a9d565b975060208301925050600101612ac2565b60e08101612af5828a612a84565b8181036020830152612b078189612667565b90508181036040830152612b1b8188612667565b9050612b2a6060830187612790565b612b376080830186612a94565b612b4460a0830185612790565b81810360c0830152611f488184612aa9565b602081016106598284612a94565b634e487b7160e01b600052604160045260246000fd5b601f19601f830116810181811067ffffffffffffffff82111715612ba057612ba0612b64565b6040525050565b6000612bb260405190565b90506109348282612b7a565b600067ffffffffffffffff821115612bd857612bd8612b64565b601f19601f83011660200192915050565b82818337506000910152565b6000612c08612c0384612bbe565b612ba7565b905082815260208101848484011115612c2357612c23600080fd5b612c2e848285612be9565b509392505050565b600082601f830112612c4a57612c4a600080fd5b8135611a48848260208601612bf5565b600080600060608486031215612c7257612c72600080fd5b6000612c7e86866126cf565b935050602084013567ffffffffffffffff811115612c9e57612c9e600080fd5b612caa86828701612c36565b925050604084013567ffffffffffffffff811115612cca57612cca600080fd5b61278686828701612c36565b600080600080600080600060e0888a031215612cf457612cf4600080fd5b6000612d008a8a6126cf565b9750506020612d118a828b016126cf565b9650506040612d228a828b016126e0565b9550506060612d338a828b016126e0565b9450506080612d448a828b01612806565b93505060a0612d558a828b016126e0565b92505060c0612d668a828b016126e0565b91505092959891949750929550565b60008060408385031215612d8b57612d8b600080fd5b6000612d9785856126cf565b925050602061271e858286016126cf565b60008060008060008060008060006101208a8c031215612dca57612dca600080fd5b6000612dd68c8c6126cf565b9950506020612de78c828d016126cf565b9850506040612df88c828d016126e0565b9750506060612e098c828d016126e0565b9650506080612e1a8c828d016126e0565b95505060a0612e2b8c828d016126e0565b94505060c0612e3c8c828d01612806565b93505060e0612e4d8c828d016126e0565b925050610100612e5f8c828d016126e0565b9150509295985092959850929598565b634e487b7160e01b600052602260045260246000fd5b600281046001821680612e9957607f821691505b6020821081036119f3576119f3612e6f565b601181526000602082017020b1b1b7bab73a1034b990333937bd32b760791b815291505b5060200190565b6020808252810161065981612eab565b634e487b7160e01b600052601160045260246000fd5b8082018082111561065957610659612ee6565b602e81526000602082017f496e697469616c697a61626c653a20636f6e747261637420697320616c72656181526d191e481a5b9a5d1a585b1a5e995960921b602082015291505b5060400190565b6020808252810161065981612f0f565b600b81526000602082016a155b9cdd5c1c1bdc9d195960aa1b81529150612ecf565b6020808252810161065981612f6d565b634e487b7160e01b600052603260045260246000fd5b600060208284031215612fca57612fca600080fd5b6000611a488484612806565b602981526000602082017f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865208152683732bb9037bbb732b960b91b60208201529150612f56565b6020808252810161065981612fd6565b60158152600060208201741152540dcc4c8e88155b9a5b9a5d1a585b1a5e9959605a1b81529150612ecf565b602080825281016106598161302c565b602581526000602082017f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77815264207a65726f60d81b60208201529150612f56565b6020808252810161065981613068565b601d81526000602082017f45524332305065726d69743a206578706972656420646561646c696e6500000081529150612ecf565b60208082528101610659816130ba565b60c0810161310c8289612790565b6131196020830188612a94565b6131266040830187612a94565b6131336060830186612790565b6131406080830185612790565b6125ca60a0830184612790565b601e81526000602082017f45524332305065726d69743a20696e76616c6964207369676e6174757265000081529150612ecf565b602080825281016106598161314d565b60208082527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657291019081526000612ecf565b6020808252810161065981613191565b601081526000602082016f14185d5cd8589b194e881c185d5cd95960821b81529150612ecf565b60208082528101610659816131d3565b604081016132188285612a94565b6107b86020830184612790565b601d81526000602082017f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000081529150612ecf565b6020808252810161065981613225565b602181526000602082017f45524332303a206275726e2066726f6d20746865207a65726f206164647265738152607360f81b60208201529150612f56565b6020808252810161065981613269565b602281526000602082017f45524332303a206275726e20616d6f756e7420657863656564732062616c616e815261636560f01b60208201529150612f56565b60208082528101610659816132b7565b634e487b7160e01b600052602160045260246000fd5b602b81526000602082017f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206981526a6e697469616c697a696e6760a81b60208201529150612f56565b602080825281016106598161331c565b600061065982613382565b90565b60ff1690565b61272c81613374565b602081016106598284613388565b601f81526000602082017f45524332303a206d696e7420746f20746865207a65726f20616464726573730081529150612ecf565b602080825281016106598161339f565b60e081016133f1828a612790565b6133fe6020830189612a94565b61340b6040830188612a94565b6134186060830187612790565b6134256080830186612790565b61343260a0830185612790565b61343f60c0830184612790565b98975050505050505050565b602481526000602082017f45524332303a20617070726f76652066726f6d20746865207a65726f206164648152637265737360e01b60208201529150612f56565b602080825281016106598161344b565b602281526000602082017f45524332303a20617070726f766520746f20746865207a65726f206164647265815261737360f01b60208201529150612f56565b602080825281016106598161349c565b8051610659816128db565b60006020828403121561350b5761350b600080fd5b6000611a4884846134eb565b602a81526000602082017f5361666545524332303a204552433230206f7065726174696f6e20646964206e8152691bdd081cdd58d8d9595960b21b60208201529150612f56565b6020808252810161065981613517565b602581526000602082017f45524332303a207472616e736665722066726f6d20746865207a65726f206164815264647265737360d81b60208201529150612f56565b602080825281016106598161356e565b602381526000602082017f45524332303a207472616e7366657220746f20746865207a65726f206164647281526265737360e81b60208201529150612f56565b60208082528101610659816135c0565b602681526000602082017f45524332303a207472616e7366657220616d6f756e7420657863656564732062815265616c616e636560d01b60208201529150612f56565b6020808252810161065981613610565b60a081016136718288612790565b61367e6020830187612790565b61368b6040830186612790565b6136986060830185612790565b6117cb6080830184612a94565b601481526000602082017314185d5cd8589b194e881b9bdd081c185d5cd95960621b81529150612ecf565b60208082528101610659816136a5565b606081016136ee8286612790565b6136fb6020830185612a94565b611a486040830184612790565b8181038181111561065957610659612ee6565b600061065961337f8381565b6137308361371b565b815460001960089490940293841b1916921b91909117905550565b6000610e33818484613727565b8181101561173e5761376b60008261374b565b600101613758565b601f821115610e33576000818152602090206020601f8501048101602085101561379a5750805b6113066020601f860104830182613758565b815167ffffffffffffffff8111156137c6576137c6612b64565b6137d08254612e85565b6137db828285613773565b6020601f83116001811461380f57600084156137f75750858201515b600019600886021c1981166002860217865550611c8d565b600085815260208120601f198616915b8281101561383f578885015182556020948501946001909201910161381f565b8683101561385b5784890151600019601f89166008021c191682555b600160028802018855505050505050505050565b6080810161387d8287612790565b61388a60208301866127a4565b6138976040830185612790565b6116016060830184612790565b601881526000602082017f45434453413a20696e76616c6964207369676e6174757265000000000000000081529150612ecf565b60208082528101610659816138a4565b601f81526000602082017f45434453413a20696e76616c6964207369676e6174757265206c656e6774680081529150612ecf565b60208082528101610659816138e8565b602281526000602082017f45434453413a20696e76616c6964207369676e6174757265202773272076616c815261756560f01b60208201529150612f56565b602080825281016106598161392c565b602681526000602082017f416464726573733a20696e73756666696369656e742062616c616e636520666f8152651c8818d85b1b60d21b60208201529150612f56565b602080825281016106598161397b565b60006139d8825190565b6139e6818560208601612643565b9290920192915050565b60006107b882846139ce565b601d81526000602082017f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000081529150612ecf565b60208082528101610659816139fc56fe454950333030393a20617574686f72697a6174696f6e206973206e6f74207965742076616c6964454950333030393a2063616c6c6572206d75737420626520746865207061796565454950333030393a20617574686f72697a6174696f6e2069732065787069726564a264697066735822122069272801a435453a1a74a38fffb27d7eb4a3a2ae7e0475a8b5df2c18d86e28e064736f6c63430008180033","name":"StablecoinV2","is_blueprint":false,"license_type":"none","is_fully_verified":true,"is_verified_via_eth_bytecode_db":true,"language":"solidity","evm_version":"paris","can_be_visualized_via_sol2uml":true,"is_verified_via_sourcify":false,"additional_sources":[{"file_path":"@openzeppelin/contracts-upgradeable/interfaces/IERC5267Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC5267.sol)\n\npragma solidity ^0.8.0;\n\ninterface IERC5267Upgradeable {\n    /**\n     * @dev MAY be emitted to signal that the domain could have changed.\n     */\n    event EIP712DomainChanged();\n\n    /**\n     * @dev returns the fields and values that describe the domain separator used by this contract for EIP-712\n     * signature.\n     */\n    function eip712Domain()\n        external\n        view\n        returns (\n            bytes1 fields,\n            string memory name,\n            string memory version,\n            uint256 chainId,\n            address verifyingContract,\n            bytes32 salt,\n            uint256[] memory extensions\n        );\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n *     function initialize() initializer public {\n *         __ERC20_init(\"MyToken\", \"MTK\");\n *     }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n *     function initializeV2() reinitializer(2) public {\n *         __ERC20Permit_init(\"MyToken\");\n *     }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n *     _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n    /**\n     * @dev Indicates that the contract has been initialized.\n     * @custom:oz-retyped-from bool\n     */\n    uint8 private _initialized;\n\n    /**\n     * @dev Indicates that the contract is in the process of being initialized.\n     */\n    bool private _initializing;\n\n    /**\n     * @dev Triggered when the contract has been initialized or reinitialized.\n     */\n    event Initialized(uint8 version);\n\n    /**\n     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n     * `onlyInitializing` functions can be used to initialize parent contracts.\n     *\n     * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n     * constructor.\n     *\n     * Emits an {Initialized} event.\n     */\n    modifier initializer() {\n        bool isTopLevelCall = !_initializing;\n        require(\n            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n            \"Initializable: contract is already initialized\"\n        );\n        _initialized = 1;\n        if (isTopLevelCall) {\n            _initializing = true;\n        }\n        _;\n        if (isTopLevelCall) {\n            _initializing = false;\n            emit Initialized(1);\n        }\n    }\n\n    /**\n     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n     * used to initialize parent contracts.\n     *\n     * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n     * are added through upgrades and that require initialization.\n     *\n     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n     * cannot be nested. If one is invoked in the context of another, execution will revert.\n     *\n     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n     * a contract, executing them in the right order is up to the developer or operator.\n     *\n     * WARNING: setting the version to 255 will prevent any future reinitialization.\n     *\n     * Emits an {Initialized} event.\n     */\n    modifier reinitializer(uint8 version) {\n        require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n        _initialized = version;\n        _initializing = true;\n        _;\n        _initializing = false;\n        emit Initialized(version);\n    }\n\n    /**\n     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n     * {initializer} and {reinitializer} modifiers, directly or indirectly.\n     */\n    modifier onlyInitializing() {\n        require(_initializing, \"Initializable: contract is not initializing\");\n        _;\n    }\n\n    /**\n     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n     * through proxies.\n     *\n     * Emits an {Initialized} event the first time it is successfully executed.\n     */\n    function _disableInitializers() internal virtual {\n        require(!_initializing, \"Initializable: contract is initializing\");\n        if (_initialized != type(uint8).max) {\n            _initialized = type(uint8).max;\n            emit Initialized(type(uint8).max);\n        }\n    }\n\n    /**\n     * @dev Returns the highest version that has been initialized. See {reinitializer}.\n     */\n    function _getInitializedVersion() internal view returns (uint8) {\n        return _initialized;\n    }\n\n    /**\n     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n     */\n    function _isInitializing() internal view returns (bool) {\n        return _initializing;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./OwnableUpgradeable.sol\";\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership} and {acceptOwnership}.\n *\n * This module is used through inheritance. It will make available all functions\n * from parent (Ownable).\n */\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\n    address private _pendingOwner;\n\n    event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\n\n    function __Ownable2Step_init() internal onlyInitializing {\n        __Ownable_init_unchained();\n    }\n\n    function __Ownable2Step_init_unchained() internal onlyInitializing {\n    }\n    /**\n     * @dev Returns the address of the pending owner.\n     */\n    function pendingOwner() public view virtual returns (address) {\n        return _pendingOwner;\n    }\n\n    /**\n     * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\n     * Can only be called by the current owner.\n     */\n    function transferOwnership(address newOwner) public virtual override onlyOwner {\n        _pendingOwner = newOwner;\n        emit OwnershipTransferStarted(owner(), newOwner);\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\n     * Internal function without access restriction.\n     */\n    function _transferOwnership(address newOwner) internal virtual override {\n        delete _pendingOwner;\n        super._transferOwnership(newOwner);\n    }\n\n    /**\n     * @dev The new owner accepts the ownership transfer.\n     */\n    function acceptOwnership() public virtual {\n        address sender = _msgSender();\n        require(pendingOwner() == sender, \"Ownable2Step: caller is not the new owner\");\n        _transferOwnership(sender);\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[49] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n    address private _owner;\n\n    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n    /**\n     * @dev Initializes the contract setting the deployer as the initial owner.\n     */\n    function __Ownable_init() internal onlyInitializing {\n        __Ownable_init_unchained();\n    }\n\n    function __Ownable_init_unchained() internal onlyInitializing {\n        _transferOwnership(_msgSender());\n    }\n\n    /**\n     * @dev Throws if called by any account other than the owner.\n     */\n    modifier onlyOwner() {\n        _checkOwner();\n        _;\n    }\n\n    /**\n     * @dev Returns the address of the current owner.\n     */\n    function owner() public view virtual returns (address) {\n        return _owner;\n    }\n\n    /**\n     * @dev Throws if the sender is not the owner.\n     */\n    function _checkOwner() internal view virtual {\n        require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n    }\n\n    /**\n     * @dev Leaves the contract without owner. It will not be possible to call\n     * `onlyOwner` functions. Can only be called by the current owner.\n     *\n     * NOTE: Renouncing ownership will leave the contract without an owner,\n     * thereby disabling any functionality that is only available to the owner.\n     */\n    function renounceOwnership() public virtual onlyOwner {\n        _transferOwnership(address(0));\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Can only be called by the current owner.\n     */\n    function transferOwnership(address newOwner) public virtual onlyOwner {\n        require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n        _transferOwnership(newOwner);\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Internal function without access restriction.\n     */\n    function _transferOwnership(address newOwner) internal virtual {\n        address oldOwner = _owner;\n        _owner = newOwner;\n        emit OwnershipTransferred(oldOwner, newOwner);\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[49] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which allows children to implement an emergency stop\n * mechanism that can be triggered by an authorized account.\n *\n * This module is used through inheritance. It will make available the\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\n * the functions of your contract. Note that they will not be pausable by\n * simply including this module, only once the modifiers are put in place.\n */\nabstract contract PausableUpgradeable is Initializable, ContextUpgradeable {\n    /**\n     * @dev Emitted when the pause is triggered by `account`.\n     */\n    event Paused(address account);\n\n    /**\n     * @dev Emitted when the pause is lifted by `account`.\n     */\n    event Unpaused(address account);\n\n    bool private _paused;\n\n    /**\n     * @dev Initializes the contract in unpaused state.\n     */\n    function __Pausable_init() internal onlyInitializing {\n        __Pausable_init_unchained();\n    }\n\n    function __Pausable_init_unchained() internal onlyInitializing {\n        _paused = false;\n    }\n\n    /**\n     * @dev Modifier to make a function callable only when the contract is not paused.\n     *\n     * Requirements:\n     *\n     * - The contract must not be paused.\n     */\n    modifier whenNotPaused() {\n        _requireNotPaused();\n        _;\n    }\n\n    /**\n     * @dev Modifier to make a function callable only when the contract is paused.\n     *\n     * Requirements:\n     *\n     * - The contract must be paused.\n     */\n    modifier whenPaused() {\n        _requirePaused();\n        _;\n    }\n\n    /**\n     * @dev Returns true if the contract is paused, and false otherwise.\n     */\n    function paused() public view virtual returns (bool) {\n        return _paused;\n    }\n\n    /**\n     * @dev Throws if the contract is paused.\n     */\n    function _requireNotPaused() internal view virtual {\n        require(!paused(), \"Pausable: paused\");\n    }\n\n    /**\n     * @dev Throws if the contract is not paused.\n     */\n    function _requirePaused() internal view virtual {\n        require(paused(), \"Pausable: not paused\");\n    }\n\n    /**\n     * @dev Triggers stopped state.\n     *\n     * Requirements:\n     *\n     * - The contract must not be paused.\n     */\n    function _pause() internal virtual whenNotPaused {\n        _paused = true;\n        emit Paused(_msgSender());\n    }\n\n    /**\n     * @dev Returns to normal state.\n     *\n     * Requirements:\n     *\n     * - The contract must be paused.\n     */\n    function _unpause() internal virtual whenPaused {\n        _paused = false;\n        emit Unpaused(_msgSender());\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[49] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC20Upgradeable.sol\";\nimport \"./extensions/IERC20MetadataUpgradeable.sol\";\nimport \"../../utils/ContextUpgradeable.sol\";\nimport {Initializable} from \"../../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Implementation of the {IERC20} interface.\n *\n * This implementation is agnostic to the way tokens are created. This means\n * that a supply mechanism has to be added in a derived contract using {_mint}.\n * For a generic mechanism see {ERC20PresetMinterPauser}.\n *\n * TIP: For a detailed writeup see our guide\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\n * to implement supply mechanisms].\n *\n * The default value of {decimals} is 18. To change this, you should override\n * this function so it returns a different value.\n *\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\n * instead returning `false` on failure. This behavior is nonetheless\n * conventional and does not conflict with the expectations of ERC20\n * applications.\n *\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\n * This allows applications to reconstruct the allowance for all accounts just\n * by listening to said events. Other implementations of the EIP may not emit\n * these events, as it isn't required by the specification.\n *\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\n * functions have been added to mitigate the well-known issues around setting\n * allowances. See {IERC20-approve}.\n */\ncontract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20Upgradeable, IERC20MetadataUpgradeable {\n    mapping(address => uint256) private _balances;\n\n    mapping(address => mapping(address => uint256)) private _allowances;\n\n    uint256 private _totalSupply;\n\n    string private _name;\n    string private _symbol;\n\n    /**\n     * @dev Sets the values for {name} and {symbol}.\n     *\n     * All two of these values are immutable: they can only be set once during\n     * construction.\n     */\n    function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing {\n        __ERC20_init_unchained(name_, symbol_);\n    }\n\n    function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {\n        _name = name_;\n        _symbol = symbol_;\n    }\n\n    /**\n     * @dev Returns the name of the token.\n     */\n    function name() public view virtual override returns (string memory) {\n        return _name;\n    }\n\n    /**\n     * @dev Returns the symbol of the token, usually a shorter version of the\n     * name.\n     */\n    function symbol() public view virtual override returns (string memory) {\n        return _symbol;\n    }\n\n    /**\n     * @dev Returns the number of decimals used to get its user representation.\n     * For example, if `decimals` equals `2`, a balance of `505` tokens should\n     * be displayed to a user as `5.05` (`505 / 10 ** 2`).\n     *\n     * Tokens usually opt for a value of 18, imitating the relationship between\n     * Ether and Wei. This is the default value returned by this function, unless\n     * it's overridden.\n     *\n     * NOTE: This information is only used for _display_ purposes: it in\n     * no way affects any of the arithmetic of the contract, including\n     * {IERC20-balanceOf} and {IERC20-transfer}.\n     */\n    function decimals() public view virtual override returns (uint8) {\n        return 18;\n    }\n\n    /**\n     * @dev See {IERC20-totalSupply}.\n     */\n    function totalSupply() public view virtual override returns (uint256) {\n        return _totalSupply;\n    }\n\n    /**\n     * @dev See {IERC20-balanceOf}.\n     */\n    function balanceOf(address account) public view virtual override returns (uint256) {\n        return _balances[account];\n    }\n\n    /**\n     * @dev See {IERC20-transfer}.\n     *\n     * Requirements:\n     *\n     * - `to` cannot be the zero address.\n     * - the caller must have a balance of at least `amount`.\n     */\n    function transfer(address to, uint256 amount) public virtual override returns (bool) {\n        address owner = _msgSender();\n        _transfer(owner, to, amount);\n        return true;\n    }\n\n    /**\n     * @dev See {IERC20-allowance}.\n     */\n    function allowance(address owner, address spender) public view virtual override returns (uint256) {\n        return _allowances[owner][spender];\n    }\n\n    /**\n     * @dev See {IERC20-approve}.\n     *\n     * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\n     * `transferFrom`. This is semantically equivalent to an infinite approval.\n     *\n     * Requirements:\n     *\n     * - `spender` cannot be the zero address.\n     */\n    function approve(address spender, uint256 amount) public virtual override returns (bool) {\n        address owner = _msgSender();\n        _approve(owner, spender, amount);\n        return true;\n    }\n\n    /**\n     * @dev See {IERC20-transferFrom}.\n     *\n     * Emits an {Approval} event indicating the updated allowance. This is not\n     * required by the EIP. See the note at the beginning of {ERC20}.\n     *\n     * NOTE: Does not update the allowance if the current allowance\n     * is the maximum `uint256`.\n     *\n     * Requirements:\n     *\n     * - `from` and `to` cannot be the zero address.\n     * - `from` must have a balance of at least `amount`.\n     * - the caller must have allowance for ``from``'s tokens of at least\n     * `amount`.\n     */\n    function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\n        address spender = _msgSender();\n        _spendAllowance(from, spender, amount);\n        _transfer(from, to, amount);\n        return true;\n    }\n\n    /**\n     * @dev Atomically increases the allowance granted to `spender` by the caller.\n     *\n     * This is an alternative to {approve} that can be used as a mitigation for\n     * problems described in {IERC20-approve}.\n     *\n     * Emits an {Approval} event indicating the updated allowance.\n     *\n     * Requirements:\n     *\n     * - `spender` cannot be the zero address.\n     */\n    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\n        address owner = _msgSender();\n        _approve(owner, spender, allowance(owner, spender) + addedValue);\n        return true;\n    }\n\n    /**\n     * @dev Atomically decreases the allowance granted to `spender` by the caller.\n     *\n     * This is an alternative to {approve} that can be used as a mitigation for\n     * problems described in {IERC20-approve}.\n     *\n     * Emits an {Approval} event indicating the updated allowance.\n     *\n     * Requirements:\n     *\n     * - `spender` cannot be the zero address.\n     * - `spender` must have allowance for the caller of at least\n     * `subtractedValue`.\n     */\n    function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\n        address owner = _msgSender();\n        uint256 currentAllowance = allowance(owner, spender);\n        require(currentAllowance >= subtractedValue, \"ERC20: decreased allowance below zero\");\n        unchecked {\n            _approve(owner, spender, currentAllowance - subtractedValue);\n        }\n\n        return true;\n    }\n\n    /**\n     * @dev Moves `amount` of tokens from `from` to `to`.\n     *\n     * This internal function is equivalent to {transfer}, and can be used to\n     * e.g. implement automatic token fees, slashing mechanisms, etc.\n     *\n     * Emits a {Transfer} event.\n     *\n     * Requirements:\n     *\n     * - `from` cannot be the zero address.\n     * - `to` cannot be the zero address.\n     * - `from` must have a balance of at least `amount`.\n     */\n    function _transfer(address from, address to, uint256 amount) internal virtual {\n        require(from != address(0), \"ERC20: transfer from the zero address\");\n        require(to != address(0), \"ERC20: transfer to the zero address\");\n\n        _beforeTokenTransfer(from, to, amount);\n\n        uint256 fromBalance = _balances[from];\n        require(fromBalance >= amount, \"ERC20: transfer amount exceeds balance\");\n        unchecked {\n            _balances[from] = fromBalance - amount;\n            // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\n            // decrementing then incrementing.\n            _balances[to] += amount;\n        }\n\n        emit Transfer(from, to, amount);\n\n        _afterTokenTransfer(from, to, amount);\n    }\n\n    /** @dev Creates `amount` tokens and assigns them to `account`, increasing\n     * the total supply.\n     *\n     * Emits a {Transfer} event with `from` set to the zero address.\n     *\n     * Requirements:\n     *\n     * - `account` cannot be the zero address.\n     */\n    function _mint(address account, uint256 amount) internal virtual {\n        require(account != address(0), \"ERC20: mint to the zero address\");\n\n        _beforeTokenTransfer(address(0), account, amount);\n\n        _totalSupply += amount;\n        unchecked {\n            // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\n            _balances[account] += amount;\n        }\n        emit Transfer(address(0), account, amount);\n\n        _afterTokenTransfer(address(0), account, amount);\n    }\n\n    /**\n     * @dev Destroys `amount` tokens from `account`, reducing the\n     * total supply.\n     *\n     * Emits a {Transfer} event with `to` set to the zero address.\n     *\n     * Requirements:\n     *\n     * - `account` cannot be the zero address.\n     * - `account` must have at least `amount` tokens.\n     */\n    function _burn(address account, uint256 amount) internal virtual {\n        require(account != address(0), \"ERC20: burn from the zero address\");\n\n        _beforeTokenTransfer(account, address(0), amount);\n\n        uint256 accountBalance = _balances[account];\n        require(accountBalance >= amount, \"ERC20: burn amount exceeds balance\");\n        unchecked {\n            _balances[account] = accountBalance - amount;\n            // Overflow not possible: amount <= accountBalance <= totalSupply.\n            _totalSupply -= amount;\n        }\n\n        emit Transfer(account, address(0), amount);\n\n        _afterTokenTransfer(account, address(0), amount);\n    }\n\n    /**\n     * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\n     *\n     * This internal function is equivalent to `approve`, and can be used to\n     * e.g. set automatic allowances for certain subsystems, etc.\n     *\n     * Emits an {Approval} event.\n     *\n     * Requirements:\n     *\n     * - `owner` cannot be the zero address.\n     * - `spender` cannot be the zero address.\n     */\n    function _approve(address owner, address spender, uint256 amount) internal virtual {\n        require(owner != address(0), \"ERC20: approve from the zero address\");\n        require(spender != address(0), \"ERC20: approve to the zero address\");\n\n        _allowances[owner][spender] = amount;\n        emit Approval(owner, spender, amount);\n    }\n\n    /**\n     * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\n     *\n     * Does not update the allowance amount in case of infinite allowance.\n     * Revert if not enough allowance is available.\n     *\n     * Might emit an {Approval} event.\n     */\n    function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\n        uint256 currentAllowance = allowance(owner, spender);\n        if (currentAllowance != type(uint256).max) {\n            require(currentAllowance >= amount, \"ERC20: insufficient allowance\");\n            unchecked {\n                _approve(owner, spender, currentAllowance - amount);\n            }\n        }\n    }\n\n    /**\n     * @dev Hook that is called before any transfer of tokens. This includes\n     * minting and burning.\n     *\n     * Calling conditions:\n     *\n     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n     * will be transferred to `to`.\n     * - when `from` is zero, `amount` tokens will be minted for `to`.\n     * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\n     * - `from` and `to` are never both zero.\n     *\n     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n     */\n    function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n\n    /**\n     * @dev Hook that is called after any transfer of tokens. This includes\n     * minting and burning.\n     *\n     * Calling conditions:\n     *\n     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n     * has been transferred to `to`.\n     * - when `from` is zero, `amount` tokens have been minted for `to`.\n     * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\n     * - `from` and `to` are never both zero.\n     *\n     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n     */\n    function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[45] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20Upgradeable {\n    /**\n     * @dev Emitted when `value` tokens are moved from one account (`from`) to\n     * another (`to`).\n     *\n     * Note that `value` may be zero.\n     */\n    event Transfer(address indexed from, address indexed to, uint256 value);\n\n    /**\n     * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n     * a call to {approve}. `value` is the new allowance.\n     */\n    event Approval(address indexed owner, address indexed spender, uint256 value);\n\n    /**\n     * @dev Returns the amount of tokens in existence.\n     */\n    function totalSupply() external view returns (uint256);\n\n    /**\n     * @dev Returns the amount of tokens owned by `account`.\n     */\n    function balanceOf(address account) external view returns (uint256);\n\n    /**\n     * @dev Moves `amount` tokens from the caller's account to `to`.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transfer(address to, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Returns the remaining number of tokens that `spender` will be\n     * allowed to spend on behalf of `owner` through {transferFrom}. This is\n     * zero by default.\n     *\n     * This value changes when {approve} or {transferFrom} are called.\n     */\n    function allowance(address owner, address spender) external view returns (uint256);\n\n    /**\n     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * IMPORTANT: Beware that changing an allowance with this method brings the risk\n     * that someone may use both the old and the new allowance by unfortunate\n     * transaction ordering. One possible solution to mitigate this race\n     * condition is to first reduce the spender's allowance to 0 and set the\n     * desired value afterwards:\n     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n     *\n     * Emits an {Approval} event.\n     */\n    function approve(address spender, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Moves `amount` tokens from `from` to `to` using the\n     * allowance mechanism. `amount` is then deducted from the caller's\n     * allowance.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC20PermitUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/ERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC20PermitUpgradeable.sol\";\nimport \"../ERC20Upgradeable.sol\";\nimport \"../../../utils/cryptography/ECDSAUpgradeable.sol\";\nimport \"../../../utils/cryptography/EIP712Upgradeable.sol\";\nimport \"../../../utils/CountersUpgradeable.sol\";\nimport {Initializable} from \"../../../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Implementation of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on `{IERC20-approve}`, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * _Available since v3.4._\n *\n * @custom:storage-size 51\n */\nabstract contract ERC20PermitUpgradeable is Initializable, ERC20Upgradeable, IERC20PermitUpgradeable, EIP712Upgradeable {\n    using CountersUpgradeable for CountersUpgradeable.Counter;\n\n    mapping(address => CountersUpgradeable.Counter) private _nonces;\n\n    // solhint-disable-next-line var-name-mixedcase\n    bytes32 private constant _PERMIT_TYPEHASH =\n        keccak256(\"Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)\");\n    /**\n     * @dev In previous versions `_PERMIT_TYPEHASH` was declared as `immutable`.\n     * However, to ensure consistency with the upgradeable transpiler, we will continue\n     * to reserve a slot.\n     * @custom:oz-renamed-from _PERMIT_TYPEHASH\n     */\n    // solhint-disable-next-line var-name-mixedcase\n    bytes32 private _PERMIT_TYPEHASH_DEPRECATED_SLOT;\n\n    /**\n     * @dev Initializes the {EIP712} domain separator using the `name` parameter, and setting `version` to `\"1\"`.\n     *\n     * It's a good idea to use the same `name` that is defined as the ERC20 token name.\n     */\n    function __ERC20Permit_init(string memory name) internal onlyInitializing {\n        __EIP712_init_unchained(name, \"1\");\n    }\n\n    function __ERC20Permit_init_unchained(string memory) internal onlyInitializing {}\n\n    /**\n     * @inheritdoc IERC20PermitUpgradeable\n     */\n    function permit(\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) public virtual override {\n        require(block.timestamp <= deadline, \"ERC20Permit: expired deadline\");\n\n        bytes32 structHash = keccak256(abi.encode(_PERMIT_TYPEHASH, owner, spender, value, _useNonce(owner), deadline));\n\n        bytes32 hash = _hashTypedDataV4(structHash);\n\n        address signer = ECDSAUpgradeable.recover(hash, v, r, s);\n        require(signer == owner, \"ERC20Permit: invalid signature\");\n\n        _approve(owner, spender, value);\n    }\n\n    /**\n     * @inheritdoc IERC20PermitUpgradeable\n     */\n    function nonces(address owner) public view virtual override returns (uint256) {\n        return _nonces[owner].current();\n    }\n\n    /**\n     * @inheritdoc IERC20PermitUpgradeable\n     */\n    // solhint-disable-next-line func-name-mixedcase\n    function DOMAIN_SEPARATOR() external view override returns (bytes32) {\n        return _domainSeparatorV4();\n    }\n\n    /**\n     * @dev \"Consume a nonce\": return the current value and increment.\n     *\n     * _Available since v4.1._\n     */\n    function _useNonce(address owner) internal virtual returns (uint256 current) {\n        CountersUpgradeable.Counter storage nonce = _nonces[owner];\n        current = nonce.current();\n        nonce.increment();\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[49] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20MetadataUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20Upgradeable.sol\";\n\n/**\n * @dev Interface for the optional metadata functions from the ERC20 standard.\n *\n * _Available since v4.1._\n */\ninterface IERC20MetadataUpgradeable is IERC20Upgradeable {\n    /**\n     * @dev Returns the name of the token.\n     */\n    function name() external view returns (string memory);\n\n    /**\n     * @dev Returns the symbol of the token.\n     */\n    function symbol() external view returns (string memory);\n\n    /**\n     * @dev Returns the decimals places of the token.\n     */\n    function decimals() external view returns (uint8);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n *     doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n *     token.safeTransferFrom(msg.sender, address(this), value);\n *     ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20PermitUpgradeable {\n    /**\n     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n     * given ``owner``'s signed approval.\n     *\n     * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n     * ordering also apply here.\n     *\n     * Emits an {Approval} event.\n     *\n     * Requirements:\n     *\n     * - `spender` cannot be the zero address.\n     * - `deadline` must be a timestamp in the future.\n     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n     * over the EIP712-formatted function arguments.\n     * - the signature must use ``owner``'s current nonce (see {nonces}).\n     *\n     * For more information on the signature format, see the\n     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n     * section].\n     *\n     * CAUTION: See Security Considerations above.\n     */\n    function permit(\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external;\n\n    /**\n     * @dev Returns the current nonce for `owner`. This value must be\n     * included whenever a signature is generated for {permit}.\n     *\n     * Every successful call to {permit} increases ``owner``'s nonce by one. This\n     * prevents a signature from being used multiple times.\n     */\n    function nonces(address owner) external view returns (uint256);\n\n    /**\n     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n     */\n    // solhint-disable-next-line func-name-mixedcase\n    function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-ERC20PermitUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/draft-ERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n// EIP-2612 is Final as of 2022-11-01. This file is deprecated.\n\nimport \"./ERC20PermitUpgradeable.sol\";\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n    /**\n     * @dev Returns true if `account` is a contract.\n     *\n     * [IMPORTANT]\n     * ====\n     * It is unsafe to assume that an address for which this function returns\n     * false is an externally-owned account (EOA) and not a contract.\n     *\n     * Among others, `isContract` will return false for the following\n     * types of addresses:\n     *\n     *  - an externally-owned account\n     *  - a contract in construction\n     *  - an address where a contract will be created\n     *  - an address where a contract lived, but was destroyed\n     *\n     * Furthermore, `isContract` will also return true if the target contract within\n     * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n     * which only has an effect at the end of a transaction.\n     * ====\n     *\n     * [IMPORTANT]\n     * ====\n     * You shouldn't rely on `isContract` to protect against flash loan attacks!\n     *\n     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n     * constructor.\n     * ====\n     */\n    function isContract(address account) internal view returns (bool) {\n        // This method relies on extcodesize/address.code.length, which returns 0\n        // for contracts in construction, since the code is only stored at the end\n        // of the constructor execution.\n\n        return account.code.length > 0;\n    }\n\n    /**\n     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n     * `recipient`, forwarding all available gas and reverting on errors.\n     *\n     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n     * of certain opcodes, possibly making contracts go over the 2300 gas limit\n     * imposed by `transfer`, making them unable to receive funds via\n     * `transfer`. {sendValue} removes this limitation.\n     *\n     * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n     *\n     * IMPORTANT: because control is transferred to `recipient`, care must be\n     * taken to not create reentrancy vulnerabilities. Consider using\n     * {ReentrancyGuard} or the\n     * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n     */\n    function sendValue(address payable recipient, uint256 amount) internal {\n        require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n        (bool success, ) = recipient.call{value: amount}(\"\");\n        require(success, \"Address: unable to send value, recipient may have reverted\");\n    }\n\n    /**\n     * @dev Performs a Solidity function call using a low level `call`. A\n     * plain `call` is an unsafe replacement for a function call: use this\n     * function instead.\n     *\n     * If `target` reverts with a revert reason, it is bubbled up by this\n     * function (like regular Solidity function calls).\n     *\n     * Returns the raw returned data. To convert to the expected return value,\n     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n     *\n     * Requirements:\n     *\n     * - `target` must be a contract.\n     * - calling `target` with `data` must not revert.\n     *\n     * _Available since v3.1._\n     */\n    function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n     * `errorMessage` as a fallback revert reason when `target` reverts.\n     *\n     * _Available since v3.1._\n     */\n    function functionCall(\n        address target,\n        bytes memory data,\n        string memory errorMessage\n    ) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, 0, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but also transferring `value` wei to `target`.\n     *\n     * Requirements:\n     *\n     * - the calling contract must have an ETH balance of at least `value`.\n     * - the called Solidity function must be `payable`.\n     *\n     * _Available since v3.1._\n     */\n    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n     * with `errorMessage` as a fallback revert reason when `target` reverts.\n     *\n     * _Available since v3.1._\n     */\n    function functionCallWithValue(\n        address target,\n        bytes memory data,\n        uint256 value,\n        string memory errorMessage\n    ) internal returns (bytes memory) {\n        require(address(this).balance >= value, \"Address: insufficient balance for call\");\n        (bool success, bytes memory returndata) = target.call{value: value}(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a static call.\n     *\n     * _Available since v3.3._\n     */\n    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n        return functionStaticCall(target, data, \"Address: low-level static call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n     * but performing a static call.\n     *\n     * _Available since v3.3._\n     */\n    function functionStaticCall(\n        address target,\n        bytes memory data,\n        string memory errorMessage\n    ) internal view returns (bytes memory) {\n        (bool success, bytes memory returndata) = target.staticcall(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a delegate call.\n     *\n     * _Available since v3.4._\n     */\n    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n        return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n     * but performing a delegate call.\n     *\n     * _Available since v3.4._\n     */\n    function functionDelegateCall(\n        address target,\n        bytes memory data,\n        string memory errorMessage\n    ) internal returns (bytes memory) {\n        (bool success, bytes memory returndata) = target.delegatecall(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n     *\n     * _Available since v4.8._\n     */\n    function verifyCallResultFromTarget(\n        address target,\n        bool success,\n        bytes memory returndata,\n        string memory errorMessage\n    ) internal view returns (bytes memory) {\n        if (success) {\n            if (returndata.length == 0) {\n                // only check isContract if the call was successful and the return data is empty\n                // otherwise we already know that it was a contract\n                require(isContract(target), \"Address: call to non-contract\");\n            }\n            return returndata;\n        } else {\n            _revert(returndata, errorMessage);\n        }\n    }\n\n    /**\n     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n     * revert reason or using the provided one.\n     *\n     * _Available since v4.3._\n     */\n    function verifyCallResult(\n        bool success,\n        bytes memory returndata,\n        string memory errorMessage\n    ) internal pure returns (bytes memory) {\n        if (success) {\n            return returndata;\n        } else {\n            _revert(returndata, errorMessage);\n        }\n    }\n\n    function _revert(bytes memory returndata, string memory errorMessage) private pure {\n        // Look for revert reason and bubble it up if present\n        if (returndata.length > 0) {\n            // The easiest way to bubble the revert reason is using memory via assembly\n            /// @solidity memory-safe-assembly\n            assembly {\n                let returndata_size := mload(returndata)\n                revert(add(32, returndata), returndata_size)\n            }\n        } else {\n            revert(errorMessage);\n        }\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract ContextUpgradeable is Initializable {\n    function __Context_init() internal onlyInitializing {\n    }\n\n    function __Context_init_unchained() internal onlyInitializing {\n    }\n    function _msgSender() internal view virtual returns (address) {\n        return msg.sender;\n    }\n\n    function _msgData() internal view virtual returns (bytes calldata) {\n        return msg.data;\n    }\n\n    function _contextSuffixLength() internal view virtual returns (uint256) {\n        return 0;\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[50] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @title Counters\n * @author Matt Condon (@shrugs)\n * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number\n * of elements in a mapping, issuing ERC721 ids, or counting request ids.\n *\n * Include with `using Counters for Counters.Counter;`\n */\nlibrary CountersUpgradeable {\n    struct Counter {\n        // This variable should never be directly accessed by users of the library: interactions must be restricted to\n        // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add\n        // this feature: see https://github.com/ethereum/solidity/issues/4637\n        uint256 _value; // default: 0\n    }\n\n    function current(Counter storage counter) internal view returns (uint256) {\n        return counter._value;\n    }\n\n    function increment(Counter storage counter) internal {\n        unchecked {\n            counter._value += 1;\n        }\n    }\n\n    function decrement(Counter storage counter) internal {\n        uint256 value = counter._value;\n        require(value > 0, \"Counter: decrement overflow\");\n        unchecked {\n            counter._value = value - 1;\n        }\n    }\n\n    function reset(Counter storage counter) internal {\n        counter._value = 0;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/MathUpgradeable.sol\";\nimport \"./math/SignedMathUpgradeable.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary StringsUpgradeable {\n    bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n    uint8 private constant _ADDRESS_LENGTH = 20;\n\n    /**\n     * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n     */\n    function toString(uint256 value) internal pure returns (string memory) {\n        unchecked {\n            uint256 length = MathUpgradeable.log10(value) + 1;\n            string memory buffer = new string(length);\n            uint256 ptr;\n            /// @solidity memory-safe-assembly\n            assembly {\n                ptr := add(buffer, add(32, length))\n            }\n            while (true) {\n                ptr--;\n                /// @solidity memory-safe-assembly\n                assembly {\n                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n                }\n                value /= 10;\n                if (value == 0) break;\n            }\n            return buffer;\n        }\n    }\n\n    /**\n     * @dev Converts a `int256` to its ASCII `string` decimal representation.\n     */\n    function toString(int256 value) internal pure returns (string memory) {\n        return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMathUpgradeable.abs(value))));\n    }\n\n    /**\n     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n     */\n    function toHexString(uint256 value) internal pure returns (string memory) {\n        unchecked {\n            return toHexString(value, MathUpgradeable.log256(value) + 1);\n        }\n    }\n\n    /**\n     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n     */\n    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n        bytes memory buffer = new bytes(2 * length + 2);\n        buffer[0] = \"0\";\n        buffer[1] = \"x\";\n        for (uint256 i = 2 * length + 1; i > 1; --i) {\n            buffer[i] = _SYMBOLS[value & 0xf];\n            value >>= 4;\n        }\n        require(value == 0, \"Strings: hex length insufficient\");\n        return string(buffer);\n    }\n\n    /**\n     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n     */\n    function toHexString(address addr) internal pure returns (string memory) {\n        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n    }\n\n    /**\n     * @dev Returns true if the two strings are equal.\n     */\n    function equal(string memory a, string memory b) internal pure returns (bool) {\n        return keccak256(bytes(a)) == keccak256(bytes(b));\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../StringsUpgradeable.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSAUpgradeable {\n    enum RecoverError {\n        NoError,\n        InvalidSignature,\n        InvalidSignatureLength,\n        InvalidSignatureS,\n        InvalidSignatureV // Deprecated in v4.8\n    }\n\n    function _throwError(RecoverError error) private pure {\n        if (error == RecoverError.NoError) {\n            return; // no error: do nothing\n        } else if (error == RecoverError.InvalidSignature) {\n            revert(\"ECDSA: invalid signature\");\n        } else if (error == RecoverError.InvalidSignatureLength) {\n            revert(\"ECDSA: invalid signature length\");\n        } else if (error == RecoverError.InvalidSignatureS) {\n            revert(\"ECDSA: invalid signature 's' value\");\n        }\n    }\n\n    /**\n     * @dev Returns the address that signed a hashed message (`hash`) with\n     * `signature` or error string. This address can then be used for verification purposes.\n     *\n     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n     * this function rejects them by requiring the `s` value to be in the lower\n     * half order, and the `v` value to be either 27 or 28.\n     *\n     * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n     * verification to be secure: it is possible to craft signatures that\n     * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n     * this is by receiving a hash of the original message (which may otherwise\n     * be too long), and then calling {toEthSignedMessageHash} on it.\n     *\n     * Documentation for signature generation:\n     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n     *\n     * _Available since v4.3._\n     */\n    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n        if (signature.length == 65) {\n            bytes32 r;\n            bytes32 s;\n            uint8 v;\n            // ecrecover takes the signature parameters, and the only way to get them\n            // currently is to use assembly.\n            /// @solidity memory-safe-assembly\n            assembly {\n                r := mload(add(signature, 0x20))\n                s := mload(add(signature, 0x40))\n                v := byte(0, mload(add(signature, 0x60)))\n            }\n            return tryRecover(hash, v, r, s);\n        } else {\n            return (address(0), RecoverError.InvalidSignatureLength);\n        }\n    }\n\n    /**\n     * @dev Returns the address that signed a hashed message (`hash`) with\n     * `signature`. This address can then be used for verification purposes.\n     *\n     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n     * this function rejects them by requiring the `s` value to be in the lower\n     * half order, and the `v` value to be either 27 or 28.\n     *\n     * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n     * verification to be secure: it is possible to craft signatures that\n     * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n     * this is by receiving a hash of the original message (which may otherwise\n     * be too long), and then calling {toEthSignedMessageHash} on it.\n     */\n    function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n        (address recovered, RecoverError error) = tryRecover(hash, signature);\n        _throwError(error);\n        return recovered;\n    }\n\n    /**\n     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n     *\n     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n     *\n     * _Available since v4.3._\n     */\n    function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n        bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n        uint8 v = uint8((uint256(vs) >> 255) + 27);\n        return tryRecover(hash, v, r, s);\n    }\n\n    /**\n     * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n     *\n     * _Available since v4.2._\n     */\n    function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n        (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n        _throwError(error);\n        return recovered;\n    }\n\n    /**\n     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n     * `r` and `s` signature fields separately.\n     *\n     * _Available since v4.3._\n     */\n    function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n        // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n        //\n        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n        // these malleable signatures as well.\n        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n            return (address(0), RecoverError.InvalidSignatureS);\n        }\n\n        // If the signature is valid (and not malleable), return the signer address\n        address signer = ecrecover(hash, v, r, s);\n        if (signer == address(0)) {\n            return (address(0), RecoverError.InvalidSignature);\n        }\n\n        return (signer, RecoverError.NoError);\n    }\n\n    /**\n     * @dev Overload of {ECDSA-recover} that receives the `v`,\n     * `r` and `s` signature fields separately.\n     */\n    function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n        (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n        _throwError(error);\n        return recovered;\n    }\n\n    /**\n     * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n     * produces hash corresponding to the one signed with the\n     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n     * JSON-RPC method as part of EIP-191.\n     *\n     * See {recover}.\n     */\n    function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n        // 32 is the length in bytes of hash,\n        // enforced by the type signature above\n        /// @solidity memory-safe-assembly\n        assembly {\n            mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n            mstore(0x1c, hash)\n            message := keccak256(0x00, 0x3c)\n        }\n    }\n\n    /**\n     * @dev Returns an Ethereum Signed Message, created from `s`. This\n     * produces hash corresponding to the one signed with the\n     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n     * JSON-RPC method as part of EIP-191.\n     *\n     * See {recover}.\n     */\n    function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n        return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", StringsUpgradeable.toString(s.length), s));\n    }\n\n    /**\n     * @dev Returns an Ethereum Signed Typed Data, created from a\n     * `domainSeparator` and a `structHash`. This produces hash corresponding\n     * to the one signed with the\n     * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n     * JSON-RPC method as part of EIP-712.\n     *\n     * See {recover}.\n     */\n    function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            let ptr := mload(0x40)\n            mstore(ptr, \"\\x19\\x01\")\n            mstore(add(ptr, 0x02), domainSeparator)\n            mstore(add(ptr, 0x22), structHash)\n            data := keccak256(ptr, 0x42)\n        }\n    }\n\n    /**\n     * @dev Returns an Ethereum Signed Data with intended validator, created from a\n     * `validator` and `data` according to the version 0 of EIP-191.\n     *\n     * See {recover}.\n     */\n    function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n        return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/cryptography/EIP712Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/EIP712.sol)\n\npragma solidity ^0.8.8;\n\nimport \"./ECDSAUpgradeable.sol\";\nimport \"../../interfaces/IERC5267Upgradeable.sol\";\nimport {Initializable} from \"../../proxy/utils/Initializable.sol\";\n\n/**\n * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n *\n * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,\n * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding\n * they need in their contracts using a combination of `abi.encode` and `keccak256`.\n *\n * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding\n * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA\n * ({_hashTypedDataV4}).\n *\n * The implementation of the domain separator was designed to be as efficient as possible while still properly updating\n * the chain id to protect against replay attacks on an eventual fork of the chain.\n *\n * NOTE: This contract implements the version of the encoding known as \"v4\", as implemented by the JSON RPC method\n * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].\n *\n * NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain\n * separator of the implementation contract. This will cause the `_domainSeparatorV4` function to always rebuild the\n * separator from the immutable values, which is cheaper than accessing a cached version in cold storage.\n *\n * _Available since v3.4._\n *\n * @custom:storage-size 52\n */\nabstract contract EIP712Upgradeable is Initializable, IERC5267Upgradeable {\n    bytes32 private constant _TYPE_HASH =\n        keccak256(\"EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)\");\n\n    /// @custom:oz-renamed-from _HASHED_NAME\n    bytes32 private _hashedName;\n    /// @custom:oz-renamed-from _HASHED_VERSION\n    bytes32 private _hashedVersion;\n\n    string private _name;\n    string private _version;\n\n    /**\n     * @dev Initializes the domain separator and parameter caches.\n     *\n     * The meaning of `name` and `version` is specified in\n     * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n     *\n     * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n     * - `version`: the current major version of the signing domain.\n     *\n     * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n     * contract upgrade].\n     */\n    function __EIP712_init(string memory name, string memory version) internal onlyInitializing {\n        __EIP712_init_unchained(name, version);\n    }\n\n    function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {\n        _name = name;\n        _version = version;\n\n        // Reset prior values in storage if upgrading\n        _hashedName = 0;\n        _hashedVersion = 0;\n    }\n\n    /**\n     * @dev Returns the domain separator for the current chain.\n     */\n    function _domainSeparatorV4() internal view returns (bytes32) {\n        return _buildDomainSeparator();\n    }\n\n    function _buildDomainSeparator() private view returns (bytes32) {\n        return keccak256(abi.encode(_TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash(), block.chainid, address(this)));\n    }\n\n    /**\n     * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n     * function returns the hash of the fully encoded EIP712 message for this domain.\n     *\n     * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n     *\n     * ```solidity\n     * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(\n     *     keccak256(\"Mail(address to,string contents)\"),\n     *     mailTo,\n     *     keccak256(bytes(mailContents))\n     * )));\n     * address signer = ECDSA.recover(digest, signature);\n     * ```\n     */\n    function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {\n        return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(), structHash);\n    }\n\n    /**\n     * @dev See {EIP-5267}.\n     *\n     * _Available since v4.9._\n     */\n    function eip712Domain()\n        public\n        view\n        virtual\n        override\n        returns (\n            bytes1 fields,\n            string memory name,\n            string memory version,\n            uint256 chainId,\n            address verifyingContract,\n            bytes32 salt,\n            uint256[] memory extensions\n        )\n    {\n        // If the hashed name and version in storage are non-zero, the contract hasn't been properly initialized\n        // and the EIP712 domain is not reliable, as it will be missing name and version.\n        require(_hashedName == 0 && _hashedVersion == 0, \"EIP712: Uninitialized\");\n\n        return (\n            hex\"0f\", // 01111\n            _EIP712Name(),\n            _EIP712Version(),\n            block.chainid,\n            address(this),\n            bytes32(0),\n            new uint256[](0)\n        );\n    }\n\n    /**\n     * @dev The name parameter for the EIP712 domain.\n     *\n     * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs\n     * are a concern.\n     */\n    function _EIP712Name() internal virtual view returns (string memory) {\n        return _name;\n    }\n\n    /**\n     * @dev The version parameter for the EIP712 domain.\n     *\n     * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs\n     * are a concern.\n     */\n    function _EIP712Version() internal virtual view returns (string memory) {\n        return _version;\n    }\n\n    /**\n     * @dev The hash of the name parameter for the EIP712 domain.\n     *\n     * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Name` instead.\n     */\n    function _EIP712NameHash() internal view returns (bytes32) {\n        string memory name = _EIP712Name();\n        if (bytes(name).length > 0) {\n            return keccak256(bytes(name));\n        } else {\n            // If the name is empty, the contract may have been upgraded without initializing the new storage.\n            // We return the name hash in storage if non-zero, otherwise we assume the name is empty by design.\n            bytes32 hashedName = _hashedName;\n            if (hashedName != 0) {\n                return hashedName;\n            } else {\n                return keccak256(\"\");\n            }\n        }\n    }\n\n    /**\n     * @dev The hash of the version parameter for the EIP712 domain.\n     *\n     * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Version` instead.\n     */\n    function _EIP712VersionHash() internal view returns (bytes32) {\n        string memory version = _EIP712Version();\n        if (bytes(version).length > 0) {\n            return keccak256(bytes(version));\n        } else {\n            // If the version is empty, the contract may have been upgraded without initializing the new storage.\n            // We return the version hash in storage if non-zero, otherwise we assume the version is empty by design.\n            bytes32 hashedVersion = _hashedVersion;\n            if (hashedVersion != 0) {\n                return hashedVersion;\n            } else {\n                return keccak256(\"\");\n            }\n        }\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[48] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary MathUpgradeable {\n    enum Rounding {\n        Down, // Toward negative infinity\n        Up, // Toward infinity\n        Zero // Toward zero\n    }\n\n    /**\n     * @dev Returns the largest of two numbers.\n     */\n    function max(uint256 a, uint256 b) internal pure returns (uint256) {\n        return a > b ? a : b;\n    }\n\n    /**\n     * @dev Returns the smallest of two numbers.\n     */\n    function min(uint256 a, uint256 b) internal pure returns (uint256) {\n        return a < b ? a : b;\n    }\n\n    /**\n     * @dev Returns the average of two numbers. The result is rounded towards\n     * zero.\n     */\n    function average(uint256 a, uint256 b) internal pure returns (uint256) {\n        // (a + b) / 2 can overflow.\n        return (a & b) + (a ^ b) / 2;\n    }\n\n    /**\n     * @dev Returns the ceiling of the division of two numbers.\n     *\n     * This differs from standard division with `/` in that it rounds up instead\n     * of rounding down.\n     */\n    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n        // (a + b - 1) / b can overflow on addition, so we distribute.\n        return a == 0 ? 0 : (a - 1) / b + 1;\n    }\n\n    /**\n     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n     * with further edits by Uniswap Labs also under MIT license.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n        unchecked {\n            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n            // variables such that product = prod1 * 2^256 + prod0.\n            uint256 prod0; // Least significant 256 bits of the product\n            uint256 prod1; // Most significant 256 bits of the product\n            assembly {\n                let mm := mulmod(x, y, not(0))\n                prod0 := mul(x, y)\n                prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n            }\n\n            // Handle non-overflow cases, 256 by 256 division.\n            if (prod1 == 0) {\n                // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n                // The surrounding unchecked block does not change this fact.\n                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n                return prod0 / denominator;\n            }\n\n            // Make sure the result is less than 2^256. Also prevents denominator == 0.\n            require(denominator > prod1, \"Math: mulDiv overflow\");\n\n            ///////////////////////////////////////////////\n            // 512 by 256 division.\n            ///////////////////////////////////////////////\n\n            // Make division exact by subtracting the remainder from [prod1 prod0].\n            uint256 remainder;\n            assembly {\n                // Compute remainder using mulmod.\n                remainder := mulmod(x, y, denominator)\n\n                // Subtract 256 bit number from 512 bit number.\n                prod1 := sub(prod1, gt(remainder, prod0))\n                prod0 := sub(prod0, remainder)\n            }\n\n            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n            // See https://cs.stackexchange.com/q/138556/92363.\n\n            // Does not overflow because the denominator cannot be zero at this stage in the function.\n            uint256 twos = denominator & (~denominator + 1);\n            assembly {\n                // Divide denominator by twos.\n                denominator := div(denominator, twos)\n\n                // Divide [prod1 prod0] by twos.\n                prod0 := div(prod0, twos)\n\n                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n                twos := add(div(sub(0, twos), twos), 1)\n            }\n\n            // Shift in bits from prod1 into prod0.\n            prod0 |= prod1 * twos;\n\n            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n            // four bits. That is, denominator * inv = 1 mod 2^4.\n            uint256 inverse = (3 * denominator) ^ 2;\n\n            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n            // in modular arithmetic, doubling the correct bits in each step.\n            inverse *= 2 - denominator * inverse; // inverse mod 2^8\n            inverse *= 2 - denominator * inverse; // inverse mod 2^16\n            inverse *= 2 - denominator * inverse; // inverse mod 2^32\n            inverse *= 2 - denominator * inverse; // inverse mod 2^64\n            inverse *= 2 - denominator * inverse; // inverse mod 2^128\n            inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n            // is no longer required.\n            result = prod0 * inverse;\n            return result;\n        }\n    }\n\n    /**\n     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n        uint256 result = mulDiv(x, y, denominator);\n        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n            result += 1;\n        }\n        return result;\n    }\n\n    /**\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n     *\n     * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n     */\n    function sqrt(uint256 a) internal pure returns (uint256) {\n        if (a == 0) {\n            return 0;\n        }\n\n        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n        //\n        // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n        //\n        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n        //\n        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n        uint256 result = 1 << (log2(a) >> 1);\n\n        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n        // into the expected uint128 result.\n        unchecked {\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            return min(result, a / result);\n        }\n    }\n\n    /**\n     * @notice Calculates sqrt(a), following the selected rounding direction.\n     */\n    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = sqrt(a);\n            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 2, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 128;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 64;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 32;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 16;\n            }\n            if (value >> 8 > 0) {\n                value >>= 8;\n                result += 8;\n            }\n            if (value >> 4 > 0) {\n                value >>= 4;\n                result += 4;\n            }\n            if (value >> 2 > 0) {\n                value >>= 2;\n                result += 2;\n            }\n            if (value >> 1 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log2(value);\n            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 10, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >= 10 ** 64) {\n                value /= 10 ** 64;\n                result += 64;\n            }\n            if (value >= 10 ** 32) {\n                value /= 10 ** 32;\n                result += 32;\n            }\n            if (value >= 10 ** 16) {\n                value /= 10 ** 16;\n                result += 16;\n            }\n            if (value >= 10 ** 8) {\n                value /= 10 ** 8;\n                result += 8;\n            }\n            if (value >= 10 ** 4) {\n                value /= 10 ** 4;\n                result += 4;\n            }\n            if (value >= 10 ** 2) {\n                value /= 10 ** 2;\n                result += 2;\n            }\n            if (value >= 10 ** 1) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log10(value);\n            return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 256, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     *\n     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n     */\n    function log256(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 16;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 8;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 4;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 2;\n            }\n            if (value >> 8 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log256(value);\n            return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n        }\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMathUpgradeable {\n    /**\n     * @dev Returns the largest of two signed numbers.\n     */\n    function max(int256 a, int256 b) internal pure returns (int256) {\n        return a > b ? a : b;\n    }\n\n    /**\n     * @dev Returns the smallest of two signed numbers.\n     */\n    function min(int256 a, int256 b) internal pure returns (int256) {\n        return a < b ? a : b;\n    }\n\n    /**\n     * @dev Returns the average of two signed numbers without overflow.\n     * The result is rounded towards zero.\n     */\n    function average(int256 a, int256 b) internal pure returns (int256) {\n        // Formula from the book \"Hacker's Delight\"\n        int256 x = (a & b) + ((a ^ b) >> 1);\n        return x + (int256(uint256(x) >> 255) & (a ^ b));\n    }\n\n    /**\n     * @dev Returns the absolute unsigned value of a signed value.\n     */\n    function abs(int256 n) internal pure returns (uint256) {\n        unchecked {\n            // must be unchecked in order to support `n = type(int256).min`\n            return uint256(n >= 0 ? n : -n);\n        }\n    }\n}\n"},{"file_path":"@openzeppelin/contracts/token/ERC20/IERC20.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n    /**\n     * @dev Emitted when `value` tokens are moved from one account (`from`) to\n     * another (`to`).\n     *\n     * Note that `value` may be zero.\n     */\n    event Transfer(address indexed from, address indexed to, uint256 value);\n\n    /**\n     * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n     * a call to {approve}. `value` is the new allowance.\n     */\n    event Approval(address indexed owner, address indexed spender, uint256 value);\n\n    /**\n     * @dev Returns the amount of tokens in existence.\n     */\n    function totalSupply() external view returns (uint256);\n\n    /**\n     * @dev Returns the amount of tokens owned by `account`.\n     */\n    function balanceOf(address account) external view returns (uint256);\n\n    /**\n     * @dev Moves `amount` tokens from the caller's account to `to`.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transfer(address to, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Returns the remaining number of tokens that `spender` will be\n     * allowed to spend on behalf of `owner` through {transferFrom}. This is\n     * zero by default.\n     *\n     * This value changes when {approve} or {transferFrom} are called.\n     */\n    function allowance(address owner, address spender) external view returns (uint256);\n\n    /**\n     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * IMPORTANT: Beware that changing an allowance with this method brings the risk\n     * that someone may use both the old and the new allowance by unfortunate\n     * transaction ordering. One possible solution to mitigate this race\n     * condition is to first reduce the spender's allowance to 0 and set the\n     * desired value afterwards:\n     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n     *\n     * Emits an {Approval} event.\n     */\n    function approve(address spender, uint256 amount) external returns (bool);\n\n    /**\n     * @dev Moves `amount` tokens from `from` to `to` using the\n     * allowance mechanism. `amount` is then deducted from the caller's\n     * allowance.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"},{"file_path":"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n *     doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n *     token.safeTransferFrom(msg.sender, address(this), value);\n *     ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20Permit {\n    /**\n     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n     * given ``owner``'s signed approval.\n     *\n     * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n     * ordering also apply here.\n     *\n     * Emits an {Approval} event.\n     *\n     * Requirements:\n     *\n     * - `spender` cannot be the zero address.\n     * - `deadline` must be a timestamp in the future.\n     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n     * over the EIP712-formatted function arguments.\n     * - the signature must use ``owner``'s current nonce (see {nonces}).\n     *\n     * For more information on the signature format, see the\n     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n     * section].\n     *\n     * CAUTION: See Security Considerations above.\n     */\n    function permit(\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external;\n\n    /**\n     * @dev Returns the current nonce for `owner`. This value must be\n     * included whenever a signature is generated for {permit}.\n     *\n     * Every successful call to {permit} increases ``owner``'s nonce by one. This\n     * prevents a signature from being used multiple times.\n     */\n    function nonces(address owner) external view returns (uint256);\n\n    /**\n     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n     */\n    // solhint-disable-next-line func-name-mixedcase\n    function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"},{"file_path":"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n    using Address for address;\n\n    /**\n     * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful.\n     */\n    function safeTransfer(IERC20 token, address to, uint256 value) internal {\n        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n    }\n\n    /**\n     * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n     * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n     */\n    function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n    }\n\n    /**\n     * @dev Deprecated. This function has issues similar to the ones found in\n     * {IERC20-approve}, and its usage is discouraged.\n     *\n     * Whenever possible, use {safeIncreaseAllowance} and\n     * {safeDecreaseAllowance} instead.\n     */\n    function safeApprove(IERC20 token, address spender, uint256 value) internal {\n        // safeApprove should only be called when setting an initial allowance,\n        // or when resetting it to zero. To increase and decrease it, use\n        // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n        require(\n            (value == 0) || (token.allowance(address(this), spender) == 0),\n            \"SafeERC20: approve from non-zero to non-zero allowance\"\n        );\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n    }\n\n    /**\n     * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful.\n     */\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n        uint256 oldAllowance = token.allowance(address(this), spender);\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n    }\n\n    /**\n     * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful.\n     */\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n        unchecked {\n            uint256 oldAllowance = token.allowance(address(this), spender);\n            require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n        }\n    }\n\n    /**\n     * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n     * to be set to zero before setting it to a non-zero value, such as USDT.\n     */\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\n        bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n        if (!_callOptionalReturnBool(token, approvalCall)) {\n            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n            _callOptionalReturn(token, approvalCall);\n        }\n    }\n\n    /**\n     * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n     * Revert on invalid signature.\n     */\n    function safePermit(\n        IERC20Permit token,\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) internal {\n        uint256 nonceBefore = token.nonces(owner);\n        token.permit(owner, spender, value, deadline, v, r, s);\n        uint256 nonceAfter = token.nonces(owner);\n        require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n    }\n\n    /**\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\n     * @param token The token targeted by the call.\n     * @param data The call data (encoded using abi.encode or one of its variants).\n     */\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\n        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n        // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n        // the target address contains contract code and also asserts for success in the low-level call.\n\n        bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n        require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n    }\n\n    /**\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\n     * @param token The token targeted by the call.\n     * @param data The call data (encoded using abi.encode or one of its variants).\n     *\n     * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n     */\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n        // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n        // and not revert is the subcall reverts.\n\n        (bool success, bytes memory returndata) = address(token).call(data);\n        return\n            success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n    }\n}\n"},{"file_path":"@openzeppelin/contracts/utils/Address.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n    /**\n     * @dev Returns true if `account` is a contract.\n     *\n     * [IMPORTANT]\n     * ====\n     * It is unsafe to assume that an address for which this function returns\n     * false is an externally-owned account (EOA) and not a contract.\n     *\n     * Among others, `isContract` will return false for the following\n     * types of addresses:\n     *\n     *  - an externally-owned account\n     *  - a contract in construction\n     *  - an address where a contract will be created\n     *  - an address where a contract lived, but was destroyed\n     *\n     * Furthermore, `isContract` will also return true if the target contract within\n     * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n     * which only has an effect at the end of a transaction.\n     * ====\n     *\n     * [IMPORTANT]\n     * ====\n     * You shouldn't rely on `isContract` to protect against flash loan attacks!\n     *\n     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n     * constructor.\n     * ====\n     */\n    function isContract(address account) internal view returns (bool) {\n        // This method relies on extcodesize/address.code.length, which returns 0\n        // for contracts in construction, since the code is only stored at the end\n        // of the constructor execution.\n\n        return account.code.length > 0;\n    }\n\n    /**\n     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n     * `recipient`, forwarding all available gas and reverting on errors.\n     *\n     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n     * of certain opcodes, possibly making contracts go over the 2300 gas limit\n     * imposed by `transfer`, making them unable to receive funds via\n     * `transfer`. {sendValue} removes this limitation.\n     *\n     * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n     *\n     * IMPORTANT: because control is transferred to `recipient`, care must be\n     * taken to not create reentrancy vulnerabilities. Consider using\n     * {ReentrancyGuard} or the\n     * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n     */\n    function sendValue(address payable recipient, uint256 amount) internal {\n        require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n        (bool success, ) = recipient.call{value: amount}(\"\");\n        require(success, \"Address: unable to send value, recipient may have reverted\");\n    }\n\n    /**\n     * @dev Performs a Solidity function call using a low level `call`. A\n     * plain `call` is an unsafe replacement for a function call: use this\n     * function instead.\n     *\n     * If `target` reverts with a revert reason, it is bubbled up by this\n     * function (like regular Solidity function calls).\n     *\n     * Returns the raw returned data. To convert to the expected return value,\n     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n     *\n     * Requirements:\n     *\n     * - `target` must be a contract.\n     * - calling `target` with `data` must not revert.\n     *\n     * _Available since v3.1._\n     */\n    function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n     * `errorMessage` as a fallback revert reason when `target` reverts.\n     *\n     * _Available since v3.1._\n     */\n    function functionCall(\n        address target,\n        bytes memory data,\n        string memory errorMessage\n    ) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, 0, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but also transferring `value` wei to `target`.\n     *\n     * Requirements:\n     *\n     * - the calling contract must have an ETH balance of at least `value`.\n     * - the called Solidity function must be `payable`.\n     *\n     * _Available since v3.1._\n     */\n    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n     * with `errorMessage` as a fallback revert reason when `target` reverts.\n     *\n     * _Available since v3.1._\n     */\n    function functionCallWithValue(\n        address target,\n        bytes memory data,\n        uint256 value,\n        string memory errorMessage\n    ) internal returns (bytes memory) {\n        require(address(this).balance >= value, \"Address: insufficient balance for call\");\n        (bool success, bytes memory returndata) = target.call{value: value}(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a static call.\n     *\n     * _Available since v3.3._\n     */\n    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n        return functionStaticCall(target, data, \"Address: low-level static call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n     * but performing a static call.\n     *\n     * _Available since v3.3._\n     */\n    function functionStaticCall(\n        address target,\n        bytes memory data,\n        string memory errorMessage\n    ) internal view returns (bytes memory) {\n        (bool success, bytes memory returndata) = target.staticcall(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a delegate call.\n     *\n     * _Available since v3.4._\n     */\n    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n        return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n     * but performing a delegate call.\n     *\n     * _Available since v3.4._\n     */\n    function functionDelegateCall(\n        address target,\n        bytes memory data,\n        string memory errorMessage\n    ) internal returns (bytes memory) {\n        (bool success, bytes memory returndata) = target.delegatecall(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n     *\n     * _Available since v4.8._\n     */\n    function verifyCallResultFromTarget(\n        address target,\n        bool success,\n        bytes memory returndata,\n        string memory errorMessage\n    ) internal view returns (bytes memory) {\n        if (success) {\n            if (returndata.length == 0) {\n                // only check isContract if the call was successful and the return data is empty\n                // otherwise we already know that it was a contract\n                require(isContract(target), \"Address: call to non-contract\");\n            }\n            return returndata;\n        } else {\n            _revert(returndata, errorMessage);\n        }\n    }\n\n    /**\n     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n     * revert reason or using the provided one.\n     *\n     * _Available since v4.3._\n     */\n    function verifyCallResult(\n        bool success,\n        bytes memory returndata,\n        string memory errorMessage\n    ) internal pure returns (bytes memory) {\n        if (success) {\n            return returndata;\n        } else {\n            _revert(returndata, errorMessage);\n        }\n    }\n\n    function _revert(bytes memory returndata, string memory errorMessage) private pure {\n        // Look for revert reason and bubble it up if present\n        if (returndata.length > 0) {\n            // The easiest way to bubble the revert reason is using memory via assembly\n            /// @solidity memory-safe-assembly\n            assembly {\n                let returndata_size := mload(returndata)\n                revert(add(32, returndata), returndata_size)\n            }\n        } else {\n            revert(errorMessage);\n        }\n    }\n}\n"},{"file_path":"contracts/Stablecoin.sol","source_code":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport {ERC20PermitUpgradeable} from \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-ERC20PermitUpgradeable.sol\"; // solhint-disable-line max-line-length\nimport {Ownable2StepUpgradeable} from \"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\";\nimport {PausableUpgradeable} from \"@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol\";\n\ncontract Stablecoin is ERC20PermitUpgradeable, Ownable2StepUpgradeable, PausableUpgradeable {\n\n    mapping(address => bool) public frozen;\n    uint256[49] private __gap; // reserve storage slots for future base contract fields\n\n    event Mint(address indexed caller, address indexed to, uint256 amount);\n    event Burn(address indexed caller, address indexed from, uint256 amount);\n    event Freeze(address indexed caller, address indexed account);\n    event Unfreeze(address indexed caller, address indexed account);\n\n    /**\n     * @dev Throws if account is frozen.\n     */\n    modifier notFrozen(address account) {\n        require(!frozen[account], \"Account is frozen\");\n        _;\n    }\n\n    function initialize(address _initialOwner, string memory _name, string memory _symbol) public virtual initializer {\n        __Context_init();\n        __ERC20_init(_name, _symbol);\n        __ERC20Permit_init(_name);\n        __Ownable2Step_init();\n        __Pausable_init();\n        _transferOwnership(_initialOwner);\n    }\n\n    /**\n     * @dev See {ERC20-_mint}.\n     * @param amount Mint amount\n     * @return True if successful\n     * Can only be called by the current owner.\n     */\n    function mint(uint256 amount) external onlyOwner returns (bool) {\n        _mint(_msgSender(), amount);\n        emit Mint(_msgSender(), _msgSender(), amount);\n        return true;\n    }\n\n    /**\n     * @dev See {ERC20-_burn}.\n     * @param amount Burn amount\n     * @return True if successful\n     * Can only be called by the current owner.\n     */\n    function burn(uint256 amount) external onlyOwner returns (bool) {\n        _burn(_msgSender(), amount);\n        emit Burn(_msgSender(), _msgSender(), amount);\n        return true;\n    }\n\n    /**\n     * @dev Adds account to frozen state.\n     * Can only be called by the current owner.\n     */\n    function freeze(address account) external onlyOwner {\n        frozen[account] = true;\n        emit Freeze(_msgSender(), account);\n    }\n\n    /**\n     * @dev Removes account from frozen state.\n     * Can only be called by the current owner.\n     */\n    function unfreeze(address account) external onlyOwner {\n        delete frozen[account];\n        emit Unfreeze(_msgSender(), account);\n    }\n\n    /**\n     * @dev Triggers stopped state.\n     * Can only be called by the current owner.\n     */\n    function pause() external onlyOwner {\n        _pause();\n    }\n\n    /**\n     * @dev Returns to normal state.\n     * Can only be called by the current owner.\n     */\n    function unpause() external onlyOwner {\n        _unpause();\n    }\n\n    /**\n     * @dev Unsupported. Leaves the contract without owner.\n     */\n    function renounceOwnership() public view override onlyOwner {\n        revert(\"Unsupported\");\n    }\n\n    /**\n     * @dev See {ERC20-_transfer}.\n     * @param from Source address\n     * @param to Destination address\n     * @param amount Transfer amount\n     */\n    function _transfer(\n        address from,\n        address to,\n        uint256 amount\n    ) internal virtual override whenNotPaused notFrozen(from) notFrozen(to) notFrozen(_msgSender()) {\n        super._transfer(from, to, amount);\n    }\n\n    /**\n     * @dev See {ERC20-_approve}.\n     * @param owner Owners's address\n     * @param spender Spender's address\n     * @param amount Allowance amount\n     */\n    function _approve(\n        address owner,\n        address spender,\n        uint256 amount\n    ) internal override whenNotPaused notFrozen(owner) notFrozen(spender) {\n        super._approve(owner, spender, amount);\n    }\n}\n"},{"file_path":"contracts/interfaces/IERC3009.sol","source_code":"// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.24;\n\ninterface IERC3009 {\n    event AuthorizationUsed(address indexed authorizer, bytes32 indexed nonce);\n    event AuthorizationCanceled(address indexed authorizer, bytes32 indexed nonce);\n\n    /**\n     * @notice Execute a transfer with a signed authorization\n     * @param from          Payer's address (Authorizer)\n     * @param to            Payee's address\n     * @param value         Amount to be transferred\n     * @param validAfter    The time after which this is valid (unix time)\n     * @param validBefore   The time before which this is valid (unix time)\n     * @param nonce         Unique nonce\n     * @param v             v of the signature\n     * @param r             r of the signature\n     * @param s             s of the signature\n     */\n    function transferWithAuthorization(\n        address from,\n        address to,\n        uint256 value,\n        uint256 validAfter,\n        uint256 validBefore,\n        bytes32 nonce,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external;\n\n    /**\n     * @notice Receive a transfer with a signed authorization from the payer\n     * @dev This has an additional check to ensure that the payee's address matches the caller of this function to\n     * prevent front-running attacks. (See security considerations)\n     * @param from          Payer's address (Authorizer)\n     * @param to            Payee's address\n     * @param value         Amount to be transferred\n     * @param validAfter    The time after which this is valid (unix time)\n     * @param validBefore   The time before which this is valid (unix time)\n     * @param nonce         Unique nonce\n     * @param v             v of the signature\n     * @param r             r of the signature\n     * @param s             s of the signature\n     */\n    function receiveWithAuthorization(\n        address from,\n        address to,\n        uint256 value,\n        uint256 validAfter,\n        uint256 validBefore,\n        bytes32 nonce,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external;\n\n    /**\n     * @notice Attempt to cancel an authorization\n     * @param authorizer    Authorizer's address\n     * @param nonce         Nonce of the authorization\n     * @param v             v of the signature\n     * @param r             r of the signature\n     * @param s             s of the signature\n     */\n    function cancelAuthorization(\n        address authorizer,\n        bytes32 nonce,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external;\n\n    /**\n     * @notice Returns the state of an authorization\n     * @dev Nonces are randomly generated 32-byte data unique to the authorizer's address\n     * @param authorizer    Authorizer's address\n     * @param nonce         Nonce of the authorization\n     * @return True if the nonce is used\n     */\n    function authorizationState(address authorizer, bytes32 nonce) external view returns (bool);\n}\n"}],"certified":false,"conflicting_implementations":null,"abi":[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"authorizer","type":"address"},{"indexed":true,"internalType":"bytes32","name":"nonce","type":"bytes32"}],"name":"AuthorizationCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"authorizer","type":"address"},{"indexed":true,"internalType":"bytes32","name":"nonce","type":"bytes32"}],"name":"AuthorizationUsed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Burn","type":"event"},{"anonymous":false,"inputs":[],"name":"EIP712DomainChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ERC20Recovered","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"Freeze","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"FrozenAccountDrained","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"FrozenFundsReallocated","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":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Mint","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"caller","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"Unfreeze","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"CANCEL_AUTHORIZATION_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"RECEIVE_WITH_AUTHORIZATION_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"TRANSFER_WITH_AUTHORIZATION_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"authorizer","type":"address"},{"internalType":"bytes32","name":"nonce","type":"bytes32"}],"name":"authorizationState","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"_authorizerList","type":"address[]"},{"internalType":"bytes32[]","name":"_nonceList","type":"bytes32[]"},{"internalType":"uint8[]","name":"_vList","type":"uint8[]"},{"internalType":"bytes32[]","name":"_rList","type":"bytes32[]"},{"internalType":"bytes32[]","name":"_sList","type":"bytes32[]"},{"internalType":"bool","name":"_ignoreErrors","type":"bool"}],"name":"batchCancelAuthorization","outputs":[{"internalType":"bool[]","name":"_didCancelList","type":"bool[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"authorizer","type":"address"},{"internalType":"bytes32","name":"nonce","type":"bytes32"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"cancelAuthorization","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_account","type":"address"}],"name":"drain","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"eip712Domain","outputs":[{"internalType":"bytes1","name":"fields","type":"bytes1"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"},{"internalType":"uint256","name":"chainId","type":"uint256"},{"internalType":"address","name":"verifyingContract","type":"address"},{"internalType":"bytes32","name":"salt","type":"bytes32"},{"internalType":"uint256[]","name":"extensions","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"freeze","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"frozen","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_initialOwner","type":"address"},{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"initializeV2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"reallocate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"validAfter","type":"uint256"},{"internalType":"uint256","name":"validBefore","type":"uint256"},{"internalType":"bytes32","name":"nonce","type":"bytes32"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"receiveWithAuthorization","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_token","type":"address"},{"internalType":"address","name":"_recipient","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"recoverERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"validAfter","type":"uint256"},{"internalType":"uint256","name":"validBefore","type":"uint256"},{"internalType":"bytes32","name":"nonce","type":"bytes32"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"transferWithAuthorization","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"unfreeze","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"}],"is_changed_bytecode":false,"is_partially_verified":false,"constructor_args":null}