@gala-chain/launchpad-mcp-server/dist/prompts/dex-leaderboard.js

MCP server for Gala Launchpad - 102 tools (pool management, event watchers, GSwap DEX trading, price history, token creation, wallet management, DEX pool discovery, liquidity positions, token locks, locked token queries, composite pool data, cross-chain b

"use strict";
/**
 * DEX Leaderboard Prompts
 *
 * Slash commands for discovering DEX leaderboard seasons and player rankings.
 * Provides access to seasonal competitions, rankings, and achievement tracking.
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.dexLeaderboardPrompts = exports.fetchCurrentDexLeaderboardPrompt = exports.fetchDexLeaderboardBySeasonIdPrompt = exports.fetchCurrentDexSeasonPrompt = exports.fetchAllDexSeasonsPrompt = void 0;
const mcpToolNames_js_1 = require("../constants/mcpToolNames.js");
const handlerHelpers_js_1 = require("./utils/handlerHelpers.js");
/**
 * Fetch All DEX Seasons
 *
 * Returns all available leaderboard seasons with dates and rules.
 * Used to explore which seasons have occurred and their date ranges.
 */
exports.fetchAllDexSeasonsPrompt = {
    name: 'galachain-launchpad:fetch-all-dex-seasons',
    description: 'Fetch all DEX leaderboard seasons - explore season dates and rules',
    arguments: [],
    handler: () => {
        return (0, handlerHelpers_js_1.createPromptResponse)(`I want to explore all available DEX leaderboard seasons.

**Purpose:**
Get a comprehensive list of all DEX seasons that have occurred or are planned.

**Data to Retrieve:**
- Season IDs and names
- Start and end dates for each season
- Rules ID for season-specific rules
- Season status (active, upcoming, completed)

**Information Provided:**
- Complete history of DEX competitive seasons
- Date ranges for planning participation
- Season structure and progression

**Use Cases:**
1. **Historical Analysis**: See past seasons and their date ranges
2. **Season Selection**: Choose which season's leaderboard to view
3. **Planning**: Find upcoming seasons and prepare for competition
4. **Archive Research**: Look at completed seasons for trends

**Related Operations:**
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_CURRENT_DEX_SEASON} to get the currently active season
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_DEX_LEADERBOARD_BY_SEASON_ID} to view rankings for a specific season

Please fetch all available DEX leaderboard seasons.`);
    },
};
/**
 * Fetch Current DEX Season
 *
 * Returns the currently active leaderboard season.
 * Automatically determines which season is active based on current date.
 */
exports.fetchCurrentDexSeasonPrompt = {
    name: 'galachain-launchpad:fetch-current-dex-season',
    description: 'Fetch the currently active DEX leaderboard season',
    arguments: [],
    handler: () => {
        return (0, handlerHelpers_js_1.createPromptResponse)(`I want to find the currently active DEX leaderboard season.

**Purpose:**
Get information about which season is currently running on the DEX leaderboard.

**Data to Retrieve:**
- Current season ID and name
- Season start date and end date
- Season rules ID
- Active status confirmation

**Information Provided:**
- Which season is currently active
- When the current season started and ends
- Deadline for leaderboard participation

**Use Cases:**
1. **Current Competition**: Find active season for real-time rankings
2. **Timing Check**: Verify if a season is still active
3. **Deadline Planning**: Know when current season ends
4. **Competition Status**: Confirm if participation is still open

**Edge Cases:**
- Returns null if no season is currently active (off-season period)
- Graceful handling of transition periods between seasons

**Related Operations:**
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_ALL_DEX_SEASONS} to see all seasons including past and future
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_CURRENT_DEX_LEADERBOARD} to get rankings for the current season
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_DEX_LEADERBOARD_BY_SEASON_ID} to view a specific season's rankings

Please fetch the currently active DEX leaderboard season.`);
    },
};
/**
 * Fetch DEX Leaderboard by Season ID
 *
 * Returns the complete leaderboard rankings for a specific season.
 * Includes player ranks, XP metrics, and mastery achievements.
 */
exports.fetchDexLeaderboardBySeasonIdPrompt = {
    name: 'galachain-launchpad:fetch-dex-leaderboard-by-season-id',
    description: 'Fetch DEX leaderboard rankings for a specific season',
    arguments: [
        {
            name: 'seasonId',
            description: 'Season ID to fetch leaderboard for (e.g., 4 for Season 1)',
            required: true,
        },
    ],
    handler: (args) => {
        const seasonId = args.seasonId || 4;
        return (0, handlerHelpers_js_1.createPromptResponse)(`I want to view the DEX leaderboard rankings for season ${seasonId}.

**Purpose:**
Get complete leaderboard rankings with XP metrics and achievements for a specific season.

**Season Information:**
- Season ID: ${seasonId}

**Data to Retrieve:**
- Player rankings and positions
- Total XP earned (combined liquidity + trading XP)
- Liquidity XP contribution
- Trading XP contribution
- Distribution percentage of total XP
- Mastery titles and achievements earned

**Leaderboard Details:**
- Ranked list of all participants
- XP breakdown by activity type (liquidity vs trading)
- Achievement/title tracking
- Top performers and their metrics

**Information Provided:**
- Complete season rankings
- XP earned by each player
- Achievement status (mastery titles)
- Performance metrics for analysis

**Use Cases:**
1. **Rankings Check**: See current rankings for the season
2. **Top Performers**: Identify leading players and their strategies
3. **Progress Comparison**: Compare your rank to others
4. **Achievement Tracking**: View earned mastery titles
5. **Historical Analysis**: Look at completed season rankings
6. **Competitive Research**: Study successful player patterns

**Key Metrics:**
- **totalXp**: Combined points from liquidity and trading activities
- **liquidityXp**: Points earned from providing liquidity
- **tradingXp**: Points earned from swap/trading volume
- **distributionPercent**: Player's share of total XP pool
- **masteryTitles**: Achievements unlocked (liquidity or trading focused)

**Related Operations:**
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_ALL_DEX_SEASONS} to find valid season IDs
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_CURRENT_DEX_LEADERBOARD} for quick access to current season rankings
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_CURRENT_DEX_SEASON} to get the active season ID

Please fetch the leaderboard for season ${seasonId}.`);
    },
};
/**
 * Fetch Current DEX Leaderboard
 *
 * Returns the leaderboard rankings for the currently active season.
 * Combines current season detection with leaderboard retrieval.
 */
exports.fetchCurrentDexLeaderboardPrompt = {
    name: 'galachain-launchpad:fetch-current-dex-leaderboard',
    description: 'Fetch DEX leaderboard rankings for the currently active season',
    arguments: [],
    handler: () => {
        return (0, handlerHelpers_js_1.createPromptResponse)(`I want to view the DEX leaderboard rankings for the currently active season.

**Purpose:**
Get real-time leaderboard rankings for the season that is active right now.

**Data to Retrieve:**
- Current season information (auto-detected)
- Player rankings and positions
- Total XP earned by each player
- Liquidity XP and Trading XP breakdown
- Distribution percentages
- Mastery titles and achievements

**Leaderboard Features:**
- Automatically finds the active season
- Complete rankings of all participants
- Real-time XP metrics
- Achievement tracking
- Top performer summaries

**Information Provided:**
- Current season name and ID
- Live leaderboard positions
- XP earned by each player
- Mastery achievements and titles
- Performance distribution

**Use Cases:**
1. **Live Rankings**: See current competitive standings
2. **Find Myself**: Locate your position on the leaderboard
3. **Top Players**: Identify current season leaders
4. **Achievement View**: See earned mastery titles
5. **Quick Check**: Fastest way to see active season rankings
6. **Real-Time Tracking**: Monitor ongoing competition progress

**Return Values:**
- **currentSeason**: The season that is active (or null if no active season)
- **totalEntries**: Number of players in current rankings
- **topEntries**: Top 5 ranked players (quick summary)
- **topPlayer**: #1 ranked player with detailed stats

**Related Operations:**
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_CURRENT_DEX_SEASON} to just get season info
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_ALL_DEX_SEASONS} to see all seasons
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_DEX_LEADERBOARD_BY_SEASON_ID} to view a specific season

**Edge Case:**
- If no season is currently active, returns null (off-season period)
- Graceful handling ensures clean error reporting

Please fetch the current DEX leaderboard rankings.`);
    },
};
/**
 * Export all DEX leaderboard prompts
 */
exports.dexLeaderboardPrompts = [
    exports.fetchAllDexSeasonsPrompt,
    exports.fetchCurrentDexSeasonPrompt,
    exports.fetchDexLeaderboardBySeasonIdPrompt,
    exports.fetchCurrentDexLeaderboardPrompt,
];
//# sourceMappingURL=dex-leaderboard.js.map