@xoxno/types 1.0.368 → 1.0.370

package/dist/cache/cache-keys.js

@@ -0,0 +1,961 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheIndexKeys = exports.CachePatterns = exports.CacheKeys = void 0;
+const ttl_1 = require("./ttl");
+/**
+ * Helper function for serializing ActivityChain arrays in cache keys.
+ */
+function serializeChain(chain) {
+    return (chain ?? []).sort().join(',');
+}
+/**
+ * Cache key generators for commonly used patterns.
+ * These ensure consistent key formats across repositories.
+ */
+exports.CacheKeys = {
+    // ==========================================
+    // User-related cache keys
+    // ==========================================
+    UserProfile: (address) => ({
+        key: `user:${address}:profile`,
+        ttl: ttl_1.TTLS.ONE_DAY * 3,
+    }),
+    UserSettings: (address) => ({
+        key: `user:${address}:settings`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    UserInventorySummary: (address, activeAuction) => ({
+        key: `user:${address}:inventory:summary:${activeAuction}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    UserHerotag: (address) => ({
+        key: `user:${address}:herotag`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    UserFavorite: (address, favoriteId) => ({
+        key: `user:${address}:favorite:${favoriteId}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    UserOffers: (address, offerType) => ({
+        key: `user:${address}:offers:${offerType}`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 2,
+    }),
+    UserPlacedOffersCount: (address, offerType) => ({
+        key: `user:${address}:offers:${offerType}:count`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 2,
+    }),
+    UserFavoriteUserAddresses: (address) => ({
+        key: `user:${address}:favorites:users`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    UserFavoriteCollectionTickers: (address) => ({
+        key: `user:${address}:favorites:collections`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    UserFavoriteNftIdentifiers: (address) => ({
+        key: `user:${address}:favorites:nfts`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    UserTradingSummary: (address) => ({
+        key: `user:${address}:trading:summary`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 15,
+    }),
+    UserOwnedAndListedSummary: (address) => ({
+        key: `user:${address}:owned:listed:summary`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    UserStatistics: (hash) => ({
+        key: `query:user:statistics:${hash}`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    UserSearch: (filter) => ({
+        key: `search:user:${filter}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    UserCount: (chain) => ({
+        key: `user:count${serializeChain(chain)}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    AddressEsdt: (address) => ({
+        key: `user:${address}:esdt`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 6,
+    }),
+    UserXoxnoDropScore: (skip, top, address) => ({
+        key: `user:${address}:xoxno:drop:score:${skip}:${top}`,
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    EmailVerificationCode: (address) => ({
+        key: `user:${address}:email:verification:code`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    // ==========================================
+    // Collection-related cache keys
+    // ==========================================
+    CollectionProfile: (collection) => ({
+        key: `collection:${collection}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    CollectionStats: (collection) => ({
+        key: `collection:${collection}:stats`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 30,
+    }),
+    CollectionFloorPrice: (collection, token) => ({
+        key: `collection:${collection}:floor:${token}`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    CollectionTraitMap: (collection) => ({
+        key: `collection:${collection}:traits:map`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    CollectionRanks: (collection) => ({
+        key: `collection:${collection}:ranks`,
+        ttl: ttl_1.TTLS.ONE_DAY * 2,
+    }),
+    CollectionMintProfile: (collection) => ({
+        key: `collection:${collection}:mint:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    CollectionMintStages: (collection, enabledOnly) => ({
+        key: `collection:${collection}:mint:stages:${enabledOnly}`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    CollectionListedCount: (collection) => ({
+        key: `collection:${collection}:listed:count`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    CollectionListingDistribution: (collection) => ({
+        key: `collection:${collection}:listing:distribution`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    CollectionFloorPriceByAttribute: (collection) => ({
+        key: `collection:${collection}:floor:attributes`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    CollectionHoldersDetailed: (key, realOwners) => ({
+        key: `collection:${key}:holders:detailed:${realOwners}`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    CollectionHoldersCount: (key) => ({
+        key: `collection:${key}:holders:count`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    CollectionHoldersDocCount: (collection) => ({
+        key: `collection:${collection}:holders:doc:count`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 6,
+    }),
+    SftTotalSupplyCount: (collection) => ({
+        key: `collection:${collection}:supply:count`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    CollectionProfileDocs: (hash) => ({
+        key: `query:collection:profile:docs:${hash}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    CollectionStatsDocs: (query) => ({
+        key: `query:collection:stats:${query}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    CollectionOfferDocs: (hash) => ({
+        key: `query:collection:offers:${hash}`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 30,
+    }),
+    CollectionSearch: (filter) => ({
+        key: `search:collection:${filter}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    CollectionTickerByTags: (creatorTag, collectionTag) => ({
+        key: `collection:ticker:${creatorTag}:${collectionTag}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    CollectionListings: (collection) => ({
+        key: `collection:${collection}:listings`,
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    AllBannedCollections: () => ({
+        key: 'collection:banned:all',
+        ttl: ttl_1.TTLS.ONE_DAY * 90,
+    }),
+    AllVerifiedCollections: () => ({
+        key: 'collection:verified:all',
+        ttl: ttl_1.TTLS.ONE_DAY * 90,
+    }),
+    // ==========================================
+    // NFT-related cache keys
+    // ==========================================
+    NftDoc: (identifier) => ({
+        key: `nft:${identifier}:doc`,
+        ttl: ttl_1.TTLS.ONE_DAY * 30,
+    }),
+    NftHasOffer: (identifier) => ({
+        key: `nft:${identifier}:offer:exists`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    NftOffers: (identifier) => {
+        const collection = identifier.split('-').slice(0, 2).join('-');
+        return {
+            key: `collection:${collection}:offers:${identifier}`,
+            ttl: ttl_1.TTLS.ONE_HOUR,
+        };
+    },
+    NftDataDocs: (query) => ({
+        key: `query:nft:data:${query}`,
+        ttl: ttl_1.TTLS.ONE_DAY * 7,
+    }),
+    NftSearch: (filter) => ({
+        key: `search:nft:${filter}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    NftMetadataUrl: (url) => ({
+        key: `nft:metadata:url:${url}`,
+        ttl: ttl_1.TTLS.ONE_DAY * 30,
+    }),
+    NftMetadata: (identifier) => ({
+        key: `nft:metadata:${identifier}`,
+        ttl: ttl_1.TTLS.ONE_DAY * 30,
+    }),
+    // ==========================================
+    // Staking-related cache keys
+    // ==========================================
+    StakingPoolDoc: (poolId) => ({
+        key: `staking:${poolId}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    StakingWlNonces: (poolId) => ({
+        key: `staking:${poolId}:whitelist:nonces`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    StakingUserReward: (address, poolId) => ({
+        key: `staking:${poolId}:user:${address}:reward`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 6,
+    }),
+    StakingDataDocs: (query) => ({
+        key: `query:staking:data:${query}`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 30,
+    }),
+    StakingPoolsByCollection: (collections, activePoolsOnly) => {
+        const collectionsKey = collections.sort().join(',');
+        return {
+            key: `staking:pools:collection:${collectionsKey}:active:${activePoolsOnly}`,
+            ttl: ttl_1.TTLS.ONE_HOUR * 2,
+        };
+    },
+    StakingPoolsSummaryByCollection: () => ({
+        key: 'staking:pools:collection:summary',
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    StakingProviderOwner: (provider) => ({
+        key: `staking:${provider}:owner`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    StakingCreatedDelegationContract: (address) => ({
+        key: `staking:contract:${address}:delegation:created`,
+        ttl: ttl_1.TTLS.ONE_DAY * 300,
+    }),
+    StakingProviderUserRewards: (address, currentEpoch) => ({
+        key: `staking:${address}:rewards:${currentEpoch}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    StakingProviderEpochRewards: (provider, epoch) => ({
+        key: `staking:${provider}:epoch:${epoch}:rewards`,
+        ttl: ttl_1.TTLS.ONE_WEEK * 54,
+    }),
+    ClaimableRewards: (address, delegationContract) => ({
+        key: `staking:rewards:${address}:${delegationContract}:claimable`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    AllUserDelegations: (address) => ({
+        key: `staking:user:${address}:delegations:all`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    EgldStakingProviders: (providers, withIdentityInfo = true) => ({
+        key: `staking:${providers.join(',')}:egld:identity:${withIdentityInfo}`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    EgldStakingProvider: (provider) => ({
+        key: `staking:${provider}:egld`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    GetLastUpdatedEpoch: (provider, epoch) => ({
+        key: `staking:${provider}:epoch:${epoch}:last:updated`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    // ==========================================
+    // Lending-related cache keys
+    // ==========================================
+    LendingMarketProfileDoc: (token) => ({
+        key: `lending:${token}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    LendingAccountProfileDoc: (identifier, token) => ({
+        key: `lending:${token}:${identifier}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    LendingTokenEModeProfileDoc: (token, eModeCategory) => ({
+        key: `lending:${token}:emode:${eModeCategory}:profile`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    LendingPoolContracts: (controllerAddress) => ({
+        key: `lending:global:pool:${controllerAddress}:contracts`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    LendingAllActiveAccounts: () => ({
+        key: 'lending:global:accounts:all',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    LendingAccountAttributes: (nonce) => ({
+        key: `lending:account:${nonce}:attributes`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    LendingLiquidateablePositions: () => ({
+        key: 'lending:global:positions:liquidateable',
+        ttl: ttl_1.TTLS.ONE_MINUTE,
+    }),
+    LendingMarketIndexes: (tokens) => ({
+        key: `lending:market:${tokens.join(',')}:indexes`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 5,
+    }),
+    LendingAllMarketsTokens: () => ({
+        key: 'lending:global:market:tokens:all',
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    LendingAccountPosition: (identifier) => ({
+        key: `lending:position:${identifier}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    LendingFaucetClaimed: (address) => ({
+        key: `lending:global:faucet:${address}:claimed`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    LendingBulkOraclePrice: (tokens, returnAsUsd) => ({
+        key: `lending:oracle:${tokens.join(',')}:bulk:${returnAsUsd}`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 30,
+    }),
+    LendingTokenPriceAsUsd: (token) => ({
+        key: `lending:${token}:price:usd`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 30,
+    }),
+    LendingTokenPriceAsEgld: (token) => ({
+        key: `lending:${token}:price:egld`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 30,
+    }),
+    LendingOverallStats: () => ({
+        key: 'lending:global:stats:overall',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    LendingTopMarketParticipants: (token) => ({
+        key: `lending:${token}:participants:top`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    LendingMarketParticipantsCount: (token) => ({
+        key: `lending:${token}:participants:count`,
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    LendingPositionLeaderboard: (hash) => ({
+        key: `query:lending:position:${hash}:leaderboard`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    LendingEModeCategoryProfileDoc: (id) => ({
+        key: `lending:emode:${id}:category:profile`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    LendingMarketStatsGraphData: (startTime, endTime, bin, token) => ({
+        key: `lending:market:${token}:stats:graph:${startTime}:${endTime}:${bin}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 15,
+    }),
+    LendingMarketAverageGraphData: (token) => ({
+        key: `lending:market:${token}:stats`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 4,
+    }),
+    // ==========================================
+    // Event/Ticketing-related cache keys
+    // ==========================================
+    EventProfileDoc: (eventId) => ({
+        key: `event:${eventId}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventStageDoc: (eventId, stageId) => ({
+        key: `event:${eventId}:stage:${stageId}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventTicketProfileDoc: (eventId, ticketId) => ({
+        key: `event:${eventId}:ticket:${ticketId}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventGuestDoc: (eventId, address) => ({
+        key: `event:${eventId}:guest:${address}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventStartsFromPrice: (eventId) => ({
+        key: `event:${eventId}:price:starts:from`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventQuestions: (eventId) => ({
+        key: `event:${eventId}:questions`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventVoucherDoc: (eventId, voucherId) => ({
+        key: `event:${eventId}:voucher:${voucherId}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventUserRoleDoc: (eventId, address) => ({
+        key: `event:${eventId}:user:${address}:role`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventGuestSummary: (eventId) => ({
+        key: `event:${eventId}:guests:summary`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 30,
+    }),
+    EventVoucherDocByCode: (eventId, code) => ({
+        key: `event:${eventId}:voucher:code:${code}`,
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    EventIdBySlug: (slug) => ({
+        key: `event:slug:${slug}:id`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    EventReferralConfigDoc: (eventId, configId) => ({
+        key: `event:${eventId}:referralConfig:${configId}`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    EventReferralDoc: (eventId, referralCode) => ({
+        key: `event:${eventId}:referral:${referralCode}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    // ==========================================
+    // Token-related cache keys
+    // ==========================================
+    TokenDecimals: (token) => ({
+        key: `token:${token}:decimals`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    TokenProperties: (tokenIdentifier) => ({
+        key: `token:${tokenIdentifier}:properties`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    TokenData: (token) => ({
+        key: `token:${token}:data`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    TokenSupply: (token) => ({
+        key: `token:${token}:supply`,
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    TokenSummary: (token) => ({
+        key: `token:${token}:summary`,
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    MvxTokenSummary: (token) => ({
+        key: `token:${token}:summary:mvx`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 15,
+    }),
+    TokenFiatPrice: (fiatCurrencies, token) => ({
+        key: `token:${token}:fiat:price:${fiatCurrencies.join(',')}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    TokenUsdcValue: (token, timestamp) => ({
+        key: `token:${token}:usdc:value:${timestamp}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    LpTokenInfo: (token) => ({
+        key: `token:lp:${token}:info`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 3,
+    }),
+    AllSwapTokens: () => ({
+        key: 'token:swap:all',
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    AllTokensMap: () => ({
+        key: 'token:map:all',
+        ttl: ttl_1.TTLS.ONE_HOUR * 2,
+    }),
+    AshTokenUsdValue: (token) => ({
+        key: `ash:token:${token}:usd:value`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    AshSupportedTokens: () => ({
+        key: 'ash:supported:tokens',
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    TokenAccountsCount: (token) => ({
+        key: `token:${token}:accounts:count`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    TokensByIdentifier: (tokens, returnMap) => ({
+        key: `tokens:by:identifier:${tokens.sort().join(',')}:map:${returnMap}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    TokensByFilterString: (identifier, category, chain) => {
+        const identifierKey = identifier?.length
+            ? identifier.sort().join(',')
+            : 'all';
+        const categoryKey = category?.length ? category.sort().join(',') : 'all';
+        const chainKey = serializeChain(chain);
+        return {
+            key: `tokens:by:filter:${identifierKey}:${categoryKey}:${chainKey}`,
+            ttl: ttl_1.TTLS.ONE_DAY,
+        };
+    },
+    FilteredTokenDocs: (identifier, category, chain) => {
+        const identifierKey = identifier?.length
+            ? identifier.sort().join(',')
+            : 'all';
+        const categoryKey = category?.length ? category.sort().join(',') : 'all';
+        const chainKey = serializeChain(chain);
+        return {
+            key: `token:docs:filtered:${identifierKey}:${categoryKey}:${chainKey}`,
+            ttl: ttl_1.TTLS.ONE_DAY,
+        };
+    },
+    // ==========================================
+    // Launchpad-related cache keys
+    // ==========================================
+    LaunchpadAllRegisteredContracts: () => ({
+        key: 'launchpad:contracts:registered:all',
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    UserCreatorProfile: (address) => ({
+        key: `launchpad:creator:${address}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    UserCreatorProfileByTag: (creatorTag) => ({
+        key: `launchpad:creator:${creatorTag}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    UserCreatorTagRegistered: (tag) => ({
+        key: `launchpad:creator:${tag}:registered`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    GetCreatorProfileByContractAddress: (contractAddress) => ({
+        key: `launchpad:creator:${contractAddress}:profile`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    // ==========================================
+    // Minter-related cache keys
+    // ==========================================
+    MinterLocalOwner: (address) => ({
+        key: `mint:launchpad:${address}:local:owner`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    MinterUserMintsGlobal: (collectionTag, contractAddress, userAddress) => ({
+        key: `mint:${contractAddress}:${collectionTag}:user:${userAddress}:mints:global`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 6,
+    }),
+    MinterUserMintsPerStage: (collectionTag, contractAddress, userAddress, stageName) => ({
+        key: `mint:${contractAddress}:${collectionTag}:user:${userAddress}:stage:${stageName}:mints`,
+        ttl: ttl_1.TTLS.ONE_SECOND * 6,
+    }),
+    MinterMintShareholders: (collectionTag, contractAddress) => ({
+        key: `mint:${contractAddress}:${collectionTag}:shareholders:mint`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    MinterRoyaltiesShareholders: (contractAddress) => ({
+        key: `mint:${contractAddress}:shareholders:royalties`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    MinterIsUserWhitelisted: (collectionTag, contractAddress, userAddress, stageName) => ({
+        key: `mint:${contractAddress}:${collectionTag}:user:${userAddress}:stage:${stageName}:whitelisted`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    // ==========================================
+    // System-related cache keys
+    // ==========================================
+    CurrentEpoch: () => ({
+        key: 'system:epoch:current',
+        ttl: ttl_1.TTLS.ONE_SECOND * 6,
+    }),
+    EpochEndTimestamp: () => ({
+        key: 'system:epoch:end:timestamp',
+        ttl: ttl_1.TTLS.ONE_SECOND * 6,
+    }),
+    ShardCount: () => ({
+        key: 'system:shard:count',
+        ttl: ttl_1.TTLS.ONE_WEEK,
+    }),
+    CurrentTokenValue: () => ({
+        key: 'system:token:value:current',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    NextRelayWalletIndex: (shard) => ({
+        key: `system:relay:wallet:${shard}:index:next`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    AccumulatorCreators: () => ({
+        key: 'system:accumulator:creators',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    LowVolumeCollections: () => ({
+        key: 'system:collections:low:volume',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    // ==========================================
+    // Liquid staking cache keys
+    // ==========================================
+    EGLDLiquidStats: () => ({
+        key: 'liquid:egld:stats:overall',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    XoxnoLiquidStats: () => ({
+        key: 'liquid:xoxno:stats:overall',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 15,
+    }),
+    XoxnoLiquidApy: () => ({
+        key: 'liquid:xoxno:stats:apy',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    ExchangeRateLiquidXOXNO: () => ({
+        key: 'liquid:xoxno:stats:exchange:rate',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    ExchangeRateLiquidXOXNOEGLD: () => ({
+        key: 'liquid:egld:stats:exchange:rate',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    SEgldExchangeRate: () => ({
+        key: 'system:segld:exchange:rate',
+        ttl: ttl_1.TTLS.ONE_HOUR * 12,
+    }),
+    FeesXOXNOEGLD: () => ({
+        key: 'liquid:egld:stats:fees',
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    PendingDelegateXOXNOEGLD: () => ({
+        key: 'liquid:egld:pending:delegate',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    VirtualEGLDReserveXOXNOEGLD: () => ({
+        key: 'liquid:egld:reserve:virtual',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    TotalWithdrawnXOXNOEGLD: () => ({
+        key: 'liquid:egld:total:withdrawn',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    ValidatorsLiquidXOXNOEGLD: () => ({
+        key: 'liquid:egld:providers',
+        ttl: ttl_1.TTLS.ONE_HOUR * 5,
+    }),
+    AprLiquidXOXNOEGLD: () => ({
+        key: 'liquid:egld:stats:apr',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    PendingUnstakeXOXNOEGLD: () => ({
+        key: 'liquid:egld:pending:unstake',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    // ==========================================
+    // Governance cache keys
+    // ==========================================
+    GovernanceVotesProviders: () => ({
+        key: 'governance:providers',
+        ttl: ttl_1.TTLS.ONE_MINUTE,
+    }),
+    GovernanceVotes: () => ({
+        key: 'governance',
+        ttl: ttl_1.TTLS.ONE_MINUTE,
+    }),
+    // ==========================================
+    // Perp/Trading cache keys
+    // ==========================================
+    PerpSpotBalance: (user, coin) => ({
+        key: `perp:spot:${user}:${coin}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    PerpPerpBalance: (user, coin) => ({
+        key: `perp:perp:${user}:${coin}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    PerpOpenOrders: (user) => ({
+        key: `perp:openOrders:${user}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    PerpFilledOrders: (user) => ({
+        key: `perp:filledOrders:${user}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    PerpSpotUsers: () => ({
+        key: 'perp:spot:users',
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    PerpTermsAccepted: (user) => ({
+        key: `perp:legal-check:${user}:terms`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    // ==========================================
+    // Bober-related cache keys
+    // ==========================================
+    GetBoberBattleBiggestWinners: () => ({
+        key: 'bober:battle:biggest:winners',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    GetAllBoberBattleTokens: () => ({
+        key: 'bober:battle:tokens',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    BoberWheelWinners: () => ({
+        key: 'bober:wheel:winners',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    BoberWheelConfig: () => ({
+        key: 'bober:wheel:config',
+        ttl: ttl_1.TTLS.ONE_MINUTE,
+    }),
+    BoberWheelScheduledSpin: () => ({
+        key: 'bober:wheel:scheduled:spin',
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    BoberBattleLeaderboard: (hash) => ({
+        key: `bober:battle:leaderboard:${hash}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    BoberBattleSingleLeaderboard: (hash) => ({
+        key: `bober:battle:single:leaderboard:${hash}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    // ==========================================
+    // Chat-related cache keys
+    // ==========================================
+    AllGroupChatIds: () => ({
+        key: 'chat:groups:all:ids',
+        ttl: ttl_1.TTLS.ONE_MONTH * 6,
+    }),
+    GroupChatProfile: (chatId) => ({
+        key: `chat:${chatId}:profile`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 6,
+    }),
+    ConversationDeleteTimestamp: (chatId, address) => ({
+        key: `chat:${chatId}:user:${address}:delete:timestamp`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    IsSenderBlockedByReceiver: (sender, receiver) => ({
+        key: `chat:block:${sender}:by:${receiver}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    UserLastReadChatMessage: (chatId, address) => ({
+        key: `chat:${chatId}:user:${address}:last:read`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    UserLastSentChatMessage: (chatId, address) => ({
+        key: `chat:${chatId}:user:${address}:last:sent`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    // ==========================================
+    // Web2-related cache keys
+    // ==========================================
+    Web2NativeWalletAddress: (userId) => ({
+        key: `web2:${userId}:native:wallet:address`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    Web2UserDoc: (userId) => ({
+        key: `web2:${userId}:doc`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 3,
+    }),
+    // ==========================================
+    // Location-related cache keys
+    // ==========================================
+    LocationPolygon: (query) => ({
+        key: `location:polygon:${query.toLowerCase().trim()}`,
+        ttl: ttl_1.TTLS.ONE_MONTH * 6,
+    }),
+    GetCountries: () => ({
+        key: 'location:countries:zontix',
+        ttl: ttl_1.TTLS.ONE_DAY * 30,
+    }),
+    // ==========================================
+    // Platform-related cache keys
+    // ==========================================
+    PinnedNftsApiResponse: () => ({
+        key: 'platform:nfts:pinned:response',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    DropsPinnedCollectionsApiResponse: () => ({
+        key: 'drops:pinned:collections:api:response',
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    HomePinnedCollectionsApiResponse: () => ({
+        key: 'home:pinned:collections:api:response',
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    ListingCount: (chain) => ({
+        key: `platform:stats:listing:count${serializeChain(chain)}`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    TradingStatistics: (chain) => ({
+        key: `platform:stats:trading${serializeChain(chain)}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    HatomTokenValues: () => ({
+        key: 'platform:hatom:token:values',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    PendingExternalPayments: () => ({
+        key: 'pending:external:payments',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    TwispayCallbackProcessed: (transactionId) => ({
+        key: `twispay:callback:processed:${transactionId}`,
+        ttl: ttl_1.TTLS.ONE_MONTH,
+    }),
+    // ==========================================
+    // Activity-related cache keys
+    // ==========================================
+    ActivityQuery: (queryHash) => ({
+        key: `activity:query:${queryHash}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    VolumeGraphData: (startTime, endTime, bin, collection, chain) => ({
+        key: `volume:graph:data:${startTime}:${endTime}:${bin}:${collection}:${serializeChain(chain)}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 15,
+    }),
+    // ==========================================
+    // Search-related cache keys
+    // ==========================================
+    GlobalSearch: (filter) => ({
+        key: `search:global:${filter}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    DropsSearch: (filter) => ({
+        key: `search:drops:${filter}`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    // ==========================================
+    // Data API cache keys
+    // ==========================================
+    DataApiTokens: () => ({
+        key: 'data:api:tokens',
+        ttl: ttl_1.TTLS.ONE_MINUTE * 10,
+    }),
+    DataApiTokenPrice: (identifier, dateString, isCurrentDate) => ({
+        key: `data:api:price:${identifier}:${dateString}`,
+        ttl: isCurrentDate ? ttl_1.TTLS.ONE_MINUTE * 5 : ttl_1.TTLS.ONE_WEEK,
+    }),
+    // ==========================================
+    // ABI cache keys
+    // ==========================================
+    GetAbi: (abiName) => ({
+        key: `abi:${abiName}`,
+        ttl: ttl_1.TTLS.ONE_DAY,
+    }),
+    // ==========================================
+    // Sui-related cache keys
+    // ==========================================
+    SuiTransactionSender: (txDigest) => ({
+        key: `platform:sui:transaction:${txDigest}:sender`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    SuiObject: (objectId) => ({
+        key: `platform:sui:object:${objectId}`,
+        ttl: ttl_1.TTLS.ONE_YEAR,
+    }),
+    SuiEvents: (packageId, startTime, endTime, eventTypes) => ({
+        key: `platform:sui:events:${packageId}:${startTime}:${endTime}:${eventTypes.join(',')}`,
+        ttl: ttl_1.TTLS.ONE_HOUR * 6,
+    }),
+    SuiUserCoins: (userAddress) => ({
+        key: `platform:sui:user:${userAddress}:coins`,
+        ttl: ttl_1.TTLS.ONE_MINUTE,
+    }),
+    SuiCollectionInfo: (collectionType) => ({
+        key: `platform:sui:collection:${collectionType}:info`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    SuiAllCollectionTypes: () => ({
+        key: 'platform:sui:collections:types:all',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    SuiTokenPrices: (coinTypes) => ({
+        key: `platform:sui:tokens:${coinTypes.join(',')}:prices`,
+        ttl: ttl_1.TTLS.ONE_MINUTE * 5,
+    }),
+    SuiQueryEventsPage: (moveEventType, order, limit, cursor) => {
+        const cursorKey = cursor
+            ? `${cursor.txDigest}:${cursor.eventSeq}`
+            : 'start';
+        const orderKey = order ?? 'ascending';
+        const limitKey = limit ?? 'default';
+        return {
+            key: `platform:sui:queryEvents:${moveEventType}:${orderKey}:${limitKey}:${cursorKey}`,
+            ttl: ttl_1.TTLS.ONE_MINUTE,
+        };
+    },
+    // ==========================================
+    // Kusto-related cache keys
+    // ==========================================
+    KustoXoxnoLiquidStats: () => ({
+        key: 'kusto:xoxno:liquid:stats',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+    KustoEgldLiquidStats: () => ({
+        key: 'kusto:egld:liquid:stats',
+        ttl: ttl_1.TTLS.ONE_HOUR,
+    }),
+};
+/**
+ * Cache key patterns for invalidation.
+ * Used by az-functions to find and delete related cache entries.
+ *
+ * @deprecated Use CacheIndexKeys with index sets instead of SCAN patterns.
+ * SCAN is expensive in serverless environments and causes connection saturation.
+ */
+exports.CachePatterns = {
+    UserAll: (address) => `user:${address}:*`,
+    CollectionAll: (collection) => `collection:${collection}:*`,
+    NftAll: (identifier) => `nft:${identifier}:*`,
+    StakingPoolAll: (poolId) => `staking:${poolId}:*`,
+    LendingTokenAll: (token) => `lending:${token}:*`,
+    EventAll: (eventId) => `event:${eventId}:*`,
+};
+// ==========================================
+// Index Set Keys (for O(1) cache invalidation)
+// ==========================================
+/**
+ * Index set keys for efficient cache invalidation.
+ *
+ * Instead of using SCAN to find cache keys by pattern (expensive in serverless),
+ * we maintain Redis SETs that track which cache keys belong to which collection/address.
+ *
+ * Usage:
+ * - API: When setting a cache, also SADD the key to relevant index sets
+ * - Azure Functions: When invalidating, use SMEMBERS to get keys from index sets
+ *
+ * This reduces O(n) SCAN operations to O(1) SMEMBERS lookups.
+ */
+exports.CacheIndexKeys = {
+    // ==========================================
+    // NFT Query Index Sets
+    // ==========================================
+    /**
+     * Index of all NFT query cache keys for a specific collection.
+     * When API caches an NFT query result, it adds the cache key to this set.
+     * When invalidating, az-functions reads this set instead of SCAN.
+     */
+    NftQueryByCollection: (collection) => `idx:nft:query:collection:${collection.toLowerCase()}`,
+    /**
+     * Index of all NFT query cache keys for a specific address (owner, seller).
+     */
+    NftQueryByAddress: (address) => `idx:nft:query:address:${address.toLowerCase()}`,
+    /**
+     * Index of all global/wildcard NFT query cache keys (explore pages).
+     * These are queries with no specific collection or address filter.
+     */
+    NftQueryGlobal: 'idx:nft:query:global',
+    // ==========================================
+    // Offer Query Index Sets
+    // ==========================================
+    OfferQueryByCollection: (collection) => `idx:offer:query:collection:${collection.toLowerCase()}`,
+    OfferQueryByAddress: (address) => `idx:offer:query:address:${address.toLowerCase()}`,
+    OfferQueryByIdentifier: (identifier) => `idx:offer:query:identifier:${identifier.toLowerCase()}`,
+    OfferQueryGlobal: 'idx:offer:query:global',
+    // ==========================================
+    // Collection Query Index Sets
+    // ==========================================
+    CollectionQueryByTicker: (ticker) => `idx:collection:query:ticker:${ticker.toLowerCase()}`,
+    CollectionStatsQueryByTicker: (ticker) => `idx:collection:stats:ticker:${ticker.toLowerCase()}`,
+    CollectionOffersQueryByTicker: (ticker) => `idx:collection:offers:ticker:${ticker.toLowerCase()}`,
+    CollectionQueryGlobal: 'idx:collection:query:global',
+    // ==========================================
+    // Activity Query Index Sets
+    // ==========================================
+    ActivityQueryByCollection: (collection) => `idx:activity:query:collection:${collection.toLowerCase()}`,
+    ActivityQueryByAddress: (address) => `idx:activity:query:address:${address.toLowerCase()}`,
+    ActivityQueryGlobal: 'idx:activity:query:global',
+};