Contract 0xf9b2e71001bb5e5a109950be9c87411662f30d39

Contract Overview

Balance:
0 AVAX
Txn Hash Method
Block
From
To
Value [Txn Fee]
0xcfb5d076fc6f0d8c80fc241f474183bb33ed9052ae4d79699e125b96fe205b860x60a06040179263522023-01-11 22:29:5570 days 22 hrs ago0x4082e997ec720a4894efec53b0d9aabfeea44cbe IN  Create: A8BallCue0 AVAX0.1210009525
[ Download CSV Export 
Latest 25 internal transaction
Parent Txn Hash Block From To Value
0xc547b916b27b8b913a56f47c0bf66f12437b9e3d14caa0da240d25467b182d58185438282023-02-01 16:38:2250 days 3 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xb79c83db357e89118d85070d39013f84c6eb41ee8b2ffe32ed61b36fe64e1ab7185437892023-02-01 16:37:0550 days 3 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xc2afa2d591f7e9e28a226d079bb2a3d34c0fa21c3429cef60fc7787464c3ef36185432102023-02-01 16:17:3850 days 4 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x304d70b979a6118c55f58862031e2638636328a9ae6fdc9f15b142af45eede5e185262692023-02-01 6:51:4050 days 13 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x6f33c7912d5f68b00005fc41fe0ad8b7ed457e8e56cbeed0c80e28a7f5fd0c38185210482023-02-01 3:42:4650 days 16 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x5379eae1aaa0b1a5e44f9d8b97f65d24da32945f238f54cb5bcee8b8a91f3126185208482023-02-01 3:32:4850 days 17 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x43dbe405f96b80bd394d434cf813fabdfbfef9b8195fae2ebb6bfa0ef9963f90185206592023-02-01 3:24:3850 days 17 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xcf5e542a27f3389c3f1fa58ecc69c1885269c4e9ab78e599c274dd10991b1218185205952023-02-01 3:22:0550 days 17 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xc3beb14652be53d70301915b8efe006808f75adb842ea435023f023087b2072e185204872023-02-01 3:17:3850 days 17 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x52b6521e69a0fa1a8e119a36be2608a4c9e6f83c4344a278e2f46749be33babb185202902023-02-01 3:08:3050 days 17 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x18ae18485032524043b8e5aef22ad85e2ad181b4d068d497d4c385ecda4c908a185200172023-02-01 2:54:5450 days 17 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x48f53d0dc4e96c1d24f9b9fcc341685d13db1b2951a03d3d13003279d8357754185192512023-02-01 2:17:1450 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xd4de1329ed56abdca6a175889037053ebb287eddff37e3d8d6b211a56ebde077185192292023-02-01 2:16:2850 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xd4de1329ed56abdca6a175889037053ebb287eddff37e3d8d6b211a56ebde077185192292023-02-01 2:16:2850 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x1b94199aa4680d707a8c1cc8c12fc9f83a37ee5774d581d65f9a015f69f06333185192152023-02-01 2:15:4950 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xfe1d736818624f02c3b94978df4c1869ad69e10e79740167bcfd51ef0abd1051185191892023-02-01 2:14:4350 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xdeda22fe037b7ee465c2563530a6a78f77cacd2f4af3c32ac5001f45c04b58ea185191632023-02-01 2:13:3750 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xc30a71f2aa816a4b8b6be4ae8c0007a7ee92faf3e320752546b9269211caaa8e185189132023-02-01 2:01:4250 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x05efa45e447a48c734f0eed8697664d01cf015fb7c2ad9bdd9fbcd1b264b01e4185188902023-02-01 2:00:3950 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x3aae4ec04c878715f661901941364b0df7a8d73115349cdc02f55e1ca317fc79185188682023-02-01 1:59:3650 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0xefed9632769714a863b61ed8a102377dcebec826fbc7513cef4ba817cf5e45a9185188182023-02-01 1:57:0750 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x8896fa9dcc4d93c86011fc6cf4635b0f99cf88e4f21d02063d8fb0a535ebb76d185187542023-02-01 1:53:5350 days 18 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x090e6030621b8ee65ccbda73ad4abd5287d2172b9161e41bd4911eb17762a34e185162612023-01-31 23:50:1550 days 20 hrs ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x016d8f177fc469ca85e3882387cabc4e2e9be959a2cd74956283313a1065d95f185115362023-01-31 20:01:5651 days 31 mins ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
0x89985a639269d50d1488b0db20f91535bcb8e29794fcf8a4b80705c7f2b8d317185111452023-01-31 19:43:0751 days 50 mins ago 0xcd9df581f855d07144f150b0c6818245480086440xf9b2e71001bb5e5a109950be9c87411662f30d390 AVAX
[ Download CSV Export 
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.

Contract Source Code Verified (Exact Match)

Contract Name:
A8BallCue

Compiler Version
v0.8.16+commit.07a7930e

Optimization Enabled:
Yes with 200 runs

Other Settings:
default evmVersion
File 1 of 36 : ERC721BurnableV2.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (token/ERC721/extensions/ERC721URITokenJSON.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721BurnableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/utils/structs/EnumerableSetUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";

/**
 * @dev This implements an optional extension of {ERC721} defined in the EIP that adds
 * enumerability of all the token ids in the contract as well as all token ids owned by each
 * account.
 */
abstract contract ERC721BurnableV2 is Initializable, ERC721BurnableUpgradeable {
    using EnumerableSetUpgradeable for EnumerableSetUpgradeable.UintSet;

    EnumerableSetUpgradeable.UintSet private _burned;

    function __ERC721BurnableV2_init() internal onlyInitializing {
        __ERC721Burnable_init();
    }

    function __ERC721BurnableV2_init_unchained() internal onlyInitializing {
    }

    function burn(uint256 tokenId) public virtual override {
        require(_isApprovedOrOwner(msg.sender, tokenId), "ERC721BurnableV2: caller is not token owner nor approved");
        _burned.add(tokenId);
        super._burn(tokenId);
    }



    function _removeBurnedId(uint256 tokenId) internal virtual {
        _burned.remove(tokenId);
    }

    uint256[49] private __gap;
}

File 2 of 36 : ERC721Capped.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (token/ERC721/extensions/ERC721URITokenJSON.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721EnumerableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";


/**
 * @dev Extension of {ERC721} that adds a cap to the supply of tokens.
 *
 * @custom:storage-size 51
 */
abstract contract ERC721Capped is Initializable, ERC721EnumerableUpgradeable {
    uint256 private _cap;

    /**
     * @dev Sets the value of the `cap`. This value is immutable, it can only be
     * set once during construction.
     */
    function __ERC721Capped_init(uint256 cap_) internal onlyInitializing {
        __ERC721Capped_init_unchained(cap_);
    }

    function __ERC721Capped_init_unchained(uint256 cap_) internal onlyInitializing {
        require(cap_ > 0, "ERC721Capped::cap is 0");
        _cap = cap_;
    }

    /**
     * @dev Returns the cap on the token's total supply.
     */
    function cap() public view virtual returns (uint256) {
        return _cap;
    }

    /**
     * @dev See {ERC20-_mint}.
     */
    function _safeMint(address to, uint256 tokenId) internal virtual override {
        require(ERC721EnumerableUpgradeable.totalSupply() + 1 <= cap(), "ERC721Capped: cap exceeded");
        super._safeMint(to, tokenId);
    }

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

File 3 of 36 : ERC721EnumerableV2.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (token/ERC721/extensions/ERC721EnumerableV2.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721EnumerableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/utils/structs/EnumerableSetUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";

/**
 * @dev This implements an optional extension of {ERC721} defined in the EIP that adds
 * enumerability of all the token ids in the contract as well as all token ids owned by each
 * account.
 */
abstract contract ERC721EnumerableV2 is Initializable, ERC721EnumerableUpgradeable {
    using EnumerableSetUpgradeable for EnumerableSetUpgradeable.UintSet;

    function __ERC721EnumerableV2_init() internal onlyInitializing {
        __ERC721Enumerable_init();
    }

    function __ERC721EnumerableV2_init_unchained() internal onlyInitializing {
    }

    function batchTransferFrom(address from, address to, uint256[] memory tokenIds) public virtual {
        for (uint256 i = 0; i < tokenIds.length; i++) {
            transferFrom(from, to, tokenIds[i]);
        }
    }

    function tokensOfOwner(address owner) public view virtual returns(uint256[] memory) {
        uint256 total = balanceOf(owner);
        uint256[] memory tokens = new uint256[](total);
        for (uint256 i = 0; i < total; i++) {
            tokens[i] = tokenOfOwnerByIndex(owner, i);
        }
        return tokens;
    }

    function getAllTokenIds() public view returns (uint256[] memory) {
        uint256 count = 0;
        for (uint256 i = 1; i < 10_000; i++) {
            if (_exists(i)) {
                count++;
            }
        }
        uint256[] memory tokenIds = new uint256[](count);
        uint256 index = 0;
        for (uint256 i = 1; i < 10_000; i++) {
            if (_exists(i)) {
                tokenIds[index] = i;
                index++;
            }
        }
        return tokenIds;
    }

    function supportsInterface(bytes4 interfaceId)
    public
    view
    virtual
    override(ERC721EnumerableUpgradeable)
    returns (bool)
    {
        return super.supportsInterface(interfaceId);
    }

    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 firstTokenId,
        uint256 batchSize
    ) internal virtual override(ERC721EnumerableUpgradeable) {
        super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
    }

    uint256[50] private __gap;
}

File 4 of 36 : ERC721URITokenJSON.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (token/ERC721/extensions/ERC721URITokenJSON.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";

import "../../../utils/TokenMetadata.sol";

/**
 * @dev ERC721 token with storage based token URI management.
 */
abstract contract ERC721URITokenJSON is Initializable, ERC721Upgradeable {
    using StringsUpgradeable for uint256;
    using TokenMetadata for string;

    string public imageBaseURI;

    function __ERC721URITokenJSON_init(string memory _imageBaseURI) internal onlyInitializing {
        imageBaseURI = _imageBaseURI;
    }

    function tokenURI(uint256 tokenId) public view virtual override(ERC721Upgradeable) returns(string memory) {
        return tokenURIJSON(tokenId).toBase64();
    }

    function tokenURIJSON(uint256 tokenId) public view virtual returns(string memory);

    function batchTokenURI(uint256[] calldata tokenIds) public view virtual returns(string[] memory) {
        string[] memory uris = new string[](tokenIds.length);
        for (uint256 i = 0; i < tokenIds.length; i++) {
            uris[i] = tokenURI(tokenIds[i]);
        }
        return uris;
    }

    function batchTokenURIJSON(uint256[] memory tokenIds) public view virtual returns(string[] memory) {
        string[] memory uris = new string[](tokenIds.length);
        for (uint256 i = 0; i < tokenIds.length; i++) {
            uris[i] = tokenURIJSON(tokenIds[i]);
        }
        return uris;
    }

    function makeMetadataJSON(
        uint256 tokenId,
        string memory name,
        string memory description,
        TokenMetadata.Attribute[] memory attributes
    ) internal view virtual returns(string memory) {
        address owner = ownerOf(tokenId);
        string memory imageURI = string(abi.encodePacked(imageBaseURI, imageURISuffix(tokenId)));
        return TokenMetadata.makeMetadataJSON(
            tokenId,
            owner,
            name,
            imageURI,
            description,
            TokenMetadata.TokenType.ERC721,
            attributes
        );
    }

    function imageURISuffix(uint256 tokenId) internal view virtual returns (string memory) {
        return tokenId.toString();
    }

    uint256[49] private __gap;
}

File 5 of 36 : StandardAccessControl.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (utils/access/TokenMetadata.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/access/AccessControlEnumerableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";

abstract contract StandardAccessControl is Initializable, AccessControlEnumerableUpgradeable {
    bytes32 private constant ADMIN_ROLE = keccak256("ADMIN_ROLE");
    bytes32 private constant CONTRACT_ROLE = keccak256("CONTRACT_ROLE");
    bytes32 private constant MINTER_ROLE = keccak256("MINTER_ROLE");
    bytes32 private constant PRIVATE_ROLE = keccak256("PRIVATE_ROLE");
    bytes32 private constant BRIDGE_ROLE = keccak256("BRIDGE_ROLE");

    function __StandardAccessControl_init() internal onlyInitializing {
        __AccessControlEnumerable_init();

        _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
        _grantRole(ADMIN_ROLE, msg.sender);
        _grantRole(CONTRACT_ROLE, msg.sender);
        _grantRole(MINTER_ROLE, msg.sender);
        _grantRole(PRIVATE_ROLE, msg.sender);
        _grantRole(BRIDGE_ROLE, msg.sender);
    }

    modifier onlyDefaultAdmin() {
        _checkRole(DEFAULT_ADMIN_ROLE);
        _;
    }

    modifier onlyAdmin() {
        _checkRole(ADMIN_ROLE);
        _;
    }
    modifier onlyContract() {
        _checkRole(CONTRACT_ROLE);
        _;
    }
    modifier onlyMinter() {
        _checkRole(MINTER_ROLE);
        _;
    }
    modifier onlyPrivate() {
        _checkRole(PRIVATE_ROLE);
        _;
    }

    modifier onlyBridge() {
        _checkRole(BRIDGE_ROLE);
        _;
    }

    function _hasDefaultAdminRole(address _address) internal view returns(bool) {
        return hasRole(DEFAULT_ADMIN_ROLE, _address);
    }

    function _hasAdminRole(address _address) internal view returns(bool) {
        return hasRole(ADMIN_ROLE, _address);
    }

    function _hasContractRole(address _address) internal view returns(bool) {
        return hasRole(CONTRACT_ROLE, _address);
    }

    function _hasMinterRole(address _address) internal view returns(bool) {
        return hasRole(MINTER_ROLE, _address);
    }

    function _hasPrivateRole(address _address) internal view returns(bool) {
        return hasRole(PRIVATE_ROLE, _address);
    }

    function _hasBridgeRole(address _address) internal view returns(bool) {
        return hasRole(BRIDGE_ROLE, _address);
    }

    function _checkRoles(bytes32[] calldata roles) internal view virtual {
        _checkRoles(roles, msg.sender);
    }

    function _checkRoles(bytes32[] calldata roles, address account) internal view virtual {
        for (uint256 i = 0; i < roles.length; i++) {
            if (hasRole(roles[i], account)) {
                return;
            }
        }
        revert(
            string(
                abi.encodePacked(
                    "AccessControl: account ",
                    StringsUpgradeable.toHexString(account),
                    " is missing role all roles"
                )
            )
        );
    }

    uint256[46] private __gap;
}

File 6 of 36 : Attributes.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (utils/structs/Attributes.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/utils/structs/EnumerableSetUpgradeable.sol";

/**
* @title Attributes v1.0.0
* @author @DirtyCajunRice
* @dev Attribute storage library for NFTs
*/
library Attributes {
    using EnumerableSetUpgradeable for EnumerableSetUpgradeable.UintSet;

    struct AttributeStore {
        EnumerableSetUpgradeable.UintSet _treeIds;
        // treeId => skillId;
        mapping(uint256 => EnumerableSetUpgradeable.UintSet) _skillIds;
        // tokenId => treeId => skillId => value
        mapping(uint256 => mapping(uint256 => mapping(uint256 => uint256)))  _values;
        // treeId => skillId => skillValue => name
        mapping(uint256 => mapping(uint256 => mapping(uint256 => string))) _names;
        // treeId => skillId => name
        mapping(uint256 => mapping(uint256 => string)) _skillNames;
        // treeId => name
        mapping(uint256 => string) _treeNames;
    }

    /**
     * @dev Get a single skill value
     *
     * @param tokenId ID of the NFT
     * @param treeId ID of the storage tree
     * @param skillId ID of the skill
     *
     * @return value skill value
     */
    function getValue(
        AttributeStore storage store,
        uint256 tokenId,
        uint256 treeId,
        uint256 skillId
    ) internal view returns (uint256) {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].contains(skillId), "Attributes::Non-existent skillId");
        return store._values[tokenId][treeId][skillId];
    }

    function getSkillIds(AttributeStore storage store, uint256 treeId) internal view returns (uint256[] memory) {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        return store._skillIds[treeId].values();
    }

    function getTreeIds(AttributeStore storage store) internal view returns (uint256[] memory) {
        return store._treeIds.values();
    }

    function getName(
        AttributeStore storage store,
        uint256 treeId,
        uint256 skillId,
        uint256 value
    ) internal view returns (string memory) {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].contains(skillId), "Attributes::Non-existent skillId");
        return store._names[treeId][skillId][value];
    }

    function getSkillName(
        AttributeStore storage store,
        uint256 treeId,
        uint256 skillId
    ) internal view returns (string memory) {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].contains(skillId), "Attributes::Non-existent skillId");
        return store._skillNames[treeId][skillId];
    }

    function getTreeName(AttributeStore storage store, uint256 treeId) internal view returns (string memory) {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        return store._treeNames[treeId];
    }

    /**
    * @dev Update a single skill to value
    *
    * @param tokenId ID of the NFT
    * @param treeId ID of the storage tree
    * @param skillId ID of the skill
    * @param value new skill value
    */
    function setValue(
        AttributeStore storage store,
        uint256 tokenId,
        uint256 treeId,
        uint256 skillId,
        uint256 value
    ) internal {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].contains(skillId), "Attributes::Non-existent skillId");
        store._values[tokenId][treeId][skillId] = value;
    }

    function setName(
        AttributeStore storage store,
        uint256 treeId,
        uint256 skillId,
        uint256 value,
        string memory name
    ) internal {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].contains(skillId), "Attributes::Non-existent skillId");
        store._names[treeId][skillId][value] = name;
    }

    function addSkill(AttributeStore storage store, uint256 treeId, uint256 skillId, string memory name) internal {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].add(skillId), "Attributes::SkillId already exists");
        store._skillNames[treeId][skillId] = name;
    }

    function setSkillName(AttributeStore storage store, uint256 treeId, uint256 skillId, string memory name) internal {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        require(store._skillIds[treeId].contains(skillId), "Attributes::Non-existent skillId");
        store._skillNames[treeId][skillId] = name;
    }

    function addTree(AttributeStore storage store, uint256 treeId, string memory name) internal {
        require(store._treeIds.add(treeId), "Attributes::TreeId already exists");
        store._treeNames[treeId] = name;
    }

    function setTreeName(AttributeStore storage store, uint256 treeId, string memory name) internal {
        require(store._treeIds.contains(treeId), "Attributes::Non-existent treeId");
        store._treeNames[treeId] = name;
    }

    struct StringStore {
        EnumerableSetUpgradeable.UintSet _stringIds;
        // tokenId > stringId  > value
        mapping(uint256 => mapping(uint256 => string))  _values;
        // stringId > name
        mapping(uint256 => string)  _names;
        // tokenId > name
        mapping(uint256 => string)  _tokenNames;
    }

    function getValue(
        StringStore storage store,
        uint256 tokenId,
        uint256 stringId
    ) internal view returns (string memory) {
        require(store._stringIds.contains(stringId), "Attributes::Non-existent stringId");
        return store._values[tokenId][stringId];
    }

    function getName(StringStore storage store, uint256 stringId) internal view returns (string memory) {
        require(store._stringIds.contains(stringId), "Attributes::Non-existent stringId");
        return store._names[stringId];
    }

    function getStringIds(StringStore storage store) internal view returns (uint256[] memory) {
        return store._stringIds.values();
    }

    function getTokenName(StringStore storage store, uint256 tokenId) internal view returns (string memory) {
        return store._tokenNames[tokenId];
    }

    function setValue(StringStore storage store, uint256 tokenId, uint256 stringId, string memory value) internal {
        require(store._stringIds.contains(stringId), "Attributes::Non-existent stringId");
        store._values[tokenId][stringId] = value;
    }

    function setName(StringStore storage store, uint256 stringId, string memory value) internal {
        require(store._stringIds.contains(stringId), "Attributes::Non-existent stringId");
        store._names[stringId] = value;
    }

    function setTokenName(StringStore storage store, uint256 tokenId, string memory value) internal {
        store._names[tokenId] = value;
    }
}

File 7 of 36 : TokenMetadata.sol
// SPDX-License-Identifier: MIT
// DirtyCajunRice Contracts (last updated v1.0.0) (utils/TokenMetadata.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/utils/Base64Upgradeable.sol";

/**
 * @dev Metadata operations.
 */
library TokenMetadata {
    using StringsUpgradeable for uint256;
    using StringsUpgradeable for address;
    using Base64Upgradeable for bytes;
    using TokenMetadata for TokenType;
    using TokenMetadata for Attribute[];

    enum TokenType {
        ERC20,
        ERC1155,
        ERC721
    }

    struct Attribute {
        string name;
        string displayType;
        string value;
        bool isNumber;
    }

    function toBase64(string memory json) internal pure returns (string memory) {
        return string(abi.encodePacked("data:application/json;base64,", bytes(json).encode()));
    }

    function makeMetadataJSON(
        uint256 tokenId,
        address owner,
        string memory name,
        string memory imageURI,
        string memory description,
        TokenType tokenType,
        Attribute[] memory attributes
    ) internal pure returns(string memory) {
        string memory metadataJSON = makeMetadataString(tokenId, owner, name, imageURI, description, tokenType);
        return string(abi.encodePacked('{', metadataJSON, attributes.toJSONString(), '}'));
    }

    function makeMetadataString(
        uint256 tokenId,
        address owner,
        string memory name,
        string memory imageURI,
        string memory description,
        TokenType tokenType
    ) internal pure returns(string memory) {
        return string(abi.encodePacked(
                '"name":"', name, '",',
                '"tokenId":"', tokenId.toString(), '",',
                '"description":"', description, '",',
                '"image":"', imageURI, '",',
                '"owner":"', owner.toHexString(), '",',
                '"type":"', tokenType.toString(), '",'
            ));
    }

    function toJSONString(Attribute[] memory attributes) internal pure returns(string memory) {
        string memory attributeString = "";
        for (uint256 i = 0; i < attributes.length; i++) {
            string memory comma = i == (attributes.length - 1) ? '' : ',';
            string memory quote = attributes[i].isNumber ? '' : '"';
            string memory value = string(abi.encodePacked(quote, attributes[i].value, quote));
            string memory displayType = bytes(attributes[i].displayType).length == 0
            ? ''
            : string(abi.encodePacked('"display_type":"', attributes[i].displayType, '",'));
            string memory newAttributeString = string(
                abi.encodePacked(
                    attributeString,
                    '{"trait_type":"', attributes[i].name, '",', displayType, '"value":', value, '}',
                    comma
                )
            );
            attributeString = newAttributeString;
        }
        return string(abi.encodePacked('"attributes":[', attributeString, ']'));
    }

    function toString(TokenType tokenType) internal pure returns(string memory) {
        return tokenType == TokenType.ERC721 ? "ERC721" : tokenType == TokenType.ERC1155 ? "ERC1155" : "ERC20";
    }

    function makeContractURI(
        string memory name,
        string memory description,
        string memory imageURL,
        string memory externalLinkURL,
        uint256 sellerFeeBasisPoints,
        address feeRecipient
    ) internal pure returns(string memory) {
        return string(abi.encodePacked(
                '{"name":"', name, '",',
                '"description":"', description, '",',
                '"image":"', imageURL, '",',
                '"external_link":"', externalLinkURL, '",',
                '"seller_fee_basis_points":', sellerFeeBasisPoints.toString(), ',',
                '"fee_recipient":"', feeRecipient.toHexString(), '"}'
            ));
    }
}

File 8 of 36 : AccessControlEnumerableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol)

pragma solidity ^0.8.0;

import "./IAccessControlEnumerableUpgradeable.sol";
import "./AccessControlUpgradeable.sol";
import "../utils/structs/EnumerableSetUpgradeable.sol";
import "../proxy/utils/Initializable.sol";

/**
 * @dev Extension of {AccessControl} that allows enumerating the members of each role.
 */
abstract contract AccessControlEnumerableUpgradeable is Initializable, IAccessControlEnumerableUpgradeable, AccessControlUpgradeable {
    function __AccessControlEnumerable_init() internal onlyInitializing {
    }

    function __AccessControlEnumerable_init_unchained() internal onlyInitializing {
    }
    using EnumerableSetUpgradeable for EnumerableSetUpgradeable.AddressSet;

    mapping(bytes32 => EnumerableSetUpgradeable.AddressSet) private _roleMembers;

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

    /**
     * @dev Returns one of the accounts that have `role`. `index` must be a
     * value between 0 and {getRoleMemberCount}, non-inclusive.
     *
     * Role bearers are not sorted in any particular way, and their ordering may
     * change at any point.
     *
     * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
     * you perform all queries on the same block. See the following
     * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
     * for more information.
     */
    function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) {
        return _roleMembers[role].at(index);
    }

    /**
     * @dev Returns the number of accounts that have `role`. Can be used
     * together with {getRoleMember} to enumerate all bearers of a role.
     */
    function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) {
        return _roleMembers[role].length();
    }

    /**
     * @dev Overload {_grantRole} to track enumerable memberships
     */
    function _grantRole(bytes32 role, address account) internal virtual override {
        super._grantRole(role, account);
        _roleMembers[role].add(account);
    }

    /**
     * @dev Overload {_revokeRole} to track enumerable memberships
     */
    function _revokeRole(bytes32 role, address account) internal virtual override {
        super._revokeRole(role, account);
        _roleMembers[role].remove(account);
    }

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

File 9 of 36 : AccessControlUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (access/AccessControl.sol)

pragma solidity ^0.8.0;

import "./IAccessControlUpgradeable.sol";
import "../utils/ContextUpgradeable.sol";
import "../utils/StringsUpgradeable.sol";
import "../utils/introspection/ERC165Upgradeable.sol";
import "../proxy/utils/Initializable.sol";

/**
 * @dev Contract module that allows children to implement role-based access
 * control mechanisms. This is a lightweight version that doesn't allow enumerating role
 * members except through off-chain means by accessing the contract event logs. Some
 * applications may benefit from on-chain enumerability, for those cases see
 * {AccessControlEnumerable}.
 *
 * Roles are referred to by their `bytes32` identifier. These should be exposed
 * in the external API and be unique. The best way to achieve this is by
 * using `public constant` hash digests:
 *
 * ```
 * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
 * ```
 *
 * Roles can be used to represent a set of permissions. To restrict access to a
 * function call, use {hasRole}:
 *
 * ```
 * function foo() public {
 *     require(hasRole(MY_ROLE, msg.sender));
 *     ...
 * }
 * ```
 *
 * Roles can be granted and revoked dynamically via the {grantRole} and
 * {revokeRole} functions. Each role has an associated admin role, and only
 * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
 *
 * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
 * that only accounts with this role will be able to grant or revoke other
 * roles. More complex role relationships can be created by using
 * {_setRoleAdmin}.
 *
 * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
 * grant and revoke this role. Extra precautions should be taken to secure
 * accounts that have been granted it.
 */
abstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControlUpgradeable, ERC165Upgradeable {
    function __AccessControl_init() internal onlyInitializing {
    }

    function __AccessControl_init_unchained() internal onlyInitializing {
    }
    struct RoleData {
        mapping(address => bool) members;
        bytes32 adminRole;
    }

    mapping(bytes32 => RoleData) private _roles;

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with a standardized message including the required role.
     *
     * The format of the revert reason is given by the following regular expression:
     *
     *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
     *
     * _Available since v4.1._
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

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

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
        return _roles[role].members[account];
    }

    /**
     * @dev Revert with a standard message if `_msgSender()` is missing `role`.
     * Overriding this function changes the behavior of the {onlyRole} modifier.
     *
     * Format of the revert message is described in {_checkRole}.
     *
     * _Available since v4.6._
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @dev Revert with a standard message if `account` is missing `role`.
     *
     * The format of the revert reason is given by the following regular expression:
     *
     *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert(
                string(
                    abi.encodePacked(
                        "AccessControl: account ",
                        StringsUpgradeable.toHexString(account),
                        " is missing role ",
                        StringsUpgradeable.toHexString(uint256(role), 32)
                    )
                )
            );
        }
    }

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
        return _roles[role].adminRole;
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleGranted} event.
     */
    function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
        _grantRole(role, account);
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleRevoked} event.
     */
    function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
        _revokeRole(role, account);
    }

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been revoked `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `account`.
     *
     * May emit a {RoleRevoked} event.
     */
    function renounceRole(bytes32 role, address account) public virtual override {
        require(account == _msgSender(), "AccessControl: can only renounce roles for self");

        _revokeRole(role, account);
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event. Note that unlike {grantRole}, this function doesn't perform any
     * checks on the calling account.
     *
     * May emit a {RoleGranted} event.
     *
     * [WARNING]
     * ====
     * This function should only be called from the constructor when setting
     * up the initial roles for the system.
     *
     * Using this function in any other way is effectively circumventing the admin
     * system imposed by {AccessControl}.
     * ====
     *
     * NOTE: This function is deprecated in favor of {_grantRole}.
     */
    function _setupRole(bytes32 role, address account) internal virtual {
        _grantRole(role, account);
    }

    /**
     * @dev Sets `adminRole` as ``role``'s admin role.
     *
     * Emits a {RoleAdminChanged} event.
     */
    function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
        bytes32 previousAdminRole = getRoleAdmin(role);
        _roles[role].adminRole = adminRole;
        emit RoleAdminChanged(role, previousAdminRole, adminRole);
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual {
        if (!hasRole(role, account)) {
            _roles[role].members[account] = true;
            emit RoleGranted(role, account, _msgSender());
        }
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual {
        if (hasRole(role, account)) {
            _roles[role].members[account] = false;
            emit RoleRevoked(role, account, _msgSender());
        }
    }

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

File 10 of 36 : IAccessControlEnumerableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol)

pragma solidity ^0.8.0;

import "./IAccessControlUpgradeable.sol";

/**
 * @dev External interface of AccessControlEnumerable declared to support ERC165 detection.
 */
interface IAccessControlEnumerableUpgradeable is IAccessControlUpgradeable {
    /**
     * @dev Returns one of the accounts that have `role`. `index` must be a
     * value between 0 and {getRoleMemberCount}, non-inclusive.
     *
     * Role bearers are not sorted in any particular way, and their ordering may
     * change at any point.
     *
     * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
     * you perform all queries on the same block. See the following
     * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
     * for more information.
     */
    function getRoleMember(bytes32 role, uint256 index) external view returns (address);

    /**
     * @dev Returns the number of accounts that have `role`. Can be used
     * together with {getRoleMember} to enumerate all bearers of a role.
     */
    function getRoleMemberCount(bytes32 role) external view returns (uint256);
}

File 11 of 36 : IAccessControlUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)

pragma solidity ^0.8.0;

/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControlUpgradeable {
    /**
     * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
     *
     * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
     * {RoleAdminChanged} not being emitted signaling this.
     *
     * _Available since v3.1._
     */
    event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);

    /**
     * @dev Emitted when `account` is granted `role`.
     *
     * `sender` is the account that originated the contract call, an admin role
     * bearer except when using {AccessControl-_setupRole}.
     */
    event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Emitted when `account` is revoked `role`.
     *
     * `sender` is the account that originated the contract call:
     *   - if using `revokeRole`, it is the admin role bearer
     *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
     */
    event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) external view returns (bool);

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {AccessControl-_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) external view returns (bytes32);

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function grantRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function revokeRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been granted `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `account`.
     */
    function renounceRole(bytes32 role, address account) external;
}

File 12 of 36 : draft-IERC1822Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)

pragma solidity ^0.8.0;

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

File 13 of 36 : IBeaconUpgradeable.sol
// 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);
}

File 14 of 36 : ERC1967UpgradeUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (proxy/ERC1967/ERC1967Upgrade.sol)

pragma solidity ^0.8.2;

import "../beacon/IBeaconUpgradeable.sol";
import "../../interfaces/draft-IERC1822Upgradeable.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 {
    }

    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 _upgradeToAndCallUUPS(
        address newImplementation,
        bytes memory data,
        bool forceCall
    ) internal {
        // Upgrades from old implementations will perform a rollback test. This test requires the new
        // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
        // this special case will break upgrade paths from old UUPS implementation to new ones.
        if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {
            _setImplementation(newImplementation);
        } else {
            try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
            } catch {
                revert("ERC1967Upgrade: new implementation is not UUPS");
            }
            _upgradeToAndCall(newImplementation, data, forceCall);
        }
    }

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

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

File 15 of 36 : Initializable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (proxy/utils/Initializable.sol)

pragma solidity ^0.8.2;

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

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

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

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

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts.
     *
     * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
     * constructor.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        bool isTopLevelCall = !_initializing;
        require(
            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
            "Initializable: contract is already initialized"
        );
        _initialized = 1;
        if (isTopLevelCall) {
            _initializing = true;
        }
        _;
        if (isTopLevelCall) {
            _initializing = false;
            emit Initialized(1);
        }
    }

    /**
     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
     * used to initialize parent contracts.
     *
     * A reinitializer may be used after the original initialization step. This is essential to configure modules that
     * are added through upgrades and that require initialization.
     *
     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
     * cannot be nested. If one is invoked in the context of another, execution will revert.
     *
     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
     * a contract, executing them in the right order is up to the developer or operator.
     *
     * WARNING: setting the version to 255 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint8 version) {
        require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
        _initialized = version;
        _initializing = true;
        _;
        _initializing = false;
        emit Initialized(version);
    }

    /**
     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
     * {initializer} and {reinitializer} modifiers, directly or indirectly.
     */
    modifier onlyInitializing() {
        require(_initializing, "Initializable: contract is not initializing");
        _;
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     *
     * Emits an {Initialized} event the first time it is successfully executed.
     */
    function _disableInitializers() internal virtual {
        require(!_initializing, "Initializable: contract is initializing");
        if (_initialized < type(uint8).max) {
            _initialized = type(uint8).max;
            emit Initialized(type(uint8).max);
        }
    }

    /**
     * @dev Internal function that returns the initialized version. Returns `_initialized`
     */
    function _getInitializedVersion() internal view returns (uint8) {
        return _initialized;
    }

    /**
     * @dev Internal function that returns the initialized version. Returns `_initializing`
     */
    function _isInitializing() internal view returns (bool) {
        return _initializing;
    }
}

File 16 of 36 : UUPSUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (proxy/utils/UUPSUpgradeable.sol)

pragma solidity ^0.8.0;

import "../../interfaces/draft-IERC1822Upgradeable.sol";
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, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {
    function __UUPSUpgradeable_init() internal onlyInitializing {
    }

    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 Check that the execution is not being performed through a delegate call. This allows a function to be
     * callable on the implementing contract but not through proxies.
     */
    modifier notDelegated() {
        require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall");
        _;
    }

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

    /**
     * @dev Upgrade the implementation of the proxy to `newImplementation`.
     *
     * Calls {_authorizeUpgrade}.
     *
     * Emits an {Upgraded} event.
     */
    function upgradeTo(address newImplementation) external virtual onlyProxy {
        _authorizeUpgrade(newImplementation);
        _upgradeToAndCallUUPS(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);
        _upgradeToAndCallUUPS(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;

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

File 17 of 36 : PausableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)

pragma solidity ^0.8.0;

import "../utils/ContextUpgradeable.sol";
import "../proxy/utils/Initializable.sol";

/**
 * @dev Contract module which allows children to implement an emergency stop
 * mechanism that can be triggered by an authorized account.
 *
 * This module is used through inheritance. It will make available the
 * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
 * the functions of your contract. Note that they will not be pausable by
 * simply including this module, only once the modifiers are put in place.
 */
abstract contract PausableUpgradeable is Initializable, ContextUpgradeable {
    /**
     * @dev Emitted when the pause is triggered by `account`.
     */
    event Paused(address account);

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

    bool private _paused;

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

    function __Pausable_init_unchained() internal onlyInitializing {
        _paused = false;
    }

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

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

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

    /**
     * @dev Throws if the contract is paused.
     */
    function _requireNotPaused() internal view virtual {
        require(!paused(), "Pausable: paused");
    }

    /**
     * @dev Throws if the contract is not paused.
     */
    function _requirePaused() internal view virtual {
        require(paused(), "Pausable: not paused");
    }

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

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

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

File 18 of 36 : ERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (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 {
        __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: address zero is not a valid owner");
        return _balances[owner];
    }

    /**
     * @dev See {IERC721-ownerOf}.
     */
    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
        address owner = _ownerOf(tokenId);
        require(owner != address(0), "ERC721: invalid token ID");
        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) {
        _requireMinted(tokenId);

        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 overridden 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 token owner or approved for all"
        );

        _approve(to, tokenId);
    }

    /**
     * @dev See {IERC721-getApproved}.
     */
    function getApproved(uint256 tokenId) public view virtual override returns (address) {
        _requireMinted(tokenId);

        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: caller is not token owner or 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: caller is not token owner or 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 the owner of the `tokenId`. Does NOT revert if token doesn't exist
     */
    function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
        return _owners[tokenId];
    }

    /**
     * @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 _ownerOf(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) {
        address owner = ERC721Upgradeable.ownerOf(tokenId);
        return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == 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, 1);

        // Check that tokenId was not minted by `_beforeTokenTransfer` hook
        require(!_exists(tokenId), "ERC721: token already minted");

        unchecked {
            // Will not overflow unless all 2**256 token ids are minted to the same owner.
            // Given that tokens are minted one by one, it is impossible in practice that
            // this ever happens. Might change if we allow batch minting.
            // The ERC fails to describe this case.
            _balances[to] += 1;
        }

        _owners[tokenId] = to;

        emit Transfer(address(0), to, tokenId);

        _afterTokenTransfer(address(0), to, tokenId, 1);
    }

    /**
     * @dev Destroys `tokenId`.
     * The approval is cleared when the token is burned.
     * This is an internal function that does not check if the sender is authorized to operate on the token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     *
     * Emits a {Transfer} event.
     */
    function _burn(uint256 tokenId) internal virtual {
        address owner = ERC721Upgradeable.ownerOf(tokenId);

        _beforeTokenTransfer(owner, address(0), tokenId, 1);

        // Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
        owner = ERC721Upgradeable.ownerOf(tokenId);

        // Clear approvals
        delete _tokenApprovals[tokenId];

        unchecked {
            // Cannot overflow, as that would require more tokens to be burned/transferred
            // out than the owner initially received through minting and transferring in.
            _balances[owner] -= 1;
        }
        delete _owners[tokenId];

        emit Transfer(owner, address(0), tokenId);

        _afterTokenTransfer(owner, address(0), tokenId, 1);
    }

    /**
     * @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 from incorrect owner");
        require(to != address(0), "ERC721: transfer to the zero address");

        _beforeTokenTransfer(from, to, tokenId, 1);

        // Check that tokenId was not transferred by `_beforeTokenTransfer` hook
        require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");

        // Clear approvals from the previous owner
        delete _tokenApprovals[tokenId];

        unchecked {
            // `_balances[from]` cannot overflow for the same reason as described in `_burn`:
            // `from`'s balance is the number of token held, which is at least one before the current
            // transfer.
            // `_balances[to]` could overflow in the conditions described in `_mint`. That would require
            // all 2**256 token ids to be minted, which in practice is impossible.
            _balances[from] -= 1;
            _balances[to] += 1;
        }
        _owners[tokenId] = to;

        emit Transfer(from, to, tokenId);

        _afterTokenTransfer(from, to, tokenId, 1);
    }

    /**
     * @dev Approve `to` to operate on `tokenId`
     *
     * Emits an {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 an {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 Reverts if the `tokenId` has not been minted yet.
     */
    function _requireMinted(uint256 tokenId) internal view virtual {
        require(_exists(tokenId), "ERC721: invalid token ID");
    }

    /**
     * @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 {
                    /// @solidity memory-safe-assembly
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        } else {
            return true;
        }
    }

    /**
     * @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
     * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
     * - When `from` is zero, the tokens will be minted for `to`.
     * - When `to` is zero, ``from``'s tokens will be burned.
     * - `from` and `to` are never both zero.
     * - `batchSize` is non-zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256, /* firstTokenId */
        uint256 batchSize
    ) internal virtual {
        if (batchSize > 1) {
            if (from != address(0)) {
                _balances[from] -= batchSize;
            }
            if (to != address(0)) {
                _balances[to] += batchSize;
            }
        }
    }

    /**
     * @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
     * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
     * - When `from` is zero, the tokens were minted for `to`.
     * - When `to` is zero, ``from``'s tokens were burned.
     * - `from` and `to` are never both zero.
     * - `batchSize` is non-zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(
        address from,
        address to,
        uint256 firstTokenId,
        uint256 batchSize
    ) 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[44] private __gap;
}

File 19 of 36 : ERC721BurnableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Burnable.sol)

pragma solidity ^0.8.0;

import "../ERC721Upgradeable.sol";
import "../../../utils/ContextUpgradeable.sol";
import "../../../proxy/utils/Initializable.sol";

/**
 * @title ERC721 Burnable Token
 * @dev ERC721 Token that can be burned (destroyed).
 */
abstract contract ERC721BurnableUpgradeable is Initializable, ContextUpgradeable, ERC721Upgradeable {
    function __ERC721Burnable_init() internal onlyInitializing {
    }

    function __ERC721Burnable_init_unchained() internal onlyInitializing {
    }
    /**
     * @dev Burns `tokenId`. See {ERC721-_burn}.
     *
     * Requirements:
     *
     * - The caller must own `tokenId` or be an approved operator.
     */
    function burn(uint256 tokenId) public virtual {
        //solhint-disable-next-line max-line-length
        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
        _burn(tokenId);
    }

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

File 20 of 36 : ERC721EnumerableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Enumerable.sol)

pragma solidity ^0.8.0;

import "../ERC721Upgradeable.sol";
import "./IERC721EnumerableUpgradeable.sol";
import "../../../proxy/utils/Initializable.sol";

/**
 * @dev This implements an optional extension of {ERC721} defined in the EIP that adds
 * enumerability of all the token ids in the contract as well as all token ids owned by each
 * account.
 */
abstract contract ERC721EnumerableUpgradeable is Initializable, ERC721Upgradeable, IERC721EnumerableUpgradeable {
    function __ERC721Enumerable_init() internal onlyInitializing {
    }

    function __ERC721Enumerable_init_unchained() internal onlyInitializing {
    }
    // Mapping from owner to list of owned token IDs
    mapping(address => mapping(uint256 => uint256)) private _ownedTokens;

    // Mapping from token ID to index of the owner tokens list
    mapping(uint256 => uint256) private _ownedTokensIndex;

    // Array with all token ids, used for enumeration
    uint256[] private _allTokens;

    // Mapping from token id to position in the allTokens array
    mapping(uint256 => uint256) private _allTokensIndex;

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

    /**
     * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
     */
    function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) {
        require(index < ERC721Upgradeable.balanceOf(owner), "ERC721Enumerable: owner index out of bounds");
        return _ownedTokens[owner][index];
    }

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

    /**
     * @dev See {IERC721Enumerable-tokenByIndex}.
     */
    function tokenByIndex(uint256 index) public view virtual override returns (uint256) {
        require(index < ERC721EnumerableUpgradeable.totalSupply(), "ERC721Enumerable: global index out of bounds");
        return _allTokens[index];
    }

    /**
     * @dev See {ERC721-_beforeTokenTransfer}.
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 firstTokenId,
        uint256 batchSize
    ) internal virtual override {
        super._beforeTokenTransfer(from, to, firstTokenId, batchSize);

        if (batchSize > 1) {
            // Will only trigger during construction. Batch transferring (minting) is not available afterwards.
            revert("ERC721Enumerable: consecutive transfers not supported");
        }

        uint256 tokenId = firstTokenId;

        if (from == address(0)) {
            _addTokenToAllTokensEnumeration(tokenId);
        } else if (from != to) {
            _removeTokenFromOwnerEnumeration(from, tokenId);
        }
        if (to == address(0)) {
            _removeTokenFromAllTokensEnumeration(tokenId);
        } else if (to != from) {
            _addTokenToOwnerEnumeration(to, tokenId);
        }
    }

    /**
     * @dev Private function to add a token to this extension's ownership-tracking data structures.
     * @param to address representing the new owner of the given token ID
     * @param tokenId uint256 ID of the token to be added to the tokens list of the given address
     */
    function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private {
        uint256 length = ERC721Upgradeable.balanceOf(to);
        _ownedTokens[to][length] = tokenId;
        _ownedTokensIndex[tokenId] = length;
    }

    /**
     * @dev Private function to add a token to this extension's token tracking data structures.
     * @param tokenId uint256 ID of the token to be added to the tokens list
     */
    function _addTokenToAllTokensEnumeration(uint256 tokenId) private {
        _allTokensIndex[tokenId] = _allTokens.length;
        _allTokens.push(tokenId);
    }

    /**
     * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that
     * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for
     * gas optimizations e.g. when performing a transfer operation (avoiding double writes).
     * This has O(1) time complexity, but alters the order of the _ownedTokens array.
     * @param from address representing the previous owner of the given token ID
     * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address
     */
    function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private {
        // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and
        // then delete the last slot (swap and pop).

        uint256 lastTokenIndex = ERC721Upgradeable.balanceOf(from) - 1;
        uint256 tokenIndex = _ownedTokensIndex[tokenId];

        // When the token to delete is the last token, the swap operation is unnecessary
        if (tokenIndex != lastTokenIndex) {
            uint256 lastTokenId = _ownedTokens[from][lastTokenIndex];

            _ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
            _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
        }

        // This also deletes the contents at the last position of the array
        delete _ownedTokensIndex[tokenId];
        delete _ownedTokens[from][lastTokenIndex];
    }

    /**
     * @dev Private function to remove a token from this extension's token tracking data structures.
     * This has O(1) time complexity, but alters the order of the _allTokens array.
     * @param tokenId uint256 ID of the token to be removed from the tokens list
     */
    function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private {
        // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and
        // then delete the last slot (swap and pop).

        uint256 lastTokenIndex = _allTokens.length - 1;
        uint256 tokenIndex = _allTokensIndex[tokenId];

        // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so
        // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding
        // an 'if' statement (like in _removeTokenFromOwnerEnumeration)
        uint256 lastTokenId = _allTokens[lastTokenIndex];

        _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
        _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index

        // This also deletes the contents at the last position of the array
        delete _allTokensIndex[tokenId];
        _allTokens.pop();
    }

    /**
     * @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[46] private __gap;
}

File 21 of 36 : IERC721EnumerableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol)

pragma solidity ^0.8.0;

import "../IERC721Upgradeable.sol";

/**
 * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
 * @dev See https://eips.ethereum.org/EIPS/eip-721
 */
interface IERC721EnumerableUpgradeable is IERC721Upgradeable {
    /**
     * @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);
}

File 22 of 36 : IERC721MetadataUpgradeable.sol
// 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);
}

File 23 of 36 : IERC721ReceiverUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (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 `IERC721Receiver.onERC721Received.selector`.
     */
    function onERC721Received(
        address operator,
        address from,
        uint256 tokenId,
        bytes calldata data
    ) external returns (bytes4);
}

File 24 of 36 : IERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (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`.
     *
     * 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;

    /**
     * @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 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: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
     * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
     * understand this adds an external call which potentially creates a reentrancy vulnerability.
     *
     * 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 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 the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) external view returns (address operator);

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

File 25 of 36 : AddressUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)

pragma solidity ^0.8.1;

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

        return account.code.length > 0;
    }

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

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

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

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

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

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

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

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

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

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

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

File 26 of 36 : Base64Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (utils/Base64.sol)

pragma solidity ^0.8.0;

/**
 * @dev Provides a set of functions to operate with Base64 strings.
 *
 * _Available since v4.5._
 */
library Base64Upgradeable {
    /**
     * @dev Base64 Encoding/Decoding Table
     */
    string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";

    /**
     * @dev Converts a `bytes` to its Bytes64 `string` representation.
     */
    function encode(bytes memory data) internal pure returns (string memory) {
        /**
         * Inspired by Brecht Devos (Brechtpd) implementation - MIT licence
         * https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol
         */
        if (data.length == 0) return "";

        // Loads the table into memory
        string memory table = _TABLE;

        // Encoding takes 3 bytes chunks of binary data from `bytes` data parameter
        // and split into 4 numbers of 6 bits.
        // The final Base64 length should be `bytes` data length multiplied by 4/3 rounded up
        // - `data.length + 2`  -> Round up
        // - `/ 3`              -> Number of 3-bytes chunks
        // - `4 *`              -> 4 characters for each chunk
        string memory result = new string(4 * ((data.length + 2) / 3));

        /// @solidity memory-safe-assembly
        assembly {
            // Prepare the lookup table (skip the first "length" byte)
            let tablePtr := add(table, 1)

            // Prepare result pointer, jump over length
            let resultPtr := add(result, 32)

            // Run over the input, 3 bytes at a time
            for {
                let dataPtr := data
                let endPtr := add(data, mload(data))
            } lt(dataPtr, endPtr) {

            } {
                // Advance 3 bytes
                dataPtr := add(dataPtr, 3)
                let input := mload(dataPtr)

                // To write each character, shift the 3 bytes (18 bits) chunk
                // 4 times in blocks of 6 bits for each character (18, 12, 6, 0)
                // and apply logical AND with 0x3F which is the number of
                // the previous character in the ASCII table prior to the Base64 Table
                // The result is then added to the table to get the character to write,
                // and finally write it in the result pointer but with a left shift
                // of 256 (1 byte) - 8 (1 ASCII char) = 248 bits

                mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance

                mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance

                mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance

                mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))
                resultPtr := add(resultPtr, 1) // Advance
            }

            // When data `bytes` is not exactly 3 bytes long
            // it is padded with `=` characters at the end
            switch mod(mload(data), 3)
            case 1 {
                mstore8(sub(resultPtr, 1), 0x3d)
                mstore8(sub(resultPtr, 2), 0x3d)
            }
            case 2 {
                mstore8(sub(resultPtr, 1), 0x3d)
            }
        }

        return result;
    }
}

File 27 of 36 : ContextUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;
import "../proxy/utils/Initializable.sol";

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

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

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

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

File 28 of 36 : ERC165Upgradeable.sol
// 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 {
    }

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

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

File 29 of 36 : IERC165Upgradeable.sol
// 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);
}

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

pragma solidity ^0.8.0;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

File 31 of 36 : StorageSlotUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (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) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

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

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

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

File 32 of 36 : StringsUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/MathUpgradeable.sol";

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

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

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

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

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

File 33 of 36 : EnumerableSetUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/structs/EnumerableSet.sol)
// This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.

pragma solidity ^0.8.0;

/**
 * @dev Library for managing
 * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
 * types.
 *
 * Sets have the following properties:
 *
 * - Elements are added, removed, and checked for existence in constant time
 * (O(1)).
 * - Elements are enumerated in O(n). No guarantees are made on the ordering.
 *
 * ```
 * contract Example {
 *     // Add the library methods
 *     using EnumerableSet for EnumerableSet.AddressSet;
 *
 *     // Declare a set state variable
 *     EnumerableSet.AddressSet private mySet;
 * }
 * ```
 *
 * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
 * and `uint256` (`UintSet`) are supported.
 *
 * [WARNING]
 * ====
 * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
 * unusable.
 * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
 *
 * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
 * array of EnumerableSet.
 * ====
 */
library EnumerableSetUpgradeable {
    // To implement this library for multiple types with as little code
    // repetition as possible, we write it in terms of a generic Set type with
    // bytes32 values.
    // The Set implementation uses private functions, and user-facing
    // implementations (such as AddressSet) are just wrappers around the
    // underlying Set.
    // This means that we can only create new EnumerableSets for types that fit
    // in bytes32.

    struct Set {
        // Storage of set values
        bytes32[] _values;
        // Position of the value in the `values` array, plus 1 because index 0
        // means a value is not in the set.
        mapping(bytes32 => uint256) _indexes;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function _add(Set storage set, bytes32 value) private returns (bool) {
        if (!_contains(set, value)) {
            set._values.push(value);
            // The value is stored at length-1, but we add 1 to all indexes
            // and use 0 as a sentinel value
            set._indexes[value] = set._values.length;
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function _remove(Set storage set, bytes32 value) private returns (bool) {
        // We read and store the value's index to prevent multiple reads from the same storage slot
        uint256 valueIndex = set._indexes[value];

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

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

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

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

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

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

            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function _contains(Set storage set, bytes32 value) private view returns (bool) {
        return set._indexes[value] != 0;
    }

    /**
     * @dev Returns the number of values on the set. O(1).
     */
    function _length(Set storage set) private view returns (uint256) {
        return set._values.length;
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function _at(Set storage set, uint256 index) private view returns (bytes32) {
        return set._values[index];
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function _values(Set storage set) private view returns (bytes32[] memory) {
        return set._values;
    }

    // Bytes32Set

    struct Bytes32Set {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
        return _add(set._inner, value);
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
        return _remove(set._inner, value);
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
        return _contains(set._inner, value);
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(Bytes32Set storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
        return _at(set._inner, index);
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
        bytes32[] memory store = _values(set._inner);
        bytes32[] memory result;

        /// @solidity memory-safe-assembly
        assembly {
            result := store
        }

        return result;
    }

    // AddressSet

    struct AddressSet {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(AddressSet storage set, address value) internal returns (bool) {
        return _add(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(AddressSet storage set, address value) internal returns (bool) {
        return _remove(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(AddressSet storage set, address value) internal view returns (bool) {
        return _contains(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(AddressSet storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(AddressSet storage set, uint256 index) internal view returns (address) {
        return address(uint160(uint256(_at(set._inner, index))));
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(AddressSet storage set) internal view returns (address[] memory) {
        bytes32[] memory store = _values(set._inner);
        address[] memory result;

        /// @solidity memory-safe-assembly
        assembly {
            result := store
        }

        return result;
    }

    // UintSet

    struct UintSet {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(UintSet storage set, uint256 value) internal returns (bool) {
        return _add(set._inner, bytes32(value));
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(UintSet storage set, uint256 value) internal returns (bool) {
        return _remove(set._inner, bytes32(value));
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(UintSet storage set, uint256 value) internal view returns (bool) {
        return _contains(set._inner, bytes32(value));
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(UintSet storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(UintSet storage set, uint256 index) internal view returns (uint256) {
        return uint256(_at(set._inner, index));
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(UintSet storage set) internal view returns (uint256[] memory) {
        bytes32[] memory store = _values(set._inner);
        uint256[] memory result;

        /// @solidity memory-safe-assembly
        assembly {
            result := store
        }

        return result;
    }
}

File 34 of 36 : A8BallCue.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.16;

import "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
import "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol";

import "@dirtycajunrice/contracts/token/ERC721/extensions/ERC721EnumerableV2.sol";
import "@dirtycajunrice/contracts/token/ERC721/extensions/ERC721URITokenJSON.sol";
import "@dirtycajunrice/contracts/token/ERC721/extensions/ERC721BurnableV2.sol";
import "@dirtycajunrice/contracts/token/ERC721/extensions/ERC721Capped.sol";
import "@dirtycajunrice/contracts/utils/access/StandardAccessControl.sol";
import "@dirtycajunrice/contracts/utils/structs/Attributes.sol";
import "@dirtycajunrice/contracts/utils/TokenMetadata.sol";

import "../I8BallCommon.sol";
import "./I8BallCue.sol";

/**
* @title Arcadian 8Ball Cue v1.0.0
* @author @DirtyCajunRice
*/
contract A8BallCue is Initializable, I8BallCue, ERC721EnumerableV2, ERC721BurnableV2, ERC721URITokenJSON,
StandardAccessControl, PausableUpgradeable, UUPSUpgradeable {
    using StringsUpgradeable for uint256;
    using Attributes for Attributes.AttributeStore;

    Attributes.AttributeStore private _attributes;

    /// @custom:oz-upgrades-unsafe-allow constructor
    constructor() {
        _disableInitializers();
    }

    function initialize() public initializer {
        __ERC721_init("8BallCue", "8BALLCUE");
        __ERC721EnumerableV2_init();
        __ERC721URITokenJSON_init("https://images.arcadian.game/8BallCue/");
        __Pausable_init();
        __StandardAccessControl_init();
        __ERC721BurnableV2_init();
        __UUPSUpgradeable_init();

        // core metadata
        _attributes.addTree(0, "Core Metadata");
        _attributes.addSkill(0, 0, "Collection");
    }

    function mint(address to, uint256 tokenId, Cue calldata cue) external onlyContract {
        _safeMint(to, tokenId);
        
        _attributes.setValue(tokenId, 0, 0, cue.collectionId);
        _attributes.setValue(tokenId, cue.collectionId, 0, block.timestamp);
        _attributes.setValue(tokenId, cue.collectionId, 1, uint256(cue.rarity));
        _attributes.setValue(tokenId, cue.collectionId, 2, cue.designId);
        _attributes.setValue(tokenId, cue.collectionId, 3, cue.power);
        _attributes.setValue(tokenId, cue.collectionId, 4, cue.accuracy);
        _attributes.setValue(tokenId, cue.collectionId, 5, cue.spin);
        _attributes.setValue(tokenId, cue.collectionId, 6, cue.time);
        
    }

    function upgradeCue(address owner, uint256 tokenId, Cue calldata cue) external onlyContract {
        require(_isApprovedOrOwner(owner, tokenId), "8BallCue::Not approved or owner");

        uint256 collectionId = _attributes.getValue(tokenId, 0, 0);

        _attributes.setValue(tokenId, collectionId, 3, cue.power);
        _attributes.setValue(tokenId, collectionId, 4, cue.accuracy);
        _attributes.setValue(tokenId, collectionId, 5, cue.spin);
        _attributes.setValue(tokenId, collectionId, 6, cue.time);
    }

    function maxLevel(Rarity rarity) public pure returns (uint256) {
        return rarity == Rarity.Common ? 5 : 6 + uint256(rarity);
    }

    function getCue(uint256 tokenId) public view returns (Cue memory) {
        uint256 collectionId = _attributes.getValue(tokenId, 0, 0);
        require(collectionId > 0, "8BallCue::Invalid Token ID");
        return Cue({
            rarity: Rarity(_attributes.getValue(tokenId, collectionId, 1)),
            collectionId: collectionId,
            designId: _attributes.getValue(tokenId, collectionId, 2),
            power: _attributes.getValue(tokenId, collectionId, 3),
            accuracy: _attributes.getValue(tokenId, collectionId, 4),
            spin: _attributes.getValue(tokenId, collectionId, 5),
            time: _attributes.getValue(tokenId, collectionId, 6)
        });
    }

    function tokenURIJSON(uint256 tokenId) public view override(ERC721URITokenJSON) returns(string memory) {
        uint256 collectionId = _attributes.getValue(tokenId, 0, 0);

        TokenMetadata.Attribute[] memory attributes = new TokenMetadata.Attribute[](7);

        attributes[0] = TokenMetadata.Attribute(
            _attributes.getSkillName(0, 0),
            '',
            _attributes.getTreeName(collectionId),
            false
        );
        attributes[1] = TokenMetadata.Attribute(
            _attributes.getSkillName(collectionId, 0),
            'date',
            _attributes.getValue(tokenId, collectionId, 0).toString(),
            true
        );
        attributes[2] = TokenMetadata.Attribute(
            _attributes.getSkillName(collectionId, 1),
            '',
            ["Common", "Uncommon", "Rare", "Epic", "Legendary"][_attributes.getValue(tokenId, collectionId, 1)],
            false
        );

        for (uint256 i = 3; i < 7; i++) {
            attributes[i] = TokenMetadata.Attribute(
                _attributes.getSkillName(collectionId, i),
                '',
                _attributes.getValue(tokenId, collectionId, i).toString(),
                true
            );
        }

        return makeMetadataJSON(
            tokenId,
            _attributes.getName(collectionId, 2, _attributes.getValue(tokenId, collectionId, 2)),
            'Crypto 8Ball Cue',
            attributes
        );
    }

    ///
    /// Contract
    ///
    function addCollection(uint256 collectionId, string memory name) external onlyContract {
        // treeId 0 is reserved for core metadata
        require(collectionId > 0, "8BallCue::Invalid collectionId");

        _attributes.addTree(collectionId, name);
        _attributes.addSkill(collectionId, 0, "Birthday");
        _attributes.addSkill(collectionId, 1, "Rarity");
        _attributes.addSkill(collectionId, 2, "Design");
        _attributes.addSkill(collectionId, 3, "Power");
        _attributes.addSkill(collectionId, 4, "Accuracy");
        _attributes.addSkill(collectionId, 5, "Spin");
        _attributes.addSkill(collectionId, 6, "Time");
    }

    function addCollectionDesigns(uint256 collectionId, Design[] memory designs) external onlyContract {
        for (uint256 i = 0; i < designs.length; i++) {
            _attributes.setName(collectionId, 2, designs[i].id, designs[i].name);
        }
    }
    ///
    /// Admin
    ///
    function setImageBaseUri(string memory _imageBaseURI) external onlyAdmin {
        imageBaseURI = _imageBaseURI;
    }

    ///
    /// Overrides
    ///
    function tokenURI(uint256 tokenId)
    public
    view
    virtual
    override(ERC721URITokenJSON, ERC721Upgradeable)
    returns(string memory) {
        return ERC721URITokenJSON.tokenURI(tokenId);
    }

    function imageURISuffix(
        uint256 tokenId
    ) internal view virtual override(ERC721URITokenJSON) returns (string memory) {
        uint256 collectionId = _attributes.getValue(tokenId, 0, 0);
        return string(
            abi.encodePacked(
                _attributes.getTreeName(collectionId), "/", _attributes.getValue(tokenId, collectionId, 2).toString()
            )
        );
    }

    function _safeMint(address to, uint256 tokenId) internal virtual override(ERC721Upgradeable) {
        super._safeMint(to, tokenId);
    }

    function _authorizeUpgrade(address newImplementation) internal override onlyAdmin {}

    function supportsInterface(bytes4 interfaceId)
    public
    view
    virtual
    override(AccessControlEnumerableUpgradeable, ERC721EnumerableV2, ERC721Upgradeable, IERC165Upgradeable)
    returns (bool)
    {
        return type(I8BallCue).interfaceId == interfaceId || super.supportsInterface(interfaceId);
    }

    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 firstTokenId,
        uint256 batchSize
    ) internal virtual override(ERC721EnumerableV2, ERC721Upgradeable) {
        super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
    }

}

File 35 of 36 : I8BallCue.sol
// SPDX-License-Identifier: GPL-3.0

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol";

import "../I8BallCommon.sol";

/**
* @title Arcadian 8Ball Cue Interface v1.0.0
* @author @DirtyCajunRice
*/
interface I8BallCue is IERC721Upgradeable, I8BallCommon {
    function mint(address to, uint256 tokenId, Cue calldata cue) external;
    function upgradeCue(address owner, uint256 tokenId, Cue calldata cue) external;
    function maxLevel(Rarity rarity) external pure returns (uint256);
    function addCollection(uint256 collectionId, string memory name) external;
    function addCollectionDesigns(uint256 collectionId, Design[] memory designs) external;

    function setImageBaseUri(string memory _imageBaseURI) external;
    function getCue(uint256 tokenId) external view returns (Cue memory);
}

File 36 of 36 : I8BallCommon.sol
// SPDX-License-Identifier: GPL-3.0

pragma solidity ^0.8.0;

import "@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol";

/**
* @title Arcadian 8Ball Common Interface v1.0.0
* @author @DirtyCajunRice
*/
interface I8BallCommon {
    enum Rarity { Common, Uncommon, Rare, Epic, Legendary }

    struct Design {
        Rarity rarity;
        uint256 id;
        uint256 remaining;
        string name;
    }

    struct Cue {
        Rarity rarity;
        uint256 collectionId;
        uint256 designId;
        uint256 power;
        uint256 accuracy;
        uint256 spin;
        uint256 time;
    }
}

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

Contract ABI

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"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":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","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"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"collectionId","type":"uint256"},{"internalType":"string","name":"name","type":"string"}],"name":"addCollection","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"collectionId","type":"uint256"},{"components":[{"internalType":"enum I8BallCommon.Rarity","name":"rarity","type":"uint8"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"remaining","type":"uint256"},{"internalType":"string","name":"name","type":"string"}],"internalType":"struct I8BallCommon.Design[]","name":"designs","type":"tuple[]"}],"name":"addCollectionDesigns","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","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":"tokenIds","type":"uint256[]"}],"name":"batchTokenURI","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"batchTokenURIJSON","outputs":[{"internalType":"string[]","name":"","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"batchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getAllTokenIds","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getCue","outputs":[{"components":[{"internalType":"enum I8BallCommon.Rarity","name":"rarity","type":"uint8"},{"internalType":"uint256","name":"collectionId","type":"uint256"},{"internalType":"uint256","name":"designId","type":"uint256"},{"internalType":"uint256","name":"power","type":"uint256"},{"internalType":"uint256","name":"accuracy","type":"uint256"},{"internalType":"uint256","name":"spin","type":"uint256"},{"internalType":"uint256","name":"time","type":"uint256"}],"internalType":"struct I8BallCommon.Cue","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"imageBaseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initialize","outputs":[],"stateMutability":"nonpayable","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":[{"internalType":"enum I8BallCommon.Rarity","name":"rarity","type":"uint8"}],"name":"maxLevel","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"components":[{"internalType":"enum I8BallCommon.Rarity","name":"rarity","type":"uint8"},{"internalType":"uint256","name":"collectionId","type":"uint256"},{"internalType":"uint256","name":"designId","type":"uint256"},{"internalType":"uint256","name":"power","type":"uint256"},{"internalType":"uint256","name":"accuracy","type":"uint256"},{"internalType":"uint256","name":"spin","type":"uint256"},{"internalType":"uint256","name":"time","type":"uint256"}],"internalType":"struct I8BallCommon.Cue","name":"cue","type":"tuple"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","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":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","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":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_imageBaseURI","type":"string"}],"name":"setImageBaseUri","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":"owner","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":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURIJSON","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"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"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"components":[{"internalType":"enum I8BallCommon.Rarity","name":"rarity","type":"uint8"},{"internalType":"uint256","name":"collectionId","type":"uint256"},{"internalType":"uint256","name":"designId","type":"uint256"},{"internalType":"uint256","name":"power","type":"uint256"},{"internalType":"uint256","name":"accuracy","type":"uint256"},{"internalType":"uint256","name":"spin","type":"uint256"},{"internalType":"uint256","name":"time","type":"uint256"}],"internalType":"struct I8BallCommon.Cue","name":"cue","type":"tuple"}],"name":"upgradeCue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"}],"name":"upgradeTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"}]

60a0604052306080523480156200001557600080fd5b506200002062000026565b620000e8565b600054610100900460ff1615620000935760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161015620000e6576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b60805161561e6200012060003960008181611058015281816110980152818161121a0152818161125a015261137c015261561e6000f3fe6080604052600436106102675760003560e01c80635d93d6a411610144578063a22cb465116100b6578063d547741f1161007a578063d547741f1461073e578063e985e9c51461075e578063f3993d11146107a7578063fd2de539146107c7578063fd80e45a146107e7578063fe459f5c1461080757600080fd5b8063a22cb465146106a9578063b88d4fde146106c9578063bdbed722146106e9578063c87b56dd146106fe578063ca15c8731461071e57600080fd5b80638129fc1c116101085780638129fc1c146105fd5780638462151c146106125780639010d07c1461063f57806391d148541461065f57806395d89b411461067f578063a217fddf1461069457600080fd5b80635d93d6a4146105685780636352211e146105885780636d94f13a146105a857806370a08231146105c857806377645839146105e857600080fd5b80632f745c59116101dd57806342842e0e116101a157806342842e0e146104c757806342966c68146104e75780634f1ef286146105075780634f6ccce71461051a57806352d1902d1461053a5780635c975abb1461054f57600080fd5b80632f745c591461041a57806334985b991461043a57806336568abe146104675780633659cfe61461048757806339b92bbb146104a757600080fd5b8063095ea7b31161022f578063095ea7b31461033d57806318160ddd1461035d57806323b872dd1461037c578063248a9ca31461039c5780632c303493146103cd5780632f2ff15d146103fa57600080fd5b8063014979f61461026c57806301e65df11461028e57806301ffc9a7146102ae57806306fdde03146102e3578063081812fc14610305575b600080fd5b34801561027857600080fd5b5061028c61028736600461445c565b610827565b005b34801561029a57600080fd5b5061028c6102a93660046144be565b6109ec565b3480156102ba57600080fd5b506102ce6102c936600461451d565b610ae7565b60405190151581526020015b60405180910390f35b3480156102ef57600080fd5b506102f8610b12565b6040516102da919061458a565b34801561031157600080fd5b5061032561032036600461459d565b610ba4565b6040516001600160a01b0390911681526020016102da565b34801561034957600080fd5b5061028c6103583660046145b6565b610bcb565b34801561036957600080fd5b506099545b6040519081526020016102da565b34801561038857600080fd5b5061028c6103973660046145e0565b610cdb565b3480156103a857600080fd5b5061036e6103b736600461459d565b6000908152610192602052604090206001015490565b3480156103d957600080fd5b506103ed6103e83660046146aa565b610d0c565b6040516102da91906146de565b34801561040657600080fd5b5061028c610415366004614740565b610dc4565b34801561042657600080fd5b5061036e6104353660046145b6565b610dea565b34801561044657600080fd5b5061045a61045536600461459d565b610e80565b6040516102da9190614782565b34801561047357600080fd5b5061028c610482366004614740565b610fd4565b34801561049357600080fd5b5061028c6104a23660046147ed565b61104e565b3480156104b357600080fd5b5061028c6104c2366004614808565b61112d565b3480156104d357600080fd5b5061028c6104e23660046145e0565b611163565b3480156104f357600080fd5b5061028c61050236600461459d565b61117e565b61028c61051536600461483c565b611210565b34801561052657600080fd5b5061036e61053536600461459d565b6112dc565b34801561054657600080fd5b5061036e61136f565b34801561055b57600080fd5b506102245460ff166102ce565b34801561057457600080fd5b5061036e610583366004614882565b611422565b34801561059457600080fd5b506103256105a336600461459d565b611466565b3480156105b457600080fd5b506103ed6105c336600461489d565b6114c6565b3480156105d457600080fd5b5061036e6105e33660046147ed565b61157c565b3480156105f457600080fd5b506102f8611602565b34801561060957600080fd5b5061028c611691565b34801561061e57600080fd5b5061063261062d3660046147ed565b611893565b6040516102da9190614911565b34801561064b57600080fd5b5061032561065a366004614955565b61192c565b34801561066b57600080fd5b506102ce61067a366004614740565b61194c565b34801561068b57600080fd5b506102f8611978565b3480156106a057600080fd5b5061036e600081565b3480156106b557600080fd5b5061028c6106c4366004614977565b611987565b3480156106d557600080fd5b5061028c6106e43660046149b3565b611992565b3480156106f557600080fd5b506106326119ca565b34801561070a57600080fd5b506102f861071936600461459d565b611ad2565b34801561072a57600080fd5b5061036e61073936600461459d565b611add565b34801561074a57600080fd5b5061028c610759366004614740565b611af5565b34801561076a57600080fd5b506102ce610779366004614a1a565b6001600160a01b039182166000908152606a6020908152604080832093909416825291909152205460ff1690565b3480156107b357600080fd5b5061028c6107c2366004614a44565b611b1b565b3480156107d357600080fd5b5061028c6107e2366004614aa1565b611b5d565b3480156107f357600080fd5b5061028c6108023660046144be565b611be8565b34801561081357600080fd5b506102f861082236600461459d565b611cb7565b61083e6000805160206155c9833981519152612013565b600082116108935760405162461bcd60e51b815260206004820152601e60248201527f3842616c6c4375653a3a496e76616c696420636f6c6c656374696f6e4964000060448201526064015b60405180910390fd5b6108a06102ba838361201d565b604080518082019091526008815267426972746864617960c01b60208201526108d1906102ba908490600090612097565b60408051808201909152600681526552617269747960d01b6020820152610900906102ba908490600190612097565b6040805180820190915260068152652232b9b4b3b760d11b602082015261092f906102ba908490600290612097565b6040805180820190915260058152642837bbb2b960d91b602082015261095d906102ba908490600390612097565b604080518082019091526008815267416363757261637960c01b602082015261098e906102ba908490600490612097565b60408051808201909152600481526329b834b760e11b60208201526109bb906102ba908490600590612097565b60408051808201909152600481526354696d6560e01b60208201526109e8906102ba908490600690612097565b5050565b610a036000805160206155c9833981519152612013565b610a0d838361215a565b610a216102ba836000806020860135612164565b610a356102ba836020840135600042612164565b610a6a8260208301803590600190610a4d9086614882565b6004811115610a5e57610a5e61476c565b6102ba93929190612164565b610a826102ba83602084013560026040860135612164565b610a9a6102ba83602084013560036060860135612164565b610ab26102ba83602084013560046080860135612164565b610aca6102ba836020840135600560a0860135612164565b610ae26102ba836020840135600660c0860135612164565b505050565b600063285841f160e11b6001600160e01b031983161480610b0c5750610b0c826121e6565b92915050565b606060658054610b2190614bb7565b80601f0160208091040260200160405190810160405280929190818152602001828054610b4d90614bb7565b8015610b9a5780601f10610b6f57610100808354040283529160200191610b9a565b820191906000526020600020905b815481529060010190602001808311610b7d57829003601f168201915b5050505050905090565b6000610baf8261220b565b506000908152606960205260409020546001600160a01b031690565b6000610bd682611466565b9050806001600160a01b0316836001600160a01b031603610c435760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b606482015260840161088a565b336001600160a01b0382161480610c5f5750610c5f8133610779565b610cd15760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c000000606482015260840161088a565b610ae2838361226a565b610ce533826122d8565b610d015760405162461bcd60e51b815260040161088a90614bf1565b610ae2838383612356565b6060600082516001600160401b03811115610d2957610d2961437f565b604051908082528060200260200182016040528015610d5c57816020015b6060815260200190600190039081610d475790505b50905060005b8351811015610dbd57610d8d848281518110610d8057610d80614c3e565b6020026020010151611cb7565b828281518110610d9f57610d9f614c3e565b60200260200101819052508080610db590614c6a565b915050610d62565b5092915050565b60008281526101926020526040902060010154610de081612013565b610ae283836124c7565b6000610df58361157c565b8210610e575760405162461bcd60e51b815260206004820152602b60248201527f455243373231456e756d657261626c653a206f776e657220696e646578206f7560448201526a74206f6620626f756e647360a81b606482015260840161088a565b506001600160a01b03919091166000908152609760209081526040808320938352929052205490565b610ec16040805160e0810190915280600081526020016000815260200160008152602001600081526020016000815260200160008152602001600081525090565b6000610ed16102ba8483806124ea565b905060008111610f235760405162461bcd60e51b815260206004820152601a60248201527f3842616c6c4375653a3a496e76616c696420546f6b656e204944000000000000604482015260640161088a565b6040805160e0810190915280610f3e6102ba868560016124ea565b6004811115610f4f57610f4f61476c565b6004811115610f6057610f6061476c565b815260208101839052604001610f7b6102ba868560026124ea565b8152602001610f8f6102ba868560036124ea565b8152602001610fa36102ba868560046124ea565b8152602001610fb76102ba868560056124ea565b8152602001610fcb6102ba868560066124ea565b90529392505050565b6001600160a01b03811633146110445760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b606482015260840161088a565b6109e88282612573565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036110965760405162461bcd60e51b815260040161088a90614c83565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166110df60008051602061551c833981519152546001600160a01b031690565b6001600160a01b0316146111055760405162461bcd60e51b815260040161088a90614ccf565b61110e81612596565b6040805160008082526020820190925261112a918391906125bf565b50565b6111567fa49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775612013565b6101606109e88282614d61565b610ae283838360405180602001604052806000815250611992565b61118833826122d8565b6111fa5760405162461bcd60e51b815260206004820152603860248201527f4552433732314275726e61626c6556323a2063616c6c6572206973206e6f742060448201527f746f6b656e206f776e6572206e6f7220617070726f7665640000000000000000606482015260840161088a565b61120661012d8261272a565b5061112a81612736565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036112585760405162461bcd60e51b815260040161088a90614c83565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166112a160008051602061551c833981519152546001600160a01b031690565b6001600160a01b0316146112c75760405162461bcd60e51b815260040161088a90614ccf565b6112d082612596565b6109e8828260016125bf565b60006112e760995490565b821061134a5760405162461bcd60e51b815260206004820152602c60248201527f455243373231456e756d657261626c653a20676c6f62616c20696e646578206f60448201526b7574206f6620626f756e647360a01b606482015260840161088a565b6099828154811061135d5761135d614c3e565b90600052602060002001549050919050565b6000306001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161461140f5760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c0000000000000000606482015260840161088a565b5060008051602061551c83398151915290565b6000808260048111156114375761143761476c565b1461145e5781600481111561144e5761144e61476c565b611459906006614e20565b610b0c565b600592915050565b6000818152606760205260408120546001600160a01b031680610b0c5760405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604482015260640161088a565b60606000826001600160401b038111156114e2576114e261437f565b60405190808252806020026020018201604052801561151557816020015b60608152602001906001900390816115005790505b50905060005b838110156115745761154485858381811061153857611538614c3e565b90506020020135611ad2565b82828151811061155657611556614c3e565b6020026020010181905250808061156c90614c6a565b91505061151b565b509392505050565b60006001600160a01b0382166115e65760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b606482015260840161088a565b506001600160a01b031660009081526068602052604090205490565b610160805461161090614bb7565b80601f016020809104026020016040519081016040528092919081815260200182805461163c90614bb7565b80156116895780601f1061165e57610100808354040283529160200191611689565b820191906000526020600020905b81548152906001019060200180831161166c57829003601f168201915b505050505081565b600054610100900460ff16158080156116b15750600054600160ff909116105b806116cb5750303b1580156116cb575060005460ff166001145b61172e5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161088a565b6000805460ff191660011790558015611751576000805461ff0019166101001790555b61179b604051806040016040528060088152602001673842616c6c43756560c01b815250604051806040016040528060088152602001673842414c4c43554560c01b8152506127d9565b6117a361280a565b6117c46040518060600160405280602681526020016155a36026913961283b565b6117cc612862565b6117d4612891565b6117dc61280a565b6117e461298b565b60408051808201909152600d81526c436f7265204d6574616461746160981b6020820152611818906102ba9060009061201d565b60408051808201909152600a81526921b7b63632b1ba34b7b760b11b602082015261184b906102ba906000908190612097565b801561112a576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a150565b606060006118a08361157c565b90506000816001600160401b038111156118bc576118bc61437f565b6040519080825280602002602001820160405280156118e5578160200160208202803683370190505b50905060005b82811015611574576118fd8582610dea565b82828151811061190f5761190f614c3e565b60209081029190910101528061192481614c6a565b9150506118eb565b60008281526101c46020526040812061194590836129b2565b9392505050565b6000918252610192602090815260408084206001600160a01b0393909316845291905290205460ff1690565b606060668054610b2190614bb7565b6109e83383836129be565b61199c33836122d8565b6119b85760405162461bcd60e51b815260040161088a90614bf1565b6119c484848484612a8c565b50505050565b6060600060015b612710811015611a18576000818152606760205260409020546001600160a01b031615611a065781611a0281614c6a565b9250505b80611a1081614c6a565b9150506119d1565b506000816001600160401b03811115611a3357611a3361437f565b604051908082528060200260200182016040528015611a5c578160200160208202803683370190505b509050600060015b612710811015611ac9576000818152606760205260409020546001600160a01b031615611ab75780838381518110611a9e57611a9e614c3e565b602090810291909101015281611ab381614c6a565b9250505b80611ac181614c6a565b915050611a64565b50909392505050565b6060610b0c82612abf565b60008181526101c460205260408120610b0c90612ad2565b60008281526101926020526040902060010154611b1181612013565b610ae28383612573565b60005b81518110156119c457611b4b8484848481518110611b3e57611b3e614c3e565b6020026020010151610cdb565b80611b5581614c6a565b915050611b1e565b611b746000805160206155c9833981519152612013565b60005b8151811015610ae257611bd6836002848481518110611b9857611b98614c3e565b602002602001015160200151858581518110611bb657611bb6614c3e565b6020026020010151606001516102ba612adc90949392919063ffffffff16565b80611be081614c6a565b915050611b77565b611bff6000805160206155c9833981519152612013565b611c0983836122d8565b611c555760405162461bcd60e51b815260206004820152601f60248201527f3842616c6c4375653a3a4e6f7420617070726f766564206f72206f776e657200604482015260640161088a565b6000611c656102ba8483806124ea565b9050611c7b6102ba848360036060870135612164565b611c8f6102ba848360046080870135612164565b611ca36102ba8483600560a0870135612164565b6119c46102ba8483600660c0870135612164565b60606000611cc96102ba8483806124ea565b604080516007808252610100820190925291925060009190816020015b611d1360405180608001604052806060815260200160608152602001606081526020016000151581525090565b815260200190600190039081611ce6575050604080516080810190915290915080611d426102ba600080612b6d565b815260408051602081810183526000825283015201611d636102ba85612c78565b81526020016000151581525081600081518110611d8257611d82614c3e565b6020908102919091010152604080516080810190915280611da76102ba856000612b6d565b815260408051808201825260048152636461746560e01b60208281019190915283015201611de2611ddd6102ba888760006124ea565b612d41565b81526020016001151581525081600181518110611e0157611e01614c3e565b6020908102919091010152604080516080810190915280611e266102ba856001612b6d565b815260408051602081810183526000825280840191909152815160e081018352600660a082019081526521b7b6b6b7b760d11b60c083015281528251808401845260088152672ab731b7b6b6b7b760c11b8184015281830152825180840184526004808252635261726560e01b828501528285019190915283518085018552908152634570696360e01b8184015260608201528251808401845260098152684c6567656e6461727960b81b928101929092526080810191909152910190611ef26102ba888760016124ea565b60058110611f0257611f02614c3e565b602002015181526020016000151581525081600281518110611f2657611f26614c3e565b602090810291909101015260035b6007811015611fb857604080516080810190915280611f566102ba8685612b6d565b815260408051602081810183526000825283015201611f7c611ddd6102ba8988876124ea565b815260200160011515815250828281518110611f9a57611f9a614c3e565b60200260200101819052508080611fb090614c6a565b915050611f34565b5061200b84611fdc846002611fd16102ba8584846124ea565b6102ba929190612dd3565b6040518060400160405280601081526020016f43727970746f203842616c6c2043756560801b81525084612ee7565b949350505050565b61112a8133612f41565b612027838361272a565b61207d5760405162461bcd60e51b815260206004820152602160248201527f417474726962757465733a3a54726565496420616c72656164792065786973746044820152607360f81b606482015260840161088a565b600082815260068401602052604090206119c48282614d61565b6120a18484612f9a565b6120bd5760405162461bcd60e51b815260040161088a90614e33565b600083815260028501602052604090206120d7908361272a565b61212e5760405162461bcd60e51b815260206004820152602260248201527f417474726962757465733a3a536b696c6c496420616c72656164792065786973604482015261747360f01b606482015260840161088a565b6000838152600585016020908152604080832085845290915290206121538282614d61565b5050505050565b6109e88282612fb2565b61216e8584612f9a565b61218a5760405162461bcd60e51b815260040161088a90614e33565b600083815260028601602052604090206121a49083612f9a565b6121c05760405162461bcd60e51b815260040161088a90614e6a565b600093845260039094016020908152604080852093855292815282842091845252902055565b60006001600160e01b03198216635a05180f60e01b1480610b0c5750610b0c82612fcc565b6000818152606760205260409020546001600160a01b031661112a5760405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604482015260640161088a565b600081815260696020526040902080546001600160a01b0319166001600160a01b038416908117909155819061229f82611466565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000806122e483611466565b9050806001600160a01b0316846001600160a01b0316148061232b57506001600160a01b038082166000908152606a602090815260408083209388168352929052205460ff165b8061200b5750836001600160a01b031661234484610ba4565b6001600160a01b031614949350505050565b826001600160a01b031661236982611466565b6001600160a01b03161461238f5760405162461bcd60e51b815260040161088a90614e9f565b6001600160a01b0382166123f15760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b606482015260840161088a565b6123fe8383836001612ff1565b826001600160a01b031661241182611466565b6001600160a01b0316146124375760405162461bcd60e51b815260040161088a90614e9f565b600081815260696020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260688552838620805460001901905590871680865283862080546001019055868652606790945282852080549092168417909155905184937fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b6124d18282612ffd565b60008281526101c460205260409020610ae29082613084565b60006124f68584612f9a565b6125125760405162461bcd60e51b815260040161088a90614e33565b6000838152600286016020526040902061252c9083612f9a565b6125485760405162461bcd60e51b815260040161088a90614e6a565b5060009283526003939093016020908152604080842092845291815281832093835292909252205490565b61257d8282613099565b60008281526101c460205260409020610ae29082613101565b61112a7fa49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775612013565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156125f257610ae283613116565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa92505050801561264c575060408051601f3d908101601f1916820190925261264991810190614ee4565b60015b6126af5760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b606482015260840161088a565b60008051602061551c833981519152811461271e5760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b606482015260840161088a565b50610ae28383836131b2565b600061194583836131d7565b600061274182611466565b9050612751816000846001612ff1565b61275a82611466565b600083815260696020908152604080832080546001600160a01b03199081169091556001600160a01b0385168085526068845282852080546000190190558785526067909352818420805490911690555192935084927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a45050565b600054610100900460ff166128005760405162461bcd60e51b815260040161088a90614efd565b6109e88282613226565b600054610100900460ff166128315760405162461bcd60e51b815260040161088a90614efd565b61283961298b565b565b600054610100900460ff166111565760405162461bcd60e51b815260040161088a90614efd565b600054610100900460ff166128895760405162461bcd60e51b815260040161088a90614efd565b612839613266565b600054610100900460ff166128b85760405162461bcd60e51b815260040161088a90614efd565b6128c061298b565b6128cb6000336124c7565b6128f57fa49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775336124c7565b61290d6000805160206155c9833981519152336124c7565b6129377f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6336124c7565b6129617ff18b77e1ef402111bacb54bd5e03494cbdba92fbd1bd3bbcc1ce77e69b42ea6c336124c7565b6128397f52ba824bfabc2bcfcdf7f0edbb486ebb05e1836c90e78047efeb949990f72e5f336124c7565b600054610100900460ff166128395760405162461bcd60e51b815260040161088a90614efd565b6000611945838361329a565b816001600160a01b0316836001600160a01b031603612a1f5760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c657200000000000000604482015260640161088a565b6001600160a01b038381166000818152606a6020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b612a97848484612356565b612aa3848484846132c4565b6119c45760405162461bcd60e51b815260040161088a90614f48565b6060610b0c612acd83611cb7565b6133c2565b6000610b0c825490565b612ae68585612f9a565b612b025760405162461bcd60e51b815260040161088a90614e33565b60008481526002860160205260409020612b1c9084612f9a565b612b385760405162461bcd60e51b815260040161088a90614e6a565b6000848152600486016020908152604080832086845282528083208584529091529020612b658282614d61565b505050505050565b6060612b798484612f9a565b612b955760405162461bcd60e51b815260040161088a90614e33565b60008381526002850160205260409020612baf9083612f9a565b612bcb5760405162461bcd60e51b815260040161088a90614e6a565b6000838152600585016020908152604080832085845290915290208054612bf190614bb7565b80601f0160208091040260200160405190810160405280929190818152602001828054612c1d90614bb7565b8015612c6a5780601f10612c3f57610100808354040283529160200191612c6a565b820191906000526020600020905b815481529060010190602001808311612c4d57829003601f168201915b505050505090509392505050565b6060612c848383612f9a565b612ca05760405162461bcd60e51b815260040161088a90614e33565b600082815260068401602052604090208054612cbb90614bb7565b80601f0160208091040260200160405190810160405280929190818152602001828054612ce790614bb7565b8015612d345780601f10612d0957610100808354040283529160200191612d34565b820191906000526020600020905b815481529060010190602001808311612d1757829003601f168201915b5050505050905092915050565b60606000612d4e836133f3565b60010190506000816001600160401b03811115612d6d57612d6d61437f565b6040519080825280601f01601f191660200182016040528015612d97576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a8504945084612da157509392505050565b6060612ddf8585612f9a565b612dfb5760405162461bcd60e51b815260040161088a90614e33565b60008481526002860160205260409020612e159084612f9a565b612e315760405162461bcd60e51b815260040161088a90614e6a565b60008481526004860160209081526040808320868452825280832085845290915290208054612e5f90614bb7565b80601f0160208091040260200160405190810160405280929190818152602001828054612e8b90614bb7565b8015612ed85780601f10612ead57610100808354040283529160200191612ed8565b820191906000526020600020905b815481529060010190602001808311612ebb57829003601f168201915b50505050509050949350505050565b60606000612ef486611466565b90506000610160612f04886134cb565b604051602001612f15929190614fb6565b6040516020818303038152906040529050612f36878388848960028a613525565b979650505050505050565b612f4b828261194c565b6109e857612f5881613571565b612f63836020613583565b604051602001612f7492919061503d565b60408051601f198184030181529082905262461bcd60e51b825261088a9160040161458a565b60008181526001830160205260408120541515611945565b6109e882826040518060200160405280600081525061371e565b60006001600160e01b03198216637965db0b60e01b1480610b0c5750610b0c82613751565b6119c48484848461375c565b613007828261194c565b6109e8576000828152610192602090815260408083206001600160a01b03851684529091529020805460ff191660011790556130403390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000611945836001600160a01b0384166131d7565b6130a3828261194c565b156109e8576000828152610192602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000611945836001600160a01b038416613768565b6001600160a01b0381163b6131835760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b606482015260840161088a565b60008051602061551c83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6131bb8361385b565b6000825111806131c85750805b15610ae2576119c4838361389b565b600081815260018301602052604081205461321e57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610b0c565b506000610b0c565b600054610100900460ff1661324d5760405162461bcd60e51b815260040161088a90614efd565b60656132598382614d61565b506066610ae28282614d61565b600054610100900460ff1661328d5760405162461bcd60e51b815260040161088a90614efd565b610224805460ff19169055565b60008260000182815481106132b1576132b1614c3e565b9060005260206000200154905092915050565b60006001600160a01b0384163b156133ba57604051630a85bd0160e11b81526001600160a01b0385169063150b7a02906133089033908990889088906004016150b2565b6020604051808303816000875af1925050508015613343575060408051601f3d908101601f19168201909252613340918101906150ef565b60015b6133a0573d808015613371576040519150601f19603f3d011682016040523d82523d6000602084013e613376565b606091505b5080516000036133985760405162461bcd60e51b815260040161088a90614f48565b805181602001fd5b6001600160e01b031916630a85bd0160e11b14905061200b565b50600161200b565b60606133cd8261398f565b6040516020016133dd919061510c565b6040516020818303038152906040529050919050565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b83106134325772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef8100000000831061345e576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc10000831061347c57662386f26fc10000830492506010015b6305f5e1008310613494576305f5e100830492506008015b61271083106134a857612710830492506004015b606483106134ba576064830492506002015b600a8310610b0c5760010192915050565b606060006134dd6102ba8483806124ea565b90506134eb6102ba82612c78565b6134fd611ddd6102ba868560026124ea565b60405160200161350e929190615151565b604051602081830303815290604052915050919050565b60606000613537898989898989613ae1565b90508061354384613b4b565b60405160200161355492919061518d565b604051602081830303815290604052915050979650505050505050565b6060610b0c6001600160a01b03831660145b606060006135928360026151da565b61359d906002614e20565b6001600160401b038111156135b4576135b461437f565b6040519080825280601f01601f1916602001820160405280156135de576020820181803683370190505b509050600360fc1b816000815181106135f9576135f9614c3e565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061362857613628614c3e565b60200101906001600160f81b031916908160001a905350600061364c8460026151da565b613657906001614e20565b90505b60018111156136cf576f181899199a1a9b1b9c1cb0b131b232b360811b85600f166010811061368b5761368b614c3e565b1a60f81b8282815181106136a1576136a1614c3e565b60200101906001600160f81b031916908160001a90535060049490941c936136c8816151f9565b905061365a565b5083156119455760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e74604482015260640161088a565b6137288383613d3f565b61373560008484846132c4565b610ae25760405162461bcd60e51b815260040161088a90614f48565b6000610b0c82613ed8565b6119c484848484613efd565b6000818152600183016020526040812054801561385157600061378c600183615210565b85549091506000906137a090600190615210565b90508181146138055760008660000182815481106137c0576137c0614c3e565b90600052602060002001549050808760000184815481106137e3576137e3614c3e565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061381657613816615223565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610b0c565b6000915050610b0c565b61386481613116565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606001600160a01b0383163b6139035760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b606482015260840161088a565b600080846001600160a01b03168460405161391e9190615239565b600060405180830381855af49150503d8060008114613959576040519150601f19603f3d011682016040523d82523d6000602084013e61395e565b606091505b5091509150613986828260405180606001604052806027815260200161557c60279139614036565b95945050505050565b606081516000036139ae57505060408051602081019091526000815290565b600060405180606001604052806040815260200161553c60409139905060006003845160026139dd9190614e20565b6139e79190615255565b6139f29060046151da565b6001600160401b03811115613a0957613a0961437f565b6040519080825280601f01601f191660200182016040528015613a33576020820181803683370190505b509050600182016020820185865187015b80821015613a9f576003820191508151603f8160121c168501518453600184019350603f81600c1c168501518453600184019350603f8160061c168501518453600184019350603f8116850151845350600183019250613a44565b5050600386510660018114613abb5760028114613ace57613ad6565b603d6001830353603d6002830353613ad6565b603d60018303535b509195945050505050565b606084613aed88612d41565b8486613b018a6001600160a01b0316613571565b613b1b876002811115613b1657613b1661476c565b61404f565b604051602001613b3096959493929190615277565b60405160208183030381529060405290509695505050505050565b60408051602081019091526000808252606091905b8351811015613d2d57600060018551613b799190615210565b8214613b9e57604051806040016040528060018152602001600b60fa1b815250613baf565b604051806020016040528060008152505b90506000858381518110613bc557613bc5614c3e565b602002602001015160600151613bf457604051806040016040528060018152602001601160f91b815250613c05565b604051806020016040528060008152505b9050600081878581518110613c1c57613c1c614c3e565b60200260200101516040015183604051602001613c3b93929190615396565b60405160208183030381529060405290506000878581518110613c6057613c60614c3e565b60200260200101516020015151600014613cb657878581518110613c8657613c86614c3e565b602002602001015160200151604051602001613ca291906153d9565b604051602081830303815290604052613cc7565b604051806020016040528060008152505b9050600086898781518110613cde57613cde614c3e565b602002602001015160000151838588604051602001613d0195949392919061541e565b604051602081830303815290604052905080965050505050508080613d2590614c6a565b915050613b60565b508060405160200161350e91906154d9565b6001600160a01b038216613d955760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f2061646472657373604482015260640161088a565b6000818152606760205260409020546001600160a01b031615613dfa5760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000604482015260640161088a565b613e08600083836001612ff1565b6000818152606760205260409020546001600160a01b031615613e6d5760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000604482015260640161088a565b6001600160a01b038216600081815260686020908152604080832080546001019055848352606790915280822080546001600160a01b0319168417905551839291907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b60006001600160e01b0319821663780e9d6360e01b1480610b0c5750610b0c826140ed565b613f098484848461413d565b6001811115613f785760405162461bcd60e51b815260206004820152603560248201527f455243373231456e756d657261626c653a20636f6e7365637574697665207472604482015274185b9cd9995c9cc81b9bdd081cdd5c1c1bdc9d1959605a1b606482015260840161088a565b816001600160a01b038516613fd457613fcf81609980546000838152609a60205260408120829055600182018355919091527f72a152ddfb8e864297c917af52ea6c1c68aead0fee1a62673fcc7e0c94979d000155565b613ff7565b836001600160a01b0316856001600160a01b031614613ff757613ff785826141c5565b6001600160a01b0384166140135761400e81614262565b612153565b846001600160a01b0316846001600160a01b031614612153576121538482614311565b60608315614045575081611945565b6119458383614355565b606060028260028111156140655761406561476c565b146140cb57600182600281111561407e5761407e61476c565b146140a65760405180604001604052806005815260200164045524332360dc1b815250610b0c565b604051806040016040528060078152602001664552433131353560c81b815250610b0c565b505060408051808201909152600681526545524337323160d01b602082015290565b60006001600160e01b031982166380ac58cd60e01b148061411e57506001600160e01b03198216635b5e139f60e01b145b80610b0c57506301ffc9a760e01b6001600160e01b0319831614610b0c565b60018111156119c4576001600160a01b03841615614183576001600160a01b0384166000908152606860205260408120805483929061417d908490615210565b90915550505b6001600160a01b038316156119c4576001600160a01b038316600090815260686020526040812080548392906141ba908490614e20565b909155505050505050565b600060016141d28461157c565b6141dc9190615210565b60008381526098602052604090205490915080821461422f576001600160a01b03841660009081526097602090815260408083208584528252808320548484528184208190558352609890915290208190555b5060009182526098602090815260408084208490556001600160a01b039094168352609781528383209183525290812055565b60995460009061427490600190615210565b6000838152609a60205260408120546099805493945090928490811061429c5761429c614c3e565b9060005260206000200154905080609983815481106142bd576142bd614c3e565b6000918252602080832090910192909255828152609a909152604080822084905585825281205560998054806142f5576142f5615223565b6001900381819060005260206000200160009055905550505050565b600061431c8361157c565b6001600160a01b039093166000908152609760209081526040808320868452825280832085905593825260989052919091209190915550565b8151156143655781518083602001fd5b8060405162461bcd60e51b815260040161088a919061458a565b634e487b7160e01b600052604160045260246000fd5b604051608081016001600160401b03811182821017156143b7576143b761437f565b60405290565b604051601f8201601f191681016001600160401b03811182821017156143e5576143e561437f565b604052919050565b600082601f8301126143fe57600080fd5b81356001600160401b038111156144175761441761437f565b61442a601f8201601f19166020016143bd565b81815284602083860101111561443f57600080fd5b816020850160208301376000918101602001919091529392505050565b6000806040838503121561446f57600080fd5b8235915060208301356001600160401b0381111561448c57600080fd5b614498858286016143ed565b9150509250929050565b80356001600160a01b03811681146144b957600080fd5b919050565b60008060008385036101208112156144d557600080fd5b6144de856144a2565b93506020850135925060e0603f19820112156144f957600080fd5b506040840190509250925092565b6001600160e01b03198116811461112a57600080fd5b60006020828403121561452f57600080fd5b813561194581614507565b60005b8381101561455557818101518382015260200161453d565b50506000910152565b6000815180845261457681602086016020860161453a565b601f01601f19169290920160200192915050565b602081526000611945602083018461455e565b6000602082840312156145af57600080fd5b5035919050565b600080604083850312156145c957600080fd5b6145d2836144a2565b946020939093013593505050565b6000806000606084860312156145f557600080fd5b6145fe846144a2565b925061460c602085016144a2565b9150604084013590509250925092565b60006001600160401b038211156146355761463561437f565b5060051b60200190565b600082601f83011261465057600080fd5b813560206146656146608361461c565b6143bd565b82815260059290921b8401810191818101908684111561468457600080fd5b8286015b8481101561469f5780358352918301918301614688565b509695505050505050565b6000602082840312156146bc57600080fd5b81356001600160401b038111156146d257600080fd5b61200b8482850161463f565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b8281101561473357603f1988860301845261472185835161455e565b94509285019290850190600101614705565b5092979650505050505050565b6000806040838503121561475357600080fd5b82359150614763602084016144a2565b90509250929050565b634e487b7160e01b600052602160045260246000fd5b815160e0820190600581106147a757634e487b7160e01b600052602160045260246000fd5b808352506020830151602083015260408301516040830152606083015160608301526080830151608083015260a083015160a083015260c083015160c083015292915050565b6000602082840312156147ff57600080fd5b611945826144a2565b60006020828403121561481a57600080fd5b81356001600160401b0381111561483057600080fd5b61200b848285016143ed565b6000806040838503121561484f57600080fd5b614858836144a2565b915060208301356001600160401b0381111561448c57600080fd5b8035600581106144b957600080fd5b60006020828403121561489457600080fd5b61194582614873565b600080602083850312156148b057600080fd5b82356001600160401b03808211156148c757600080fd5b818501915085601f8301126148db57600080fd5b8135818111156148ea57600080fd5b8660208260051b85010111156148ff57600080fd5b60209290920196919550909350505050565b6020808252825182820181905260009190848201906040850190845b818110156149495783518352928401929184019160010161492d565b50909695505050505050565b6000806040838503121561496857600080fd5b50508035926020909101359150565b6000806040838503121561498a57600080fd5b614993836144a2565b9150602083013580151581146149a857600080fd5b809150509250929050565b600080600080608085870312156149c957600080fd5b6149d2856144a2565b93506149e0602086016144a2565b92506040850135915060608501356001600160401b03811115614a0257600080fd5b614a0e878288016143ed565b91505092959194509250565b60008060408385031215614a2d57600080fd5b614a36836144a2565b9150614763602084016144a2565b600080600060608486031215614a5957600080fd5b614a62846144a2565b9250614a70602085016144a2565b915060408401356001600160401b03811115614a8b57600080fd5b614a978682870161463f565b9150509250925092565b60008060408385031215614ab457600080fd5b823591506020808401356001600160401b0380821115614ad357600080fd5b818601915086601f830112614ae757600080fd5b8135614af56146608261461c565b81815260059190911b83018401908481019089831115614b1457600080fd5b8585015b83811015614ba657803585811115614b305760008081fd5b86016080818d03601f1901811315614b485760008081fd5b614b50614395565b614b5b8a8401614873565b815260408301358a820152606080840135604083015282840135925088831115614b855760008081fd5b614b938f8c858701016143ed565b9082015285525050918601918601614b18565b508096505050505050509250929050565b600181811c90821680614bcb57607f821691505b602082108103614beb57634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201614c7c57614c7c614c54565b5060010190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b601f821115610ae257600081815260208120601f850160051c81016020861015614d425750805b601f850160051c820191505b81811015612b6557828155600101614d4e565b81516001600160401b03811115614d7a57614d7a61437f565b614d8e81614d888454614bb7565b84614d1b565b602080601f831160018114614dc35760008415614dab5750858301515b600019600386901b1c1916600185901b178555612b65565b600085815260208120601f198616915b82811015614df257888601518255948401946001909101908401614dd3565b5085821015614e105787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b80820180821115610b0c57610b0c614c54565b6020808252601f908201527f417474726962757465733a3a4e6f6e2d6578697374656e742074726565496400604082015260600190565b6020808252818101527f417474726962757465733a3a4e6f6e2d6578697374656e7420736b696c6c4964604082015260600190565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b600060208284031215614ef657600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b60008151614fac81856020860161453a565b9290920192915050565b6000808454614fc481614bb7565b60018281168015614fdc5760018114614ff157615020565b60ff1984168752821515830287019450615020565b8860005260208060002060005b858110156150175781548a820152908401908201614ffe565b50505082870194505b50505050835161503481836020880161453a565b01949350505050565b7f416363657373436f6e74726f6c3a206163636f756e742000000000000000000081526000835161507581601785016020880161453a565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516150a681602884016020880161453a565b01602801949350505050565b6001600160a01b03858116825284166020820152604081018390526080606082018190526000906150e59083018461455e565b9695505050505050565b60006020828403121561510157600080fd5b815161194581614507565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c00000081526000825161514481601d85016020870161453a565b91909101601d0192915050565b6000835161516381846020880161453a565b602f60f81b908301908152835161518181600184016020880161453a565b01600101949350505050565b607b60f81b8152600083516151a981600185016020880161453a565b8351908301906151c081600184016020880161453a565b607d60f81b60019290910191820152600201949350505050565b60008160001904831182151516156151f4576151f4614c54565b500290565b60008161520857615208614c54565b506000190190565b81810381811115610b0c57610b0c614c54565b634e487b7160e01b600052603160045260246000fd5b6000825161524b81846020870161453a565b9190910192915050565b60008261527257634e487b7160e01b600052601260045260246000fd5b500490565b67113730b6b2911d1160c11b8152865160009061529b816008850160208c0161453a565b61088b60f21b60089184019182018190526a113a37b5b2b724b2111d1160a91b600a83015288516152d3816015850160208d0161453a565b601592019182018190526e113232b9b1b934b83a34b7b7111d1160891b60178301528751615308816026850160208c0161453a565b602692019182015261538961534661538361536f826153696153548261534060288a01681134b6b0b3b2911d1160b91b815260090190565b8e614f9a565b61088b60f21b815260020190565b681137bbb732b9111d1160b91b815260090190565b8a614f9a565b67113a3cb832911d1160c11b815260080190565b86614f9a565b9998505050505050505050565b600084516153a881846020890161453a565b8451908301906153bc81836020890161453a565b84519101906153cf81836020880161453a565b0195945050505050565b6f113234b9b83630bcafba3cb832911d1160811b8152815160009061540581601085016020870161453a565b61088b60f21b6010939091019283015250601201919050565b60008651615430818460208b0161453a565b6e3d913a3930b4ba2fba3cb832911d1160891b908301908152865161545c81600f840160208b0161453a565b61088b60f21b600f9290910191820152855161547f816011840160208a0161453a565b67113b30b63ab2911d60c11b6011929091019182015284516154a881601984016020890161453a565b607d60f81b6019929091019182015283516154ca81601a84016020880161453a565b01601a01979650505050505050565b6d2261747472696275746573223a5b60901b8152815160009061550381600e85016020870161453a565b605d60f81b600e939091019283015250600f0191905056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c656468747470733a2f2f696d616765732e617263616469616e2e67616d652f3842616c6c4375652f364d3d7565c7a8300c96fd53e065d19b65848d7b23b3191adcd55621c744223ca2646970667358221220ab28256a263ba5fcb9c4cd79bb657aed73c458141d5e84083e74a2db2d94fbc364736f6c63430008100033

Block Transaction Gas Used Reward
Age Block Fee Address BC Fee Address Voting Power Jailed Incoming
Block Uncle Number Difficulty Gas Used Reward
Loading