Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Is this a proxy?
• Similar
• Submit Audit
• Compare

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "../token/IToken.sol";
import "../token/TokenLauncher.sol";
import "../Bridge/IProjectBridge.sol";
import "../sale/ISaleContract.sol";
import "../sale/SaleLauncher.sol";
import "../interfaces/IRegistryConsumer.sol";
import "../interfaces/IRandomNumberProvider.sol";
import "../extras/recovery/BlackHolePrevention.sol";

import "../../@galaxis/registries/contracts/UsesGalaxisRegistry.sol";

import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/token/ERC721/IERC721.sol";

import "../../@galaxis/registries/contracts/CommunityList.sol";
import "../../@galaxis/registries/contracts/CommunityRegistry.sol";
import "../../@galaxis/registries/contracts/Hook.sol";
import "../../@galaxis/registries/contracts/Versionable/IVersionable.sol";

import "../interfaces/ISubscriptionManager.sol";


interface OwnableContract {
    function owner() external view returns (address);
}

interface IProjectFactory {
    function projectMapByCommunity(uint32 communityId,uint32 projectId) external view returns (uint32);
}

contract ProjectFactory is Ownable, BlackHolePrevention, AccessControl, IVersionable, UsesGalaxisRegistry { 

    function version() external pure returns (uint256) {
        return 2024091401;
    }

    using Strings  for uint256; 
    using Strings  for uint32; 
    using Strings  for uint8; 
    
    string              constant    public REGISTRY_KEY_RANDOM_CONTRACT  = "RANDOMV2_SSP";
    string              constant    public REGISTRY_KEY_PROJECT_FACTORY_CONTRACT  = "PROJECT_FACTORY";
    string              constant    public REGISTRY_KEY_COMMUNITY_LIST   = "COMMUNITY_LIST";
    string              constant    public REGISTRY_KEY_SSP_FACTORY_HOOK = "SSP_FACTORY_HOOK";
    bytes32             constant    public COMMUNITY_REGISTRY_ADMIN = keccak256("COMMUNITY_REGISTRY_ADMIN");
    bytes32             constant    public RANDOM_CONSUMER = keccak256("RANDOM_CONSUMER");
    bytes32             constant    public MAP_ACCESS = keccak256("MAP_ACCESS");
    bytes32             constant    public CONTRACT_ADMIN = keccak256("CONTRACT_ADMIN");

    mapping(uint32 =>                   // communityId
                mapping(uint32 =>       // projectId
                            uint32))    public projectMapByCommunity;

    uint256 public immutable chainid;

    bool    public useCommunityRandom = true;

    IProjectFactory oldProjectFactory;

    event NewProject(uint256 _projectCount);
    event CollectionCreatedFromProject(uint32 indexed communityId, uint32 collectionId, uint32 projectId);
    event CollectionCreatedFromProjectViaBridge(uint32 indexed communityId, uint32 collectionId, uint32 projectId, uint256 chainId);
    event CollectionCreatedByBridge(uint32 indexed communityId, uint32 collectionId);

    event SubscriptionCreationFailed(uint32 community, string reason);
    event SubscriptionCreationFailedBadly(uint32 community, bytes reason);
    event SubscriptionCreated(uint32 community_id,uint64 subscription_id);

    constructor(
        // address TokenFactoryAddress,
        // address SaleFactoryAddress,
        address _oldProjectFactory,
        address _galaxisRegistry
    ) UsesGalaxisRegistry(_galaxisRegistry) { 
        uint256 id;
        assembly {
            id := chainid()
        }
        chainid = id;
        _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
        _grantRole(CONTRACT_ADMIN,msg.sender);

        // TokenFactory = TokenFactoryV1(TokenFactoryAddress);
        // SaleFactory = SaleFactoryV1(SaleFactoryAddress);
        oldProjectFactory = IProjectFactory(_oldProjectFactory);
    }

    // function updateFactoryContracts(
    //     address TokenFactoryAddress,
    //     address SaleFactoryAddress
    // ) external onlyRole(CONTRACT_ADMIN) {
    //     TokenFactory = TokenFactoryV1(TokenFactoryAddress);
    //     SaleFactory = SaleFactoryV1(SaleFactoryAddress);
    // }

    // function LaunchProjectViaBridge(
    //     uint256 chainId,
    //     uint32 communityId,
    //     uint32 projectId,   // backend working ID
    //     SaleConfiguration memory saleConfig,
    //     TokenConstructorConfig memory tokenConfig
    // ) external payable {
    //     address PROJECT_FACTORY = galaxisRegistry.getRegistryAddress(REGISTRY_KEY_PROJECT_FACTORY_CONTRACT);
    //     require(PROJECT_FACTORY == address(this), "ProjectFactory: Not current project factory.");
    //     IProjectBridge theBridge = IProjectBridge(galaxisRegistry.getRegistryAddress("CCIP_PROJECT_BRIDGE"));
    //     require(address(theBridge)!= address(0),"Project bridge not currently active");        
    //     CommunityRegistry thisCommunityRegistry = getCommunityRegistry(communityId,false);
    //     require(thisCommunityRegistry.isUserCommunityAdmin(COMMUNITY_REGISTRY_ADMIN, msg.sender), "ProjectFactory: Community not owned by sender");
    //     require(thisCommunityRegistry.getRegistryBool("IS_HOME_CHAIN"),"ProjectFactory : not on home chain");
    //     uint256 collectionId = thisCommunityRegistry.getRegistryUINT("TOKEN_COUNT")+1;
    //     thisCommunityRegistry.setRegistryUINT("TOKEN_COUNT",collectionId);
    //     thisCommunityRegistry.setRegistryUINT("SALE_COUNT",collectionId);
    //     thisCommunityRegistry.setRegistryUINT(
    //         string.concat("TOKEN_HOME_CHAIN_",collectionId.toString()),
    //         chainId
    //     );
    //     projectMapByCommunity[communityId][projectId] = uint32(collectionId);
    //     theBridge.launchProject{value:msg.value}(msg.sender,chainId,communityId,uint32(collectionId),saleConfig,tokenConfig);
    //     emit CollectionCreatedFromProjectViaBridge(communityId,uint32(collectionId),projectId,chainId);
    // }

    function getProjectMapByCommunity(uint32 communityId,uint32 projectId) public view returns (uint32 collectionId) {
        collectionId = projectMapByCommunity[communityId][projectId];
        if (collectionId != 0) return collectionId;
        if (address(oldProjectFactory) == address(0)) return collectionId;
        // in future version replace this with a call to this function on old factory
        return oldProjectFactory.projectMapByCommunity(communityId,projectId);
    }

    // function LaunchProjectFromBridge(
    //     uint32 communityId,
    //     uint32 collectionId,
    //     address projectOwner,
    //     SaleConfiguration memory saleConfig,
    //     TokenConstructorConfig memory tokenConfig
    // ) external {
    //     _LaunchProjectFromBridge(
    //         communityId,
    //         "default name",
    //         collectionId,
    //         projectOwner,
    //         saleConfig,
    //         tokenConfig
    //     );
    // }

    // function LaunchProjectAndCommunityFromBridge(
    //     uint32 communityId,
    //     uint32 collectionId,
    //     string calldata communityName,
    //     address projectOwner,
    //     SaleConfiguration memory saleConfig,
    //     TokenConstructorConfig memory tokenConfig
    // ) external {
    //      _LaunchProjectFromBridge(
    //         communityId,
    //         communityName,
    //         collectionId,
    //         projectOwner,
    //         saleConfig,
    //         tokenConfig
    //     );
    // }

    // function _LaunchProjectFromBridge(
    //     uint32 communityId,
    //     string memory communityName,
    //     uint32 collectionId,
    //     address projectOwner,
    //     SaleConfiguration memory saleConfig,
    //     TokenConstructorConfig memory tokenConfig
    // ) internal {
    //     CommunityRegistry thisCommunityRegistry;
    //     require(msg.sender == galaxisRegistry.getRegistryAddress("CCIP_PROJECT_BRIDGE"),"ProjectFactory: not called by project bridge");
    //     CommunityList COMMUNITY_LIST = CommunityList(galaxisRegistry.getRegistryAddress(REGISTRY_KEY_COMMUNITY_LIST));
    //     (, address crAddr, ) = COMMUNITY_LIST.communities(communityId);
    //     if (crAddr == address(0)) {
    //         thisCommunityRegistry = CommunityRegistry(
    //             newProxy("GOLDEN_COMMUNITY_REGISTRY")
    //         );
    //         thisCommunityRegistry.init(
    //             communityId,
    //             projectOwner,
    //             communityName // <-- need the name
    //         );
    //         CommunityList(galaxisRegistry.getRegistryAddress(REGISTRY_KEY_COMMUNITY_LIST)).addCommunity(
    //             communityId,
    //             communityName,
    //             address(thisCommunityRegistry)
    //         );
    //         ISubscriptionManager subMan = ISubscriptionManager(galaxisRegistry.getRegistryAddress("SUBSCRIPTION_MANAGER"));
    //         if (address(subMan) != address(0)) {
    //             try subMan.createSubscription(communityId) {
    //                 //uint64 id = subMan.communitySubscriptions(communityId);
    //                 //emit SubscriptionCreated(communityId,id);
    //             } catch Error(string memory reason) {
    //                 emit SubscriptionCreationFailed(communityId,reason);
    //             } catch(bytes memory reason) {
    //                 emit SubscriptionCreationFailedBadly(communityId,reason);
    //             }
    //         }

    //     } else {
    //         thisCommunityRegistry = CommunityRegistry(crAddr);
    //         if (thisCommunityRegistry.getRegistryAddress("USER_RANDOM") == address(0)) {
    //             ISubscriptionManager subMan = ISubscriptionManager(galaxisRegistry.getRegistryAddress("SUBSCRIPTION_MANAGER"));
    //             if (address(subMan) != address(0)) {
    //                 try subMan.createSubscription(communityId) {
    //                     //uint64 id = subMan.communitySubscriptions(communityId);
    //                     //emit SubscriptionCreated(communityId,id);
    //                 } catch Error(string memory reason) {
    //                     emit SubscriptionCreationFailed(communityId,reason);
    //                 } catch(bytes memory reason) {
    //                     emit SubscriptionCreationFailedBadly(communityId,reason);
    //                 }
    //             }
    //         }
    //     }
    //     require(!thisCommunityRegistry.getRegistryBool("IS_HOME_CHAIN"),"ProjectFactory : cannot bridge projects to home chain");
    //     uint256 tokenCount = thisCommunityRegistry.getRegistryUINT("TOKEN_COUNT");
    //     if (collectionId > tokenCount) {
    //         thisCommunityRegistry.setRegistryUINT("TOKEN_COUNT",collectionId);
    //         thisCommunityRegistry.setRegistryUINT("SALE_COUNT",collectionId);
    //     }
    //     _LaunchProject(
    //         communityId,
    //         thisCommunityRegistry,
    //         collectionId, // resolved by bumping
    //         projectOwner,
    //         saleConfig,
    //         tokenConfig
    //     );
    //     emit CollectionCreatedByBridge(communityId,collectionId);
    // }

    function LaunchProject( // only on home chain
        uint32 communityId,
        uint32 projectId,   // backend working ID
        SaleConfiguration memory saleConfig,
        TokenConstructorConfig memory tokenConfig
    ) external {
        require (
            getProjectMapByCommunity(communityId,projectId) == 0,
            "ProjectFactory : project has already been launched"
        );
        CommunityRegistry thisCommunityRegistry = getCommunityRegistry(communityId,false);
        require(thisCommunityRegistry.isUserCommunityAdmin(COMMUNITY_REGISTRY_ADMIN, msg.sender), "ProjectFactory: Community not owned by sender");
        require(thisCommunityRegistry.getRegistryBool("IS_HOME_CHAIN"),"ProjectFactory : not on home chain");
        uint256 collectionId = thisCommunityRegistry.getRegistryUINT("TOKEN_COUNT")+1;
        thisCommunityRegistry.setRegistryUINT("TOKEN_COUNT",collectionId);
        thisCommunityRegistry.setRegistryUINT("SALE_COUNT",collectionId);
        projectMapByCommunity[communityId][projectId] = uint32(collectionId);
        
        _LaunchProject(
            communityId,
            thisCommunityRegistry,
            uint32(collectionId), // resolved by bumping
            msg.sender,
            saleConfig,
            tokenConfig
        );
        emit CollectionCreatedFromProject(communityId,uint32(collectionId),projectId);
    }

    function getCommunityRegistry(uint32 communityId, bool canCreate) internal view returns (CommunityRegistry) {
        CommunityList COMMUNITY_LIST = CommunityList(galaxisRegistry.getRegistryAddress(REGISTRY_KEY_COMMUNITY_LIST));
        (, address crAddr, ) = COMMUNITY_LIST.communities(communityId);
        require(crAddr != address(0) || canCreate, "ProjectFactory: Invalid community ID");
        return CommunityRegistry(crAddr);
    }

    function _LaunchProject(
        uint32                          communityId,
        CommunityRegistry               thisCommunityRegistry,
        uint32                          collectionId,   
        address                         projectOwner,
        SaleConfiguration       memory  saleConfig,
        TokenConstructorConfig  memory  tokenConfig
    ) internal {
        // validate this contract is the current version to be used. else fail
        address PROJECT_FACTORY = galaxisRegistry.getRegistryAddress(REGISTRY_KEY_PROJECT_FACTORY_CONTRACT);
        require(PROJECT_FACTORY == address(this), "ProjectFactory: Not current project factory.");
        saleConfig.projectID = communityId;
        tokenConfig.projectID = communityId;

        // Launch new token contract
        address tl = galaxisRegistry.getRegistryAddress("TOKEN_LAUNCHER");
        require(tl != address(0),"Project Factory : TOKEN_LAUNCHER not defined");
        IToken _newToken = TokenLauncher(tl).clone(address(galaxisRegistry));
        _newToken.init(tokenConfig, projectOwner);

        // make sure the TOKEN_{ID} address is not already used
        string memory tokenKey = string(abi.encodePacked("TOKEN_", collectionId.toString()));
        require(thisCommunityRegistry.getRegistryAddress(tokenKey) == address(0),"ProjectFactory: TOKEN_{ID} address already exists!");
        thisCommunityRegistry.setRegistryAddress(tokenKey, address(_newToken));       

        // add the new token contract address into the sale
        address sl = galaxisRegistry.getRegistryAddress("SALE_LAUNCHER");
        require(sl != address(0),"Project Factory : SALE_LAUNCHER not defined");

        saleConfig.token = address(_newToken);
        // Launch new sale contract
        ISaleContract _newSale = SaleLauncher(sl).clone(address(galaxisRegistry));
        _newSale.init(saleConfig,projectOwner); // transfers ownership after initialisation

        // Give sale contract TOKEN_CONTRACT_ACCESS_SALE role in Community Registry so it can call mint methods in token
        thisCommunityRegistry.grantRole(
            _newToken.TOKEN_CONTRACT_ACCESS_SALE(),
            address(_newSale)
        );
        if (useCommunityRandom){
            thisCommunityRegistry.grantRole(RANDOM_CONSUMER, address(_newToken));
        } else {
            // give random number provider access to the token
            IRandomNumberProvider random = IRandomNumberProvider(galaxisRegistry.getRegistryAddress(REGISTRY_KEY_RANDOM_CONTRACT));
            random.setAuth(address(_newToken), true);
        }

        // set community sale id for current token id
        // set new community sale address
        thisCommunityRegistry.setRegistryAddress(
            string(abi.encodePacked("SALE_", collectionId.toString())),
            address(_newSale)
        );

        // call finish hook
        // hook finishHook = hook( galaxisRegistry.getRegistryAddress(REGISTRY_KEY_SSP_FACTORY_HOOK) );
        // HookData memory data = HookData(
        //     communityId, 
        //     saleConfig,
        //     tokenConfig
        // );
        // finishHook.TJHooker(
        //     "SSP_FACTORY_HOOK_NEW_PROJECT", data
        // );


        emit NewProject(communityId);
    }

    struct HookData {
        uint32 communityId;
        SaleConfiguration saleConfig;
        TokenConstructorConfig tokenConfig;
    }


    struct ProjectDetails {
        address[] tokenContracts;
        address[] saleContracts;
        TokenInfo[] tokenInfo;
        SaleInfo[] saleInfo;
        uint256 chainid;
    }

    function getProjectDetails(uint32 communityId) public view returns (ProjectDetails memory) {

        CommunityList COMMUNITY_LIST = CommunityList(galaxisRegistry.getRegistryAddress(REGISTRY_KEY_COMMUNITY_LIST));
        (, address crAddr, ) = COMMUNITY_LIST.communities(communityId);
        require(crAddr != address(0), "ProjectFactory: Invalid community ID");
        CommunityRegistry thisCommunityRegistry = CommunityRegistry(crAddr);

        uint256 existingTokenCount = thisCommunityRegistry.getRegistryUINT("TOKEN_COUNT");
        uint256 existingSaleCount = thisCommunityRegistry.getRegistryUINT("SALE_COUNT");

        address[] memory _tokenAddresses = new address[](existingTokenCount);
        TokenInfo[] memory _tokenInfo = new TokenInfo[](existingTokenCount);
        for(uint8 i = 0; i < existingTokenCount; i++) {
            string memory key = string(abi.encodePacked("TOKEN_", (i+1).toString()));
            address thisAddress = thisCommunityRegistry.getRegistryAddress(key);
            if(thisAddress != address(0)) {
                _tokenAddresses[i] = thisAddress;
                _tokenInfo[i] = IToken(thisAddress).tellEverything();
            } 
        }

        address[] memory _saleAddresses = new address[](existingSaleCount);
        SaleInfo[] memory _saleInfo = new SaleInfo[](existingSaleCount);
        for(uint8 i = 0; i < existingSaleCount; i++) {

            string memory key = string(abi.encodePacked("SALE_", (i+1).toString()));
            address thisAddress = thisCommunityRegistry.getRegistryAddress(key);
            if(thisAddress != address(0)) {
                _saleAddresses[i] = thisAddress;
                _saleInfo[i] = ISaleContract(thisAddress).tellEverything();
            } 
        }

        return ProjectDetails(
            _tokenAddresses,
            _saleAddresses,
            _tokenInfo,
            _saleInfo,
            chainid
        );
    }

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./OperatorFilteredToken.sol";
import "./IToken.sol";
import "../../@galaxis/registries/contracts/UsesGalaxisRegistry.sol";

contract TokenLauncher is UsesGalaxisRegistry {

    constructor(address _galaxisRegistry) UsesGalaxisRegistry(_galaxisRegistry) {

    }

    function clone(
        address _galaxisRegistry
    ) external returns (IToken) {
        require(
            msg.sender == galaxisRegistry.getRegistryAddress("PROJECT_FACTORY"),
            "Token Launcher : unauthorised"
        );
        OperatorFilteredToken token = new OperatorFilteredToken(
            _galaxisRegistry
        );
        return IToken(address(token));
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;


struct revealStruct {
    uint256 REQUEST_ID;
    uint256 RANDOM_NUM;
    uint256 SHIFT;
    uint256 RANGE_START;
    uint256 RANGE_END;
    bool processed;
}

struct TokenInfoForSale {
    uint256 projectID;
    uint256 maxSupply;
    uint256 reservedSupply;
}

struct TokenInfo {
    string      name;
    string      symbol;
    uint256     projectID;
    uint256     maxSupply;
    uint256     mintedSupply;
    uint256     mintedReserve;
    uint256     reservedSupply;
    uint256     giveawaySupply;
    string      tokenPreRevealURI;
    string      tokenRevealURI;
    bool        transferLocked;
    bool        lastRevealRequested;
    uint256     totalSupply;
    revealStruct[] reveals;
    address     owner;
    address[]   managers;
    address[]   controllers;
    uint256     version;
    bool        VRFShifting;
}

struct TokenConstructorConfig {
    uint256 projectID;
    uint256 maxSupply;
    string  erc721name;
    string  erc721symbol;
    string  tokenPreRevealURI;
    string  tokenRevealURI;     
    bool    transferLocked;
    uint256 reservedSupply;
    uint256 giveawaySupply;
    bool    VRFShifting;
}

interface IToken {

    function init(TokenConstructorConfig memory config, address _actualOwner) external;
    function TOKEN_CONTRACT_GIVEAWAY() external returns (bytes32);
    function TOKEN_CONTRACT_ACCESS_SALE() external returns (bytes32);
    function TOKEN_CONTRACT_ACCESS_ADMIN() external returns (bytes32);
    function TOKEN_CONTRACT_ACCESS_LOCK() external returns (bytes32);
    function TOKEN_CONTRACT_ACCESS_REVEAL() external returns (bytes32);

    function mintIncrementalCards(uint256, address) external;
    function mintReservedCards(uint256, address) external;
    function mintGiveawayCard(uint256, address) external;

    function setPreRevealURI(string calldata) external;
    function setRevealURI(string calldata) external;

    function revealAtCurrentSupply() external;
    function lastReveal() external;
    function process(uint256, uint256) external;
    
    function uri(uint256) external view returns (uint256);
    function tokenURI(uint256) external view returns (string memory);

    function setTransferLock(bool) external;
    function hasRole(bytes32, address) external view returns (bool);
    function isAllowed(bytes32, address) external view returns (bool);    

    function getFirstGiveawayCardId() external view returns (uint256);
    function tellEverything() external view returns (TokenInfo memory);
    function getTokenInfoForSale() external view returns (TokenInfoForSale memory);

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "../sale/ISaleContract.sol";
import "../token/IToken.sol";


interface IProjectBridge {
    function launchProject(
        address                         sender,
        uint256                         chainId,
        uint32                          communityId,
        uint32                          collectionId,
        SaleConfiguration memory        saleConfig,
        TokenConstructorConfig memory   tokenConfig
    ) external payable returns (bytes32 messageId) ;

    function getFee(
        uint256                         chainId,
        uint32                          communityId,
        uint32                          collectionId,
        SaleConfiguration memory        saleConfig,
        TokenConstructorConfig memory   tokenConfig
    ) external view returns (
        uint256 fee
    ) ;

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

interface IRegistryConsumer {
    function getRegistryAddress(string memory key) external view returns (address) ;
    function getRegistryBool(string memory key) external view returns (bool);
    function getRegistryUINT(string memory key) external view returns (uint256) ;
    function getRegistryString(string memory key) external view returns (string memory) ;
    function isAdmin(address user) external view returns (bool);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "@openzeppelin/contracts/token/ERC20/IERC20.sol";

struct SaleConfiguration {
    uint256 projectID; 
    address token;
    address payable[] wallets;
    uint16[] shares;

    uint256 maxMintPerTransaction;      // How many tokens a transaction can mint
    uint256 maxApprovedSale;            // Max sold in approvedsale across approvedsale eth
    uint256 maxApprovedSalePerAddress;  // Limit discounts per address
    uint256 maxSalePerAddress;

    uint256 approvedsaleStart;
    uint256 approvedsaleEnd;
    uint256 saleStart;
    uint256 saleEnd;

    uint256 fullPrice;
    uint256 maxUserMintable;
    address signer;
    uint256 fullERC20Price;
    bool    ethSaleEnabled;
    bool    erc20SaleEnabled;
    address erc20tokenAddress;
}


struct SaleInfo {
    SaleConfiguration config;
    uint256 userMinted;
    bool    approvedSaleIsActive;
    bool    saleIsActive;
    uint256 version;
    bool    isMembership;
}

struct SaleSignedPayload {
    uint256 projectID;
    uint256 chainID;  // 1 mainnet / 4 rinkeby / 11155111 sepolia / 137 polygon / 80001 mumbai
    bool    free;
    uint16  max_mint;
    address receiver;
    uint256 valid_from;
    uint256 valid_to;
    uint256 eth_price;
    uint256 erc20_price;
    bytes   signature;
}

struct tokenPayload {
    uint256 numberOfCards;
    SaleSignedPayload payload;
}

interface ISaleContract {
    function init(SaleConfiguration memory, address) external;
    function UpdateSaleConfiguration(SaleConfiguration memory) external;
    function UpdateWalletsAndShares(address payable[] memory, uint16[] memory) external;
    function mint(uint256) external payable;
    function crossmint(uint256, address) external payable;
    function mint_approved(SaleSignedPayload memory _payload, uint256 _numberOfCards) external payable;
    function tellEverything() external view returns (SaleInfo memory);
    function getBlockTimestamp() external view returns(uint256);
    function buyWithERC20(uint256 amount, IERC20 _erc20Token, bytes memory userData) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./SaleContract.sol";
import "./ISaleContract.sol";
import "../../@galaxis/registries/contracts/UsesGalaxisRegistry.sol";

contract SaleLauncher is UsesGalaxisRegistry {

    constructor(address _galaxisRegistry) UsesGalaxisRegistry(_galaxisRegistry) {

    }

    function clone(
        address _galaxisRegistry
    ) external returns (ISaleContract) {
        require(
            msg.sender == galaxisRegistry.getRegistryAddress("PROJECT_FACTORY"),
            "Token Launcher : unauthorised"
        );
        SaleContract sale = new SaleContract(
            _galaxisRegistry
        );
        return ISaleContract(address(sale));
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

interface IRandomNumberProvider {
    function requestRandomNumber() external returns (uint256 requestId);
    function requestRandomNumberWithCallback() external returns (uint256);
    function isRequestComplete(uint256 requestId) external view returns (bool isCompleted);
    function randomNumber(uint256 requestId) external view returns (uint256 randomNum);
    function setAuth(address user, bool grant) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./IRegistry.sol";

contract UsesGalaxisRegistry {

    IRegistry   immutable   public   galaxisRegistry;

    constructor(address _galaxisRegistry) {
        galaxisRegistry = IRegistry(_galaxisRegistry);
    }

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/Address.sol";

contract BlackHolePrevention is Ownable {
    using Address for address payable;
    // blackhole prevention methods

    constructor() Ownable(msg.sender) {

    }

    function retrieveETH() external onlyOwner {
        address payable sender = payable(msg.sender);
        sender.sendValue(address(this).balance);

    }
    
    function retrieveERC20(address _tracker, uint256 amount) external onlyOwner {
        IERC20(_tracker).transfer(msg.sender, amount);
    }

    function retrieve721(address _tracker, uint256 id) external onlyOwner {
        IERC721(_tracker).transferFrom(address(this), msg.sender, id);
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;


interface ISubscriptionManager {
    function createSubscription(uint32 community_id) external;
    function communitySubscriptions(uint32) external view returns (uint64);
    //function subscriptionStatuses(uint64) external view returns (SubscriptionStatus memory);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "@openzeppelin/contracts/access/extensions/AccessControlEnumerable.sol";
import "./Versionable/IVersionable.sol";

contract CommunityList is AccessControlEnumerable, IVersionable { 

    function version() external pure returns (uint256) {
        return 2024040301;
    }

    bytes32 public constant CONTRACT_ADMIN = keccak256("CONTRACT_ADMIN");


    uint256                              public numberOfEntries;

    struct community_entry {
        string      name;
        address     registry;
        uint32      id;
    }
    
    mapping(uint32 => community_entry)  public communities;   // community_id => record
    mapping(uint256 => uint32)           public index;         // entryNumber => community_id for enumeration

    event CommunityAdded(uint256 pos, string community_name, address community_registry, uint32 community_id);

    constructor() {
        _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
        _grantRole(CONTRACT_ADMIN,msg.sender);
    }

    function addCommunity(uint32 community_id, string memory community_name, address community_registry) external onlyRole(CONTRACT_ADMIN) {
        uint256 pos = numberOfEntries++;
        index[pos]  = community_id;
        communities[community_id] = community_entry(community_name, community_registry, community_id);
        emit CommunityAdded(pos, community_name, community_registry, community_id);
    }

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "@openzeppelin/contracts/access/extensions/AccessControlEnumerable.sol";
import "@openzeppelin/contracts/access/IAccessControl.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "./Versionable/IVersionable.sol";
import "./UsesGalaxisRegistry.sol";

contract CommunityRegistry is AccessControlEnumerable, UsesGalaxisRegistry, IVersionable  {

    function version() virtual external pure returns(uint256) {
        return 2024040401;
    }

    bytes32 public constant COMMUNITY_REGISTRY_ADMIN = keccak256("COMMUNITY_REGISTRY_ADMIN");

    uint32                      public  community_id;
    string                      public  community_name;
    

    mapping(bytes32 => address)         addresses;
    mapping(bytes32 => uint256)         uints;
    mapping(bytes32 => bool)            booleans;
    mapping(bytes32 => string)          strings;

    mapping (uint => string)    public  addressEntries;
    mapping (uint => string)    public  uintEntries;
    mapping (uint => string)    public  boolEntries;
    mapping (uint => string)    public  stringEntries;
    uint                        public  numberOfAddresses;
    uint                        public  numberOfUINTs;
    uint                        public  numberOfBooleans;
    uint                        public  numberOfStrings;

    bool                                initialised;

    bool                        public  independant;

    event IndependanceDay(bool gain_independance);

    modifier onlyAdmin() {
        require(
            isUserCommunityAdmin(COMMUNITY_REGISTRY_ADMIN,msg.sender)
            ,"CommunityRegistry : Unauthorised");
        _;
    }

    modifier onlyPropertyAdmin() {
        require(
            isUserCommunityAdmin(COMMUNITY_REGISTRY_ADMIN,msg.sender) ||
            hasRole(COMMUNITY_REGISTRY_ADMIN,msg.sender)
            ,"CommunityRegistry : Unauthorised");
        _;
    }



    function isUserCommunityAdmin(bytes32 role, address user) public view returns (bool) {
        if (hasRole(DEFAULT_ADMIN_ROLE,user) ) return true; // community_admin can do anything
        if (independant){        
            return(
                hasRole(role,user)
            );
        } else { // for Factories
           return(roleManager().hasRole(role,user));
        }
    }

    function roleManager() internal view returns (IAccessControlEnumerable) {
        address addr = galaxisRegistry.getRegistryAddress("ROLE_MANAGER"); // universal
        if (addr != address(0)) return IAccessControlEnumerable(addr);
        addr = galaxisRegistry.getRegistryAddress("MAINNET_CHAIN_IMPLEMENTER"); // mainnet
        if (addr != address(0)) return IAccessControlEnumerable(addr);
        addr = galaxisRegistry.getRegistryAddress("L2_RECEIVER"); // mainnet
        require(addr != address(0),"CommunityRegistry : no higher authority found");
        return IAccessControlEnumerable(addr);
    }

    function grantRole(bytes32 key, address user) public override(AccessControl,IAccessControl) onlyAdmin {
        _grantRole(key,user); // need to be able to grant it
    }


 
    constructor (
        address _galaxisRegistry,
        uint32  _community_id, 
        address _community_admin, 
        string memory _community_name
    ) UsesGalaxisRegistry(_galaxisRegistry){
        _init(_community_id,_community_admin,_community_name);
    }

    
    function init(
        uint32  _community_id, 
        address _community_admin, 
        string memory _community_name
    ) external {
        _init(_community_id,_community_admin,_community_name);
    }

    function _init(
        uint32  _community_id, 
        address _community_admin, 
        string memory _community_name
    ) internal {
        require(!initialised,"This can only be called once");
        initialised = true;
        community_id = _community_id;
        community_name  = _community_name;
        _grantRole(DEFAULT_ADMIN_ROLE, _community_admin); // default admin = launchpad
    }



    event AdminUpdated(address user, bool isAdmin);
    event AppAdminChanged(address app,address user,bool state);
    //===
    event AddressChanged(string key, address value);
    event UintChanged(string key, uint256 value);
    event BooleanChanged(string key, bool value);
    event StringChanged(string key, string value);

    function setIndependant(bool gain_independance) external onlyAdmin {
        if (independant != gain_independance) {
                independant = gain_independance;
                emit IndependanceDay(gain_independance);
        }
    }


    function setAdmin(address user,bool status ) external onlyAdmin {
        if (status)
            _grantRole(COMMUNITY_REGISTRY_ADMIN,user);
        else
            _revokeRole(COMMUNITY_REGISTRY_ADMIN,user);
    }

    function hash(string memory field) internal pure returns (bytes32) {
        return keccak256(abi.encode(field));
    }

    function setRegistryAddress(string memory fn, address value) external onlyPropertyAdmin {
        bytes32 hf = hash(fn);
        addresses[hf] = value;
        addressEntries[numberOfAddresses++] = fn;
        emit AddressChanged(fn,value);
    }

    function setRegistryBool(string memory fn, bool value) external onlyPropertyAdmin {
        bytes32 hf = hash(fn);
        booleans[hf] = value;
        boolEntries[numberOfBooleans++] = fn;
        emit BooleanChanged(fn,value);
    }

    function setRegistryString(string memory fn, string memory value) external onlyPropertyAdmin {
        bytes32 hf = hash(fn);
        strings[hf] = value;
        stringEntries[numberOfStrings++] = fn;
        emit StringChanged(fn,value);
    }

    function setRegistryUINT(string memory fn, uint value) external onlyPropertyAdmin {
        bytes32 hf = hash(fn);
        uints[hf] = value;
        uintEntries[numberOfUINTs++] = fn;
        emit UintChanged(fn,value);
    }

    function getRegistryAddress(string memory key) external view returns (address) {
        return addresses[hash(key)];
    }

    function getRegistryBool(string memory key) external view returns (bool) {
        return booleans[hash(key)];
    }

    function getRegistryUINT(string memory key) external view returns (uint256) {
        return uints[hash(key)];
    }

    function getRegistryString(string memory key) external view returns (string memory) {
        return strings[hash(key)];
    }

}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./UsesGalaxisRegistry.sol";
import "./Versionable/IVersionable.sol";


interface hookey {

    function Process(bytes memory data) external;
}


contract hook is UsesGalaxisRegistry, IVersionable { 


    function version() public pure returns (uint256) {
        return 2024040401; 
    }

    constructor(address _galaxisRegistry) UsesGalaxisRegistry(_galaxisRegistry) {

    }
 
    function TJHooker(string memory key, bytes calldata data) external {
        hookey hookAddress = hookey(galaxisRegistry.getRegistryAddress(key));
        if (address(hookAddress) == address(0)) return;
        hookAddress.Process(data);
    }

}

//SPDX-License-Identifier: Unlicensed
pragma solidity 0.8.25;

/**
 * @title IVersionable
 * @dev Interface for versionable contracts.
 */
interface IVersionable {
    /**
     * @notice Get the current version of the contract.
     * @return The current version.
     */
    function version() external pure returns (uint256);
}

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

pragma solidity ^0.8.20;

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

/**
 * @dev String operations.
 */
library Strings {
    using SafeCast for *;

    bytes16 private constant HEX_DIGITS = "0123456789abcdef";
    uint8 private constant ADDRESS_LENGTH = 20;

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

    /**
     * @dev The string being parsed contains characters that are not in scope of the given base.
     */
    error StringsInvalidChar();

    /**
     * @dev The string being parsed is not a properly formatted address.
     */
    error StringsInvalidAddressFormat();

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

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

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

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

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

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its checksummed ASCII `string` hexadecimal
     * representation, according to EIP-55.
     */
    function toChecksumHexString(address addr) internal pure returns (string memory) {
        bytes memory buffer = bytes(toHexString(addr));

        // hash the hex part of buffer (skip length + 2 bytes, length 40)
        uint256 hashValue;
        assembly ("memory-safe") {
            hashValue := shr(96, keccak256(add(buffer, 0x22), 40))
        }

        for (uint256 i = 41; i > 1; --i) {
            // possible values for buffer[i] are 48 (0) to 57 (9) and 97 (a) to 102 (f)
            if (hashValue & 0xf > 7 && uint8(buffer[i]) > 96) {
                // case shift by xoring with 0x20
                buffer[i] ^= 0x20;
            }
            hashValue >>= 4;
        }
        return string(buffer);
    }

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

    /**
     * @dev Parse a decimal string and returns the value as a `uint256`.
     *
     * Requirements:
     * - The string must be formatted as `[0-9]*`
     * - The result must fit into an `uint256` type
     */
    function parseUint(string memory input) internal pure returns (uint256) {
        return parseUint(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseUint} that parses a substring of `input` located between position `begin` (included) and
     * `end` (excluded).
     *
     * Requirements:
     * - The substring must be formatted as `[0-9]*`
     * - The result must fit into an `uint256` type
     */
    function parseUint(string memory input, uint256 begin, uint256 end) internal pure returns (uint256) {
        (bool success, uint256 value) = tryParseUint(input, begin, end);
        if (!success) revert StringsInvalidChar();
        return value;
    }

    /**
     * @dev Variant of {parseUint-string} that returns false if the parsing fails because of an invalid character.
     *
     * NOTE: This function will revert if the result does not fit in a `uint256`.
     */
    function tryParseUint(string memory input) internal pure returns (bool success, uint256 value) {
        return _tryParseUintUncheckedBounds(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseUint-string-uint256-uint256} that returns false if the parsing fails because of an invalid
     * character.
     *
     * NOTE: This function will revert if the result does not fit in a `uint256`.
     */
    function tryParseUint(
        string memory input,
        uint256 begin,
        uint256 end
    ) internal pure returns (bool success, uint256 value) {
        if (end > bytes(input).length || begin > end) return (false, 0);
        return _tryParseUintUncheckedBounds(input, begin, end);
    }

    /**
     * @dev Implementation of {tryParseUint} that does not check bounds. Caller should make sure that
     * `begin <= end <= input.length`. Other inputs would result in undefined behavior.
     */
    function _tryParseUintUncheckedBounds(
        string memory input,
        uint256 begin,
        uint256 end
    ) private pure returns (bool success, uint256 value) {
        bytes memory buffer = bytes(input);

        uint256 result = 0;
        for (uint256 i = begin; i < end; ++i) {
            uint8 chr = _tryParseChr(bytes1(_unsafeReadBytesOffset(buffer, i)));
            if (chr > 9) return (false, 0);
            result *= 10;
            result += chr;
        }
        return (true, result);
    }

    /**
     * @dev Parse a decimal string and returns the value as a `int256`.
     *
     * Requirements:
     * - The string must be formatted as `[-+]?[0-9]*`
     * - The result must fit in an `int256` type.
     */
    function parseInt(string memory input) internal pure returns (int256) {
        return parseInt(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseInt-string} that parses a substring of `input` located between position `begin` (included) and
     * `end` (excluded).
     *
     * Requirements:
     * - The substring must be formatted as `[-+]?[0-9]*`
     * - The result must fit in an `int256` type.
     */
    function parseInt(string memory input, uint256 begin, uint256 end) internal pure returns (int256) {
        (bool success, int256 value) = tryParseInt(input, begin, end);
        if (!success) revert StringsInvalidChar();
        return value;
    }

    /**
     * @dev Variant of {parseInt-string} that returns false if the parsing fails because of an invalid character or if
     * the result does not fit in a `int256`.
     *
     * NOTE: This function will revert if the absolute value of the result does not fit in a `uint256`.
     */
    function tryParseInt(string memory input) internal pure returns (bool success, int256 value) {
        return _tryParseIntUncheckedBounds(input, 0, bytes(input).length);
    }

    uint256 private constant ABS_MIN_INT256 = 2 ** 255;

    /**
     * @dev Variant of {parseInt-string-uint256-uint256} that returns false if the parsing fails because of an invalid
     * character or if the result does not fit in a `int256`.
     *
     * NOTE: This function will revert if the absolute value of the result does not fit in a `uint256`.
     */
    function tryParseInt(
        string memory input,
        uint256 begin,
        uint256 end
    ) internal pure returns (bool success, int256 value) {
        if (end > bytes(input).length || begin > end) return (false, 0);
        return _tryParseIntUncheckedBounds(input, begin, end);
    }

    /**
     * @dev Implementation of {tryParseInt} that does not check bounds. Caller should make sure that
     * `begin <= end <= input.length`. Other inputs would result in undefined behavior.
     */
    function _tryParseIntUncheckedBounds(
        string memory input,
        uint256 begin,
        uint256 end
    ) private pure returns (bool success, int256 value) {
        bytes memory buffer = bytes(input);

        // Check presence of a negative sign.
        bytes1 sign = begin == end ? bytes1(0) : bytes1(_unsafeReadBytesOffset(buffer, begin)); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
        bool positiveSign = sign == bytes1("+");
        bool negativeSign = sign == bytes1("-");
        uint256 offset = (positiveSign || negativeSign).toUint();

        (bool absSuccess, uint256 absValue) = tryParseUint(input, begin + offset, end);

        if (absSuccess && absValue < ABS_MIN_INT256) {
            return (true, negativeSign ? -int256(absValue) : int256(absValue));
        } else if (absSuccess && negativeSign && absValue == ABS_MIN_INT256) {
            return (true, type(int256).min);
        } else return (false, 0);
    }

    /**
     * @dev Parse a hexadecimal string (with or without "0x" prefix), and returns the value as a `uint256`.
     *
     * Requirements:
     * - The string must be formatted as `(0x)?[0-9a-fA-F]*`
     * - The result must fit in an `uint256` type.
     */
    function parseHexUint(string memory input) internal pure returns (uint256) {
        return parseHexUint(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseHexUint} that parses a substring of `input` located between position `begin` (included) and
     * `end` (excluded).
     *
     * Requirements:
     * - The substring must be formatted as `(0x)?[0-9a-fA-F]*`
     * - The result must fit in an `uint256` type.
     */
    function parseHexUint(string memory input, uint256 begin, uint256 end) internal pure returns (uint256) {
        (bool success, uint256 value) = tryParseHexUint(input, begin, end);
        if (!success) revert StringsInvalidChar();
        return value;
    }

    /**
     * @dev Variant of {parseHexUint-string} that returns false if the parsing fails because of an invalid character.
     *
     * NOTE: This function will revert if the result does not fit in a `uint256`.
     */
    function tryParseHexUint(string memory input) internal pure returns (bool success, uint256 value) {
        return _tryParseHexUintUncheckedBounds(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseHexUint-string-uint256-uint256} that returns false if the parsing fails because of an
     * invalid character.
     *
     * NOTE: This function will revert if the result does not fit in a `uint256`.
     */
    function tryParseHexUint(
        string memory input,
        uint256 begin,
        uint256 end
    ) internal pure returns (bool success, uint256 value) {
        if (end > bytes(input).length || begin > end) return (false, 0);
        return _tryParseHexUintUncheckedBounds(input, begin, end);
    }

    /**
     * @dev Implementation of {tryParseHexUint} that does not check bounds. Caller should make sure that
     * `begin <= end <= input.length`. Other inputs would result in undefined behavior.
     */
    function _tryParseHexUintUncheckedBounds(
        string memory input,
        uint256 begin,
        uint256 end
    ) private pure returns (bool success, uint256 value) {
        bytes memory buffer = bytes(input);

        // skip 0x prefix if present
        bool hasPrefix = (end > begin + 1) && bytes2(_unsafeReadBytesOffset(buffer, begin)) == bytes2("0x"); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
        uint256 offset = hasPrefix.toUint() * 2;

        uint256 result = 0;
        for (uint256 i = begin + offset; i < end; ++i) {
            uint8 chr = _tryParseChr(bytes1(_unsafeReadBytesOffset(buffer, i)));
            if (chr > 15) return (false, 0);
            result *= 16;
            unchecked {
                // Multiplying by 16 is equivalent to a shift of 4 bits (with additional overflow check).
                // This guaratees that adding a value < 16 will not cause an overflow, hence the unchecked.
                result += chr;
            }
        }
        return (true, result);
    }

    /**
     * @dev Parse a hexadecimal string (with or without "0x" prefix), and returns the value as an `address`.
     *
     * Requirements:
     * - The string must be formatted as `(0x)?[0-9a-fA-F]{40}`
     */
    function parseAddress(string memory input) internal pure returns (address) {
        return parseAddress(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseAddress} that parses a substring of `input` located between position `begin` (included) and
     * `end` (excluded).
     *
     * Requirements:
     * - The substring must be formatted as `(0x)?[0-9a-fA-F]{40}`
     */
    function parseAddress(string memory input, uint256 begin, uint256 end) internal pure returns (address) {
        (bool success, address value) = tryParseAddress(input, begin, end);
        if (!success) revert StringsInvalidAddressFormat();
        return value;
    }

    /**
     * @dev Variant of {parseAddress-string} that returns false if the parsing fails because the input is not a properly
     * formatted address. See {parseAddress} requirements.
     */
    function tryParseAddress(string memory input) internal pure returns (bool success, address value) {
        return tryParseAddress(input, 0, bytes(input).length);
    }

    /**
     * @dev Variant of {parseAddress-string-uint256-uint256} that returns false if the parsing fails because input is not a properly
     * formatted address. See {parseAddress} requirements.
     */
    function tryParseAddress(
        string memory input,
        uint256 begin,
        uint256 end
    ) internal pure returns (bool success, address value) {
        if (end > bytes(input).length || begin > end) return (false, address(0));

        bool hasPrefix = (end > begin + 1) && bytes2(_unsafeReadBytesOffset(bytes(input), begin)) == bytes2("0x"); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
        uint256 expectedLength = 40 + hasPrefix.toUint() * 2;

        // check that input is the correct length
        if (end - begin == expectedLength) {
            // length guarantees that this does not overflow, and value is at most type(uint160).max
            (bool s, uint256 v) = _tryParseHexUintUncheckedBounds(input, begin, end);
            return (s, address(uint160(v)));
        } else {
            return (false, address(0));
        }
    }

    function _tryParseChr(bytes1 chr) private pure returns (uint8) {
        uint8 value = uint8(chr);

        // Try to parse `chr`:
        // - Case 1: [0-9]
        // - Case 2: [a-f]
        // - Case 3: [A-F]
        // - otherwise not supported
        unchecked {
            if (value > 47 && value < 58) value -= 48;
            else if (value > 96 && value < 103) value -= 87;
            else if (value > 64 && value < 71) value -= 55;
            else return type(uint8).max;
        }

        return value;
    }

    /**
     * @dev Reads a bytes32 from a bytes array without bounds checking.
     *
     * NOTE: making this function internal would mean it could be used with memory unsafe offset, and marking the
     * assembly block as such would prevent some optimizations.
     */
    function _unsafeReadBytesOffset(bytes memory buffer, uint256 offset) private pure returns (bytes32 value) {
        // This is not memory safe in the general case, but all calls to this private function are within bounds.
        assembly ("memory-safe") {
            value := mload(add(buffer, add(0x20, offset)))
        }
    }
}

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../../utils/introspection/IERC165.sol";

/**
 * @dev Required interface of an ERC-721 compliant contract.
 */
interface IERC721 is IERC165 {
    /**
     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
     */
    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
     */
    event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
     */
    event ApprovalForAll(address indexed owner, address indexed operator, bool approved);

    /**
     * @dev Returns the number of tokens in ``owner``'s account.
     */
    function balanceOf(address owner) external view returns (uint256 balance);

    /**
     * @dev Returns the owner of the `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function ownerOf(uint256 tokenId) external view returns (address owner);

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`.
     *
     * 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 ERC-721 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 ERC-721
     * 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 address zero.
     *
     * 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);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./LockableRevealERC721EnumerableToken.sol";
import "operator-filter-registry/src/IOperatorFilterRegistry.sol";

contract OperatorFilteredToken is LockableRevealERC721EnumerableToken {

    error OperatorNotAllowed(address operator);

    bool                    public OSFiltering = true;
    address                 public DEFAULT_SUBSCRIPTION = address(0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6);
    IOperatorFilterRegistry public OPERATOR_FILTER_REGISTRY = IOperatorFilterRegistry(0x000000000000AAeB6D7670E522A718067333cd4E);

    constructor(address _galaxisRegistry) LockableRevealERC721EnumerableToken(_galaxisRegistry) {
    }

    function init(TokenConstructorConfig memory config, address _actualOwner) public virtual override  {

        if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
            OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), DEFAULT_SUBSCRIPTION);
        }
        super.init(config,_actualOwner);
    }

    // Toggle to disable OS filtering
    function toggleOSFilterOperatorState() public onlyOwner() {
        OSFiltering = !OSFiltering;
    }

    function setApprovalForAll(address operator, bool approved) public override(ERC721, IERC721) {
        if(OSFiltering) {
            _checkFilterOperator(operator);
        }
        super.setApprovalForAll(operator, approved);
    }

    function approve(address operator, uint256 tokenId) public override(ERC721, IERC721) {
        if(OSFiltering) {
            _checkFilterOperator(operator);
        }
        super.approve(operator, tokenId);
    }

    function transferFrom(address from, address to, uint256 tokenId) public override(ERC721, IERC721) {
        if (OSFiltering && from != msg.sender) { _checkFilterOperator(msg.sender); }
        super.transferFrom(from, to, tokenId);
    }

    function safeTransferFrom(address from, address to, uint256 tokenId) public override(ERC721, IERC721) {
        if (OSFiltering && from != msg.sender) { _checkFilterOperator(msg.sender); }
        super.safeTransferFrom(from, to, tokenId);
    }

    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public override(ERC721, IERC721) {
        if (OSFiltering && from != msg.sender) { _checkFilterOperator(msg.sender); }
        super.safeTransferFrom(from, to, tokenId, data);
    }

    function _checkFilterOperator(address operator) internal view virtual {
        // Check registry code length to facilitate testing in environments without a deployed registry.
        if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
            if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) {
                revert OperatorNotAllowed(operator);
            }
        }
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./ISaleContract.sol";
import "../token/IToken.sol";
import "../extras/recovery/BlackHolePrevention.sol";

import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
//import "@openzeppelin/contracts/utils/introspection/IERC1820Registry.sol";
import "@openzeppelin/contracts/access/extensions/AccessControlEnumerable.sol";
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "../../@galaxis/registries/contracts/Versionable/IVersionable.sol";
import "../../@galaxis/registries/contracts/CommunityList.sol";
import "../../@galaxis/registries/contracts/CommunityRegistry.sol";
import "../../@galaxis/registries/contracts/UsesGalaxisRegistry.sol";

contract SaleContract is AccessControlEnumerable, ISaleContract, Ownable, BlackHolePrevention, UsesGalaxisRegistry, IVersionable { 

    function version() public pure returns (uint256) {
        return 2024042601;
    }

    using Strings  for uint256;

    uint256             public  projectID;
    IToken              public  token;
    bool                public  isMembership;

    address payable []  _wallets;
    uint16[]            _shares;
    uint256             _maxMintPerTransaction;
    uint256             _maxApprovedSale;
    uint256             _maxMintPerAddress;
    uint256             _maxApprovedSalePerAddress;
    uint256             _maxSalePerAddress;
    address             _projectSigner;
    uint256             _approvedsaleStart;
    uint256             _approvedsaleEnd;
    uint256             _saleStart;
    uint256             _saleEnd;
    uint256             _fullPrice;
    uint256             _fullERC20Price;
    bool                _ethSaleEnabled;
    bool                _erc20SaleEnabled;
    address             _erc20tokenAddress;

    uint256             _maxUserMintable;
    uint256             _userMinted;
    mapping(address => uint256) public _mintedByWallet;

    bool                _initialized;

    event ApprovedPayloadSale(address _buyer, address _receiver, uint256 _number_of_items, uint256 _amount);
    event ApprovedTokenPayloadSale(address _buyer, address _receiver, uint256 _number_of_items, uint256 _amount);

    event ETHSale(address _buyer, address _receiver, uint256 _number_of_items, uint256 _amount);
    event TokenSale(address _buyer, address _receiver, uint256 _number_of_items, uint256 _amount);

    uint8 constant TRANSFER_TYPE_ETH = 1;
    uint8 constant TRANSFER_TYPE_ERC20 = 2;

    uint8 constant BUY_TYPE_APSALE = 1;
    uint8 constant BUY_TYPE_SALE = 2;

    constructor(address _galaxisRegistry) UsesGalaxisRegistry(_galaxisRegistry){
        //_initialized = true;
    }

    function init(SaleConfiguration calldata config, address newOwner) external {
        require(!_initialized, "Sale: Contract already initialized");
        require(config.projectID > 0, "Sale: Project id must be higher than 0");
        require(config.token != address(0), "Sale: Token address can not be address(0)");
 
        projectID = config.projectID;
        token = IToken(config.token);

        TokenInfoForSale memory tinfo = token.getTokenInfoForSale();
        require(config.projectID == tinfo.projectID, "Sale: Project id must match");

        _UpdateSaleConfiguration(config);
        _UpdateWalletsAndShares(config.wallets, config.shares);
        _transferOwnership(newOwner);

        // is membership card contract?
        isMembership = isMembershipCard(config);
        _initialized = true;
    }

    function isMembershipCard(SaleConfiguration calldata config) internal view returns(bool) {
        CommunityList COMMUNITY_LIST = CommunityList(galaxisRegistry.getRegistryAddress("COMMUNITY_LIST"));
        (,address crAddr,) = COMMUNITY_LIST.communities(uint32(projectID));
        CommunityRegistry myCommunityRegistry = CommunityRegistry(crAddr);

        address firstTokenAddress = myCommunityRegistry.getRegistryAddress("TOKEN_1");
        if(config.token == firstTokenAddress) {
            return true;
        }
        return false;
    }

    function UpdateSaleConfiguration(SaleConfiguration memory config) public onlyAllowed {
        _UpdateSaleConfiguration(config);
    }

    function _UpdateSaleConfiguration(SaleConfiguration memory config) internal {


        // How many tokens a transaction can mint
        _maxMintPerTransaction = config.maxMintPerTransaction;

        // Number of tokens to be sold in approvedsale 
        _maxApprovedSale = config.maxApprovedSale;

        // Limit approvedsale mints per address
        _maxApprovedSalePerAddress = config.maxApprovedSalePerAddress;

        // Limit sale mints per address ( must include _maxApprovedSalePerAddress value )
        _maxSalePerAddress = config.maxSalePerAddress;

        _approvedsaleStart  = config.approvedsaleStart;
        _approvedsaleEnd    = config.approvedsaleEnd;
        _saleStart          = config.saleStart;
        _saleEnd            = config.saleEnd;

        _fullPrice          = config.fullPrice;
        _fullERC20Price     = config.fullERC20Price;
        _ethSaleEnabled     = config.ethSaleEnabled;
        _erc20SaleEnabled   = config.erc20SaleEnabled;
        _erc20tokenAddress  = config.erc20tokenAddress;

        // if provided use it.
        if(config.maxUserMintable > 0) {
            _maxUserMintable = config.maxUserMintable;
        } else {
            // Calculate how many tokens can be minted through the sale contract by normal users
            TokenInfoForSale memory tinfo = token.getTokenInfoForSale();
            _maxUserMintable = tinfo.maxSupply - tinfo.reservedSupply;
        }

        // Signed data signer address
        _projectSigner = config.signer;
    }

    /**
     * @dev Admin: Update wallets and shares
     */
    function UpdateWalletsAndShares(
        address payable[] memory _newWallets,
        uint16[] memory _newShares
    ) public onlyAllowed {
        _UpdateWalletsAndShares(_newWallets,_newShares);
    }

    function _UpdateWalletsAndShares(
        address payable[] memory _newWallets,
        uint16[] memory _newShares
    ) internal {
        require(_newWallets.length == _newShares.length && _newWallets.length > 0, "Sale: Must have at least 1 output wallet");
        uint16 totalShares = 0;
        for (uint8 j = 0; j < _newShares.length; j++) {
            totalShares+= _newShares[j];
        }
        require(totalShares == 10000, "Sale: Shares total must be 10000");
        _shares = _newShares;
        _wallets = _newWallets;
    }

    /**
     * @dev Public Sale minting
     */
    function mint(uint256 _numberOfCards) external payable {
        _internalMint(_numberOfCards, msg.sender, msg.value, TRANSFER_TYPE_ETH);
    }

    /**
     * @dev Public Sale cross mint
     */
    function crossmint(uint256 _numberOfCards, address _receiver) external payable {
        _internalMint(_numberOfCards, _receiver, msg.value, TRANSFER_TYPE_ETH);
    }

    /**
     * @dev Public Sale minting
     */
    function _internalMint(uint256 _numberOfCards, address _receiver, uint256 _value, uint8 _section) internal {
        require(checkSaleIsActive(),                            "Sale: Sale is not open");
        require(_numberOfCards <= _maxMintPerTransaction,       "Sale: Over maximum number per transaction");

        uint256 checkPrice = 0;
        uint8 transferType = 0;
        uint256 number_of_items = 0;

        if(_fullPrice == 0) {
            require(_value == 0, "Sale: ETH sent must be 0");
            number_of_items = _numberOfCards;
        } else {
            if(_section == TRANSFER_TYPE_ETH) {
                require(_ethSaleEnabled,                            "Sale: ETH Sale is not enabled");
                checkPrice = _fullPrice;
                transferType = TRANSFER_TYPE_ETH;
            } else {
                require(_erc20SaleEnabled,                           "Sale: Token Sale is not enabled");
                checkPrice = _fullERC20Price;
                transferType = TRANSFER_TYPE_ERC20;
            }
            number_of_items = _value / checkPrice;
            require(number_of_items == _numberOfCards,              "Sale: Value sent does not match items requested");
            require(number_of_items * checkPrice == _value,         "Sale: Incorrect amount sent");
        }

        uint256 _sold = _mintedByWallet[_receiver];
        require(_sold < _maxSalePerAddress,                     "Sale: You have already minted your allowance");
        require(_sold + number_of_items <= _maxSalePerAddress,  "Sale: That would put you over your approvedsale limit");

        _mintedByWallet[_receiver]+= number_of_items;

        _mintCards(number_of_items, _receiver);

        if(_fullPrice > 0) {
            _split(_value, transferType);
        }

        if(_section == TRANSFER_TYPE_ETH) {
            emit ETHSale(msg.sender, _receiver, number_of_items, _value);
        } else {
            emit TokenSale(msg.sender, _receiver, number_of_items, _value);
        }
    }

    function buyWithERC20(uint256 amount, IERC20 _erc20Token, bytes memory userData) external {
        require(address(_erc20Token) == _erc20tokenAddress ,"Sale: Invalid Token");
        require(_erc20Token.allowance(msg.sender,address(this))>= amount,"Sale: Insufficient amount approved");
        require(_erc20Token.balanceOf(msg.sender) >= amount,"Sale: buyer has insufficient funds");
        require(_erc20Token.transferFrom(msg.sender,address(this),amount),"Sale: token transfer failed");
        // Decode userData tokenPayload(uint256, SaleSignedPayload) manually 
        // because solidity doesn't support nested structs
        // 
        // will not work:  tokenPayload memory receivedTokenPayload  = abi.decode(userData, (tokenPayload));

        (uint8 buyType, uint256 numberOfCards, SaleSignedPayload memory payload) = abi.decode(userData, (uint8, uint256, SaleSignedPayload));
         
        if(buyType == BUY_TYPE_APSALE) {

            // Make sure that from is actually the intended receiver
            require(payload.receiver == msg.sender, "Payload Verify: Invalid receiver");

            verify_payload_rules(payload, amount, numberOfCards, TRANSFER_TYPE_ERC20);

            _mintedByWallet[payload.receiver]+= numberOfCards;

            // Cards will be minted into the specified receiver
            _mintCards(numberOfCards, payload.receiver);
            
            if(!payload.free) {
                _split(amount, TRANSFER_TYPE_ERC20);
            }

            emit ApprovedTokenPayloadSale(msg.sender, msg.sender, numberOfCards, amount);

        } else if(buyType == BUY_TYPE_SALE) {
            _internalMint(numberOfCards, msg.sender, amount, TRANSFER_TYPE_ERC20);
            emit TokenSale(msg.sender, msg.sender, numberOfCards, amount);
        }
    }

    /**
     * @dev Internal mint method
     */
    function _mintCards(uint256 numberOfCards, address recipient) internal {
        
        // if this is a membership card contract, minter needs to hold GALAXIS tokens
        if(isMembership) {
            IERC20 galaxisToken = IERC20(galaxisRegistry.getRegistryAddress("GALAXIS_TOKEN"));
            uint256 requiredBalance = galaxisRegistry.getRegistryUINT("MEMBERSHIP_MINT_GALAXIS_AMOUNT");
            require(galaxisToken.balanceOf(recipient) >= requiredBalance, "Sale: Token Balance insufficient for membership mint");
        }

        _userMinted+= numberOfCards;
        require(
            _userMinted <= _maxUserMintable,
            "Sale: Exceeds maximum number of user mintable cards"
        );
        token.mintIncrementalCards(numberOfCards, recipient);
    }

    function verify_payload_rules(SaleSignedPayload memory _payload, uint256 _value, uint256 _numberOfCards, uint8 _section) internal view {

        require(_numberOfCards <= _maxMintPerTransaction, "APSale: Over maximum number per transaction");
        require(_numberOfCards + _userMinted <= _maxApprovedSale, "APSale: ApprovedSale maximum reached");

        // Make sure it can only be called if approvedsale is active
        require(checkApprovedSaleIsActive(), "APSale: ApprovedSale is not active");

        // First make sure the received payload was signed by _projectSigner
        require(verify(_payload), "APSale: SignedPayload verification failed");

        // Make sure that payload.projectID matches
        require(_payload.projectID == projectID, "APSale Verify: Invalid projectID");

        // Make sure that payload.chainID matches
        require(_payload.chainID == block.chainid, "APSale Verify: Invalid chainID");

        // Make sure in date range
        require(_payload.valid_from < _payload.valid_to, "APSale: Invalid from/to range in payload");
        require(
            getBlockTimestamp() >= _payload.valid_from &&
            getBlockTimestamp() <= _payload.valid_to,
            "APSale: Contract time outside from/to range"
        );

        uint256 number_of_items = 0;
        if(_payload.free) {
            number_of_items = _numberOfCards;
            require(_value == 0, "APSale: value needs to be 0");
        } else {

            uint256 checkPrice = 0;
            if(_section == TRANSFER_TYPE_ETH) {
                checkPrice = _payload.eth_price;
            } else {
                // } else if(_section == TRANSFER_TYPE_ERC20) {
                checkPrice = _payload.erc20_price;
            }
            
            number_of_items = _value / checkPrice;
            require(number_of_items == _numberOfCards, "APSale: Value sent does not match items requested");
            require(number_of_items * checkPrice == _value, "APSale: Incorrect amount sent");
        }

        uint256 _presold = _mintedByWallet[_payload.receiver];
        require(_presold < _payload.max_mint, "APSale: You have already minted your allowance");
        require(_presold + number_of_items <= _payload.max_mint, "APSale: That would put you over your approvedsale limit");

    }

    /**
     * @dev Mint tokens as specified in the signed payload
     */

    function mint_approved(SaleSignedPayload memory _payload, uint256 _numberOfCards) external payable {

        // Make sure that msg.sender is actually the intended receiver
        require(_payload.receiver == msg.sender, "APSale Verify: Invalid receiver");

        verify_payload_rules(_payload, msg.value, _numberOfCards, TRANSFER_TYPE_ETH);

        _mintedByWallet[msg.sender]+= _numberOfCards;

        // Cards will be minted into the specified receiver
        _mintCards(_numberOfCards, msg.sender);
        
        if(!_payload.free) {
            _split(msg.value, TRANSFER_TYPE_ETH);
        }

        emit ApprovedPayloadSale(msg.sender, msg.sender, _numberOfCards, msg.value);
    }

    /**
     * @dev Verify signed payload
     */
    function verify(SaleSignedPayload memory info) public view returns (bool) {
        require(info.signature.length == 65, "Sale Verify: Invalid signature length");

        bytes memory encodedPayload = abi.encode(
            info.projectID,
            info.chainID,
            info.free,
            info.max_mint,
            info.receiver,
            info.valid_from,
            info.valid_to,
            info.eth_price,
            info.erc20_price
        );

        bytes32 hash = keccak256(encodedPayload);

        bytes32 sigR;
        bytes32 sigS;
        uint8 sigV;
        bytes memory signature = info.signature;
        // ecrecover takes the signature parameters, and the only way to get them
        // currently is to use assembly.
        assembly {
            sigR := mload(add(signature, 0x20))
            sigS := mload(add(signature, 0x40))
            sigV := byte(0, mload(add(signature, 0x60)))
        }

        bytes32 data = keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
        address recovered = ecrecover(data, sigV, sigR, sigS);
        return recovered == _projectSigner;
    }

    /**
     * @dev Is approvedsale active?
     */
    function checkApprovedSaleIsActive() public view returns (bool) {
        if ( (_approvedsaleStart <= getBlockTimestamp()) && (_approvedsaleEnd >= getBlockTimestamp())) {
            return true;
        }
        return false;
    }

    /**
     * @dev Is sale active?
     */
    function checkSaleIsActive() public view returns (bool) {
        if ((_saleStart <= getBlockTimestamp()) && (_saleEnd >= getBlockTimestamp())) {
            return true;
        }
        return false;
    }

    /**
     * @dev Royalties splitter
     */
    receive() external payable {
        _split(msg.value, TRANSFER_TYPE_ETH);
    }

    /**
     * @dev Internal output splitter
     */
    function _split(uint256 amount, uint8 transferType) internal {
        bool sent;
        uint256 _total;

        for (uint256 j = 0; j < _wallets.length; j++) {
            uint256 _amount = (amount * _shares[j]) / 10000;
            if (j == _wallets.length - 1) {
                _amount = amount - _total;
            } else {
                _total += _amount;
            }
            
            if(transferType == TRANSFER_TYPE_ETH) {
                (sent,) = _wallets[j].call{value: _amount}("");
                require(sent, "Sale: Splitter failed to send ether");
            }
            else if(transferType == TRANSFER_TYPE_ERC20) {
                sent = IERC20(_erc20tokenAddress).transfer(_wallets[j], _amount);
                require(sent, "Sale: Splitter failed to send ERC20");
            }
        }
    }

    modifier onlyAllowed() { 
        require( msg.sender == owner() || token.isAllowed(token.TOKEN_CONTRACT_ACCESS_SALE(), msg.sender), "Sale: Unauthorised");
        _;
    }
 
    function tellEverything() external view returns (SaleInfo memory) {
        
        return SaleInfo(
            SaleConfiguration(
                projectID,
                address(token),
                _wallets,
                _shares,
                _maxMintPerTransaction,
                _maxApprovedSale,
                _maxApprovedSalePerAddress,
                _maxSalePerAddress,
                _approvedsaleStart,
                _approvedsaleEnd,
                _saleStart,
                _saleEnd,
                _fullPrice,
                _maxUserMintable,
                _projectSigner,
                _fullERC20Price,
                _ethSaleEnabled,
                _erc20SaleEnabled,
                _erc20tokenAddress
            ),
            _userMinted,
            checkApprovedSaleIsActive(),
            checkSaleIsActive(),
            version(),
            isMembership
        );
    }

    function getBlockTimestamp() public view virtual returns(uint256) {
        return block.timestamp;
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

interface IRegistry {
    function setRegistryAddress(string memory fn, address value) external ;
    function setRegistryBool(string memory fn, bool value) external ;
    function setRegistryUINT(string memory key) external returns (uint256) ;
    function setRegistryString(string memory fn, string memory value) external ;
    function setAdmin(address user,bool status ) external;
    function setAppAdmin(address app, address user, bool state) external;

    function getRegistryAddress(string memory key) external view returns (address) ;
    function getRegistryBool(string memory key) external view returns (bool);
    function getRegistryUINT(string memory key) external view returns (uint256) ;
    function getRegistryString(string memory key) external view returns (string memory) ;
    function isAdmin(address user) external view returns (bool) ;
    function isAppAdmin(address app, address user) external view returns (bool);

    function numberOfAddresses() external view returns(uint256);
    function addressEntries(uint256) external view returns(string memory);
}

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

pragma solidity ^0.8.20;

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

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev There's no code at `target` (it is not a contract).
     */
    error AddressEmptyCode(address target);

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

        (bool success, bytes memory returndata) = recipient.call{value: amount}("");
        if (!success) {
            _revert(returndata);
        }
    }

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

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

pragma solidity ^0.8.20;

/**
 * @dev External interface of AccessControl declared to support ERC-165 detection.
 */
interface IAccessControl {
    /**
     * @dev The `account` is missing a role.
     */
    error AccessControlUnauthorizedAccount(address account, bytes32 neededRole);

    /**
     * @dev The caller of a function is not the expected one.
     *
     * NOTE: Don't confuse with {AccessControlUnauthorizedAccount}.
     */
    error AccessControlBadConfirmation();

    /**
     * @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.
     */
    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. This account bears the admin role (for the granted role).
     * Expected in cases where the role was granted using the internal {AccessControl-_grantRole}.
     */
    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 `callerConfirmation`.
     */
    function renounceRole(bytes32 role, address callerConfirmation) external;
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (access/extensions/AccessControlEnumerable.sol)

pragma solidity ^0.8.20;

import {IAccessControlEnumerable} from "./IAccessControlEnumerable.sol";
import {AccessControl} from "../AccessControl.sol";
import {EnumerableSet} from "../../utils/structs/EnumerableSet.sol";

/**
 * @dev Extension of {AccessControl} that allows enumerating the members of each role.
 */
abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {
    using EnumerableSet for EnumerableSet.AddressSet;

    mapping(bytes32 role => EnumerableSet.AddressSet) private _roleMembers;

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IAccessControlEnumerable).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 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 returns (uint256) {
        return _roleMembers[role].length();
    }

    /**
     * @dev Return all accounts that have `role`
     *
     * 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 getRoleMembers(bytes32 role) public view virtual returns (address[] memory) {
        return _roleMembers[role].values();
    }

    /**
     * @dev Overload {AccessControl-_grantRole} to track enumerable memberships
     */
    function _grantRole(bytes32 role, address account) internal virtual override returns (bool) {
        bool granted = super._grantRole(role, account);
        if (granted) {
            _roleMembers[role].add(account);
        }
        return granted;
    }

    /**
     * @dev Overload {AccessControl-_revokeRole} to track enumerable memberships
     */
    function _revokeRole(bytes32 role, address account) internal virtual override returns (bool) {
        bool revoked = super._revokeRole(role, account);
        if (revoked) {
            _roleMembers[role].remove(account);
        }
        return revoked;
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

import "./IToken.sol";
import "../interfaces/IRegistryConsumer.sol";
import "../interfaces/IRandomNumberProvider.sol";
import "../interfaces/IRandomNumberRequester.sol";
import "../extras/recovery/BlackHolePrevention.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "../overrides/ERC721Enumerable.sol";
import "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
import "../../@galaxis/registries/contracts/CommunityList.sol";
import "../../@galaxis/registries/contracts/CommunityRegistry.sol";
import "../../@galaxis/registries/contracts/UsesGalaxisRegistry.sol";
import "../../@galaxis/registries/contracts/Versionable/IVersionable.sol";


contract LockableRevealERC721EnumerableToken is IToken, ERC721Enumerable, Ownable, BlackHolePrevention, UsesGalaxisRegistry, IVersionable { 

    function version() public pure returns (uint256) {
        return 2024040301;
    }

    using Strings  for uint256; 
 
    bytes32 public constant TOKEN_CONTRACT_GIVEAWAY         = keccak256("TOKEN_CONTRACT_GIVEAWAY");
    bytes32 public constant TOKEN_CONTRACT_ACCESS_SALE      = keccak256("TOKEN_CONTRACT_ACCESS_SALE");
    bytes32 public constant TOKEN_CONTRACT_ACCESS_ADMIN     = keccak256("TOKEN_CONTRACT_ACCESS_ADMIN");
    bytes32 public constant TOKEN_CONTRACT_ACCESS_LOCK      = keccak256("TOKEN_CONTRACT_ACCESS_LOCK");
    bytes32 public constant TOKEN_CONTRACT_ACCESS_REVEAL    = keccak256("TOKEN_CONTRACT_ACCESS_REVEAL");

    constructor(address _galaxisRegistry)  UsesGalaxisRegistry(_galaxisRegistry){
        setup("GOLDEN_TOKEN_CONTRACT","GT");
        //_initialized = true;
    }

    string              constant    public REGISTRY_KEY_RANDOM_CONTRACT = "RANDOMV2_SSP";
    string              constant    public USER_RANDOM = "USER_RANDOM";
    bool                constant    public useCommunityRandom = true;

    uint256                         public projectID;
    uint256                         public maxSupply;
    uint256                         public mintedSupply;    // minted incrementally
    uint256                         public mintedReserve;   
    uint256                         public reservedSupply;  // includes giveaway supply
    uint256                         public giveawaySupply;

    string                          public tokenPreRevealURI;
    string                          public tokenRevealURI;
    bool                            public transferLocked;
    bool                            public lastRevealRequested;

    mapping(uint16 => revealStruct) public reveals;
    mapping(uint256 => uint16)      public requestToRevealId;
    string                          public revealURI;
    uint16                          public currentRevealCount;
    string                          public contractURI;
    bool                            _initialized;
    bool                            public VRFShifting;
    string                          public chain;

    string                          private _name;
    string                          private _symbol;
    
    CommunityRegistry               public myCommunityRegistry;

    using EnumerableSet for EnumerableSet.AddressSet;
    // onlyOwner can change contractControllers and transfer it's ownership
    // any contractController can setData
    EnumerableSet.AddressSet contractControllers;
    event contractControllerEvent(address _address, bool mode);
    EnumerableSet.AddressSet contractManagers;
    event contractManagerEvent(address _address, bool mode);

    event Locked(bool);
    event RandomProcessed(uint256 stage, uint256 randNumber, uint256 _shiftsBy, uint256 _start, uint256 _end);
    event ContractURIset(string contractURI);

    function init(TokenConstructorConfig memory config, address _actualOwner ) public virtual  {
        require(!_initialized, "Token: Contract already initialized");
        _name = config.erc721name;
        _symbol = config.erc721symbol;
        projectID           = config.projectID;
        tokenPreRevealURI   = config.tokenPreRevealURI;
        tokenRevealURI      = config.tokenRevealURI;
        maxSupply           = config.maxSupply;
        transferLocked      = config.transferLocked;
        reservedSupply      = config.reservedSupply;
        giveawaySupply      = config.giveawaySupply;

        CommunityList COMMUNITY_LIST = CommunityList(galaxisRegistry.getRegistryAddress("COMMUNITY_LIST"));
        (,address crAddr,) = COMMUNITY_LIST.communities(uint32(projectID));
        myCommunityRegistry = CommunityRegistry(crAddr);

        VRFShifting = config.VRFShifting;

        uint256 id;
        assembly {
            id := chainid()
        }

        chain = id.toString();
        _transferOwnership(_actualOwner);
        _initialized = true;
    }


    /**
     * @dev Hook that is called before any token transfer. This includes minting
     * and burning.
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 _tokenId
    ) internal override {
        if(from != address(0)) {
            require(!transferLocked, "Token: Transfers are not enabled");
        }
        super._beforeTokenTransfer(from, to, _tokenId);
    }

    /**
     * @dev Sale: mint cards.
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_SALE
     */
    function mintIncrementalCards(uint256 numberOfCards, address recipient) external onlyAllowed(TOKEN_CONTRACT_ACCESS_SALE) {
        require(!lastRevealRequested, "Token: Cannot mint after last reveal");
        require(mintedSupply + numberOfCards <= maxSupply - reservedSupply, "Token: This would exceed the number of cards available");
        uint256 mintId = mintedSupply + 1;
        for (uint j = 0; j < numberOfCards; j++) {
            _mint(recipient, mintId++);
        }
        mintedSupply+=numberOfCards;
    }

    /**
     * @dev Admin: mint reserved cards.
     *   Should only mint reserved AFTER the sale is over.
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_ADMIN
     */
    function mintReservedCards(uint256 numberOfCards, address recipient) external onlyAllowed(TOKEN_CONTRACT_ACCESS_ADMIN) {
        require(lastRevealRequested, "Token: Last reveal must be requested first");
        require(mintedReserve + numberOfCards <= reservedSupply - giveawaySupply, "Token: This would exceed the number of reserved cards available");
        uint256 mintId = mintedSupply + mintedReserve + 1;
        for (uint j = 0; j < numberOfCards; j++) {
            _mint(recipient, mintId++);
        }
        mintedReserve+=numberOfCards;
    }

    /**
     * @dev DropRegistry util
     */
    function getFirstGiveawayCardId() public view returns (uint256) {
        return mintedSupply + reservedSupply - giveawaySupply + 1;
    }

    /**
     * @dev DropRegistry: mint specific giveaway card.
     *   Can only mint after reserve has been minted.
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_GIVEAWAY
     */
    function mintGiveawayCard(uint256 _index, address _recipient) external onlyAllowed(TOKEN_CONTRACT_GIVEAWAY) {
        require(lastRevealRequested, "Token: Last reveal must be requested first");
        require(mintedReserve == reservedSupply - giveawaySupply, "Token: Must mint reserved cards first");
        uint256 firstIndex = getFirstGiveawayCardId();
        require( _index >= firstIndex && _index < firstIndex + giveawaySupply, "Token: Card id not in range");
        _mint(_recipient, _index);
    }

    /**
     * @dev Admin: set PreRevealURI
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_ADMIN
     */
    function setPreRevealURI(string calldata _tokenPreRevealURI) external onlyAllowed(TOKEN_CONTRACT_ACCESS_ADMIN) {
        tokenPreRevealURI = _tokenPreRevealURI;
    }

    /**
     * @dev Admin: set RevealURI
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_ADMIN
     */
    function setRevealURI(string calldata _tokenRevealURI) external onlyAllowed(TOKEN_CONTRACT_ACCESS_ADMIN) {
        tokenRevealURI = _tokenRevealURI;
    }

    function getRandomSource() internal view returns (IRandomNumberProvider) {
        // console.log("*",useCommunityRandom,address(myCommunityRegistry),myCommunityRegistry.getRegistryAddress(USER_RANDOM));
        if (useCommunityRandom) {
            return IRandomNumberProvider(myCommunityRegistry.getRegistryAddress(USER_RANDOM));
        } else {
            return IRandomNumberProvider(galaxisRegistry.getRegistryAddress(REGISTRY_KEY_RANDOM_CONTRACT));
        }
    }

    /**
     * @dev Admin: reveal tokens starting at prev range end to current supply
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_REVEAL
     */
    function revealAtCurrentSupply() external onlyAllowed(TOKEN_CONTRACT_ACCESS_REVEAL) {
        require(VRFShifting, "Token: VRF Shifting must be enabled");
        require(!lastRevealRequested, "Token: Last reveal already requested");
        require(reveals[currentRevealCount].RANGE_END < mintedSupply, "Token: Reveal request already exists");

        // make sure we have minted at least 1 token, else process() will fail with modulo / div by 0

        revealStruct storage currentReveal = reveals[++currentRevealCount];

        // if previous RANGE_END does not exist, this is 0
        currentReveal.RANGE_START = reveals[currentRevealCount-1].RANGE_END;
        currentReveal.RANGE_END = mintedSupply;

        require(currentReveal.RANGE_END - currentReveal.RANGE_START > 0, "Token: requires minted tokens for current range to be at least 1");

        //
        // console.log(mintedSupply , reservedSupply , maxSupply);
        require(mintedSupply + reservedSupply < maxSupply, "Token: Please request LastReveal");

        currentReveal.REQUEST_ID = getRandomSource().requestRandomNumberWithCallback();
        requestToRevealId[currentReveal.REQUEST_ID] = currentRevealCount;
    }

    /**
     * @dev Admin: reveal tokens starting at prev range end to:
     *      - if(!VRFShifting) then RANGE_END = maxSupply
     *      - if(VRFShifting) then RANGE_END = maxSupply
     *
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_REVEAL
     */
    function lastReveal() external onlyAllowed(TOKEN_CONTRACT_ACCESS_REVEAL) {
        require(!lastRevealRequested, "Token: Last reveal already requested");
        require(reveals[currentRevealCount].RANGE_END < maxSupply, "Token: Reveal request already exists");
        lastRevealRequested = true;
        revealStruct storage currentReveal = reveals[++currentRevealCount];

        // if previous RANGE_END does not exist, this is 0
        currentReveal.RANGE_START = reveals[currentRevealCount-1].RANGE_END;

        // Normal VRF Shifting process
        if(VRFShifting) {
            // since reservedSupply 

            currentReveal.RANGE_END = mintedSupply + reservedSupply;
            // currentReveal.RANGE_END = maxSupply;

            require(currentReveal.RANGE_END - currentReveal.RANGE_START > 0, "Token: requires minted tokens for current range to be at least 1");
            // console.log("241 ",address(getRandomSource()));
            currentReveal.REQUEST_ID = getRandomSource().requestRandomNumberWithCallback();
            requestToRevealId[currentReveal.REQUEST_ID] = currentRevealCount;
        } else {
            require(mintedSupply > 0, "Token: requires minted tokens for current range to be at least 1");
            
            // Non shifted token
            // Does not do a VRF call
            // Just sets max supply as revealed and emits RandomProcessed so Metadata Server ca pick it up and reveal things

            currentReveal.RANDOM_NUM = 0;
            currentReveal.SHIFT = 0;
            currentReveal.RANGE_START = 0;
            currentReveal.RANGE_END = maxSupply;

            emit RandomProcessed(
                currentRevealCount,
                currentReveal.RANDOM_NUM,
                currentReveal.SHIFT,
                currentReveal.RANGE_START,
                currentReveal.RANGE_END
            );
        }

    }

    /**
     * @dev Chainlink VRF callback
     */
    function process(uint256 _random, uint256 _requestId) external {
        require(VRFShifting, "Token: VRF Shifting must be enabled");
        require(
            msg.sender == address(getRandomSource()), 
            "Token: process() Unauthorised caller"
        );

        // get reveal using _requestId
        uint16 thisRevealId = requestToRevealId[_requestId];
        revealStruct storage thisReveal = reveals[thisRevealId];

        require(!thisReveal.processed, "Token: reveal already processed.");

        if(thisReveal.REQUEST_ID == _requestId) {
            thisReveal.RANDOM_NUM = _random / 2; // Set msb to zero

            // in the very rare case where RANDOM_NUM is 0, use currentReveal.RANGE_END / 3
            if(thisReveal.RANDOM_NUM == 0) {
                thisReveal.RANDOM_NUM = thisReveal.RANGE_END * (10 ** 5) / 3;
            }

            thisReveal.SHIFT = thisReveal.RANDOM_NUM % ( thisReveal.RANGE_END - thisReveal.RANGE_START );
            
            // in the very rare case where the shifting result is 0, do it again but divide by 3
            if(thisReveal.SHIFT == 0) {
                thisReveal.RANDOM_NUM = thisReveal.RANDOM_NUM / 3;
                thisReveal.SHIFT = thisReveal.RANDOM_NUM % ( thisReveal.RANGE_END - thisReveal.RANGE_START );
            }

            thisReveal.processed = true;

            emit RandomProcessed(
                thisRevealId,
                thisReveal.RANDOM_NUM,
                thisReveal.SHIFT,
                thisReveal.RANGE_START,
                thisReveal.RANGE_END
            );

        } else revert("Token: Incorrect requestId received");
    }


    function findRevealRangeForN(uint256 n) public view returns (uint16) {
        for(uint16 i = 1; i <= currentRevealCount; i++) {
            if(n <= reveals[i].RANGE_END) {
                return i;
            }
        }
        return 0;
    }

    function uri(uint256 n) public view returns (uint256) {
        uint16 rangeId = findRevealRangeForN(n); 
        // outside ranges
        if(rangeId == 0) {
            return n;
        }

        revealStruct memory currentReveal = reveals[rangeId];
        uint256 shiftedN = n + currentReveal.SHIFT;
        if (shiftedN <= currentReveal.RANGE_END) {
            return shiftedN;
        }
        return currentReveal.RANGE_START + shiftedN - currentReveal.RANGE_END;
    }

    /**
    * @dev Reserved are always at the end of current minted 
    */
    function _reserved(uint256 _tokenId) public view returns (bool) {
        if(_tokenId > mintedSupply + mintedReserve && _tokenId <= mintedSupply + reservedSupply) {
            return true;
        }
        return false;
    }

    /**
    * @dev Get metadata server url for tokenId
    */
    function tokenURI(uint256 _tokenId) public view override(IToken, ERC721) returns (string memory) {
        require(_exists(_tokenId) || _reserved(_tokenId), 'Token: Token does not exist');

        if(VRFShifting) {
            
            uint16 rangeId = findRevealRangeForN(_tokenId);
            // outside ranges
            if(rangeId == 0) {
                return tokenPreRevealURI;
            }

            revealStruct memory currentReveal = reveals[rangeId];

            // if random number was not set, return pre reveal
            // TODO: most likely remove this.. as we never get here.. we're already outside range
            if(currentReveal.RANDOM_NUM == 0) {
                return tokenPreRevealURI;
            }
        }

        uint256 newTokenId = uri(_tokenId);        
        string memory folder = (newTokenId % 100).toString(); 
        string memory file = newTokenId.toString();
        string memory slash = "/";
        return string.concat(tokenRevealURI, chain, slash, folder, slash, file);
    }

    /**
     * @dev Admin: Lock / Unlock transfers
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_LOCK
     */
    function setTransferLock(bool _locked) external onlyAllowed(TOKEN_CONTRACT_ACCESS_LOCK) {
        transferLocked = _locked;
        emit Locked(_locked);
    }


    function hasRole(bytes32 key, address user) public view returns (bool) {
        return myCommunityRegistry.hasRole(key, user);
    }

    /**
     * @dev Admin: Allow / Dissalow addresses
     */

    modifier onlyAllowed(bytes32 role) { 
        require(isAllowed(role, msg.sender), "Token: Unauthorised");
        _;
    }

    function isAllowed(bytes32 role, address user) public view returns (bool) { 
        return( user == owner() || hasRole(role, user));
    }

    function tellEverything() external view returns (TokenInfo memory) {
        
        revealStruct[] memory _reveals = new revealStruct[](currentRevealCount);
        for(uint16 i = 1; i <= currentRevealCount; i++) {
            _reveals[i - 1] = reveals[i];
        }

        uint256 contractManagers_length = contractManagers.length();
        address[] memory _managers = new address[](contractManagers_length);
        for(uint16 i = 0; i < contractManagers_length; i++) {
            _managers[i] = contractManagers.at(i);
        }

        uint256 contractControllers_length = contractControllers.length();
        address[] memory _controllers = new address[](contractControllers_length);
        for(uint16 i = 0; i < contractControllers_length; i++) {
            _controllers[i] = contractControllers.at(i);
        }

        return TokenInfo(
            name(),
            symbol(),
            projectID,
            maxSupply,
            mintedSupply,
            mintedReserve,
            reservedSupply,
            giveawaySupply,
            tokenPreRevealURI,
            tokenRevealURI,
            transferLocked,
            lastRevealRequested,
            totalSupply(),
            _reveals,
            owner(),
            _managers,
            _controllers,
            version(),
            VRFShifting
        );
    }

    function getTokenInfoForSale() external view returns (TokenInfoForSale memory) {
        return TokenInfoForSale(
            projectID,
            maxSupply,
            reservedSupply
        );
    }

    function name() public view override returns (string memory) {
        return _name;
    }

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


    /**
     * @dev Admin: set setContractURI
     * - DEFAULT_ADMIN_ROLE or TOKEN_CONTRACT_ACCESS_ADMIN
     */
    function setContractURI(string memory _contractURI) external onlyAllowed(TOKEN_CONTRACT_ACCESS_ADMIN) {
        contractURI = _contractURI;
        emit ContractURIset(_contractURI);
    }
}

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

pragma solidity ^0.8.20;

import {Panic} from "../Panic.sol";
import {SafeCast} from "./SafeCast.sol";

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Floor, // Toward negative infinity
        Ceil, // Toward positive infinity
        Trunc, // Toward zero
        Expand // Away from zero
    }

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

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

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

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

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

    /**
     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
     *
     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
     * one branch when needed, making this function more expensive.
     */
    function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {
        unchecked {
            // branchless ternary works because:
            // b ^ (a ^ b) == a
            // b ^ 0 == b
            return b ^ ((a ^ b) * SafeCast.toUint(condition));
        }
    }

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

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

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

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

        // The following calculation ensures accurate ceiling division without overflow.
        // Since a is non-zero, (a - 1) / b will not overflow.
        // The largest possible result occurs when (a - 1) / b is type(uint256).max,
        // but the largest value we can obtain is type(uint256).max - 1, which happens
        // when a = type(uint256).max and b = 1.
        unchecked {
            return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);
        }
    }

    /**
     * @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
     * denominator == 0.
     *
     * 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²⁵⁶ and mod 2²⁵⁶ - 1, then use
            // the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2²⁵⁶ + prod0.
            uint256 prod0 = x * y; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

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

            // Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0.
            if (denominator <= prod1) {
                Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));
            }

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

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

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

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

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

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

                // Flip twos such that it is 2²⁵⁶ / 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²⁵⁶. Now that denominator is an odd number, it has an inverse modulo 2²⁵⁶ such
            // that denominator * inv ≡ 1 mod 2²⁵⁶. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv ≡ 1 mod 2⁴.
            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⁸
            inverse *= 2 - denominator * inverse; // inverse mod 2¹⁶
            inverse *= 2 - denominator * inverse; // inverse mod 2³²
            inverse *= 2 - denominator * inverse; // inverse mod 2⁶⁴
            inverse *= 2 - denominator * inverse; // inverse mod 2¹²⁸
            inverse *= 2 - denominator * inverse; // inverse mod 2²⁵⁶

            // 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²⁵⁶. Since the preconditions guarantee that the outcome is
            // less than 2²⁵⁶, 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;
        }
    }

    /**
     * @dev 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) {
        return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);
    }

    /**
     * @dev Calculate the modular multiplicative inverse of a number in Z/nZ.
     *
     * If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.
     * If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.
     *
     * If the input value is not inversible, 0 is returned.
     *
     * NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the
     * inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.
     */
    function invMod(uint256 a, uint256 n) internal pure returns (uint256) {
        unchecked {
            if (n == 0) return 0;

            // The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)
            // Used to compute integers x and y such that: ax + ny = gcd(a, n).
            // When the gcd is 1, then the inverse of a modulo n exists and it's x.
            // ax + ny = 1
            // ax = 1 + (-y)n
            // ax ≡ 1 (mod n) # x is the inverse of a modulo n

            // If the remainder is 0 the gcd is n right away.
            uint256 remainder = a % n;
            uint256 gcd = n;

            // Therefore the initial coefficients are:
            // ax + ny = gcd(a, n) = n
            // 0a + 1n = n
            int256 x = 0;
            int256 y = 1;

            while (remainder != 0) {
                uint256 quotient = gcd / remainder;

                (gcd, remainder) = (
                    // The old remainder is the next gcd to try.
                    remainder,
                    // Compute the next remainder.
                    // Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd
                    // where gcd is at most n (capped to type(uint256).max)
                    gcd - remainder * quotient
                );

                (x, y) = (
                    // Increment the coefficient of a.
                    y,
                    // Decrement the coefficient of n.
                    // Can overflow, but the result is casted to uint256 so that the
                    // next value of y is "wrapped around" to a value between 0 and n - 1.
                    x - y * int256(quotient)
                );
            }

            if (gcd != 1) return 0; // No inverse exists.
            return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.
        }
    }

    /**
     * @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.
     *
     * From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is
     * prime, then `a**(p-1) ≡ 1 mod p`. As a consequence, we have `a * a**(p-2) ≡ 1 mod p`, which means that
     * `a**(p-2)` is the modular multiplicative inverse of a in Fp.
     *
     * NOTE: this function does NOT check that `p` is a prime greater than `2`.
     */
    function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {
        unchecked {
            return Math.modExp(a, p - 2, p);
        }
    }

    /**
     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)
     *
     * Requirements:
     * - modulus can't be zero
     * - underlying staticcall to precompile must succeed
     *
     * IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make
     * sure the chain you're using it on supports the precompiled contract for modular exponentiation
     * at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,
     * the underlying function will succeed given the lack of a revert, but the result may be incorrectly
     * interpreted as 0.
     */
    function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {
        (bool success, uint256 result) = tryModExp(b, e, m);
        if (!success) {
            Panic.panic(Panic.DIVISION_BY_ZERO);
        }
        return result;
    }

    /**
     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).
     * It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying
     * to operate modulo 0 or if the underlying precompile reverted.
     *
     * IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain
     * you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in
     * https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack
     * of a revert, but the result may be incorrectly interpreted as 0.
     */
    function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {
        if (m == 0) return (false, 0);
        assembly ("memory-safe") {
            let ptr := mload(0x40)
            // | Offset    | Content    | Content (Hex)                                                      |
            // |-----------|------------|--------------------------------------------------------------------|
            // | 0x00:0x1f | size of b  | 0x0000000000000000000000000000000000000000000000000000000000000020 |
            // | 0x20:0x3f | size of e  | 0x0000000000000000000000000000000000000000000000000000000000000020 |
            // | 0x40:0x5f | size of m  | 0x0000000000000000000000000000000000000000000000000000000000000020 |
            // | 0x60:0x7f | value of b | 0x<.............................................................b> |
            // | 0x80:0x9f | value of e | 0x<.............................................................e> |
            // | 0xa0:0xbf | value of m | 0x<.............................................................m> |
            mstore(ptr, 0x20)
            mstore(add(ptr, 0x20), 0x20)
            mstore(add(ptr, 0x40), 0x20)
            mstore(add(ptr, 0x60), b)
            mstore(add(ptr, 0x80), e)
            mstore(add(ptr, 0xa0), m)

            // Given the result < m, it's guaranteed to fit in 32 bytes,
            // so we can use the memory scratch space located at offset 0.
            success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
            result := mload(0x00)
        }
    }

    /**
     * @dev Variant of {modExp} that supports inputs of arbitrary length.
     */
    function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {
        (bool success, bytes memory result) = tryModExp(b, e, m);
        if (!success) {
            Panic.panic(Panic.DIVISION_BY_ZERO);
        }
        return result;
    }

    /**
     * @dev Variant of {tryModExp} that supports inputs of arbitrary length.
     */
    function tryModExp(
        bytes memory b,
        bytes memory e,
        bytes memory m
    ) internal view returns (bool success, bytes memory result) {
        if (_zeroBytes(m)) return (false, new bytes(0));

        uint256 mLen = m.length;

        // Encode call args in result and move the free memory pointer
        result = abi.encodePacked(b.length, e.length, mLen, b, e, m);

        assembly ("memory-safe") {
            let dataPtr := add(result, 0x20)
            // Write result on top of args to avoid allocating extra memory.
            success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)
            // Overwrite the length.
            // result.length > returndatasize() is guaranteed because returndatasize() == m.length
            mstore(result, mLen)
            // Set the memory pointer after the returned data.
            mstore(0x40, add(dataPtr, mLen))
        }
    }

    /**
     * @dev Returns whether the provided byte array is zero.
     */
    function _zeroBytes(bytes memory byteArray) private pure returns (bool) {
        for (uint256 i = 0; i < byteArray.length; ++i) {
            if (byteArray[i] != 0) {
                return false;
            }
        }
        return true;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
     * towards zero.
     *
     * This method is based on Newton's method for computing square roots; the algorithm is restricted to only
     * using integer operations.
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        unchecked {
            // Take care of easy edge cases when a == 0 or a == 1
            if (a <= 1) {
                return a;
            }

            // In this function, we use Newton's method to get a root of `f(x) := x² - a`. It involves building a
            // sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between
            // the current value as `ε_n = | x_n - sqrt(a) |`.
            //
            // For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root
            // of the target. (i.e. `2**(e-1) ≤ sqrt(a) < 2**e`). We know that `e ≤ 128` because `(2¹²⁸)² = 2²⁵⁶` is
            // bigger than any uint256.
            //
            // By noticing that
            // `2**(e-1) ≤ sqrt(a) < 2**e → (2**(e-1))² ≤ a < (2**e)² → 2**(2*e-2) ≤ a < 2**(2*e)`
            // we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar
            // to the msb function.
            uint256 aa = a;
            uint256 xn = 1;

            if (aa >= (1 << 128)) {
                aa >>= 128;
                xn <<= 64;
            }
            if (aa >= (1 << 64)) {
                aa >>= 64;
                xn <<= 32;
            }
            if (aa >= (1 << 32)) {
                aa >>= 32;
                xn <<= 16;
            }
            if (aa >= (1 << 16)) {
                aa >>= 16;
                xn <<= 8;
            }
            if (aa >= (1 << 8)) {
                aa >>= 8;
                xn <<= 4;
            }
            if (aa >= (1 << 4)) {
                aa >>= 4;
                xn <<= 2;
            }
            if (aa >= (1 << 2)) {
                xn <<= 1;
            }

            // We now have x_n such that `x_n = 2**(e-1) ≤ sqrt(a) < 2**e = 2 * x_n`. This implies ε_n ≤ 2**(e-1).
            //
            // We can refine our estimation by noticing that the middle of that interval minimizes the error.
            // If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to ε_n ≤ 2**(e-2).
            // This is going to be our x_0 (and ε_0)
            xn = (3 * xn) >> 1; // ε_0 := | x_0 - sqrt(a) | ≤ 2**(e-2)

            // From here, Newton's method give us:
            // x_{n+1} = (x_n + a / x_n) / 2
            //
            // One should note that:
            // x_{n+1}² - a = ((x_n + a / x_n) / 2)² - a
            //              = ((x_n² + a) / (2 * x_n))² - a
            //              = (x_n⁴ + 2 * a * x_n² + a²) / (4 * x_n²) - a
            //              = (x_n⁴ + 2 * a * x_n² + a² - 4 * a * x_n²) / (4 * x_n²)
            //              = (x_n⁴ - 2 * a * x_n² + a²) / (4 * x_n²)
            //              = (x_n² - a)² / (2 * x_n)²
            //              = ((x_n² - a) / (2 * x_n))²
            //              ≥ 0
            // Which proves that for all n ≥ 1, sqrt(a) ≤ x_n
            //
            // This gives us the proof of quadratic convergence of the sequence:
            // ε_{n+1} = | x_{n+1} - sqrt(a) |
            //         = | (x_n + a / x_n) / 2 - sqrt(a) |
            //         = | (x_n² + a - 2*x_n*sqrt(a)) / (2 * x_n) |
            //         = | (x_n - sqrt(a))² / (2 * x_n) |
            //         = | ε_n² / (2 * x_n) |
            //         = ε_n² / | (2 * x_n) |
            //
            // For the first iteration, we have a special case where x_0 is known:
            // ε_1 = ε_0² / | (2 * x_0) |
            //     ≤ (2**(e-2))² / (2 * (2**(e-1) + 2**(e-2)))
            //     ≤ 2**(2*e-4) / (3 * 2**(e-1))
            //     ≤ 2**(e-3) / 3
            //     ≤ 2**(e-3-log2(3))
            //     ≤ 2**(e-4.5)
            //
            // For the following iterations, we use the fact that, 2**(e-1) ≤ sqrt(a) ≤ x_n:
            // ε_{n+1} = ε_n² / | (2 * x_n) |
            //         ≤ (2**(e-k))² / (2 * 2**(e-1))
            //         ≤ 2**(2*e-2*k) / 2**e
            //         ≤ 2**(e-2*k)
            xn = (xn + a / xn) >> 1; // ε_1 := | x_1 - sqrt(a) | ≤ 2**(e-4.5)  -- special case, see above
            xn = (xn + a / xn) >> 1; // ε_2 := | x_2 - sqrt(a) | ≤ 2**(e-9)    -- general case with k = 4.5
            xn = (xn + a / xn) >> 1; // ε_3 := | x_3 - sqrt(a) | ≤ 2**(e-18)   -- general case with k = 9
            xn = (xn + a / xn) >> 1; // ε_4 := | x_4 - sqrt(a) | ≤ 2**(e-36)   -- general case with k = 18
            xn = (xn + a / xn) >> 1; // ε_5 := | x_5 - sqrt(a) | ≤ 2**(e-72)   -- general case with k = 36
            xn = (xn + a / xn) >> 1; // ε_6 := | x_6 - sqrt(a) | ≤ 2**(e-144)  -- general case with k = 72

            // Because e ≤ 128 (as discussed during the first estimation phase), we know have reached a precision
            // ε_6 ≤ 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either
            // sqrt(a) or sqrt(a) + 1.
            return xn - SafeCast.toUint(xn > a / xn);
        }
    }

    /**
     * @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);
        }
    }

    /**
     * @dev Return the log in base 2 of a positive value rounded towards zero.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        uint256 exp;
        unchecked {
            exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);
            value >>= exp;
            result += exp;

            exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);
            value >>= exp;
            result += exp;

            exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);
            value >>= exp;
            result += exp;

            exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);
            value >>= exp;
            result += exp;

            exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);
            value >>= exp;
            result += exp;

            exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);
            value >>= exp;
            result += exp;

            exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);
            value >>= exp;
            result += exp;

            result += SafeCast.toUint(value > 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);
        }
    }

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

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

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

            isGt = SafeCast.toUint(value > (1 << 64) - 1);
            value >>= isGt * 64;
            result += isGt * 8;

            isGt = SafeCast.toUint(value > (1 << 32) - 1);
            value >>= isGt * 32;
            result += isGt * 4;

            isGt = SafeCast.toUint(value > (1 << 16) - 1);
            value >>= isGt * 16;
            result += isGt * 2;

            result += SafeCast.toUint(value > (1 << 8) - 1);
        }
        return result;
    }

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

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

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

pragma solidity ^0.8.20;

/**
 * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow
 * checks.
 *
 * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
 * easily result in undesired exploitation or bugs, since developers usually
 * assume that overflows raise errors. `SafeCast` restores this intuition by
 * reverting the transaction when such an operation overflows.
 *
 * Using this library instead of the unchecked operations eliminates an entire
 * class of bugs, so it's recommended to use it always.
 */
library SafeCast {
    /**
     * @dev Value doesn't fit in an uint of `bits` size.
     */
    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);

    /**
     * @dev An int value doesn't fit in an uint of `bits` size.
     */
    error SafeCastOverflowedIntToUint(int256 value);

    /**
     * @dev Value doesn't fit in an int of `bits` size.
     */
    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);

    /**
     * @dev An uint value doesn't fit in an int of `bits` size.
     */
    error SafeCastOverflowedUintToInt(uint256 value);

    /**
     * @dev Returns the downcasted uint248 from uint256, reverting on
     * overflow (when the input is greater than largest uint248).
     *
     * Counterpart to Solidity's `uint248` operator.
     *
     * Requirements:
     *
     * - input must fit into 248 bits
     */
    function toUint248(uint256 value) internal pure returns (uint248) {
        if (value > type(uint248).max) {
            revert SafeCastOverflowedUintDowncast(248, value);
        }
        return uint248(value);
    }

    /**
     * @dev Returns the downcasted uint240 from uint256, reverting on
     * overflow (when the input is greater than largest uint240).
     *
     * Counterpart to Solidity's `uint240` operator.
     *
     * Requirements:
     *
     * - input must fit into 240 bits
     */
    function toUint240(uint256 value) internal pure returns (uint240) {
        if (value > type(uint240).max) {
            revert SafeCastOverflowedUintDowncast(240, value);
        }
        return uint240(value);
    }

    /**
     * @dev Returns the downcasted uint232 from uint256, reverting on
     * overflow (when the input is greater than largest uint232).
     *
     * Counterpart to Solidity's `uint232` operator.
     *
     * Requirements:
     *
     * - input must fit into 232 bits
     */
    function toUint232(uint256 value) internal pure returns (uint232) {
        if (value > type(uint232).max) {
            revert SafeCastOverflowedUintDowncast(232, value);
        }
        return uint232(value);
    }

    /**
     * @dev Returns the downcasted uint224 from uint256, reverting on
     * overflow (when the input is greater than largest uint224).
     *
     * Counterpart to Solidity's `uint224` operator.
     *
     * Requirements:
     *
     * - input must fit into 224 bits
     */
    function toUint224(uint256 value) internal pure returns (uint224) {
        if (value > type(uint224).max) {
            revert SafeCastOverflowedUintDowncast(224, value);
        }
        return uint224(value);
    }

    /**
     * @dev Returns the downcasted uint216 from uint256, reverting on
     * overflow (when the input is greater than largest uint216).
     *
     * Counterpart to Solidity's `uint216` operator.
     *
     * Requirements:
     *
     * - input must fit into 216 bits
     */
    function toUint216(uint256 value) internal pure returns (uint216) {
        if (value > type(uint216).max) {
            revert SafeCastOverflowedUintDowncast(216, value);
        }
        return uint216(value);
    }

    /**
     * @dev Returns the downcasted uint208 from uint256, reverting on
     * overflow (when the input is greater than largest uint208).
     *
     * Counterpart to Solidity's `uint208` operator.
     *
     * Requirements:
     *
     * - input must fit into 208 bits
     */
    function toUint208(uint256 value) internal pure returns (uint208) {
        if (value > type(uint208).max) {
            revert SafeCastOverflowedUintDowncast(208, value);
        }
        return uint208(value);
    }

    /**
     * @dev Returns the downcasted uint200 from uint256, reverting on
     * overflow (when the input is greater than largest uint200).
     *
     * Counterpart to Solidity's `uint200` operator.
     *
     * Requirements:
     *
     * - input must fit into 200 bits
     */
    function toUint200(uint256 value) internal pure returns (uint200) {
        if (value > type(uint200).max) {
            revert SafeCastOverflowedUintDowncast(200, value);
        }
        return uint200(value);
    }

    /**
     * @dev Returns the downcasted uint192 from uint256, reverting on
     * overflow (when the input is greater than largest uint192).
     *
     * Counterpart to Solidity's `uint192` operator.
     *
     * Requirements:
     *
     * - input must fit into 192 bits
     */
    function toUint192(uint256 value) internal pure returns (uint192) {
        if (value > type(uint192).max) {
            revert SafeCastOverflowedUintDowncast(192, value);
        }
        return uint192(value);
    }

    /**
     * @dev Returns the downcasted uint184 from uint256, reverting on
     * overflow (when the input is greater than largest uint184).
     *
     * Counterpart to Solidity's `uint184` operator.
     *
     * Requirements:
     *
     * - input must fit into 184 bits
     */
    function toUint184(uint256 value) internal pure returns (uint184) {
        if (value > type(uint184).max) {
            revert SafeCastOverflowedUintDowncast(184, value);
        }
        return uint184(value);
    }

    /**
     * @dev Returns the downcasted uint176 from uint256, reverting on
     * overflow (when the input is greater than largest uint176).
     *
     * Counterpart to Solidity's `uint176` operator.
     *
     * Requirements:
     *
     * - input must fit into 176 bits
     */
    function toUint176(uint256 value) internal pure returns (uint176) {
        if (value > type(uint176).max) {
            revert SafeCastOverflowedUintDowncast(176, value);
        }
        return uint176(value);
    }

    /**
     * @dev Returns the downcasted uint168 from uint256, reverting on
     * overflow (when the input is greater than largest uint168).
     *
     * Counterpart to Solidity's `uint168` operator.
     *
     * Requirements:
     *
     * - input must fit into 168 bits
     */
    function toUint168(uint256 value) internal pure returns (uint168) {
        if (value > type(uint168).max) {
            revert SafeCastOverflowedUintDowncast(168, value);
        }
        return uint168(value);
    }

    /**
     * @dev Returns the downcasted uint160 from uint256, reverting on
     * overflow (when the input is greater than largest uint160).
     *
     * Counterpart to Solidity's `uint160` operator.
     *
     * Requirements:
     *
     * - input must fit into 160 bits
     */
    function toUint160(uint256 value) internal pure returns (uint160) {
        if (value > type(uint160).max) {
            revert SafeCastOverflowedUintDowncast(160, value);
        }
        return uint160(value);
    }

    /**
     * @dev Returns the downcasted uint152 from uint256, reverting on
     * overflow (when the input is greater than largest uint152).
     *
     * Counterpart to Solidity's `uint152` operator.
     *
     * Requirements:
     *
     * - input must fit into 152 bits
     */
    function toUint152(uint256 value) internal pure returns (uint152) {
        if (value > type(uint152).max) {
            revert SafeCastOverflowedUintDowncast(152, value);
        }
        return uint152(value);
    }

    /**
     * @dev Returns the downcasted uint144 from uint256, reverting on
     * overflow (when the input is greater than largest uint144).
     *
     * Counterpart to Solidity's `uint144` operator.
     *
     * Requirements:
     *
     * - input must fit into 144 bits
     */
    function toUint144(uint256 value) internal pure returns (uint144) {
        if (value > type(uint144).max) {
            revert SafeCastOverflowedUintDowncast(144, value);
        }
        return uint144(value);
    }

    /**
     * @dev Returns the downcasted uint136 from uint256, reverting on
     * overflow (when the input is greater than largest uint136).
     *
     * Counterpart to Solidity's `uint136` operator.
     *
     * Requirements:
     *
     * - input must fit into 136 bits
     */
    function toUint136(uint256 value) internal pure returns (uint136) {
        if (value > type(uint136).max) {
            revert SafeCastOverflowedUintDowncast(136, value);
        }
        return uint136(value);
    }

    /**
     * @dev Returns the downcasted uint128 from uint256, reverting on
     * overflow (when the input is greater than largest uint128).
     *
     * Counterpart to Solidity's `uint128` operator.
     *
     * Requirements:
     *
     * - input must fit into 128 bits
     */
    function toUint128(uint256 value) internal pure returns (uint128) {
        if (value > type(uint128).max) {
            revert SafeCastOverflowedUintDowncast(128, value);
        }
        return uint128(value);
    }

    /**
     * @dev Returns the downcasted uint120 from uint256, reverting on
     * overflow (when the input is greater than largest uint120).
     *
     * Counterpart to Solidity's `uint120` operator.
     *
     * Requirements:
     *
     * - input must fit into 120 bits
     */
    function toUint120(uint256 value) internal pure returns (uint120) {
        if (value > type(uint120).max) {
            revert SafeCastOverflowedUintDowncast(120, value);
        }
        return uint120(value);
    }

    /**
     * @dev Returns the downcasted uint112 from uint256, reverting on
     * overflow (when the input is greater than largest uint112).
     *
     * Counterpart to Solidity's `uint112` operator.
     *
     * Requirements:
     *
     * - input must fit into 112 bits
     */
    function toUint112(uint256 value) internal pure returns (uint112) {
        if (value > type(uint112).max) {
            revert SafeCastOverflowedUintDowncast(112, value);
        }
        return uint112(value);
    }

    /**
     * @dev Returns the downcasted uint104 from uint256, reverting on
     * overflow (when the input is greater than largest uint104).
     *
     * Counterpart to Solidity's `uint104` operator.
     *
     * Requirements:
     *
     * - input must fit into 104 bits
     */
    function toUint104(uint256 value) internal pure returns (uint104) {
        if (value > type(uint104).max) {
            revert SafeCastOverflowedUintDowncast(104, value);
        }
        return uint104(value);
    }

    /**
     * @dev Returns the downcasted uint96 from uint256, reverting on
     * overflow (when the input is greater than largest uint96).
     *
     * Counterpart to Solidity's `uint96` operator.
     *
     * Requirements:
     *
     * - input must fit into 96 bits
     */
    function toUint96(uint256 value) internal pure returns (uint96) {
        if (value > type(uint96).max) {
            revert SafeCastOverflowedUintDowncast(96, value);
        }
        return uint96(value);
    }

    /**
     * @dev Returns the downcasted uint88 from uint256, reverting on
     * overflow (when the input is greater than largest uint88).
     *
     * Counterpart to Solidity's `uint88` operator.
     *
     * Requirements:
     *
     * - input must fit into 88 bits
     */
    function toUint88(uint256 value) internal pure returns (uint88) {
        if (value > type(uint88).max) {
            revert SafeCastOverflowedUintDowncast(88, value);
        }
        return uint88(value);
    }

    /**
     * @dev Returns the downcasted uint80 from uint256, reverting on
     * overflow (when the input is greater than largest uint80).
     *
     * Counterpart to Solidity's `uint80` operator.
     *
     * Requirements:
     *
     * - input must fit into 80 bits
     */
    function toUint80(uint256 value) internal pure returns (uint80) {
        if (value > type(uint80).max) {
            revert SafeCastOverflowedUintDowncast(80, value);
        }
        return uint80(value);
    }

    /**
     * @dev Returns the downcasted uint72 from uint256, reverting on
     * overflow (when the input is greater than largest uint72).
     *
     * Counterpart to Solidity's `uint72` operator.
     *
     * Requirements:
     *
     * - input must fit into 72 bits
     */
    function toUint72(uint256 value) internal pure returns (uint72) {
        if (value > type(uint72).max) {
            revert SafeCastOverflowedUintDowncast(72, value);
        }
        return uint72(value);
    }

    /**
     * @dev Returns the downcasted uint64 from uint256, reverting on
     * overflow (when the input is greater than largest uint64).
     *
     * Counterpart to Solidity's `uint64` operator.
     *
     * Requirements:
     *
     * - input must fit into 64 bits
     */
    function toUint64(uint256 value) internal pure returns (uint64) {
        if (value > type(uint64).max) {
            revert SafeCastOverflowedUintDowncast(64, value);
        }
        return uint64(value);
    }

    /**
     * @dev Returns the downcasted uint56 from uint256, reverting on
     * overflow (when the input is greater than largest uint56).
     *
     * Counterpart to Solidity's `uint56` operator.
     *
     * Requirements:
     *
     * - input must fit into 56 bits
     */
    function toUint56(uint256 value) internal pure returns (uint56) {
        if (value > type(uint56).max) {
            revert SafeCastOverflowedUintDowncast(56, value);
        }
        return uint56(value);
    }

    /**
     * @dev Returns the downcasted uint48 from uint256, reverting on
     * overflow (when the input is greater than largest uint48).
     *
     * Counterpart to Solidity's `uint48` operator.
     *
     * Requirements:
     *
     * - input must fit into 48 bits
     */
    function toUint48(uint256 value) internal pure returns (uint48) {
        if (value > type(uint48).max) {
            revert SafeCastOverflowedUintDowncast(48, value);
        }
        return uint48(value);
    }

    /**
     * @dev Returns the downcasted uint40 from uint256, reverting on
     * overflow (when the input is greater than largest uint40).
     *
     * Counterpart to Solidity's `uint40` operator.
     *
     * Requirements:
     *
     * - input must fit into 40 bits
     */
    function toUint40(uint256 value) internal pure returns (uint40) {
        if (value > type(uint40).max) {
            revert SafeCastOverflowedUintDowncast(40, value);
        }
        return uint40(value);
    }

    /**
     * @dev Returns the downcasted uint32 from uint256, reverting on
     * overflow (when the input is greater than largest uint32).
     *
     * Counterpart to Solidity's `uint32` operator.
     *
     * Requirements:
     *
     * - input must fit into 32 bits
     */
    function toUint32(uint256 value) internal pure returns (uint32) {
        if (value > type(uint32).max) {
            revert SafeCastOverflowedUintDowncast(32, value);
        }
        return uint32(value);
    }

    /**
     * @dev Returns the downcasted uint24 from uint256, reverting on
     * overflow (when the input is greater than largest uint24).
     *
     * Counterpart to Solidity's `uint24` operator.
     *
     * Requirements:
     *
     * - input must fit into 24 bits
     */
    function toUint24(uint256 value) internal pure returns (uint24) {
        if (value > type(uint24).max) {
            revert SafeCastOverflowedUintDowncast(24, value);
        }
        return uint24(value);
    }

    /**
     * @dev Returns the downcasted uint16 from uint256, reverting on
     * overflow (when the input is greater than largest uint16).
     *
     * Counterpart to Solidity's `uint16` operator.
     *
     * Requirements:
     *
     * - input must fit into 16 bits
     */
    function toUint16(uint256 value) internal pure returns (uint16) {
        if (value > type(uint16).max) {
            revert SafeCastOverflowedUintDowncast(16, value);
        }
        return uint16(value);
    }

    /**
     * @dev Returns the downcasted uint8 from uint256, reverting on
     * overflow (when the input is greater than largest uint8).
     *
     * Counterpart to Solidity's `uint8` operator.
     *
     * Requirements:
     *
     * - input must fit into 8 bits
     */
    function toUint8(uint256 value) internal pure returns (uint8) {
        if (value > type(uint8).max) {
            revert SafeCastOverflowedUintDowncast(8, value);
        }
        return uint8(value);
    }

    /**
     * @dev Converts a signed int256 into an unsigned uint256.
     *
     * Requirements:
     *
     * - input must be greater than or equal to 0.
     */
    function toUint256(int256 value) internal pure returns (uint256) {
        if (value < 0) {
            revert SafeCastOverflowedIntToUint(value);
        }
        return uint256(value);
    }

    /**
     * @dev Returns the downcasted int248 from int256, reverting on
     * overflow (when the input is less than smallest int248 or
     * greater than largest int248).
     *
     * Counterpart to Solidity's `int248` operator.
     *
     * Requirements:
     *
     * - input must fit into 248 bits
     */
    function toInt248(int256 value) internal pure returns (int248 downcasted) {
        downcasted = int248(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(248, value);
        }
    }

    /**
     * @dev Returns the downcasted int240 from int256, reverting on
     * overflow (when the input is less than smallest int240 or
     * greater than largest int240).
     *
     * Counterpart to Solidity's `int240` operator.
     *
     * Requirements:
     *
     * - input must fit into 240 bits
     */
    function toInt240(int256 value) internal pure returns (int240 downcasted) {
        downcasted = int240(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(240, value);
        }
    }

    /**
     * @dev Returns the downcasted int232 from int256, reverting on
     * overflow (when the input is less than smallest int232 or
     * greater than largest int232).
     *
     * Counterpart to Solidity's `int232` operator.
     *
     * Requirements:
     *
     * - input must fit into 232 bits
     */
    function toInt232(int256 value) internal pure returns (int232 downcasted) {
        downcasted = int232(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(232, value);
        }
    }

    /**
     * @dev Returns the downcasted int224 from int256, reverting on
     * overflow (when the input is less than smallest int224 or
     * greater than largest int224).
     *
     * Counterpart to Solidity's `int224` operator.
     *
     * Requirements:
     *
     * - input must fit into 224 bits
     */
    function toInt224(int256 value) internal pure returns (int224 downcasted) {
        downcasted = int224(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(224, value);
        }
    }

    /**
     * @dev Returns the downcasted int216 from int256, reverting on
     * overflow (when the input is less than smallest int216 or
     * greater than largest int216).
     *
     * Counterpart to Solidity's `int216` operator.
     *
     * Requirements:
     *
     * - input must fit into 216 bits
     */
    function toInt216(int256 value) internal pure returns (int216 downcasted) {
        downcasted = int216(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(216, value);
        }
    }

    /**
     * @dev Returns the downcasted int208 from int256, reverting on
     * overflow (when the input is less than smallest int208 or
     * greater than largest int208).
     *
     * Counterpart to Solidity's `int208` operator.
     *
     * Requirements:
     *
     * - input must fit into 208 bits
     */
    function toInt208(int256 value) internal pure returns (int208 downcasted) {
        downcasted = int208(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(208, value);
        }
    }

    /**
     * @dev Returns the downcasted int200 from int256, reverting on
     * overflow (when the input is less than smallest int200 or
     * greater than largest int200).
     *
     * Counterpart to Solidity's `int200` operator.
     *
     * Requirements:
     *
     * - input must fit into 200 bits
     */
    function toInt200(int256 value) internal pure returns (int200 downcasted) {
        downcasted = int200(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(200, value);
        }
    }

    /**
     * @dev Returns the downcasted int192 from int256, reverting on
     * overflow (when the input is less than smallest int192 or
     * greater than largest int192).
     *
     * Counterpart to Solidity's `int192` operator.
     *
     * Requirements:
     *
     * - input must fit into 192 bits
     */
    function toInt192(int256 value) internal pure returns (int192 downcasted) {
        downcasted = int192(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(192, value);
        }
    }

    /**
     * @dev Returns the downcasted int184 from int256, reverting on
     * overflow (when the input is less than smallest int184 or
     * greater than largest int184).
     *
     * Counterpart to Solidity's `int184` operator.
     *
     * Requirements:
     *
     * - input must fit into 184 bits
     */
    function toInt184(int256 value) internal pure returns (int184 downcasted) {
        downcasted = int184(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(184, value);
        }
    }

    /**
     * @dev Returns the downcasted int176 from int256, reverting on
     * overflow (when the input is less than smallest int176 or
     * greater than largest int176).
     *
     * Counterpart to Solidity's `int176` operator.
     *
     * Requirements:
     *
     * - input must fit into 176 bits
     */
    function toInt176(int256 value) internal pure returns (int176 downcasted) {
        downcasted = int176(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(176, value);
        }
    }

    /**
     * @dev Returns the downcasted int168 from int256, reverting on
     * overflow (when the input is less than smallest int168 or
     * greater than largest int168).
     *
     * Counterpart to Solidity's `int168` operator.
     *
     * Requirements:
     *
     * - input must fit into 168 bits
     */
    function toInt168(int256 value) internal pure returns (int168 downcasted) {
        downcasted = int168(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(168, value);
        }
    }

    /**
     * @dev Returns the downcasted int160 from int256, reverting on
     * overflow (when the input is less than smallest int160 or
     * greater than largest int160).
     *
     * Counterpart to Solidity's `int160` operator.
     *
     * Requirements:
     *
     * - input must fit into 160 bits
     */
    function toInt160(int256 value) internal pure returns (int160 downcasted) {
        downcasted = int160(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(160, value);
        }
    }

    /**
     * @dev Returns the downcasted int152 from int256, reverting on
     * overflow (when the input is less than smallest int152 or
     * greater than largest int152).
     *
     * Counterpart to Solidity's `int152` operator.
     *
     * Requirements:
     *
     * - input must fit into 152 bits
     */
    function toInt152(int256 value) internal pure returns (int152 downcasted) {
        downcasted = int152(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(152, value);
        }
    }

    /**
     * @dev Returns the downcasted int144 from int256, reverting on
     * overflow (when the input is less than smallest int144 or
     * greater than largest int144).
     *
     * Counterpart to Solidity's `int144` operator.
     *
     * Requirements:
     *
     * - input must fit into 144 bits
     */
    function toInt144(int256 value) internal pure returns (int144 downcasted) {
        downcasted = int144(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(144, value);
        }
    }

    /**
     * @dev Returns the downcasted int136 from int256, reverting on
     * overflow (when the input is less than smallest int136 or
     * greater than largest int136).
     *
     * Counterpart to Solidity's `int136` operator.
     *
     * Requirements:
     *
     * - input must fit into 136 bits
     */
    function toInt136(int256 value) internal pure returns (int136 downcasted) {
        downcasted = int136(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(136, value);
        }
    }

    /**
     * @dev Returns the downcasted int128 from int256, reverting on
     * overflow (when the input is less than smallest int128 or
     * greater than largest int128).
     *
     * Counterpart to Solidity's `int128` operator.
     *
     * Requirements:
     *
     * - input must fit into 128 bits
     */
    function toInt128(int256 value) internal pure returns (int128 downcasted) {
        downcasted = int128(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(128, value);
        }
    }

    /**
     * @dev Returns the downcasted int120 from int256, reverting on
     * overflow (when the input is less than smallest int120 or
     * greater than largest int120).
     *
     * Counterpart to Solidity's `int120` operator.
     *
     * Requirements:
     *
     * - input must fit into 120 bits
     */
    function toInt120(int256 value) internal pure returns (int120 downcasted) {
        downcasted = int120(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(120, value);
        }
    }

    /**
     * @dev Returns the downcasted int112 from int256, reverting on
     * overflow (when the input is less than smallest int112 or
     * greater than largest int112).
     *
     * Counterpart to Solidity's `int112` operator.
     *
     * Requirements:
     *
     * - input must fit into 112 bits
     */
    function toInt112(int256 value) internal pure returns (int112 downcasted) {
        downcasted = int112(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(112, value);
        }
    }

    /**
     * @dev Returns the downcasted int104 from int256, reverting on
     * overflow (when the input is less than smallest int104 or
     * greater than largest int104).
     *
     * Counterpart to Solidity's `int104` operator.
     *
     * Requirements:
     *
     * - input must fit into 104 bits
     */
    function toInt104(int256 value) internal pure returns (int104 downcasted) {
        downcasted = int104(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(104, value);
        }
    }

    /**
     * @dev Returns the downcasted int96 from int256, reverting on
     * overflow (when the input is less than smallest int96 or
     * greater than largest int96).
     *
     * Counterpart to Solidity's `int96` operator.
     *
     * Requirements:
     *
     * - input must fit into 96 bits
     */
    function toInt96(int256 value) internal pure returns (int96 downcasted) {
        downcasted = int96(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(96, value);
        }
    }

    /**
     * @dev Returns the downcasted int88 from int256, reverting on
     * overflow (when the input is less than smallest int88 or
     * greater than largest int88).
     *
     * Counterpart to Solidity's `int88` operator.
     *
     * Requirements:
     *
     * - input must fit into 88 bits
     */
    function toInt88(int256 value) internal pure returns (int88 downcasted) {
        downcasted = int88(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(88, value);
        }
    }

    /**
     * @dev Returns the downcasted int80 from int256, reverting on
     * overflow (when the input is less than smallest int80 or
     * greater than largest int80).
     *
     * Counterpart to Solidity's `int80` operator.
     *
     * Requirements:
     *
     * - input must fit into 80 bits
     */
    function toInt80(int256 value) internal pure returns (int80 downcasted) {
        downcasted = int80(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(80, value);
        }
    }

    /**
     * @dev Returns the downcasted int72 from int256, reverting on
     * overflow (when the input is less than smallest int72 or
     * greater than largest int72).
     *
     * Counterpart to Solidity's `int72` operator.
     *
     * Requirements:
     *
     * - input must fit into 72 bits
     */
    function toInt72(int256 value) internal pure returns (int72 downcasted) {
        downcasted = int72(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(72, value);
        }
    }

    /**
     * @dev Returns the downcasted int64 from int256, reverting on
     * overflow (when the input is less than smallest int64 or
     * greater than largest int64).
     *
     * Counterpart to Solidity's `int64` operator.
     *
     * Requirements:
     *
     * - input must fit into 64 bits
     */
    function toInt64(int256 value) internal pure returns (int64 downcasted) {
        downcasted = int64(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(64, value);
        }
    }

    /**
     * @dev Returns the downcasted int56 from int256, reverting on
     * overflow (when the input is less than smallest int56 or
     * greater than largest int56).
     *
     * Counterpart to Solidity's `int56` operator.
     *
     * Requirements:
     *
     * - input must fit into 56 bits
     */
    function toInt56(int256 value) internal pure returns (int56 downcasted) {
        downcasted = int56(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(56, value);
        }
    }

    /**
     * @dev Returns the downcasted int48 from int256, reverting on
     * overflow (when the input is less than smallest int48 or
     * greater than largest int48).
     *
     * Counterpart to Solidity's `int48` operator.
     *
     * Requirements:
     *
     * - input must fit into 48 bits
     */
    function toInt48(int256 value) internal pure returns (int48 downcasted) {
        downcasted = int48(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(48, value);
        }
    }

    /**
     * @dev Returns the downcasted int40 from int256, reverting on
     * overflow (when the input is less than smallest int40 or
     * greater than largest int40).
     *
     * Counterpart to Solidity's `int40` operator.
     *
     * Requirements:
     *
     * - input must fit into 40 bits
     */
    function toInt40(int256 value) internal pure returns (int40 downcasted) {
        downcasted = int40(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(40, value);
        }
    }

    /**
     * @dev Returns the downcasted int32 from int256, reverting on
     * overflow (when the input is less than smallest int32 or
     * greater than largest int32).
     *
     * Counterpart to Solidity's `int32` operator.
     *
     * Requirements:
     *
     * - input must fit into 32 bits
     */
    function toInt32(int256 value) internal pure returns (int32 downcasted) {
        downcasted = int32(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(32, value);
        }
    }

    /**
     * @dev Returns the downcasted int24 from int256, reverting on
     * overflow (when the input is less than smallest int24 or
     * greater than largest int24).
     *
     * Counterpart to Solidity's `int24` operator.
     *
     * Requirements:
     *
     * - input must fit into 24 bits
     */
    function toInt24(int256 value) internal pure returns (int24 downcasted) {
        downcasted = int24(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(24, value);
        }
    }

    /**
     * @dev Returns the downcasted int16 from int256, reverting on
     * overflow (when the input is less than smallest int16 or
     * greater than largest int16).
     *
     * Counterpart to Solidity's `int16` operator.
     *
     * Requirements:
     *
     * - input must fit into 16 bits
     */
    function toInt16(int256 value) internal pure returns (int16 downcasted) {
        downcasted = int16(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(16, value);
        }
    }

    /**
     * @dev Returns the downcasted int8 from int256, reverting on
     * overflow (when the input is less than smallest int8 or
     * greater than largest int8).
     *
     * Counterpart to Solidity's `int8` operator.
     *
     * Requirements:
     *
     * - input must fit into 8 bits
     */
    function toInt8(int256 value) internal pure returns (int8 downcasted) {
        downcasted = int8(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(8, value);
        }
    }

    /**
     * @dev Converts an unsigned uint256 into a signed int256.
     *
     * Requirements:
     *
     * - input must be less than or equal to maxInt256.
     */
    function toInt256(uint256 value) internal pure returns (int256) {
        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
        if (value > uint256(type(int256).max)) {
            revert SafeCastOverflowedUintToInt(value);
        }
        return int256(value);
    }

    /**
     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.
     */
    function toUint(bool b) internal pure returns (uint256 u) {
        assembly ("memory-safe") {
            u := iszero(iszero(b))
        }
    }
}

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

pragma solidity ^0.8.20;

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

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

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

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

pragma solidity ^0.8.20;

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

/**
 * @dev Standard signed math utilities missing in the Solidity language.
 */
library SignedMath {
    /**
     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
     *
     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
     * one branch when needed, making this function more expensive.
     */
    function ternary(bool condition, int256 a, int256 b) internal pure returns (int256) {
        unchecked {
            // branchless ternary works because:
            // b ^ (a ^ b) == a
            // b ^ 0 == b
            return b ^ ((a ^ b) * int256(SafeCast.toUint(condition)));
        }
    }

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

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

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

    /**
     * @dev Returns the absolute unsigned value of a signed value.
     */
    function abs(int256 n) internal pure returns (uint256) {
        unchecked {
            // Formula from the "Bit Twiddling Hacks" by Sean Eron Anderson.
            // Since `n` is a signed integer, the generated bytecode will use the SAR opcode to perform the right shift,
            // taking advantage of the most significant (or "sign" bit) in two's complement representation.
            // This opcode adds new most significant bits set to the value of the previous most significant bit. As a result,
            // the mask will either be `bytes32(0)` (if n is positive) or `~bytes32(0)` (if n is negative).
            int256 mask = n >> 255;

            // A `bytes32(0)` mask leaves the input unchanged, while a `~bytes32(0)` mask complements it.
            return uint256((n + mask) ^ mask);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC-165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[ERC].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[ERC section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

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

interface IOperatorFilterRegistry {
    /**
     * @notice Returns true if operator is not filtered for a given token, either by address or codeHash. Also returns
     *         true if supplied registrant address is not registered.
     */
    function isOperatorAllowed(address registrant, address operator) external view returns (bool);

    /**
     * @notice Registers an address with the registry. May be called by address itself or by EIP-173 owner.
     */
    function register(address registrant) external;

    /**
     * @notice Registers an address with the registry and "subscribes" to another address's filtered operators and codeHashes.
     */
    function registerAndSubscribe(address registrant, address subscription) external;

    /**
     * @notice Registers an address with the registry and copies the filtered operators and codeHashes from another
     *         address without subscribing.
     */
    function registerAndCopyEntries(address registrant, address registrantToCopy) external;

    /**
     * @notice Unregisters an address with the registry and removes its subscription. May be called by address itself or by EIP-173 owner.
     *         Note that this does not remove any filtered addresses or codeHashes.
     *         Also note that any subscriptions to this registrant will still be active and follow the existing filtered addresses and codehashes.
     */
    function unregister(address addr) external;

    /**
     * @notice Update an operator address for a registered address - when filtered is true, the operator is filtered.
     */
    function updateOperator(address registrant, address operator, bool filtered) external;

    /**
     * @notice Update multiple operators for a registered address - when filtered is true, the operators will be filtered. Reverts on duplicates.
     */
    function updateOperators(address registrant, address[] calldata operators, bool filtered) external;

    /**
     * @notice Update a codeHash for a registered address - when filtered is true, the codeHash is filtered.
     */
    function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;

    /**
     * @notice Update multiple codeHashes for a registered address - when filtered is true, the codeHashes will be filtered. Reverts on duplicates.
     */
    function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;

    /**
     * @notice Subscribe an address to another registrant's filtered operators and codeHashes. Will remove previous
     *         subscription if present.
     *         Note that accounts with subscriptions may go on to subscribe to other accounts - in this case,
     *         subscriptions will not be forwarded. Instead the former subscription's existing entries will still be
     *         used.
     */
    function subscribe(address registrant, address registrantToSubscribe) external;

    /**
     * @notice Unsubscribe an address from its current subscribed registrant, and optionally copy its filtered operators and codeHashes.
     */
    function unsubscribe(address registrant, bool copyExistingEntries) external;

    /**
     * @notice Get the subscription address of a given registrant, if any.
     */
    function subscriptionOf(address addr) external returns (address registrant);

    /**
     * @notice Get the set of addresses subscribed to a given registrant.
     *         Note that order is not guaranteed as updates are made.
     */
    function subscribers(address registrant) external returns (address[] memory);

    /**
     * @notice Get the subscriber at a given index in the set of addresses subscribed to a given registrant.
     *         Note that order is not guaranteed as updates are made.
     */
    function subscriberAt(address registrant, uint256 index) external returns (address);

    /**
     * @notice Copy filtered operators and codeHashes from a different registrantToCopy to addr.
     */
    function copyEntriesOf(address registrant, address registrantToCopy) external;

    /**
     * @notice Returns true if operator is filtered by a given address or its subscription.
     */
    function isOperatorFiltered(address registrant, address operator) external returns (bool);

    /**
     * @notice Returns true if the hash of an address's code is filtered by a given address or its subscription.
     */
    function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);

    /**
     * @notice Returns true if a codeHash is filtered by a given address or its subscription.
     */
    function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);

    /**
     * @notice Returns a list of filtered operators for a given address or its subscription.
     */
    function filteredOperators(address addr) external returns (address[] memory);

    /**
     * @notice Returns the set of filtered codeHashes for a given address or its subscription.
     *         Note that order is not guaranteed as updates are made.
     */
    function filteredCodeHashes(address addr) external returns (bytes32[] memory);

    /**
     * @notice Returns the filtered operator at the given index of the set of filtered operators for a given address or
     *         its subscription.
     *         Note that order is not guaranteed as updates are made.
     */
    function filteredOperatorAt(address registrant, uint256 index) external returns (address);

    /**
     * @notice Returns the filtered codeHash at the given index of the list of filtered codeHashes for a given address or
     *         its subscription.
     *         Note that order is not guaranteed as updates are made.
     */
    function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);

    /**
     * @notice Returns true if an address has registered
     */
    function isRegistered(address addr) external returns (bool);

    /**
     * @dev Convenience method to compute the code hash of an arbitrary contract
     */
    function codeHashOf(address addr) external returns (bytes32);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.25;

interface IRandomNumberRequester {
    function process(uint256 rand, uint256 requestId) external;
}

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

pragma solidity ^0.8.0;

import "./ERC721.sol";
import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Enumerable.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 ERC721Enumerable is ERC721, IERC721Enumerable {
    // 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(IERC165, ERC721) returns (bool) {
        return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
     */
    function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) {
        require(index < ERC721.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 < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds");
        return _allTokens[index];
    }

    /**
     * @dev Hook that is called before any token transfer. This includes minting
     * and burning.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, ``from``'s `tokenId` will be burned.
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual override {
        super._beforeTokenTransfer(from, to, tokenId);

        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 = ERC721.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 = ERC721.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();
    }
}

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

pragma solidity ^0.8.20;

/**
 * @dev Collection of common custom errors used in multiple contracts
 *
 * IMPORTANT: Backwards compatibility is not guaranteed in future versions of the library.
 * It is recommended to avoid relying on the error API for critical functionality.
 *
 * _Available since v5.1._
 */
library Errors {
    /**
     * @dev The ETH balance of the account is not enough to perform the operation.
     */
    error InsufficientBalance(uint256 balance, uint256 needed);

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

    /**
     * @dev The deployment failed.
     */
    error FailedDeployment();

    /**
     * @dev A necessary precompile is missing.
     */
    error MissingPrecompile(address);
}

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

pragma solidity ^0.8.20;

import {IAccessControl} from "./IAccessControl.sol";
import {Context} from "../utils/Context.sol";
import {ERC165} from "../utils/introspection/ERC165.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:
 *
 * ```solidity
 * 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}:
 *
 * ```solidity
 * 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. We recommend using {AccessControlDefaultAdminRules}
 * to enforce additional security measures for this role.
 */
abstract contract AccessControl is Context, IAccessControl, ERC165 {
    struct RoleData {
        mapping(address account => bool) hasRole;
        bytes32 adminRole;
    }

    mapping(bytes32 role => RoleData) private _roles;

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with an {AccessControlUnauthorizedAccount} error including the required role.
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

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

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

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `_msgSender()`
     * is missing `role`. Overriding this function changes the behavior of the {onlyRole} modifier.
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `account`
     * is missing `role`.
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert AccessControlUnauthorizedAccount(account, role);
        }
    }

    /**
     * @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 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 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 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 `callerConfirmation`.
     *
     * May emit a {RoleRevoked} event.
     */
    function renounceRole(bytes32 role, address callerConfirmation) public virtual {
        if (callerConfirmation != _msgSender()) {
            revert AccessControlBadConfirmation();
        }

        _revokeRole(role, callerConfirmation);
    }

    /**
     * @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 Attempts to grant `role` to `account` and returns a boolean indicating if `role` was granted.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual returns (bool) {
        if (!hasRole(role, account)) {
            _roles[role].hasRole[account] = true;
            emit RoleGranted(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Attempts to revoke `role` to `account` and returns a boolean indicating if `role` was revoked.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual returns (bool) {
        if (hasRole(role, account)) {
            _roles[role].hasRole[account] = false;
            emit RoleRevoked(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (access/extensions/IAccessControlEnumerable.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev External interface of AccessControlEnumerable declared to support ERC-165 detection.
 */
interface IAccessControlEnumerable is IAccessControl {
    /**
     * @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);
}

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

pragma solidity ^0.8.20;

/**
 * @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.
 *
 * ```solidity
 * 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 EnumerableSet {
    // 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 is the index of the value in the `values` array plus 1.
        // Position 0 is used to mean a value is not in the set.
        mapping(bytes32 value => uint256) _positions;
    }

    /**
     * @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._positions[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 cache the value's position to prevent multiple reads from the same storage slot
        uint256 position = set._positions[value];

        if (position != 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 valueIndex = position - 1;
            uint256 lastIndex = set._values.length - 1;

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

                // Move the lastValue to the index where the value to delete is
                set._values[valueIndex] = lastValue;
                // Update the tracked position of the lastValue (that was just moved)
                set._positions[lastValue] = position;
            }

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

            // Delete the tracked position for the deleted slot
            delete set._positions[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._positions[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;

        assembly ("memory-safe") {
            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;

        assembly ("memory-safe") {
            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;

        assembly ("memory-safe") {
            result := store
        }

        return result;
    }
}

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

pragma solidity ^0.8.20;

/**
 * @dev Helper library for emitting standardized panic codes.
 *
 * ```solidity
 * contract Example {
 *      using Panic for uint256;
 *
 *      // Use any of the declared internal constants
 *      function foo() { Panic.GENERIC.panic(); }
 *
 *      // Alternatively
 *      function foo() { Panic.panic(Panic.GENERIC); }
 * }
 * ```
 *
 * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].
 *
 * _Available since v5.1._
 */
// slither-disable-next-line unused-state
library Panic {
    /// @dev generic / unspecified error
    uint256 internal constant GENERIC = 0x00;
    /// @dev used by the assert() builtin
    uint256 internal constant ASSERT = 0x01;
    /// @dev arithmetic underflow or overflow
    uint256 internal constant UNDER_OVERFLOW = 0x11;
    /// @dev division or modulo by zero
    uint256 internal constant DIVISION_BY_ZERO = 0x12;
    /// @dev enum conversion error
    uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;
    /// @dev invalid encoding in storage
    uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;
    /// @dev empty array pop
    uint256 internal constant EMPTY_ARRAY_POP = 0x31;
    /// @dev array out of bounds access
    uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;
    /// @dev resource error (too large allocation or too large array)
    uint256 internal constant RESOURCE_ERROR = 0x41;
    /// @dev calling invalid internal function
    uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;

    /// @dev Reverts with a panic code. Recommended to use with
    /// the internal constants with predefined codes.
    function panic(uint256 code) internal pure {
        assembly ("memory-safe") {
            mstore(0x00, 0x4e487b71)
            mstore(0x20, code)
            revert(0x1c, 0x24)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/ERC721.sol)

pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
import "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol";
import "@openzeppelin/contracts/utils/Address.sol";
import "@openzeppelin/contracts/utils/Context.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/utils/introspection/ERC165.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 ERC721 is Context, ERC165, IERC721, IERC721Metadata {
    using Address for address;
    using Strings 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;

    bool private _initialized;

    /**
     * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
     */
    // constructor(string memory name_, string memory symbol_) {
    //     _name = name_;
    //     _symbol = symbol_;
    // }

    function setup(string memory name_, string memory symbol_) public {
        require(!_initialized, "ERC721: Contract already initialized");
        _name = name_;
        _symbol = symbol_;
        _initialized = true;
    }

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

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

    /**
     * @dev See {IERC721-ownerOf}.
     */
    function ownerOf(uint256 tokenId) public view virtual override returns (address) {
        address owner = _owners[tokenId];
        require(owner != address(0), "ERC721: owner query for nonexistent token");
        return owner;
    }

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

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

    /**
     * @dev See {IERC721Metadata-tokenURI}.
     */
    function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
        require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");

        string memory baseURI = _baseURI();
        return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
    }

    /**
     * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
     * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
     * by default, can be 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 = ERC721.ownerOf(tokenId);
        require(to != owner, "ERC721: approval to current owner");

        require(
            _msgSender() == owner || isApprovedForAll(owner, _msgSender()),
            "ERC721: approve caller is not owner nor approved for all"
        );

        _approve(to, tokenId);
    }

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

        return _tokenApprovals[tokenId];
    }

    /**
     * @dev See {IERC721-setApprovalForAll}.
     */
    function setApprovalForAll(address operator, bool approved) public virtual override {
        _setApprovalForAll(_msgSender(), operator, approved);
    }

    /**
     * @dev See {IERC721-isApprovedForAll}.
     */
    function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
        return _operatorApprovals[owner][operator];
    }

    /**
     * @dev See {IERC721-transferFrom}.
     */
    function transferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public virtual override {
        //solhint-disable-next-line max-line-length
        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");

        _transfer(from, to, tokenId);
    }

    /**
     * @dev See {IERC721-safeTransferFrom}.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) public virtual override {
        safeTransferFrom(from, to, tokenId, "");
    }

    /**
     * @dev See {IERC721-safeTransferFrom}.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) public virtual override {
        require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
        _safeTransfer(from, to, tokenId, _data);
    }

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
     * are aware of the ERC721 protocol to prevent tokens from being forever locked.
     *
     * `_data` is additional data, it has no specified format and it is sent in call to `to`.
     *
     * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
     * implement alternative mechanisms to perform token transfer, such as signature-based.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function _safeTransfer(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) internal virtual {
        _transfer(from, to, tokenId);
        require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
    }

    /**
     * @dev Returns whether `tokenId` exists.
     *
     * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
     *
     * Tokens start existing when they are minted (`_mint`),
     * and stop existing when they are burned (`_burn`).
     */
    function _exists(uint256 tokenId) internal view virtual returns (bool) {
        return _owners[tokenId] != address(0);
    }

    /**
     * @dev Returns whether `spender` is allowed to manage `tokenId`.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
        require(_exists(tokenId), "ERC721: operator query for nonexistent token");
        address owner = ERC721.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);

        _balances[to] += 1;
        _owners[tokenId] = to;

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

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

    /**
     * @dev Destroys `tokenId`.
     * The approval is cleared when the token is burned.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     *
     * Emits a {Transfer} event.
     */
    function _burn(uint256 tokenId) internal virtual {
        address owner = ERC721.ownerOf(tokenId);

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

        // Clear approvals
        _approve(address(0), tokenId);

        _balances[owner] -= 1;
        delete _owners[tokenId];

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

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

    /**
     * @dev Transfers `tokenId` from `from` to `to`.
     *  As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `tokenId` token must be owned by `from`.
     *
     * Emits a {Transfer} event.
     */
    function _transfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {
        require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
        require(to != address(0), "ERC721: transfer to the zero address");

        _beforeTokenTransfer(from, to, tokenId);

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

        _balances[from] -= 1;
        _balances[to] += 1;
        _owners[tokenId] = to;

        emit Transfer(from, to, tokenId);

        _afterTokenTransfer(from, to, tokenId);
    }

    /**
     * @dev Approve `to` to operate on `tokenId`
     *
     * Emits a {Approval} event.
     */
    function _approve(address to, uint256 tokenId) internal virtual {
        _tokenApprovals[tokenId] = to;
        emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
    }

    /**
     * @dev Approve `operator` to operate on all of `owner` tokens
     *
     * Emits a {ApprovalForAll} event.
     */
    function _setApprovalForAll(
        address owner,
        address operator,
        bool approved
    ) internal virtual {
        require(owner != operator, "ERC721: approve to caller");
        _operatorApprovals[owner][operator] = approved;
        emit ApprovalForAll(owner, operator, approved);
    }

    /**
     * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
     * The call is not executed if the target address is not a contract.
     *
     * @param from address representing the previous owner of the given token ID
     * @param to target address that will receive the tokens
     * @param tokenId uint256 ID of the token to be transferred
     * @param _data bytes optional data to send along with the call
     * @return bool whether the call correctly returned the expected magic value
     */
    function _checkOnERC721Received(
        address from,
        address to,
        uint256 tokenId,
        bytes memory _data
    ) private returns (bool) {
        if (to.code.length > 0) {
            try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
                return retval == IERC721Receiver.onERC721Received.selector;
            } catch (bytes memory reason) {
                if (reason.length == 0) {
                    revert("ERC721: transfer to non ERC721Receiver implementer");
                } else {
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        } else {
            return true;
        }
    }

    /**
     * @dev Hook that is called before any token transfer. This includes minting
     * and burning.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
     * transferred to `to`.
     * - When `from` is zero, `tokenId` will be minted for `to`.
     * - When `to` is zero, ``from``'s `tokenId` will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {}

    /**
     * @dev Hook that is called after any transfer of tokens. This includes
     * minting and burning.
     *
     * Calling conditions:
     *
     * - when `from` and `to` are both non-zero.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(
        address from,
        address to,
        uint256 tokenId
    ) internal virtual {}
}

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

pragma solidity ^0.8.20;

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC-165 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);
 * }
 * ```
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721Receiver.sol)

pragma solidity ^0.8.20;

/**
 * @title ERC-721 token receiver interface
 * @dev Interface for any contract that wants to support safeTransfers
 * from ERC-721 asset contracts.
 */
interface IERC721Receiver {
    /**
     * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
     * by `operator` from `from`, this function is called.
     *
     * It must return its Solidity selector to confirm the token transfer.
     * If any other value is returned or the interface is not implemented by the recipient, the transfer will be
     * reverted.
     *
     * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
     */
    function onERC721Received(
        address operator,
        address from,
        uint256 tokenId,
        bytes calldata data
    ) external returns (bytes4);
}

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

pragma solidity ^0.8.20;

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

/**
 * @title ERC-721 Non-Fungible Token Standard, optional metadata extension
 * @dev See https://eips.ethereum.org/EIPS/eip-721
 */
interface IERC721Metadata is IERC721 {
    /**
     * @dev Returns the token collection name.
     */
    function name() external view returns (string memory);

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

    /**
     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
     */
    function tokenURI(uint256 tokenId) external view returns (string memory);
}

{
  "evmVersion": "paris",
  "optimizer": {
    "enabled": true,
    "mode": "3"
  },
  "outputSelection": {
    "*": {
      "*": [
        "abi"
      ]
    }
  },
  "detectMissingLibraries": false,
  "forceEVMLA": false,
  "enableEraVMExtensions": false,
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"_oldProjectFactory","type":"address"},{"internalType":"address","name":"_galaxisRegistry","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AccessControlBadConfirmation","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"bytes32","name":"neededRole","type":"bytes32"}],"name":"AccessControlUnauthorizedAccount","type":"error"},{"inputs":[],"name":"FailedCall","type":"error"},{"inputs":[{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint32","name":"communityId","type":"uint32"},{"indexed":false,"internalType":"uint32","name":"collectionId","type":"uint32"}],"name":"CollectionCreatedByBridge","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint32","name":"communityId","type":"uint32"},{"indexed":false,"internalType":"uint32","name":"collectionId","type":"uint32"},{"indexed":false,"internalType":"uint32","name":"projectId","type":"uint32"}],"name":"CollectionCreatedFromProject","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint32","name":"communityId","type":"uint32"},{"indexed":false,"internalType":"uint32","name":"collectionId","type":"uint32"},{"indexed":false,"internalType":"uint32","name":"projectId","type":"uint32"},{"indexed":false,"internalType":"uint256","name":"chainId","type":"uint256"}],"name":"CollectionCreatedFromProjectViaBridge","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_projectCount","type":"uint256"}],"name":"NewProject","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"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":false,"internalType":"uint32","name":"community_id","type":"uint32"},{"indexed":false,"internalType":"uint64","name":"subscription_id","type":"uint64"}],"name":"SubscriptionCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint32","name":"community","type":"uint32"},{"indexed":false,"internalType":"string","name":"reason","type":"string"}],"name":"SubscriptionCreationFailed","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint32","name":"community","type":"uint32"},{"indexed":false,"internalType":"bytes","name":"reason","type":"bytes"}],"name":"SubscriptionCreationFailedBadly","type":"event"},{"inputs":[],"name":"COMMUNITY_REGISTRY_ADMIN","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"CONTRACT_ADMIN","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"communityId","type":"uint32"},{"internalType":"uint32","name":"projectId","type":"uint32"},{"components":[{"internalType":"uint256","name":"projectID","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"address payable[]","name":"wallets","type":"address[]"},{"internalType":"uint16[]","name":"shares","type":"uint16[]"},{"internalType":"uint256","name":"maxMintPerTransaction","type":"uint256"},{"internalType":"uint256","name":"maxApprovedSale","type":"uint256"},{"internalType":"uint256","name":"maxApprovedSalePerAddress","type":"uint256"},{"internalType":"uint256","name":"maxSalePerAddress","type":"uint256"},{"internalType":"uint256","name":"approvedsaleStart","type":"uint256"},{"internalType":"uint256","name":"approvedsaleEnd","type":"uint256"},{"internalType":"uint256","name":"saleStart","type":"uint256"},{"internalType":"uint256","name":"saleEnd","type":"uint256"},{"internalType":"uint256","name":"fullPrice","type":"uint256"},{"internalType":"uint256","name":"maxUserMintable","type":"uint256"},{"internalType":"address","name":"signer","type":"address"},{"internalType":"uint256","name":"fullERC20Price","type":"uint256"},{"internalType":"bool","name":"ethSaleEnabled","type":"bool"},{"internalType":"bool","name":"erc20SaleEnabled","type":"bool"},{"internalType":"address","name":"erc20tokenAddress","type":"address"}],"internalType":"struct SaleConfiguration","name":"saleConfig","type":"tuple"},{"components":[{"internalType":"uint256","name":"projectID","type":"uint256"},{"internalType":"uint256","name":"maxSupply","type":"uint256"},{"internalType":"string","name":"erc721name","type":"string"},{"internalType":"string","name":"erc721symbol","type":"string"},{"internalType":"string","name":"tokenPreRevealURI","type":"string"},{"internalType":"string","name":"tokenRevealURI","type":"string"},{"internalType":"bool","name":"transferLocked","type":"bool"},{"internalType":"uint256","name":"reservedSupply","type":"uint256"},{"internalType":"uint256","name":"giveawaySupply","type":"uint256"},{"internalType":"bool","name":"VRFShifting","type":"bool"}],"internalType":"struct TokenConstructorConfig","name":"tokenConfig","type":"tuple"}],"name":"LaunchProject","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"MAP_ACCESS","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"RANDOM_CONSUMER","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"REGISTRY_KEY_COMMUNITY_LIST","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"REGISTRY_KEY_PROJECT_FACTORY_CONTRACT","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"REGISTRY_KEY_RANDOM_CONTRACT","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"REGISTRY_KEY_SSP_FACTORY_HOOK","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"chainid","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"galaxisRegistry","outputs":[{"internalType":"contract IRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"communityId","type":"uint32"}],"name":"getProjectDetails","outputs":[{"components":[{"internalType":"address[]","name":"tokenContracts","type":"address[]"},{"internalType":"address[]","name":"saleContracts","type":"address[]"},{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"uint256","name":"projectID","type":"uint256"},{"internalType":"uint256","name":"maxSupply","type":"uint256"},{"internalType":"uint256","name":"mintedSupply","type":"uint256"},{"internalType":"uint256","name":"mintedReserve","type":"uint256"},{"internalType":"uint256","name":"reservedSupply","type":"uint256"},{"internalType":"uint256","name":"giveawaySupply","type":"uint256"},{"internalType":"string","name":"tokenPreRevealURI","type":"string"},{"internalType":"string","name":"tokenRevealURI","type":"string"},{"internalType":"bool","name":"transferLocked","type":"bool"},{"internalType":"bool","name":"lastRevealRequested","type":"bool"},{"internalType":"uint256","name":"totalSupply","type":"uint256"},{"components":[{"internalType":"uint256","name":"REQUEST_ID","type":"uint256"},{"internalType":"uint256","name":"RANDOM_NUM","type":"uint256"},{"internalType":"uint256","name":"SHIFT","type":"uint256"},{"internalType":"uint256","name":"RANGE_START","type":"uint256"},{"internalType":"uint256","name":"RANGE_END","type":"uint256"},{"internalType":"bool","name":"processed","type":"bool"}],"internalType":"struct revealStruct[]","name":"reveals","type":"tuple[]"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address[]","name":"managers","type":"address[]"},{"internalType":"address[]","name":"controllers","type":"address[]"},{"internalType":"uint256","name":"version","type":"uint256"},{"internalType":"bool","name":"VRFShifting","type":"bool"}],"internalType":"struct TokenInfo[]","name":"tokenInfo","type":"tuple[]"},{"components":[{"components":[{"internalType":"uint256","name":"projectID","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"address payable[]","name":"wallets","type":"address[]"},{"internalType":"uint16[]","name":"shares","type":"uint16[]"},{"internalType":"uint256","name":"maxMintPerTransaction","type":"uint256"},{"internalType":"uint256","name":"maxApprovedSale","type":"uint256"},{"internalType":"uint256","name":"maxApprovedSalePerAddress","type":"uint256"},{"internalType":"uint256","name":"maxSalePerAddress","type":"uint256"},{"internalType":"uint256","name":"approvedsaleStart","type":"uint256"},{"internalType":"uint256","name":"approvedsaleEnd","type":"uint256"},{"internalType":"uint256","name":"saleStart","type":"uint256"},{"internalType":"uint256","name":"saleEnd","type":"uint256"},{"internalType":"uint256","name":"fullPrice","type":"uint256"},{"internalType":"uint256","name":"maxUserMintable","type":"uint256"},{"internalType":"address","name":"signer","type":"address"},{"internalType":"uint256","name":"fullERC20Price","type":"uint256"},{"internalType":"bool","name":"ethSaleEnabled","type":"bool"},{"internalType":"bool","name":"erc20SaleEnabled","type":"bool"},{"internalType":"address","name":"erc20tokenAddress","type":"address"}],"internalType":"struct SaleConfiguration","name":"config","type":"tuple"},{"internalType":"uint256","name":"userMinted","type":"uint256"},{"internalType":"bool","name":"approvedSaleIsActive","type":"bool"},{"internalType":"bool","name":"saleIsActive","type":"bool"},{"internalType":"uint256","name":"version","type":"uint256"},{"internalType":"bool","name":"isMembership","type":"bool"}],"internalType":"struct SaleInfo[]","name":"saleInfo","type":"tuple[]"},{"internalType":"uint256","name":"chainid","type":"uint256"}],"internalType":"struct ProjectFactory.ProjectDetails","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"communityId","type":"uint32"},{"internalType":"uint32","name":"projectId","type":"uint32"}],"name":"getProjectMapByCommunity","outputs":[{"internalType":"uint32","name":"collectionId","type":"uint32"}],"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":"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":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"","type":"uint32"},{"internalType":"uint32","name":"","type":"uint32"}],"name":"projectMapByCommunity","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"callerConfirmation","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_tracker","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"retrieve721","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_tracker","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"retrieveERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"retrieveETH","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":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"useCommunityRandom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"}]

9c4d535b00000000000000000000000000000000000000000000000000000000000000000100078f2a0bb467c5b24b662de6b2be4920026c6550cc1b61783075488fdb04000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f8274c5e5149a6e0fc5190483323a1b399896a8a

0x0002000000000002001c00000000000200010000000103550000006003100270000006ec0030019d000006ec0330019700000001002001900000002b0000c13d0000008002000039000000400020043f000000040030008c000000510000413d001c00000000003d000000000201043b000000e002200270000006ff0020009c000000530000a13d000007000020009c0000008e0000a13d000007010020009c0000009c0000213d000007070020009c0000013b0000213d0000070a0020009c000007710000613d0000070b0020009c000000510000c13d0000000001000416000000000001004b000000510000c13d0000000001000412001300000001001d001200200000003d000080050100003900000044030000390000000004000415000000130440008a000000050440021000000734020000411baa1b820000040f000000800010043f0000072a0100004100001bab0001042e0000000002000416000000000002004b000000510000c13d0000001f02300039000006ed02200197000000c002200039000000400020043f0000001f0430018f000006ee05300198000000c0025000390000003c0000613d000000c006000039000000000701034f000000007807043c0000000006860436000000000026004b000000380000c13d000000000004004b000000490000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000400030008c000000510000413d000000c00200043d000006ef0020009c000000510000213d000000e00100043d000006ef0010009c000000b90000a13d000000000100001900001bac00010430000007150020009c0000006e0000213d0000071f0020009c000000c60000a13d000007200020009c000000ed0000213d000007230020009c000002110000613d000007240020009c000000510000c13d000000240030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000401100370000000000101043b000000000010043f0000000101000039000000200010043f00000000010000191baa1b710000040f0000000101100039000000000101041a000000800010043f0000072a0100004100001bab0001042e000007160020009c000000d30000a13d000007170020009c000001020000213d0000071a0020009c000002560000613d0000071b0020009c000000510000c13d0000000001000416000000000001004b000000510000c13d000000000100041a000006ef021001970000000005000411000000000052004b000007d70000c13d000006f001100197000000000010041b0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f1011001c70000800d020000390000000303000039000006f20400004100000000060000191baa1ba00000040f0000000100200190000000510000613d000000000100001900001bab0001042e0000070c0020009c000000e00000a13d0000070d0020009c0000011a0000213d000007100020009c000002b40000613d000007110020009c000000510000c13d0000000001000416000000000001004b000000510000c13d000000800000043f0000072a0100004100001bab0001042e000007020020009c000001590000213d000007050020009c000007760000613d000007060020009c000000510000c13d000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000402100370000000000302043b000006ec0030009c000000510000213d0000002401100370000000000201043b000006ec0020009c000000510000213d00000000010300191baa1a5a0000040f000006ec01100197000000400200043d0000000000120435000006ec0020009c000006ec0200804100000040012002100000072b011001c700001bab0001042e0000000006000411000000000006004b000001720000c13d000000400100043d000006fd02000041000000000021043500000004021000390000000000020435000006ec0010009c000006ec010080410000004001100210000006fe011001c700001bac00010430000007250020009c0000032c0000613d000007260020009c0000030e0000613d000007270020009c000000510000c13d0000000001000416000000000001004b000000510000c13d0000075901000041000000800010043f0000072a0100004100001bab0001042e0000071c0020009c000006970000613d0000071d0020009c0000031f0000613d0000071e0020009c000000510000c13d0000000001000416000000000001004b000000510000c13d0000073c01000041000000800010043f0000072a0100004100001bab0001042e000007120020009c0000076a0000613d000007130020009c000003240000613d000007140020009c000000510000c13d0000000001000416000000000001004b000000510000c13d000006f901000041000000800010043f0000072a0100004100001bab0001042e000007210020009c0000025d0000613d000007220020009c000000510000c13d000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000002402100370000000000302043b000006ef0030009c000000510000213d0000000002000411000000000023004b000007e10000c13d0000000401100370000000000101043b1baa1b1f0000040f000000000100001900001bab0001042e000007180020009c000002a60000613d000007190020009c000000510000c13d0000000001000416000000000001004b000000510000c13d000000c001000039000000400010043f0000001001000039000000800010043f0000073901000041000000a00010043f0000002001000039000000c00010043f0000008001000039000000e0020000391baa19a60000040f000000c00110008a000006ec0010009c000006ec0100804100000060011002100000073a011001c700001bab0001042e0000070e0020009c000002cb0000613d0000070f0020009c000000510000c13d000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000402100370000000000202043b000006ec0020009c000000510000213d0000002401100370000000000101043b001000000001001d000006ec0010009c000000510000213d000000000020043f0000000201000039000000200010043f00000000010000191baa1b710000040f0000001002000029000000000020043f000000200010043f00000000010000191baa1b710000040f000000000101041a000006ec01100197000000800010043f0000072a0100004100001bab0001042e000007080020009c000007b40000613d000007090020009c000000510000c13d000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000002402100370000000000202043b001000000002001d000006ef0020009c000000510000213d0000000401100370000000000101043b000f00000001001d000000000010043f0000000101000039000000200010043f00000000010000191baa1b710000040f0000000101100039000000000101041a1baa1aef0000040f0000000f0100002900000010020000291baa1b1f0000040f000000000100001900001bab0001042e000007030020009c000007c70000613d000007040020009c000000510000c13d000000240030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000401100370000000000601043b000006ef0060009c000000510000213d000000000100041a000006ef021001970000000005000411000000000052004b000007d70000c13d000000000006004b0000080f0000c13d000006fd01000041000000800010043f000000840000043f000007290100004100001bac00010430001000000001001d000000000100041a000f00000002001d000006f002100197000000000262019f000000000020041b0000000002000414000006ef05100197000006ec0020009c000006ec02008041000000c001200210000006f1011001c70000800d020000390000000303000039000006f2040000411baa1ba00000040f00000010010000290000000100200190000000510000613d000000800010043f0000000302000039000000000102041a000007870110019700000001011001bf000000000012041b000006f30100004100000000001004430000000001000414000006ec0010009c000006ec01008041000000c001100210000006f4011001c70000800b020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000a00010043f0000000001000411000006ef01100197001000000001001d000000000010043f000006f501000041000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b000000000101041a000000ff00100190000001cb0000c13d0000001001000029000000000010043f000006f501000041000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b000000000201041a000007870220019700000001022001bf000000000021041b0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f1011001c70000800d020000390000000403000039000006f7040000410000000005000019000000100600002900000000070004111baa1ba00000040f0000000100200190000000510000613d0000001001000029000000000010043f000006f801000041000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f00000001002001900000000f02000029000000510000613d000000000101043b000000000101041a000000ff00100190000001fe0000c13d0000001001000029000000000010043f000006f801000041000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b000000000201041a000007870220019700000001022001bf000000000021041b0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f1011001c70000800d020000390000000403000039000006f704000041000006f905000041000000100600002900000000070004111baa1ba00000040f00000001002001900000000f02000029000000510000613d0000000801200210000006fa011001970000000303000039000000000203041a000006fb02200197000000000112019f000000000013041b000000800100043d000001400000044300000160001004430000002001000039000000a00200043d0000018000100443000001a000200443000001000010044300000002010000390000012000100443000006fc0100004100001bab0001042e000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000402100370000000000202043b000006ef0020009c000000510000213d000000000300041a000006ef043001970000000003000411000000000034004b000007dc0000c13d0000075704000041000000800040043f000000840030043f0000002401100370000000000101043b000000a40010043f0000000001000414000006ec0010009c000006ec01008041000000c00110021000000758011001c71baa1ba00000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf0000023a0000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b000002360000c13d000000000006004b000002470000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000007e50000613d0000001f01400039000000600110018f00000080011001bf000000400010043f000000200030008c000000510000413d000000800100043d000000000001004b0000000002000039000000010200c039000000000021004b0000008c0000613d000000510000013d0000000001000416000000000001004b000000510000c13d0000073b01000041000000800010043f0000072a0100004100001bab0001042e000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000402100370000000000202043b001000000002001d0000002401100370000000000101043b000f00000001001d000006ef0010009c000000510000213d0000001001000029000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b0000000101100039000000000101041a000e00000001001d000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b0000000002000411000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b000000000101041a000000ff00100190000008230000c13d000000400100043d00000024021000390000000e03000029000000000032043500000756020000410000000000210435000000040210003900000000030004110000000000320435000006ec0010009c000006ec01008041000000400110021000000733011001c700001bac000104300000000001000416000000000001004b000000510000c13d0000000001000412001500000001001d001400000000003d000080050100003900000044030000390000000004000415000000150440008a000000050440021000000734020000411baa1b820000040f000003280000013d000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000002402100370000000000202043b001000000002001d000006ef0020009c000000510000213d0000000401100370000000000101043b000000000010043f0000000101000039000000200010043f00000000010000191baa1b710000040f0000001002000029000000000020043f000000200010043f00000000010000191baa1b710000040f000007cb0000013d000000440030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000401100370000000000101043b001000000001001d000006ef0010009c000000510000213d000000000100041a000006ef011001970000000002000411000000000021004b000007d20000c13d00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d0000002401300039000000000200041100000000002104350000073601000041000000000013043500000004013000390000000002000410000000000021043500000024010000390000000101100367000000000101043b00000044023000390000000000120435000006ec0030009c000f00000003001d000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000737011001c700000010020000291baa1ba00000040f00000001002001900000086f0000613d0000000f010000290000072f0010009c0000096e0000213d0000000f01000029000000400010043f000000000100001900001bab0001042e000000240030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000401100370000000000101043b0000075a00100198000000510000c13d0000075b0010009c000000000200003900000001020060390000075c0010009c00000001022061bf000000800020043f0000072a0100004100001bab0001042e0000000001000416000000000001004b000000510000c13d1baa1a270000040f000007b80000013d0000000001000416000000000001004b000000510000c13d000000000100041a000006ef01100197000000800010043f0000072a0100004100001bab0001042e000000840030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000402100370000000000202043b001000000002001d000006ec0020009c000000510000213d001b00100000002d0000002402100370000000000202043b000f00000002001d000006ec0020009c000000510000213d001a000f0000002d0000004402100370000000000402043b0000072f0040009c000000510000213d00000000024300490000074d0020009c000000510000213d000002640020008c000000510000413d000002e002000039000000400020043f0000000405400039000000000551034f000000000505043b000000800050043f0000002405400039000000000651034f000000000606043b000006ef0060009c000000510000213d000000a00060043f0000002005500039000000000651034f000000000606043b0000072f0060009c000000510000213d00000000064600190000002307600039000000000037004b000000510000813d0000000407600039000000000771034f000000000807043b0000075d0080009c0000096e0000813d00000005078002100000003f0970003900000745099001970000075e0090009c0000096e0000213d000002e009900039000000400090043f000002e00080043f00000024066000390000000007670019000000000037004b000000510000213d000000000008004b000003770000613d0000030008000039000000000961034f000000000909043b000006ef0090009c000000510000213d00000000089804360000002006600039000000000076004b0000036f0000413d000000c00020043f0000002002500039000000000521034f000000000505043b0000072f0050009c000000510000213d00000000054500190000002304500039000000000034004b00000000060000190000074e060080410000074e04400197000000000004004b00000000070000190000074e070040410000074e0040009c000000000706c019000000000007004b000000510000c13d0000000404500039000000000441034f000000000604043b0000072f0060009c0000096e0000213d00000005076002100000003f047000390000074508400197000000400400043d0000000008840019000000000048004b000000000900003900000001090040390000072f0080009c0000096e0000213d00000001009001900000096e0000c13d000000400080043f000000000064043500000024055000390000000006570019000000000036004b000000510000213d000000000065004b000003ad0000813d0000000007040019000000000851034f000000000808043b0000ffff0080008c000000510000213d000000200770003900000000008704350000002005500039000000000065004b000003a40000413d000000e00040043f0000002004200039000000000441034f000000000404043b000001000040043f0000004004200039000000000441034f000000000404043b000001200040043f0000006004200039000000000441034f000000000404043b000001400040043f0000008004200039000000000441034f000000000404043b000001600040043f000000a004200039000000000441034f000000000404043b000001800040043f000000c004200039000000000441034f000000000404043b000001a00040043f000000e004200039000000000441034f000000000404043b000001c00040043f0000010004200039000000000441034f000000000404043b000001e00040043f0000012004200039000000000441034f000000000404043b000002000040043f0000014004200039000000000441034f000000000404043b000002200040043f0000016002200039000000000421034f000000000404043b000006ef0040009c000000510000213d000002400040043f0000002004200039000000000441034f000000000404043b000002600040043f0000004002200039000000000421034f000000000404043b000000000004004b0000000005000039000000010500c039000000000054004b000000510000c13d000002800040043f0000002002200039000000000421034f000000000404043b000000000004004b0000000005000039000000010500c039000000000054004b000000510000c13d000002a00040043f0000002002200039000000000221034f000000000202043b000006ef0020009c000000510000213d000002c00020043f0000006402100370000000000202043b0000072f0020009c000000510000213d0000000004230049000000040440008a0000074d0040009c000000510000213d000001400040008c000000510000413d000000400400043d000e00000004001d0000075f0040009c0000096e0000213d0000000e050000290000014004500039000000400040043f0000000404200039000000000441034f000000000404043b00000000054504360000002404200039000000000441034f000000000404043b000d00000005001d00000000004504350000004404200039000000000541034f000000000505043b0000072f0050009c000000510000213d00000000082500190000002305800039000000000035004b00000000060000190000074e060080410000074e05500197000000000005004b00000000070000190000074e070040410000074e0050009c000000000706c019000000000007004b000000510000c13d0000000409800039000000000591034f000000000505043b0000072f0050009c0000096e0000213d0000001f0650003900000788066001970000003f066000390000078807600197000000400600043d0000000007760019000000000067004b000000000a000039000000010a0040390000072f0070009c0000096e0000213d0000000100a001900000096e0000c13d000000400070043f000000000756043600000000085800190000002408800039000000000038004b000000510000213d0000002008900039000000000981034f000007880a5001980000001f0b50018f0000000008a70019000004480000613d000000000c09034f000000000d07001900000000ce0c043c000000000ded043600000000008d004b000004440000c13d00000000000b004b000004550000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000557001900000000000504350000000e050000290000004005500039000b00000005001d00000000006504350000002004400039000000000541034f000000000505043b0000072f0050009c000000510000213d00000000082500190000002305800039000000000035004b00000000060000190000074e060080410000074e05500197000000000005004b00000000070000190000074e070040410000074e0050009c000000000706c019000000000007004b000000510000c13d0000000409800039000000000591034f000000000505043b0000072f0050009c0000096e0000213d0000001f0650003900000788066001970000003f066000390000078807600197000000400600043d0000000007760019000000000067004b000000000a000039000000010a0040390000072f0070009c0000096e0000213d0000000100a001900000096e0000c13d000000400070043f000000000756043600000000085800190000002408800039000000000038004b000000510000213d0000002008900039000000000981034f000007880a5001980000001f0b50018f0000000008a70019000004910000613d000000000c09034f000000000d07001900000000ce0c043c000000000ded043600000000008d004b0000048d0000c13d00000000000b004b0000049e0000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000557001900000000000504350000000e050000290000006005500039000a00000005001d00000000006504350000002004400039000000000541034f000000000505043b0000072f0050009c000000510000213d00000000082500190000002305800039000000000035004b00000000060000190000074e060080410000074e05500197000000000005004b00000000070000190000074e070040410000074e0050009c000000000706c019000000000007004b000000510000c13d0000000409800039000000000591034f000000000505043b0000072f0050009c0000096e0000213d0000001f0650003900000788066001970000003f066000390000078807600197000000400600043d0000000007760019000000000067004b000000000a000039000000010a0040390000072f0070009c0000096e0000213d0000000100a001900000096e0000c13d000000400070043f000000000756043600000000085800190000002408800039000000000038004b000000510000213d0000002008900039000000000981034f000007880a5001980000001f0b50018f0000000008a70019000004da0000613d000000000c09034f000000000d07001900000000ce0c043c000000000ded043600000000008d004b000004d60000c13d00000000000b004b000004e70000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f0000000000980435000000000557001900000000000504350000000e050000290000008005500039000700000005001d00000000006504350000002004400039000000000541034f000000000505043b0000072f0050009c000000510000213d00000000072500190000002302700039000000000032004b00000000050000190000074e050080410000074e02200197000000000002004b00000000060000190000074e060040410000074e0020009c000000000605c019000000000006004b000000510000c13d0000000408700039000000000281034f000000000202043b0000072f0020009c0000096e0000213d0000001f0520003900000788055001970000003f055000390000078806500197000000400500043d0000000006650019000000000056004b000000000900003900000001090040390000072f0060009c0000096e0000213d00000001009001900000096e0000c13d000000400060043f000000000625043600000000072700190000002407700039000000000037004b000000510000213d0000002003800039000000000731034f00000788082001980000001f0920018f0000000003860019000005230000613d000000000a07034f000000000b06001900000000ac0a043c000000000bcb043600000000003b004b0000051f0000c13d000000000009004b000005300000613d000000000787034f0000000308900210000000000903043300000000098901cf000000000989022f000000000707043b0000010008800089000000000787022f00000000078701cf000000000797019f0000000000730435000000000226001900000000000204350000000e02000029000000a002200039000100000002001d00000000005204350000002002400039000000000321034f000000000303043b000000000003004b0000000004000039000000010400c039000000000043004b000000510000c13d0000000e04000029000000c005400039000500000005001d00000000003504350000002003200039000000000331034f000000000303043b000000e005400039000400000005001d00000000003504350000004003200039000000000331034f000000000303043b0000010004400039000300000004001d00000000003404350000006002200039000000000121034f000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000000510000c13d0000000e020000290000012002200039000200000002001d000000000012043500000010010000290000000f020000291baa1a5a0000040f000000400200043d000006ec001001980000116d0000c13d000007470020009c0000096e0000213d0000004001200039000000400010043f00000020012000390000073d0300004100000000003104350000000e0300003900000000003204350000073e03000041000000400500043d0000000000350435000000040350003900000020040000390000000000430435000000000302043300000024025000390000000000320435000900000005001d0000004402500039000c00000003001d000000000003004b0000057f0000613d0000000003000019000000000423001900000000051300190000000005050433000000000054043500000020033000390000000c0030006c000005780000413d0000000c012000290000000000010435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d0000000c020000290000001f0220003900000788022001970000004402200039000006ec0020009c000006ec0200804100000060022002100000000903000029000006ec0030009c000006ec030080410000004003300210000000000232019f000000000301043b0000000001000414000006ec0010009c000006ec01008041000000c001100210000000000121019f000006ef023001971baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000905700029000005b20000613d000000000801034f0000000909000029000000008a08043c0000000009a90436000000000059004b000005ae0000c13d000000000006004b000005bf0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000011800000613d0000001f01400039000000600110018f0000000902100029000000000012004b00000000010000390000000101004039000c00000002001d0000072f0020009c0000096e0000213d00000001001001900000096e0000c13d0000000c01000029000000400010043f000000200030008c000000510000413d00000009010000290000000002010433000006ef0020009c000000510000213d00000741010000410000000c040000290000000001140436000900000001001d0000001001000029000006ec031001970000000401400039000600000003001d0000000000310435000006ec0040009c000006ec01000041000000000104401900000040011002100000000003000414000006ec0030009c000006ec03008041000000c003300210000000000113019f000006fe011001c71baa1ba50000040f00000060031002700000001f0530018f000006ee08300197000006ec033001970000000100200190000000000481034f00000003025002100000118c0000613d0000000c06800029000000000008004b000005f80000613d0000000c07000029000000001801043c0000000007870436000000000067004b000005f40000c13d000000000005004b000006030000613d000000000106043300000000012101cf000000000121022f000000000404043b0000010002200089000000000424022f00000000022401cf000000000112019f00000000001604350000001f01300039000006ed011001970000000c041000290000072f0040009c0000096e0000213d000000400040043f000000600030008c000000510000413d0000000c0100002900000000010104330000072f0010009c000000510000213d0000000c033000290000000c011000290000001f02100039000000000032004b000000510000813d00000000210104340000072f0010009c0000096e0000213d0000001f0510003900000788055001970000003f05500039000007880550019700000000054500190000072f0050009c0000096e0000213d000000400050043f00000000041404360000000005210019000000000035004b000000510000213d000000000001004b0000062d0000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000006260000413d0000000001410019000000000001043500000009010000290000000001010433001000000001001d000006ef0010009c000000510000213d0000000c0100002900000040011000390000000001010433000006ec0010009c000000510000213d000000100000006b000007560000613d000000400300043d000900000003001d00000764010000410000000000130435000000040130003900000738020000410000000000210435000000240130003900000000020004110000000000210435000006ec0030009c000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000733011001c700000010020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000090b0000290000000905700029000006610000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000065d0000c13d000000000006004b0000066e0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000011a60000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000c00000002001d0000072f0020009c0000096e0000213d00000001001001900000096e0000c13d0000000c01000029000000400010043f000000200030008c000000510000413d00000000040b0433000000000004004b0000000001000039000000010100c039000000000014004b000000510000c13d0000000c03000029000000440130003900000024023000390000000403300039000000000004004b000011b20000c13d00000762040000410000000c050000290000000000450435000000200400003900000000004304350000002d0300003900000000003204350000078302000041000000000021043500000064015000390000078402000041000012070000013d000000240030008c000000510000413d0000000002000416000000000002004b000000510000c13d0000000401100370000000000101043b001000000001001d000006ec0010009c000000510000213d0000006001000039000000800010043f000000a00010043f000000c00010043f000000e00010043f000001000000043f0000016001000039000000400010043f0000000e01000039000001200010043f0000073d02000041000001400020043f0000073e03000041000001600030043f0000002003000039000001640030043f000001840010043f000001a40020043f000001b20000043f000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b0000000003000414000006ef02100197000006ec0030009c000006ec03008041000000c00130021000000740011001c71baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000016005700039000001600a000039000006d90000613d000000000801034f000000008908043c000000000a9a043600000000005a004b000006d50000c13d000000000006004b000006e60000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000007f10000613d0000001f01400039000000600110018f000e00000001001d0000016001100039000f00000001001d000000400010043f000000200030008c000000510000413d000001600200043d000006ef0020009c000000510000213d00000741010000410000000f0400002900000000001404350000000e0100002900000164011000390000001003000029000000000031043500000040014002100000000003000414000006ec0030009c000006ec03008041000000c003300210000000000113019f000006fe011001c71baa1ba50000040f00000060031002700000001f0430018f000006ee05300197000006ec033001970000000100200190000008c90000613d0000000f090000290000000002590019000000000005004b000007120000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b0000070e0000c13d000000000004004b0000071f0000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000006ed011001970000000004910019000000400040043f000000600030008c000000510000413d0000000f0100002900000000010104330000072f0010009c000000510000213d0000000f033000290000000f011000290000001f02100039000000000032004b000000510000813d00000000210104340000072f0010009c0000096e0000213d0000001f0510003900000788055001970000003f05500039000007880550019700000000054500190000072f0050009c0000096e0000213d000000400050043f00000000041404360000000005210019000000000035004b000000510000213d000000000001004b000007470000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000007400000413d000000000141001900000000000104350000000e0100002900000180011001bf0000000001010433000d00000001001d000006ef0010009c000000510000213d0000000e01000029000001a0011000390000000001010433000006ec0010009c000000510000213d0000000d0000006b000008e90000c13d000000400100043d00000064021000390000078503000041000000000032043500000044021000390000078603000041000000000032043500000024021000390000002403000039000000000032043500000762020000410000000000210435000000040210003900000020030000390000000000320435000006ec0010009c000006ec01008041000000400110021000000763011001c700001bac000104300000000001000416000000000001004b000000510000c13d0000073801000041000000800010043f0000072a0100004100001bab0001042e0000000001000416000000000001004b000000510000c13d1baa1a380000040f000007b80000013d0000000001000416000000000001004b000000510000c13d000000000100041a000006ef011001970000000002000411000000000021004b000007d20000c13d0000072c010000410000000000100443000000000100041000000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c70000800a020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b001000000001001d0000072c010000410000000000100443000000000100041000000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c70000800a020000391baa1ba50000040f0000000100200190000019980000613d0000000002000410000000000101043b0000001003000029000000000031004b0000081b0000813d001100000002001d0000800a0100003900000024030000390000000004000415000000110440008a00000005044002100000072c020000411baa1b820000040f0000073202000041000000400300043d000000000023043500000004023000390000000000120435000000240130003900000010020000290000000000210435000006ec0030009c000006ec03008041000000400130021000000733011001c700001bac000104300000000001000416000000000001004b000000510000c13d1baa1a490000040f0000002002000039000000400300043d001000000003001d00000000022304361baa19a60000040f00000010020000290000000001210049000006ec0010009c000006ec010080410000006001100210000006ec0020009c000006ec020080410000004002200210000000000121019f00001bab0001042e0000000001000416000000000001004b000000510000c13d0000000301000039000000000101041a000000ff001001900000000001000039000000010100c039000000800010043f0000072a0100004100001bab0001042e0000072801000041000000800010043f000000840020043f000007290100004100001bac000104300000072801000041000000800010043f000000840050043f000007290100004100001bac000104300000072801000041000000800010043f000000840030043f000007290100004100001bac000104300000075401000041000000800010043f000007550100004100001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000007ec0000c13d000007fc0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000007f80000c13d000000000005004b000008090000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000006ec0020009c000006ec020080410000004002200210000000000112019f00001bac00010430000006f001100197000000000161019f000000000010041b0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f1011001c70000800d020000390000000303000039000006f204000041000000890000013d0000000001000414000006ec0010009c000006ec01008041000000c001100210000000000003004b0000088b0000c13d00000000020004110000088f0000013d0000001001000029000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b0000000f02000029000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b000000000101041a000000ff001001900000008c0000c13d0000001001000029000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b0000000f02000029000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b000000000201041a000007870220019700000001022001bf000000000021041b0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f1011001c70000800d020000390000000403000039000006f70400004100000010050000290000000f0600002900000000070004111baa1ba00000040f0000000100200190000000510000613d0000008c0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000008770000c13d000006ec06600197000000000004004b000008890000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f000000000013043500000060016002100000080a0000013d000006f1011001c70000800902000039000000000400041100000000050000191baa1ba00000040f0000006003100270000006ec04300198000000800a000039000008a20000c13d000000600300003900000001002001900000008c0000c13d0000000001030433000000000001004b000008e10000c13d000000400100043d00000730020000410000000000210435000006ec0010009c000006ec01008041000000400110021000000731011001c700001bac000104300000001f03400039000006ed033001970000003f033000390000072e05300197000000400300043d0000000005530019000000000035004b000000000600003900000001060040390000072f0050009c0000096e0000213d00000001006001900000096e0000c13d000000400050043f0000001f0540018f000000000a430436000006ee0640019800000000046a0019000008bb0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000048004b000008b70000c13d000000000005004b000008950000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000008950000013d000000400200043d0000000006520019000000000005004b000008d30000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000008cf0000c13d000000000004004b000008090000613d000000000151034f0000000304400210000000000506043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000160435000008090000013d000006ec00a0009c000006ec0a0080410000004002a00210000006ec0010009c000006ec010080410000006001100210000000000121019f00001bac00010430000000400300043d001000000003001d00000044013000390000074202000041000000000021043500000024013000390000000b02000039000000000021043500000743010000410000000000130435000000040130003900000020020000390000000000210435000006ec0030009c000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000737011001c70000000d020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000100b0000290000001005700029000009120000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000090e0000c13d000000000006004b0000091f0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000009740000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000f00000002001d0000072f0020009c0000096e0000213d00000001001001900000096e0000c13d0000000f01000029000000400010043f000000200030008c000000510000413d00000000010b0433000b00000001001d0000000f0300002900000044013000390000074402000041000000000021043500000024013000390000000a02000039000000000021043500000743010000410000000000130435000000040130003900000020020000390000000000210435000006ec0030009c000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000737011001c70000000d020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f05700029000009590000613d000000000801034f0000000f09000029000000008a08043c0000000009a90436000000000059004b000009550000c13d000000000006004b000009660000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000009800000613d0000001f01400039000000600110018f0000000f01100029000a00000001001d0000072f0010009c0000098c0000a13d0000075201000041000000000010043f0000004101000039000000040010043f000006fe0100004100001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000097b0000c13d000007fc0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000009870000c13d000007fc0000013d0000000a01000029000000400010043f000000200030008c000000510000413d0000000b010000290000072f0010009c0000096e0000213d0000000b0100002900000005011002100000003f0210003900000745022001970000000a032000290000072f0030009c0000096e0000213d0000000f040000290000000004040433000700000004001d000000400030043f0000000a030000290000000b040000290000000003430436000900000003001d0000001f0310018f000000000001004b000009ad0000613d0000000906000029000000000416001900000000050000310000000105500367000000005705043c0000000006760436000000000046004b000009a90000c13d000000000003004b000000400300043d0000000002230019001000000003001d000000000032004b000000000300003900000001030040390000072f0020009c0000096e0000213d00000001003001900000096e0000c13d000000400020043f00000010020000290000000b030000290000000002320436000800000002001d000000000003004b00000b3b0000c13d00000007010000290000072f0010009c0000096e0000213d000000070100002900000005011002100000003f021000390000074502200197000000400400043d0000000003240019000900000004001d000000000043004b000000000400003900000001040040390000072f0030009c0000096e0000213d00000001004001900000096e0000c13d000000400030043f000000070300002900000009040000290000000003340436000800000003001d0000001f0310018f000000000001004b000009e00000613d0000000806000029000000000416001900000000050000310000000105500367000000005705043c0000000006760436000000000046004b000009dc0000c13d000000000003004b000000400300043d0000000002230019000f00000003001d000000000032004b000000000300003900000001030040390000072f0020009c0000096e0000213d00000001003001900000096e0000c13d000000400020043f00000007020000290000000f030000290000000003230436000600000003001d000000000002004b00000e410000c13d000000400100043d001700000001001d000e00000001001d000007530010009c0000096e0000213d0000000e03000029000000a001300039000000400010043f00000060023000390000000f01000029000d00000002001d000000000012043500000040023000390000001001000029000c00000002001d00000000001204350000000a0100002900000000021304360000000901000029001000000002001d00000000001204350000073401000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b0000000e040000290000008002400039000b00000002001d0000000000120435000000400300043d001600000003001d000000200100003900000000011304360000000004040433000000a0020000390000000000210435000000c00130003900000000050404330000000000510435000f00000003001d000000e001300039000000000005004b00000a310000613d000000000300001900000020044000390000000002040433000006ef0220019700000000012104360000000103300039000000000053004b00000a2a0000413d0000000f030000290000000002310049000000200220008a000000100400002900000000050404330000004003300039000000000023043500000000060504330000000004610436000000000006004b00000a440000613d000000000100001900000020055000390000000002050433000006ef0220019700000000042404360000000101100039000000000061004b00000a3d0000413d0000000f020000290000000001240049000000200110008a0000000c03000029000000000503043300000060022000390000000000120435000000000205043300000000002404350000000501200210000000000114001900000020091000390000001c01000029001000000002001d000000000021004b000010740000813d0000000008010019000000000a04001900000a660000013d0000022002b0003900000000020204330000022003900039000000000023043500000240029000390000024003b000390000000003030433000000000003004b0000000003000039000000010300c03900000000003204350000000108800039000000100080006c00000000090c0019000010750000813d0000000002490049000000200220008a000000200aa0003900000000002a04350000002005500039000000000b05043300000000d20b04340000026003000039000000000c390436000002600f900039000000003e0204340000000000ef0435000002800f90003900000000000e004b00000a7d0000613d00000000020000190000000007f2001900000000062300190000000006060433000000000067043500000020022000390000000000e2004b00000a760000413d0000000002fe001900000000000204350000001f02e0003900000788022001970000000002f2001900000000030d0433000000000692004900000000006c0435000000003d030434000000000cd2043600000000000d004b00000a910000613d00000000020000190000000006c2001900000000072300190000000007070433000000000076043500000020022000390000000000d2004b00000a8a0000413d0000000002cd001900000000000204350000004002b000390000000002020433000000400390003900000000002304350000006002b000390000000002020433000000600390003900000000002304350000008002b00039000000000202043300000080039000390000000000230435000000a002b000390000000002020433000000a0039000390000000000230435000000c002b000390000000002020433000000c0039000390000000000230435000000e002b000390000000002020433000000e00390003900000000002304350000001f02d0003900000788022001970000000002c20019000000000392004900000100069000390000010007b0003900000000070704330000000000360435000000003d070434000000000cd2043600000000000d004b00000abf0000613d00000000020000190000000006c2001900000000072300190000000007070433000000000076043500000020022000390000000000d2004b00000ab80000413d0000000002cd001900000000000204350000001f02d0003900000788022001970000000002c200190000012003b000390000000003030433000000000692004900000120079000390000000000670435000000003d030434000000000cd2043600000000000d004b00000ad50000613d00000000020000190000000006c2001900000000072300190000000007070433000000000076043500000020022000390000000000d2004b00000ace0000413d0000000002cd001900000000000204350000014002b000390000000002020433000000000002004b0000000002000039000000010200c039000001400390003900000000002304350000016002b000390000000002020433000000000002004b0000000002000039000000010200c039000001600390003900000000002304350000018002b000390000000002020433000001800390003900000000002304350000001f02d0003900000788022001970000000002c200190000000003920049000001a006900039000001a007b00039000000000d0704330000000000360435000000000e0d0433000000000ce204360000000000e1004b000000000f01001900000b130000813d000000200dd0003900000000020d0433000000006302043400000000033c043600000000060604330000000000630435000000400320003900000000030304330000004006c000390000000000360435000000600320003900000000030304330000006006c000390000000000360435000000800320003900000000030304330000008006c000390000000000360435000000a0022000390000000002020433000000000002004b0000000002000039000000010200c039000000a003c000390000000000230435000000c00cc00039000000010ff000390000000000ef004b00000af60000413d000001c002b000390000000002020433000006ef02200197000001c0039000390000000000230435000001e002b00039000000000d02043300000000029c0049000001e0039000390000000000230435000000000e0d0433000000000cec043600000000000e004b00000b290000613d0000000003000019000000200dd0003900000000020d0433000006ef02200197000000000c2c043600000001033000390000000000e3004b00000b220000413d0000020002b00039000000000d02043300000000029c004900000200039000390000000000230435000000000e0d0433000000000cec043600000000000e004b00000a570000613d0000000003000019000000200dd0003900000000020d0433000006ef02200197000000000c2c043600000001033000390000000000e3004b00000b330000413d00000a570000013d00000000020000190000006005000039000000400300043d000007460030009c0000096e0000213d0000026004300039000000400040043f00000200043000390000000000540435000001e0043000390000000000540435000001a004300039000000000054043500000120043000390000000000540435000001000430003900000000005404350000002004300039000000000054043500000000005304350000024004300039000000000004043500000220043000390000000000040435000001c0043000390000000000040435000001800430003900000000000404350000016004300039000000000004043500000140043000390000000000040435000000e0043000390000000000040435000000c0043000390000000000040435000000a0043000390000000000040435000000800430003900000000000404350000006004300039000000000004043500000040043000390000000000040435000000200220003900000010042000290000000000340435000000000012004b00000b3d0000413d0000000001000415000000190110008a000c000500100218001900ff0000003d000e00000000001d0000000e01000029000000ff0010008c000012590000613d0000000e020000290000000101200039000000630020008c00000000020100190000000003000019000000ff0210818f000000640220811a0000000203008039000000400400043d000007470040009c0000096e0000213d0000004005400039000000400050043f000000090020008c00000001033021bf0000000102300039000000000224043600000000050000310000000105500367000000000505043b000000000052043500000000033400190000002103300039000000090010008c0000000a5110011a0000000305500210000000010330008a00000000060304330000074806600197000007490550021f0000074a05500197000000000565019f000000000053043500000b8b0000213d000000400300043d00000020013000390000074b05000041000000000051043500000026053000390000000004040433000000000004004b00000ba60000613d000000000600001900000000075600190000000008260019000000000808043300000000008704350000002006600039000000000046004b00000b9f0000413d0000000002540019000000000002043500000006024000390000000000230435000000450240003900000788022001970000000004320019000000000024004b00000000020000390000000102004039000f00000004001d0000072f0040009c0000096e0000213d00000001002001900000096e0000c13d0000000f05000029000000400050043f0000073e0200004100000000002504350000000402500039000000200400003900000000004204350000000002030433000000240350003900000000002304350000004403500039000000000002004b00000bca0000613d000000000400001900000000053400190000000006140019000000000606043300000000006504350000002004400039000000000024004b00000bc30000413d0000001f012000390000078801100197000000000232001900000000000204350000004401100039000006ec0010009c000006ec0100804100000060011002100000000f02000029000006ec0020009c000006ec020080410000004002200210000000000121019f0000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f0000000d020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c0000002004000039000000000403401900000020064001900000000f0560002900000bec0000613d000000000701034f0000000f08000029000000007907043c0000000008980436000000000058004b00000be80000c13d0000001f0740019000000bf90000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000011310000613d0000001f01400039000000600210018f0000000f01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200030008c000000510000413d0000000f010000290000000002010433000006ef0020009c000000510000213d000000000002004b00000e340000613d0000000c0100002900000005011002700000000e0300002900000000013101870000000a030000290000000003030433000000000013004b0000106e0000a13d000000050110021000000009011000290000000000210435000000400300043d0000074c010000410000000000130435000006ec0030009c000f00000003001d000006ec01000041000000000103401900000040011002100000000003000414000006ec0030009c000006ec03008041000000c003300210000000000113019f00000731011001c71baa1ba50000040f00000060031002700000001f0430018f000006ee05300197000006ec0330019700000001002001900000113d0000613d0000000f02500029000000000005004b00000c370000613d000000000601034f0000000f07000029000000006806043c0000000007870436000000000027004b00000c330000c13d000000000004004b00000c440000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000006ed021001970000000f01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200030008c000000510000413d0000000f0200002900000000020204330000072f0020009c000000510000213d00000000042300490000074d0040009c000000510000213d000002600040008c000000510000413d000007460010009c0000096e0000213d0000000f022000290000026005100039000000400050043f00000000640204340000072f0040009c000000510000213d00000000072400190000000f033000290000074e043001970000001f087000390000074e09800197000000000a49013f000000000049004b00000000090000190000074e09004041000000000038004b00000000080000190000074e080080410000074e00a0009c000000000908c019000000000009004b000000510000c13d00000000870704340000072f0070009c0000096e0000213d0000001f0970003900000788099001970000003f09900039000007880990019700000000095900190000072f0090009c0000096e0000213d000000400090043f00000000007504350000000009870019000000000039004b000000510000213d0000028009100039000000000007004b00000c8c0000613d000000000a000019000000000b9a0019000000000c8a0019000000000c0c04330000000000cb0435000000200aa0003900000000007a004b00000c850000413d00000000079700190000000000070435000000000551043600000000060604330000072f0060009c000000510000213d00000000062600190000001f07600039000000000037004b00000000080000190000074e080080410000074e07700197000000000947013f000000000047004b00000000070000190000074e070040410000074e0090009c000000000708c019000000000007004b000000510000c13d00000000760604340000072f0060009c0000096e0000213d0000001f0860003900000788088001970000003f088000390000078809800197000000400800043d0000000009980019000000000089004b000000000a000039000000010a0040390000072f0090009c0000096e0000213d0000000100a001900000096e0000c13d000000400090043f0000000009680436000000000a76001900000000003a004b000000510000213d000000000006004b00000cbf0000613d000000000a000019000000000b9a0019000000000c7a0019000000000c0c04330000000000cb0435000000200aa0003900000000006a004b00000cb80000413d000000000669001900000000000604350000000000850435000000400520003900000000050504330000004006100039000000000056043500000060052000390000000005050433000000600610003900000000005604350000008005200039000000000505043300000080061000390000000000560435000000a0052000390000000005050433000000a0061000390000000000560435000000c0052000390000000005050433000000c0061000390000000000560435000000e005100039000000e00620003900000000060604330000000000650435000001000520003900000000050504330000072f0050009c000000510000213d00000000052500190000001f06500039000000000036004b00000000070000190000074e070080410000074e06600197000000000846013f000000000046004b00000000060000190000074e060040410000074e0080009c000000000607c019000000000006004b000000510000c13d00000000650504340000072f0050009c0000096e0000213d0000001f0750003900000788077001970000003f077000390000078808700197000000400700043d0000000008870019000000000078004b000000000900003900000001090040390000072f0080009c0000096e0000213d00000001009001900000096e0000c13d000000400080043f00000000085704360000000009650019000000000039004b000000510000213d000000000005004b00000d0b0000613d0000000009000019000000000a890019000000000b690019000000000b0b04330000000000ba04350000002009900039000000000059004b00000d040000413d0000000005580019000000000005043500000100051000390000000000750435000001200520003900000000050504330000072f0050009c000000510000213d00000000052500190000001f06500039000000000036004b00000000070000190000074e070080410000074e06600197000000000846013f000000000046004b00000000060000190000074e060040410000074e0080009c000000000607c019000000000006004b000000510000c13d00000000650504340000072f0050009c0000096e0000213d0000001f0750003900000788077001970000003f077000390000078808700197000000400700043d0000000008870019000000000078004b000000000900003900000001090040390000072f0080009c0000096e0000213d00000001009001900000096e0000c13d000000400080043f00000000085704360000000009650019000000000039004b000000510000213d000000000005004b00000d400000613d0000000009000019000000000a890019000000000b690019000000000b0b04330000000000ba04350000002009900039000000000059004b00000d390000413d000000000558001900000000000504350000012005100039000000000075043500000140052000390000000005050433000000000005004b0000000006000039000000010600c039000000000065004b000000510000c13d0000014006100039000000000056043500000160052000390000000005050433000000000005004b0000000006000039000000010600c039000000000065004b000000510000c13d000001600610003900000000005604350000018005100039000001800620003900000000060604330000000000650435000001a00520003900000000050504330000072f0050009c000000510000213d00000000055200190000001f06500039000000000036004b00000000070000190000074e070080410000074e06600197000000000846013f000000000046004b00000000060000190000074e060040410000074e0080009c000000000607c019000000000006004b000000510000c13d00000000570504340000072f0070009c0000096e0000213d00000005067002100000003f066000390000074508600197000000400600043d0000000008860019000000000068004b000000000900003900000001090040390000072f0080009c0000096e0000213d00000001009001900000096e0000c13d000000400080043f0000000000760435000000c0077000c90000000007570019000000000037004b000000510000213d000000000075004b00000dac0000813d000000000806001900000000095300490000074d0090009c000000510000213d000000c00090008c000000510000413d000000400900043d0000074f0090009c0000096e0000213d000000c00a9000390000004000a0043f00000000ba050434000000000aa90436000000000b0b04330000000000ba0435000000400a500039000000000a0a0433000000400b9000390000000000ab0435000000600a500039000000000a0a0433000000600b9000390000000000ab0435000000800a900039000000800b500039000000000b0b04330000000000ba0435000000a00a500039000000000a0a043300000000000a004b000000000b000039000000010b00c0390000000000ba004b000000510000c13d0000002008800039000000a00b9000390000000000ab04350000000000980435000000c005500039000000000075004b00000d840000413d000001a0051000390000000000650435000001c0052000390000000005050433000006ef0050009c000000510000213d000001c0061000390000000000560435000001e00520003900000000050504330000072f0050009c000000510000213d00000000052500190000001f06500039000000000036004b00000000070000190000074e070080410000074e06600197000000000846013f000000000046004b00000000060000190000074e060040410000074e0080009c000000000607c019000000000006004b000000510000c13d00000000570504340000072f0070009c0000096e0000213d00000005087002100000003f068000390000074509600197000000400600043d0000000009960019000000000069004b000000000a000039000000010a0040390000072f0090009c0000096e0000213d0000000100a001900000096e0000c13d000000400090043f00000000007604350000000007580019000000000037004b000000510000213d000000000075004b00000de40000813d00000000080600190000000059050434000006ef0090009c000000510000213d00000020088000390000000000980435000000000075004b00000ddd0000413d000001e0051000390000000000650435000002000520003900000000050504330000072f0050009c000000510000213d00000000052500190000001f06500039000000000036004b00000000070000190000074e070080410000074e06600197000000000846013f000000000046004b00000000040000190000074e040040410000074e0080009c000000000407c019000000000004004b000000510000c13d00000000460504340000072f0060009c0000096e0000213d00000005076002100000003f057000390000074508500197000000400500043d0000000008850019000000000058004b000000000900003900000001090040390000072f0080009c0000096e0000213d00000001009001900000096e0000c13d000000400080043f00000000006504350000000006470019000000000036004b000000510000213d000000000064004b00000e160000813d00000000030500190000000047040434000006ef0070009c000000510000213d00000020033000390000000000730435000000000064004b00000e0f0000413d00000200031000390000000000530435000002200310003900000220042000390000000004040433000000000043043500000240022000390000000002020433000000000002004b0000000003000039000000010300c039000000000032004b000000510000c13d000002400310003900000000002304350000000c0200002900000005022002700000000e03000029000000000232018700000010030000290000000003030433000000000023004b0000106e0000a13d00000005032002100000000803300029000000000013043500000010010000290000000001010433000000000021004b0000106e0000a13d0000000e01000029000000ff0110018f000000ff0010008c000012590000613d0000000002000415000000180220008a000c000500200218001800ff0000003d0000000102100039000e00000002001d0000000b0020006c00000b710000413d000009bf0000013d00000000020000190000006006000039000000400300043d0000074f0030009c0000096e0000213d000000c004300039000000400040043f000007500030009c0000096e0000213d0000032005300039000000400050043f00000000000404350000012005300039000000000065043500000100053000390000000000650435000000000443043600000300053000390000000000050435000002e0053000390000000000050435000002c0053000390000000000050435000002a00530003900000000000504350000028005300039000000000005043500000260053000390000000000050435000002400530003900000000000504350000022005300039000000000005043500000200053000390000000000050435000001e0053000390000000000050435000001c0053000390000000000050435000001a0053000390000000000050435000001800530003900000000000504350000016005300039000000000005043500000140053000390000000000050435000000e0053000390000000000050435000000a0053000390000000000050435000000800530003900000000000504350000006005300039000000000005043500000040053000390000000000050435000000000004043500000020022000390000000f042000290000000000340435000000000012004b00000e430000413d0000000d01000029000b06ef0010019b000d00000000001d0000000002000019000000ff0020008c000012590000613d0000000101200039000000630020008c00000000020100190000000003000019000000ff0210818f000000640220811a0000000203008039000000400400043d000007470040009c0000096e0000213d0000004005400039000000400050043f000000090020008c00000001033021bf0000000102300039000000000224043600000000050000310000000105500367000000000505043b000000000052043500000000033400190000002103300039000000090010008c0000000a5110011a0000000305500210000000010330008a00000000060304330000074806600197000007490550021f0000074a05500197000000000565019f000000000053043500000e9c0000213d000000400300043d00000020013000390000075105000041000000000051043500000025053000390000000004040433000000000004004b00000eb70000613d000000000600001900000000075600190000000008260019000000000808043300000000008704350000002006600039000000000046004b00000eb00000413d0000000002540019000000000002043500000005024000390000000000230435000000440240003900000788022001970000000004320019000000000024004b00000000020000390000000102004039000e00000004001d0000072f0040009c0000096e0000213d00000001002001900000096e0000c13d0000000e05000029000000400050043f0000073e0200004100000000002504350000000402500039000000200400003900000000004204350000000002030433000000240350003900000000002304350000004403500039000000000002004b00000edb0000613d000000000400001900000000053400190000000006140019000000000606043300000000006504350000002004400039000000000024004b00000ed40000413d0000001f012000390000078801100197000000000232001900000000000204350000004401100039000006ec0010009c000006ec0100804100000060011002100000000e02000029000006ec0020009c000006ec020080410000004002200210000000000121019f0000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f0000000b020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c0000002004000039000000000403401900000020064001900000000e0560002900000efd0000613d000000000701034f0000000e08000029000000007907043c0000000008980436000000000058004b00000ef90000c13d0000001f0740019000000f0a0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000011480000613d0000001f01400039000000600210018f0000000e01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200030008c000000510000413d0000000e010000290000000002010433000006ef0020009c000000510000213d0000000d01000029000e00ff00100193000000000002004b000010640000613d000000090100002900000000010104330000000e0010006c0000106e0000a13d0000000e010000290000000503100210000c00000003001d00000008013000290000000000210435000000400300043d0000074c010000410000000000130435000006ec0030009c000d00000003001d000006ec01000041000000000103401900000040011002100000000003000414000006ec0030009c000006ec03008041000000c003300210000000000113019f00000731011001c71baa1ba50000040f00000060051002700000001f0350018f000006ee04500197000006ec055001970000000100200190000011540000613d0000000d02400029000000000004004b00000f480000613d000000000601034f0000000d07000029000000006806043c0000000007870436000000000027004b00000f440000c13d000000000003004b00000f550000613d000000000141034f0000000303300210000000000402043300000000043401cf000000000434022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000141019f00000000001204350000001f01500039000006ed021001970000000d01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200050008c000000510000413d0000000d0200002900000000040204330000072f0040009c000000510000213d00000000024500490000074d0020009c000000510000213d000000c00020008c000000510000413d0000074f0010009c0000096e0000213d0000000d06400029000000c002100039000000400020043f00000000370604340000072f0070009c000000510000213d000000000447001900000000084500490000074d0080009c000000510000213d000002600080008c000000510000413d000007500010009c0000096e0000213d0000032008100039000000400080043f0000000d044000290000000004040433000000000042043500000000047300190000000004040433000006ef0040009c000000510000213d000000e00810003900000000004804350000004004600039000000000874001900000000080804330000072f0080009c000000510000213d0000000d09500029000000000576001900000000088500190000074e0a9001970000001f0b8000390000074e0cb00197000000000dac013f0000000000ac004b000000000c0000190000074e0c00404100000000009b004b000000000b0000190000074e0b0080410000074e00d0009c000000000c0bc01900000000000c004b000000510000c13d000000008c0804340000072f00c0009c0000096e0000213d000000050dc002100000003f0bd00039000007450eb00197000000400b00043d000000000eeb00190000000000be004b000000000f000039000000010f0040390000072f00e0009c0000096e0000213d0000000100f001900000096e0000c13d0000004000e0043f0000000000cb0435000000000cd8001900000000009c004b000000510000213d0000000000c8004b00000fba0000813d000000000d0b0019000000008e080434000006ef00e0009c000000510000213d000000200dd000390000000000ed04350000000000c8004b00000fb30000413d00000100081000390000000000b804350000006008600039000000000b780019000000000b0b04330000072f00b0009c000000510000213d000000000bb500190000001f0cb0003900000000009c004b000000000d0000190000074e0d0080410000074e0cc00197000000000eac013f0000000000ac004b000000000a0000190000074e0a0040410000074e00e0009c000000000a0dc01900000000000a004b000000510000c13d00000000ac0b04340000072f00c0009c0000096e0000213d000000050dc002100000003f0bd00039000007450eb00197000000400b00043d000000000eeb00190000000000be004b000000000f000039000000010f0040390000072f00e0009c0000096e0000213d0000000100f001900000096e0000c13d0000004000e0043f0000000000cb0435000000000cda001900000000009c004b000000510000213d0000000000ca004b00000fed0000813d00000000090b001900000000ad0a04340000ffff00d0008c000000510000213d00000020099000390000000000d904350000000000ca004b00000fe60000413d00000120091000390000000000b904350000008009600039000000000a790019000000000a0a0433000001400b1000390000000000ab0435000000a00660003900000000077600190000000007070433000001600a10003900000000007a0435000000c0075000390000000007070433000001800a10003900000000007a0435000000e0075000390000000007070433000001a00a10003900000000007a043500000100075000390000000007070433000001c00a10003900000000007a043500000120075000390000000007070433000001e00a10003900000000007a043500000140075000390000000007070433000002000a10003900000000007a043500000160075000390000000007070433000002200a10003900000000007a043500000180075000390000000007070433000002400a10003900000000007a04350000026007100039000001a00a500039000000000a0a04330000000000a70435000001c0075000390000000007070433000006ef0070009c000000510000213d000002800a10003900000000007a0435000002a007100039000001e00a500039000000000a0a04330000000000a7043500000200075000390000000007070433000000000007004b000000000a000039000000010a00c0390000000000a7004b000000510000c13d000002c00a10003900000000007a043500000220075000390000000007070433000000000007004b000000000a000039000000010a00c0390000000000a7004b000000510000c13d000002e00a10003900000000007a043500000240055000390000000005050433000006ef0050009c000000510000213d000003000710003900000000005704350000000002210436000000000303043300000000003204350000000002040433000000000002004b0000000003000039000000010300c039000000000032004b000000510000c13d000000400310003900000000002304350000000002080433000000000002004b0000000003000039000000010300c039000000000032004b000000510000c13d000000600310003900000000002304350000008002100039000000000309043300000000003204350000000002060433000000000002004b0000000003000039000000010300c039000000000032004b000000510000c13d000000a00310003900000000002304350000000f0200002900000000020204330000000e0020006c0000106e0000a13d0000000c03000029000000060230002900000000001204350000000f0100002900000000010104330000000e0010006c0000106e0000a13d0000000e01000029000000ff0010008c000012590000613d0000000e010000290000000101100039000d00000001001d000000ff0210018f000000070020006c00000e840000413d000009f20000013d0000075201000041000000000010043f0000003201000039000000040010043f000006fe0100004100001bac00010430000000000c0900190000000f0300002900000000023c0049000000200220008a0000000d04000029000000000404043300000080033000390000000000230435000000000304043300000000003c0435000000050230021000000000022c00190000002006200039001000000003001d000000000031004b0000111e0000813d00000000070c0019000010e90000013d0000008002d00039000000000202043300000140036000390000000000230435000000a002d00039000000000202043300000160036000390000000000230435000000c002d00039000000000202043300000180036000390000000000230435000000e002d000390000000002020433000001a00360003900000000002304350000010002d000390000000002020433000001c00360003900000000002304350000012002d000390000000002020433000001e00360003900000000002304350000014002d000390000000002020433000002000360003900000000002304350000016002d000390000000002020433000002200360003900000000002304350000018002d00039000000000202043300000240036000390000000000230435000001a002d00039000000000202043300000260036000390000000000230435000001c002d000390000000002020433000006ef0220019700000280036000390000000000230435000001e002d000390000000002020433000002a00360003900000000002304350000020002d000390000000002020433000000000002004b0000000002000039000000010200c039000002c00360003900000000002304350000022002d000390000000002020433000000000002004b0000000002000039000000010200c039000002e00360003900000000002304350000024002d000390000000002020433000006ef0220019700000300036000390000000000230435000000000209043300000000002a043500000040028000390000000002020433000000000002004b0000000002000039000000010200c0390000004003600039000000000023043500000060028000390000000002020433000000000002004b0000000002000039000000010200c039000000600360003900000000002304350000008002800039000000000202043300000080036000390000000000230435000000a002600039000000a0038000390000000003030433000000000003004b0000000003000039000000010300c03900000000003204350000000101100039000000100010006c00000000060b0019000011200000813d0000000002c60049000000200220008a0000002007700039000000000027043500000020044000390000000008040433000000009d080434000000c002000039000000000a260436000000c00b60003900000000320d043400000000002b04350000000002030433000006ef02200197000000e00360003900000000002304350000004002d00039000000000f020433000001000260003900000260030000390000000000320435000003200360003900000000020f04330000000000230435000003400e600039000000000002004b0000110c0000613d0000000003000019000000200ff0003900000000050f0433000006ef05500197000000000e5e04360000000103300039000000000023004b000011050000413d0000000002be00490000006003d00039000000000f0304330000012003600039000000000023043500000000020f0433000000000b2e0436000000000002004b000010860000613d0000000003000019000000200ff0003900000000050f04330000ffff0550018f000000000b5b04360000000103300039000000000023004b000011160000413d000010860000013d000000000b060019000011230000013d000f00160000002d0000008001000039000b00170010002d0000000b0100002900000000010104330000000f03000029000000a002300039000000000012043500000000013b0049000006ec0010009c000006ec010080410000006001100210000006ec0030009c000006ec030080410000004002300210000000000121019f00001bab0001042e0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011380000c13d000007fc0000013d000000400200043d0000000006520019000000000005004b000008d30000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000011430000c13d000008d30000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000114f0000c13d000007fc0000013d000000400200043d0000000006420019000000000004004b0000115e0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b0000115a0000c13d000000000003004b0000116b0000613d000000000141034f0000000303300210000000000406043300000000043401cf000000000434022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000141019f000000000016043500000060015002100000080a0000013d00000064012000390000076003000041000000000031043500000044012000390000076103000041000000000031043500000024012000390000003203000039000000000031043500000762010000410000000000120435000000040120003900000020030000390000000000310435000006ec0020009c000006ec02008041000000400120021000000763011001c700001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011870000c13d000007fc0000013d000000400600043d0000000007860019000000000008004b000011950000613d0000000008060019000000001901043c0000000008980436000000000078004b000011910000c13d000000000005004b000011a00000613d000000000107043300000000012101cf000000000121022f000000000404043b0000010002200089000000000424022f00000000022401cf000000000112019f00000000001704350000006001300210000006ec0060009c000006ec060080410000004002600210000000000112019f00001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011ad0000c13d000007fc0000013d00000765040000410000000c050000290000000000450435000000200400003900000000004304350000000d03000039000000000032043500000766020000410000000000210435000006ec0050009c000006ec01000041000000000105401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000737011001c700000010020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c05700029000011d60000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b000011d20000c13d000000000006004b000011e30000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000120d0000613d0000001f01400039000000600110018f0000000c01100029000900000001001d0000072f0010009c0000096e0000213d0000000901000029000000400010043f000000200030008c000000510000413d0000000c010000290000000004010433000000000004004b0000000001000039000000010100c039000000000014004b000000510000c13d0000000903000029000000440130003900000024023000390000000403300039000000000004004b000012190000c13d000007620400004100000009050000290000000000450435000000200400003900000000004304350000002203000039000000000032043500000781020000410000000000210435000000640150003900000782020000410000000000210435000006ec0050009c000006ec05008041000000400150021000000763011001c700001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012140000c13d000007fc0000013d000007430400004100000009050000290000000000450435000000200400003900000000004304350000000b03000039000000000032043500000742020000410000000000210435000006ec0050009c000006ec01000041000000000105401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000737011001c700000010020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000009057000290000123d0000613d000000000801034f0000000909000029000000008a08043c0000000009a90436000000000059004b000012390000c13d000000000006004b0000124a0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000125f0000613d0000001f01400039000000600110018f00000009011000290000072f0010009c0000096e0000213d000000400010043f000000200030008c000000510000413d00000009010000290000000002010433000c00000002001d000007890020009c0000126b0000c13d0000075201000041000000000010043f0000001101000039000000040010043f000006fe0100004100001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012660000c13d000007fc0000013d00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d00000064013000390000074202000041000000000021043500000044013000390000000b020000390000000000210435000007670100004100000000001304350000000401300039000000400200003900000000002104350000000c0100002900000001021000390000002401300039000c00000002001d0000000000210435000006ec0030009c000900000003001d000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000763011001c700000010020000291baa1ba00000040f0000000100200190000013dc0000613d00000009010000290000072f0010009c0000096e0000213d0000000901000029000000400010043f00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d00000064013000390000074402000041000000000021043500000044013000390000000a0200003900000000002104350000076701000041000000000013043500000004013000390000004002000039000000000021043500000024013000390000000c020000290000000000210435000006ec0030009c000900000003001d000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000763011001c700000010020000291baa1ba00000040f0000000100200190000013e90000613d00000009010000290000072f0010009c0000096e0000213d0000000901000029000000400010043f0000000601000029000000000010043f0000000201000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d000000000101043b0000000f02000029000006ec02200197000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f0000000100200190000000510000613d0000000c02000029000806ec0020019b000000000101043b000000000201041a000007680220019700000008022001af000000000021041b000000400200043d000007470020009c0000096e0000213d0000004001200039000000400010043f0000002001200039000007690300004100000000003104350000000f0300003900000000003204350000073e03000041000000400500043d0000000000350435000000040350003900000020040000390000000000430435000000000302043300000024025000390000000000320435000c00000005001d0000004402500039000f00000003001d000000000003004b000013150000613d0000000003000019000000000423001900000000051300190000000005050433000000000054043500000020033000390000000f0030006c0000130e0000413d0000000f012000290000000000010435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d0000000f020000290000001f0220003900000788022001970000004402200039000006ec0020009c000006ec0200804100000060022002100000000c03000029000006ec0030009c000006ec030080410000004003300210000000000232019f000000000301043b0000000001000414000006ec0010009c000006ec01008041000000c001100210000000000121019f000006ef023001971baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c05700029000013480000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b000013440000c13d000000000006004b000013550000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000013f60000613d0000001f01400039000000600210018f0000000c01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200030008c000000510000413d0000000c020000290000000002020433000006ef0020009c000000510000213d0000000003000410000000000032004b000014020000c13d0000000602000029000000800020043f0000000e010000290000000000210435000000400300043d00000044013000390000076c02000041000000000021043500000024013000390000000e0200003900000000002104350000073e010000410000000000130435000c00000003001d000000040130003900000020020000390000000000210435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d000000000201043b0000000c01000029000006ec0010009c000006ec0100804100000040011002100000000003000414000006ec0030009c000006ec03008041000000c003300210000000000113019f00000737011001c7000006ef022001971baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c05700029000013a60000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b000013a20000c13d000000000006004b000013b30000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000140b0000613d0000001f01400039000000600110018f0000000c02100029000000000012004b00000000010000390000000101004039000f00000002001d0000072f0020009c0000096e0000213d00000001001001900000096e0000c13d0000000f01000029000000400010043f000000200030008c000000510000413d0000000c010000290000000001010433000c00000001001d000006ef0010009c000000510000213d0000000c0000006b0000000f01000029000900040010003d000014170000c13d0000000f0300002900000064013000390000077f02000041000000000021043500000044013000390000078002000041000000000021043500000024013000390000002c0200003900000000002104350000076201000041000000000013043500000020010000390000000902000029000016750000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000013e40000c13d0000087b0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000013f10000c13d0000087b0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000013fd0000c13d000007fc0000013d00000064021000390000076a03000041000000000032043500000044021000390000076b03000041000000000032043500000024021000390000002c030000390000075f0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000014120000c13d000007fc0000013d0000076d010000410000000f020000290000000000120435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000006ef01100197000000090200002900000000001204350000000f01000029000006ec0010009c000006ec0100804100000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f000006fe011001c70000000c020000291baa1ba00000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f05700029000014470000613d000000000801034f0000000f09000029000000008a08043c0000000009a90436000000000059004b000014430000c13d000000000006004b000014540000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000167b0000613d0000001f01400039000000600110018f0000000f011000290000072f0010009c0000096e0000213d000000400010043f000000200030008c000000510000413d0000000f010000290000000001010433000900000001001d000006ef0010009c000000510000213d00000735010000410000000000100443000000090100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400500043d0000076e010000410000000001150436000c00000001001d0000000401500039000000400200003900000000002104350000000e010000290000000001010433000000440250003900000000001204350000000d010000290000000001010433000000640250003900000000001204350000000b010000290000000001010433000000840250003900000140030000390000000000320435000001840450003900000000320104340000000000240435000e00000005001d000001a401500039000000000002004b000014960000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b0000148f0000413d000000000312001900000000000304350000001f0220003900000788022001970000000a0300002900000000030304330000000e04000029000000a40440003900000160052000390000000000540435000000000112001900000000320304340000000001210436000000000002004b000014ad0000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b000014a60000413d000000000312001900000000000304350000001f02200039000007880220019700000000011200190000000e040000290000000002410049000000440220008a00000007030000290000000003030433000000c404400039000000000024043500000000320304340000000001210436000000000002004b000014c50000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b000014be0000413d000000000312001900000000000304350000001f02200039000007880220019700000000011200190000000e040000290000000002410049000000440220008a00000001030000290000000003030433000000e404400039000000000024043500000000320304340000000001210436000000000002004b000014dd0000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b000014d60000413d0000000003120019000000000003043500000005030000290000000003030433000000000003004b0000000003000039000000010300c0390000000e06000029000001040460003900000000003404350000000403000029000000000303043300000124046000390000000000340435000000030300002900000000030304330000014404600039000000000034043500000002030000290000000003030433000000240460003900000000050004110000000000540435000000000003004b0000000003000039000000010300c039000001640460003900000000003404350000001f02200039000007880220019700000000016100490000000001210019000006ec0010009c000006ec010080410000006001100210000006ec0060009c000006ec0200004100000000020640190000004002200210000000000121019f0000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000009020000291baa1ba00000040f0000000100200190000016870000613d0000000e010000290000072f0010009c0000096e0000213d0000000e01000029000000400010043f0000000802000029000007700020009c0000076f0220212a00000000010000390000000801002039000027100020008c000d00000002001d000700000001001d000015210000413d000000070100002900000004011001bf0000000d02000029000006ec02200197000027100220011a000000640020008c0000000201108039000006ec02208197000000640220811a000000090020008c000000010110203900000788021001970000005f0320003900000788033001970000000e033000290000072f0030009c0000096e0000213d000000400030043f00000001031000390000000e040000290000000000340435000000200220003900000788032001980000001f0220018f0000153d0000613d0000000c05000029000000000335001900000000040000310000000104400367000000004604043c0000000005650436000000000035004b000015390000c13d000000000002004b0000000702000029000b0004002001c30000000e0110002900000021011000390000000802000029000000090020008c0000000a3220011a0000000303300210000000010110008a00000000040104330000074804400197000007490330021f0000074a03300197000000000343019f0000000000310435000015430000213d000000400300043d00000020023000390000074b01000041000f00000002001d0000000000120435000a00000003001d00000026023000390000000e010000290000000001010433000000000001004b000015610000613d000000000300001900000000042300190000000c05300029000000000505043300000000005404350000002003300039000000000013004b0000155a0000413d0000000002210019000000000002043500000006021000390000000a030000290000000000230435000000450110003900000788011001970000000002310019000000000012004b00000000010000390000000101004039000e00000002001d0000072f0020009c0000096e0000213d00000001001001900000096e0000c13d0000000e03000029000000400030043f0000073e0100004100000000001304350000000401300039000000200200003900000000002104350000000a010000290000000001010433000000240230003900000000001204350000004402300039000000000001004b000015870000613d000000000300001900000000042300190000000f05300029000000000505043300000000005404350000002003300039000000000013004b000015800000413d0000001f031000390000078803300197000000000121001900000000000104350000004401300039000006ec0010009c000006ec0100804100000060011002100000000e02000029000006ec0020009c000006ec020080410000004002200210000000000121019f0000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000010020000291baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000e05700029000015aa0000613d000000000801034f0000000e09000029000000008a08043c0000000009a90436000000000059004b000015a60000c13d000000000006004b000015b70000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000016940000613d0000001f01400039000000600210018f0000000e01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200030008c000000510000413d0000000e020000290000000002020433000006ef0020009c000000510000213d000000000002004b000016a00000c13d00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d0000077301000041000000000013043500000004023000390000004001000039000c00000002001d00000000001204350000006402300039000e00000003001d00000044033000390000000a010000290000000001010433000a00000003001d0000000000130435000000000001004b000015f40000613d000000000300001900000000042300190000000f05300029000000000505043300000000005404350000002003300039000000000013004b000015ed0000413d000000000221001900000000000204350000000e0300002900000024043000390000000902000029000600000004001d00000000002404350000001f0110003900000788011001970000006401100039000006ec0010009c000006ec0100804100000060011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f000006ec0030009c000006ec020000410000000002034019000f0040002002180000000f011001af00000010020000291baa1ba00000040f0000000100200190000016a90000613d0000000e010000290000072f0010009c0000096e0000213d0000000e02000029000000400020043f0000073e01000041000000000012043500000020010000390000000c0200002900000000001204350000000d010000390000000602000029000000000012043500000774010000410000000a020000290000000000120435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d000000000201043b0000000001000414000006ec0010009c000006ec01008041000000c0011002100000000f011001af00000737011001c7000006ef022001971baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000e05700029000016450000613d000000000801034f0000000e09000029000000008a08043c0000000009a90436000000000059004b000016410000c13d000000000006004b000016520000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000016b60000613d0000001f01400039000000600110018f0000000e01100029000f00000001001d0000072f0010009c0000096e0000213d0000000f01000029000000400010043f000000200030008c000000510000413d0000000e010000290000000001010433000e00000001001d000006ef0010009c000000510000213d0000000e0000006b0000000f01000029000c00040010003d000016c20000c13d0000000f0300002900000064013000390000077d02000041000000000021043500000044013000390000077e02000041000000000021043500000024013000390000002b0200003900000000002104350000076201000041000000000013043500000020010000390000000c020000290000000000120435000006ec0030009c000006ec03008041000000400130021000000763011001c700001bac000104300000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000016820000c13d000007fc0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b0000168f0000c13d0000087b0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000169b0000c13d000007fc0000013d000000640210003900000771030000410000000000320435000000440210003900000772030000410000000000320435000000240210003900000032030000390000075f0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000016b10000c13d0000087b0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000016bd0000c13d000007fc0000013d0000000901000029000000a00010043f0000076d010000410000000f020000290000000000120435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000006ef011001970000000c0200002900000000001204350000000f01000029000006ec0010009c000006ec0100804100000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f000006fe011001c70000000e020000291baa1ba00000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f05700029000016f40000613d000000000801034f0000000f09000029000000008a08043c0000000009a90436000000000059004b000016f00000c13d000000000006004b000017010000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000018540000613d0000001f01400039000000600110018f0000000f011000290000072f0010009c0000096e0000213d000000400010043f000000200030008c000000510000413d0000000f010000290000000001010433000a00000001001d000006ef0010009c000000510000213d000007350100004100000000001004430000000a0100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d000f00000003001d00000775010000410000000000130435000000040130003900000040020000390000000000210435000000440230003900000080010000391baa19b80000040f0000000f040000290000002402400039000000000300041100000000003204350000000001410049000006ec0010009c000006ec0100804100000060011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f000006ec0040009c000006ec020000410000000002044019000e0040002002180000000e011001af0000000a020000291baa1ba00000040f0000000100200190000018600000613d0000000f010000290000072f0010009c0000096e0000213d0000000f02000029000000400020043f000007760100004100000000001204350000000001000414000006ec0010009c000006ec01008041000000c0011002100000000e011001af00000731011001c700000009020000291baa1ba00000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f057000290000175e0000613d000000000801034f0000000f09000029000000008a08043c0000000009a90436000000000059004b0000175a0000c13d000000000006004b0000176b0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000186d0000613d0000001f01400039000000600110018f0000000f011000290000072f0010009c0000096e0000213d000000400010043f000000200030008c000000510000413d0000000f010000290000000001010433000f00000001001d00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d00000024013000390000000a02000029000000000021043500000777010000410000000001130436000e00000001001d00000004013000390000000f020000290000000000210435000006ec0030009c000f00000003001d000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000733011001c700000010020000291baa1ba00000040f0000000100200190000018790000613d0000000f010000290000072f0010009c0000096e0000213d0000000f01000029000000400010043f0000000301000039000000000101041a000000ff00100190000018860000c13d0000000f01000029000007470010009c0000096e0000213d0000000f040000290000004001400039000000400010043f00000778010000410000000e0200002900000000001204350000000c0100003900000000001404350000073e01000041000000400300043d0000000000130435000000040130003900000020020000390000000000210435000000000204043300000024013000390000000000210435000c00000003001d0000004401300039000f00000002001d000000000002004b000017cb0000613d000000000200001900000000031200190000000e042000290000000004040433000000000043043500000020022000390000000f0020006c000017c40000413d0000000f011000290000000000010435000007340100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000073f011001c700008005020000391baa1ba50000040f0000000100200190000019980000613d0000000f020000290000001f0220003900000788022001970000004402200039000006ec0020009c000006ec0200804100000060022002100000000c03000029000006ec0030009c000006ec030080410000004003300210000000000232019f000000000301043b0000000001000414000006ec0010009c000006ec01008041000000c001100210000000000121019f000006ef023001971baa1ba50000040f0000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c05700029000017fe0000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b000017fa0000c13d000000000006004b0000180b0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000018ba0000613d0000001f01400039000000600210018f0000000c01200029000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f000000200030008c000000510000413d0000000c010000290000000001010433000e00000001001d000006ef0010009c000000510000213d000007350100004100000000001004430000000e0100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d00000024013000390000000102000039000000000021043500000779010000410000000000130435000000040130003900000009020000290000000000210435000006ec0030009c000f00000003001d000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000733011001c70000000e020000291baa1ba00000040f0000000100200190000018ae0000c13d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b0000184f0000c13d0000087b0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000185b0000c13d000007fc0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000018680000c13d0000087b0000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000018740000c13d000007fc0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000018810000c13d0000087b0000013d00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d0000002401300039000000090200002900000000002104350000077701000041000000000013043500000004013000390000073c020000410000000000210435000006ec0030009c000f00000003001d000006ec01000041000000000103401900000040011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f00000733011001c700000010020000291baa1ba00000040f0000000100200190000018c60000613d0000000f010000290000072f0010009c0000096e0000213d0000000f01000029000000400010043f0000000d01000029000027100010008c000018d30000413d0000000d01000029000006ec01100197000d271000100122000018d40000013d0000001f0530018f000006ee06300198000000400200043d0000000004620019000007fc0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000018c10000c13d000007fc0000013d00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000018ce0000c13d0000087b0000013d000b00070000002d0000000d01000029000000640010008c000018dc0000413d0000000b01000029000b00020010003d0000000d01000029000006ec01100197000d0064001001220000000d01000029000000090010008c0000000b020000290000000102202039000000000702001900000788022001970000005f0120003900000788031001970000000f01300029000000000031004b000000000300003900000001030040390000072f0010009c0000096e0000213d00000001003001900000096e0000c13d000000400010043f00000001017000390000000f030000290000000001130436000000200220003900000788032001980000001f0220018f000018fc0000613d0000000003310019000000000400003100000001044003670000000005010019000000004604043c0000000005650436000000000035004b000018f80000c13d000000000002004b0000000f0270002900000021022000390000000803000029000000090030008c0000000a4330011a0000000304400210000000010220008a00000000050204330000074805500197000007490440021f0000074a04400197000000000454019f0000000000420435000019000000213d000000400400043d00000020034000390000075102000041000e00000003001d0000000000230435000d00000004001d00000025034000390000000f020000290000000002020433000000000002004b0000191e0000613d000000000400001900000000053400190000000006140019000000000606043300000000006504350000002004400039000000000024004b000019170000413d0000000001320019000000000001043500000005012000390000000d030000290000000000130435000000440120003900000788021001970000000001320019000000000021004b000000000200003900000001020040390000072f0010009c0000096e0000213d00000001002001900000096e0000c13d000000400010043f00000735010000410000000000100443000000100100002900000004001004430000000001000414000006ec0010009c000006ec01008041000000c0011002100000072d011001c700008002020000391baa1ba50000040f0000000100200190000019980000613d000000000101043b000000000001004b000000510000613d000000400300043d000007730100004100000000001304350000000401300039000000400200003900000000002104350000000d01000029000000000101043300000044023000390000000000120435000f00000003001d0000006402300039000000000001004b000019540000613d000000000300001900000000042300190000000e05300029000000000505043300000000005404350000002003300039000000000013004b0000194d0000413d000000000221001900000000000204350000000f0400002900000024024000390000000a0300002900000000003204350000001f0110003900000788011001970000006401100039000006ec0010009c000006ec0100804100000060011002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f000006ec0040009c000006ec020000410000000002044019000e0040002002180000000e011001af00000010020000291baa1ba00000040f0000000100200190000019990000613d0000000f010000290000072f0010009c0000096e0000213d0000000f01000029000000400010043f000006ec020000410000001b0220017f001000000002001d00000000002104350000000001000414000006ec0010009c000006ec01008041000000c0011002100000000e011001af0000077a011001c70000800d0200003900000001030000390000077b040000411baa1ba00000040f0000000100200190000000510000613d000006ec010000410000001a0110017f000000400200043d0000002003200039000000000013043500000008010000290000000000120435000006ec0020009c000006ec0200804100000040012002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f000006f6011001c70000800d0200003900000002030000390000077c040000410000001005000029000000890000013d000000000001042f00000060061002700000001f0460018f000006ee05600198000000400200043d00000000035200190000087b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000019a10000c13d0000087b0000013d00000000430104340000000001320436000000000003004b000019b20000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b000019ab0000413d000000000213001900000000000204350000001f0230003900000788022001970000000001210019000000000001042d000000004301043400000000033204360000000004040433000006ef044001970000000000430435000000400310003900000000040304330000004003200039000002600500003900000000005304350000026003200039000000000504043300000000005304350000028003200039000000000005004b000019d00000613d000000000600001900000020044000390000000007040433000006ef0770019700000000037304360000000106600039000000000056004b000019c90000413d0000006004100039000000000404043300000000052300490000006006200039000000000056043500000000050404330000000003530436000000000005004b000019e10000613d0000000006000019000000200440003900000000070404330000ffff0770018f00000000037304360000000106600039000000000056004b000019da0000413d0000008004100039000000000404043300000080052000390000000000450435000000a0041000390000000004040433000000a0052000390000000000450435000000c0041000390000000004040433000000c0052000390000000000450435000000e0041000390000000004040433000000e005200039000000000045043500000100041000390000000004040433000001000520003900000000004504350000012004100039000000000404043300000120052000390000000000450435000001400410003900000000040404330000014005200039000000000045043500000160041000390000000004040433000001600520003900000000004504350000018004100039000000000404043300000180052000390000000000450435000001a0041000390000000004040433000001a0052000390000000000450435000001c0041000390000000004040433000006ef04400197000001c0052000390000000000450435000001e0041000390000000004040433000001e005200039000000000045043500000200041000390000000004040433000000000004004b0000000004000039000000010400c0390000020005200039000000000045043500000220041000390000000004040433000000000004004b0000000004000039000000010400c03900000220052000390000000000450435000002400220003900000240011000390000000001010433000006ef0110019700000000001204350000000001030019000000000001042d000000400100043d0000078a0010009c00001a320000813d0000004002100039000000400020043f0000002002100039000007780300004100000000003204350000000c020000390000000000210435000000000001042d0000075201000041000000000010043f0000004101000039000000040010043f000006fe0100004100001bac00010430000000400100043d0000078a0010009c00001a430000813d0000004002100039000000400020043f00000020021000390000073d0300004100000000003204350000000e020000390000000000210435000000000001042d0000075201000041000000000010043f0000004101000039000000040010043f000006fe0100004100001bac00010430000000400100043d0000078a0010009c00001a540000813d0000004002100039000000400020043f0000002002100039000007690300004100000000003204350000000f020000390000000000210435000000000001042d0000075201000041000000000010043f0000004101000039000000040010043f000006fe0100004100001bac000104300003000000000002000300000002001d000006ec01100197000200000001001d000000000010043f0000000201000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001ac90000613d000000000101043b0000000302000029000006ec02200197000300000002001d000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001ac90000613d000000000101043b000000000101041a000006ec0110019800001ac60000c13d0000000301000039000000000101041a0000000801100270000006ef0210019800001ac70000613d000000400400043d000100000004001d0000002401400039000000030300002900000000003104350000078b010000410000000000140435000000040140003900000002030000290000000000310435000006ec0040009c000006ec01000041000000000104401900000040011002100000000003000414000006ec0030009c000006ec03008041000000c003300210000000000113019f00000733011001c71baa1ba50000040f000000010b0000290000006003100270000006ec03300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900001aa70000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00001aa30000c13d000000000006004b00001ab40000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000001acb0000613d0000001f01400039000000600210018f0000000001b20019000000000021004b000000000200003900000001020040390000072f0010009c00001ae90000213d000000010020019000001ae90000c13d000000400010043f000000200030008c00001ac90000413d00000000010b0433000006ec0010009c00001ac90000213d000000000001042d0000000001000019000000000001042d000000000100001900001bac000104300000001f0530018f000006ee06300198000000400200043d000000000462001900001ad60000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001ad20000c13d000000000005004b00001ae30000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000006ec0020009c000006ec020080410000004002200210000000000112019f00001bac000104300000075201000041000000000010043f0000004101000039000000040010043f000006fe0100004100001bac000104300001000000000002000100000001001d000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b0f0000613d000000000101043b0000000002000411000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b0f0000613d000000000101043b000000000101041a000000ff0010019000001b110000613d000000000001042d000000000100001900001bac00010430000000400100043d00000024021000390000000103000029000000000032043500000756020000410000000000210435000000040210003900000000030004110000000000320435000006ec0010009c000006ec01008041000000400110021000000733011001c700001bac000104300002000000000002000100000002001d000200000001001d000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b6e0000613d000000000101043b0000000102000029000006ef02200197000100000002001d000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b6e0000613d000000000101043b000000000101041a000000ff0010019000001b6d0000613d0000000201000029000000000010043f0000000101000039000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b6e0000613d000000000101043b0000000102000029000000000020043f000000200010043f0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b6e0000613d000000000101043b000000000201041a0000078702200197000000000021041b0000000001000414000006ec0010009c000006ec01008041000000c001100210000006f1011001c70000800d02000039000000040300003900000000070004110000078c04000041000000020500002900000001060000291baa1ba00000040f000000010020019000001b6e0000613d000000000001042d000000000100001900001bac00010430000000000001042f0000000002000414000006ec0020009c000006ec02008041000000c002200210000006ec0010009c000006ec010080410000004001100210000000000121019f000006f6011001c700008010020000391baa1ba50000040f000000010020019000001b800000613d000000000101043b000000000001042d000000000100001900001bac0001043000000000050100190000000000200443000000050030008c00001b900000413d000000040100003900000000020000190000000506200210000000000664001900000005066002700000000006060031000000000161043a0000000102200039000000000031004b00001b880000413d000006ec0030009c000006ec0300804100000060013002100000000002000414000006ec0020009c000006ec02008041000000c002200210000000000112019f0000078d011001c700000000020500191baa1ba50000040f000000010020019000001b9f0000613d000000000101043b000000000001042d000000000001042f00001ba3002104210000000102000039000000000001042d0000000002000019000000000001042d00001ba8002104230000000102000039000000000001042d0000000002000019000000000001042d00001baa0000043200001bab0001042e00001bac0001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b0200000200000000000000000000000000000004000000000000000000000000a6eef7e35abe7026729641147f7915573c7e97b47efa546f5f6e3230263bcb4902000000000000000000000000000000000000400000000000000000000000002f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d3af7f0310bda25ebf6a91358c0e506d5381a9b7c2a77a2c36d9ac18cbec0b51ecc3e15b6937a2f69a6f5452031b5fbab5ab7de91ec2efae0db33241e870e61210000000000000000000000ffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffff0000000000000000000000000000000000000000ff00000002000000000000000000000000000000c00000010000000000000000001e4fbdf70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000000000000000000000000000000000000000000000000000000000000080cefab600000000000000000000000000000000000000000000000000000000b346a4d300000000000000000000000000000000000000000000000000000000d5b014c200000000000000000000000000000000000000000000000000000000ee198b9600000000000000000000000000000000000000000000000000000000ee198b9700000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000d5b014c300000000000000000000000000000000000000000000000000000000dab59e4400000000000000000000000000000000000000000000000000000000cfd3adbc00000000000000000000000000000000000000000000000000000000cfd3adbd00000000000000000000000000000000000000000000000000000000d547741f00000000000000000000000000000000000000000000000000000000b346a4d400000000000000000000000000000000000000000000000000000000cd84980e0000000000000000000000000000000000000000000000000000000091d1485300000000000000000000000000000000000000000000000000000000a5b3abfa00000000000000000000000000000000000000000000000000000000a5b3abfb00000000000000000000000000000000000000000000000000000000acc8e13f0000000000000000000000000000000000000000000000000000000091d1485400000000000000000000000000000000000000000000000000000000a217fddf0000000000000000000000000000000000000000000000000000000080cefab7000000000000000000000000000000000000000000000000000000008da5cb5b000000000000000000000000000000000000000000000000000000008fc59014000000000000000000000000000000000000000000000000000000004282b1d40000000000000000000000000000000000000000000000000000000054fd4d4f000000000000000000000000000000000000000000000000000000007671114c000000000000000000000000000000000000000000000000000000007671114d0000000000000000000000000000000000000000000000000000000078311f8a0000000000000000000000000000000000000000000000000000000054fd4d5000000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000004282b1d5000000000000000000000000000000000000000000000000000000004cf292580000000000000000000000000000000000000000000000000000000052aeec220000000000000000000000000000000000000000000000000000000017fd1e2e000000000000000000000000000000000000000000000000000000002f2ff15c000000000000000000000000000000000000000000000000000000002f2ff15d0000000000000000000000000000000000000000000000000000000036568abe0000000000000000000000000000000000000000000000000000000017fd1e2f00000000000000000000000000000000000000000000000000000000248a9ca30000000000000000000000000000000000000000000000000000000000b7a1810000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000002033e62118cdaa7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000024000000800000000000000000000000000000000000000000000000000000002000000080000000000000000000000000000000000000000000000000000000200000000000000000000000009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f39020000020000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe0000000000000000000000000000000000000000000000000ffffffffffffffffd6bda275000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000cf479181000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b8323b872dd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064000000000000000000000000fb3231be112a9810d87b6e307a1f4ba88b91ae1ffb1f669ad6f3832974c930bc5353505f464143544f52595f484f4f4b000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000000000000078a52f09b55ee8fa278d4d711a66e8ddff0365a4333380c8c6dbcdf8c74675b71e0e7659434f4d4d554e4954595f4c49535400000000000000000000000000000000000074b9982c0000000000000000000000000000000000000000000000000000000002000002000000000000000000000000000000440000000000000000000000000000000000000000000000000000000000000064000001600000000000000000d0f4a53700000000000000000000000000000000000000000000000000000000544f4b454e5f434f554e54000000000000000000000000000000000000000000a23220d10000000000000000000000000000000000000000000000000000000053414c455f434f554e54000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0000000000000000000000000000000000000000000000000fffffffffffffd9f000000000000000000000000000000000000000000000000ffffffffffffffbf00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff30313233343536373839616263646566000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000544f4b454e5f00000000000000000000000000000000000000000000000000002f151b76000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff3f000000000000000000000000000000000000000000000000fffffffffffffcdf53414c455f0000000000000000000000000000000000000000000000000000004e487b7100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff5f6697b232000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000800000000000000000e2517d3f00000000000000000000000000000000000000000000000000000000a9059cbb0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000440000008000000000000000006f8e937e504f31740fcd909af11a6f08748ab8f2ab78d652b8dbdd08b34c6ad700000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff01ffc9a7000000000000000000000000000000000000000000000000000000007965db0b000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000fffffffffffffd1f000000000000000000000000000000000000000000000000fffffffffffffebf65616479206265656e206c61756e63686564000000000000000000000000000050726f6a656374466163746f7279203a2070726f6a6563742068617320616c7208c379a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000840000000000000000000000002125ba0200000000000000000000000000000000000000000000000000000000257973e40000000000000000000000000000000000000000000000000000000049535f484f4d455f434841494e00000000000000000000000000000000000000f74bc1a700000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000050524f4a4543545f464143544f5259000000000000000000000000000000000065637420666163746f72792e000000000000000000000000000000000000000050726f6a656374466163746f72793a204e6f742063757272656e742070726f6a544f4b454e5f4c41554e434845520000000000000000000000000000000000008124b78e00000000000000000000000000000000000000000000000000000000a4b744e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005f5e1000000000000000000000000000000000000000000000000000000000005f5e0ff737320616c72656164792065786973747321000000000000000000000000000050726f6a656374466163746f72793a20544f4b454e5f7b49447d2061646472653a8debb00000000000000000000000000000000000000000000000000000000053414c455f4c41554e43484552000000000000000000000000000000000000009aecc8ed0000000000000000000000000000000000000000000000000000000066d47d84000000000000000000000000000000000000000000000000000000002f2ff15d0000000000000000000000000000000000000000000000000000000052414e444f4d56325f53535000000000000000000000000000000000000000000b44a218000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000020000000000000000000000000d78a25afe0b6160e2dc1fc71b2845c76cc268398d17be04665b78ba59b474407907b3af8b7ab876f0d8f8755c36a3803606a84fab1a2f2c77779b270347c49be6e6f7420646566696e656400000000000000000000000000000000000000000050726f6a65637420466163746f7279203a2053414c455f4c41554e4348455220206e6f7420646566696e6564000000000000000000000000000000000000000050726f6a65637420466163746f7279203a20544f4b454e5f4c41554e4348455250726f6a656374466163746f7279203a206e6f74206f6e20686f6d6520636861696e00000000000000000000000000000000000000000000000000000000000050726f6a656374466163746f72793a20436f6d6d756e697479206e6f74206f776e65642062792073656e64657200000000000000000000000000000000000000792049440000000000000000000000000000000000000000000000000000000050726f6a656374466163746f72793a20496e76616c696420636f6d6d756e6974ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffc0acc8e13f00000000000000000000000000000000000000000000000000000000f6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b020000020000000000000000000000000000000000000000000000000000000031dba66f8c3d42046d81c58a4cac4e97916d26bfc252c1e7acf4a8f188147b8a

0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f8274c5e5149a6e0fc5190483323a1b399896a8a

-----Decoded View---------------
Arg [0] : _oldProjectFactory (address): 0x0000000000000000000000000000000000000000
Arg [1] : _galaxisRegistry (address): 0xF8274c5E5149a6e0FC5190483323a1B399896a8A

-----Encoded View---------------
2 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [1] : 000000000000000000000000f8274c5e5149a6e0fc5190483323a1b399896a8a