ETH Price: $2,116.26 (-2.75%)

Transaction Decoder

Block:
16468427 at Jan-23-2023 08:52:11 AM +UTC
Transaction Fee:
0.00546250567049985 ETH $11.56
Gas Used:
428,685 Gas / 12.74246981 Gwei

Emitted Events:

225 0xb6f962764b05970b283d030f4ef506695f873de9.0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0( 0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000007068895c897f318257da606395b89e272b9da9e0 )
226 ERC1967Proxy.0x682ae3d4e241d6aa8a69cef59ea153c02f510907315f4d1fe410b07776d724ca( 0x682ae3d4e241d6aa8a69cef59ea153c02f510907315f4d1fe410b07776d724ca, 0x8a5eb632a930b5c79068aa22ade4e766f295b2cf108c2dd622ae0933d35e7478, 0x000000000000000000000000b6f962764b05970b283d030f4ef506695f873de9, 0000000000000000000000000000000000000000000000000000000000000040, 0000000000000000000000007068895c897f318257da606395b89e272b9da9e0, 0000000000000000000000000000000000000000000000000000000000000018, 3633626362393331613338613136373736356161643963370000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
0x7068895C...72b9Da9e0
(The Rabbit 2023 Ready2Wear*: Deployer)
0.098290497491691088 Eth
Nonce: 19
0.042827991821191238 Eth
Nonce: 20
0.05546250567049985
0xB6f96276...95f873dE9
0 Eth
Nonce: 0
0 Eth
Nonce: 1
From: 0 To: 497590261154554171967157713262398415775405744751137033061396022474211817247389959623689270709230661741140979
0xCE417118...BE17F0134
1.275 Eth
Nonce: 1197
1.325 Eth
Nonce: 1198
0.05
(Flashbots: Builder)
1.184547002122825754 Eth1.184652954957031109 Eth0.000105952834205355

Execution Trace

ETH 0.05 ERC1967Proxy.37e8ae74( )
  • ETH 0.05 AutoMinterFactory.create( name_=The Rabbit 2023 Ready2Wear, symbol_=R2W, baseURI_=ipfs://bafybeihnhtkxwmtmzarcmnexgjcgqy5zsvcvcivuljoo64p4y7tg5sunha/, appId_=63bcb931a38a167765aad9c7, mintFee_=50000000000000000, size_=333, mintSelectionEnabled_=False, mintRandomEnabled_=True, whiteListSignerAddress_=0x5523756369B11952666511a899411438f474f16A, mintLimit_=3, royaltyBasis_=1000, placeholderImage_= )
    • 0xb6f962764b05970b283d030f4ef506695f873de9.3d602d80( )
    • 0xb6f962764b05970b283d030f4ef506695f873de9.195b2934( )
      • AutoMinterERC721.initialize( name_=The Rabbit 2023 Ready2Wear, symbol_=R2W, baseURI_=ipfs://bafybeihnhtkxwmtmzarcmnexgjcgqy5zsvcvcivuljoo64p4y7tg5sunha/, ownerAddress_=0x7068895C897F318257da606395B89E272b9Da9e0, mintFee_=50000000000000000, size_=333, mintSelectionEnabled_=False, mintRandomEnabled_=True, whiteListSignerAddress_=0x5523756369B11952666511a899411438f474f16A, mintLimit_=3, royaltyBasis_=1000, placeholderImage_= )
        File 1 of 3: ERC1967Proxy
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.8.0;
        
        /**
         * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
         * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
         * be specified by overriding the virtual {_implementation} function.
         *
         * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
         * different contract through the {_delegate} function.
         *
         * The success and return data of the delegated call will be returned back to the caller of the proxy.
         */
        abstract contract Proxy {
            /**
             * @dev Delegates the current call to `implementation`.
             *
             * This function does not return to its internall call site, it will return directly to the external caller.
             */
            function _delegate(address implementation) internal virtual {
                // solhint-disable-next-line no-inline-assembly
                assembly {
                // Copy msg.data. We take full control of memory in this inline assembly
                // block because it will not return to Solidity code. We overwrite the
                // Solidity scratch pad at memory position 0.
                    calldatacopy(0, 0, calldatasize())
        
                // Call the implementation.
                // out and outsize are 0 because we don't know the size yet.
                    let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
        
                // Copy the returned data.
                    returndatacopy(0, 0, returndatasize())
        
                    switch result
                    // delegatecall returns 0 on error.
                    case 0 { revert(0, returndatasize()) }
                    default { return(0, returndatasize()) }
                }
            }
        
            /**
             * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function
             * and {_fallback} should delegate.
             */
            function _implementation() internal view virtual returns (address);
        
            /**
             * @dev Delegates the current call to the address returned by `_implementation()`.
             *
             * This function does not return to its internall call site, it will return directly to the external caller.
             */
            function _fallback() internal virtual {
                _beforeFallback();
                _delegate(_implementation());
            }
        
            /**
             * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
             * function in the contract matches the call data.
             */
            fallback () external payable virtual {
                _fallback();
            }
        
            /**
             * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
             * is empty.
             */
            receive () external payable virtual {
                _fallback();
            }
        
            /**
             * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
             * call, or as part of the Solidity `fallback` or `receive` functions.
             *
             * If overriden should call `super._beforeFallback()`.
             */
            function _beforeFallback() internal virtual {
            }
        }
        
        
        /**
         * @dev This abstract contract provides getters and event emitting update functions for
         * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
         *
         * _Available since v4.1._
         *
         */
        abstract contract ERC1967Upgrade {
            // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
            bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
        
            /**
             * @dev Storage slot with the address of the current implementation.
             * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
             * validated in the constructor.
             */
            bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
        
            /**
             * @dev Emitted when the implementation is upgraded.
             */
            event Upgraded(address indexed implementation);
        
            /**
             * @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 {
                require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
            }
        
            /**
             * @dev Perform implementation upgrade
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeTo(address newImplementation) internal {
                _setImplementation(newImplementation);
                emit Upgraded(newImplementation);
            }
        
            /**
             * @dev Perform implementation upgrade with additional setup call.
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
                _setImplementation(newImplementation);
                emit Upgraded(newImplementation);
                if (data.length > 0 || forceCall) {
                    Address.functionDelegateCall(newImplementation, data);
                }
            }
        
            /**
             * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeToAndCallSecure(address newImplementation, bytes memory data, bool forceCall) internal {
                address oldImplementation = _getImplementation();
        
                // Initial upgrade and setup call
                _setImplementation(newImplementation);
                if (data.length > 0 || forceCall) {
                    Address.functionDelegateCall(newImplementation, data);
                }
        
                // Perform rollback test if not already in progress
                StorageSlot.BooleanSlot storage rollbackTesting = StorageSlot.getBooleanSlot(_ROLLBACK_SLOT);
                if (!rollbackTesting.value) {
                    // Trigger rollback using upgradeTo from the new implementation
                    rollbackTesting.value = true;
                    Address.functionDelegateCall(
                        newImplementation,
                        abi.encodeWithSignature(
                            "upgradeTo(address)",
                            oldImplementation
                        )
                    );
                    rollbackTesting.value = false;
                    // Check rollback was effective
                    require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                    // Finally reset to the new implementation and log the upgrade
                    _setImplementation(newImplementation);
                    emit Upgraded(newImplementation);
                }
            }
        
            /**
             * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
             * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
             *
             * Emits a {BeaconUpgraded} event.
             */
            function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
                _setBeacon(newBeacon);
                emit BeaconUpgraded(newBeacon);
                if (data.length > 0 || forceCall) {
                    Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                }
            }
        
            /**
             * @dev Storage slot with the admin of the contract.
             * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
             * validated in the constructor.
             */
            bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
        
            /**
             * @dev Emitted when the admin account has changed.
             */
            event AdminChanged(address previousAdmin, address newAdmin);
        
            /**
             * @dev Returns the current admin.
             */
            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 {
                require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
            }
        
            /**
             * @dev Changes the admin of the proxy.
             *
             * Emits an {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 bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
             */
            bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
        
            /**
             * @dev Emitted when the beacon is upgraded.
             */
            event BeaconUpgraded(address indexed beacon);
        
            /**
             * @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 {
                require(
                    Address.isContract(newBeacon),
                    "ERC1967: new beacon is not a contract"
                );
                require(
                    Address.isContract(IBeacon(newBeacon).implementation()),
                    "ERC1967: beacon implementation is not a contract"
                );
                StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
            }
        }
        
        /**
         * @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.
             *
             * {BeaconProxy} will check that this address is a contract.
             */
            function implementation() external view returns (address);
        }
        
        /**
         * @dev Collection of functions related to the address type
         */
        library Address {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize, which returns 0 for contracts in
                // construction, since the code is only stored at the end of the
                // constructor execution.
        
                uint256 size;
                // solhint-disable-next-line no-inline-assembly
                assembly { size := extcodesize(account) }
                return size > 0;
            }
        
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
        
                // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                (bool success, ) = recipient.call{ value: amount }("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
        
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain`call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
            }
        
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
             * `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, errorMessage);
            }
        
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but also transferring `value` wei to `target`.
             *
             * Requirements:
             *
             * - the calling contract must have an ETH balance of at least `value`.
             * - the called Solidity function must be `payable`.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
            }
        
            /**
             * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
             * with `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                require(address(this).balance >= value, "Address: insufficient balance for call");
                require(isContract(target), "Address: call to non-contract");
        
                // solhint-disable-next-line avoid-low-level-calls
                (bool success, bytes memory returndata) = target.call{ value: value }(data);
                return _verifyCallResult(success, returndata, errorMessage);
            }
        
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "Address: low-level static call failed");
            }
        
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
                require(isContract(target), "Address: static call to non-contract");
        
                // solhint-disable-next-line avoid-low-level-calls
                (bool success, bytes memory returndata) = target.staticcall(data);
                return _verifyCallResult(success, returndata, errorMessage);
            }
        
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
        
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                require(isContract(target), "Address: delegate call to non-contract");
        
                // solhint-disable-next-line avoid-low-level-calls
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return _verifyCallResult(success, returndata, errorMessage);
            }
        
            function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    // 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
        
                        // solhint-disable-next-line no-inline-assembly
                        assembly {
                            let returndata_size := mload(returndata)
                            revert(add(32, returndata), returndata_size)
                        }
                    } else {
                        revert(errorMessage);
                    }
                }
            }
        }
        
        /**
         * @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:
         * ```
         * 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(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
         *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
         *     }
         * }
         * ```
         *
         * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
         */
        library StorageSlot {
            struct AddressSlot {
                address value;
            }
        
            struct BooleanSlot {
                bool value;
            }
        
            struct Bytes32Slot {
                bytes32 value;
            }
        
            struct Uint256Slot {
                uint256 value;
            }
        
            /**
             * @dev Returns an `AddressSlot` with member `value` located at `slot`.
             */
            function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                assembly {
                    r.slot := slot
                }
            }
        
            /**
             * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
             */
            function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                assembly {
                    r.slot := slot
                }
            }
        
            /**
             * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
             */
            function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                assembly {
                    r.slot := slot
                }
            }
        
            /**
             * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
             */
            function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                assembly {
                    r.slot := slot
                }
            }
        }
        
        /*
         * @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) {
                this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
                return msg.data;
            }
        }
        
        /**
         * @dev Contract module which provides a basic access control mechanism, where
         * there is an account (an owner) that can be granted exclusive access to
         * specific functions.
         *
         * By default, the owner account will be the one that deploys the contract. This
         * can later be changed with {transferOwnership}.
         *
         * This module is used through inheritance. It will make available the modifier
         * `onlyOwner`, which can be applied to your functions to restrict their use to
         * the owner.
         */
        abstract contract Ownable is Context {
            address private _owner;
        
            event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
        
            /**
             * @dev Initializes the contract setting the deployer as the initial owner.
             */
            constructor () {
                address msgSender = _msgSender();
                _owner = msgSender;
                emit OwnershipTransferred(address(0), msgSender);
            }
        
            /**
             * @dev Returns the address of the current owner.
             */
            function owner() public view virtual returns (address) {
                return _owner;
            }
        
            /**
             * @dev Throws if called by any account other than the owner.
             */
            modifier onlyOwner() {
                require(owner() == _msgSender(), "Ownable: caller is not the owner");
                _;
            }
        
            /**
             * @dev Leaves the contract without owner. It will not be possible to call
             * `onlyOwner` functions anymore. Can only be called by the current owner.
             *
             * NOTE: Renouncing ownership will leave the contract without an owner,
             * thereby removing any functionality that is only available to the owner.
             */
            function renounceOwnership() public virtual onlyOwner {
                emit OwnershipTransferred(_owner, address(0));
                _owner = address(0);
            }
        
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Can only be called by the current owner.
             */
            function transferOwnership(address newOwner) public virtual onlyOwner {
                require(newOwner != address(0), "Ownable: new owner is the zero address");
                emit OwnershipTransferred(_owner, newOwner);
                _owner = newOwner;
            }
        }
        
        /**
         * @dev This is an auxiliary contract meant to be assigned as the admin of a {TransparentUpgradeableProxy}. For an
         * explanation of why you would want to use this see the documentation for {TransparentUpgradeableProxy}.
         */
        contract ProxyAdmin is Ownable {
        
            /**
             * @dev Returns the current implementation of `proxy`.
             *
             * Requirements:
             *
             * - This contract must be the admin of `proxy`.
             */
            function getProxyImplementation(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                // We need to manually run the static call since the getter cannot be flagged as view
                // bytes4(keccak256("implementation()")) == 0x5c60da1b
                (bool success, bytes memory returndata) = address(proxy).staticcall(hex"5c60da1b");
                require(success);
                return abi.decode(returndata, (address));
            }
        
            /**
             * @dev Returns the current admin of `proxy`.
             *
             * Requirements:
             *
             * - This contract must be the admin of `proxy`.
             */
            function getProxyAdmin(TransparentUpgradeableProxy proxy) public view virtual returns (address) {
                // We need to manually run the static call since the getter cannot be flagged as view
                // bytes4(keccak256("admin()")) == 0xf851a440
                (bool success, bytes memory returndata) = address(proxy).staticcall(hex"f851a440");
                require(success);
                return abi.decode(returndata, (address));
            }
        
            /**
             * @dev Changes the admin of `proxy` to `newAdmin`.
             *
             * Requirements:
             *
             * - This contract must be the current admin of `proxy`.
             */
            function changeProxyAdmin(TransparentUpgradeableProxy proxy, address newAdmin) public virtual onlyOwner {
                proxy.changeAdmin(newAdmin);
            }
        
            /**
             * @dev Upgrades `proxy` to `implementation`. See {TransparentUpgradeableProxy-upgradeTo}.
             *
             * Requirements:
             *
             * - This contract must be the admin of `proxy`.
             */
            function upgrade(TransparentUpgradeableProxy proxy, address implementation) public virtual onlyOwner {
                proxy.upgradeTo(implementation);
            }
        
            /**
             * @dev Upgrades `proxy` to `implementation` and calls a function on the new implementation. See
             * {TransparentUpgradeableProxy-upgradeToAndCall}.
             *
             * Requirements:
             *
             * - This contract must be the admin of `proxy`.
             */
            function upgradeAndCall(TransparentUpgradeableProxy proxy, address implementation, bytes memory data) public payable virtual onlyOwner {
                proxy.upgradeToAndCall{value: msg.value}(implementation, data);
            }
        }
        
        
        /**
         * @dev Base contract for building openzeppelin-upgrades compatible implementations for the {ERC1967Proxy}. It includes
         * publicly available upgrade functions that are called by the plugin and by the secure upgrade mechanism to verify
         * continuation of the upgradability.
         *
         * The {_authorizeUpgrade} function MUST be overridden to include access restriction to the upgrade mechanism.
         *
         * _Available since v4.1._
         */
        abstract contract UUPSUpgradeable is ERC1967Upgrade {
            function upgradeTo(address newImplementation) external virtual {
                _authorizeUpgrade(newImplementation);
                _upgradeToAndCallSecure(newImplementation, bytes(""), false);
            }
        
            function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual {
                _authorizeUpgrade(newImplementation);
                _upgradeToAndCallSecure(newImplementation, data, true);
            }
        
            function _authorizeUpgrade(address newImplementation) internal virtual;
        }
        
        
        abstract contract Proxiable is UUPSUpgradeable {
            function _authorizeUpgrade(address newImplementation) internal override {
                _beforeUpgrade(newImplementation);
            }
        
            function _beforeUpgrade(address newImplementation) internal virtual;
        }
        
        contract ChildOfProxiable is Proxiable {
            function _beforeUpgrade(address newImplementation) internal virtual override {}
        }
        
        
        /**
         * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
         * implementation address that can be changed. This address is stored in storage in the location specified by
         * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
         * implementation behind the proxy.
         */
        contract ERC1967Proxy is Proxy, ERC1967Upgrade {
            /**
             * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
             *
             * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
             * function call, and allows initializating the storage of the proxy like a Solidity constructor.
             */
            constructor(address _logic, bytes memory _data) payable {
                assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
                _upgradeToAndCall(_logic, _data, false);
            }
        
            /**
             * @dev Returns the current implementation address.
             */
            function _implementation() internal view virtual override returns (address impl) {
                return ERC1967Upgrade._getImplementation();
            }
        }
        
        /**
         * @dev This contract implements a proxy that is upgradeable by an admin.
         *
         * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
         * clashing], which can potentially be used in an attack, this contract uses the
         * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
         * things that go hand in hand:
         *
         * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
         * that call matches one of the admin functions exposed by the proxy itself.
         * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
         * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
         * "admin cannot fallback to proxy target".
         *
         * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
         * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
         * to sudden errors when trying to call a function from the proxy implementation.
         *
         * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
         * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
         */
        contract TransparentUpgradeableProxy is ERC1967Proxy {
            /**
             * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
             * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
             */
            constructor(address _logic, address admin_, bytes memory _data) payable ERC1967Proxy(_logic, _data) {
                assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                _changeAdmin(admin_);
            }
        
            /**
             * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
             */
            modifier ifAdmin() {
                if (msg.sender == _getAdmin()) {
                    _;
                } else {
                    _fallback();
                }
            }
        
            /**
             * @dev Returns the current admin.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
             *
             * 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 admin() external ifAdmin returns (address admin_) {
                admin_ = _getAdmin();
            }
        
            /**
             * @dev Returns the current implementation.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
             *
             * 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.
             * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
             */
            function implementation() external ifAdmin returns (address implementation_) {
                implementation_ = _implementation();
            }
        
            /**
             * @dev Changes the admin of the proxy.
             *
             * Emits an {AdminChanged} event.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.
             */
            function changeAdmin(address newAdmin) external virtual ifAdmin {
                _changeAdmin(newAdmin);
            }
        
            /**
             * @dev Upgrade the implementation of the proxy.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
             */
            function upgradeTo(address newImplementation) external ifAdmin {
                _upgradeToAndCall(newImplementation, bytes(""), false);
            }
        
            /**
             * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
             * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
             * proxied contract.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
             */
            function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                _upgradeToAndCall(newImplementation, data, true);
            }
        
            /**
             * @dev Returns the current admin.
             */
            function _admin() internal view virtual returns (address) {
                return _getAdmin();
            }
        
            /**
             * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
             */
            function _beforeFallback() internal virtual override {
                require(msg.sender != _getAdmin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                super._beforeFallback();
            }
        }
        
        
        // Kept for backwards compatibility with older versions of Hardhat and Truffle plugins.
        contract AdminUpgradeabilityProxy is TransparentUpgradeableProxy {
            constructor(address logic, address admin, bytes memory data) payable TransparentUpgradeableProxy(logic, admin, data) {}
        }

        File 2 of 3: AutoMinterFactory
        // SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        import "./AutoMinterERC721.sol";
        import "./AutoMinterERC721A.sol";
        import '@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol';
        import '@openzeppelin/contracts-upgradeable/proxy/ClonesUpgradeable.sol';
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
        contract AutoMinterFactory is IAutoMinterFactory, Initializable, UUPSUpgradeable, OwnableUpgradeable
        {
            address erc721Implementation;
            uint256 public fee;
            address erc721AImplementation;
            // contract addresses for token rewards in $AMR
            mapping(address => bool) public contractsDeployed;
            event ContractDeployed(string indexed appIdIndex, string appId, address indexed erc721Implementation, address author);
            
            function initialize() public initializer  {
                __Ownable_init_unchained();
                __UUPSUpgradeable_init();
                erc721Implementation = address(new AutoMinterERC721());
            }
            
            /* Create an NFT Collection and pay the fee */
            function create(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                string memory appId_,
                uint256 mintFee_,
                uint256 size_,
                bool mintSelectionEnabled_,
                bool mintRandomEnabled_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) payable public
            {
                require(msg.value >= fee, 'Must pass the correct fee to the contract');
                
                address payable clone = payable(ClonesUpgradeable.clone(erc721Implementation));
                AutoMinterERC721(clone).initialize(name_,
                    symbol_,
                    baseURI_,
                    msg.sender,
                    mintFee_,
                    size_,
                    mintSelectionEnabled_,
                    mintRandomEnabled_,
                    whiteListSignerAddress_,
                    mintLimit_,
                    royaltyBasis_,
                    placeholderImage_
                );
                contractsDeployed[clone] = true;
                
                emit ContractDeployed(appId_, appId_, clone, msg.sender);
            }
            
            /* Create an NFT Collection and pay the fee */
            function createConsecutive(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                string memory appId_,
                uint256 mintFee_,
                uint256 size_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) payable public
            {
                require(msg.value >= fee, 'Must pass the correct fee to the contract');
                
                address payable clone = payable(ClonesUpgradeable.clone(erc721AImplementation));
                AutoMinterERC721A(clone).initialize(name_,
                    symbol_,
                    baseURI_,
                    msg.sender,
                    mintFee_,
                    size_,
                    whiteListSignerAddress_,
                    mintLimit_,
                    royaltyBasis_,
                    placeholderImage_
                );
                
                contractsDeployed[clone] = true;
                emit ContractDeployed(appId_, appId_, clone, msg.sender);
            }
            
            /* Change the fee charged for creating contracts */
            function changeFee(uint256 newFee) onlyOwner() public {
                fee = newFee;
            }
            /* add an existing contract the the factory collection so it can be tracked */
            function addExistingCollection(address collectionAddress, address owner, string memory appId) onlyOwner() public{
                emit ContractDeployed(appId, appId, collectionAddress, owner);
            }
            
            /* Transfer balance of this contract to an account */
            function transferBalance(address payable to, uint256 ammount) onlyOwner() public{
                require(address(this).balance >= ammount);
                to.transfer(ammount);
            }
            
            function version() external pure returns (string memory)
            {
                return "1.0.6";
            }
            function setERC721Implementation(address payable implementationContract) onlyOwner() public {
                erc721Implementation = implementationContract;
            }
            function setERC721AImplementation(address payable implementationContract) onlyOwner() public {
                erc721AImplementation = implementationContract;
            }
            function isCollectionValid(address collectionAddress) public view returns (bool){
                return contractsDeployed[collectionAddress] || address(this) == collectionAddress;
            }
            function _authorizeUpgrade(address newImplementation) internal override onlyOwner() {}
            function _registerContract(address collectionAddress) private {
                contractsDeployed[collectionAddress] = true;
            }
        }// SPDX-License-Identifier: UNLICENSED
        import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
        pragma solidity >=0.7.0 <0.9.0;
        // import "@openzeppelin/contracts-upgradeable/interfaces/IERC2981Upgradeable.sol";
        /**
         * @dev Interface for the NFT Royalty Standard
         */
        interface IERC2981Upgradeable is IERC165Upgradeable {
            /**
             * @dev Called with the sale price to determine how much royalty is owed and to whom.
             * @param tokenId - the NFT asset queried for royalty information
             * @param salePrice - the sale price of the NFT asset specified by `tokenId`
             * @return receiver - address of who should be sent the royalty payment
             * @return royaltyAmount - the royalty payment amount for `salePrice`
             */
            function royaltyInfo(uint256 tokenId, uint256 salePrice)
                external
                view
                returns (address receiver, uint256 royaltyAmount);
        }
        // SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        interface IAutoMinterFactory
        {
            /* Create an NFT Collection and pay the fee */
            function create(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                string memory appId_,
                uint256 mintFee_,
                uint256 size_,
                bool mintSelectionEnabled_,
                bool mintRandomEnabled_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) payable external;
            
            /* Create an NFT Collection and pay the fee */
            function createConsecutive(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                string memory appId_,
                uint256 mintFee_,
                uint256 size_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) payable external;
            
            /* Change the fee charged for creating contracts */
            function changeFee(uint256 newFee) external;
            function addExistingCollection(address collectionAddress, address owner, string memory appId) external;
            function transferBalance(address payable to, uint256 ammount) external;
            
            function version() external pure returns (string memory);
            function setERC721Implementation(address payable implementationContract) external;
            function setERC721AImplementation(address payable implementationContract) external;
            function isCollectionValid(address collectionAddress) external view returns (bool);
        }// SPDX-License-Identifier: MIT
        pragma solidity ^0.8.0;
        /// @title Base64
        /// @author Brecht Devos - <brecht@loopring.org>
        /// @notice Provides a function for encoding some bytes in base64
        library Base64 {
            string internal constant TABLE =
                "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
            function encode(bytes memory data) internal pure returns (string memory) {
                if (data.length == 0) return "";
                // load the table into memory
                string memory table = TABLE;
                // multiply by 4/3 rounded up
                uint256 encodedLen = 4 * ((data.length + 2) / 3);
                // add some extra buffer at the end required for the writing
                string memory result = new string(encodedLen + 32);
                assembly {
                    // set the actual output length
                    mstore(result, encodedLen)
                    // prepare the lookup table
                    let tablePtr := add(table, 1)
                    // input ptr
                    let dataPtr := data
                    let endPtr := add(dataPtr, mload(data))
                    // result ptr, jump over length
                    let resultPtr := add(result, 32)
                    // run over the input, 3 bytes at a time
                    for {
                    } lt(dataPtr, endPtr) {
                    } {
                        dataPtr := add(dataPtr, 3)
                        // read 3 bytes
                        let input := mload(dataPtr)
                        // write 4 characters
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(shr(18, input), 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(shr(12, input), 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(shr(6, input), 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(input, 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                    }
                    // padding with '='
                    switch mod(mload(data), 3)
                    case 1 {
                        mstore(sub(resultPtr, 2), shl(240, 0x3d3d))
                    }
                    case 2 {
                        mstore(sub(resultPtr, 1), shl(248, 0x3d))
                    }
                }
                return result;
            }
        }pragma solidity ^0.8.4;
        import 'erc721a-upgradeable/contracts/ERC721AUpgradeable.sol';
        import '@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol';
        import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
        import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
        import "./Base64.sol";
        import "./IERC2981Upgradable.sol";
        import "./AutoMinterERC20.sol";
        /**
        * @title ERC721A Minting Contract
        * @author Osaka Toni Thomas - Autominter
        */
        contract AutoMinterERC721A is Initializable, ERC721AUpgradeable, OwnableUpgradeable, IERC2981Upgradeable
        {
            string private baseURI;
            address constant private shareAddress = 0xc00C733702248AeBDb357340ddDdA5C47500A35A;
            uint256 public MINT_FEE;
            bool private publicMintEnabled;
            
            uint256 public remaining;
            mapping(address => uint256) public accountMintCount;
            address private whiteListSignerAddress;
            uint256 public MAX_MINTS_PER_WALLET;
            uint256 public royaltyBasis = 1000;
            uint256 public ammountWithdrawn = 0;
            string public placeholderImage;
            bool public lockBaseUri;
            uint256 public reserve;
            address constant private autoMinterTokenContract = 0xfB777365B735780020f265DeF82f672E30367dbE;
            constructor(){}
            function initialize(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                address ownerAddress_,
                uint256 mintFee_,
                uint256 size_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) public initializer  {
                __ERC721A_init(name_, symbol_);
                baseURI = baseURI_;
                MINT_FEE = mintFee_;
                publicMintEnabled = true;
                _transferOwnership(ownerAddress_);
                remaining = size_;
                whiteListSignerAddress = whiteListSignerAddress_;
                MAX_MINTS_PER_WALLET = mintLimit_;
                royaltyBasis = royaltyBasis_;
                placeholderImage = placeholderImage_;
            }
            
            function _baseURI() internal view virtual override returns (string memory) {
                return baseURI;
            }
            
            /**
             * @notice Mint a "quantity" of NFTs from the collection
             * @dev You can mint using this function only when public mint is enabled
             * @param quantity The quantity of tokens that you want to mint
             */
            function mint(uint256 quantity) payable public
            {
                require(quantity > 0, 'Quantity must be greater than zero');
                require(publicMintEnabled == true, 'Public minting is not enabled for this contract yet');
                require(msg.value == MINT_FEE * quantity, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender, quantity, 0);
                _updateMintCount(quantity);
                _safeMint(msg.sender, quantity);
            }
            
            /**
             * @notice Mint tokens if you are on the access list. It is recommended to use the minting app for this
             * @dev Signature and parameters must be provided by the project creator
             */
            function mintWithSignature(bool isFree, address to, uint256 customFee, uint256 limit, uint256 quantity, bytes calldata signature) payable public
            {
                require(quantity > 0, 'Quantity must be greater than zero');
                require(quantity <= limit || limit == 0, 'You are not able to mint more than the allocated limit at once');
                _updateUserMintCount(to, quantity, limit);
                /* Hash the content (isFree, to, tokenID) and verify the signature from the owner address */
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(isFree, to, uint256(0), true, limit, customFee))),
                        signature);
                    
                require(signer == owner() || signer == whiteListSignerAddress, "The signature provided does not match");
                
                /* If isFree then do not splitPayment, else splitPayment */
                if(!isFree){
                    /* If custom fee is not provided use, mint fee */
                    if(customFee == 0){
                        require(msg.value == MINT_FEE * quantity, 'Eth sent does not match the mint fee');
                    }
                    /* If custom fee is provided use, the custom fee */
                    else{
                        require(msg.value == customFee * quantity, 'Eth sent does not match the mint fee');
                    }
                    // _splitPayment();
                }
                
                _updateMintCount(quantity);
                _safeMint(to, quantity);
            }
            
            /**
             * @notice Airdrop tokens  (ADMIN ONLY FUNCTION)
             * @dev Admins can mint tokens to specific wallets 
             * @param to Address to mint the token too
             * @param quantity The quantity of tokens that you want to airdrop
             */
            function airdrop(address to, uint256 quantity) onlyOwner() public
            {
                _updateMintCount(quantity);
                _safeMint(to, quantity);
            }
            
            /**
             * @notice Airdrop tokens to multipl wallets (ADMIN ONLY FUNCTION)
             * @dev Admins can mint tokens to specific wallets, use this to airdrop to multiple addresses 
             * @param to List of addresses to mint the token too
             */
            function airdrop(address[] calldata to) onlyOwner() public
            {
                for (uint i=0; i<to.length; i++) {
                    _updateMintCount(1);
                    _safeMint(to[i], 1);
                }
            }
            
            function _updateUserMintCount(address account, uint256 quantity, uint256 customLimit) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                if(customLimit == 0){
                    require(count + quantity <= MAX_MINTS_PER_WALLET || MAX_MINTS_PER_WALLET == 0, "Mint limit for this account has been exceeded");
                }
                else{
                    require(count + quantity <= customLimit, "Mint limit for this account has been exceeded");
                }
                accountMintCount[account] = count + quantity;
            }
            
            function _updateMintCount(uint256 quantity) internal {
                require(quantity <= remaining, "Not enough mints remaining");
                require(quantity <= remaining - reserve, "Not enough unreserved mints available");
                remaining -= quantity;
            }
            
            function isTokenAvailable(uint256 tokenID) external view returns (bool)
            {
                return !_exists(tokenID);
            }
            /**
             * @notice Turn on or off the ability for anyone to mint (ADMIN ONLY FUNCTION)
             * @dev Admins can mint tokens to specific wallets, use this to airdrop to multiple addresses 
             */
            function togglePublicMinting() onlyOwner() public
            {
                publicMintEnabled = !publicMintEnabled;
            }
            /**
             * @notice Change the default mint price (ADMIN ONLY FUNCTION)
             * @dev Admins can change the mint price for the initial minting of tokens
             * @param mintFee_ The price to set the mint too in WEI
             */
            function changeMintFee(uint256 mintFee_) onlyOwner() public
            {
                MINT_FEE = mintFee_;
            }
            /**
             * @notice Change the max mints per wallet (ADMIN ONLY FUNCTION)
             * @dev Admins can change the max number of mints per wallet (0 = unlimitted)
             * @param mintLimit_ The maximum number of mints per wallet
             */
            function changeMintLimit(uint256 mintLimit_) onlyOwner() public
            {
                MAX_MINTS_PER_WALLET = mintLimit_;
            }
            /**
             * @notice Change the number of reserved NFTs (ADMIN ONLY FUNCTION)
             * @dev Admins can change the number of NFTs which cannot be minted and will be reserved
             * @param ammount The number of tokens to reserve
             */
            function updateReserveAmmount(uint256 ammount) onlyOwner() public
            {
                require(ammount <= remaining, "Reserve ammount must be less than remaining quantity");
                reserve = ammount;
            }
            /**
             * @notice Change the image for delayed reveal (ADMIN ONLY FUNCTION)
             * @dev Admins can change the delayed reveal image, only if the artwork has not been revealed yet
             * @param placeholderImage_ the uri of the image to use
             */
            function changePlaceholderImage(string memory placeholderImage_) onlyOwner() public
            {
                require(bytes(placeholderImage).length != 0, "Metadata has already been revealed");
                require(bytes(placeholderImage_).length != 0, "Placeholder image cannot be empty");
                placeholderImage = placeholderImage_;
            }
            function royaltyInfo(uint _tokenId, uint _salePrice) external view returns (address receiver, uint royaltyAmount) {
                return (address(this), uint((_salePrice * royaltyBasis)/10000));
            }
            
            /**
             * @notice Transfer the balance of in contract (ADMIN ONLY FUNCTION)
             * @dev Admins can transfer the balance in the contract
             * @param to the address to send funds too
             * @param ammount the ammount to transfer in WEI ((Make equal to balance)
             */
            function transferBalance(address payable to, uint256 ammount) onlyOwner() public{
                
                if(address(this).balance != 0){
                    require(address(this).balance <= ammount, "Not enought Balance to Transfer");
                    uint256 splitValue = ammount / 20;
                    uint256 remainingValue = ammount - splitValue;
                    
                    // if mainnet, earn tokens
                    if(block.chainid == 1 || block.chainid == 5 || block.chainid == 5777){
                        _mintAutoMinterTokens(to, splitValue);
                    }
                    else{
                        payable(shareAddress).transfer(splitValue);
                    }
                    
                    payable(to).transfer(remainingValue);
                    ammountWithdrawn += ammount;
                }
            }
            
            /**
             * @notice Transfer ERC20  balance of in contract (ADMIN ONLY FUNCTION)
             * @dev Admins can transfer the balance in the contract
             * @param erc20ContractAddress the address of the ERC20 token which is held and should be transfered
             * @param to the address to send
             * @param ammount the ammount to transfer in the base unit of the ERC20 token
             */
            function transferERC20Balance(address erc20ContractAddress, address payable to, uint256 ammount) onlyOwner() public{
                uint256 splitValue = ammount / 10;
                uint256 remainingValue = ammount - splitValue;
                IERC20(erc20ContractAddress).transfer(shareAddress, splitValue);
                IERC20(erc20ContractAddress).transfer(to, remainingValue);
            }
            
            function contractURI() public view returns (string memory) {
                return string(abi.encodePacked(
                    "data:application/json;base64,",
                    Base64.encode(
                        bytes(
                            string(abi.encodePacked('{"name":"', name(), '","seller_fee_basis_points":', Strings.toString(royaltyBasis), ',"fee_recipient":"', "0x", toAsciiString(address(this)), '"}' ))
                        )
                    )
                ));
            }
            function toAsciiString(address x) internal pure returns (string memory) {
                bytes memory s = new bytes(40);
                for (uint i = 0; i < 20; i++) {
                    bytes1 b = bytes1(uint8(uint(uint160(x)) / (2**(8*(19 - i)))));
                    bytes1 hi = bytes1(uint8(b) / 16);
                    bytes1 lo = bytes1(uint8(b) - 16 * uint8(hi));
                    s[2*i] = char(hi);
                    s[2*i+1] = char(lo);            
                }
                return string(s);
            }
            function char(bytes1 b) internal pure returns (bytes1 c) {
                if (uint8(b) < 10) return bytes1(uint8(b) + 0x30);
                else return bytes1(uint8(b) + 0x57);
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721AUpgradeable, IERC165Upgradeable) returns (bool) {
                return
                    interfaceId == type(IERC721AUpgradeable).interfaceId ||
                    // interfaceId == type(IERC721AMetadataUpgradeable).interfaceId ||
                    interfaceId == type(IERC2981Upgradeable).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            function IS_PUBLIC_MINTING_OPEN() external view returns (bool){
                return publicMintEnabled;
            }
            
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                string memory baseURI = _baseURI();
                if(bytes(placeholderImage).length > 0){
                    return placeholderImage;
                }
                else{
                    return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, Strings.toString(tokenId))) : "";
                }
            }
            /**
             * @notice Reveal the artwork (ADMIN ONLY FUNCTION)
             * @dev Reveal the artwork if you have delayed reveal on
             */
            function reveal() onlyOwner() public {
                placeholderImage = "";
            }
            /**
             * @notice Change the base URI for the artwork and metadata (ADMIN ONLY FUNCTION)
             * @dev You can change the base tokenURI if you have not locked the base uri from being updated
             * @param baseURI_ URI of the collection
             */
            function changeBaseUri(string memory baseURI_) onlyOwner() public {
                require(!lockBaseUri, "Base URI is locked, it cannot be edited");
                baseURI = baseURI_;
            }
            /**
             * @notice Permenantly lock the base URI so the artwork can never be changed (ADMIN ONLY FUNCTION)
             * @dev Lock the base uri so that it is permenant and cannot be changed in the future ever
             */
            function permanentlyLockBaseUri() onlyOwner() public {
                lockBaseUri = true;
            }
            function getMintsUsed(address account) external view returns (uint256) {
                return accountMintCount[account];
            }
            function _mintAutoMinterTokens(address to, uint256 value) private {
                AutoMinterERC20(autoMinterTokenContract).mint{value:value}(to);
            }
            
            function version() external pure returns (string memory)
            {
                return "2.0.1";
            }
            receive() external payable {}
        }
        // SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        // import '@openzeppelin/contracts/token/ERC721/ERC721.sol';
        import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
        import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
        import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
        import "./Base64.sol";
        import "./IERC2981Upgradable.sol";
        import "./AutoMinterERC20.sol";
        contract AutoMinterERC721 is Initializable, ERC721Upgradeable, OwnableUpgradeable, IERC2981Upgradeable
        {
            string private baseURI;
            address constant public shareAddress = 0xE28564784a0f57554D8beEc807E8609b40A97241;
            uint256 public mintFee;
            bool private mintSelectionEnabled;
            bool private mintRandomEnabled;
            
            uint256 public remaining;
            mapping(uint256 => uint256) public cache;
            mapping(uint256 => uint256) public cachePosition;
            mapping(address => uint256) public accountMintCount;
            address private whiteListSignerAddress;
            uint256 public mintLimit;
            uint256 public royaltyBasis = 1000;
            uint256 public ammountWithdrawn = 0;
            string public placeholderImage;
            bool public lockBaseUri;
            address constant private autoMinterTokenContract = 0xc00C733702248AeBDb357340ddDdA5C47500A35A;
            constructor(){}
            function initialize(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                address ownerAddress_,
                uint256 mintFee_,
                uint256 size_,
                bool mintSelectionEnabled_,
                bool mintRandomEnabled_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) public initializer  {
                __ERC721_init(name_, symbol_);
                baseURI = baseURI_;
                mintFee = mintFee_;
                mintSelectionEnabled = mintSelectionEnabled_;
                mintRandomEnabled = mintRandomEnabled_;
                _transferOwnership(ownerAddress_);
                remaining = size_;
                whiteListSignerAddress = whiteListSignerAddress_;
                mintLimit = mintLimit_;
                royaltyBasis = royaltyBasis_;
                placeholderImage = placeholderImage_;
            }
            
            function _baseURI() internal view virtual override returns (string memory) {
                return baseURI;
            }
            
            /* Mint specific token if individual token selection is enabled */
            function mintToken(uint256 tokenID) payable public
            {
                require(mintSelectionEnabled == true, 'Specific token minting is not enabled for this contract');
                require(msg.value == mintFee, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender);
                // _splitPayment();
                
                _drawIndex(tokenID);
                
                _safeMint(msg.sender, tokenID);
            }
            
            /* Mint random token if random minting is enabled */
            function mintRandom() payable public
            {
                require(mintRandomEnabled == true, 'Random minting is not enabled for this contract');
                require(msg.value == mintFee, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender);
                
                // _splitPayment();
                
                uint256 tokenID = _drawRandomIndex();
                
                _safeMint(msg.sender, tokenID);
            }
            
            /* Mint 'n' random tokens if random minting is enabled */
            function mintRandom(uint256 count) payable public
            {
                require(count > 0, 'Count must be greater than zero');
                require(mintRandomEnabled == true, 'Random minting is not enabled for this contract');
                require(msg.value == mintFee * count, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender, count);
                for(uint256 i=0; i < count; i++){
                    
                    // _splitPayment();
                    
                    uint256 tokenID = _drawRandomIndex();
                    
                    _safeMint(msg.sender, tokenID);
                }
            }
            
            /* Mint if have been pre-approved using signature of the owner */
            function mintWithSignature(bool isFree, address to, uint256 tokenID, bool isRandom, uint256 customFee, bytes calldata signature) payable public
            {
                _updateUserMintCount(to);
                /* Hash the content (isFree, to, tokenID) and verify the signature from the owner address */
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(isFree, to, tokenID, isRandom, customFee))),
                        signature);
                    
                require(signer == owner() || signer == whiteListSignerAddress, "The signature provided does not match");
                
                /* If isFree then do not splitPayment, else splitPayment */
                if(!isFree){
                    /* If custom fee is not provided use, mint fee */
                    if(customFee == 0){
                        require(msg.value == mintFee, 'Eth sent does not match the mint fee');
                    }
                    /* If custom fee is provided use, the custom fee */
                    else{
                        require(msg.value == customFee, 'Eth sent does not match the mint fee');
                    }
                    // _splitPayment();
                }
                
                /* Mint the token for the provided to address */
                if(isRandom){
                    tokenID = _drawRandomIndex();
                }
                else{
                    _drawIndex(tokenID);
                }
                
                _safeMint(to, tokenID);
            }
            /* Mint 'n' tokens if have been pre-approved using signature of the owner */
            function mintWithSignature(bool isFree, address to, uint256 tokenID, bool isRandom, uint256 customFee, uint256 limit, uint256 count, bytes calldata signature) payable public
            {
                require(count > 0, 'Count must be greater than zero');
                require(count <= limit || limit == 0, 'You are not able to mint more than the allocated limit at once');
                _updateUserMintCount(to, count, limit);
                /* Hash the content (isFree, to, tokenID) and verify the signature from the owner address */
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(isFree, to, tokenID, isRandom, limit, customFee))),
                        signature);
                    
                require(signer == owner() || signer == whiteListSignerAddress, "The signature provided does not match");
                
                /* If isFree then do not splitPayment, else splitPayment */
                if(!isFree){
                    /* If custom fee is not provided use, mint fee */
                    if(customFee == 0){
                        require(msg.value == mintFee * count, 'Eth sent does not match the mint fee');
                    }
                    /* If custom fee is provided use, the custom fee */
                    else{
                        require(msg.value == customFee * count, 'Eth sent does not match the mint fee');
                    }
                    // _splitPayment();
                }
                
                
                for(uint256 i=0; i < count; i++){
                    /* Mint the token for the provided to address */
                    if(isRandom){
                        tokenID = _drawRandomIndex();
                    }
                    else{
                        _drawIndex(tokenID);
                    }
                    
                    _safeMint(to, tokenID);
                }
            }
            
            /* Mint a token to a specific address */
            function mintToAccount(address to, uint256 tokenID) onlyOwner() public
            {
                _drawIndex(tokenID);
                _safeMint(to, tokenID);
            }
            
            /* Mint a token to a specific address */
            function airDropRandomToAccounts(address[] calldata to) onlyOwner() public
            {
                for (uint i=0; i<to.length; i++) {
                    uint256 tokenID = _drawRandomIndex();
                    _safeMint(to[i], tokenID);
                }
            }
            
            // function _splitPayment() internal
            // {
            //     if(msg.value != 0){
            //         uint256 splitValue = msg.value / 10;
            //         uint256 remainingValue = msg.value - splitValue;
                    
            //         payable(shareAddress).transfer(splitValue);
            //         payable(owner()).transfer(remainingValue);
            //     }
            // }
            
            function _drawRandomIndex() internal returns (uint256 index) {
                //RNG
                uint256 i = uint(keccak256(abi.encodePacked(block.timestamp))) % remaining;
                // if there's a cache at cache[i] then use it
                // otherwise use i itself
                index = cache[i] == 0 ? i : cache[i];
                // grab a number from the tail
                cache[i] = cache[remaining - 1] == 0 ? remaining - 1 : cache[remaining - 1];
                
                // store the position of moved token in cache to be looked up (add 1 to avoid 0, remove when recovering)
                cachePosition[cache[i]] = i + 1;
                
                remaining = remaining - 1;
            }
            
            function _drawIndex(uint256 tokenID) internal {
                // recover the index, subtract 1 from cachePosition as an additional 1 was added to avoid 0 conflict
                uint256 i = cachePosition[tokenID] == 0 ? tokenID : cachePosition[tokenID] - 1;
                
                require(i <= remaining);
                
                // grab a number from the tail
                cache[i] = cache[remaining - 1] == 0 ? remaining - 1 : cache[remaining - 1];
                
                // store the position of moved token in cache to be looked up (add 1 to avoid 0, remove when recovering)
                cachePosition[cache[i]] = i + 1;
                
                remaining = remaining - 1;
            }
            
            function _updateUserMintCount(address account) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                require(count < mintLimit || mintLimit == 0, "Mint limit for this account has been exceeded");
                accountMintCount[account] = count + 1;
            }
            
            function _updateUserMintCount(address account, uint256 quantity) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                require(count + quantity <= mintLimit || mintLimit == 0, "Mint limit for this account has been exceeded");
                accountMintCount[account] = count + quantity;
            }
            
            function _updateUserMintCount(address account, uint256 quantity, uint256 customLimit) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                if(customLimit == 0){
                    require(count + quantity <= mintLimit || mintLimit == 0, "Mint limit for this account has been exceeded");
                }
                else{
                    require(count + quantity <= customLimit, "Mint limit for this account has been exceeded");
                }
                accountMintCount[account] = count + quantity;
            }
            
            function isTokenAvailable(uint256 tokenID) external view returns (bool)
            {
                return !_exists(tokenID);
            }
            function toggleRandomPublicMinting() onlyOwner() public
            {
                mintRandomEnabled = !mintRandomEnabled;
            }
            function changeMintFee(uint256 mintFee_) onlyOwner() public
            {
                mintFee = mintFee_;
            }
            function changeMintLimit(uint256 mintLimit_) onlyOwner() public
            {
                mintLimit = mintLimit_;
            }
            function changePlaceholderImage(string memory placeholderImage_) onlyOwner() public
            {
                require(bytes(placeholderImage).length != 0, "Metadata has already been revealed");
                require(bytes(placeholderImage_).length != 0, "Placeholder image cannot be empty");
                placeholderImage = placeholderImage_;
            }
            function royaltyInfo(uint _tokenId, uint _salePrice) external view returns (address receiver, uint royaltyAmount) {
                return (address(this), uint((_salePrice * royaltyBasis)/10000));
            }
            
            /* Transfer balance of this contract to an account */
            function transferBalance(address payable to, uint256 ammount) onlyOwner() public{
                
                if(address(this).balance != 0){
                    require(address(this).balance <= ammount, "Not enought Balance to Transfer");
                    uint256 splitValue = ammount / 20;
                    uint256 remainingValue = ammount - splitValue;
                    
                    // if mainnet, earn tokens
                    if(block.chainid == 1 || block.chainid == 5 || block.chainid == 5777){
                        _mintAutoMinterTokens(to, splitValue);
                    }
                    else{
                        payable(shareAddress).transfer(splitValue);
                    }
                    payable(to).transfer(remainingValue);
                    ammountWithdrawn += ammount;
                }
            }
            
            /* Transfer any ERC20 balance of this contract to an account */
            function transferERC20Balance(address erc20ContractAddress, address payable to, uint256 ammount) onlyOwner() public{
                uint256 splitValue = ammount / 10;
                uint256 remainingValue = ammount - splitValue;
                IERC20(erc20ContractAddress).transfer(shareAddress, splitValue);
                IERC20(erc20ContractAddress).transfer(to, remainingValue);
            }
            
            function contractURI() public view returns (string memory) {
                return string(abi.encodePacked(
                    "data:application/json;base64,",
                    Base64.encode(
                        bytes(
                            string(abi.encodePacked('{"name":"', name(), '","seller_fee_basis_points":', Strings.toString(royaltyBasis), ',"fee_recipient":"', "0x", toAsciiString(address(this)), '"}' ))
                        )
                    )
                ));
            }
            function toAsciiString(address x) internal pure returns (string memory) {
                bytes memory s = new bytes(40);
                for (uint i = 0; i < 20; i++) {
                    bytes1 b = bytes1(uint8(uint(uint160(x)) / (2**(8*(19 - i)))));
                    bytes1 hi = bytes1(uint8(b) / 16);
                    bytes1 lo = bytes1(uint8(b) - 16 * uint8(hi));
                    s[2*i] = char(hi);
                    s[2*i+1] = char(lo);            
                }
                return string(s);
            }
            function char(bytes1 b) internal pure returns (bytes1 c) {
                if (uint8(b) < 10) return bytes1(uint8(b) + 0x30);
                else return bytes1(uint8(b) + 0x57);
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721Upgradeable, IERC165Upgradeable) returns (bool) {
                return
                    interfaceId == type(IERC721Upgradeable).interfaceId ||
                    interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                    interfaceId == type(IERC2981Upgradeable).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            function isPublicMintingEnabled() external view returns (bool){
                return mintRandomEnabled;
            }
            
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                string memory baseURI = _baseURI();
                if(bytes(placeholderImage).length > 0){
                    return placeholderImage;
                }
                else{
                    return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, Strings.toString(tokenId))) : "";
                }
            }
            function reveal() onlyOwner() public {
                placeholderImage = "";
            }
            function changeBaseUri(string memory baseURI_) onlyOwner() public {
                require(!lockBaseUri, "Base URI is locked, it cannot be edited");
                baseURI = baseURI_;
            }
            function permanentlyLockBaseUri() onlyOwner() public {
                lockBaseUri = true;
            }
            function getMintsUsed(address account) external view returns (uint256) {
                return accountMintCount[account];
            }
            function _mintAutoMinterTokens(address to, uint256 value) private {
                AutoMinterERC20(autoMinterTokenContract).mint{value:value}(to);
            }
            
            function version() external pure returns (string memory)
            {
                return "1.0.7";
            }
            receive() external payable {}
        }
        // SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
        import "@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol";
        import '@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol';
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "./IAutoMinterFactory.sol";
        contract AutoMinterERC20 is Initializable, ERC20Upgradeable, OwnableUpgradeable {
            
            // revenue supplied to the contract
            uint256 private revenue;
            // the signer address for verifying airdrops
            address private airdropSignerAddress;
            // the quantity of supply claimed in the airdrop
            uint256 private quantityClaimed;
            // the max supply to be claimed in the airdrop
            uint256 private airdropLimit;
            // the address of the staking contract
            address private stakingContract;
            // the address of the treasury, team, investor treasury fund contract
            address private fundsContract;
            // the amount that each account has claimed in the airdrop
            mapping(address => bool) public accountClaimed;
            
            // AutoMinter Factory contract to check valid collection addresses
            IAutoMinterFactory private autoMinterFactory;
            // the integer representing the current lock window
            uint256 public currentLockWindow;
            // is airdrop tradable
            bool public isAirdropTradable;
            struct LockInfo {
                uint256 lockWindow;
                uint256 totalLockAmount;
                uint256 currentLockWindowAmount;
                uint256 previousLockWindowAmount;
                uint256 lastLockWindowAmount;
                uint256 airdropAmount;
            }
            mapping(address => LockInfo) private accountLockedTokens;
            // the max supply reserved for strategic sale + liquidity provision
            uint256 private strategicLiquidityLimit;
            // the quantity of supply strategic liquidity released
            uint256 private strategicLiquidityReleased;
            constructor() {}
            function initialize(address stakingContract_, address fundsContract_, address autoMinterFactoryContract_) public virtual initializer {
                __ERC20_init("AutoMinter", "AMR");
                _transferOwnership(msg.sender);
                airdropSignerAddress = msg.sender;
                stakingContract = stakingContract_;
                fundsContract = fundsContract_;
                airdropLimit = 2000000000000000000000000;
                strategicLiquidityLimit = 2000000000000000000000000;
                autoMinterFactory = IAutoMinterFactory(autoMinterFactoryContract_);
            }
            
            /**
             * @notice Claim the initil airdropped tokens
             * @dev Claim the initial allocation of tokens by providing the correct signature
             * @param amount the amount of tokens available to mint
             * @param signature the signature required to prove airdrop rights
             */
            function claim(uint256 amount, bytes calldata signature, address to) public
            {
                // check airdrop supply for a cap on how much can be claimed in the airdrop
                require(airdropLimit >= quantityClaimed + amount);
                // wallets can only claim 1 airdrop
                require(accountClaimed[to] == false);
                // Hash the content (amount, claimant) and verify the signature from the owner address
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(amount, to))),
                        signature);
                // check signature is valid
                require(signer == owner() || signer == airdropSignerAddress, "The signature provided does not match");
                // set claimant claim status to true
                accountClaimed[to] = true;
                accountLockedTokens[to].airdropAmount = amount;
                // mint the provided number of tokens
                _mint(to, amount);
            }
            /**
             * @notice Mint new tokens
             * @dev Exchange ETH for tokens by sending revenue
             * @param to the address which tokens should be minted too
             */
            function mint(address to) payable public
            {
                // require contract caller to be a registered contract to avoid direct mints
                require(autoMinterFactory.isCollectionValid(msg.sender), "Tokens can only be minted via contracts created with AutoMinter");
                // get value exchanged for tokens (decreasing marginal amount)
                uint256 value = _getValueDeduction(msg.sender, msg.value);
                // get the new number of tokens to mint (based on allocation curve)
                uint256 currentSupply = _getTotalAllocation(revenue);
                uint256 newSupply = _getTotalAllocation(revenue + value);
                uint256 diff = newSupply - currentSupply;
                uint256 volumeRewardsQuantity = diff  * 35 / 96;
                uint256 stakingRewardsQuantity = diff  * 17 / 96;
                uint256 fundsQuantity = diff  * 46 / 96;
                // lock new volume reward tokens
                _updateLockedTokens(to, volumeRewardsQuantity);
                // mint tokens based on new allocation (getAllocation)
                _mint(to, volumeRewardsQuantity);
                _mint(fundsContract, fundsQuantity);
                _mint(stakingContract, stakingRewardsQuantity);
                // update revenue
                revenue = revenue + value;
            }
            /**
             * @notice Transfer funds from the contract
             * @dev Transfer funds from the contract
             */
            function transferFunds() onlyOwner() public
            {
                uint256 balance = address(this).balance;
                payable(owner()).transfer(balance);
            }
            /**
             * @notice update the signer address for claimable airdrop
             * @dev the signer is the address who signs the claimable airdrop required signature
             */
            function updateSigner(address signer) onlyOwner() public
            {
                airdropSignerAddress = signer;
            }
            /**
             * @notice update the signer address for claimable airdrop
             * @dev the signer is the address who signs the claimable airdrop required signature
             */
            function updateStakingContract(address stakingContract_) onlyOwner() public
            {
                stakingContract = stakingContract_;
            }
            /**
             * @notice update the autominter factory address for validating source
             * @dev update the autominter factory address for validating source
             */
            function updateFactoryContract(address autoMinterFactoryContract_) onlyOwner() public
            {
                autoMinterFactory = IAutoMinterFactory(autoMinterFactoryContract_);
            }
            /**
             * @notice allow airdrop to be tradable
             * @dev allow airdropped tokens to be tradable and unlocked
             */
            function unlockAirdropTokens() onlyOwner() public
            {
                isAirdropTradable = true;
            }
            /**
             * @notice move the next lock window for users tokens to be unlocked
             * @dev move the next lock window period forward to unlock new tokens
             */
            function nextLockWindow() onlyOwner() public
            {
                currentLockWindow += 1;
            }
            
            /**
             * @notice check if wallet has claimed airdrop
             * @dev check if the provided wallet has already claimed the airdrop
             * @param account account to check claimed status
             */
            function hasClaimedAirdrop(address account) external view returns (bool)
            {
                return accountClaimed[account];
            }
            
            /**
             * @notice Move the strategic liquidity tokens
             * @dev The reserve of tokens reserved for liquidity provisioning and strategic sale
             * @param amount how much of the reserves to move in wei
             * @param to the address to send the reserves too
             */
            function moveStrategicLiquidityReserves(uint256 amount, address to) onlyOwner() public
            {
                // check airdrop supply for a cap on how much can be claimed in the airdrop
                require(strategicLiquidityLimit >= strategicLiquidityReleased + amount);
                strategicLiquidityReleased += amount;
                // mint the provided number of tokens
                _mint(to, amount);
            }
            /**
             * @notice get the number of locked tokens
             * @dev get the number of locked tokens for an account
             * @param account account to check locked token amount
             */
            function getLockedTokens(address account) external view returns (uint256)
            {
                return _getLockedTokens(account);
            }
            
            /**
             * @notice get the number of locked tokens
             * @dev get the number of locked tokens for an account
             * @param account account to check locked token amount
             */
            function _getLockedTokens(address account)  private view returns (uint256)
            {
                uint256 lockedAmount = 0;
                LockInfo storage lockInfo = accountLockedTokens[account];
                if(!isAirdropTradable){
                    lockedAmount += lockInfo.airdropAmount;
                }
                
                uint256 windowsSkipped = currentLockWindow - lockInfo.lockWindow;
                if(windowsSkipped == 0){
                    lockedAmount += lockInfo.currentLockWindowAmount + lockInfo.previousLockWindowAmount + lockInfo.lastLockWindowAmount;
                }
                else if(windowsSkipped == 1){
                    lockedAmount += lockInfo.currentLockWindowAmount + lockInfo.previousLockWindowAmount;
                }
                else if(windowsSkipped == 2){
                    lockedAmount += lockInfo.currentLockWindowAmount;
                }
                else{
                    // ignore all lock measures
                }
                return lockedAmount;
            }
            /**
             * @notice update the number of locked tokens for a user
             * @dev update the number of locked tokens for a user
             * @param account account to lock tokens for
             * @param account new number of tokens to lock
             */
            function _updateLockedTokens(address account, uint256 amount) private
            {
                LockInfo storage lockInfo = accountLockedTokens[account];
                // do nothing if amount is 0 and lock window is the same
                if(lockInfo.lockWindow == currentLockWindow && amount == 0){
                    return;
                }
                // if the lock window hasnt altered since the last update, update the lock amounts for the current window and total
                else if(lockInfo.lockWindow == currentLockWindow){
                    accountLockedTokens[account].totalLockAmount += amount;
                    accountLockedTokens[account].currentLockWindowAmount += amount;
                    return;
                }
                // if the lock window has altered by 1, then unlock the oldest tokens, and move the rest
                else if(lockInfo.lockWindow + 1 == currentLockWindow){
                    // update lock window
                    accountLockedTokens[account].lockWindow = currentLockWindow;
                    // move previous locked tokens to last
                    accountLockedTokens[account].lastLockWindowAmount = lockInfo.previousLockWindowAmount;
                    
                    // move current tokens to previous
                    accountLockedTokens[account].previousLockWindowAmount = lockInfo.currentLockWindowAmount;
                    // update current locked tokens
                    accountLockedTokens[account].currentLockWindowAmount = amount;
                    // total count increass by new tokens, decreases by releasing the last lock window tokens
                    accountLockedTokens[account].totalLockAmount += amount - lockInfo.lastLockWindowAmount;
                    return;
                }
                // if the lock window has altered by 2, then unlock the oldest and previous tokens, and move the rest
                else if(lockInfo.lockWindow + 2 == currentLockWindow){
                    // update lock window
                    accountLockedTokens[account].lockWindow = currentLockWindow;
                    // move current locked tokens to last
                    accountLockedTokens[account].lastLockWindowAmount = lockInfo.currentLockWindowAmount;
                    // update current locked tokens
                    accountLockedTokens[account].currentLockWindowAmount = amount;
                    // total count increass by new tokens, decreases by releasing the last lock window tokens and previous tokens
                    accountLockedTokens[account].totalLockAmount += amount - lockInfo.lastLockWindowAmount - lockInfo.previousLockWindowAmount;
                    return;
                }
                // if the lock window has altered by 3 or more, then unlock all tokens
                else{
                    // update lock window
                    accountLockedTokens[account].lockWindow = currentLockWindow;
                    // move last locked tokens to last
                    accountLockedTokens[account].lastLockWindowAmount = 0;
                    // move previous locked tokens to last
                    accountLockedTokens[account].previousLockWindowAmount = 0;
                    // update current locked tokens
                    accountLockedTokens[account].currentLockWindowAmount = amount;
                    // total count increass by new tokens, decreases by releasing the last lock window tokens and previous tokens
                    accountLockedTokens[account].totalLockAmount += amount;
                    return;
                }
            }
            /**
             * @notice Get the number of tokens allocated based on revenue
             * @dev The allocation curve determines how many tokens are allocated in total
             * @param amount the revenue to determine the current value
             * @return uint256 the amount of tokens be exchanged
             */
            function _getTotalAllocation(uint256 amount) pure private returns (uint256)
            {
                // get the current token supply based on revenue
                uint256 supply = 20000000000000000000000000 + (980000000000000000000000000 * amount + 10000000000000000000000) / (amount + 5000000000000000000000);
                
                return supply;
            }
            /**
             * @notice Get the equivilent value of revenue paid to be exchanged for new tokens
             * @dev The more tokens are minted, the less marginally you will get next time
             * @param source the source of extraction
             * @param amount the amount to be exchanged
             * @return uint256 the equivilent value to be exchanged
             */
            function _getValueDeduction(address source, uint256 amount) pure private returns (uint256)
            {
                return amount;
            }
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 amount
            ) internal virtual override(ERC20Upgradeable) {
                super._beforeTokenTransfer(from, to, amount);
                // _updateLockedTokens(from, 0);
                require(from == address(0) || super.balanceOf(from) - _getLockedTokens(from) >= amount, "AutoMinterERC20: Transfer amount exceeds unlocked token amount");
            }
        }// SPDX-License-Identifier: MIT
        // ERC721A Contracts v3.3.0
        // Creator: Chiru Labs
        pragma solidity ^0.8.4;
        import "@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/IERC721MetadataUpgradeable.sol";
        /**
         * @dev Interface of an ERC721A compliant contract.
         */
        interface IERC721AUpgradeable is IERC721Upgradeable, IERC721MetadataUpgradeable {
            /**
             * The caller must own the token or be an approved operator.
             */
            error ApprovalCallerNotOwnerNorApproved();
            /**
             * The token does not exist.
             */
            error ApprovalQueryForNonexistentToken();
            /**
             * The caller cannot approve to their own address.
             */
            error ApproveToCaller();
            /**
             * The caller cannot approve to the current owner.
             */
            error ApprovalToCurrentOwner();
            /**
             * Cannot query the balance for the zero address.
             */
            error BalanceQueryForZeroAddress();
            /**
             * Cannot mint to the zero address.
             */
            error MintToZeroAddress();
            /**
             * The quantity of tokens minted must be more than zero.
             */
            error MintZeroQuantity();
            /**
             * The token does not exist.
             */
            error OwnerQueryForNonexistentToken();
            /**
             * The caller must own the token or be an approved operator.
             */
            error TransferCallerNotOwnerNorApproved();
            /**
             * The token must be owned by `from`.
             */
            error TransferFromIncorrectOwner();
            /**
             * Cannot safely transfer to a contract that does not implement the ERC721Receiver interface.
             */
            error TransferToNonERC721ReceiverImplementer();
            /**
             * Cannot transfer to the zero address.
             */
            error TransferToZeroAddress();
            /**
             * The token does not exist.
             */
            error URIQueryForNonexistentToken();
            // Compiler will pack this into a single 256bit word.
            struct TokenOwnership {
                // The address of the owner.
                address addr;
                // Keeps track of the start time of ownership with minimal overhead for tokenomics.
                uint64 startTimestamp;
                // Whether the token has been burned.
                bool burned;
            }
            // Compiler will pack this into a single 256bit word.
            struct AddressData {
                // Realistically, 2**64-1 is more than enough.
                uint64 balance;
                // Keeps track of mint count with minimal overhead for tokenomics.
                uint64 numberMinted;
                // Keeps track of burn count with minimal overhead for tokenomics.
                uint64 numberBurned;
                // For miscellaneous variable(s) pertaining to the address
                // (e.g. number of whitelist mint slots used).
                // If there are multiple variables, please pack them into a uint64.
                uint64 aux;
            }
            /**
             * @dev Returns the total amount of tokens stored by the contract.
             * 
             * Burned tokens are calculated here, use `_totalMinted()` if you want to count just minted tokens.
             */
            function totalSupply() external view returns (uint256);
        }
        // SPDX-License-Identifier: MIT
        // ERC721A Contracts v3.3.0
        // Creator: Chiru Labs
        pragma solidity ^0.8.4;
        import "./IERC721AUpgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/token/ERC721/IERC721ReceiverUpgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        /**
         * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
         * the Metadata extension. Built to optimize for lower gas during batch mints.
         *
         * Assumes serials are sequentially minted starting at _startTokenId() (defaults to 0, e.g. 0, 1, 2, 3..).
         *
         * Assumes that an owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
         *
         * Assumes that the maximum token id cannot exceed 2**256 - 1 (max value of uint256).
         */
        contract ERC721AUpgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721AUpgradeable {
            using AddressUpgradeable for address;
            using StringsUpgradeable for uint256;
            // The tokenId of the next token to be minted.
            uint256 internal _currentIndex;
            // The number of tokens burned.
            uint256 internal _burnCounter;
            // Token name
            string private _name;
            // Token symbol
            string private _symbol;
            // Mapping from token ID to ownership details
            // An empty struct value does not necessarily mean the token is unowned. See _ownershipOf implementation for details.
            mapping(uint256 => TokenOwnership) internal _ownerships;
            // Mapping owner address to address data
            mapping(address => AddressData) private _addressData;
            // Mapping from token ID to approved address
            mapping(uint256 => address) private _tokenApprovals;
            // Mapping from owner to operator approvals
            mapping(address => mapping(address => bool)) private _operatorApprovals;
            function __ERC721A_init(string memory name_, string memory symbol_) internal onlyInitializing {
                __ERC721A_init_unchained(name_, symbol_);
            }
            function __ERC721A_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                _name = name_;
                _symbol = symbol_;
                _currentIndex = _startTokenId();
            }
            /**
             * To change the starting tokenId, please override this function.
             */
            function _startTokenId() internal view virtual returns (uint256) {
                return 0;
            }
            /**
             * @dev Burned tokens are calculated here, use _totalMinted() if you want to count just minted tokens.
             */
            function totalSupply() public view override returns (uint256) {
                // Counter underflow is impossible as _burnCounter cannot be incremented
                // more than _currentIndex - _startTokenId() times
                unchecked {
                    return _currentIndex - _burnCounter - _startTokenId();
                }
            }
            /**
             * Returns the total amount of tokens minted in the contract.
             */
            function _totalMinted() internal view returns (uint256) {
                // Counter underflow is impossible as _currentIndex does not decrement,
                // and it is initialized to _startTokenId()
                unchecked {
                    return _currentIndex - _startTokenId();
                }
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
                return
                    interfaceId == type(IERC721Upgradeable).interfaceId ||
                    interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721-balanceOf}.
             */
            function balanceOf(address owner) public view override returns (uint256) {
                if (owner == address(0)) revert BalanceQueryForZeroAddress();
                return uint256(_addressData[owner].balance);
            }
            /**
             * Returns the number of tokens minted by `owner`.
             */
            function _numberMinted(address owner) internal view returns (uint256) {
                return uint256(_addressData[owner].numberMinted);
            }
            /**
             * Returns the number of tokens burned by or on behalf of `owner`.
             */
            function _numberBurned(address owner) internal view returns (uint256) {
                return uint256(_addressData[owner].numberBurned);
            }
            /**
             * Returns the auxillary data for `owner`. (e.g. number of whitelist mint slots used).
             */
            function _getAux(address owner) internal view returns (uint64) {
                return _addressData[owner].aux;
            }
            /**
             * Sets the auxillary data for `owner`. (e.g. number of whitelist mint slots used).
             * If there are multiple variables, please pack them into a uint64.
             */
            function _setAux(address owner, uint64 aux) internal {
                _addressData[owner].aux = aux;
            }
            /**
             * Gas spent here starts off proportional to the maximum mint batch size.
             * It gradually moves to O(1) as tokens get transferred around in the collection over time.
             */
            function _ownershipOf(uint256 tokenId) internal view returns (TokenOwnership memory) {
                uint256 curr = tokenId;
                unchecked {
                    if (_startTokenId() <= curr) if (curr < _currentIndex) {
                        TokenOwnership memory ownership = _ownerships[curr];
                        if (!ownership.burned) {
                            if (ownership.addr != address(0)) {
                                return ownership;
                            }
                            // Invariant:
                            // There will always be an ownership that has an address and is not burned
                            // before an ownership that does not have an address and is not burned.
                            // Hence, curr will not underflow.
                            while (true) {
                                curr--;
                                ownership = _ownerships[curr];
                                if (ownership.addr != address(0)) {
                                    return ownership;
                                }
                            }
                        }
                    }
                }
                revert OwnerQueryForNonexistentToken();
            }
            /**
             * @dev See {IERC721-ownerOf}.
             */
            function ownerOf(uint256 tokenId) public view override returns (address) {
                return _ownershipOf(tokenId).addr;
            }
            /**
             * @dev See {IERC721Metadata-name}.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev See {IERC721Metadata-symbol}.
             */
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
                string memory baseURI = _baseURI();
                return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : '';
            }
            /**
             * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
             * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
             * by default, can be overriden in child contracts.
             */
            function _baseURI() internal view virtual returns (string memory) {
                return '';
            }
            /**
             * @dev See {IERC721-approve}.
             */
            function approve(address to, uint256 tokenId) public override {
                address owner = ERC721AUpgradeable.ownerOf(tokenId);
                if (to == owner) revert ApprovalToCurrentOwner();
                if (_msgSender() != owner) if(!isApprovedForAll(owner, _msgSender())) {
                    revert ApprovalCallerNotOwnerNorApproved();
                }
                _approve(to, tokenId, owner);
            }
            /**
             * @dev See {IERC721-getApproved}.
             */
            function getApproved(uint256 tokenId) public view override returns (address) {
                if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();
                return _tokenApprovals[tokenId];
            }
            /**
             * @dev See {IERC721-setApprovalForAll}.
             */
            function setApprovalForAll(address operator, bool approved) public virtual override {
                if (operator == _msgSender()) revert ApproveToCaller();
                _operatorApprovals[_msgSender()][operator] = approved;
                emit ApprovalForAll(_msgSender(), operator, approved);
            }
            /**
             * @dev See {IERC721-isApprovedForAll}.
             */
            function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                return _operatorApprovals[owner][operator];
            }
            /**
             * @dev See {IERC721-transferFrom}.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                _transfer(from, to, tokenId);
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                safeTransferFrom(from, to, tokenId, '');
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) public virtual override {
                _transfer(from, to, tokenId);
                if (to.isContract()) if(!_checkContractOnERC721Received(from, to, tokenId, _data)) {
                    revert TransferToNonERC721ReceiverImplementer();
                }
            }
            /**
             * @dev Returns whether `tokenId` exists.
             *
             * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
             *
             * Tokens start existing when they are minted (`_mint`),
             */
            function _exists(uint256 tokenId) internal view returns (bool) {
                return _startTokenId() <= tokenId && tokenId < _currentIndex && !_ownerships[tokenId].burned;
            }
            /**
             * @dev Equivalent to `_safeMint(to, quantity, '')`.
             */
            function _safeMint(address to, uint256 quantity) internal {
                _safeMint(to, quantity, '');
            }
            /**
             * @dev Safely mints `quantity` tokens and transfers them to `to`.
             *
             * Requirements:
             *
             * - If `to` refers to a smart contract, it must implement
             *   {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
             * - `quantity` must be greater than 0.
             *
             * Emits a {Transfer} event.
             */
            function _safeMint(
                address to,
                uint256 quantity,
                bytes memory _data
            ) internal {
                uint256 startTokenId = _currentIndex;
                if (to == address(0)) revert MintToZeroAddress();
                if (quantity == 0) revert MintZeroQuantity();
                _beforeTokenTransfers(address(0), to, startTokenId, quantity);
                // Overflows are incredibly unrealistic.
                // balance or numberMinted overflow if current value of either + quantity > 1.8e19 (2**64) - 1
                // updatedIndex overflows if _currentIndex + quantity > 1.2e77 (2**256) - 1
                unchecked {
                    _addressData[to].balance += uint64(quantity);
                    _addressData[to].numberMinted += uint64(quantity);
                    _ownerships[startTokenId].addr = to;
                    _ownerships[startTokenId].startTimestamp = uint64(block.timestamp);
                    uint256 updatedIndex = startTokenId;
                    uint256 end = updatedIndex + quantity;
                    if (to.isContract()) {
                        do {
                            emit Transfer(address(0), to, updatedIndex);
                            if (!_checkContractOnERC721Received(address(0), to, updatedIndex++, _data)) {
                                revert TransferToNonERC721ReceiverImplementer();
                            }
                        } while (updatedIndex < end);
                        // Reentrancy protection
                        if (_currentIndex != startTokenId) revert();
                    } else {
                        do {
                            emit Transfer(address(0), to, updatedIndex++);
                        } while (updatedIndex < end);
                    }
                    _currentIndex = updatedIndex;
                }
                _afterTokenTransfers(address(0), to, startTokenId, quantity);
            }
            /**
             * @dev Mints `quantity` tokens and transfers them to `to`.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `quantity` must be greater than 0.
             *
             * Emits a {Transfer} event.
             */
            function _mint(address to, uint256 quantity) internal {
                uint256 startTokenId = _currentIndex;
                if (to == address(0)) revert MintToZeroAddress();
                if (quantity == 0) revert MintZeroQuantity();
                _beforeTokenTransfers(address(0), to, startTokenId, quantity);
                // Overflows are incredibly unrealistic.
                // balance or numberMinted overflow if current value of either + quantity > 1.8e19 (2**64) - 1
                // updatedIndex overflows if _currentIndex + quantity > 1.2e77 (2**256) - 1
                unchecked {
                    _addressData[to].balance += uint64(quantity);
                    _addressData[to].numberMinted += uint64(quantity);
                    _ownerships[startTokenId].addr = to;
                    _ownerships[startTokenId].startTimestamp = uint64(block.timestamp);
                    uint256 updatedIndex = startTokenId;
                    uint256 end = updatedIndex + quantity;
                    do {
                        emit Transfer(address(0), to, updatedIndex++);
                    } while (updatedIndex < end);
                    _currentIndex = updatedIndex;
                }
                _afterTokenTransfers(address(0), to, startTokenId, quantity);
            }
            /**
             * @dev Transfers `tokenId` from `from` to `to`.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             *
             * Emits a {Transfer} event.
             */
            function _transfer(
                address from,
                address to,
                uint256 tokenId
            ) private {
                TokenOwnership memory prevOwnership = _ownershipOf(tokenId);
                if (prevOwnership.addr != from) revert TransferFromIncorrectOwner();
                bool isApprovedOrOwner = (_msgSender() == from ||
                    isApprovedForAll(from, _msgSender()) ||
                    getApproved(tokenId) == _msgSender());
                if (!isApprovedOrOwner) revert TransferCallerNotOwnerNorApproved();
                if (to == address(0)) revert TransferToZeroAddress();
                _beforeTokenTransfers(from, to, tokenId, 1);
                // Clear approvals from the previous owner
                _approve(address(0), tokenId, from);
                // Underflow of the sender's balance is impossible because we check for
                // ownership above and the recipient's balance can't realistically overflow.
                // Counter overflow is incredibly unrealistic as tokenId would have to be 2**256.
                unchecked {
                    _addressData[from].balance -= 1;
                    _addressData[to].balance += 1;
                    TokenOwnership storage currSlot = _ownerships[tokenId];
                    currSlot.addr = to;
                    currSlot.startTimestamp = uint64(block.timestamp);
                    // If the ownership slot of tokenId+1 is not explicitly set, that means the transfer initiator owns it.
                    // Set the slot of tokenId+1 explicitly in storage to maintain correctness for ownerOf(tokenId+1) calls.
                    uint256 nextTokenId = tokenId + 1;
                    TokenOwnership storage nextSlot = _ownerships[nextTokenId];
                    if (nextSlot.addr == address(0)) {
                        // This will suffice for checking _exists(nextTokenId),
                        // as a burned slot cannot contain the zero address.
                        if (nextTokenId != _currentIndex) {
                            nextSlot.addr = from;
                            nextSlot.startTimestamp = prevOwnership.startTimestamp;
                        }
                    }
                }
                emit Transfer(from, to, tokenId);
                _afterTokenTransfers(from, to, tokenId, 1);
            }
            /**
             * @dev Equivalent to `_burn(tokenId, false)`.
             */
            function _burn(uint256 tokenId) internal virtual {
                _burn(tokenId, false);
            }
            /**
             * @dev Destroys `tokenId`.
             * The approval is cleared when the token is burned.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             *
             * Emits a {Transfer} event.
             */
            function _burn(uint256 tokenId, bool approvalCheck) internal virtual {
                TokenOwnership memory prevOwnership = _ownershipOf(tokenId);
                address from = prevOwnership.addr;
                if (approvalCheck) {
                    bool isApprovedOrOwner = (_msgSender() == from ||
                        isApprovedForAll(from, _msgSender()) ||
                        getApproved(tokenId) == _msgSender());
                    if (!isApprovedOrOwner) revert TransferCallerNotOwnerNorApproved();
                }
                _beforeTokenTransfers(from, address(0), tokenId, 1);
                // Clear approvals from the previous owner
                _approve(address(0), tokenId, from);
                // Underflow of the sender's balance is impossible because we check for
                // ownership above and the recipient's balance can't realistically overflow.
                // Counter overflow is incredibly unrealistic as tokenId would have to be 2**256.
                unchecked {
                    AddressData storage addressData = _addressData[from];
                    addressData.balance -= 1;
                    addressData.numberBurned += 1;
                    // Keep track of who burned the token, and the timestamp of burning.
                    TokenOwnership storage currSlot = _ownerships[tokenId];
                    currSlot.addr = from;
                    currSlot.startTimestamp = uint64(block.timestamp);
                    currSlot.burned = true;
                    // If the ownership slot of tokenId+1 is not explicitly set, that means the burn initiator owns it.
                    // Set the slot of tokenId+1 explicitly in storage to maintain correctness for ownerOf(tokenId+1) calls.
                    uint256 nextTokenId = tokenId + 1;
                    TokenOwnership storage nextSlot = _ownerships[nextTokenId];
                    if (nextSlot.addr == address(0)) {
                        // This will suffice for checking _exists(nextTokenId),
                        // as a burned slot cannot contain the zero address.
                        if (nextTokenId != _currentIndex) {
                            nextSlot.addr = from;
                            nextSlot.startTimestamp = prevOwnership.startTimestamp;
                        }
                    }
                }
                emit Transfer(from, address(0), tokenId);
                _afterTokenTransfers(from, address(0), tokenId, 1);
                // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
                unchecked {
                    _burnCounter++;
                }
            }
            /**
             * @dev Approve `to` to operate on `tokenId`
             *
             * Emits a {Approval} event.
             */
            function _approve(
                address to,
                uint256 tokenId,
                address owner
            ) private {
                _tokenApprovals[tokenId] = to;
                emit Approval(owner, to, tokenId);
            }
            /**
             * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target contract.
             *
             * @param from address representing the previous owner of the given token ID
             * @param to target address that will receive the tokens
             * @param tokenId uint256 ID of the token to be transferred
             * @param _data bytes optional data to send along with the call
             * @return bool whether the call correctly returned the expected magic value
             */
            function _checkContractOnERC721Received(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) private returns (bool) {
                try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                    return retval == IERC721ReceiverUpgradeable(to).onERC721Received.selector;
                } catch (bytes memory reason) {
                    if (reason.length == 0) {
                        revert TransferToNonERC721ReceiverImplementer();
                    } else {
                        assembly {
                            revert(add(32, reason), mload(reason))
                        }
                    }
                }
            }
            /**
             * @dev Hook that is called before a set of serially-ordered token ids are about to be transferred. This includes minting.
             * And also called before burning one token.
             *
             * startTokenId - the first token id to be transferred
             * quantity - the amount to be transferred
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
             * transferred to `to`.
             * - When `from` is zero, `tokenId` will be minted for `to`.
             * - When `to` is zero, `tokenId` will be burned by `from`.
             * - `from` and `to` are never both zero.
             */
            function _beforeTokenTransfers(
                address from,
                address to,
                uint256 startTokenId,
                uint256 quantity
            ) internal virtual {}
            /**
             * @dev Hook that is called after a set of serially-ordered token ids have been transferred. This includes
             * minting.
             * And also called after one token has been burned.
             *
             * startTokenId - the first token id to be transferred
             * quantity - the amount to be transferred
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
             * transferred to `to`.
             * - When `from` is zero, `tokenId` has been minted for `to`.
             * - When `to` is zero, `tokenId` has been burned by `from`.
             * - `from` and `to` are never both zero.
             */
            function _afterTokenTransfers(
                address from,
                address to,
                uint256 startTokenId,
                uint256 quantity
            ) internal virtual {}
            /**
             * @dev This empty reserved space is put in place to allow future versions to add new
             * variables without shifting down storage in the inheritance chain.
             * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
             */
            uint256[42] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/cryptography/ECDSA.sol)
        pragma solidity ^0.8.0;
        import "../Strings.sol";
        /**
         * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
         *
         * These functions can be used to verify that a message was signed by the holder
         * of the private keys of a given address.
         */
        library ECDSA {
            enum RecoverError {
                NoError,
                InvalidSignature,
                InvalidSignatureLength,
                InvalidSignatureS,
                InvalidSignatureV
            }
            function _throwError(RecoverError error) private pure {
                if (error == RecoverError.NoError) {
                    return; // no error: do nothing
                } else if (error == RecoverError.InvalidSignature) {
                    revert("ECDSA: invalid signature");
                } else if (error == RecoverError.InvalidSignatureLength) {
                    revert("ECDSA: invalid signature length");
                } else if (error == RecoverError.InvalidSignatureS) {
                    revert("ECDSA: invalid signature 's' value");
                } else if (error == RecoverError.InvalidSignatureV) {
                    revert("ECDSA: invalid signature 'v' value");
                }
            }
            /**
             * @dev Returns the address that signed a hashed message (`hash`) with
             * `signature` or error string. This address can then be used for verification purposes.
             *
             * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
             * this function rejects them by requiring the `s` value to be in the lower
             * half order, and the `v` value to be either 27 or 28.
             *
             * IMPORTANT: `hash` _must_ be the result of a hash operation for the
             * verification to be secure: it is possible to craft signatures that
             * recover to arbitrary addresses for non-hashed data. A safe way to ensure
             * this is by receiving a hash of the original message (which may otherwise
             * be too long), and then calling {toEthSignedMessageHash} on it.
             *
             * Documentation for signature generation:
             * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
             * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
             *
             * _Available since v4.3._
             */
            function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                // Check the signature length
                // - case 65: r,s,v signature (standard)
                // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                if (signature.length == 65) {
                    bytes32 r;
                    bytes32 s;
                    uint8 v;
                    // ecrecover takes the signature parameters, and the only way to get them
                    // currently is to use assembly.
                    assembly {
                        r := mload(add(signature, 0x20))
                        s := mload(add(signature, 0x40))
                        v := byte(0, mload(add(signature, 0x60)))
                    }
                    return tryRecover(hash, v, r, s);
                } else if (signature.length == 64) {
                    bytes32 r;
                    bytes32 vs;
                    // ecrecover takes the signature parameters, and the only way to get them
                    // currently is to use assembly.
                    assembly {
                        r := mload(add(signature, 0x20))
                        vs := mload(add(signature, 0x40))
                    }
                    return tryRecover(hash, r, vs);
                } else {
                    return (address(0), RecoverError.InvalidSignatureLength);
                }
            }
            /**
             * @dev Returns the address that signed a hashed message (`hash`) with
             * `signature`. This address can then be used for verification purposes.
             *
             * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
             * this function rejects them by requiring the `s` value to be in the lower
             * half order, and the `v` value to be either 27 or 28.
             *
             * IMPORTANT: `hash` _must_ be the result of a hash operation for the
             * verification to be secure: it is possible to craft signatures that
             * recover to arbitrary addresses for non-hashed data. A safe way to ensure
             * this is by receiving a hash of the original message (which may otherwise
             * be too long), and then calling {toEthSignedMessageHash} on it.
             */
            function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                (address recovered, RecoverError error) = tryRecover(hash, signature);
                _throwError(error);
                return recovered;
            }
            /**
             * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
             *
             * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
             *
             * _Available since v4.3._
             */
            function tryRecover(
                bytes32 hash,
                bytes32 r,
                bytes32 vs
            ) internal pure returns (address, RecoverError) {
                bytes32 s;
                uint8 v;
                assembly {
                    s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
                    v := add(shr(255, vs), 27)
                }
                return tryRecover(hash, v, r, s);
            }
            /**
             * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
             *
             * _Available since v4.2._
             */
            function recover(
                bytes32 hash,
                bytes32 r,
                bytes32 vs
            ) internal pure returns (address) {
                (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                _throwError(error);
                return recovered;
            }
            /**
             * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
             * `r` and `s` signature fields separately.
             *
             * _Available since v4.3._
             */
            function tryRecover(
                bytes32 hash,
                uint8 v,
                bytes32 r,
                bytes32 s
            ) internal pure returns (address, RecoverError) {
                // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                //
                // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                // these malleable signatures as well.
                if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                    return (address(0), RecoverError.InvalidSignatureS);
                }
                if (v != 27 && v != 28) {
                    return (address(0), RecoverError.InvalidSignatureV);
                }
                // If the signature is valid (and not malleable), return the signer address
                address signer = ecrecover(hash, v, r, s);
                if (signer == address(0)) {
                    return (address(0), RecoverError.InvalidSignature);
                }
                return (signer, RecoverError.NoError);
            }
            /**
             * @dev Overload of {ECDSA-recover} that receives the `v`,
             * `r` and `s` signature fields separately.
             */
            function recover(
                bytes32 hash,
                uint8 v,
                bytes32 r,
                bytes32 s
            ) internal pure returns (address) {
                (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                _throwError(error);
                return recovered;
            }
            /**
             * @dev Returns an Ethereum Signed Message, created from a `hash`. This
             * produces hash corresponding to the one signed with the
             * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
             * JSON-RPC method as part of EIP-191.
             *
             * See {recover}.
             */
            function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
                // 32 is the length in bytes of hash,
                // enforced by the type signature above
                return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
        32", hash));
            }
            /**
             * @dev Returns an Ethereum Signed Message, created from `s`. This
             * produces hash corresponding to the one signed with the
             * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
             * JSON-RPC method as part of EIP-191.
             *
             * See {recover}.
             */
            function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
                return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
        ", Strings.toString(s.length), s));
            }
            /**
             * @dev Returns an Ethereum Signed Typed Data, created from a
             * `domainSeparator` and a `structHash`. This produces hash corresponding
             * to the one signed with the
             * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
             * JSON-RPC method as part of EIP-712.
             *
             * See {recover}.
             */
            function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
                return keccak256(abi.encodePacked("\\x19\\x01", domainSeparator, structHash));
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev String operations.
         */
        library Strings {
            bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
            /**
             * @dev Converts a `uint256` to its ASCII `string` decimal representation.
             */
            function toString(uint256 value) internal pure returns (string memory) {
                // Inspired by OraclizeAPI's implementation - MIT licence
                // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                if (value == 0) {
                    return "0";
                }
                uint256 temp = value;
                uint256 digits;
                while (temp != 0) {
                    digits++;
                    temp /= 10;
                }
                bytes memory buffer = new bytes(digits);
                while (value != 0) {
                    digits -= 1;
                    buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                    value /= 10;
                }
                return string(buffer);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
             */
            function toHexString(uint256 value) internal pure returns (string memory) {
                if (value == 0) {
                    return "0x00";
                }
                uint256 temp = value;
                uint256 length = 0;
                while (temp != 0) {
                    length++;
                    temp >>= 8;
                }
                return toHexString(value, length);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
             */
            function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                bytes memory buffer = new bytes(2 * length + 2);
                buffer[0] = "0";
                buffer[1] = "x";
                for (uint256 i = 2 * length + 1; i > 1; --i) {
                    buffer[i] = _HEX_SYMBOLS[value & 0xf];
                    value >>= 4;
                }
                require(value == 0, "Strings: hex length insufficient");
                return string(buffer);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC20 standard as defined in the EIP.
         */
        interface IERC20 {
            /**
             * @dev Returns the amount of tokens in existence.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns the amount of tokens owned by `account`.
             */
            function balanceOf(address account) external view returns (uint256);
            /**
             * @dev Moves `amount` tokens from the caller's account to `recipient`.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transfer(address recipient, uint256 amount) external returns (bool);
            /**
             * @dev Returns the remaining number of tokens that `spender` will be
             * allowed to spend on behalf of `owner` through {transferFrom}. This is
             * zero by default.
             *
             * This value changes when {approve} or {transferFrom} are called.
             */
            function allowance(address owner, address spender) external view returns (uint256);
            /**
             * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * IMPORTANT: Beware that changing an allowance with this method brings the risk
             * that someone may use both the old and the new allowance by unfortunate
             * transaction ordering. One possible solution to mitigate this race
             * condition is to first reduce the spender's allowance to 0 and set the
             * desired value afterwards:
             * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
             *
             * Emits an {Approval} event.
             */
            function approve(address spender, uint256 amount) external returns (bool);
            /**
             * @dev Moves `amount` tokens from `sender` to `recipient` using the
             * allowance mechanism. `amount` is then deducted from the caller's
             * allowance.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) external returns (bool);
            /**
             * @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);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC165 standard, as defined in the
         * https://eips.ethereum.org/EIPS/eip-165[EIP].
         *
         * Implementers can declare support of contract interfaces, which can then be
         * queried by others ({ERC165Checker}).
         *
         * For an implementation, see {ERC165}.
         */
        interface IERC165Upgradeable {
            /**
             * @dev Returns true if this contract implements the interface defined by
             * `interfaceId`. See the corresponding
             * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
             * to learn more about how these ids are created.
             *
             * This function call must use less than 30 000 gas.
             */
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
        pragma solidity ^0.8.0;
        import "./IERC165Upgradeable.sol";
        import "../../proxy/utils/Initializable.sol";
        /**
         * @dev Implementation of the {IERC165} interface.
         *
         * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
         * for the additional interface id that will be supported. For example:
         *
         * ```solidity
         * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
         *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
         * }
         * ```
         *
         * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
         */
        abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
            function __ERC165_init() internal onlyInitializing {
                __ERC165_init_unchained();
            }
            function __ERC165_init_unchained() internal onlyInitializing {
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                return interfaceId == type(IERC165Upgradeable).interfaceId;
            }
            uint256[50] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev String operations.
         */
        library StringsUpgradeable {
            bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
            /**
             * @dev Converts a `uint256` to its ASCII `string` decimal representation.
             */
            function toString(uint256 value) internal pure returns (string memory) {
                // Inspired by OraclizeAPI's implementation - MIT licence
                // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                if (value == 0) {
                    return "0";
                }
                uint256 temp = value;
                uint256 digits;
                while (temp != 0) {
                    digits++;
                    temp /= 10;
                }
                bytes memory buffer = new bytes(digits);
                while (value != 0) {
                    digits -= 1;
                    buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                    value /= 10;
                }
                return string(buffer);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
             */
            function toHexString(uint256 value) internal pure returns (string memory) {
                if (value == 0) {
                    return "0x00";
                }
                uint256 temp = value;
                uint256 length = 0;
                while (temp != 0) {
                    length++;
                    temp >>= 8;
                }
                return toHexString(value, length);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
             */
            function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                bytes memory buffer = new bytes(2 * length + 2);
                buffer[0] = "0";
                buffer[1] = "x";
                for (uint256 i = 2 * length + 1; i > 1; --i) {
                    buffer[i] = _HEX_SYMBOLS[value & 0xf];
                    value >>= 4;
                }
                require(value == 0, "Strings: hex length insufficient");
                return string(buffer);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)
        pragma solidity ^0.8.0;
        /**
         * @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:
         * ```
         * 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(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
         *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
         *     }
         * }
         * ```
         *
         * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
         */
        library StorageSlotUpgradeable {
            struct AddressSlot {
                address value;
            }
            struct BooleanSlot {
                bool value;
            }
            struct Bytes32Slot {
                bytes32 value;
            }
            struct Uint256Slot {
                uint256 value;
            }
            /**
             * @dev Returns an `AddressSlot` with member `value` located at `slot`.
             */
            function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                assembly {
                    r.slot := slot
                }
            }
            /**
             * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
             */
            function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                assembly {
                    r.slot := slot
                }
            }
            /**
             * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
             */
            function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                assembly {
                    r.slot := slot
                }
            }
            /**
             * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
             */
            function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                assembly {
                    r.slot := slot
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
        pragma solidity ^0.8.0;
        import "../proxy/utils/Initializable.sol";
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract ContextUpgradeable is Initializable {
            function __Context_init() internal onlyInitializing {
                __Context_init_unchained();
            }
            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;
            }
            uint256[50] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Address.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Collection of functions related to the address type
         */
        library AddressUpgradeable {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize, which returns 0 for contracts in
                // construction, since the code is only stored at the end of the
                // constructor execution.
                uint256 size;
                assembly {
                    size := extcodesize(account)
                }
                return size > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
             * `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but also transferring `value` wei to `target`.
             *
             * Requirements:
             *
             * - the calling contract must have an ETH balance of at least `value`.
             * - the called Solidity function must be `payable`.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
            }
            /**
             * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
             * with `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(address(this).balance >= value, "Address: insufficient balance for call");
                require(isContract(target), "Address: call to non-contract");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "Address: low-level static call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                require(isContract(target), "Address: static call to non-contract");
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    // Look for revert reason and bubble it up if present
                    if (returndata.length > 0) {
                        // The easiest way to bubble the revert reason is using memory via assembly
                        assembly {
                            let returndata_size := mload(returndata)
                            revert(add(32, returndata), returndata_size)
                        }
                    } else {
                        revert(errorMessage);
                    }
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
        pragma solidity ^0.8.0;
        import "../IERC721Upgradeable.sol";
        /**
         * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
         * @dev See https://eips.ethereum.org/EIPS/eip-721
         */
        interface IERC721MetadataUpgradeable is IERC721Upgradeable {
            /**
             * @dev Returns the token collection name.
             */
            function name() external view returns (string memory);
            /**
             * @dev Returns the token collection symbol.
             */
            function symbol() external view returns (string memory);
            /**
             * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
             */
            function tokenURI(uint256 tokenId) external view returns (string memory);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165Upgradeable.sol";
        /**
         * @dev Required interface of an ERC721 compliant contract.
         */
        interface IERC721Upgradeable is IERC165Upgradeable {
            /**
             * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
             */
            event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
             */
            event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
             */
            event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
            /**
             * @dev Returns the number of tokens in ``owner``'s account.
             */
            function balanceOf(address owner) external view returns (uint256 balance);
            /**
             * @dev Returns the owner of the `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function ownerOf(uint256 tokenId) external view returns (address owner);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Transfers `tokenId` token from `from` to `to`.
             *
             * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Gives permission to `to` to transfer `tokenId` token to another account.
             * The approval is cleared when the token is transferred.
             *
             * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
             *
             * Requirements:
             *
             * - The caller must own the token or be an approved operator.
             * - `tokenId` must exist.
             *
             * Emits an {Approval} event.
             */
            function approve(address to, uint256 tokenId) external;
            /**
             * @dev Returns the account approved for `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function getApproved(uint256 tokenId) external view returns (address operator);
            /**
             * @dev Approve or remove `operator` as an operator for the caller.
             * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
             *
             * Requirements:
             *
             * - The `operator` cannot be the caller.
             *
             * Emits an {ApprovalForAll} event.
             */
            function setApprovalForAll(address operator, bool _approved) external;
            /**
             * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
             *
             * See {setApprovalForAll}
             */
            function isApprovedForAll(address owner, address operator) external view returns (bool);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes calldata data
            ) external;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)
        pragma solidity ^0.8.0;
        /**
         * @title ERC721 token receiver interface
         * @dev Interface for any contract that wants to support safeTransfers
         * from ERC721 asset contracts.
         */
        interface IERC721ReceiverUpgradeable {
            /**
             * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
             * by `operator` from `from`, this function is called.
             *
             * It must return its Solidity selector to confirm the token transfer.
             * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
             *
             * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
             */
            function onERC721Received(
                address operator,
                address from,
                uint256 tokenId,
                bytes calldata data
            ) external returns (bytes4);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/ERC721.sol)
        pragma solidity ^0.8.0;
        import "./IERC721Upgradeable.sol";
        import "./IERC721ReceiverUpgradeable.sol";
        import "./extensions/IERC721MetadataUpgradeable.sol";
        import "../../utils/AddressUpgradeable.sol";
        import "../../utils/ContextUpgradeable.sol";
        import "../../utils/StringsUpgradeable.sol";
        import "../../utils/introspection/ERC165Upgradeable.sol";
        import "../../proxy/utils/Initializable.sol";
        /**
         * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
         * the Metadata extension, but not including the Enumerable extension, which is available separately as
         * {ERC721Enumerable}.
         */
        contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
            using AddressUpgradeable for address;
            using StringsUpgradeable for uint256;
            // Token name
            string private _name;
            // Token symbol
            string private _symbol;
            // Mapping from token ID to owner address
            mapping(uint256 => address) private _owners;
            // Mapping owner address to token count
            mapping(address => uint256) private _balances;
            // Mapping from token ID to approved address
            mapping(uint256 => address) private _tokenApprovals;
            // Mapping from owner to operator approvals
            mapping(address => mapping(address => bool)) private _operatorApprovals;
            /**
             * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
             */
            function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
                __Context_init_unchained();
                __ERC165_init_unchained();
                __ERC721_init_unchained(name_, symbol_);
            }
            function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                _name = name_;
                _symbol = symbol_;
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
                return
                    interfaceId == type(IERC721Upgradeable).interfaceId ||
                    interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721-balanceOf}.
             */
            function balanceOf(address owner) public view virtual override returns (uint256) {
                require(owner != address(0), "ERC721: balance query for the zero address");
                return _balances[owner];
            }
            /**
             * @dev See {IERC721-ownerOf}.
             */
            function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                address owner = _owners[tokenId];
                require(owner != address(0), "ERC721: owner query for nonexistent token");
                return owner;
            }
            /**
             * @dev See {IERC721Metadata-name}.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev See {IERC721Metadata-symbol}.
             */
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                string memory baseURI = _baseURI();
                return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
            }
            /**
             * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
             * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
             * by default, can be overriden in child contracts.
             */
            function _baseURI() internal view virtual returns (string memory) {
                return "";
            }
            /**
             * @dev See {IERC721-approve}.
             */
            function approve(address to, uint256 tokenId) public virtual override {
                address owner = ERC721Upgradeable.ownerOf(tokenId);
                require(to != owner, "ERC721: approval to current owner");
                require(
                    _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                    "ERC721: approve caller is not owner nor approved for all"
                );
                _approve(to, tokenId);
            }
            /**
             * @dev See {IERC721-getApproved}.
             */
            function getApproved(uint256 tokenId) public view virtual override returns (address) {
                require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                return _tokenApprovals[tokenId];
            }
            /**
             * @dev See {IERC721-setApprovalForAll}.
             */
            function setApprovalForAll(address operator, bool approved) public virtual override {
                _setApprovalForAll(_msgSender(), operator, approved);
            }
            /**
             * @dev See {IERC721-isApprovedForAll}.
             */
            function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                return _operatorApprovals[owner][operator];
            }
            /**
             * @dev See {IERC721-transferFrom}.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                //solhint-disable-next-line max-line-length
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                _transfer(from, to, tokenId);
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                safeTransferFrom(from, to, tokenId, "");
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) public virtual override {
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                _safeTransfer(from, to, tokenId, _data);
            }
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * `_data` is additional data, it has no specified format and it is sent in call to `to`.
             *
             * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
             * implement alternative mechanisms to perform token transfer, such as signature-based.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function _safeTransfer(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) internal virtual {
                _transfer(from, to, tokenId);
                require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
            }
            /**
             * @dev Returns whether `tokenId` exists.
             *
             * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
             *
             * Tokens start existing when they are minted (`_mint`),
             * and stop existing when they are burned (`_burn`).
             */
            function _exists(uint256 tokenId) internal view virtual returns (bool) {
                return _owners[tokenId] != address(0);
            }
            /**
             * @dev Returns whether `spender` is allowed to manage `tokenId`.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
                require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                address owner = ERC721Upgradeable.ownerOf(tokenId);
                return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
            }
            /**
             * @dev Safely mints `tokenId` and transfers it to `to`.
             *
             * Requirements:
             *
             * - `tokenId` must not exist.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function _safeMint(address to, uint256 tokenId) internal virtual {
                _safeMint(to, tokenId, "");
            }
            /**
             * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
             * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
             */
            function _safeMint(
                address to,
                uint256 tokenId,
                bytes memory _data
            ) internal virtual {
                _mint(to, tokenId);
                require(
                    _checkOnERC721Received(address(0), to, tokenId, _data),
                    "ERC721: transfer to non ERC721Receiver implementer"
                );
            }
            /**
             * @dev Mints `tokenId` and transfers it to `to`.
             *
             * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
             *
             * Requirements:
             *
             * - `tokenId` must not exist.
             * - `to` cannot be the zero address.
             *
             * Emits a {Transfer} event.
             */
            function _mint(address to, uint256 tokenId) internal virtual {
                require(to != address(0), "ERC721: mint to the zero address");
                require(!_exists(tokenId), "ERC721: token already minted");
                _beforeTokenTransfer(address(0), to, tokenId);
                _balances[to] += 1;
                _owners[tokenId] = to;
                emit Transfer(address(0), to, tokenId);
            }
            /**
             * @dev Destroys `tokenId`.
             * The approval is cleared when the token is burned.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             *
             * Emits a {Transfer} event.
             */
            function _burn(uint256 tokenId) internal virtual {
                address owner = ERC721Upgradeable.ownerOf(tokenId);
                _beforeTokenTransfer(owner, address(0), tokenId);
                // Clear approvals
                _approve(address(0), tokenId);
                _balances[owner] -= 1;
                delete _owners[tokenId];
                emit Transfer(owner, address(0), tokenId);
            }
            /**
             * @dev Transfers `tokenId` from `from` to `to`.
             *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             *
             * Emits a {Transfer} event.
             */
            function _transfer(
                address from,
                address to,
                uint256 tokenId
            ) internal virtual {
                require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                require(to != address(0), "ERC721: transfer to the zero address");
                _beforeTokenTransfer(from, to, tokenId);
                // Clear approvals from the previous owner
                _approve(address(0), tokenId);
                _balances[from] -= 1;
                _balances[to] += 1;
                _owners[tokenId] = to;
                emit Transfer(from, to, tokenId);
            }
            /**
             * @dev Approve `to` to operate on `tokenId`
             *
             * Emits a {Approval} event.
             */
            function _approve(address to, uint256 tokenId) internal virtual {
                _tokenApprovals[tokenId] = to;
                emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
            }
            /**
             * @dev Approve `operator` to operate on all of `owner` tokens
             *
             * Emits a {ApprovalForAll} event.
             */
            function _setApprovalForAll(
                address owner,
                address operator,
                bool approved
            ) internal virtual {
                require(owner != operator, "ERC721: approve to caller");
                _operatorApprovals[owner][operator] = approved;
                emit ApprovalForAll(owner, operator, approved);
            }
            /**
             * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
             * The call is not executed if the target address is not a contract.
             *
             * @param from address representing the previous owner of the given token ID
             * @param to target address that will receive the tokens
             * @param tokenId uint256 ID of the token to be transferred
             * @param _data bytes optional data to send along with the call
             * @return bool whether the call correctly returned the expected magic value
             */
            function _checkOnERC721Received(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) private returns (bool) {
                if (to.isContract()) {
                    try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                        return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
                    } catch (bytes memory reason) {
                        if (reason.length == 0) {
                            revert("ERC721: transfer to non ERC721Receiver implementer");
                        } else {
                            assembly {
                                revert(add(32, reason), mload(reason))
                            }
                        }
                    }
                } else {
                    return true;
                }
            }
            /**
             * @dev Hook that is called before any token transfer. This includes minting
             * and burning.
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
             * transferred to `to`.
             * - When `from` is zero, `tokenId` will be minted for `to`.
             * - When `to` is zero, ``from``'s `tokenId` will be burned.
             * - `from` and `to` are never both zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 tokenId
            ) internal virtual {}
            uint256[44] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
        pragma solidity ^0.8.0;
        import "../IERC20Upgradeable.sol";
        /**
         * @dev Interface for the optional metadata functions from the ERC20 standard.
         *
         * _Available since v4.1._
         */
        interface IERC20MetadataUpgradeable is IERC20Upgradeable {
            /**
             * @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 v4.4.1 (token/ERC20/IERC20.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC20 standard as defined in the EIP.
         */
        interface IERC20Upgradeable {
            /**
             * @dev Returns the amount of tokens in existence.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns the amount of tokens owned by `account`.
             */
            function balanceOf(address account) external view returns (uint256);
            /**
             * @dev Moves `amount` tokens from the caller's account to `recipient`.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transfer(address recipient, uint256 amount) external returns (bool);
            /**
             * @dev Returns the remaining number of tokens that `spender` will be
             * allowed to spend on behalf of `owner` through {transferFrom}. This is
             * zero by default.
             *
             * This value changes when {approve} or {transferFrom} are called.
             */
            function allowance(address owner, address spender) external view returns (uint256);
            /**
             * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * IMPORTANT: Beware that changing an allowance with this method brings the risk
             * that someone may use both the old and the new allowance by unfortunate
             * transaction ordering. One possible solution to mitigate this race
             * condition is to first reduce the spender's allowance to 0 and set the
             * desired value afterwards:
             * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
             *
             * Emits an {Approval} event.
             */
            function approve(address spender, uint256 amount) external returns (bool);
            /**
             * @dev Moves `amount` tokens from `sender` to `recipient` using the
             * allowance mechanism. `amount` is then deducted from the caller's
             * allowance.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) external returns (bool);
            /**
             * @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);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC20/ERC20.sol)
        pragma solidity ^0.8.0;
        import "./IERC20Upgradeable.sol";
        import "./extensions/IERC20MetadataUpgradeable.sol";
        import "../../utils/ContextUpgradeable.sol";
        import "../../proxy/utils/Initializable.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}.
         * For a generic mechanism see {ERC20PresetMinterPauser}.
         *
         * TIP: For a detailed writeup see our guide
         * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
         * to implement supply mechanisms].
         *
         * 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.
         *
         * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
         * functions have been added to mitigate the well-known issues around setting
         * allowances. See {IERC20-approve}.
         */
        contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20Upgradeable, IERC20MetadataUpgradeable {
            mapping(address => uint256) private _balances;
            mapping(address => mapping(address => uint256)) private _allowances;
            uint256 private _totalSupply;
            string private _name;
            string private _symbol;
            /**
             * @dev Sets the values for {name} and {symbol}.
             *
             * The default value of {decimals} is 18. To select a different value for
             * {decimals} you should overload it.
             *
             * All two of these values are immutable: they can only be set once during
             * construction.
             */
            function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing {
                __Context_init_unchained();
                __ERC20_init_unchained(name_, symbol_);
            }
            function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                _name = name_;
                _symbol = symbol_;
            }
            /**
             * @dev Returns the name of the token.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev Returns the symbol of the token, usually a shorter version of the
             * name.
             */
            function symbol() public view virtual override 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 value {ERC20} uses, unless this function is
             * 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 override returns (uint8) {
                return 18;
            }
            /**
             * @dev See {IERC20-totalSupply}.
             */
            function totalSupply() public view virtual override returns (uint256) {
                return _totalSupply;
            }
            /**
             * @dev See {IERC20-balanceOf}.
             */
            function balanceOf(address account) public view virtual override returns (uint256) {
                return _balances[account];
            }
            /**
             * @dev See {IERC20-transfer}.
             *
             * Requirements:
             *
             * - `recipient` cannot be the zero address.
             * - the caller must have a balance of at least `amount`.
             */
            function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                _transfer(_msgSender(), recipient, amount);
                return true;
            }
            /**
             * @dev See {IERC20-allowance}.
             */
            function allowance(address owner, address spender) public view virtual override returns (uint256) {
                return _allowances[owner][spender];
            }
            /**
             * @dev See {IERC20-approve}.
             *
             * Requirements:
             *
             * - `spender` cannot be the zero address.
             */
            function approve(address spender, uint256 amount) public virtual override returns (bool) {
                _approve(_msgSender(), spender, amount);
                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}.
             *
             * Requirements:
             *
             * - `sender` and `recipient` cannot be the zero address.
             * - `sender` must have a balance of at least `amount`.
             * - the caller must have allowance for ``sender``'s tokens of at least
             * `amount`.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) public virtual override returns (bool) {
                _transfer(sender, recipient, amount);
                uint256 currentAllowance = _allowances[sender][_msgSender()];
                require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
                unchecked {
                    _approve(sender, _msgSender(), currentAllowance - amount);
                }
                return true;
            }
            /**
             * @dev Atomically increases the allowance granted to `spender` by the caller.
             *
             * This is an alternative to {approve} that can be used as a mitigation for
             * problems described in {IERC20-approve}.
             *
             * Emits an {Approval} event indicating the updated allowance.
             *
             * Requirements:
             *
             * - `spender` cannot be the zero address.
             */
            function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
                _approve(_msgSender(), spender, _allowances[_msgSender()][spender] + addedValue);
                return true;
            }
            /**
             * @dev Atomically decreases the allowance granted to `spender` by the caller.
             *
             * This is an alternative to {approve} that can be used as a mitigation for
             * problems described in {IERC20-approve}.
             *
             * Emits an {Approval} event indicating the updated allowance.
             *
             * Requirements:
             *
             * - `spender` cannot be the zero address.
             * - `spender` must have allowance for the caller of at least
             * `subtractedValue`.
             */
            function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
                uint256 currentAllowance = _allowances[_msgSender()][spender];
                require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
                unchecked {
                    _approve(_msgSender(), spender, currentAllowance - subtractedValue);
                }
                return true;
            }
            /**
             * @dev Moves `amount` of tokens from `sender` to `recipient`.
             *
             * 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.
             *
             * Requirements:
             *
             * - `sender` cannot be the zero address.
             * - `recipient` cannot be the zero address.
             * - `sender` must have a balance of at least `amount`.
             */
            function _transfer(
                address sender,
                address recipient,
                uint256 amount
            ) internal virtual {
                require(sender != address(0), "ERC20: transfer from the zero address");
                require(recipient != address(0), "ERC20: transfer to the zero address");
                _beforeTokenTransfer(sender, recipient, amount);
                uint256 senderBalance = _balances[sender];
                require(senderBalance >= amount, "ERC20: transfer amount exceeds balance");
                unchecked {
                    _balances[sender] = senderBalance - amount;
                }
                _balances[recipient] += amount;
                emit Transfer(sender, recipient, amount);
                _afterTokenTransfer(sender, recipient, amount);
            }
            /** @dev Creates `amount` tokens and assigns them to `account`, increasing
             * the total supply.
             *
             * Emits a {Transfer} event with `from` set to the zero address.
             *
             * Requirements:
             *
             * - `account` cannot be the zero address.
             */
            function _mint(address account, uint256 amount) internal virtual {
                require(account != address(0), "ERC20: mint to the zero address");
                _beforeTokenTransfer(address(0), account, amount);
                _totalSupply += amount;
                _balances[account] += amount;
                emit Transfer(address(0), account, amount);
                _afterTokenTransfer(address(0), account, amount);
            }
            /**
             * @dev Destroys `amount` tokens from `account`, reducing the
             * total supply.
             *
             * Emits a {Transfer} event with `to` set to the zero address.
             *
             * Requirements:
             *
             * - `account` cannot be the zero address.
             * - `account` must have at least `amount` tokens.
             */
            function _burn(address account, uint256 amount) internal virtual {
                require(account != address(0), "ERC20: burn from the zero address");
                _beforeTokenTransfer(account, address(0), amount);
                uint256 accountBalance = _balances[account];
                require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
                unchecked {
                    _balances[account] = accountBalance - amount;
                }
                _totalSupply -= amount;
                emit Transfer(account, address(0), amount);
                _afterTokenTransfer(account, address(0), amount);
            }
            /**
             * @dev Sets `amount` 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.
             */
            function _approve(
                address owner,
                address spender,
                uint256 amount
            ) internal virtual {
                require(owner != address(0), "ERC20: approve from the zero address");
                require(spender != address(0), "ERC20: approve to the zero address");
                _allowances[owner][spender] = amount;
                emit Approval(owner, spender, amount);
            }
            /**
             * @dev Hook that is called before any transfer of tokens. This includes
             * minting and burning.
             *
             * Calling conditions:
             *
             * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
             * will be transferred to `to`.
             * - when `from` is zero, `amount` tokens will be minted for `to`.
             * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
             * - `from` and `to` are never both zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 amount
            ) internal virtual {}
            /**
             * @dev Hook that is called after any transfer of tokens. This includes
             * minting and burning.
             *
             * Calling conditions:
             *
             * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
             * has been transferred to `to`.
             * - when `from` is zero, `amount` tokens have been minted for `to`.
             * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
             * - `from` and `to` are never both zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _afterTokenTransfer(
                address from,
                address to,
                uint256 amount
            ) internal virtual {}
            uint256[45] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/utils/UUPSUpgradeable.sol)
        pragma solidity ^0.8.0;
        import "../ERC1967/ERC1967UpgradeUpgradeable.sol";
        import "./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.
         *
         * _Available since v4.1._
         */
        abstract contract UUPSUpgradeable is Initializable, ERC1967UpgradeUpgradeable {
            function __UUPSUpgradeable_init() internal onlyInitializing {
                __ERC1967Upgrade_init_unchained();
                __UUPSUpgradeable_init_unchained();
            }
            function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
            }
            /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
            address private immutable __self = address(this);
            /**
             * @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() {
                require(address(this) != __self, "Function must be called through delegatecall");
                require(_getImplementation() == __self, "Function must be called through active proxy");
                _;
            }
            /**
             * @dev Upgrade the implementation of the proxy to `newImplementation`.
             *
             * Calls {_authorizeUpgrade}.
             *
             * Emits an {Upgraded} event.
             */
            function upgradeTo(address newImplementation) external virtual onlyProxy {
                _authorizeUpgrade(newImplementation);
                _upgradeToAndCallSecure(newImplementation, new bytes(0), false);
            }
            /**
             * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
             * encoded in `data`.
             *
             * Calls {_authorizeUpgrade}.
             *
             * Emits an {Upgraded} event.
             */
            function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual onlyProxy {
                _authorizeUpgrade(newImplementation);
                _upgradeToAndCallSecure(newImplementation, data, true);
            }
            /**
             * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
             * {upgradeTo} and {upgradeToAndCall}.
             *
             * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
             *
             * ```solidity
             * function _authorizeUpgrade(address) internal override onlyOwner {}
             * ```
             */
            function _authorizeUpgrade(address newImplementation) internal virtual;
            uint256[50] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/utils/Initializable.sol)
        pragma solidity ^0.8.0;
        import "../../utils/AddressUpgradeable.sol";
        /**
         * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
         * behind a proxy. Since a proxied contract can't have 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.
         *
         * 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 initialize the implementation contract, you can either invoke the
         * initializer manually, or you can include a constructor to automatically mark it as initialized when it is deployed:
         *
         * [.hljs-theme-light.nopadding]
         * ```
         * /// @custom:oz-upgrades-unsafe-allow constructor
         * constructor() initializer {}
         * ```
         * ====
         */
        abstract contract Initializable {
            /**
             * @dev Indicates that the contract has been initialized.
             */
            bool private _initialized;
            /**
             * @dev Indicates that the contract is in the process of being initialized.
             */
            bool private _initializing;
            /**
             * @dev Modifier to protect an initializer function from being invoked twice.
             */
            modifier initializer() {
                // If the contract is initializing we ignore whether _initialized is set in order to support multiple
                // inheritance patterns, but we only do this in the context of a constructor, because in other contexts the
                // contract may have been reentered.
                require(_initializing ? _isConstructor() : !_initialized, "Initializable: contract is already initialized");
                bool isTopLevelCall = !_initializing;
                if (isTopLevelCall) {
                    _initializing = true;
                    _initialized = true;
                }
                _;
                if (isTopLevelCall) {
                    _initializing = false;
                }
            }
            /**
             * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
             * {initializer} modifier, directly or indirectly.
             */
            modifier onlyInitializing() {
                require(_initializing, "Initializable: contract is not initializing");
                _;
            }
            function _isConstructor() private view returns (bool) {
                return !AddressUpgradeable.isContract(address(this));
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev This is the interface that {BeaconProxy} expects of its beacon.
         */
        interface IBeaconUpgradeable {
            /**
             * @dev Must return an address that can be used as a delegate call target.
             *
             * {BeaconProxy} will check that this address is a contract.
             */
            function implementation() external view returns (address);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Upgrade.sol)
        pragma solidity ^0.8.2;
        import "../beacon/IBeaconUpgradeable.sol";
        import "../../utils/AddressUpgradeable.sol";
        import "../../utils/StorageSlotUpgradeable.sol";
        import "../utils/Initializable.sol";
        /**
         * @dev This abstract contract provides getters and event emitting update functions for
         * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
         *
         * _Available since v4.1._
         *
         * @custom:oz-upgrades-unsafe-allow delegatecall
         */
        abstract contract ERC1967UpgradeUpgradeable is Initializable {
            function __ERC1967Upgrade_init() internal onlyInitializing {
                __ERC1967Upgrade_init_unchained();
            }
            function __ERC1967Upgrade_init_unchained() internal onlyInitializing {
            }
            // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
            bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
            /**
             * @dev Storage slot with the address of the current implementation.
             * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
             * validated in the constructor.
             */
            bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
            /**
             * @dev Emitted when the implementation is upgraded.
             */
            event Upgraded(address indexed implementation);
            /**
             * @dev Returns the current implementation address.
             */
            function _getImplementation() internal view returns (address) {
                return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;
            }
            /**
             * @dev Stores a new address in the EIP1967 implementation slot.
             */
            function _setImplementation(address newImplementation) private {
                require(AddressUpgradeable.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
            }
            /**
             * @dev Perform implementation upgrade
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeTo(address newImplementation) internal {
                _setImplementation(newImplementation);
                emit Upgraded(newImplementation);
            }
            /**
             * @dev Perform implementation upgrade with additional setup call.
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeToAndCall(
                address newImplementation,
                bytes memory data,
                bool forceCall
            ) internal {
                _upgradeTo(newImplementation);
                if (data.length > 0 || forceCall) {
                    _functionDelegateCall(newImplementation, data);
                }
            }
            /**
             * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeToAndCallSecure(
                address newImplementation,
                bytes memory data,
                bool forceCall
            ) internal {
                address oldImplementation = _getImplementation();
                // Initial upgrade and setup call
                _setImplementation(newImplementation);
                if (data.length > 0 || forceCall) {
                    _functionDelegateCall(newImplementation, data);
                }
                // Perform rollback test if not already in progress
                StorageSlotUpgradeable.BooleanSlot storage rollbackTesting = StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT);
                if (!rollbackTesting.value) {
                    // Trigger rollback using upgradeTo from the new implementation
                    rollbackTesting.value = true;
                    _functionDelegateCall(
                        newImplementation,
                        abi.encodeWithSignature("upgradeTo(address)", oldImplementation)
                    );
                    rollbackTesting.value = false;
                    // Check rollback was effective
                    require(oldImplementation == _getImplementation(), "ERC1967Upgrade: upgrade breaks further upgrades");
                    // Finally reset to the new implementation and log the upgrade
                    _upgradeTo(newImplementation);
                }
            }
            /**
             * @dev Storage slot with the admin of the contract.
             * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
             * validated in the constructor.
             */
            bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
            /**
             * @dev Emitted when the admin account has changed.
             */
            event AdminChanged(address previousAdmin, address newAdmin);
            /**
             * @dev Returns the current admin.
             */
            function _getAdmin() internal view returns (address) {
                return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;
            }
            /**
             * @dev Stores a new address in the EIP1967 admin slot.
             */
            function _setAdmin(address newAdmin) private {
                require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
            }
            /**
             * @dev Changes the admin of the proxy.
             *
             * Emits an {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 bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
             */
            bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
            /**
             * @dev Emitted when the beacon is upgraded.
             */
            event BeaconUpgraded(address indexed beacon);
            /**
             * @dev Returns the current beacon.
             */
            function _getBeacon() internal view returns (address) {
                return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;
            }
            /**
             * @dev Stores a new beacon in the EIP1967 beacon slot.
             */
            function _setBeacon(address newBeacon) private {
                require(AddressUpgradeable.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                require(
                    AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),
                    "ERC1967: beacon implementation is not a contract"
                );
                StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;
            }
            /**
             * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
             * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
             *
             * Emits a {BeaconUpgraded} event.
             */
            function _upgradeBeaconToAndCall(
                address newBeacon,
                bytes memory data,
                bool forceCall
            ) internal {
                _setBeacon(newBeacon);
                emit BeaconUpgraded(newBeacon);
                if (data.length > 0 || forceCall) {
                    _functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);
                }
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function _functionDelegateCall(address target, bytes memory data) private returns (bytes memory) {
                require(AddressUpgradeable.isContract(target), "Address: delegate call to non-contract");
                // solhint-disable-next-line avoid-low-level-calls
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return AddressUpgradeable.verifyCallResult(success, returndata, "Address: low-level delegate call failed");
            }
            uint256[50] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/Clones.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for
         * deploying minimal proxy contracts, also known as "clones".
         *
         * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies
         * > a minimal bytecode implementation that delegates all calls to a known, fixed address.
         *
         * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2`
         * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the
         * deterministic method.
         *
         * _Available since v3.4._
         */
        library ClonesUpgradeable {
            /**
             * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
             *
             * This function uses the create opcode, which should never revert.
             */
            function clone(address implementation) internal returns (address instance) {
                assembly {
                    let ptr := mload(0x40)
                    mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                    mstore(add(ptr, 0x14), shl(0x60, implementation))
                    mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                    instance := create(0, ptr, 0x37)
                }
                require(instance != address(0), "ERC1167: create failed");
            }
            /**
             * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`.
             *
             * This function uses the create2 opcode and a `salt` to deterministically deploy
             * the clone. Using the same `implementation` and `salt` multiple time will revert, since
             * the clones cannot be deployed twice at the same address.
             */
            function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) {
                assembly {
                    let ptr := mload(0x40)
                    mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                    mstore(add(ptr, 0x14), shl(0x60, implementation))
                    mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                    instance := create2(0, ptr, 0x37, salt)
                }
                require(instance != address(0), "ERC1167: create2 failed");
            }
            /**
             * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
             */
            function predictDeterministicAddress(
                address implementation,
                bytes32 salt,
                address deployer
            ) internal pure returns (address predicted) {
                assembly {
                    let ptr := mload(0x40)
                    mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                    mstore(add(ptr, 0x14), shl(0x60, implementation))
                    mstore(add(ptr, 0x28), 0x5af43d82803e903d91602b57fd5bf3ff00000000000000000000000000000000)
                    mstore(add(ptr, 0x38), shl(0x60, deployer))
                    mstore(add(ptr, 0x4c), salt)
                    mstore(add(ptr, 0x6c), keccak256(ptr, 0x37))
                    predicted := keccak256(add(ptr, 0x37), 0x55)
                }
            }
            /**
             * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}.
             */
            function predictDeterministicAddress(address implementation, bytes32 salt)
                internal
                view
                returns (address predicted)
            {
                return predictDeterministicAddress(implementation, salt, address(this));
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)
        pragma solidity ^0.8.0;
        import "../utils/ContextUpgradeable.sol";
        import "../proxy/utils/Initializable.sol";
        /**
         * @dev Contract module which provides a basic access control mechanism, where
         * there is an account (an owner) that can be granted exclusive access to
         * specific functions.
         *
         * By default, the owner account will be the one that deploys the contract. This
         * can later be changed with {transferOwnership}.
         *
         * This module is used through inheritance. It will make available the modifier
         * `onlyOwner`, which can be applied to your functions to restrict their use to
         * the owner.
         */
        abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
            address private _owner;
            event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
            /**
             * @dev Initializes the contract setting the deployer as the initial owner.
             */
            function __Ownable_init() internal onlyInitializing {
                __Context_init_unchained();
                __Ownable_init_unchained();
            }
            function __Ownable_init_unchained() internal onlyInitializing {
                _transferOwnership(_msgSender());
            }
            /**
             * @dev Returns the address of the current owner.
             */
            function owner() public view virtual returns (address) {
                return _owner;
            }
            /**
             * @dev Throws if called by any account other than the owner.
             */
            modifier onlyOwner() {
                require(owner() == _msgSender(), "Ownable: caller is not the owner");
                _;
            }
            /**
             * @dev Leaves the contract without owner. It will not be possible to call
             * `onlyOwner` functions anymore. Can only be called by the current owner.
             *
             * NOTE: Renouncing ownership will leave the contract without an owner,
             * thereby removing any functionality that is only available to the owner.
             */
            function renounceOwnership() public virtual onlyOwner {
                _transferOwnership(address(0));
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Can only be called by the current owner.
             */
            function transferOwnership(address newOwner) public virtual onlyOwner {
                require(newOwner != address(0), "Ownable: new owner is the zero address");
                _transferOwnership(newOwner);
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Internal function without access restriction.
             */
            function _transferOwnership(address newOwner) internal virtual {
                address oldOwner = _owner;
                _owner = newOwner;
                emit OwnershipTransferred(oldOwner, newOwner);
            }
            uint256[49] private __gap;
        }
        

        File 3 of 3: AutoMinterERC721
        // SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        // import '@openzeppelin/contracts/token/ERC721/ERC721.sol';
        import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
        import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
        import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
        import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
        import "./Base64.sol";
        import "./IERC2981Upgradable.sol";
        import "./AutoMinterERC20.sol";
        contract AutoMinterERC721 is Initializable, ERC721Upgradeable, OwnableUpgradeable, IERC2981Upgradeable
        {
            string private baseURI;
            address constant public shareAddress = 0xE28564784a0f57554D8beEc807E8609b40A97241;
            uint256 public mintFee;
            bool private mintSelectionEnabled;
            bool private mintRandomEnabled;
            
            uint256 public remaining;
            mapping(uint256 => uint256) public cache;
            mapping(uint256 => uint256) public cachePosition;
            mapping(address => uint256) public accountMintCount;
            address private whiteListSignerAddress;
            uint256 public mintLimit;
            uint256 public royaltyBasis = 1000;
            uint256 public ammountWithdrawn = 0;
            string public placeholderImage;
            bool public lockBaseUri;
            address constant private autoMinterTokenContract = 0xc00C733702248AeBDb357340ddDdA5C47500A35A;
            constructor(){}
            function initialize(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                address ownerAddress_,
                uint256 mintFee_,
                uint256 size_,
                bool mintSelectionEnabled_,
                bool mintRandomEnabled_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) public initializer  {
                __ERC721_init(name_, symbol_);
                baseURI = baseURI_;
                mintFee = mintFee_;
                mintSelectionEnabled = mintSelectionEnabled_;
                mintRandomEnabled = mintRandomEnabled_;
                _transferOwnership(ownerAddress_);
                remaining = size_;
                whiteListSignerAddress = whiteListSignerAddress_;
                mintLimit = mintLimit_;
                royaltyBasis = royaltyBasis_;
                placeholderImage = placeholderImage_;
            }
            
            function _baseURI() internal view virtual override returns (string memory) {
                return baseURI;
            }
            
            /* Mint specific token if individual token selection is enabled */
            function mintToken(uint256 tokenID) payable public
            {
                require(mintSelectionEnabled == true, 'Specific token minting is not enabled for this contract');
                require(msg.value == mintFee, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender);
                // _splitPayment();
                
                _drawIndex(tokenID);
                
                _safeMint(msg.sender, tokenID);
            }
            
            /* Mint random token if random minting is enabled */
            function mintRandom() payable public
            {
                require(mintRandomEnabled == true, 'Random minting is not enabled for this contract');
                require(msg.value == mintFee, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender);
                
                // _splitPayment();
                
                uint256 tokenID = _drawRandomIndex();
                
                _safeMint(msg.sender, tokenID);
            }
            
            /* Mint 'n' random tokens if random minting is enabled */
            function mintRandom(uint256 count) payable public
            {
                require(count > 0, 'Count must be greater than zero');
                require(mintRandomEnabled == true, 'Random minting is not enabled for this contract');
                require(msg.value == mintFee * count, 'Eth sent does not match the mint fee');
                
                _updateUserMintCount(msg.sender, count);
                for(uint256 i=0; i < count; i++){
                    
                    // _splitPayment();
                    
                    uint256 tokenID = _drawRandomIndex();
                    
                    _safeMint(msg.sender, tokenID);
                }
            }
            
            /* Mint if have been pre-approved using signature of the owner */
            function mintWithSignature(bool isFree, address to, uint256 tokenID, bool isRandom, uint256 customFee, bytes calldata signature) payable public
            {
                _updateUserMintCount(to);
                /* Hash the content (isFree, to, tokenID) and verify the signature from the owner address */
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(isFree, to, tokenID, isRandom, customFee))),
                        signature);
                    
                require(signer == owner() || signer == whiteListSignerAddress, "The signature provided does not match");
                
                /* If isFree then do not splitPayment, else splitPayment */
                if(!isFree){
                    /* If custom fee is not provided use, mint fee */
                    if(customFee == 0){
                        require(msg.value == mintFee, 'Eth sent does not match the mint fee');
                    }
                    /* If custom fee is provided use, the custom fee */
                    else{
                        require(msg.value == customFee, 'Eth sent does not match the mint fee');
                    }
                    // _splitPayment();
                }
                
                /* Mint the token for the provided to address */
                if(isRandom){
                    tokenID = _drawRandomIndex();
                }
                else{
                    _drawIndex(tokenID);
                }
                
                _safeMint(to, tokenID);
            }
            /* Mint 'n' tokens if have been pre-approved using signature of the owner */
            function mintWithSignature(bool isFree, address to, uint256 tokenID, bool isRandom, uint256 customFee, uint256 limit, uint256 count, bytes calldata signature) payable public
            {
                require(count > 0, 'Count must be greater than zero');
                require(count <= limit || limit == 0, 'You are not able to mint more than the allocated limit at once');
                _updateUserMintCount(to, count, limit);
                /* Hash the content (isFree, to, tokenID) and verify the signature from the owner address */
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(isFree, to, tokenID, isRandom, limit, customFee))),
                        signature);
                    
                require(signer == owner() || signer == whiteListSignerAddress, "The signature provided does not match");
                
                /* If isFree then do not splitPayment, else splitPayment */
                if(!isFree){
                    /* If custom fee is not provided use, mint fee */
                    if(customFee == 0){
                        require(msg.value == mintFee * count, 'Eth sent does not match the mint fee');
                    }
                    /* If custom fee is provided use, the custom fee */
                    else{
                        require(msg.value == customFee * count, 'Eth sent does not match the mint fee');
                    }
                    // _splitPayment();
                }
                
                
                for(uint256 i=0; i < count; i++){
                    /* Mint the token for the provided to address */
                    if(isRandom){
                        tokenID = _drawRandomIndex();
                    }
                    else{
                        _drawIndex(tokenID);
                    }
                    
                    _safeMint(to, tokenID);
                }
            }
            
            /* Mint a token to a specific address */
            function mintToAccount(address to, uint256 tokenID) onlyOwner() public
            {
                _drawIndex(tokenID);
                _safeMint(to, tokenID);
            }
            
            /* Mint a token to a specific address */
            function airDropRandomToAccounts(address[] calldata to) onlyOwner() public
            {
                for (uint i=0; i<to.length; i++) {
                    uint256 tokenID = _drawRandomIndex();
                    _safeMint(to[i], tokenID);
                }
            }
            
            // function _splitPayment() internal
            // {
            //     if(msg.value != 0){
            //         uint256 splitValue = msg.value / 10;
            //         uint256 remainingValue = msg.value - splitValue;
                    
            //         payable(shareAddress).transfer(splitValue);
            //         payable(owner()).transfer(remainingValue);
            //     }
            // }
            
            function _drawRandomIndex() internal returns (uint256 index) {
                //RNG
                uint256 i = uint(keccak256(abi.encodePacked(block.timestamp))) % remaining;
                // if there's a cache at cache[i] then use it
                // otherwise use i itself
                index = cache[i] == 0 ? i : cache[i];
                // grab a number from the tail
                cache[i] = cache[remaining - 1] == 0 ? remaining - 1 : cache[remaining - 1];
                
                // store the position of moved token in cache to be looked up (add 1 to avoid 0, remove when recovering)
                cachePosition[cache[i]] = i + 1;
                
                remaining = remaining - 1;
            }
            
            function _drawIndex(uint256 tokenID) internal {
                // recover the index, subtract 1 from cachePosition as an additional 1 was added to avoid 0 conflict
                uint256 i = cachePosition[tokenID] == 0 ? tokenID : cachePosition[tokenID] - 1;
                
                require(i <= remaining);
                
                // grab a number from the tail
                cache[i] = cache[remaining - 1] == 0 ? remaining - 1 : cache[remaining - 1];
                
                // store the position of moved token in cache to be looked up (add 1 to avoid 0, remove when recovering)
                cachePosition[cache[i]] = i + 1;
                
                remaining = remaining - 1;
            }
            
            function _updateUserMintCount(address account) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                require(count < mintLimit || mintLimit == 0, "Mint limit for this account has been exceeded");
                accountMintCount[account] = count + 1;
            }
            
            function _updateUserMintCount(address account, uint256 quantity) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                require(count + quantity <= mintLimit || mintLimit == 0, "Mint limit for this account has been exceeded");
                accountMintCount[account] = count + quantity;
            }
            
            function _updateUserMintCount(address account, uint256 quantity, uint256 customLimit) internal {
                // increment a mapping for user on how many mints they have
                uint256 count = accountMintCount[account];
                if(customLimit == 0){
                    require(count + quantity <= mintLimit || mintLimit == 0, "Mint limit for this account has been exceeded");
                }
                else{
                    require(count + quantity <= customLimit, "Mint limit for this account has been exceeded");
                }
                accountMintCount[account] = count + quantity;
            }
            
            function isTokenAvailable(uint256 tokenID) external view returns (bool)
            {
                return !_exists(tokenID);
            }
            function toggleRandomPublicMinting() onlyOwner() public
            {
                mintRandomEnabled = !mintRandomEnabled;
            }
            function changeMintFee(uint256 mintFee_) onlyOwner() public
            {
                mintFee = mintFee_;
            }
            function changeMintLimit(uint256 mintLimit_) onlyOwner() public
            {
                mintLimit = mintLimit_;
            }
            function changePlaceholderImage(string memory placeholderImage_) onlyOwner() public
            {
                require(bytes(placeholderImage).length != 0, "Metadata has already been revealed");
                require(bytes(placeholderImage_).length != 0, "Placeholder image cannot be empty");
                placeholderImage = placeholderImage_;
            }
            function royaltyInfo(uint _tokenId, uint _salePrice) external view returns (address receiver, uint royaltyAmount) {
                return (address(this), uint((_salePrice * royaltyBasis)/10000));
            }
            
            /* Transfer balance of this contract to an account */
            function transferBalance(address payable to, uint256 ammount) onlyOwner() public{
                
                if(address(this).balance != 0){
                    require(address(this).balance <= ammount, "Not enought Balance to Transfer");
                    uint256 splitValue = ammount / 20;
                    uint256 remainingValue = ammount - splitValue;
                    
                    // if mainnet, earn tokens
                    if(block.chainid == 1 || block.chainid == 5 || block.chainid == 5777){
                        _mintAutoMinterTokens(to, splitValue);
                    }
                    else{
                        payable(shareAddress).transfer(splitValue);
                    }
                    payable(to).transfer(remainingValue);
                    ammountWithdrawn += ammount;
                }
            }
            
            /* Transfer any ERC20 balance of this contract to an account */
            function transferERC20Balance(address erc20ContractAddress, address payable to, uint256 ammount) onlyOwner() public{
                uint256 splitValue = ammount / 10;
                uint256 remainingValue = ammount - splitValue;
                IERC20(erc20ContractAddress).transfer(shareAddress, splitValue);
                IERC20(erc20ContractAddress).transfer(to, remainingValue);
            }
            
            function contractURI() public view returns (string memory) {
                return string(abi.encodePacked(
                    "data:application/json;base64,",
                    Base64.encode(
                        bytes(
                            string(abi.encodePacked('{"name":"', name(), '","seller_fee_basis_points":', Strings.toString(royaltyBasis), ',"fee_recipient":"', "0x", toAsciiString(address(this)), '"}' ))
                        )
                    )
                ));
            }
            function toAsciiString(address x) internal pure returns (string memory) {
                bytes memory s = new bytes(40);
                for (uint i = 0; i < 20; i++) {
                    bytes1 b = bytes1(uint8(uint(uint160(x)) / (2**(8*(19 - i)))));
                    bytes1 hi = bytes1(uint8(b) / 16);
                    bytes1 lo = bytes1(uint8(b) - 16 * uint8(hi));
                    s[2*i] = char(hi);
                    s[2*i+1] = char(lo);            
                }
                return string(s);
            }
            function char(bytes1 b) internal pure returns (bytes1 c) {
                if (uint8(b) < 10) return bytes1(uint8(b) + 0x30);
                else return bytes1(uint8(b) + 0x57);
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721Upgradeable, IERC165Upgradeable) returns (bool) {
                return
                    interfaceId == type(IERC721Upgradeable).interfaceId ||
                    interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                    interfaceId == type(IERC2981Upgradeable).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            function isPublicMintingEnabled() external view returns (bool){
                return mintRandomEnabled;
            }
            
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                string memory baseURI = _baseURI();
                if(bytes(placeholderImage).length > 0){
                    return placeholderImage;
                }
                else{
                    return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, Strings.toString(tokenId))) : "";
                }
            }
            function reveal() onlyOwner() public {
                placeholderImage = "";
            }
            function changeBaseUri(string memory baseURI_) onlyOwner() public {
                require(!lockBaseUri, "Base URI is locked, it cannot be edited");
                baseURI = baseURI_;
            }
            function permanentlyLockBaseUri() onlyOwner() public {
                lockBaseUri = true;
            }
            function getMintsUsed(address account) external view returns (uint256) {
                return accountMintCount[account];
            }
            function _mintAutoMinterTokens(address to, uint256 value) private {
                AutoMinterERC20(autoMinterTokenContract).mint{value:value}(to);
            }
            
            function version() external pure returns (string memory)
            {
                return "1.0.7";
            }
            receive() external payable {}
        }
        // SPDX-License-Identifier: UNLICENSED
        import "@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol";
        pragma solidity >=0.7.0 <0.9.0;
        // import "@openzeppelin/contracts-upgradeable/interfaces/IERC2981Upgradeable.sol";
        /**
         * @dev Interface for the NFT Royalty Standard
         */
        interface IERC2981Upgradeable is IERC165Upgradeable {
            /**
             * @dev Called with the sale price to determine how much royalty is owed and to whom.
             * @param tokenId - the NFT asset queried for royalty information
             * @param salePrice - the sale price of the NFT asset specified by `tokenId`
             * @return receiver - address of who should be sent the royalty payment
             * @return royaltyAmount - the royalty payment amount for `salePrice`
             */
            function royaltyInfo(uint256 tokenId, uint256 salePrice)
                external
                view
                returns (address receiver, uint256 royaltyAmount);
        }
        // SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        interface IAutoMinterFactory
        {
            /* Create an NFT Collection and pay the fee */
            function create(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                string memory appId_,
                uint256 mintFee_,
                uint256 size_,
                bool mintSelectionEnabled_,
                bool mintRandomEnabled_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) payable external;
            
            /* Create an NFT Collection and pay the fee */
            function createConsecutive(string memory name_,
                string memory symbol_,
                string memory baseURI_,
                string memory appId_,
                uint256 mintFee_,
                uint256 size_,
                address whiteListSignerAddress_,
                uint256 mintLimit_,
                uint256 royaltyBasis_,
                string memory placeholderImage_) payable external;
            
            /* Change the fee charged for creating contracts */
            function changeFee(uint256 newFee) external;
            function addExistingCollection(address collectionAddress, address owner, string memory appId) external;
            function transferBalance(address payable to, uint256 ammount) external;
            
            function version() external pure returns (string memory);
            function setERC721Implementation(address payable implementationContract) external;
            function setERC721AImplementation(address payable implementationContract) external;
            function isCollectionValid(address collectionAddress) external view returns (bool);
        }// SPDX-License-Identifier: MIT
        pragma solidity ^0.8.0;
        /// @title Base64
        /// @author Brecht Devos - <brecht@loopring.org>
        /// @notice Provides a function for encoding some bytes in base64
        library Base64 {
            string internal constant TABLE =
                "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
            function encode(bytes memory data) internal pure returns (string memory) {
                if (data.length == 0) return "";
                // load the table into memory
                string memory table = TABLE;
                // multiply by 4/3 rounded up
                uint256 encodedLen = 4 * ((data.length + 2) / 3);
                // add some extra buffer at the end required for the writing
                string memory result = new string(encodedLen + 32);
                assembly {
                    // set the actual output length
                    mstore(result, encodedLen)
                    // prepare the lookup table
                    let tablePtr := add(table, 1)
                    // input ptr
                    let dataPtr := data
                    let endPtr := add(dataPtr, mload(data))
                    // result ptr, jump over length
                    let resultPtr := add(result, 32)
                    // run over the input, 3 bytes at a time
                    for {
                    } lt(dataPtr, endPtr) {
                    } {
                        dataPtr := add(dataPtr, 3)
                        // read 3 bytes
                        let input := mload(dataPtr)
                        // write 4 characters
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(shr(18, input), 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(shr(12, input), 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(shr(6, input), 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                        mstore(
                            resultPtr,
                            shl(248, mload(add(tablePtr, and(input, 0x3F))))
                        )
                        resultPtr := add(resultPtr, 1)
                    }
                    // padding with '='
                    switch mod(mload(data), 3)
                    case 1 {
                        mstore(sub(resultPtr, 2), shl(240, 0x3d3d))
                    }
                    case 2 {
                        mstore(sub(resultPtr, 1), shl(248, 0x3d))
                    }
                }
                return result;
            }
        }// SPDX-License-Identifier: UNLICENSED
        pragma solidity >=0.7.0 <0.9.0;
        import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
        import "@openzeppelin/contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol";
        import '@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol';
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "./IAutoMinterFactory.sol";
        contract AutoMinterERC20 is Initializable, ERC20Upgradeable, OwnableUpgradeable {
            
            // revenue supplied to the contract
            uint256 private revenue;
            // the signer address for verifying airdrops
            address private airdropSignerAddress;
            // the quantity of supply claimed in the airdrop
            uint256 private quantityClaimed;
            // the max supply to be claimed in the airdrop
            uint256 private airdropLimit;
            // the address of the staking contract
            address private stakingContract;
            // the address of the treasury, team, investor treasury fund contract
            address private fundsContract;
            // the amount that each account has claimed in the airdrop
            mapping(address => bool) public accountClaimed;
            
            // AutoMinter Factory contract to check valid collection addresses
            IAutoMinterFactory private autoMinterFactory;
            // the integer representing the current lock window
            uint256 public currentLockWindow;
            // is airdrop tradable
            bool public isAirdropTradable;
            struct LockInfo {
                uint256 lockWindow;
                uint256 totalLockAmount;
                uint256 currentLockWindowAmount;
                uint256 previousLockWindowAmount;
                uint256 lastLockWindowAmount;
                uint256 airdropAmount;
            }
            mapping(address => LockInfo) private accountLockedTokens;
            // the max supply reserved for strategic sale + liquidity provision
            uint256 private strategicLiquidityLimit;
            // the quantity of supply strategic liquidity released
            uint256 private strategicLiquidityReleased;
            constructor() {}
            function initialize(address stakingContract_, address fundsContract_, address autoMinterFactoryContract_) public virtual initializer {
                __ERC20_init("AutoMinter", "AMR");
                _transferOwnership(msg.sender);
                airdropSignerAddress = msg.sender;
                stakingContract = stakingContract_;
                fundsContract = fundsContract_;
                airdropLimit = 2000000000000000000000000;
                strategicLiquidityLimit = 2000000000000000000000000;
                autoMinterFactory = IAutoMinterFactory(autoMinterFactoryContract_);
            }
            
            /**
             * @notice Claim the initil airdropped tokens
             * @dev Claim the initial allocation of tokens by providing the correct signature
             * @param amount the amount of tokens available to mint
             * @param signature the signature required to prove airdrop rights
             */
            function claim(uint256 amount, bytes calldata signature, address to) public
            {
                // check airdrop supply for a cap on how much can be claimed in the airdrop
                require(airdropLimit >= quantityClaimed + amount);
                // wallets can only claim 1 airdrop
                require(accountClaimed[to] == false);
                // Hash the content (amount, claimant) and verify the signature from the owner address
                address signer = ECDSA.recover(
                        ECDSA.toEthSignedMessageHash(keccak256(abi.encodePacked(amount, to))),
                        signature);
                // check signature is valid
                require(signer == owner() || signer == airdropSignerAddress, "The signature provided does not match");
                // set claimant claim status to true
                accountClaimed[to] = true;
                accountLockedTokens[to].airdropAmount = amount;
                // mint the provided number of tokens
                _mint(to, amount);
            }
            /**
             * @notice Mint new tokens
             * @dev Exchange ETH for tokens by sending revenue
             * @param to the address which tokens should be minted too
             */
            function mint(address to) payable public
            {
                // require contract caller to be a registered contract to avoid direct mints
                require(autoMinterFactory.isCollectionValid(msg.sender), "Tokens can only be minted via contracts created with AutoMinter");
                // get value exchanged for tokens (decreasing marginal amount)
                uint256 value = _getValueDeduction(msg.sender, msg.value);
                // get the new number of tokens to mint (based on allocation curve)
                uint256 currentSupply = _getTotalAllocation(revenue);
                uint256 newSupply = _getTotalAllocation(revenue + value);
                uint256 diff = newSupply - currentSupply;
                uint256 volumeRewardsQuantity = diff  * 35 / 96;
                uint256 stakingRewardsQuantity = diff  * 17 / 96;
                uint256 fundsQuantity = diff  * 46 / 96;
                // lock new volume reward tokens
                _updateLockedTokens(to, volumeRewardsQuantity);
                // mint tokens based on new allocation (getAllocation)
                _mint(to, volumeRewardsQuantity);
                _mint(fundsContract, fundsQuantity);
                _mint(stakingContract, stakingRewardsQuantity);
                // update revenue
                revenue = revenue + value;
            }
            /**
             * @notice Transfer funds from the contract
             * @dev Transfer funds from the contract
             */
            function transferFunds() onlyOwner() public
            {
                uint256 balance = address(this).balance;
                payable(owner()).transfer(balance);
            }
            /**
             * @notice update the signer address for claimable airdrop
             * @dev the signer is the address who signs the claimable airdrop required signature
             */
            function updateSigner(address signer) onlyOwner() public
            {
                airdropSignerAddress = signer;
            }
            /**
             * @notice update the signer address for claimable airdrop
             * @dev the signer is the address who signs the claimable airdrop required signature
             */
            function updateStakingContract(address stakingContract_) onlyOwner() public
            {
                stakingContract = stakingContract_;
            }
            /**
             * @notice update the autominter factory address for validating source
             * @dev update the autominter factory address for validating source
             */
            function updateFactoryContract(address autoMinterFactoryContract_) onlyOwner() public
            {
                autoMinterFactory = IAutoMinterFactory(autoMinterFactoryContract_);
            }
            /**
             * @notice allow airdrop to be tradable
             * @dev allow airdropped tokens to be tradable and unlocked
             */
            function unlockAirdropTokens() onlyOwner() public
            {
                isAirdropTradable = true;
            }
            /**
             * @notice move the next lock window for users tokens to be unlocked
             * @dev move the next lock window period forward to unlock new tokens
             */
            function nextLockWindow() onlyOwner() public
            {
                currentLockWindow += 1;
            }
            
            /**
             * @notice check if wallet has claimed airdrop
             * @dev check if the provided wallet has already claimed the airdrop
             * @param account account to check claimed status
             */
            function hasClaimedAirdrop(address account) external view returns (bool)
            {
                return accountClaimed[account];
            }
            
            /**
             * @notice Move the strategic liquidity tokens
             * @dev The reserve of tokens reserved for liquidity provisioning and strategic sale
             * @param amount how much of the reserves to move in wei
             * @param to the address to send the reserves too
             */
            function moveStrategicLiquidityReserves(uint256 amount, address to) onlyOwner() public
            {
                // check airdrop supply for a cap on how much can be claimed in the airdrop
                require(strategicLiquidityLimit >= strategicLiquidityReleased + amount);
                strategicLiquidityReleased += amount;
                // mint the provided number of tokens
                _mint(to, amount);
            }
            /**
             * @notice get the number of locked tokens
             * @dev get the number of locked tokens for an account
             * @param account account to check locked token amount
             */
            function getLockedTokens(address account) external view returns (uint256)
            {
                return _getLockedTokens(account);
            }
            
            /**
             * @notice get the number of locked tokens
             * @dev get the number of locked tokens for an account
             * @param account account to check locked token amount
             */
            function _getLockedTokens(address account)  private view returns (uint256)
            {
                uint256 lockedAmount = 0;
                LockInfo storage lockInfo = accountLockedTokens[account];
                if(!isAirdropTradable){
                    lockedAmount += lockInfo.airdropAmount;
                }
                
                uint256 windowsSkipped = currentLockWindow - lockInfo.lockWindow;
                if(windowsSkipped == 0){
                    lockedAmount += lockInfo.currentLockWindowAmount + lockInfo.previousLockWindowAmount + lockInfo.lastLockWindowAmount;
                }
                else if(windowsSkipped == 1){
                    lockedAmount += lockInfo.currentLockWindowAmount + lockInfo.previousLockWindowAmount;
                }
                else if(windowsSkipped == 2){
                    lockedAmount += lockInfo.currentLockWindowAmount;
                }
                else{
                    // ignore all lock measures
                }
                return lockedAmount;
            }
            /**
             * @notice update the number of locked tokens for a user
             * @dev update the number of locked tokens for a user
             * @param account account to lock tokens for
             * @param account new number of tokens to lock
             */
            function _updateLockedTokens(address account, uint256 amount) private
            {
                LockInfo storage lockInfo = accountLockedTokens[account];
                // do nothing if amount is 0 and lock window is the same
                if(lockInfo.lockWindow == currentLockWindow && amount == 0){
                    return;
                }
                // if the lock window hasnt altered since the last update, update the lock amounts for the current window and total
                else if(lockInfo.lockWindow == currentLockWindow){
                    accountLockedTokens[account].totalLockAmount += amount;
                    accountLockedTokens[account].currentLockWindowAmount += amount;
                    return;
                }
                // if the lock window has altered by 1, then unlock the oldest tokens, and move the rest
                else if(lockInfo.lockWindow + 1 == currentLockWindow){
                    // update lock window
                    accountLockedTokens[account].lockWindow = currentLockWindow;
                    // move previous locked tokens to last
                    accountLockedTokens[account].lastLockWindowAmount = lockInfo.previousLockWindowAmount;
                    
                    // move current tokens to previous
                    accountLockedTokens[account].previousLockWindowAmount = lockInfo.currentLockWindowAmount;
                    // update current locked tokens
                    accountLockedTokens[account].currentLockWindowAmount = amount;
                    // total count increass by new tokens, decreases by releasing the last lock window tokens
                    accountLockedTokens[account].totalLockAmount += amount - lockInfo.lastLockWindowAmount;
                    return;
                }
                // if the lock window has altered by 2, then unlock the oldest and previous tokens, and move the rest
                else if(lockInfo.lockWindow + 2 == currentLockWindow){
                    // update lock window
                    accountLockedTokens[account].lockWindow = currentLockWindow;
                    // move current locked tokens to last
                    accountLockedTokens[account].lastLockWindowAmount = lockInfo.currentLockWindowAmount;
                    // update current locked tokens
                    accountLockedTokens[account].currentLockWindowAmount = amount;
                    // total count increass by new tokens, decreases by releasing the last lock window tokens and previous tokens
                    accountLockedTokens[account].totalLockAmount += amount - lockInfo.lastLockWindowAmount - lockInfo.previousLockWindowAmount;
                    return;
                }
                // if the lock window has altered by 3 or more, then unlock all tokens
                else{
                    // update lock window
                    accountLockedTokens[account].lockWindow = currentLockWindow;
                    // move last locked tokens to last
                    accountLockedTokens[account].lastLockWindowAmount = 0;
                    // move previous locked tokens to last
                    accountLockedTokens[account].previousLockWindowAmount = 0;
                    // update current locked tokens
                    accountLockedTokens[account].currentLockWindowAmount = amount;
                    // total count increass by new tokens, decreases by releasing the last lock window tokens and previous tokens
                    accountLockedTokens[account].totalLockAmount += amount;
                    return;
                }
            }
            /**
             * @notice Get the number of tokens allocated based on revenue
             * @dev The allocation curve determines how many tokens are allocated in total
             * @param amount the revenue to determine the current value
             * @return uint256 the amount of tokens be exchanged
             */
            function _getTotalAllocation(uint256 amount) pure private returns (uint256)
            {
                // get the current token supply based on revenue
                uint256 supply = 20000000000000000000000000 + (980000000000000000000000000 * amount + 10000000000000000000000) / (amount + 5000000000000000000000);
                
                return supply;
            }
            /**
             * @notice Get the equivilent value of revenue paid to be exchanged for new tokens
             * @dev The more tokens are minted, the less marginally you will get next time
             * @param source the source of extraction
             * @param amount the amount to be exchanged
             * @return uint256 the equivilent value to be exchanged
             */
            function _getValueDeduction(address source, uint256 amount) pure private returns (uint256)
            {
                return amount;
            }
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 amount
            ) internal virtual override(ERC20Upgradeable) {
                super._beforeTokenTransfer(from, to, amount);
                // _updateLockedTokens(from, 0);
                require(from == address(0) || super.balanceOf(from) - _getLockedTokens(from) >= amount, "AutoMinterERC20: Transfer amount exceeds unlocked token amount");
            }
        }// SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/cryptography/ECDSA.sol)
        pragma solidity ^0.8.0;
        import "../Strings.sol";
        /**
         * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
         *
         * These functions can be used to verify that a message was signed by the holder
         * of the private keys of a given address.
         */
        library ECDSA {
            enum RecoverError {
                NoError,
                InvalidSignature,
                InvalidSignatureLength,
                InvalidSignatureS,
                InvalidSignatureV
            }
            function _throwError(RecoverError error) private pure {
                if (error == RecoverError.NoError) {
                    return; // no error: do nothing
                } else if (error == RecoverError.InvalidSignature) {
                    revert("ECDSA: invalid signature");
                } else if (error == RecoverError.InvalidSignatureLength) {
                    revert("ECDSA: invalid signature length");
                } else if (error == RecoverError.InvalidSignatureS) {
                    revert("ECDSA: invalid signature 's' value");
                } else if (error == RecoverError.InvalidSignatureV) {
                    revert("ECDSA: invalid signature 'v' value");
                }
            }
            /**
             * @dev Returns the address that signed a hashed message (`hash`) with
             * `signature` or error string. This address can then be used for verification purposes.
             *
             * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
             * this function rejects them by requiring the `s` value to be in the lower
             * half order, and the `v` value to be either 27 or 28.
             *
             * IMPORTANT: `hash` _must_ be the result of a hash operation for the
             * verification to be secure: it is possible to craft signatures that
             * recover to arbitrary addresses for non-hashed data. A safe way to ensure
             * this is by receiving a hash of the original message (which may otherwise
             * be too long), and then calling {toEthSignedMessageHash} on it.
             *
             * Documentation for signature generation:
             * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
             * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
             *
             * _Available since v4.3._
             */
            function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
                // Check the signature length
                // - case 65: r,s,v signature (standard)
                // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
                if (signature.length == 65) {
                    bytes32 r;
                    bytes32 s;
                    uint8 v;
                    // ecrecover takes the signature parameters, and the only way to get them
                    // currently is to use assembly.
                    assembly {
                        r := mload(add(signature, 0x20))
                        s := mload(add(signature, 0x40))
                        v := byte(0, mload(add(signature, 0x60)))
                    }
                    return tryRecover(hash, v, r, s);
                } else if (signature.length == 64) {
                    bytes32 r;
                    bytes32 vs;
                    // ecrecover takes the signature parameters, and the only way to get them
                    // currently is to use assembly.
                    assembly {
                        r := mload(add(signature, 0x20))
                        vs := mload(add(signature, 0x40))
                    }
                    return tryRecover(hash, r, vs);
                } else {
                    return (address(0), RecoverError.InvalidSignatureLength);
                }
            }
            /**
             * @dev Returns the address that signed a hashed message (`hash`) with
             * `signature`. This address can then be used for verification purposes.
             *
             * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
             * this function rejects them by requiring the `s` value to be in the lower
             * half order, and the `v` value to be either 27 or 28.
             *
             * IMPORTANT: `hash` _must_ be the result of a hash operation for the
             * verification to be secure: it is possible to craft signatures that
             * recover to arbitrary addresses for non-hashed data. A safe way to ensure
             * this is by receiving a hash of the original message (which may otherwise
             * be too long), and then calling {toEthSignedMessageHash} on it.
             */
            function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
                (address recovered, RecoverError error) = tryRecover(hash, signature);
                _throwError(error);
                return recovered;
            }
            /**
             * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
             *
             * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
             *
             * _Available since v4.3._
             */
            function tryRecover(
                bytes32 hash,
                bytes32 r,
                bytes32 vs
            ) internal pure returns (address, RecoverError) {
                bytes32 s;
                uint8 v;
                assembly {
                    s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
                    v := add(shr(255, vs), 27)
                }
                return tryRecover(hash, v, r, s);
            }
            /**
             * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
             *
             * _Available since v4.2._
             */
            function recover(
                bytes32 hash,
                bytes32 r,
                bytes32 vs
            ) internal pure returns (address) {
                (address recovered, RecoverError error) = tryRecover(hash, r, vs);
                _throwError(error);
                return recovered;
            }
            /**
             * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
             * `r` and `s` signature fields separately.
             *
             * _Available since v4.3._
             */
            function tryRecover(
                bytes32 hash,
                uint8 v,
                bytes32 r,
                bytes32 s
            ) internal pure returns (address, RecoverError) {
                // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
                // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                //
                // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                // these malleable signatures as well.
                if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
                    return (address(0), RecoverError.InvalidSignatureS);
                }
                if (v != 27 && v != 28) {
                    return (address(0), RecoverError.InvalidSignatureV);
                }
                // If the signature is valid (and not malleable), return the signer address
                address signer = ecrecover(hash, v, r, s);
                if (signer == address(0)) {
                    return (address(0), RecoverError.InvalidSignature);
                }
                return (signer, RecoverError.NoError);
            }
            /**
             * @dev Overload of {ECDSA-recover} that receives the `v`,
             * `r` and `s` signature fields separately.
             */
            function recover(
                bytes32 hash,
                uint8 v,
                bytes32 r,
                bytes32 s
            ) internal pure returns (address) {
                (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
                _throwError(error);
                return recovered;
            }
            /**
             * @dev Returns an Ethereum Signed Message, created from a `hash`. This
             * produces hash corresponding to the one signed with the
             * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
             * JSON-RPC method as part of EIP-191.
             *
             * See {recover}.
             */
            function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
                // 32 is the length in bytes of hash,
                // enforced by the type signature above
                return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
        32", hash));
            }
            /**
             * @dev Returns an Ethereum Signed Message, created from `s`. This
             * produces hash corresponding to the one signed with the
             * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
             * JSON-RPC method as part of EIP-191.
             *
             * See {recover}.
             */
            function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
                return keccak256(abi.encodePacked("\\x19Ethereum Signed Message:\
        ", Strings.toString(s.length), s));
            }
            /**
             * @dev Returns an Ethereum Signed Typed Data, created from a
             * `domainSeparator` and a `structHash`. This produces hash corresponding
             * to the one signed with the
             * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
             * JSON-RPC method as part of EIP-712.
             *
             * See {recover}.
             */
            function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
                return keccak256(abi.encodePacked("\\x19\\x01", domainSeparator, structHash));
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev String operations.
         */
        library Strings {
            bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
            /**
             * @dev Converts a `uint256` to its ASCII `string` decimal representation.
             */
            function toString(uint256 value) internal pure returns (string memory) {
                // Inspired by OraclizeAPI's implementation - MIT licence
                // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                if (value == 0) {
                    return "0";
                }
                uint256 temp = value;
                uint256 digits;
                while (temp != 0) {
                    digits++;
                    temp /= 10;
                }
                bytes memory buffer = new bytes(digits);
                while (value != 0) {
                    digits -= 1;
                    buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                    value /= 10;
                }
                return string(buffer);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
             */
            function toHexString(uint256 value) internal pure returns (string memory) {
                if (value == 0) {
                    return "0x00";
                }
                uint256 temp = value;
                uint256 length = 0;
                while (temp != 0) {
                    length++;
                    temp >>= 8;
                }
                return toHexString(value, length);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
             */
            function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                bytes memory buffer = new bytes(2 * length + 2);
                buffer[0] = "0";
                buffer[1] = "x";
                for (uint256 i = 2 * length + 1; i > 1; --i) {
                    buffer[i] = _HEX_SYMBOLS[value & 0xf];
                    value >>= 4;
                }
                require(value == 0, "Strings: hex length insufficient");
                return string(buffer);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC20 standard as defined in the EIP.
         */
        interface IERC20 {
            /**
             * @dev Returns the amount of tokens in existence.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns the amount of tokens owned by `account`.
             */
            function balanceOf(address account) external view returns (uint256);
            /**
             * @dev Moves `amount` tokens from the caller's account to `recipient`.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transfer(address recipient, uint256 amount) external returns (bool);
            /**
             * @dev Returns the remaining number of tokens that `spender` will be
             * allowed to spend on behalf of `owner` through {transferFrom}. This is
             * zero by default.
             *
             * This value changes when {approve} or {transferFrom} are called.
             */
            function allowance(address owner, address spender) external view returns (uint256);
            /**
             * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * IMPORTANT: Beware that changing an allowance with this method brings the risk
             * that someone may use both the old and the new allowance by unfortunate
             * transaction ordering. One possible solution to mitigate this race
             * condition is to first reduce the spender's allowance to 0 and set the
             * desired value afterwards:
             * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
             *
             * Emits an {Approval} event.
             */
            function approve(address spender, uint256 amount) external returns (bool);
            /**
             * @dev Moves `amount` tokens from `sender` to `recipient` using the
             * allowance mechanism. `amount` is then deducted from the caller's
             * allowance.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) external returns (bool);
            /**
             * @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);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC165 standard, as defined in the
         * https://eips.ethereum.org/EIPS/eip-165[EIP].
         *
         * Implementers can declare support of contract interfaces, which can then be
         * queried by others ({ERC165Checker}).
         *
         * For an implementation, see {ERC165}.
         */
        interface IERC165Upgradeable {
            /**
             * @dev Returns true if this contract implements the interface defined by
             * `interfaceId`. See the corresponding
             * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
             * to learn more about how these ids are created.
             *
             * This function call must use less than 30 000 gas.
             */
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
        pragma solidity ^0.8.0;
        import "./IERC165Upgradeable.sol";
        import "../../proxy/utils/Initializable.sol";
        /**
         * @dev Implementation of the {IERC165} interface.
         *
         * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
         * for the additional interface id that will be supported. For example:
         *
         * ```solidity
         * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
         *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
         * }
         * ```
         *
         * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
         */
        abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
            function __ERC165_init() internal onlyInitializing {
                __ERC165_init_unchained();
            }
            function __ERC165_init_unchained() internal onlyInitializing {
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
                return interfaceId == type(IERC165Upgradeable).interfaceId;
            }
            uint256[50] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev String operations.
         */
        library StringsUpgradeable {
            bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
            /**
             * @dev Converts a `uint256` to its ASCII `string` decimal representation.
             */
            function toString(uint256 value) internal pure returns (string memory) {
                // Inspired by OraclizeAPI's implementation - MIT licence
                // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
                if (value == 0) {
                    return "0";
                }
                uint256 temp = value;
                uint256 digits;
                while (temp != 0) {
                    digits++;
                    temp /= 10;
                }
                bytes memory buffer = new bytes(digits);
                while (value != 0) {
                    digits -= 1;
                    buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
                    value /= 10;
                }
                return string(buffer);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
             */
            function toHexString(uint256 value) internal pure returns (string memory) {
                if (value == 0) {
                    return "0x00";
                }
                uint256 temp = value;
                uint256 length = 0;
                while (temp != 0) {
                    length++;
                    temp >>= 8;
                }
                return toHexString(value, length);
            }
            /**
             * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
             */
            function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
                bytes memory buffer = new bytes(2 * length + 2);
                buffer[0] = "0";
                buffer[1] = "x";
                for (uint256 i = 2 * length + 1; i > 1; --i) {
                    buffer[i] = _HEX_SYMBOLS[value & 0xf];
                    value >>= 4;
                }
                require(value == 0, "Strings: hex length insufficient");
                return string(buffer);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
        pragma solidity ^0.8.0;
        import "../proxy/utils/Initializable.sol";
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract ContextUpgradeable is Initializable {
            function __Context_init() internal onlyInitializing {
                __Context_init_unchained();
            }
            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;
            }
            uint256[50] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/Address.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Collection of functions related to the address type
         */
        library AddressUpgradeable {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize, which returns 0 for contracts in
                // construction, since the code is only stored at the end of the
                // constructor execution.
                uint256 size;
                assembly {
                    size := extcodesize(account)
                }
                return size > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
             * `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but also transferring `value` wei to `target`.
             *
             * Requirements:
             *
             * - the calling contract must have an ETH balance of at least `value`.
             * - the called Solidity function must be `payable`.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
            }
            /**
             * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
             * with `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(address(this).balance >= value, "Address: insufficient balance for call");
                require(isContract(target), "Address: call to non-contract");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "Address: low-level static call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                require(isContract(target), "Address: static call to non-contract");
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    // Look for revert reason and bubble it up if present
                    if (returndata.length > 0) {
                        // The easiest way to bubble the revert reason is using memory via assembly
                        assembly {
                            let returndata_size := mload(returndata)
                            revert(add(32, returndata), returndata_size)
                        }
                    } else {
                        revert(errorMessage);
                    }
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
        pragma solidity ^0.8.0;
        import "../IERC721Upgradeable.sol";
        /**
         * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
         * @dev See https://eips.ethereum.org/EIPS/eip-721
         */
        interface IERC721MetadataUpgradeable is IERC721Upgradeable {
            /**
             * @dev Returns the token collection name.
             */
            function name() external view returns (string memory);
            /**
             * @dev Returns the token collection symbol.
             */
            function symbol() external view returns (string memory);
            /**
             * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
             */
            function tokenURI(uint256 tokenId) external view returns (string memory);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165Upgradeable.sol";
        /**
         * @dev Required interface of an ERC721 compliant contract.
         */
        interface IERC721Upgradeable is IERC165Upgradeable {
            /**
             * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
             */
            event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
             */
            event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
             */
            event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
            /**
             * @dev Returns the number of tokens in ``owner``'s account.
             */
            function balanceOf(address owner) external view returns (uint256 balance);
            /**
             * @dev Returns the owner of the `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function ownerOf(uint256 tokenId) external view returns (address owner);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Transfers `tokenId` token from `from` to `to`.
             *
             * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Gives permission to `to` to transfer `tokenId` token to another account.
             * The approval is cleared when the token is transferred.
             *
             * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
             *
             * Requirements:
             *
             * - The caller must own the token or be an approved operator.
             * - `tokenId` must exist.
             *
             * Emits an {Approval} event.
             */
            function approve(address to, uint256 tokenId) external;
            /**
             * @dev Returns the account approved for `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function getApproved(uint256 tokenId) external view returns (address operator);
            /**
             * @dev Approve or remove `operator` as an operator for the caller.
             * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
             *
             * Requirements:
             *
             * - The `operator` cannot be the caller.
             *
             * Emits an {ApprovalForAll} event.
             */
            function setApprovalForAll(address operator, bool _approved) external;
            /**
             * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
             *
             * See {setApprovalForAll}
             */
            function isApprovedForAll(address owner, address operator) external view returns (bool);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes calldata data
            ) external;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)
        pragma solidity ^0.8.0;
        /**
         * @title ERC721 token receiver interface
         * @dev Interface for any contract that wants to support safeTransfers
         * from ERC721 asset contracts.
         */
        interface IERC721ReceiverUpgradeable {
            /**
             * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
             * by `operator` from `from`, this function is called.
             *
             * It must return its Solidity selector to confirm the token transfer.
             * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
             *
             * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
             */
            function onERC721Received(
                address operator,
                address from,
                uint256 tokenId,
                bytes calldata data
            ) external returns (bytes4);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC721/ERC721.sol)
        pragma solidity ^0.8.0;
        import "./IERC721Upgradeable.sol";
        import "./IERC721ReceiverUpgradeable.sol";
        import "./extensions/IERC721MetadataUpgradeable.sol";
        import "../../utils/AddressUpgradeable.sol";
        import "../../utils/ContextUpgradeable.sol";
        import "../../utils/StringsUpgradeable.sol";
        import "../../utils/introspection/ERC165Upgradeable.sol";
        import "../../proxy/utils/Initializable.sol";
        /**
         * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
         * the Metadata extension, but not including the Enumerable extension, which is available separately as
         * {ERC721Enumerable}.
         */
        contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
            using AddressUpgradeable for address;
            using StringsUpgradeable for uint256;
            // Token name
            string private _name;
            // Token symbol
            string private _symbol;
            // Mapping from token ID to owner address
            mapping(uint256 => address) private _owners;
            // Mapping owner address to token count
            mapping(address => uint256) private _balances;
            // Mapping from token ID to approved address
            mapping(uint256 => address) private _tokenApprovals;
            // Mapping from owner to operator approvals
            mapping(address => mapping(address => bool)) private _operatorApprovals;
            /**
             * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
             */
            function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
                __Context_init_unchained();
                __ERC165_init_unchained();
                __ERC721_init_unchained(name_, symbol_);
            }
            function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                _name = name_;
                _symbol = symbol_;
            }
            /**
             * @dev See {IERC165-supportsInterface}.
             */
            function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
                return
                    interfaceId == type(IERC721Upgradeable).interfaceId ||
                    interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
                    super.supportsInterface(interfaceId);
            }
            /**
             * @dev See {IERC721-balanceOf}.
             */
            function balanceOf(address owner) public view virtual override returns (uint256) {
                require(owner != address(0), "ERC721: balance query for the zero address");
                return _balances[owner];
            }
            /**
             * @dev See {IERC721-ownerOf}.
             */
            function ownerOf(uint256 tokenId) public view virtual override returns (address) {
                address owner = _owners[tokenId];
                require(owner != address(0), "ERC721: owner query for nonexistent token");
                return owner;
            }
            /**
             * @dev See {IERC721Metadata-name}.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev See {IERC721Metadata-symbol}.
             */
            function symbol() public view virtual override returns (string memory) {
                return _symbol;
            }
            /**
             * @dev See {IERC721Metadata-tokenURI}.
             */
            function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
                require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
                string memory baseURI = _baseURI();
                return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
            }
            /**
             * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
             * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
             * by default, can be overriden in child contracts.
             */
            function _baseURI() internal view virtual returns (string memory) {
                return "";
            }
            /**
             * @dev See {IERC721-approve}.
             */
            function approve(address to, uint256 tokenId) public virtual override {
                address owner = ERC721Upgradeable.ownerOf(tokenId);
                require(to != owner, "ERC721: approval to current owner");
                require(
                    _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
                    "ERC721: approve caller is not owner nor approved for all"
                );
                _approve(to, tokenId);
            }
            /**
             * @dev See {IERC721-getApproved}.
             */
            function getApproved(uint256 tokenId) public view virtual override returns (address) {
                require(_exists(tokenId), "ERC721: approved query for nonexistent token");
                return _tokenApprovals[tokenId];
            }
            /**
             * @dev See {IERC721-setApprovalForAll}.
             */
            function setApprovalForAll(address operator, bool approved) public virtual override {
                _setApprovalForAll(_msgSender(), operator, approved);
            }
            /**
             * @dev See {IERC721-isApprovedForAll}.
             */
            function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
                return _operatorApprovals[owner][operator];
            }
            /**
             * @dev See {IERC721-transferFrom}.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                //solhint-disable-next-line max-line-length
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                _transfer(from, to, tokenId);
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) public virtual override {
                safeTransferFrom(from, to, tokenId, "");
            }
            /**
             * @dev See {IERC721-safeTransferFrom}.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) public virtual override {
                require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
                _safeTransfer(from, to, tokenId, _data);
            }
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * `_data` is additional data, it has no specified format and it is sent in call to `to`.
             *
             * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
             * implement alternative mechanisms to perform token transfer, such as signature-based.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function _safeTransfer(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) internal virtual {
                _transfer(from, to, tokenId);
                require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
            }
            /**
             * @dev Returns whether `tokenId` exists.
             *
             * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
             *
             * Tokens start existing when they are minted (`_mint`),
             * and stop existing when they are burned (`_burn`).
             */
            function _exists(uint256 tokenId) internal view virtual returns (bool) {
                return _owners[tokenId] != address(0);
            }
            /**
             * @dev Returns whether `spender` is allowed to manage `tokenId`.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
                require(_exists(tokenId), "ERC721: operator query for nonexistent token");
                address owner = ERC721Upgradeable.ownerOf(tokenId);
                return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
            }
            /**
             * @dev Safely mints `tokenId` and transfers it to `to`.
             *
             * Requirements:
             *
             * - `tokenId` must not exist.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function _safeMint(address to, uint256 tokenId) internal virtual {
                _safeMint(to, tokenId, "");
            }
            /**
             * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
             * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
             */
            function _safeMint(
                address to,
                uint256 tokenId,
                bytes memory _data
            ) internal virtual {
                _mint(to, tokenId);
                require(
                    _checkOnERC721Received(address(0), to, tokenId, _data),
                    "ERC721: transfer to non ERC721Receiver implementer"
                );
            }
            /**
             * @dev Mints `tokenId` and transfers it to `to`.
             *
             * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
             *
             * Requirements:
             *
             * - `tokenId` must not exist.
             * - `to` cannot be the zero address.
             *
             * Emits a {Transfer} event.
             */
            function _mint(address to, uint256 tokenId) internal virtual {
                require(to != address(0), "ERC721: mint to the zero address");
                require(!_exists(tokenId), "ERC721: token already minted");
                _beforeTokenTransfer(address(0), to, tokenId);
                _balances[to] += 1;
                _owners[tokenId] = to;
                emit Transfer(address(0), to, tokenId);
            }
            /**
             * @dev Destroys `tokenId`.
             * The approval is cleared when the token is burned.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             *
             * Emits a {Transfer} event.
             */
            function _burn(uint256 tokenId) internal virtual {
                address owner = ERC721Upgradeable.ownerOf(tokenId);
                _beforeTokenTransfer(owner, address(0), tokenId);
                // Clear approvals
                _approve(address(0), tokenId);
                _balances[owner] -= 1;
                delete _owners[tokenId];
                emit Transfer(owner, address(0), tokenId);
            }
            /**
             * @dev Transfers `tokenId` from `from` to `to`.
             *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
             *
             * Requirements:
             *
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             *
             * Emits a {Transfer} event.
             */
            function _transfer(
                address from,
                address to,
                uint256 tokenId
            ) internal virtual {
                require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer of token that is not own");
                require(to != address(0), "ERC721: transfer to the zero address");
                _beforeTokenTransfer(from, to, tokenId);
                // Clear approvals from the previous owner
                _approve(address(0), tokenId);
                _balances[from] -= 1;
                _balances[to] += 1;
                _owners[tokenId] = to;
                emit Transfer(from, to, tokenId);
            }
            /**
             * @dev Approve `to` to operate on `tokenId`
             *
             * Emits a {Approval} event.
             */
            function _approve(address to, uint256 tokenId) internal virtual {
                _tokenApprovals[tokenId] = to;
                emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
            }
            /**
             * @dev Approve `operator` to operate on all of `owner` tokens
             *
             * Emits a {ApprovalForAll} event.
             */
            function _setApprovalForAll(
                address owner,
                address operator,
                bool approved
            ) internal virtual {
                require(owner != operator, "ERC721: approve to caller");
                _operatorApprovals[owner][operator] = approved;
                emit ApprovalForAll(owner, operator, approved);
            }
            /**
             * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
             * The call is not executed if the target address is not a contract.
             *
             * @param from address representing the previous owner of the given token ID
             * @param to target address that will receive the tokens
             * @param tokenId uint256 ID of the token to be transferred
             * @param _data bytes optional data to send along with the call
             * @return bool whether the call correctly returned the expected magic value
             */
            function _checkOnERC721Received(
                address from,
                address to,
                uint256 tokenId,
                bytes memory _data
            ) private returns (bool) {
                if (to.isContract()) {
                    try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                        return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
                    } catch (bytes memory reason) {
                        if (reason.length == 0) {
                            revert("ERC721: transfer to non ERC721Receiver implementer");
                        } else {
                            assembly {
                                revert(add(32, reason), mload(reason))
                            }
                        }
                    }
                } else {
                    return true;
                }
            }
            /**
             * @dev Hook that is called before any token transfer. This includes minting
             * and burning.
             *
             * Calling conditions:
             *
             * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
             * transferred to `to`.
             * - When `from` is zero, `tokenId` will be minted for `to`.
             * - When `to` is zero, ``from``'s `tokenId` will be burned.
             * - `from` and `to` are never both zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 tokenId
            ) internal virtual {}
            uint256[44] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
        pragma solidity ^0.8.0;
        import "../IERC20Upgradeable.sol";
        /**
         * @dev Interface for the optional metadata functions from the ERC20 standard.
         *
         * _Available since v4.1._
         */
        interface IERC20MetadataUpgradeable is IERC20Upgradeable {
            /**
             * @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 v4.4.1 (token/ERC20/IERC20.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC20 standard as defined in the EIP.
         */
        interface IERC20Upgradeable {
            /**
             * @dev Returns the amount of tokens in existence.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns the amount of tokens owned by `account`.
             */
            function balanceOf(address account) external view returns (uint256);
            /**
             * @dev Moves `amount` tokens from the caller's account to `recipient`.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transfer(address recipient, uint256 amount) external returns (bool);
            /**
             * @dev Returns the remaining number of tokens that `spender` will be
             * allowed to spend on behalf of `owner` through {transferFrom}. This is
             * zero by default.
             *
             * This value changes when {approve} or {transferFrom} are called.
             */
            function allowance(address owner, address spender) external view returns (uint256);
            /**
             * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * IMPORTANT: Beware that changing an allowance with this method brings the risk
             * that someone may use both the old and the new allowance by unfortunate
             * transaction ordering. One possible solution to mitigate this race
             * condition is to first reduce the spender's allowance to 0 and set the
             * desired value afterwards:
             * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
             *
             * Emits an {Approval} event.
             */
            function approve(address spender, uint256 amount) external returns (bool);
            /**
             * @dev Moves `amount` tokens from `sender` to `recipient` using the
             * allowance mechanism. `amount` is then deducted from the caller's
             * allowance.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) external returns (bool);
            /**
             * @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);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (token/ERC20/ERC20.sol)
        pragma solidity ^0.8.0;
        import "./IERC20Upgradeable.sol";
        import "./extensions/IERC20MetadataUpgradeable.sol";
        import "../../utils/ContextUpgradeable.sol";
        import "../../proxy/utils/Initializable.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}.
         * For a generic mechanism see {ERC20PresetMinterPauser}.
         *
         * TIP: For a detailed writeup see our guide
         * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
         * to implement supply mechanisms].
         *
         * 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.
         *
         * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
         * functions have been added to mitigate the well-known issues around setting
         * allowances. See {IERC20-approve}.
         */
        contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20Upgradeable, IERC20MetadataUpgradeable {
            mapping(address => uint256) private _balances;
            mapping(address => mapping(address => uint256)) private _allowances;
            uint256 private _totalSupply;
            string private _name;
            string private _symbol;
            /**
             * @dev Sets the values for {name} and {symbol}.
             *
             * The default value of {decimals} is 18. To select a different value for
             * {decimals} you should overload it.
             *
             * All two of these values are immutable: they can only be set once during
             * construction.
             */
            function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing {
                __Context_init_unchained();
                __ERC20_init_unchained(name_, symbol_);
            }
            function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
                _name = name_;
                _symbol = symbol_;
            }
            /**
             * @dev Returns the name of the token.
             */
            function name() public view virtual override returns (string memory) {
                return _name;
            }
            /**
             * @dev Returns the symbol of the token, usually a shorter version of the
             * name.
             */
            function symbol() public view virtual override 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 value {ERC20} uses, unless this function is
             * 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 override returns (uint8) {
                return 18;
            }
            /**
             * @dev See {IERC20-totalSupply}.
             */
            function totalSupply() public view virtual override returns (uint256) {
                return _totalSupply;
            }
            /**
             * @dev See {IERC20-balanceOf}.
             */
            function balanceOf(address account) public view virtual override returns (uint256) {
                return _balances[account];
            }
            /**
             * @dev See {IERC20-transfer}.
             *
             * Requirements:
             *
             * - `recipient` cannot be the zero address.
             * - the caller must have a balance of at least `amount`.
             */
            function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
                _transfer(_msgSender(), recipient, amount);
                return true;
            }
            /**
             * @dev See {IERC20-allowance}.
             */
            function allowance(address owner, address spender) public view virtual override returns (uint256) {
                return _allowances[owner][spender];
            }
            /**
             * @dev See {IERC20-approve}.
             *
             * Requirements:
             *
             * - `spender` cannot be the zero address.
             */
            function approve(address spender, uint256 amount) public virtual override returns (bool) {
                _approve(_msgSender(), spender, amount);
                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}.
             *
             * Requirements:
             *
             * - `sender` and `recipient` cannot be the zero address.
             * - `sender` must have a balance of at least `amount`.
             * - the caller must have allowance for ``sender``'s tokens of at least
             * `amount`.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) public virtual override returns (bool) {
                _transfer(sender, recipient, amount);
                uint256 currentAllowance = _allowances[sender][_msgSender()];
                require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
                unchecked {
                    _approve(sender, _msgSender(), currentAllowance - amount);
                }
                return true;
            }
            /**
             * @dev Atomically increases the allowance granted to `spender` by the caller.
             *
             * This is an alternative to {approve} that can be used as a mitigation for
             * problems described in {IERC20-approve}.
             *
             * Emits an {Approval} event indicating the updated allowance.
             *
             * Requirements:
             *
             * - `spender` cannot be the zero address.
             */
            function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
                _approve(_msgSender(), spender, _allowances[_msgSender()][spender] + addedValue);
                return true;
            }
            /**
             * @dev Atomically decreases the allowance granted to `spender` by the caller.
             *
             * This is an alternative to {approve} that can be used as a mitigation for
             * problems described in {IERC20-approve}.
             *
             * Emits an {Approval} event indicating the updated allowance.
             *
             * Requirements:
             *
             * - `spender` cannot be the zero address.
             * - `spender` must have allowance for the caller of at least
             * `subtractedValue`.
             */
            function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
                uint256 currentAllowance = _allowances[_msgSender()][spender];
                require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
                unchecked {
                    _approve(_msgSender(), spender, currentAllowance - subtractedValue);
                }
                return true;
            }
            /**
             * @dev Moves `amount` of tokens from `sender` to `recipient`.
             *
             * 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.
             *
             * Requirements:
             *
             * - `sender` cannot be the zero address.
             * - `recipient` cannot be the zero address.
             * - `sender` must have a balance of at least `amount`.
             */
            function _transfer(
                address sender,
                address recipient,
                uint256 amount
            ) internal virtual {
                require(sender != address(0), "ERC20: transfer from the zero address");
                require(recipient != address(0), "ERC20: transfer to the zero address");
                _beforeTokenTransfer(sender, recipient, amount);
                uint256 senderBalance = _balances[sender];
                require(senderBalance >= amount, "ERC20: transfer amount exceeds balance");
                unchecked {
                    _balances[sender] = senderBalance - amount;
                }
                _balances[recipient] += amount;
                emit Transfer(sender, recipient, amount);
                _afterTokenTransfer(sender, recipient, amount);
            }
            /** @dev Creates `amount` tokens and assigns them to `account`, increasing
             * the total supply.
             *
             * Emits a {Transfer} event with `from` set to the zero address.
             *
             * Requirements:
             *
             * - `account` cannot be the zero address.
             */
            function _mint(address account, uint256 amount) internal virtual {
                require(account != address(0), "ERC20: mint to the zero address");
                _beforeTokenTransfer(address(0), account, amount);
                _totalSupply += amount;
                _balances[account] += amount;
                emit Transfer(address(0), account, amount);
                _afterTokenTransfer(address(0), account, amount);
            }
            /**
             * @dev Destroys `amount` tokens from `account`, reducing the
             * total supply.
             *
             * Emits a {Transfer} event with `to` set to the zero address.
             *
             * Requirements:
             *
             * - `account` cannot be the zero address.
             * - `account` must have at least `amount` tokens.
             */
            function _burn(address account, uint256 amount) internal virtual {
                require(account != address(0), "ERC20: burn from the zero address");
                _beforeTokenTransfer(account, address(0), amount);
                uint256 accountBalance = _balances[account];
                require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
                unchecked {
                    _balances[account] = accountBalance - amount;
                }
                _totalSupply -= amount;
                emit Transfer(account, address(0), amount);
                _afterTokenTransfer(account, address(0), amount);
            }
            /**
             * @dev Sets `amount` 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.
             */
            function _approve(
                address owner,
                address spender,
                uint256 amount
            ) internal virtual {
                require(owner != address(0), "ERC20: approve from the zero address");
                require(spender != address(0), "ERC20: approve to the zero address");
                _allowances[owner][spender] = amount;
                emit Approval(owner, spender, amount);
            }
            /**
             * @dev Hook that is called before any transfer of tokens. This includes
             * minting and burning.
             *
             * Calling conditions:
             *
             * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
             * will be transferred to `to`.
             * - when `from` is zero, `amount` tokens will be minted for `to`.
             * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
             * - `from` and `to` are never both zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _beforeTokenTransfer(
                address from,
                address to,
                uint256 amount
            ) internal virtual {}
            /**
             * @dev Hook that is called after any transfer of tokens. This includes
             * minting and burning.
             *
             * Calling conditions:
             *
             * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
             * has been transferred to `to`.
             * - when `from` is zero, `amount` tokens have been minted for `to`.
             * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
             * - `from` and `to` are never both zero.
             *
             * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
             */
            function _afterTokenTransfer(
                address from,
                address to,
                uint256 amount
            ) internal virtual {}
            uint256[45] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/utils/Initializable.sol)
        pragma solidity ^0.8.0;
        import "../../utils/AddressUpgradeable.sol";
        /**
         * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
         * behind a proxy. Since a proxied contract can't have 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.
         *
         * 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 initialize the implementation contract, you can either invoke the
         * initializer manually, or you can include a constructor to automatically mark it as initialized when it is deployed:
         *
         * [.hljs-theme-light.nopadding]
         * ```
         * /// @custom:oz-upgrades-unsafe-allow constructor
         * constructor() initializer {}
         * ```
         * ====
         */
        abstract contract Initializable {
            /**
             * @dev Indicates that the contract has been initialized.
             */
            bool private _initialized;
            /**
             * @dev Indicates that the contract is in the process of being initialized.
             */
            bool private _initializing;
            /**
             * @dev Modifier to protect an initializer function from being invoked twice.
             */
            modifier initializer() {
                // If the contract is initializing we ignore whether _initialized is set in order to support multiple
                // inheritance patterns, but we only do this in the context of a constructor, because in other contexts the
                // contract may have been reentered.
                require(_initializing ? _isConstructor() : !_initialized, "Initializable: contract is already initialized");
                bool isTopLevelCall = !_initializing;
                if (isTopLevelCall) {
                    _initializing = true;
                    _initialized = true;
                }
                _;
                if (isTopLevelCall) {
                    _initializing = false;
                }
            }
            /**
             * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
             * {initializer} modifier, directly or indirectly.
             */
            modifier onlyInitializing() {
                require(_initializing, "Initializable: contract is not initializing");
                _;
            }
            function _isConstructor() private view returns (bool) {
                return !AddressUpgradeable.isContract(address(this));
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)
        pragma solidity ^0.8.0;
        import "../utils/ContextUpgradeable.sol";
        import "../proxy/utils/Initializable.sol";
        /**
         * @dev Contract module which provides a basic access control mechanism, where
         * there is an account (an owner) that can be granted exclusive access to
         * specific functions.
         *
         * By default, the owner account will be the one that deploys the contract. This
         * can later be changed with {transferOwnership}.
         *
         * This module is used through inheritance. It will make available the modifier
         * `onlyOwner`, which can be applied to your functions to restrict their use to
         * the owner.
         */
        abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {
            address private _owner;
            event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
            /**
             * @dev Initializes the contract setting the deployer as the initial owner.
             */
            function __Ownable_init() internal onlyInitializing {
                __Context_init_unchained();
                __Ownable_init_unchained();
            }
            function __Ownable_init_unchained() internal onlyInitializing {
                _transferOwnership(_msgSender());
            }
            /**
             * @dev Returns the address of the current owner.
             */
            function owner() public view virtual returns (address) {
                return _owner;
            }
            /**
             * @dev Throws if called by any account other than the owner.
             */
            modifier onlyOwner() {
                require(owner() == _msgSender(), "Ownable: caller is not the owner");
                _;
            }
            /**
             * @dev Leaves the contract without owner. It will not be possible to call
             * `onlyOwner` functions anymore. Can only be called by the current owner.
             *
             * NOTE: Renouncing ownership will leave the contract without an owner,
             * thereby removing any functionality that is only available to the owner.
             */
            function renounceOwnership() public virtual onlyOwner {
                _transferOwnership(address(0));
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Can only be called by the current owner.
             */
            function transferOwnership(address newOwner) public virtual onlyOwner {
                require(newOwner != address(0), "Ownable: new owner is the zero address");
                _transferOwnership(newOwner);
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Internal function without access restriction.
             */
            function _transferOwnership(address newOwner) internal virtual {
                address oldOwner = _owner;
                _owner = newOwner;
                emit OwnershipTransferred(oldOwner, newOwner);
            }
            uint256[49] private __gap;
        }