Contract

Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT
pragma solidity 0.8.13;

import '@openzeppelin/contracts/token/ERC721/IERC721.sol';
import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol';
import '@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol';
import '@openzeppelin/contracts/token/ERC721/extensions/IERC721Enumerable.sol';
import '@openzeppelin/contracts/utils/Address.sol';
import '@openzeppelin/contracts/utils/Strings.sol';
import '@openzeppelin/contracts/utils/introspection/ERC165.sol';

// HOOPS NFT
//             ________
//     o      |   __   |
//       \_ O |  |__|  |
//    ____/ \ |___WW___|
//    __/   /     ||
//                ||
//                ||
// _______________||________________
// Created by MasoRich and Bubba Dutch Studios
// Contract by mö̵͊ö̵͊n & The Nexus Crew
// Based on ERC721A contract by Chiru Labs

contract Hoops is ERC165, IERC721, IERC721Metadata, IERC721Enumerable {
    using Address for address;
    using Strings for uint256;

    string private _unrevealedBaseURI = 'ipfs://QmekCwrU6SsTNcFEgCs36kcry6KE7zeBsSuC1nXi5KZL6o/'; 
                                                                            //                  ................ 
                                                                            //             .....                 ....
    string private _baseURI = '';                                           //          ...    ..%%%%%%%%%%%%%%%.    ....
                                                                            //       .%.  ..%%%%%.....    .....%%%%%..   ..
    address _treasuryAddress = 0x87Bc1aC91E5BeC68BCe0427A0E627828F7c52a67;  //     ..  .%%%...                     ..%%%.  ..
                                                                            //    .. .%%..                             .%%.  ..
    string private _uriSuffix = '.json';                                    //   % .%%.        WE <3 BASKETBALL          .%%  ..
                                                                            //  .  %%%                                    .%%  %
    uint private _mintPrice = 0.0824 ether;                                 //  % %%%                      HOOPS 4 LYFE    %%%  %
                                                                            // %  %%                                        %%  %
    uint private _maxMintQuantity = 25;                                     // %  %%             ssssssssssssss             %%  %
                                                                            // %  %%           %%              %%           %%  %
    uint private _maxSupply = 10000;                                        // %  %%           %%              %%           %%  %
                                                                            // %  %%           %%              %%           %%  %
    bool _mintIsOpen = false;                                               // %  %%           %%              %%           %%  %
                                                                            // %  %%           %%              %%           %%  %
    uint private _revealIndex = 0;                                          // %  %%           %%              %%           %%  %
                                                                            // %  %%          .%%%%%%%%%%%%%%%%%%.          %%  %
    bool _stickersEnabled = false;                                          // %  %%%         .%..%...%..%...%..%.         %%%  %
                                                                            // %   %%          .. %   %  %   %  %          %%   %
    uint256 internal currentIndex = 1;                                      //  %  %%.         %. %%  %  %   %  .         .%%   %
                                                                            //  %.  .%%         %%%%%%%%%%%%%%%%%        %%.   %
    // Mapping from token ID to ownership 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;//                     % % %% % %.
                                                                            //                     %.%%.%.%.%
    // This the is owner of the contract
    address private _owner;

    // Stickers will be a customization option we enable after launch
    // Users should use the portal app we provide, although anyone can make customizations if they really want
    // Please use this feature responsibly so we don't have to turn it off for everyone or make it owner-only
    mapping(uint256 => string) internal _stickerURIs;

    // Should only the owner of the contract be able to customize the stickers?
    bool _anyoneCanCustomize = true;

    function setAnyoneCanCustomize(bool anyoneCanCustomize) public onlyOwner {
        _anyoneCanCustomize = anyoneCanCustomize;
    }

    function setStickersEnabled(bool stickersEnabled) public onlyOwner {
        _stickersEnabled = stickersEnabled;
    }

    function setStickerUri(uint256 tokenId, string memory uri) public {
        require((_anyoneCanCustomize && _stickersEnabled) || msg.sender == _owner, "Stickers are not customizable right now");
        require(ownerOf(tokenId) == msg.sender || msg.sender == _owner, "Only the token owner can set the sticker URI");
        _stickerURIs[tokenId] = uri; 
    }

    function hasStickers(uint256 tokenId) public view returns (bool) {
        require(_stickersEnabled || msg.sender == _owner, "Stickers are not enabled");
        return bytes(_stickerURIs[tokenId]).length != 0;
    }

    function getStickerUri(uint256 tokenId) public view returns (string memory) {
        require(_stickersEnabled || msg.sender == _owner, "Stickers are not enabled");
        // TASK: return true if the sticker URI is set in _stickerURIs mapping and false if it is an empty string
        if(bytes(_stickerURIs[tokenId]).length > 0){
            return _stickerURIs[tokenId];
        }
        return "";
    }

    function resetStickers(uint256 tokenId) public {
        require(_stickersEnabled || msg.sender == _owner, "Stickers are not enabled");
        require(ownerOf(tokenId) == msg.sender || msg.sender == _owner, "Only the owner can reset sticker uri");
        _stickerURIs[tokenId] = "";
    }

    struct TokenOwnership {
        address addr;
        uint64 startTimestamp;
    }

    struct AddressData {
        uint128 balance;
        uint128 numberMinted;
    }

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

    constructor() {
        _owner = msg.sender;
    }

    function getMintPrice() public view returns (uint) {
        return _mintPrice;
    }

    // Set the _mintPrice to a new value in ether if the msg.sender is the _owner
    function setMintPrice(uint newPrice) public onlyOwner {
        _mintPrice = newPrice;
    }

    function transferOwnership(address owner) public virtual onlyOwner {
        _owner = owner;
    }

    function withdraw() public onlyTreasurerOrOwner {
        // This will transfer the remaining contract balance to the owner.
        (bool os, ) = payable(_treasuryAddress).call{value: address(this).balance}('');
        require(os);
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        require(_owner == msg.sender, 'Caller is not the owner');
        _;
    }

    /**
     * @dev Throws if called by any account other than the owner or treasurer.
     */
    modifier onlyTreasurerOrOwner() {
        require(_owner == msg.sender || _owner == _treasuryAddress, 'Caller is not the owner or treasurer');
        _;
    }

    modifier onlyValidAccess() {
        require(_owner == msg.sender || _mintIsOpen, 'You are not the owner and the mint is not open');
        _;
    }

    function isMintOpen() public view returns (bool) {
        return _mintIsOpen;
    }

    function setOpenMint(bool mintIsOpen) public onlyOwner {
        _mintIsOpen = mintIsOpen;
    }

    /**
     * @dev See {IERC721Enumerable-totalSupply}.
     */
    function totalSupply() public view override returns (uint256) {
        return currentIndex - 1;
    }

    function maxSupply() public view returns (uint256) {
        return _maxSupply;
    }

    function availableSupply() public view returns (uint256) {
        return _maxSupply - (currentIndex - 1);
    }

    /**
     * @dev See {IERC721Enumerable-tokenByIndex}.
     */
    function tokenByIndex(uint256 index) public view override returns (uint256) {
        require(index < currentIndex && index > 0, 'Index must be between 1 and 10,000');
        return index;
    }

    /**
     * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
     * This read function is O(totalSupply). If calling from a separate contract, be sure to test gas first.
     * It may also degrade with extremely large collection sizes (e.g >> 10000), test for your use case.
     */
    function tokenOfOwnerByIndex(address tokenOwner, uint256 index) public view override returns (uint256) {
        require(index < balanceOf(tokenOwner), 'Owner index is out of bounds');
        uint256 tokenIdsIdx;
        address currOwnershipAddr;

        // Counter overflow is impossible as the loop breaks when uint256 i is equal to another uint256 numMintedSoFar.
        unchecked {
            for (uint256 i = 1; i < currentIndex; i++) {
                TokenOwnership memory ownership = _ownerships[i];
                if (ownership.addr != address(0)) {
                    currOwnershipAddr = ownership.addr;
                }
                if (currOwnershipAddr == tokenOwner) {
                    if (tokenIdsIdx == index) {
                        return i;
                    }
                    tokenIdsIdx++;
                }
            }
        }

        revert('No token found'); //  unable to get token of owner by index
    }

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
        return
            interfaceId == type(IERC721).interfaceId ||
            interfaceId == type(IERC721Metadata).interfaceId ||
            interfaceId == type(IERC721Enumerable).interfaceId ||
            super.supportsInterface(interfaceId);
    }

    /**
     * @dev See {IERC721-balanceOf}.
     */
    function balanceOf(address owner) public view override returns (uint256) {
        require(owner != address(0), '0x'); //  balance query for the zero address
        return uint256(_addressData[owner].balance);
    }

    /**
     * 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) {
        require(_exists(tokenId), 'No token found'); //  owner query for nonexistent token

        unchecked {
            for (uint256 curr = tokenId; curr >= 0; curr--) {
                TokenOwnership memory ownership = _ownerships[curr];
                if (ownership.addr != address(0)) {
                    return ownership;
                }
            }
        }

        revert('No owner'); //  unable to determine the owner of token
    }

    /**
     * @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 'Hoops';
    }

    /**
     * @dev See {IERC721Metadata-symbol}.
     */
    function symbol() public view virtual override returns (string memory) {
        return 'HOOPS';
    }

    /**
     * @dev See {IERC721Metadata-tokenURI}.
     */
    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        require(_exists(tokenId), 'No token found'); // ERC721Metadata: URI query for nonexistent token
        if(_stickersEnabled && hasStickers(tokenId)){
            return string(abi.encodePacked(_stickerURIs[tokenId], tokenId.toString(), _uriSuffix));
        }
        return string(abi.encodePacked(tokenId < _revealIndex ? _baseURI : _unrevealedBaseURI, tokenId.toString(), _uriSuffix));
    }

    /**
     * @dev This gets us the non-sticker URI, even if stickers are enabled
     */
    function baseTokenURI(uint256 tokenId) public view virtual returns (string memory) {
        require(_exists(tokenId), 'No token found'); // ERC721Metadata: URI query for nonexistent token
        return string(abi.encodePacked(tokenId < _revealIndex ? _baseURI : _unrevealedBaseURI, tokenId.toString(), _uriSuffix));
    }

    function setBaseURI(string memory baseURI) public onlyOwner {
        _baseURI = baseURI;
    }

    function setUnrevealBaseURI(string memory baseURI) public onlyOwner {
        _unrevealedBaseURI = baseURI;
    }

    function setRevealIndex(uint index) public onlyOwner {
        _revealIndex = index;
    }

    function setUriSuffix(string memory uriSuffix) public onlyOwner {
        _uriSuffix = uriSuffix;
    }

    /**
     * @dev See {IERC721-approve}.
     */
    function approve(address to, uint256 tokenId) public override {
        address owner = Hoops.ownerOf(tokenId);
        require(to != owner, 'Only the owner can call this function'); //  approval to current owner

        require(
            msg.sender == owner || isApprovedForAll(owner, msg.sender),
            'Not approved' //  approve caller is not owner nor approved for all
        );

        _approve(to, tokenId, owner);
    }

    /**
     * @dev See {IERC721-getApproved}.
     */
    function getApproved(uint256 tokenId) public view override returns (address) {
        require(_exists(tokenId), 'No token found'); //  approved query for nonexistent token

        return _tokenApprovals[tokenId];
    }

    /**
     * @dev See {IERC721-setApprovalForAll}.
     */
    function setApprovalForAll(address operator, bool approved) public override {
        require(operator != msg.sender, 'Not the caller'); //  approve to caller

        _operatorApprovals[msg.sender][operator] = approved;
        emit ApprovalForAll(msg.sender, 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 override {
        _transfer(from, to, tokenId);
        require(
            _checkOnERC721Received(from, to, tokenId, _data),
            'not721' //  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`),
     */
    function _exists(uint256 tokenId) internal view returns (bool) {
        return tokenId < currentIndex && tokenId > 0;
    }

    function goat() public pure returns (string memory) {
        return '"Greatness is defined by how much you want to put into what you do." - LeBron James';
    }

    function mintForAddress(
        uint256 quantity,
        address to
    ) public payable onlyValidAccess() {
        _mint(to, quantity);
    }

    function mint(
        uint256 quantity
    ) public payable {
        _mint(msg.sender, 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 onlyValidAccess() {
        uint256 startTokenId = currentIndex;
        require(_owner == msg.sender || _mintIsOpen, 'Minting is currently closed'); // Don't allow anyone to mint if the mint is closed
        require(to != address(0), 'Cannot send to 0x0'); // mint to the 0x0 address
        require(quantity != 0, 'Quantity cannot be 0'); // quantity must be greater than 0
        require(_owner == msg.sender || quantity <= _maxMintQuantity, 'Quantity exceeds mint max'); // quantity must be less than max quantity
        // The owner can mint for free, everyone else needs to pay the price
        require(_owner == msg.sender || msg.value >= _mintPrice * quantity, "Insufficient funds!");
        require(currentIndex <= _maxSupply, 'No Hoops left!'); // sold out
        require(currentIndex + quantity <= _maxSupply, 'Not enough Hoops left to buy!'); // cannot mint more than maxIndex tokens

        unchecked {
            _addressData[to].balance += uint128(quantity);
            _addressData[to].numberMinted += uint128(quantity);

            _ownerships[startTokenId].addr = to;
            _ownerships[startTokenId].startTimestamp = uint64(block.timestamp);

            uint256 updatedIndex = startTokenId;

            for (uint256 i; i < quantity; i++) {
                emit Transfer(address(0), to, updatedIndex);
                    require(
                        _checkOnERC721Received(address(0), to, updatedIndex, ''),
                        'Not ERC721Receiver' // transfer to non ERC721Receiver implementer
                    );

                updatedIndex++;
            }

            currentIndex = updatedIndex;
        }
    }

    /**
     * @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);

        bool isApprovedOrOwner = (msg.sender == prevOwnership.addr ||
            getApproved(tokenId) == msg.sender ||
            isApprovedForAll(prevOwnership.addr, msg.sender));

        require(isApprovedOrOwner, 'Notapproved'); //  transfer caller is not owner nor approved
        require(prevOwnership.addr == from, 'Invalid Owner'); // transfer from incorrect owner
        require(to != address(0), '0x'); //  transfer to the zero address

        // Clear approvals from the previous owner
        _approve(address(0), tokenId, prevOwnership.addr);

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

            _ownerships[tokenId].addr = to;
            _ownerships[tokenId].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;
            if (_ownerships[nextTokenId].addr == address(0)) {
                if (_exists(nextTokenId)) {
                    _ownerships[nextTokenId].addr = prevOwnership.addr;
                    _ownerships[nextTokenId].startTimestamp = prevOwnership.startTimestamp;
                }
            }
        }

        emit Transfer(from, to, tokenId);
    }

    /**
     * @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 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 IERC721Receiver(to).onERC721Received(msg.sender, from, tokenId, _data) returns (bytes4 retval) {
                return retval == IERC721Receiver(to).onERC721Received.selector;
            } catch (bytes memory reason) {
                if (reason.length == 0) {
                    revert('not721'); //  transfer to non ERC721Receiver implementer
                } else {
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        } else {
            return true;
        }
    }
}
                                                                                          
//                                           ▓▓▓▓▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓                                      
//                                   ░░████████████▒▒▒▒▒▒▒▒▒▒▒▒▓▓██▓▓▓▓▓▓██                                
//                                 ████▓▓▒▒▒▒▓▓████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓████                            
//                             ▒▒▒▒▓▓▓▓▓▓▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓██▒▒▓▓                        
//                         ▓▓▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██▓▓▓▓                    
//                       ▓▓██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓██▓▓                  
//                     ██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒Welcome to the Hoops team▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓                
//                 ░░██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██████████████▓▓████              
//                 ▓▓██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▓▓████▓▓            
//               ▓▓▓▓▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓          
//           ░░████▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓        
//           ░░▓▓▓▓▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓        
//           ▓▓██▓▓▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓      
//           ▓▓██▒▒▒▒▓▓▓▓██▓▓▓▓▓▓▓▓▓▓▒▒▓▓██▒▒▒▒▒▒▒▒▒▒▓▓▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██      
//         ████████▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▓▓██████▓▓██████▓▓▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒████    
//         ▓▓▒▒▒▒▒▒▒▒▒▒▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒████████▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓    
//       ████▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒████████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓  
//       ██▓▓▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒Please join us on discord at https://discord.gg/hoops▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓  
//       ██▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██  
//   ░░██▓▓▒▒▒▒▒▒▒▒████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓  
//   ░░████▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒████▓▓▒▒▒▒▒▒▒▒▒▒▒▒██▓▓
//   ░░▓▓▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▓▓▓▓
//   ░░▓▓▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▓▓
//   ░░████▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▓▓
//   ░░▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓████▓▓▓▓
//   ░░██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓
//   ▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓
//   ░░██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓
//   ░░▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓
//   ░░██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒
//       ██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓  
//       ▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓  
//       ██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓  
//         ▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██    
//         ▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██    
//           ▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒████    
//           ▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██░░    
//           ░░██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓░░      
//           ░░▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒██▓▓        
//               ██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▓▓▓▓          
//                 ██▓▓▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▓▓▓▓██            
//                   ▓▓██▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒████              
//                     ██▓▓▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▓▓▓▓░░              
//                       ██▓▓▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▓▓▓▓▓▓                  
//                       ▒▒██▓▓▓▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓██░░                  
//                         ░░▒▒▓▓██▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓██░░░░                    
//                               ██████▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓████▓▓                          
//                                   ▓▓▓▓██▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓██▓▓▓▓██                              
//                                         ▓▓██▓▓██████████████████▓▓▓▓

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

pragma solidity ^0.8.0;

import "./IERC165.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 ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

// 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 (last updated v4.5.0) (utils/Address.sol)

pragma solidity ^0.8.1;

/**
 * @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
     * ====
     *
     * [IMPORTANT]
     * ====
     * You shouldn't rely on `isContract` to protect against flash loan attacks!
     *
     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
     * constructor.
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize/address.code.length, which returns 0
        // for contracts in construction, since the code is only stored at the end
        // of the constructor execution.

        return account.code.length > 0;
    }

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

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

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

        (bool success, bytes memory returndata) = target.delegatecall(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 (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol)

pragma solidity ^0.8.0;

import "../IERC721.sol";

/**
 * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
 * @dev See https://eips.ethereum.org/EIPS/eip-721
 */
interface IERC721Enumerable is IERC721 {
    /**
     * @dev Returns the total amount of tokens stored by the contract.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns a token ID owned by `owner` at a given `index` of its token list.
     * Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
     */
    function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);

    /**
     * @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
     * Use along with {totalSupply} to enumerate all tokens.
     */
    function tokenByIndex(uint256 index) external view returns (uint256);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC721.sol";

/**
 * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
 * @dev See https://eips.ethereum.org/EIPS/eip-721
 */
interface IERC721Metadata is IERC721 {
    /**
     * @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/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 IERC721Receiver {
    /**
     * @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/IERC721.sol)

pragma solidity ^0.8.0;

import "../../utils/introspection/IERC165.sol";

/**
 * @dev Required interface of an ERC721 compliant contract.
 */
interface IERC721 is IERC165 {
    /**
     * @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 (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 IERC165 {
    /**
     * @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);
}

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

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"availableSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"baseTokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getMintPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getStickerUri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"goat","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"hasStickers","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isMintOpen","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"address","name":"to","type":"address"}],"name":"mintForAddress","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"resetStickers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"anyoneCanCustomize","type":"bool"}],"name":"setAnyoneCanCustomize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"setMintPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"mintIsOpen","type":"bool"}],"name":"setOpenMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"index","type":"uint256"}],"name":"setRevealIndex","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"string","name":"uri","type":"string"}],"name":"setStickerUri","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"stickersEnabled","type":"bool"}],"name":"setStickersEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI","type":"string"}],"name":"setUnrevealBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"uriSuffix","type":"string"}],"name":"setUriSuffix","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"index","type":"uint256"}],"name":"tokenByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"tokenOwner","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"tokenOfOwnerByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

0x6080604052600436106102255760003560e01c80637dfb3cdc11610123578063d5abeb01116100ab578063e5ed8a7f1161006f578063e5ed8a7f14610655578063e985e9c514610675578063efbd73f414610695578063f2fde38b146106a8578063f4a0a528146106c857600080fd5b8063d5abeb01146105c0578063d77d8383146105d5578063d9f2a3aa146105f5578063e2af30f414610615578063e2cd9ff81461063557600080fd5b8063a22cb465116100f2578063a22cb4651461052b578063a689a9141461054b578063a7f93ebd1461056b578063b88d4fde14610580578063c87b56dd146105a057600080fd5b80637dfb3cdc146104b55780637ecc2b56146104d557806395d89b41146104ea578063a0712d681461051857600080fd5b806331d382a2116101b15780634f6ccce7116101755780634f6ccce71461041557806355f804b3146104355780635ab3188f146104555780636352211e1461047557806370a082311461049557600080fd5b806331d382a21461038b5780633bab935f146103a05780633ccfd60b146103c057806340b70797146103d557806342842e0e146103f557600080fd5b806316ba10e0116101f857806316ba10e0146102f057806318160ddd14610310578063199080161461033357806323b872dd1461034b5780632f745c591461036b57600080fd5b806301ffc9a71461022a57806306fdde031461025f578063081812fc14610296578063095ea7b3146102ce575b600080fd5b34801561023657600080fd5b5061024a610245366004611db4565b6106e8565b60405190151581526020015b60405180910390f35b34801561026b57600080fd5b50604080518082019091526005815264486f6f707360d81b60208201525b6040516102569190611e30565b3480156102a257600080fd5b506102b66102b1366004611e43565b610755565b6040516001600160a01b039091168152602001610256565b3480156102da57600080fd5b506102ee6102e9366004611e78565b6107a1565b005b3480156102fc57600080fd5b506102ee61030b366004611f4e565b610884565b34801561031c57600080fd5b506103256108c5565b604051908152602001610256565b34801561033f57600080fd5b5060075460ff1661024a565b34801561035757600080fd5b506102ee610366366004611f83565b6108db565b34801561037757600080fd5b50610325610386366004611e78565b6108e6565b34801561039757600080fd5b506102896109ee565b3480156103ac57600080fd5b506102ee6103bb366004611e43565b610a0e565b3480156103cc57600080fd5b506102ee610aee565b3480156103e157600080fd5b506102ee6103f0366004611fbf565b610bd2565b34801561040157600080fd5b506102ee610410366004611f83565b610d00565b34801561042157600080fd5b50610325610430366004611e43565b610d1b565b34801561044157600080fd5b506102ee610450366004611f4e565b610d89565b34801561046157600080fd5b506102ee610470366004611f4e565b610dc6565b34801561048157600080fd5b506102b6610490366004611e43565b610e03565b3480156104a157600080fd5b506103256104b0366004612006565b610e15565b3480156104c157600080fd5b506102896104d0366004611e43565b610e77565b3480156104e157600080fd5b50610325610f84565b3480156104f657600080fd5b50604080518082019091526005815264484f4f505360d81b6020820152610289565b6102ee610526366004611e43565b610fa2565b34801561053757600080fd5b506102ee610546366004612031565b610fac565b34801561055757600080fd5b50610289610566366004611e43565b611061565b34801561057757600080fd5b50600454610325565b34801561058c57600080fd5b506102ee61059b366004612064565b6110ce565b3480156105ac57600080fd5b506102896105bb366004611e43565b611120565b3480156105cc57600080fd5b50600654610325565b3480156105e157600080fd5b506102ee6105f03660046120e0565b611179565b34801561060157600080fd5b5061024a610610366004611e43565b6111b6565b34801561062157600080fd5b506102ee6106303660046120e0565b611212565b34801561064157600080fd5b506102ee6106503660046120e0565b61124f565b34801561066157600080fd5b506102ee610670366004611e43565b61128c565b34801561068157600080fd5b5061024a6106903660046120fb565b6112bb565b6102ee6106a3366004612125565b6112e9565b3480156106b457600080fd5b506102ee6106c3366004612006565b61132a565b3480156106d457600080fd5b506102ee6106e3366004611e43565b611376565b60006001600160e01b031982166380ac58cd60e01b148061071957506001600160e01b03198216635b5e139f60e01b145b8061073457506001600160e01b0319821663780e9d6360e01b145b8061074f57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6000610760826113a5565b6107855760405162461bcd60e51b815260040161077c90612148565b60405180910390fd5b506000908152600d60205260409020546001600160a01b031690565b60006107ac82610e03565b9050806001600160a01b0316836001600160a01b03160361081d5760405162461bcd60e51b815260206004820152602560248201527f4f6e6c7920746865206f776e65722063616e2063616c6c20746869732066756e60448201526431ba34b7b760d91b606482015260840161077c565b336001600160a01b0382161480610839575061083981336112bb565b6108745760405162461bcd60e51b815260206004820152600c60248201526b139bdd08185c1c1c9bdd995960a21b604482015260640161077c565b61087f8383836113b9565b505050565b600f546001600160a01b031633146108ae5760405162461bcd60e51b815260040161077c90612170565b80516108c1906003906020840190611d0e565b5050565b60006001600a546108d691906121bd565b905090565b61087f838383611415565b60006108f183610e15565b821061093f5760405162461bcd60e51b815260206004820152601c60248201527f4f776e657220696e646578206973206f7574206f6620626f756e647300000000604482015260640161077c565b60008060015b600a548110156109d5576000818152600b60209081526040918290208251808401909352546001600160a01b038116808452600160a01b90910467ffffffffffffffff16918301919091521561099a57805192505b866001600160a01b0316836001600160a01b0316036109cc578584036109c55750925061074f915050565b6001909301925b50600101610945565b5060405162461bcd60e51b815260040161077c90612148565b606060405180608001604052806053815260200161245d60539139905090565b60095460ff1680610a295750600f546001600160a01b031633145b610a455760405162461bcd60e51b815260040161077c906121d4565b33610a4f82610e03565b6001600160a01b03161480610a6e5750600f546001600160a01b031633145b610ac65760405162461bcd60e51b8152602060048201526024808201527f4f6e6c7920746865206f776e65722063616e20726573657420737469636b65726044820152632075726960e01b606482015260840161077c565b6040805160208082018084526000808452858152601090925292902090516108c19290611d0e565b600f546001600160a01b0316331480610b175750600254600f546001600160a01b039081169116145b610b6f5760405162461bcd60e51b8152602060048201526024808201527f43616c6c6572206973206e6f7420746865206f776e6572206f722074726561736044820152633ab932b960e11b606482015260840161077c565b6002546040516000916001600160a01b03169047908381818185875af1925050503d8060008114610bbc576040519150601f19603f3d011682016040523d82523d6000602084013e610bc1565b606091505b5050905080610bcf57600080fd5b50565b60115460ff168015610be6575060095460ff165b80610bfb5750600f546001600160a01b031633145b610c575760405162461bcd60e51b815260206004820152602760248201527f537469636b65727320617265206e6f7420637573746f6d697a61626c65207269604482015266676874206e6f7760c81b606482015260840161077c565b33610c6183610e03565b6001600160a01b03161480610c805750600f546001600160a01b031633145b610ce15760405162461bcd60e51b815260206004820152602c60248201527f4f6e6c792074686520746f6b656e206f776e65722063616e207365742074686560448201526b20737469636b65722055524960a01b606482015260840161077c565b6000828152601060209081526040909120825161087f92840190611d0e565b61087f838383604051806020016040528060008152506110ce565b6000600a5482108015610d2e5750600082115b610d855760405162461bcd60e51b815260206004820152602260248201527f496e646578206d757374206265206265747765656e203120616e642031302c30604482015261030360f41b606482015260840161077c565b5090565b600f546001600160a01b03163314610db35760405162461bcd60e51b815260040161077c90612170565b80516108c1906001906020840190611d0e565b600f546001600160a01b03163314610df05760405162461bcd60e51b815260040161077c90612170565b80516108c1906000906020840190611d0e565b6000610e0e82611683565b5192915050565b60006001600160a01b038216610e525760405162461bcd60e51b8152602060048201526002602482015261060f60f31b604482015260640161077c565b506001600160a01b03166000908152600c60205260409020546001600160801b031690565b60095460609060ff1680610e955750600f546001600160a01b031633145b610eb15760405162461bcd60e51b815260040161077c906121d4565b60008281526010602052604081208054610eca9061220b565b90501115610f705760008281526010602052604090208054610eeb9061220b565b80601f0160208091040260200160405190810160405280929190818152602001828054610f179061220b565b8015610f645780601f10610f3957610100808354040283529160200191610f64565b820191906000526020600020905b815481529060010190602001808311610f4757829003601f168201915b50505050509050919050565b505060408051602081019091526000815290565b60006001600a54610f9591906121bd565b6006546108d691906121bd565b610bcf3382611715565b336001600160a01b03831603610ff55760405162461bcd60e51b815260206004820152600e60248201526d2737ba103a34329031b0b63632b960911b604482015260640161077c565b336000818152600e602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b606061106c826113a5565b6110885760405162461bcd60e51b815260040161077c90612148565b600854821061109857600061109b565b60015b6110a483611aeb565b60036040516020016110b8939291906122dd565b6040516020818303038152906040529050919050565b6110d9848484611415565b6110e584848484611bf4565b61111a5760405162461bcd60e51b81526020600482015260066024820152656e6f7437323160d01b604482015260640161077c565b50505050565b606061112b826113a5565b6111475760405162461bcd60e51b815260040161077c90612148565b60095460ff16801561115d575061115d826111b6565b156110885760008281526010602052604090206110a483611aeb565b600f546001600160a01b031633146111a35760405162461bcd60e51b815260040161077c90612170565b6009805460ff1916911515919091179055565b60095460009060ff16806111d45750600f546001600160a01b031633145b6111f05760405162461bcd60e51b815260040161077c906121d4565b600082815260106020526040902080546112099061220b565b15159392505050565b600f546001600160a01b0316331461123c5760405162461bcd60e51b815260040161077c90612170565b6007805460ff1916911515919091179055565b600f546001600160a01b031633146112795760405162461bcd60e51b815260040161077c90612170565b6011805460ff1916911515919091179055565b600f546001600160a01b031633146112b65760405162461bcd60e51b815260040161077c90612170565b600855565b6001600160a01b039182166000908152600e6020908152604080832093909416825291909152205460ff1690565b600f546001600160a01b0316331480611304575060075460ff165b6113205760405162461bcd60e51b815260040161077c90612310565b6108c18183611715565b600f546001600160a01b031633146113545760405162461bcd60e51b815260040161077c90612170565b600f80546001600160a01b0319166001600160a01b0392909216919091179055565b600f546001600160a01b031633146113a05760405162461bcd60e51b815260040161077c90612170565b600455565b6000600a548210801561074f575050151590565b6000828152600d602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b600061142082611683565b9050600081600001516001600160a01b0316336001600160a01b0316148061145857503361144d84610755565b6001600160a01b0316145b8061146a5750815161146a90336112bb565b9050806114a75760405162461bcd60e51b815260206004820152600b60248201526a139bdd185c1c1c9bdd995960aa1b604482015260640161077c565b846001600160a01b031682600001516001600160a01b0316146114fc5760405162461bcd60e51b815260206004820152600d60248201526c24b73b30b634b21027bbb732b960991b604482015260640161077c565b6001600160a01b0384166115375760405162461bcd60e51b8152602060048201526002602482015261060f60f31b604482015260640161077c565b61154760008484600001516113b9565b6001600160a01b038581166000908152600c6020908152604080832080546001600160801b03198082166001600160801b03928316600019018316179092558986168086528386208054938416938316600190810190931693909317909255888552600b90935281842080546001600160e01b031916909117600160a01b4267ffffffffffffffff160217905590860180835291205490911661163a576115ed816113a5565b1561163a5782516000828152600b6020908152604090912080549186015167ffffffffffffffff16600160a01b026001600160e01b03199092166001600160a01b03909316929092171790555b5082846001600160a01b0316866001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45050505050565b60408051808201909152600080825260208201526116a0826113a5565b6116bc5760405162461bcd60e51b815260040161077c90612148565b815b6000818152600b60209081526040918290208251808401909352546001600160a01b038116808452600160a01b90910467ffffffffffffffff16918301919091521561170b579392505050565b50600019016116be565b600f546001600160a01b0316331480611730575060075460ff165b61174c5760405162461bcd60e51b815260040161077c90612310565b600a54600f546001600160a01b031633148061176a575060075460ff165b6117b65760405162461bcd60e51b815260206004820152601b60248201527f4d696e74696e672069732063757272656e746c7920636c6f7365640000000000604482015260640161077c565b6001600160a01b0383166118015760405162461bcd60e51b8152602060048201526012602482015271043616e6e6f742073656e6420746f203078360741b604482015260640161077c565b816000036118485760405162461bcd60e51b815260206004820152601460248201527305175616e746974792063616e6e6f7420626520360641b604482015260640161077c565b600f546001600160a01b031633148061186357506005548211155b6118af5760405162461bcd60e51b815260206004820152601960248201527f5175616e746974792065786365656473206d696e74206d617800000000000000604482015260640161077c565b600f546001600160a01b03163314806118d55750816004546118d1919061235e565b3410155b6119175760405162461bcd60e51b8152602060048201526013602482015272496e73756666696369656e742066756e64732160681b604482015260640161077c565b600654600a54111561195c5760405162461bcd60e51b815260206004820152600e60248201526d4e6f20486f6f7073206c6566742160901b604482015260640161077c565b60065482600a5461196d919061237d565b11156119bb5760405162461bcd60e51b815260206004820152601d60248201527f4e6f7420656e6f75676820486f6f7073206c65667420746f2062757921000000604482015260640161077c565b6001600160a01b0383166000818152600c602090815260408083208054600160801b6001600160801b031982166001600160801b039283168a01831690811782900483168a0190921602179055848352600b909152812080546001600160e01b031916909217600160a01b4267ffffffffffffffff16021790915581905b83811015611ae25760405182906001600160a01b038716906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a4611a956000868460405180602001604052806000815250611bf4565b611ad65760405162461bcd60e51b81526020600482015260126024820152712737ba1022a9219b9918a932b1b2b4bb32b960711b604482015260640161077c565b60019182019101611a39565b50600a55505050565b606081600003611b125750506040805180820190915260018152600360fc1b602082015290565b8160005b8115611b3c5780611b2681612395565b9150611b359050600a836123c4565b9150611b16565b60008167ffffffffffffffff811115611b5757611b57611ea2565b6040519080825280601f01601f191660200182016040528015611b81576020820181803683370190505b5090505b8415611bec57611b966001836121bd565b9150611ba3600a866123d8565b611bae90603061237d565b60f81b818381518110611bc357611bc36123ec565b60200101906001600160f81b031916908160001a905350611be5600a866123c4565b9450611b85565b949350505050565b60006001600160a01b0384163b15611d0357604051630a85bd0160e11b81526001600160a01b0385169063150b7a0290611c38903390899088908890600401612402565b6020604051808303816000875af1925050508015611c73575060408051601f3d908101601f19168201909252611c709181019061243f565b60015b611ce9573d808015611ca1576040519150601f19603f3d011682016040523d82523d6000602084013e611ca6565b606091505b508051600003611ce15760405162461bcd60e51b81526020600482015260066024820152656e6f7437323160d01b604482015260640161077c565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050611bec565b506001949350505050565b828054611d1a9061220b565b90600052602060002090601f016020900481019282611d3c5760008555611d82565b82601f10611d5557805160ff1916838001178555611d82565b82800160010185558215611d82579182015b82811115611d82578251825591602001919060010190611d67565b50610d859291505b80821115610d855760008155600101611d8a565b6001600160e01b031981168114610bcf57600080fd5b600060208284031215611dc657600080fd5b8135611dd181611d9e565b9392505050565b60005b83811015611df3578181015183820152602001611ddb565b8381111561111a5750506000910152565b60008151808452611e1c816020860160208601611dd8565b601f01601f19169290920160200192915050565b602081526000611dd16020830184611e04565b600060208284031215611e5557600080fd5b5035919050565b80356001600160a01b0381168114611e7357600080fd5b919050565b60008060408385031215611e8b57600080fd5b611e9483611e5c565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff80841115611ed357611ed3611ea2565b604051601f8501601f19908116603f01168101908282118183101715611efb57611efb611ea2565b81604052809350858152868686011115611f1457600080fd5b858560208301376000602087830101525050509392505050565b600082601f830112611f3f57600080fd5b611dd183833560208501611eb8565b600060208284031215611f6057600080fd5b813567ffffffffffffffff811115611f7757600080fd5b611bec84828501611f2e565b600080600060608486031215611f9857600080fd5b611fa184611e5c565b9250611faf60208501611e5c565b9150604084013590509250925092565b60008060408385031215611fd257600080fd5b82359150602083013567ffffffffffffffff811115611ff057600080fd5b611ffc85828601611f2e565b9150509250929050565b60006020828403121561201857600080fd5b611dd182611e5c565b80358015158114611e7357600080fd5b6000806040838503121561204457600080fd5b61204d83611e5c565b915061205b60208401612021565b90509250929050565b6000806000806080858703121561207a57600080fd5b61208385611e5c565b935061209160208601611e5c565b925060408501359150606085013567ffffffffffffffff8111156120b457600080fd5b8501601f810187136120c557600080fd5b6120d487823560208401611eb8565b91505092959194509250565b6000602082840312156120f257600080fd5b611dd182612021565b6000806040838503121561210e57600080fd5b61211783611e5c565b915061205b60208401611e5c565b6000806040838503121561213857600080fd5b8235915061205b60208401611e5c565b6020808252600e908201526d139bc81d1bdad95b88199bdd5b9960921b604082015260600190565b60208082526017908201527f43616c6c6572206973206e6f7420746865206f776e6572000000000000000000604082015260600190565b634e487b7160e01b600052601160045260246000fd5b6000828210156121cf576121cf6121a7565b500390565b60208082526018908201527f537469636b65727320617265206e6f7420656e61626c65640000000000000000604082015260600190565b600181811c9082168061221f57607f821691505b60208210810361223f57634e487b7160e01b600052602260045260246000fd5b50919050565b8054600090600181811c908083168061225f57607f831692505b6020808410820361228057634e487b7160e01b600052602260045260246000fd5b81801561229457600181146122a5576122d1565b60ff198616895284890196506122d1565b876000528160002060005b868110156122c95781548b8201529085019083016122b0565b505084890196505b50505050505092915050565b60006122e98286612245565b84516122f9818360208901611dd8565b61230581830186612245565b979650505050505050565b6020808252602e908201527f596f7520617265206e6f7420746865206f776e657220616e6420746865206d6960408201526d373a1034b9903737ba1037b832b760911b606082015260800190565b6000816000190483118215151615612378576123786121a7565b500290565b60008219821115612390576123906121a7565b500190565b6000600182016123a7576123a76121a7565b5060010190565b634e487b7160e01b600052601260045260246000fd5b6000826123d3576123d36123ae565b500490565b6000826123e7576123e76123ae565b500690565b634e487b7160e01b600052603260045260246000fd5b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061243590830184611e04565b9695505050505050565b60006020828403121561245157600080fd5b8151611dd181611d9e56fe2247726561746e65737320697320646566696e656420627920686f77206d75636820796f752077616e7420746f2070757420696e746f207768617420796f7520646f2e22202d204c6542726f6e204a616d6573a264697066735822122070a0a93866002c1a21283f7beb1b3ec7db4abc5b31524b1f24c389fd9d34d5b264736f6c634300080d0033