Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Similar
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.20;

import "./Lins20Factory.sol";
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/utils/math/Math.sol";
import "@openzeppelin/contracts/utils/Pausable.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "./IEthscription.sol";

/**
 * @title Lins20
 * @dev Lins20 is a ERC20 token with inscription.
 */
contract Lins20 is ERC20, Pausable, Ownable, IEthscription {
    uint256 public limit;     // limit per mint
    uint256 public burnsRate; // transfer burns rate 10000 = 100%
    uint256 public fee;       // fee
    uint256 public maxMint;   // max mint， total supply
    string public tick;       // inscription tick
    uint256 public maxMintTimes; // max mint times size for each account
    mapping(address => uint16) public mintTimes; // mint times of each address

    uint256 public current = 0; // current mint
    string public _mintInscription = ""; // mint inscription

    event InscribeMint(address indexed from, string content);
    event InscribeTransfer(address indexed from, string content);

    modifier notContract() {
        require(tx.origin == msg.sender);
        _;
    }

    constructor() ERC20("", "") Ownable(tx.origin) {
        string memory _tick;
        (_tick, limit, maxMint, burnsRate, fee) = Lins20Factory(msg.sender).parameters();
        require(limit != 0, "limit incorrect");
        require(maxMint != 0, "maxMint incorrect");
        require(burnsRate < 10000, "burns out of range");
        require(maxMint % limit == 0, "limit incorrect");

        maxMintTimes = 50;
        tick = _tick;
        _mintInscription = string.concat('data:,{"p":"lins20","op":"mint","tick":"', tick, '","amt":"', Strings.toString(limit/(10 ** decimals())), '"}');
    }

    function symbol() public view override returns (string memory) {
        return tick;
    }

    function name() public view override returns (string memory) {
        return string.concat("inscription ", tick);
    }

    function decimals() public pure override returns (uint8) {
        return 18;
    }

    receive() external payable {
        _doMint();
    }

    function mint() external payable {
        _doMint();
    }

    function mintV2(string memory content)  external payable {
        require(Strings.equal(content, _mintInscription), "inscription incorrect");
        _doMint();
    }

    function _doMint() internal whenNotPaused notContract {
        require(msg.value >= fee, "fee not enough");
        require(limit + current <= maxMint, "mint over");
        require(mintTimes[msg.sender] < maxMintTimes, "max mint times reached");

        _mint(msg.sender, limit);
        current += limit;
        mintTimes[msg.sender] += 1;
        emit InscribeMint(msg.sender, _mintInscription);
        emit ethscriptions_protocol_CreateEthscription(msg.sender, _mintInscription);
    }

    function transfer(address to, uint256 amount) public override whenNotPaused returns (bool) {
        uint256 destory = 0;
        if(burnsRate != 0) {
            destory = Math.mulDiv(amount, burnsRate, 10000);
        }
        require(balanceOf(msg.sender) >= amount, "insufficient balance");

        if(destory != 0) {
            _burn(msg.sender, destory);
        }
        _transfer(msg.sender, to, amount - destory);

        uint256 denominator = 10 ** decimals();
        uint256 fraction = amount % denominator;
        uint256 integer  = amount / denominator;
        string memory value = Strings.toString(integer);
        if(fraction != 0) {
           fraction = fraction / (10 ** (decimals() - 4));
           value = string.concat(value, ".", Strings.toString(fraction));
        }
        string memory ins = string.concat('data:,{"p":"lins20","op":"transfer","tick":"', tick, '","amt":"', value, '","to":"', Strings.toHexString(to), '"}');
        emit InscribeTransfer(msg.sender, ins);
        emit ethscriptions_protocol_TransferEthscriptionForPreviousOwner(msg.sender, to, bytes32(abi.encodePacked(tick)));
        return true;
    }

    function setMaxMintTimes(uint256 times) public onlyOwner {
        maxMintTimes = times;
    }

    function withdraw() public onlyOwner {
        payable(owner()).transfer(address(this).balance);
    }

    /**
     * @notice Pause (admin only)
     */
    function pause() external onlyOwner {
        _pause();
    }

    /**
     * @notice Unpause (admin only)
     */
    function unpause() external onlyOwner {
        _unpause();
    }
}

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

pragma solidity ^0.8.20;

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

/**
 * @dev Contract module which provides access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is specified at deployment time in the constructor for `Ownable`. This
 * can later be changed with {transferOwnership} and {acceptOwnership}.
 *
 * This module is used through inheritance. It will make available all functions
 * from parent (Ownable).
 */
abstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {
    /// @custom:storage-location erc7201:openzeppelin.storage.Ownable2Step
    struct Ownable2StepStorage {
        address _pendingOwner;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Ownable2Step")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant Ownable2StepStorageLocation = 0x237e158222e3e6968b72b9db0d8043aacf074ad9f650f0d1606b4d82ee432c00;

    function _getOwnable2StepStorage() private pure returns (Ownable2StepStorage storage $) {
        assembly {
            $.slot := Ownable2StepStorageLocation
        }
    }

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

    function __Ownable2Step_init() internal onlyInitializing {
    }

    function __Ownable2Step_init_unchained() internal onlyInitializing {
    }
    /**
     * @dev Returns the address of the pending owner.
     */
    function pendingOwner() public view virtual returns (address) {
        Ownable2StepStorage storage $ = _getOwnable2StepStorage();
        return $._pendingOwner;
    }

    /**
     * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual override onlyOwner {
        Ownable2StepStorage storage $ = _getOwnable2StepStorage();
        $._pendingOwner = newOwner;
        emit OwnershipTransferStarted(owner(), newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual override {
        Ownable2StepStorage storage $ = _getOwnable2StepStorage();
        delete $._pendingOwner;
        super._transferOwnership(newOwner);
    }

    /**
     * @dev The new owner accepts the ownership transfer.
     */
    function acceptOwnership() public virtual {
        address sender = _msgSender();
        if (pendingOwner() != sender) {
            revert OwnableUnauthorizedAccount(sender);
        }
        _transferOwnership(sender);
    }
}

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

    function __UUPSUpgradeable_init() internal onlyInitializing {
    }

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

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

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

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

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

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

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

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

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract ContextUpgradeable is Initializable {
    function __Context_init() internal onlyInitializing {
    }

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

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

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

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

pragma solidity ^0.8.20;

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

/**
 * @dev Contract module which allows children to implement an emergency stop
 * mechanism that can be triggered by an authorized account.
 *
 * This module is used through inheritance. It will make available the
 * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
 * the functions of your contract. Note that they will not be pausable by
 * simply including this module, only once the modifiers are put in place.
 */
abstract contract PausableUpgradeable is Initializable, ContextUpgradeable {
    /// @custom:storage-location erc7201:openzeppelin.storage.Pausable
    struct PausableStorage {
        bool _paused;
    }

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Pausable")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant PausableStorageLocation = 0xcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f03300;

    function _getPausableStorage() private pure returns (PausableStorage storage $) {
        assembly {
            $.slot := PausableStorageLocation
        }
    }

    /**
     * @dev Emitted when the pause is triggered by `account`.
     */
    event Paused(address account);

    /**
     * @dev Emitted when the pause is lifted by `account`.
     */
    event Unpaused(address account);

    /**
     * @dev The operation failed because the contract is paused.
     */
    error EnforcedPause();

    /**
     * @dev The operation failed because the contract is not paused.
     */
    error ExpectedPause();

    /**
     * @dev Initializes the contract in unpaused state.
     */
    function __Pausable_init() internal onlyInitializing {
        __Pausable_init_unchained();
    }

    function __Pausable_init_unchained() internal onlyInitializing {
        PausableStorage storage $ = _getPausableStorage();
        $._paused = false;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is not paused.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    modifier whenNotPaused() {
        _requireNotPaused();
        _;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is paused.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    modifier whenPaused() {
        _requirePaused();
        _;
    }

    /**
     * @dev Returns true if the contract is paused, and false otherwise.
     */
    function paused() public view virtual returns (bool) {
        PausableStorage storage $ = _getPausableStorage();
        return $._paused;
    }

    /**
     * @dev Throws if the contract is paused.
     */
    function _requireNotPaused() internal view virtual {
        if (paused()) {
            revert EnforcedPause();
        }
    }

    /**
     * @dev Throws if the contract is not paused.
     */
    function _requirePaused() internal view virtual {
        if (!paused()) {
            revert ExpectedPause();
        }
    }

    /**
     * @dev Triggers stopped state.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    function _pause() internal virtual whenNotPaused {
        PausableStorage storage $ = _getPausableStorage();
        $._paused = true;
        emit Paused(_msgSender());
    }

    /**
     * @dev Returns to normal state.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    function _unpause() internal virtual whenPaused {
        PausableStorage storage $ = _getPausableStorage();
        $._paused = false;
        emit Unpaused(_msgSender());
    }
}

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

pragma solidity ^0.8.20;

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

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

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

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

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

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    constructor(address initialOwner) {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

pragma solidity ^0.8.20;

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

/**
 * @dev This abstract contract provides getters and event emitting update functions for
 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
 */
library ERC1967Utils {
    // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
    // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
    /**
     * @dev Emitted when the implementation is upgraded.
     */
    event Upgraded(address indexed implementation);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

        StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

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

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

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

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

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

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

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

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

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

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

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

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

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

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

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

        emit Transfer(from, to, value);
    }

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

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

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

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

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     */
    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
        if (address(this).balance < value) {
            revert AddressInsufficientBalance(address(this));
        }
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata);
    }

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

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

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

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

    /**
     * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
     */
    function _revert(bytes memory returndata) private pure {
        // Look for revert reason and bubble it up if present
        if (returndata.length > 0) {
            // The easiest way to bubble the revert reason is using memory via assembly
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert FailedInnerCall();
        }
    }
}

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

pragma solidity ^0.8.20;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

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

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

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

pragma solidity ^0.8.20;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    /**
     * @dev Muldiv operation overflow.
     */
    error MathOverflowedMulDiv();

    enum Rounding {
        Floor, // Toward negative infinity
        Ceil, // Toward positive infinity
        Trunc, // Toward zero
        Expand // Away from zero
    }

    /**
     * @dev Returns the addition of two unsigned integers, with an overflow flag.
     */
    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            uint256 c = a + b;
            if (c < a) return (false, 0);
            return (true, c);
        }
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, with an overflow flag.
     */
    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b > a) return (false, 0);
            return (true, a - b);
        }
    }

    /**
     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
     */
    function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) return (true, 0);
            uint256 c = a * b;
            if (c / a != b) return (false, 0);
            return (true, c);
        }
    }

    /**
     * @dev Returns the division of two unsigned integers, with a division by zero flag.
     */
    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b == 0) return (false, 0);
            return (true, a / b);
        }
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
     */
    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b == 0) return (false, 0);
            return (true, a % b);
        }
    }

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

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

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

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds towards infinity instead
     * of rounding towards zero.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        if (b == 0) {
            // Guarantee the same behavior as in a regular Solidity division.
            return a / b;
        }

        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

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

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                // The surrounding unchecked block does not change this fact.
                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            if (denominator <= prod1) {
                revert MathOverflowedMulDiv();
            }

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

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

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

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

            uint256 twos = denominator & (0 - denominator);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    /**
     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
     */
    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
        return uint8(rounding) % 2 == 1;
    }
}

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

pragma solidity ^0.8.20;

/**
 * @dev Standard signed math utilities missing in the Solidity language.
 */
library SignedMath {
    /**
     * @dev Returns the largest of two signed numbers.
     */
    function max(int256 a, int256 b) internal pure returns (int256) {
        return a > b ? a : b;
    }

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

    /**
     * @dev Returns the average of two signed numbers without overflow.
     * The result is rounded towards zero.
     */
    function average(int256 a, int256 b) internal pure returns (int256) {
        // Formula from the book "Hacker's Delight"
        int256 x = (a & b) + ((a ^ b) >> 1);
        return x + (int256(uint256(x) >> 255) & (a ^ b));
    }

    /**
     * @dev Returns the absolute unsigned value of a signed value.
     */
    function abs(int256 n) internal pure returns (uint256) {
        unchecked {
            // must be unchecked in order to support `n = type(int256).min`
            return uint256(n >= 0 ? n : -n);
        }
    }
}

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

pragma solidity ^0.8.20;

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

/**
 * @dev Contract module which allows children to implement an emergency stop
 * mechanism that can be triggered by an authorized account.
 *
 * This module is used through inheritance. It will make available the
 * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
 * the functions of your contract. Note that they will not be pausable by
 * simply including this module, only once the modifiers are put in place.
 */
abstract contract Pausable is Context {
    bool private _paused;

    /**
     * @dev Emitted when the pause is triggered by `account`.
     */
    event Paused(address account);

    /**
     * @dev Emitted when the pause is lifted by `account`.
     */
    event Unpaused(address account);

    /**
     * @dev The operation failed because the contract is paused.
     */
    error EnforcedPause();

    /**
     * @dev The operation failed because the contract is not paused.
     */
    error ExpectedPause();

    /**
     * @dev Initializes the contract in unpaused state.
     */
    constructor() {
        _paused = false;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is not paused.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    modifier whenNotPaused() {
        _requireNotPaused();
        _;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is paused.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    modifier whenPaused() {
        _requirePaused();
        _;
    }

    /**
     * @dev Returns true if the contract is paused, and false otherwise.
     */
    function paused() public view virtual returns (bool) {
        return _paused;
    }

    /**
     * @dev Throws if the contract is paused.
     */
    function _requireNotPaused() internal view virtual {
        if (paused()) {
            revert EnforcedPause();
        }
    }

    /**
     * @dev Throws if the contract is not paused.
     */
    function _requirePaused() internal view virtual {
        if (!paused()) {
            revert ExpectedPause();
        }
    }

    /**
     * @dev Triggers stopped state.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    function _pause() internal virtual whenNotPaused {
        _paused = true;
        emit Paused(_msgSender());
    }

    /**
     * @dev Returns to normal state.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    function _unpause() internal virtual whenPaused {
        _paused = false;
        emit Unpaused(_msgSender());
    }
}

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

pragma solidity ^0.8.20;

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

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 value;
    }

    struct StringSlot {
        string value;
    }

    struct BytesSlot {
        bytes value;
    }

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

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

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

import {Math} from "./math/Math.sol";
import {SignedMath} from "./math/SignedMath.sol";

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant HEX_DIGITS = "0123456789abcdef";
    uint8 private constant ADDRESS_LENGTH = 20;

    /**
     * @dev The `value` string doesn't fit in the specified `length`.
     */
    error StringsInsufficientHexLength(uint256 value, uint256 length);

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

    /**
     * @dev Converts a `int256` to its ASCII `string` decimal representation.
     */
    function toStringSigned(int256 value) internal pure returns (string memory) {
        return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value)));
    }

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

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

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

    /**
     * @dev Returns true if the two strings are equal.
     */
    function equal(string memory a, string memory b) internal pure returns (bool) {
        return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b));
    }
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.20;

interface IEthscription {
    event ethscriptions_protocol_CreateEthscription(
        address indexed initialOwner,
        string contentURI
    );

    event ethscriptions_protocol_TransferEthscriptionForPreviousOwner(
        address indexed previousOwner,
        address indexed recipient,
        bytes32 indexed id
    );
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.20;

import "./Lins20.sol";
import "@openzeppelin/contracts/utils/Pausable.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/utils/math/Math.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/utils/PausableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol";


contract Lins20Factory is Initializable, PausableUpgradeable, Ownable2StepUpgradeable, UUPSUpgradeable {
    struct Parameters {
        string tick;         // inscription tick
        uint256 limit;       // limit per mint
        uint256 totalSupply; // total supply
        uint256 burnsRate;   // transfer burns rate  10000 = 100%
        uint256 fee;         // mint fee
    }

    Parameters public parameters;
    mapping(string => address) public inscriptions;
    event InscribeDeploy(address indexed from, string content);
    event AddInscription(string tick, address indexed addr);


    function initialize() public initializer {
        __Pausable_init();
        __Ownable_init(_msgSender());
        __UUPSUpgradeable_init();
    }

    /*
     * create new inscription
     * @param tick Tick
     * @param limit Limit per mint
     * @param totalSupply Total supply
     * @param burnsRate transfer burns rate  10000 = 100%
     * @param fee Fee
     */
    function createLins20(
        string memory tick,
        uint256 limit,
        uint256 totalSupply,
        uint256 burnsRate,
        uint256 fee
    ) external whenNotPaused returns (address lins20) {
        require(burnsRate < 10000, "burns out of range");
        require(limit < totalSupply, "limit out of range");
        require(inscriptions[tick] == address(0), "tick exists");
        require(totalSupply % limit == 0, "limit incorrect");

        parameters = Parameters({tick: tick, limit: limit, totalSupply: totalSupply, burnsRate: burnsRate, fee: fee});
        lins20 = address(new Lins20{salt: keccak256(abi.encode(tick, limit, totalSupply, burnsRate, fee))}());
        inscriptions[tick] = lins20;

        uint256 decimals = 10 ** 18;
        delete parameters;
        string memory ins = string.concat('data:,{"p":"lins20","op":"deploy","tick":"', tick, '","max":"', Strings.toString(totalSupply / decimals), '","lim":"', Strings.toString(limit / decimals), '"}');
        emit InscribeDeploy(msg.sender, ins);
    }


    /**
     * @notice Pause (admin only)
     */
    function pause() external onlyOwner {
        _pause();
    }

    /**
     * @notice Unpause (admin only)
     */
    function unpause() external onlyOwner {
        _unpause();
    }

    function _authorizeUpgrade(
        address newImplementation
    ) internal override onlyOwner {}

}

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

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","type":"error"},{"inputs":[],"name":"EnforcedPause","type":"error"},{"inputs":[],"name":"ExpectedPause","type":"error"},{"inputs":[],"name":"MathOverflowedMulDiv","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"length","type":"uint256"}],"name":"StringsInsufficientHexLength","type":"error"},{"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":"from","type":"address"},{"indexed":false,"internalType":"string","name":"content","type":"string"}],"name":"InscribeMint","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":false,"internalType":"string","name":"content","type":"string"}],"name":"InscribeTransfer","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":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"initialOwner","type":"address"},{"indexed":false,"internalType":"string","name":"contentURI","type":"string"}],"name":"ethscriptions_protocol_CreateEthscription","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":true,"internalType":"bytes32","name":"id","type":"bytes32"}],"name":"ethscriptions_protocol_TransferEthscriptionForPreviousOwner","type":"event"},{"inputs":[],"name":"_mintInscription","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","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":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"burnsRate","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"current","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"fee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"limit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxMintTimes","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"mintTimes","outputs":[{"internalType":"uint16","name":"","type":"uint16"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"content","type":"string"}],"name":"mintV2","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"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":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"times","type":"uint256"}],"name":"setMaxMintTimes","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tick","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":"value","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":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}]

0x6000600d81905560a06040526080908152600e906200001f90826200054d565b503480156200002d57600080fd5b50604080516020808201835260008083528351918201909352918252329160036200005983826200054d565b5060046200006882826200054d565b50506005805460ff19169055506001600160a01b038116620000a557604051631e4fbdf760e01b8152600060048201526024015b60405180910390fd5b620000b081620002cb565b506060336001600160a01b031663890357306040518163ffffffff1660e01b8152600401600060405180830381865afa158015620000f2573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526200011c91908101906200063f565b6008556007556009556006819055909150600003620001705760405162461bcd60e51b815260206004820152600f60248201526e1b1a5b5a5d081a5b98dbdc9c9958dd608a1b60448201526064016200009c565b600954600003620001b85760405162461bcd60e51b81526020600482015260116024820152701b585e135a5b9d081a5b98dbdc9c9958dd607a1b60448201526064016200009c565b61271060075410620002025760405162461bcd60e51b81526020600482015260126024820152716275726e73206f7574206f662072616e676560701b60448201526064016200009c565b60065460095462000214919062000732565b15620002555760405162461bcd60e51b815260206004820152600f60248201526e1b1a5b5a5d081a5b98dbdc9c9958dd608a1b60448201526064016200009c565b6032600b55600a6200026882826200054d565b50600a620002916200027c6012836200085c565b6006546200028b919062000874565b62000325565b604051602001620002a4929190620008a9565b604051602081830303815290604052600e9081620002c391906200054d565b50506200099f565b600580546001600160a01b03838116610100818102610100600160a81b031985161790945560405193909204169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b606060006200033483620003be565b60010190506000816001600160401b03811115620003565762000356620004a8565b6040519080825280601f01601f19166020018201604052801562000381576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a85049450846200038b57509392505050565b6000807a184f03e93ff9f4daa797ed6e38ed64bf6a1f010000000000000000831062000408577a184f03e93ff9f4daa797ed6e38ed64bf6a1f010000000000000000830492506040015b6d04ee2d6d415b85acef8100000000831062000435576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106200045457662386f26fc10000830492506010015b6305f5e10083106200046d576305f5e100830492506008015b61271083106200048257612710830492506004015b6064831062000495576064830492506002015b600a8310620004a2576001015b92915050565b634e487b7160e01b600052604160045260246000fd5b600181811c90821680620004d357607f821691505b602082108103620004f457634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200054857600081815260208120601f850160051c81016020861015620005235750805b601f850160051c820191505b8181101562000544578281556001016200052f565b5050505b505050565b81516001600160401b03811115620005695762000569620004a8565b62000581816200057a8454620004be565b84620004fa565b602080601f831160018114620005b95760008415620005a05750858301515b600019600386901b1c1916600185901b17855562000544565b600085815260208120601f198616915b82811015620005ea57888601518255948401946001909101908401620005c9565b5085821015620006095787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60005b83811015620006365781810151838201526020016200061c565b50506000910152565b600080600080600060a086880312156200065857600080fd5b85516001600160401b03808211156200067057600080fd5b818801915088601f8301126200068557600080fd5b8151818111156200069a576200069a620004a8565b604051601f8201601f19908116603f01168101908382118183101715620006c557620006c5620004a8565b816040528281528b6020848701011115620006df57600080fd5b620006f283602083016020880162000619565b60208b015160408c015160608d01516080909d0151929e919d509b9a509098509650505050505050565b634e487b7160e01b600052601260045260246000fd5b6000826200074457620007446200071c565b500690565b634e487b7160e01b600052601160045260246000fd5b600181815b80851115620007a057816000190482111562000784576200078462000749565b808516156200079257918102915b93841c939080029062000764565b509250929050565b600082620007b957506001620004a2565b81620007c857506000620004a2565b8160018114620007e15760028114620007ec576200080c565b6001915050620004a2565b60ff84111562000800576200080062000749565b50506001821b620004a2565b5060208310610133831016604e8410600b841016171562000831575081810a620004a2565b6200083d83836200075f565b806000190482111562000854576200085462000749565b029392505050565b60006200086d60ff841683620007a8565b9392505050565b6000826200088657620008866200071c565b500490565b600081516200089f81856020860162000619565b9290920192915050565b7f646174613a2c7b2270223a226c696e733230222c226f70223a226d696e74222c81526000602067113a34b1b5911d1160c11b81840152602860008654620008f181620004be565b600182811680156200090c5760018114620009265762000958565b60ff19841689870152821515830289018601945062000958565b8a6000528660002060005b848110156200094e5781548b820189015290830190880162000931565b505085838a010194505b5050505062000972816811161130b6ba111d1160b91b9052565b6200098160098201876200088b565b92505050620009948161227d60f01b9052565b600201949350505050565b611bb280620009af6000396000f3fe6080604052600436106101bb5760003560e01c80638795341e116100ec578063a62859db1161008a578063d784ba4511610064578063d784ba4514610465578063dd62ed3e146104a9578063ddca3f43146104ef578063f2fde38b1461050557600080fd5b8063a62859db14610410578063a9059cbb14610430578063bb53f4ba1461045057600080fd5b806395952097116100c657806395952097146103bc57806395d89b41146103cf5780639fa6a6e3146103e4578063a4d66daf146103fa57600080fd5b80638795341e1461035a57806387ef4714146103705780638da5cb5b1461038657600080fd5b80633eaf5d9f1161015957806370a082311161013357806370a08231146102e4578063715018a61461031a5780637501f7411461032f5780638456cb591461034557600080fd5b80633eaf5d9f146102a25780633f4ba83a146102b75780635c975abb146102cc57600080fd5b806318160ddd1161019557806318160ddd1461023257806323b872dd14610251578063313ce567146102715780633ccfd60b1461028d57600080fd5b806306fdde03146101cf578063095ea7b3146101fa5780631249c58b1461022a57600080fd5b366101ca576101c8610525565b005b600080fd5b3480156101db57600080fd5b506101e4610714565b6040516101f1919061153a565b60405180910390f35b34801561020657600080fd5b5061021a610215366004611589565b61073c565b60405190151581526020016101f1565b6101c8610756565b34801561023e57600080fd5b506002545b6040519081526020016101f1565b34801561025d57600080fd5b5061021a61026c3660046115b3565b610760565b34801561027d57600080fd5b50604051601281526020016101f1565b34801561029957600080fd5b506101c8610786565b3480156102ae57600080fd5b506101e46107d1565b3480156102c357600080fd5b506101c861085f565b3480156102d857600080fd5b5060055460ff1661021a565b3480156102f057600080fd5b506102436102ff3660046115ef565b6001600160a01b031660009081526020819052604090205490565b34801561032657600080fd5b506101c861086f565b34801561033b57600080fd5b5061024360095481565b34801561035157600080fd5b506101c8610881565b34801561036657600080fd5b5061024360075481565b34801561037c57600080fd5b50610243600b5481565b34801561039257600080fd5b5060055461010090046001600160a01b03166040516001600160a01b0390911681526020016101f1565b6101c86103ca366004611620565b610891565b3480156103db57600080fd5b506101e4610971565b3480156103f057600080fd5b50610243600d5481565b34801561040657600080fd5b5061024360065481565b34801561041c57600080fd5b506101c861042b3660046116d1565b610a03565b34801561043c57600080fd5b5061021a61044b366004611589565b610a10565b34801561045c57600080fd5b506101e4610c22565b34801561047157600080fd5b506104966104803660046115ef565b600c6020526000908152604090205461ffff1681565b60405161ffff90911681526020016101f1565b3480156104b557600080fd5b506102436104c43660046116ea565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b3480156104fb57600080fd5b5061024360085481565b34801561051157600080fd5b506101c86105203660046115ef565b610c2f565b61052d610c6a565b32331461053957600080fd5b6008543410156105815760405162461bcd60e51b815260206004820152600e60248201526d0cccaca40dcdee840cadcdeeaced60931b60448201526064015b60405180910390fd5b600954600d546006546105949190611733565b11156105ce5760405162461bcd60e51b815260206004820152600960248201526836b4b73a1037bb32b960b91b6044820152606401610578565b600b54336000908152600c602052604090205461ffff161061062b5760405162461bcd60e51b81526020600482015260166024820152751b585e081b5a5b9d081d1a5b595cc81c995858da195960521b6044820152606401610578565b61063733600654610c8e565b600654600d600082825461064b9190611733565b9091555050336000908152600c6020526040812080546001929061067490849061ffff16611746565b92506101000a81548161ffff021916908361ffff160217905550336001600160a01b03167f8855a459cb18458a02ceb534d8563f96a940643e60101d18a8f873d66b2b33c4600e6040516106c891906117a2565b60405180910390a2336001600160a01b03167f665fba0baf3dc33e9943340197893ac16f56482c2defb8de60f944987fee451c600e60405161070a91906117a2565b60405180910390a2565b6060600a60405160200161072891906118a0565b604051602081830303815290604052905090565b60003361074a818585610cc8565b60019150505b92915050565b61075e610525565b565b60003361076e858285610cda565b610779858585610d58565b60019150505b9392505050565b61078e610db7565b6005546040516001600160a01b0361010090920491909116904780156108fc02916000818181858888f193505050501580156107ce573d6000803e3d6000fd5b50565b600a80546107de90611768565b80601f016020809104026020016040519081016040528092919081815260200182805461080a90611768565b80156108575780601f1061082c57610100808354040283529160200191610857565b820191906000526020600020905b81548152906001019060200180831161083a57829003601f168201915b505050505081565b610867610db7565b61075e610dea565b610877610db7565b61075e6000610e3c565b610889610db7565b61075e610e96565b61092581600e80546108a290611768565b80601f01602080910402602001604051908101604052809291908181526020018280546108ce90611768565b801561091b5780601f106108f05761010080835404028352916020019161091b565b820191906000526020600020905b8154815290600101906020018083116108fe57829003601f168201915b5050505050610ed3565b6109695760405162461bcd60e51b81526020600482015260156024820152741a5b9cd8dc9a5c1d1a5bdb881a5b98dbdc9c9958dd605a1b6044820152606401610578565b6107ce610525565b6060600a805461098090611768565b80601f01602080910402602001604051908101604052809291908181526020018280546109ac90611768565b80156109f95780601f106109ce576101008083540402835291602001916109f9565b820191906000526020600020905b8154815290600101906020018083116109dc57829003601f168201915b5050505050905090565b610a0b610db7565b600b55565b6000610a1a610c6a565b6000600754600014610a3857610a3583600754612710610ef9565b90505b33600090815260208190526040902054831115610a8e5760405162461bcd60e51b8152602060048201526014602482015273696e73756666696369656e742062616c616e636560601b6044820152606401610578565b8015610a9e57610a9e3382610fbd565b610ab23385610aad84876118c1565b610d58565b6000610ac06012600a6119b8565b90506000610ace82866119dd565b90506000610adc83876119f1565b90506000610ae982610ff3565b90508215610b4157610afd60046012611a05565b610b0890600a6119b8565b610b1290846119f1565b925080610b1e84610ff3565b604051602001610b2f929190611a1e565b60405160208183030381529060405290505b6000600a82610b4f8b611086565b604051602001610b6193929190611a5a565b6040516020818303038152906040529050336001600160a01b03167f73a34ec193e960ca08b851bf76f3abcaa8afcadbaf40a38afed58411ddd798cc82604051610bab919061153a565b60405180910390a2600a604051602001610bc59190611b08565b604051602081830303815290604052610bdd90611b14565b6040516001600160a01b038b169033907ff1d95ed4d1680e6f665104f19c296ae52c1f64cd8114e84d55dc6349dbdafea390600090a450600198975050505050505050565b600e80546107de90611768565b610c37610db7565b6001600160a01b038116610c6157604051631e4fbdf760e01b815260006004820152602401610578565b6107ce81610e3c565b60055460ff161561075e5760405163d93c066560e01b815260040160405180910390fd5b6001600160a01b038216610cb85760405163ec442f0560e01b815260006004820152602401610578565b610cc46000838361109c565b5050565b610cd583838360016111c6565b505050565b6001600160a01b038381166000908152600160209081526040808320938616835292905220546000198114610d525781811015610d4357604051637dc7a0d960e11b81526001600160a01b03841660048201526024810182905260448101839052606401610578565b610d52848484840360006111c6565b50505050565b6001600160a01b038316610d8257604051634b637e8f60e11b815260006004820152602401610578565b6001600160a01b038216610dac5760405163ec442f0560e01b815260006004820152602401610578565b610cd583838361109c565b6005546001600160a01b0361010090910416331461075e5760405163118cdaa760e01b8152336004820152602401610578565b610df261129b565b6005805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600580546001600160a01b03838116610100818102610100600160a81b031985161790945560405193909204169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b610e9e610c6a565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610e1f3390565b60008151835114801561077f575081805190602001208380519060200120149392505050565b6000838302816000198587098281108382030391505080600003610f3057838281610f2657610f266119c7565b049250505061077f565b808411610f505760405163227bc15360e01b815260040160405180910390fd5b6000848688096000868103871696879004966002600389028118808a02820302808a02820302808a02820302808a02820302808a02820302808a02909103029181900381900460010186841190950394909402919094039290920491909117919091029150509392505050565b6001600160a01b038216610fe757604051634b637e8f60e11b815260006004820152602401610578565b610cc48260008361109c565b60606000611000836112be565b600101905060008167ffffffffffffffff8111156110205761102061160a565b6040519080825280601f01601f19166020018201604052801561104a576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461105457509392505050565b60606107506001600160a01b0383166014611396565b6001600160a01b0383166110c75780600260008282546110bc9190611733565b909155506111399050565b6001600160a01b0383166000908152602081905260409020548181101561111a5760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610578565b6001600160a01b03841660009081526020819052604090209082900390555b6001600160a01b03821661115557600280548290039055611174565b6001600160a01b03821660009081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516111b991815260200190565b60405180910390a3505050565b6001600160a01b0384166111f05760405163e602df0560e01b815260006004820152602401610578565b6001600160a01b03831661121a57604051634a1406b160e11b815260006004820152602401610578565b6001600160a01b0380851660009081526001602090815260408083209387168352929052208290558015610d5257826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258460405161128d91815260200190565b60405180910390a350505050565b60055460ff1661075e57604051638dfc202b60e01b815260040160405180910390fd5b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b83106112fd5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310611329576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc10000831061134757662386f26fc10000830492506010015b6305f5e100831061135f576305f5e100830492506008015b612710831061137357612710830492506004015b60648310611385576064830492506002015b600a83106107505760010192915050565b60608260006113a6846002611b38565b6113b1906002611733565b67ffffffffffffffff8111156113c9576113c961160a565b6040519080825280601f01601f1916602001820160405280156113f3576020820181803683370190505b509050600360fc1b8160008151811061140e5761140e611b4f565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061143d5761143d611b4f565b60200101906001600160f81b031916908160001a9053506000611461856002611b38565b61146c906001611733565b90505b60018111156114e4576f181899199a1a9b1b9c1cb0b131b232b360811b83600f16601081106114a0576114a0611b4f565b1a60f81b8282815181106114b6576114b6611b4f565b60200101906001600160f81b031916908160001a90535060049290921c916114dd81611b65565b905061146f565b50811561150e5760405163e22e27eb60e01b81526004810186905260248101859052604401610578565b949350505050565b60005b83811015611531578181015183820152602001611519565b50506000910152565b6020815260008251806020840152611559816040850160208701611516565b601f01601f19169190910160400192915050565b80356001600160a01b038116811461158457600080fd5b919050565b6000806040838503121561159c57600080fd5b6115a58361156d565b946020939093013593505050565b6000806000606084860312156115c857600080fd5b6115d18461156d565b92506115df6020850161156d565b9150604084013590509250925092565b60006020828403121561160157600080fd5b61077f8261156d565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561163257600080fd5b813567ffffffffffffffff8082111561164a57600080fd5b818401915084601f83011261165e57600080fd5b8135818111156116705761167061160a565b604051601f8201601f19908116603f011681019083821181831017156116985761169861160a565b816040528281528760208487010111156116b157600080fd5b826020860160208301376000928101602001929092525095945050505050565b6000602082840312156116e357600080fd5b5035919050565b600080604083850312156116fd57600080fd5b6117068361156d565b91506117146020840161156d565b90509250929050565b634e487b7160e01b600052601160045260246000fd5b808201808211156107505761075061171d565b61ffff8181168382160190808211156117615761176161171d565b5092915050565b600181811c9082168061177c57607f821691505b60208210810361179c57634e487b7160e01b600052602260045260246000fd5b50919050565b60006020808352600084546117b681611768565b808487015260406001808416600081146117d757600181146117f15761181f565b60ff1985168984015283151560051b89018301955061181f565b896000528660002060005b858110156118175781548b82018601529083019088016117fc565b8a0184019650505b509398975050505050505050565b6000815461183a81611768565b60018281168015611852576001811461186757611896565b60ff1984168752821515830287019450611896565b8560005260208060002060005b8581101561188d5781548a820152908401908201611874565b50505082870194505b5050505092915050565b6b034b739b1b934b83a34b7b7160a51b8152600061077f600c83018461182d565b818103818111156107505761075061171d565b600181815b8085111561190f5781600019048211156118f5576118f561171d565b8085161561190257918102915b93841c93908002906118d9565b509250929050565b60008261192657506001610750565b8161193357506000610750565b816001811461194957600281146119535761196f565b6001915050610750565b60ff8411156119645761196461171d565b50506001821b610750565b5060208310610133831016604e8410600b8410161715611992575081810a610750565b61199c83836118d4565b80600019048211156119b0576119b061171d565b029392505050565b600061077f60ff841683611917565b634e487b7160e01b600052601260045260246000fd5b6000826119ec576119ec6119c7565b500690565b600082611a0057611a006119c7565b500490565b60ff82811682821603908111156107505761075061171d565b60008351611a30818460208801611516565b601760f91b9083019081528351611a4e816001840160208801611516565b01600101949350505050565b7f646174613a2c7b2270223a226c696e733230222c226f70223a227472616e736681526b32b91116113a34b1b5911d1160a11b60208201526000611aa1602c83018661182d565b6811161130b6ba111d1160b91b81528451611ac3816009840160208901611516565b671116113a37911d1160c11b600992909101918201528351611aec816011840160208801611516565b61227d60f01b6011929091019182015260130195945050505050565b600061077f828461182d565b8051602080830151919081101561179c5760001960209190910360031b1b16919050565b80820281158282048414176107505761075061171d565b634e487b7160e01b600052603260045260246000fd5b600081611b7457611b7461171d565b50600019019056fea264697066735822122014249557772bc33d10b4cd5a890c4967736824170ee7a8e82af76ff9afaa567764736f6c63430008140033

0x6080604052600436106101bb5760003560e01c80638795341e116100ec578063a62859db1161008a578063d784ba4511610064578063d784ba4514610465578063dd62ed3e146104a9578063ddca3f43146104ef578063f2fde38b1461050557600080fd5b8063a62859db14610410578063a9059cbb14610430578063bb53f4ba1461045057600080fd5b806395952097116100c657806395952097146103bc57806395d89b41146103cf5780639fa6a6e3146103e4578063a4d66daf146103fa57600080fd5b80638795341e1461035a57806387ef4714146103705780638da5cb5b1461038657600080fd5b80633eaf5d9f1161015957806370a082311161013357806370a08231146102e4578063715018a61461031a5780637501f7411461032f5780638456cb591461034557600080fd5b80633eaf5d9f146102a25780633f4ba83a146102b75780635c975abb146102cc57600080fd5b806318160ddd1161019557806318160ddd1461023257806323b872dd14610251578063313ce567146102715780633ccfd60b1461028d57600080fd5b806306fdde03146101cf578063095ea7b3146101fa5780631249c58b1461022a57600080fd5b366101ca576101c8610525565b005b600080fd5b3480156101db57600080fd5b506101e4610714565b6040516101f1919061153a565b60405180910390f35b34801561020657600080fd5b5061021a610215366004611589565b61073c565b60405190151581526020016101f1565b6101c8610756565b34801561023e57600080fd5b506002545b6040519081526020016101f1565b34801561025d57600080fd5b5061021a61026c3660046115b3565b610760565b34801561027d57600080fd5b50604051601281526020016101f1565b34801561029957600080fd5b506101c8610786565b3480156102ae57600080fd5b506101e46107d1565b3480156102c357600080fd5b506101c861085f565b3480156102d857600080fd5b5060055460ff1661021a565b3480156102f057600080fd5b506102436102ff3660046115ef565b6001600160a01b031660009081526020819052604090205490565b34801561032657600080fd5b506101c861086f565b34801561033b57600080fd5b5061024360095481565b34801561035157600080fd5b506101c8610881565b34801561036657600080fd5b5061024360075481565b34801561037c57600080fd5b50610243600b5481565b34801561039257600080fd5b5060055461010090046001600160a01b03166040516001600160a01b0390911681526020016101f1565b6101c86103ca366004611620565b610891565b3480156103db57600080fd5b506101e4610971565b3480156103f057600080fd5b50610243600d5481565b34801561040657600080fd5b5061024360065481565b34801561041c57600080fd5b506101c861042b3660046116d1565b610a03565b34801561043c57600080fd5b5061021a61044b366004611589565b610a10565b34801561045c57600080fd5b506101e4610c22565b34801561047157600080fd5b506104966104803660046115ef565b600c6020526000908152604090205461ffff1681565b60405161ffff90911681526020016101f1565b3480156104b557600080fd5b506102436104c43660046116ea565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205490565b3480156104fb57600080fd5b5061024360085481565b34801561051157600080fd5b506101c86105203660046115ef565b610c2f565b61052d610c6a565b32331461053957600080fd5b6008543410156105815760405162461bcd60e51b815260206004820152600e60248201526d0cccaca40dcdee840cadcdeeaced60931b60448201526064015b60405180910390fd5b600954600d546006546105949190611733565b11156105ce5760405162461bcd60e51b815260206004820152600960248201526836b4b73a1037bb32b960b91b6044820152606401610578565b600b54336000908152600c602052604090205461ffff161061062b5760405162461bcd60e51b81526020600482015260166024820152751b585e081b5a5b9d081d1a5b595cc81c995858da195960521b6044820152606401610578565b61063733600654610c8e565b600654600d600082825461064b9190611733565b9091555050336000908152600c6020526040812080546001929061067490849061ffff16611746565b92506101000a81548161ffff021916908361ffff160217905550336001600160a01b03167f8855a459cb18458a02ceb534d8563f96a940643e60101d18a8f873d66b2b33c4600e6040516106c891906117a2565b60405180910390a2336001600160a01b03167f665fba0baf3dc33e9943340197893ac16f56482c2defb8de60f944987fee451c600e60405161070a91906117a2565b60405180910390a2565b6060600a60405160200161072891906118a0565b604051602081830303815290604052905090565b60003361074a818585610cc8565b60019150505b92915050565b61075e610525565b565b60003361076e858285610cda565b610779858585610d58565b60019150505b9392505050565b61078e610db7565b6005546040516001600160a01b0361010090920491909116904780156108fc02916000818181858888f193505050501580156107ce573d6000803e3d6000fd5b50565b600a80546107de90611768565b80601f016020809104026020016040519081016040528092919081815260200182805461080a90611768565b80156108575780601f1061082c57610100808354040283529160200191610857565b820191906000526020600020905b81548152906001019060200180831161083a57829003601f168201915b505050505081565b610867610db7565b61075e610dea565b610877610db7565b61075e6000610e3c565b610889610db7565b61075e610e96565b61092581600e80546108a290611768565b80601f01602080910402602001604051908101604052809291908181526020018280546108ce90611768565b801561091b5780601f106108f05761010080835404028352916020019161091b565b820191906000526020600020905b8154815290600101906020018083116108fe57829003601f168201915b5050505050610ed3565b6109695760405162461bcd60e51b81526020600482015260156024820152741a5b9cd8dc9a5c1d1a5bdb881a5b98dbdc9c9958dd605a1b6044820152606401610578565b6107ce610525565b6060600a805461098090611768565b80601f01602080910402602001604051908101604052809291908181526020018280546109ac90611768565b80156109f95780601f106109ce576101008083540402835291602001916109f9565b820191906000526020600020905b8154815290600101906020018083116109dc57829003601f168201915b5050505050905090565b610a0b610db7565b600b55565b6000610a1a610c6a565b6000600754600014610a3857610a3583600754612710610ef9565b90505b33600090815260208190526040902054831115610a8e5760405162461bcd60e51b8152602060048201526014602482015273696e73756666696369656e742062616c616e636560601b6044820152606401610578565b8015610a9e57610a9e3382610fbd565b610ab23385610aad84876118c1565b610d58565b6000610ac06012600a6119b8565b90506000610ace82866119dd565b90506000610adc83876119f1565b90506000610ae982610ff3565b90508215610b4157610afd60046012611a05565b610b0890600a6119b8565b610b1290846119f1565b925080610b1e84610ff3565b604051602001610b2f929190611a1e565b60405160208183030381529060405290505b6000600a82610b4f8b611086565b604051602001610b6193929190611a5a565b6040516020818303038152906040529050336001600160a01b03167f73a34ec193e960ca08b851bf76f3abcaa8afcadbaf40a38afed58411ddd798cc82604051610bab919061153a565b60405180910390a2600a604051602001610bc59190611b08565b604051602081830303815290604052610bdd90611b14565b6040516001600160a01b038b169033907ff1d95ed4d1680e6f665104f19c296ae52c1f64cd8114e84d55dc6349dbdafea390600090a450600198975050505050505050565b600e80546107de90611768565b610c37610db7565b6001600160a01b038116610c6157604051631e4fbdf760e01b815260006004820152602401610578565b6107ce81610e3c565b60055460ff161561075e5760405163d93c066560e01b815260040160405180910390fd5b6001600160a01b038216610cb85760405163ec442f0560e01b815260006004820152602401610578565b610cc46000838361109c565b5050565b610cd583838360016111c6565b505050565b6001600160a01b038381166000908152600160209081526040808320938616835292905220546000198114610d525781811015610d4357604051637dc7a0d960e11b81526001600160a01b03841660048201526024810182905260448101839052606401610578565b610d52848484840360006111c6565b50505050565b6001600160a01b038316610d8257604051634b637e8f60e11b815260006004820152602401610578565b6001600160a01b038216610dac5760405163ec442f0560e01b815260006004820152602401610578565b610cd583838361109c565b6005546001600160a01b0361010090910416331461075e5760405163118cdaa760e01b8152336004820152602401610578565b610df261129b565b6005805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600580546001600160a01b03838116610100818102610100600160a81b031985161790945560405193909204169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b610e9e610c6a565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610e1f3390565b60008151835114801561077f575081805190602001208380519060200120149392505050565b6000838302816000198587098281108382030391505080600003610f3057838281610f2657610f266119c7565b049250505061077f565b808411610f505760405163227bc15360e01b815260040160405180910390fd5b6000848688096000868103871696879004966002600389028118808a02820302808a02820302808a02820302808a02820302808a02820302808a02909103029181900381900460010186841190950394909402919094039290920491909117919091029150509392505050565b6001600160a01b038216610fe757604051634b637e8f60e11b815260006004820152602401610578565b610cc48260008361109c565b60606000611000836112be565b600101905060008167ffffffffffffffff8111156110205761102061160a565b6040519080825280601f01601f19166020018201604052801561104a576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461105457509392505050565b60606107506001600160a01b0383166014611396565b6001600160a01b0383166110c75780600260008282546110bc9190611733565b909155506111399050565b6001600160a01b0383166000908152602081905260409020548181101561111a5760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610578565b6001600160a01b03841660009081526020819052604090209082900390555b6001600160a01b03821661115557600280548290039055611174565b6001600160a01b03821660009081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516111b991815260200190565b60405180910390a3505050565b6001600160a01b0384166111f05760405163e602df0560e01b815260006004820152602401610578565b6001600160a01b03831661121a57604051634a1406b160e11b815260006004820152602401610578565b6001600160a01b0380851660009081526001602090815260408083209387168352929052208290558015610d5257826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258460405161128d91815260200190565b60405180910390a350505050565b60055460ff1661075e57604051638dfc202b60e01b815260040160405180910390fd5b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b83106112fd5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310611329576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc10000831061134757662386f26fc10000830492506010015b6305f5e100831061135f576305f5e100830492506008015b612710831061137357612710830492506004015b60648310611385576064830492506002015b600a83106107505760010192915050565b60608260006113a6846002611b38565b6113b1906002611733565b67ffffffffffffffff8111156113c9576113c961160a565b6040519080825280601f01601f1916602001820160405280156113f3576020820181803683370190505b509050600360fc1b8160008151811061140e5761140e611b4f565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061143d5761143d611b4f565b60200101906001600160f81b031916908160001a9053506000611461856002611b38565b61146c906001611733565b90505b60018111156114e4576f181899199a1a9b1b9c1cb0b131b232b360811b83600f16601081106114a0576114a0611b4f565b1a60f81b8282815181106114b6576114b6611b4f565b60200101906001600160f81b031916908160001a90535060049290921c916114dd81611b65565b905061146f565b50811561150e5760405163e22e27eb60e01b81526004810186905260248101859052604401610578565b949350505050565b60005b83811015611531578181015183820152602001611519565b50506000910152565b6020815260008251806020840152611559816040850160208701611516565b601f01601f19169190910160400192915050565b80356001600160a01b038116811461158457600080fd5b919050565b6000806040838503121561159c57600080fd5b6115a58361156d565b946020939093013593505050565b6000806000606084860312156115c857600080fd5b6115d18461156d565b92506115df6020850161156d565b9150604084013590509250925092565b60006020828403121561160157600080fd5b61077f8261156d565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561163257600080fd5b813567ffffffffffffffff8082111561164a57600080fd5b818401915084601f83011261165e57600080fd5b8135818111156116705761167061160a565b604051601f8201601f19908116603f011681019083821181831017156116985761169861160a565b816040528281528760208487010111156116b157600080fd5b826020860160208301376000928101602001929092525095945050505050565b6000602082840312156116e357600080fd5b5035919050565b600080604083850312156116fd57600080fd5b6117068361156d565b91506117146020840161156d565b90509250929050565b634e487b7160e01b600052601160045260246000fd5b808201808211156107505761075061171d565b61ffff8181168382160190808211156117615761176161171d565b5092915050565b600181811c9082168061177c57607f821691505b60208210810361179c57634e487b7160e01b600052602260045260246000fd5b50919050565b60006020808352600084546117b681611768565b808487015260406001808416600081146117d757600181146117f15761181f565b60ff1985168984015283151560051b89018301955061181f565b896000528660002060005b858110156118175781548b82018601529083019088016117fc565b8a0184019650505b509398975050505050505050565b6000815461183a81611768565b60018281168015611852576001811461186757611896565b60ff1984168752821515830287019450611896565b8560005260208060002060005b8581101561188d5781548a820152908401908201611874565b50505082870194505b5050505092915050565b6b034b739b1b934b83a34b7b7160a51b8152600061077f600c83018461182d565b818103818111156107505761075061171d565b600181815b8085111561190f5781600019048211156118f5576118f561171d565b8085161561190257918102915b93841c93908002906118d9565b509250929050565b60008261192657506001610750565b8161193357506000610750565b816001811461194957600281146119535761196f565b6001915050610750565b60ff8411156119645761196461171d565b50506001821b610750565b5060208310610133831016604e8410600b8410161715611992575081810a610750565b61199c83836118d4565b80600019048211156119b0576119b061171d565b029392505050565b600061077f60ff841683611917565b634e487b7160e01b600052601260045260246000fd5b6000826119ec576119ec6119c7565b500690565b600082611a0057611a006119c7565b500490565b60ff82811682821603908111156107505761075061171d565b60008351611a30818460208801611516565b601760f91b9083019081528351611a4e816001840160208801611516565b01600101949350505050565b7f646174613a2c7b2270223a226c696e733230222c226f70223a227472616e736681526b32b91116113a34b1b5911d1160a11b60208201526000611aa1602c83018661182d565b6811161130b6ba111d1160b91b81528451611ac3816009840160208901611516565b671116113a37911d1160c11b600992909101918201528351611aec816011840160208801611516565b61227d60f01b6011929091019182015260130195945050505050565b600061077f828461182d565b8051602080830151919081101561179c5760001960209190910360031b1b16919050565b80820281158282048414176107505761075061171d565b634e487b7160e01b600052603260045260246000fd5b600081611b7457611b7461171d565b50600019019056fea264697066735822122014249557772bc33d10b4cd5a890c4967736824170ee7a8e82af76ff9afaa567764736f6c63430008140033

479:4239:22:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2279:9;:7;:9::i;:::-;479:4239;;;;;2018:122;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;4293:186:11;;;;;;;;;;-1:-1:-1;4293:186:11;;;;;:::i;:::-;;:::i;:::-;;;1272:14:24;;1265:22;1247:41;;1235:2;1220:18;4293:186:11;1107:187:24;2304:61:22;;;:::i;3144:97:11:-;;;;;;;;;;-1:-1:-1;3222:12:11;;3144:97;;;1445:25:24;;;1433:2;1418:18;3144:97:11;1299:177:24;5039:244:11;;;;;;;;;;-1:-1:-1;5039:244:11;;;;;:::i;:::-;;:::i;2148:85:22:-;;;;;;;;;;-1:-1:-1;2148:85:22;;2223:2;1956:36:24;;1944:2;1929:18;2148:85:22;1814:184:24;4357:104:22;;;;;;;;;;;;;:::i;758:18::-;;;;;;;;;;;;;:::i;4648:67::-;;;;;;;;;;;;;:::i;1850:84:16:-;;;;;;;;;;-1:-1:-1;1920:7:16;;;;1850:84;;3299:116:11;;;;;;;;;;-1:-1:-1;3299:116:11;;;;;:::i;:::-;-1:-1:-1;;;;;3390:18:11;3364:7;3390:18;;;;;;;;;;;;3299:116;2293:101:6;;;;;;;;;;;;;:::i;699:22:22:-;;;;;;;;;;;;;;;;4522:63;;;;;;;;;;;;;:::i;594:24::-;;;;;;;;;;;;;;;;809:27;;;;;;;;;;;;;;;;1638:85:6;;;;;;;;;;-1:-1:-1;1710:6:6;;;;;-1:-1:-1;;;;;1710:6:6;1638:85;;-1:-1:-1;;;;;2358:32:24;;;2340:51;;2328:2;2313:18;1638:85:6;2194:203:24;2373:170:22;;;;;;:::i;:::-;;:::i;1917:93::-;;;;;;;;;;;;;:::i;965:26::-;;;;;;;;;;;;;;;;545:20;;;;;;;;;;;;;;;;4253:96;;;;;;;;;;-1:-1:-1;4253:96:22;;;;;:::i;:::-;;:::i;3062:1183::-;;;;;;;;;;-1:-1:-1;3062:1183:22;;;;;:::i;:::-;;:::i;1014:35::-;;;;;;;;;;;;;:::i;883:43::-;;;;;;;;;;-1:-1:-1;883:43:22;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;3820:6:24;3808:19;;;3790:38;;3778:2;3763:18;883:43:22;3646:188:24;3846:140:11;;;;;;;;;;-1:-1:-1;3846:140:11;;;;;:::i;:::-;-1:-1:-1;;;;;3952:18:11;;;3926:7;3952:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;3846:140;661:18:22;;;;;;;;;;;;;;;;2543:215:6;;;;;;;;;;-1:-1:-1;2543:215:6;;;;;:::i;:::-;;:::i;2551:503:22:-;1474:19:16;:17;:19::i;:::-;1252:9:22::1;1265:10;1252:23;1244:32;;;::::0;::::1;;2637:3:::2;;2624:9;:16;;2616:43;;;::::0;-1:-1:-1;;;2616:43:22;;4306:2:24;2616:43:22::2;::::0;::::2;4288:21:24::0;4345:2;4325:18;;;4318:30;-1:-1:-1;;;4364:18:24;;;4357:44;4418:18;;2616:43:22::2;;;;;;;;;2697:7;;2686;;2678:5;;:15;;;;:::i;:::-;:26;;2670:48;;;::::0;-1:-1:-1;;;2670:48:22;;4911:2:24;2670:48:22::2;::::0;::::2;4893:21:24::0;4950:1;4930:18;;;4923:29;-1:-1:-1;;;4968:18:24;;;4961:39;5017:18;;2670:48:22::2;4709:332:24::0;2670:48:22::2;2761:12;::::0;2747:10:::2;2737:21;::::0;;;:9:::2;:21;::::0;;;;;::::2;;:36;2729:71;;;::::0;-1:-1:-1;;;2729:71:22;;5248:2:24;2729:71:22::2;::::0;::::2;5230:21:24::0;5287:2;5267:18;;;5260:30;-1:-1:-1;;;5306:18:24;;;5299:52;5368:18;;2729:71:22::2;5046:346:24::0;2729:71:22::2;2813:24;2819:10;2831:5;;2813;:24::i;:::-;2859:5;;2848:7;;:16;;;;;;;:::i;:::-;::::0;;;-1:-1:-1;;2885:10:22::2;2875:21;::::0;;;:9:::2;:21;::::0;;;;:26;;2900:1:::2;::::0;2875:21;:26:::2;::::0;2900:1;;2875:26:::2;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;2930:10;-1:-1:-1::0;;;;;2917:42:22::2;;2942:16;2917:42;;;;;;:::i;:::-;;;;;;;;3017:10;-1:-1:-1::0;;;;;2975:71:22::2;;3029:16;2975:71;;;;;;:::i;:::-;;;;;;;;2551:503::o:0;2018:122::-;2064:13;2127:4;2097:35;;;;;;;;:::i;:::-;;;;;;;;;;;;;2090:42;;2018:122;:::o;4293:186:11:-;4366:4;735:10:15;4420:31:11;735:10:15;4436:7:11;4445:5;4420:8;:31::i;:::-;4468:4;4461:11;;;4293:186;;;;;:::o;2304:61:22:-;2348:9;:7;:9::i;:::-;2304:61::o;5039:244:11:-;5126:4;735:10:15;5182:37:11;5198:4;735:10:15;5213:5:11;5182:15;:37::i;:::-;5229:26;5239:4;5245:2;5249:5;5229:9;:26::i;:::-;5272:4;5265:11;;;5039:244;;;;;;:::o;4357:104:22:-;1531:13:6;:11;:13::i;:::-;1710:6;;4405:48:22::1;::::0;-1:-1:-1;;;;;1710:6:6;;;;;;;;;4431:21:22::1;4405:48:::0;::::1;;;::::0;::::1;::::0;;;4431:21;1710:6:6;4405:48:22;::::1;;;;;;;;;;;;;::::0;::::1;;;;;;4357:104::o:0;758:18::-;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::o;4648:67::-;1531:13:6;:11;:13::i;:::-;4697:10:22::1;:8;:10::i;2293:101:6:-:0;1531:13;:11;:13::i;:::-;2357:30:::1;2384:1;2357:18;:30::i;4522:63:22:-:0;1531:13:6;:11;:13::i;:::-;4569:8:22::1;:6;:8::i;2373:170::-:0;2449:40;2463:7;2472:16;2449:40;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:13;:40::i;:::-;2441:74;;;;-1:-1:-1;;;2441:74:22;;8190:2:24;2441:74:22;;;8172:21:24;8229:2;8209:18;;;8202:30;-1:-1:-1;;;8248:18:24;;;8241:51;8309:18;;2441:74:22;7988:345:24;2441:74:22;2526:9;:7;:9::i;1917:93::-;1965:13;1998:4;1991:11;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1917:93;:::o;4253:96::-;1531:13:6;:11;:13::i;:::-;4321:12:22::1;:20:::0;4253:96::o;3062:1183::-;3147:4;1474:19:16;:17;:19::i;:::-;3164:15:22::1;3197:9;;3210:1;3197:14;3194:93;;3238:37;3250:6;3258:9;;3269:5;3238:11;:37::i;:::-;3228:47;;3194:93;3315:10;3364:7:11::0;3390:18;;;;;;;;;;;3330:6:22;-1:-1:-1;3305:31:22::1;3297:64;;;::::0;-1:-1:-1;;;3297:64:22;;8540:2:24;3297:64:22::1;::::0;::::1;8522:21:24::0;8579:2;8559:18;;;8552:30;-1:-1:-1;;;8598:18:24;;;8591:50;8658:18;;3297:64:22::1;8338:344:24::0;3297:64:22::1;3377:12:::0;;3374:70:::1;;3406:26;3412:10;3424:7;3406:5;:26::i;:::-;3454:43;3464:10;3476:2:::0;3480:16:::1;3489:7:::0;3480:6;:16:::1;:::i;:::-;3454:9;:43::i;:::-;3510:19;3532:16;2223:2:::0;3532::::1;:16;:::i;:::-;3510:38:::0;-1:-1:-1;3559:16:22::1;3578:20;3510:38:::0;3578:6;:20:::1;:::i;:::-;3559:39:::0;-1:-1:-1;3609:15:22::1;3628:20;3637:11:::0;3628:6;:20:::1;:::i;:::-;3609:39;;3659:19;3681:25;3698:7;3681:16;:25::i;:::-;3659:47:::0;-1:-1:-1;3720:13:22;;3717:165:::1;;3779:14;3792:1;2223:2:::0;3779:14:::1;:::i;:::-;3772:22;::::0;:2:::1;:22;:::i;:::-;3760:35;::::0;:8;:35:::1;:::i;:::-;3749:46;;3831:5;3843:26;3860:8;3843:16;:26::i;:::-;3817:53;;;;;;;;;:::i;:::-;;;;;;;;;;;;;3809:61;;3717:165;3892:17;3974:4;3993:5;4012:23;4032:2;4012:19;:23::i;:::-;3912:130;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;3892:150;;4075:10;-1:-1:-1::0;;;;;4058:33:22::1;;4087:3;4058:33;;;;;;:::i;:::-;;;;;;;;4208:4;4191:22;;;;;;;;:::i;:::-;;;;;;;;;;;;;4183:31;;;:::i;:::-;4107:108;::::0;-1:-1:-1;;;;;4107:108:22;::::1;::::0;4167:10:::1;::::0;4107:108:::1;::::0;;;::::1;-1:-1:-1::0;4233:4:22::1;::::0;3062:1183;-1:-1:-1;;;;;;;;3062:1183:22:o;1014:35::-;;;;;;;:::i;2543:215:6:-;1531:13;:11;:13::i;:::-;-1:-1:-1;;;;;2627:22:6;::::1;2623:91;;2672:31;::::0;-1:-1:-1;;;2672:31:6;;2700:1:::1;2672:31;::::0;::::1;2340:51:24::0;2313:18;;2672:31:6::1;2194:203:24::0;2623:91:6::1;2723:28;2742:8;2723:18;:28::i;2002:128:16:-:0;1920:7;;;;2063:61;;;2098:15;;-1:-1:-1;;;2098:15:16;;;;;;;;;;;7721:208:11;-1:-1:-1;;;;;7791:21:11;;7787:91;;7835:32;;-1:-1:-1;;;7835:32:11;;7864:1;7835:32;;;2340:51:24;2313:18;;7835:32:11;2194:203:24;7787:91:11;7887:35;7903:1;7907:7;7916:5;7887:7;:35::i;:::-;7721:208;;:::o;8989:128::-;9073:37;9082:5;9089:7;9098:5;9105:4;9073:8;:37::i;:::-;8989:128;;;:::o;10663:477::-;-1:-1:-1;;;;;3952:18:11;;;10762:24;3952:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;-1:-1:-1;;10828:37:11;;10824:310;;10904:5;10885:16;:24;10881:130;;;10936:60;;-1:-1:-1;;;10936:60:11;;-1:-1:-1;;;;;13425:32:24;;10936:60:11;;;13407:51:24;13474:18;;;13467:34;;;13517:18;;;13510:34;;;13380:18;;10936:60:11;13205:345:24;10881:130:11;11052:57;11061:5;11068:7;11096:5;11077:16;:24;11103:5;11052:8;:57::i;:::-;10752:388;10663:477;;;:::o;5656:300::-;-1:-1:-1;;;;;5739:18:11;;5735:86;;5780:30;;-1:-1:-1;;;5780:30:11;;5807:1;5780:30;;;2340:51:24;2313:18;;5780:30:11;2194:203:24;5735:86:11;-1:-1:-1;;;;;5834:16:11;;5830:86;;5873:32;;-1:-1:-1;;;5873:32:11;;5902:1;5873:32;;;2340:51:24;2313:18;;5873:32:11;2194:203:24;5830:86:11;5925:24;5933:4;5939:2;5943:5;5925:7;:24::i;1796:162:6:-;1710:6;;-1:-1:-1;;;;;1710:6:6;;;;;735:10:15;1855:23:6;1851:101;;1901:40;;-1:-1:-1;;;1901:40:6;;735:10:15;1901:40:6;;;2340:51:24;2313:18;;1901:40:6;2194:203:24;2710:117:16;1721:16;:14;:16::i;:::-;2768:7:::1;:15:::0;;-1:-1:-1;;2768:15:16::1;::::0;;2798:22:::1;735:10:15::0;2807:12:16::1;2798:22;::::0;-1:-1:-1;;;;;2358:32:24;;;2340:51;;2328:2;2313:18;2798:22:16::1;;;;;;;2710:117::o:0;2912:187:6:-;3004:6;;;-1:-1:-1;;;;;3020:17:6;;;3004:6;3020:17;;;-1:-1:-1;;;;;;3020:17:6;;;;;;3052:40;;3004:6;;;;;;;;3052:40;;2985:16;;3052:40;2975:124;2912:187;:::o;2463:115:16:-;1474:19;:17;:19::i;:::-;2522:7:::1;:14:::0;;-1:-1:-1;;2522:14:16::1;2532:4;2522:14;::::0;;2551:20:::1;2558:12;735:10:15::0;;656:96;2914:182:18;2986:4;3034:1;3028:15;3015:1;3009:15;:34;:80;;;;;3086:1;3070:19;;;;;;3063:1;3047:19;;;;;;:42;3002:87;2914:182;-1:-1:-1;;;2914:182:18:o;3803:4116:19:-;3885:14;4248:5;;;3885:14;-1:-1:-1;;4252:1:19;4248;4420:20;4493:5;4489:2;4486:13;4478:5;4474:2;4470:14;4466:34;4457:43;;;4595:5;4604:1;4595:10;4591:368;;4933:11;4925:5;:19;;;;;:::i;:::-;;4918:26;;;;;;4591:368;5080:5;5065:11;:20;5061:88;;5112:22;;-1:-1:-1;;;5112:22:19;;;;;;;;;;;5061:88;5404:17;5539:11;5536:1;5533;5526:25;5939:12;5969:15;;;5954:31;;6088:22;;;;;6813:1;6794;:15;;6793:21;;7046;;;7042:25;;7031:36;7115:21;;;7111:25;;7100:36;7185:21;;;7181:25;;7170:36;7255:21;;;7251:25;;7240:36;7325:21;;;7321:25;;7310:36;7396:21;;;7392:25;;;7381:36;6333:12;;;;6329:23;;;6354:1;6325:31;5653:20;;;5642:32;;;6445:12;;;;5700:21;;;;6186:16;;;;6436:21;;;;7860:15;;;;;-1:-1:-1;;3803:4116:19;;;;;:::o;8247:206:11:-;-1:-1:-1;;;;;8317:21:11;;8313:89;;8361:30;;-1:-1:-1;;;8361:30:11;;8388:1;8361:30;;;2340:51:24;2313:18;;8361:30:11;2194:203:24;8313:89:11;8411:35;8419:7;8436:1;8440:5;8411:7;:35::i;637:698:18:-;693:13;742:14;759:17;770:5;759:10;:17::i;:::-;779:1;759:21;742:38;;794:20;828:6;817:18;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;817:18:18;-1:-1:-1;794:41:18;-1:-1:-1;955:28:18;;;971:2;955:28;1010:282;-1:-1:-1;;1041:5:18;-1:-1:-1;;;1175:2:18;1164:14;;1159:32;1041:5;1146:46;1236:2;1227:11;;;-1:-1:-1;1256:21:18;1010:282;1256:21;-1:-1:-1;1312:6:18;637:698;-1:-1:-1;;;637:698:18:o;2689:148::-;2747:13;2779:51;-1:-1:-1;;;;;2791:22:18;;375:2;2779:11;:51::i;6271:1107:11:-;-1:-1:-1;;;;;6360:18:11;;6356:540;;6512:5;6496:12;;:21;;;;;;;:::i;:::-;;;;-1:-1:-1;6356:540:11;;-1:-1:-1;6356:540:11;;-1:-1:-1;;;;;6570:15:11;;6548:19;6570:15;;;;;;;;;;;6603:19;;;6599:115;;;6649:50;;-1:-1:-1;;;6649:50:11;;-1:-1:-1;;;;;13425:32:24;;6649:50:11;;;13407:51:24;13474:18;;;13467:34;;;13517:18;;;13510:34;;;13380:18;;6649:50:11;13205:345:24;6599:115:11;-1:-1:-1;;;;;6834:15:11;;:9;:15;;;;;;;;;;6852:19;;;;6834:37;;6356:540;-1:-1:-1;;;;;6910:16:11;;6906:425;;7073:12;:21;;;;;;;6906:425;;;-1:-1:-1;;;;;7284:13:11;;:9;:13;;;;;;;;;;:22;;;;;;6906:425;7361:2;-1:-1:-1;;;;;7346:25:11;7355:4;-1:-1:-1;;;;;7346:25:11;;7365:5;7346:25;;;;1445::24;;1433:2;1418:18;;1299:177;7346:25:11;;;;;;;;6271:1107;;;:::o;9949:432::-;-1:-1:-1;;;;;10061:19:11;;10057:89;;10103:32;;-1:-1:-1;;;10103:32:11;;10132:1;10103:32;;;2340:51:24;2313:18;;10103:32:11;2194:203:24;10057:89:11;-1:-1:-1;;;;;10159:21:11;;10155:90;;10203:31;;-1:-1:-1;;;10203:31:11;;10231:1;10203:31;;;2340:51:24;2313:18;;10203:31:11;2194:203:24;10155:90:11;-1:-1:-1;;;;;10254:18:11;;;;;;;:11;:18;;;;;;;;:27;;;;;;;;;:35;;;10299:76;;;;10349:7;-1:-1:-1;;;;;10333:31:11;10342:5;-1:-1:-1;;;;;10333:31:11;;10358:5;10333:31;;;;1445:25:24;;1433:2;1418:18;;1299:177;10333:31:11;;;;;;;;9949:432;;;;:::o;2202:126:16:-;1920:7;;;;2260:62;;2296:15;;-1:-1:-1;;;2296:15:16;;;;;;;;;;;12214:916:19;12267:7;;-1:-1:-1;;;12342:17:19;;12338:103;;-1:-1:-1;;;12379:17:19;;;-1:-1:-1;12424:2:19;12414:12;12338:103;12467:8;12458:5;:17;12454:103;;12504:8;12495:17;;;-1:-1:-1;12540:2:19;12530:12;12454:103;12583:8;12574:5;:17;12570:103;;12620:8;12611:17;;;-1:-1:-1;12656:2:19;12646:12;12570:103;12699:7;12690:5;:16;12686:100;;12735:7;12726:16;;;-1:-1:-1;12770:1:19;12760:11;12686:100;12812:7;12803:5;:16;12799:100;;12848:7;12839:16;;;-1:-1:-1;12883:1:19;12873:11;12799:100;12925:7;12916:5;:16;12912:100;;12961:7;12952:16;;;-1:-1:-1;12996:1:19;12986:11;12912:100;13038:7;13029:5;:16;13025:66;;13075:1;13065:11;13117:6;12214:916;-1:-1:-1;;12214:916:19:o;2005:525:18:-;2080:13;2126:5;2105:18;2173:10;2177:6;2173:1;:10;:::i;:::-;:14;;2186:1;2173:14;:::i;:::-;2163:25;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;2163:25:18;;2141:47;;-1:-1:-1;;;2198:6:18;2205:1;2198:9;;;;;;;;:::i;:::-;;;;:15;-1:-1:-1;;;;;2198:15:18;;;;;;;;;-1:-1:-1;;;2223:6:18;2230:1;2223:9;;;;;;;;:::i;:::-;;;;:15;-1:-1:-1;;;;;2223:15:18;;;;;;;;-1:-1:-1;2253:9:18;2265:10;2269:6;2265:1;:10;:::i;:::-;:14;;2278:1;2265:14;:::i;:::-;2253:26;;2248:140;2285:1;2281;:5;2248:140;;;-1:-1:-1;;;2330:10:18;2343:3;2330:16;2319:28;;;;;;;:::i;:::-;;;;2307:6;2314:1;2307:9;;;;;;;;:::i;:::-;;;;:40;-1:-1:-1;;;;;2307:40:18;;;;;;;;-1:-1:-1;2376:1:18;2361:16;;;;;2288:3;;;:::i;:::-;;;2248:140;;;-1:-1:-1;2401:15:18;;2397:96;;2439:43;;-1:-1:-1;;;2439:43:18;;;;;14175:25:24;;;14216:18;;;14209:34;;;14148:18;;2439:43:18;14001:248:24;2397:96:18;2516:6;2005:525;-1:-1:-1;;;;2005:525:18:o;14:250:24:-;99:1;109:113;123:6;120:1;117:13;109:113;;;199:11;;;193:18;180:11;;;173:39;145:2;138:10;109:113;;;-1:-1:-1;;256:1:24;238:16;;231:27;14:250::o;269:396::-;418:2;407:9;400:21;381:4;450:6;444:13;493:6;488:2;477:9;473:18;466:34;509:79;581:6;576:2;565:9;561:18;556:2;548:6;544:15;509:79;:::i;:::-;649:2;628:15;-1:-1:-1;;624:29:24;609:45;;;;656:2;605:54;;269:396;-1:-1:-1;;269:396:24:o;670:173::-;738:20;;-1:-1:-1;;;;;787:31:24;;777:42;;767:70;;833:1;830;823:12;767:70;670:173;;;:::o;848:254::-;916:6;924;977:2;965:9;956:7;952:23;948:32;945:52;;;993:1;990;983:12;945:52;1016:29;1035:9;1016:29;:::i;:::-;1006:39;1092:2;1077:18;;;;1064:32;;-1:-1:-1;;;848:254:24:o;1481:328::-;1558:6;1566;1574;1627:2;1615:9;1606:7;1602:23;1598:32;1595:52;;;1643:1;1640;1633:12;1595:52;1666:29;1685:9;1666:29;:::i;:::-;1656:39;;1714:38;1748:2;1737:9;1733:18;1714:38;:::i;:::-;1704:48;;1799:2;1788:9;1784:18;1771:32;1761:42;;1481:328;;;;;:::o;2003:186::-;2062:6;2115:2;2103:9;2094:7;2090:23;2086:32;2083:52;;;2131:1;2128;2121:12;2083:52;2154:29;2173:9;2154:29;:::i;2402:127::-;2463:10;2458:3;2454:20;2451:1;2444:31;2494:4;2491:1;2484:15;2518:4;2515:1;2508:15;2534:922;2603:6;2656:2;2644:9;2635:7;2631:23;2627:32;2624:52;;;2672:1;2669;2662:12;2624:52;2712:9;2699:23;2741:18;2782:2;2774:6;2771:14;2768:34;;;2798:1;2795;2788:12;2768:34;2836:6;2825:9;2821:22;2811:32;;2881:7;2874:4;2870:2;2866:13;2862:27;2852:55;;2903:1;2900;2893:12;2852:55;2939:2;2926:16;2961:2;2957;2954:10;2951:36;;;2967:18;;:::i;:::-;3042:2;3036:9;3010:2;3096:13;;-1:-1:-1;;3092:22:24;;;3116:2;3088:31;3084:40;3072:53;;;3140:18;;;3160:22;;;3137:46;3134:72;;;3186:18;;:::i;:::-;3226:10;3222:2;3215:22;3261:2;3253:6;3246:18;3301:7;3296:2;3291;3287;3283:11;3279:20;3276:33;3273:53;;;3322:1;3319;3312:12;3273:53;3378:2;3373;3369;3365:11;3360:2;3352:6;3348:15;3335:46;3423:1;3401:15;;;3418:2;3397:24;3390:35;;;;-1:-1:-1;3405:6:24;2534:922;-1:-1:-1;;;;;2534:922:24:o;3461:180::-;3520:6;3573:2;3561:9;3552:7;3548:23;3544:32;3541:52;;;3589:1;3586;3579:12;3541:52;-1:-1:-1;3612:23:24;;3461:180;-1:-1:-1;3461:180:24:o;3839:260::-;3907:6;3915;3968:2;3956:9;3947:7;3943:23;3939:32;3936:52;;;3984:1;3981;3974:12;3936:52;4007:29;4026:9;4007:29;:::i;:::-;3997:39;;4055:38;4089:2;4078:9;4074:18;4055:38;:::i;:::-;4045:48;;3839:260;;;;;:::o;4447:127::-;4508:10;4503:3;4499:20;4496:1;4489:31;4539:4;4536:1;4529:15;4563:4;4560:1;4553:15;4579:125;4644:9;;;4665:10;;;4662:36;;;4678:18;;:::i;5397:168::-;5464:6;5490:10;;;5502;;;5486:27;;5525:11;;;5522:37;;;5539:18;;:::i;:::-;5522:37;5397:168;;;;:::o;5570:380::-;5649:1;5645:12;;;;5692;;;5713:61;;5767:4;5759:6;5755:17;5745:27;;5713:61;5820:2;5812:6;5809:14;5789:18;5786:38;5783:161;;5866:10;5861:3;5857:20;5854:1;5847:31;5901:4;5898:1;5891:15;5929:4;5926:1;5919:15;5783:161;;5570:380;;;:::o;5955:963::-;6064:4;6093:2;6122;6111:9;6104:21;6145:1;6178:6;6172:13;6208:36;6234:9;6208:36;:::i;:::-;6280:6;6275:2;6264:9;6260:18;6253:34;6306:2;6327:1;6359:2;6348:9;6344:18;6376:1;6371:158;;;;6543:1;6538:354;;;;6337:555;;6371:158;-1:-1:-1;;6419:24:24;;6399:18;;;6392:52;6497:14;;6490:22;6487:1;6483:30;6468:46;;6464:55;;;-1:-1:-1;6371:158:24;;6538:354;6569:6;6566:1;6559:17;6617:2;6614:1;6604:16;6642:1;6656:180;6670:6;6667:1;6664:13;6656:180;;;6763:14;;6739:17;;;6735:26;;6728:50;6806:16;;;;6685:10;;6656:180;;;6860:17;;6856:26;;;-1:-1:-1;;6337:555:24;-1:-1:-1;6909:3:24;;5955:963;-1:-1:-1;;;;;;;;5955:963:24:o;6923:722::-;6973:3;7014:5;7008:12;7043:36;7069:9;7043:36;:::i;:::-;7098:1;7115:18;;;7142:133;;;;7289:1;7284:355;;;;7108:531;;7142:133;-1:-1:-1;;7175:24:24;;7163:37;;7248:14;;7241:22;7229:35;;7220:45;;;-1:-1:-1;7142:133:24;;7284:355;7315:5;7312:1;7305:16;7344:4;7389:2;7386:1;7376:16;7414:1;7428:165;7442:6;7439:1;7436:13;7428:165;;;7520:14;;7507:11;;;7500:35;7563:16;;;;7457:10;;7428:165;;;7432:3;;;7622:6;7617:3;7613:16;7606:23;;7108:531;;;;;6923:722;;;;:::o;7650:333::-;-1:-1:-1;;;7894:3:24;7887:27;7869:3;7930:47;7973:2;7968:3;7964:12;7956:6;7930:47;:::i;8687:128::-;8754:9;;;8775:11;;;8772:37;;;8789:18;;:::i;8820:422::-;8909:1;8952:5;8909:1;8966:270;8987:7;8977:8;8974:21;8966:270;;;9046:4;9042:1;9038:6;9034:17;9028:4;9025:27;9022:53;;;9055:18;;:::i;:::-;9105:7;9095:8;9091:22;9088:55;;;9125:16;;;;9088:55;9204:22;;;;9164:15;;;;8966:270;;;8970:3;8820:422;;;;;:::o;9247:806::-;9296:5;9326:8;9316:80;;-1:-1:-1;9367:1:24;9381:5;;9316:80;9415:4;9405:76;;-1:-1:-1;9452:1:24;9466:5;;9405:76;9497:4;9515:1;9510:59;;;;9583:1;9578:130;;;;9490:218;;9510:59;9540:1;9531:10;;9554:5;;;9578:130;9615:3;9605:8;9602:17;9599:43;;;9622:18;;:::i;:::-;-1:-1:-1;;9678:1:24;9664:16;;9693:5;;9490:218;;9792:2;9782:8;9779:16;9773:3;9767:4;9764:13;9760:36;9754:2;9744:8;9741:16;9736:2;9730:4;9727:12;9723:35;9720:77;9717:159;;;-1:-1:-1;9829:19:24;;;9861:5;;9717:159;9908:34;9933:8;9927:4;9908:34;:::i;:::-;9978:6;9974:1;9970:6;9966:19;9957:7;9954:32;9951:58;;;9989:18;;:::i;:::-;10027:20;;9247:806;-1:-1:-1;;;9247:806:24:o;10058:140::-;10116:5;10145:47;10186:4;10176:8;10172:19;10166:4;10145:47;:::i;10203:127::-;10264:10;10259:3;10255:20;10252:1;10245:31;10295:4;10292:1;10285:15;10319:4;10316:1;10309:15;10335:112;10367:1;10393;10383:35;;10398:18;;:::i;:::-;-1:-1:-1;10432:9:24;;10335:112::o;10452:120::-;10492:1;10518;10508:35;;10523:18;;:::i;:::-;-1:-1:-1;10557:9:24;;10452:120::o;10577:151::-;10667:4;10660:12;;;10646;;;10642:31;;10685:14;;10682:40;;;10702:18;;:::i;10733:629::-;11002:3;11040:6;11034:13;11056:66;11115:6;11110:3;11103:4;11095:6;11091:17;11056:66;:::i;:::-;-1:-1:-1;;;11144:16:24;;;11169:18;;;11212:13;;11234:78;11212:13;11299:1;11288:13;;11281:4;11269:17;;11234:78;:::i;:::-;11332:20;11354:1;11328:28;;10733:629;-1:-1:-1;;;;10733:629:24:o;11367:1329::-;11992:66;11980:79;;-1:-1:-1;;;12084:2:24;12075:12;;12068:58;-1:-1:-1;12148:47:24;12191:2;12182:12;;12174:6;12148:47;:::i;:::-;-1:-1:-1;;;12204:45:24;;12272:13;;12294:74;12272:13;12357:1;12346:13;;12341:2;12329:15;;12294:74;:::i;:::-;-1:-1:-1;;;12429:1:24;12387:18;;;;12421:10;;;12414:48;12487:13;;12509:74;12487:13;12569:2;12561:11;;12556:2;12544:15;;12509:74;:::i;:::-;-1:-1:-1;;;12643:2:24;12602:17;;;;12635:11;;;12628:35;12687:2;12679:11;;11367:1329;-1:-1:-1;;;;;11367:1329:24:o;12701:197::-;12829:3;12854:38;12888:3;12880:6;12854:38;:::i;12903:297::-;13021:12;;13068:4;13057:16;;;13051:23;;13021:12;13086:16;;13083:111;;;-1:-1:-1;;13160:4:24;13156:17;;;;13153:1;13149:25;13145:38;13134:50;;12903:297;-1:-1:-1;12903:297:24:o;13555:168::-;13628:9;;;13659;;13676:15;;;13670:22;;13656:37;13646:71;;13697:18;;:::i;13728:127::-;13789:10;13784:3;13780:20;13777:1;13770:31;13820:4;13817:1;13810:15;13844:4;13841:1;13834:15;13860:136;13899:3;13927:5;13917:39;;13936:18;;:::i;:::-;-1:-1:-1;;;13972:18:24;;13860:136::o

ipfs://14249557772bc33d10b4cd5a890c4967736824170ee7a8e82af76ff9afaa5677