@catalyst-team/poly-sdk 0.1.0

package/dist/mcp/tools/trader.js

@@ -0,0 +1,277 @@
+/**
+ * Trader Tools - MCP tools for trader/wallet analysis
+ */
+import { validateAddress, wrapError } from '../errors.js';
+export const traderToolDefinitions = [
+    {
+        name: 'get_trader_positions',
+        description: 'Get all positions held by a trader with PnL breakdown',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: {
+                    type: 'string',
+                    description: 'Trader wallet address (0x...)',
+                },
+            },
+            required: ['address'],
+        },
+    },
+    {
+        name: 'get_trader_trades',
+        description: 'Get recent trading activity for a trader',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: {
+                    type: 'string',
+                    description: 'Trader wallet address',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of trades to return',
+                    default: 20,
+                },
+                side: {
+                    type: 'string',
+                    enum: ['BUY', 'SELL'],
+                    description: 'Filter by trade side',
+                },
+            },
+            required: ['address'],
+        },
+    },
+    {
+        name: 'get_trader_profile',
+        description: 'Get comprehensive trader profile with performance metrics',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: {
+                    type: 'string',
+                    description: 'Trader wallet address',
+                },
+            },
+            required: ['address'],
+        },
+    },
+    {
+        name: 'get_leaderboard',
+        description: 'Get top traders by PnL',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Number of traders to return',
+                    default: 10,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Pagination offset',
+                    default: 0,
+                },
+            },
+        },
+    },
+];
+export async function handleGetTraderPositions(sdk, input) {
+    validateAddress(input.address);
+    try {
+        const positions = await sdk.wallets.getWalletPositions(input.address);
+        const totalUnrealizedPnl = positions.reduce((sum, p) => sum + (p.cashPnl || 0), 0);
+        const totalRealizedPnl = positions.reduce((sum, p) => sum + (p.realizedPnl || 0), 0);
+        const winningPositions = positions.filter((p) => (p.cashPnl || 0) > 0).length;
+        const losingPositions = positions.filter((p) => (p.cashPnl || 0) < 0).length;
+        return {
+            trader: {
+                address: input.address,
+                displayName: null, // Will be enriched if available
+            },
+            positions: positions.map((p) => ({
+                market: {
+                    conditionId: p.conditionId,
+                    title: p.title,
+                    slug: p.slug,
+                },
+                holding: {
+                    outcome: p.outcome,
+                    size: p.size,
+                    avgPrice: p.avgPrice,
+                    curPrice: p.curPrice,
+                },
+                pnl: {
+                    unrealized: p.cashPnl,
+                    unrealizedPercent: p.percentPnl,
+                    realized: p.realizedPnl,
+                },
+                status: {
+                    redeemable: p.redeemable,
+                    endDate: p.endDate,
+                },
+            })),
+            summary: {
+                totalPositions: positions.length,
+                totalUnrealizedPnl,
+                totalRealizedPnl,
+                winningPositions,
+                losingPositions,
+            },
+        };
+    }
+    catch (err) {
+        throw wrapError(err);
+    }
+}
+export async function handleGetTraderTrades(sdk, input) {
+    validateAddress(input.address);
+    try {
+        const activityResult = await sdk.wallets.getWalletActivity(input.address, input.limit || 100);
+        let trades = activityResult.activities.filter((a) => a.type === 'TRADE');
+        // Filter by side if specified
+        if (input.side) {
+            trades = trades.filter((a) => a.side === input.side);
+        }
+        // Apply limit
+        const limit = input.limit || 20;
+        trades = trades.slice(0, limit);
+        const buyTrades = trades.filter((t) => t.side === 'BUY');
+        const sellTrades = trades.filter((t) => t.side === 'SELL');
+        return {
+            trader: {
+                address: input.address,
+                displayName: null,
+            },
+            trades: trades.map((t) => ({
+                type: t.type,
+                side: t.side,
+                market: {
+                    conditionId: t.conditionId,
+                    title: t.title || '',
+                    slug: t.slug,
+                },
+                outcome: t.outcome,
+                execution: {
+                    size: t.size,
+                    price: t.price,
+                    usdcValue: t.usdcSize || t.size * t.price,
+                },
+                timestamp: new Date(t.timestamp).toISOString(),
+                txHash: t.transactionHash,
+            })),
+            summary: {
+                totalTrades: trades.length,
+                buyCount: buyTrades.length,
+                sellCount: sellTrades.length,
+                buyVolume: buyTrades.reduce((sum, t) => sum + (t.usdcSize || t.size * t.price), 0),
+                sellVolume: sellTrades.reduce((sum, t) => sum + (t.usdcSize || t.size * t.price), 0),
+            },
+        };
+    }
+    catch (err) {
+        throw wrapError(err);
+    }
+}
+export async function handleGetTraderProfile(sdk, input) {
+    validateAddress(input.address);
+    try {
+        const profile = await sdk.wallets.getWalletProfile(input.address);
+        // Try to get leaderboard data for rank and official PnL
+        let rank = null;
+        let leaderboardPnl = null;
+        let leaderboardVolume = null;
+        let displayName = null;
+        let verified = false;
+        try {
+            const leaderboard = await sdk.wallets.getLeaderboard(0, 100);
+            const entry = leaderboard.entries.find((e) => e.address.toLowerCase() === input.address.toLowerCase());
+            if (entry) {
+                rank = entry.rank;
+                leaderboardPnl = entry.pnl;
+                leaderboardVolume = entry.volume;
+                displayName = entry.userName || null;
+                verified = entry.verifiedBadge || false;
+            }
+        }
+        catch {
+            // Ignore leaderboard errors
+        }
+        const winningCount = profile.positionCount > 0
+            ? Math.round(profile.positionCount * (profile.avgPercentPnL > 0 ? 0.6 : 0.4))
+            : 0;
+        const winRate = profile.positionCount > 0
+            ? winningCount / profile.positionCount
+            : 0;
+        return {
+            trader: {
+                address: input.address,
+                displayName,
+                xUsername: null,
+                verified,
+                profileImage: null,
+            },
+            ranking: {
+                rank,
+                totalTraders: 10000, // Approximate
+            },
+            performance: {
+                // Official PnL from leaderboard (used for ranking)
+                officialPnl: leaderboardPnl,
+                // Volume from leaderboard
+                totalVolume: leaderboardVolume ?? (profile.totalPnL + profile.unrealizedPnL),
+                // Calculated PnL from profile positions
+                unrealizedPnl: profile.unrealizedPnL,
+                realizedPnl: profile.realizedPnL,
+            },
+            stats: {
+                positionCount: profile.positionCount,
+                winRate,
+                avgPercentPnl: profile.avgPercentPnL,
+                smartScore: profile.smartScore,
+            },
+            activity: {
+                lastTradeAt: profile.lastActiveAt.getTime() > 0
+                    ? profile.lastActiveAt.toISOString()
+                    : null,
+                isActive: Date.now() - profile.lastActiveAt.getTime() < 7 * 24 * 60 * 60 * 1000,
+            },
+            // Explain potential PnL differences
+            notes: leaderboardPnl !== null && Math.abs((leaderboardPnl || 0) - (profile.unrealizedPnL + profile.realizedPnL)) > 100
+                ? 'Note: officialPnl (from leaderboard) may differ from unrealizedPnl + realizedPnl (from positions) due to different calculation methods. Leaderboard PnL includes historical settled positions.'
+                : undefined,
+        };
+    }
+    catch (err) {
+        throw wrapError(err);
+    }
+}
+export async function handleGetLeaderboard(sdk, input) {
+    const limit = input.limit || 10;
+    const offset = input.offset || 0;
+    try {
+        const page = Math.floor(offset / 50);
+        const leaderboard = await sdk.wallets.getLeaderboard(page, 50);
+        // Apply offset and limit within the page
+        const startIdx = offset % 50;
+        const entries = leaderboard.entries.slice(startIdx, startIdx + limit);
+        return {
+            traders: entries.map((e) => ({
+                rank: e.rank,
+                address: e.address,
+                displayName: e.userName || null,
+                pnl: e.pnl,
+                volume: e.volume,
+                verified: e.verifiedBadge || false,
+            })),
+            pagination: {
+                total: leaderboard.total,
+                offset,
+                limit,
+            },
+        };
+    }
+    catch (err) {
+        throw wrapError(err);
+    }
+}
+//# sourceMappingURL=trader.js.map

package/dist/mcp/tools/trader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trader.js","sourceRoot":"","sources":["../../../src/mcp/tools/trader.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/wallet.d.ts

@@ -0,0 +1,274 @@
+/**
+ * Wallet Tools - MCP tools for deposits, swaps, and authorization management
+ *
+ * These tools use SDK services:
+ * - BridgeClient for deposit addresses and supported assets
+ * - SwapService for DEX swaps on Polygon (QuickSwap V3)
+ * - AuthorizationService for allowance checks and approvals
+ * - depositUsdc() for executing USDC deposits
+ * - swapAndDeposit() for swapping any token to USDC and depositing
+ */
+import type { PolymarketSDK } from '../../index.js';
+import type { ToolDefinition } from '../types.js';
+export declare const walletToolDefinitions: ToolDefinition[];
+interface GetSupportedAssetsInput {
+    chainId?: number;
+}
+interface DepositUsdcInput {
+    amount: number;
+    token?: 'NATIVE_USDC' | 'USDC_E';
+}
+/**
+ * Get supported deposit assets
+ */
+export declare function handleGetSupportedAssets(_sdk: PolymarketSDK, input: GetSupportedAssetsInput): Promise<{
+    assets: {
+        chainId: number;
+        chainName: string;
+        tokenSymbol: string;
+        tokenName: string;
+        tokenAddress: string;
+        decimals: number;
+        minDeposit: string;
+        minDepositUsd: number;
+    }[];
+    summary: {
+        totalChains: number;
+        totalAssets: number;
+        chains: string[];
+    };
+}>;
+/**
+ * Get deposit addresses for the wallet
+ */
+export declare function handleGetDepositAddresses(sdk: PolymarketSDK): Promise<{
+    wallet: string;
+    addresses: {
+        evm: string;
+        solana: string;
+        bitcoin: string;
+    };
+    evmChains: string[];
+    instructions: string;
+}>;
+/**
+ * Deposit USDC to Polymarket
+ */
+export declare function handleDepositUsdc(sdk: PolymarketSDK, input: DepositUsdcInput): Promise<{
+    success: boolean;
+    error: string | undefined;
+    wallet: string;
+    amount: number;
+    txHash?: undefined;
+    depositAddress?: undefined;
+    message?: undefined;
+    explorerUrl?: undefined;
+} | {
+    success: boolean;
+    wallet: string;
+    amount: string;
+    txHash: string | undefined;
+    depositAddress: string;
+    message: string;
+    explorerUrl: string;
+    error?: undefined;
+}>;
+/**
+ * Check all allowances required for trading
+ */
+export declare function handleCheckAllowances(sdk: PolymarketSDK): Promise<{
+    wallet: string;
+    erc20: {
+        usdc: {
+            balance: string;
+            allowances: import("../../index.js").AllowanceInfo[];
+        };
+    };
+    erc1155: {
+        conditionalTokens: {
+            approvals: import("../../index.js").AllowanceInfo[];
+        };
+    };
+    tradingReady: boolean;
+    issues: string[];
+}>;
+/**
+ * Set up all required approvals for trading
+ */
+export declare function handleApproveTrading(sdk: PolymarketSDK): Promise<{
+    wallet: string;
+    erc20Approvals: import("../../index.js").ApprovalTxResult[];
+    erc1155Approvals: import("../../index.js").ApprovalTxResult[];
+    allApproved: boolean;
+    summary: string;
+}>;
+interface SwapInput {
+    tokenIn: string;
+    tokenOut: string;
+    amount: string;
+    slippage?: number;
+}
+interface SwapAndDepositInput {
+    token: string;
+    amount: string;
+    slippage?: number;
+}
+/**
+ * Swap between tokens on Polygon using QuickSwap V3
+ */
+export declare function handleSwap(sdk: PolymarketSDK, input: SwapInput): Promise<{
+    success: boolean;
+    error: string;
+    wallet: string;
+    txHash?: undefined;
+    tokenIn?: undefined;
+    tokenOut?: undefined;
+    amountIn?: undefined;
+    amountOut?: undefined;
+    gasUsed?: undefined;
+    explorerUrl?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    wallet: string;
+    txHash: string;
+    tokenIn?: undefined;
+    tokenOut?: undefined;
+    amountIn?: undefined;
+    amountOut?: undefined;
+    gasUsed?: undefined;
+    explorerUrl?: undefined;
+} | {
+    success: boolean;
+    wallet: string;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    amountOut: string;
+    txHash: string;
+    gasUsed: string;
+    explorerUrl: string;
+    error?: undefined;
+}>;
+/**
+ * Swap any token to USDC and deposit to Polymarket
+ */
+export declare function handleSwapAndDeposit(sdk: PolymarketSDK, input: SwapAndDepositInput): Promise<{
+    success: boolean;
+    error: string | undefined;
+    wallet: string;
+    token: string;
+    amount: string;
+    tokenIn?: undefined;
+    amountIn?: undefined;
+    usdcAmount?: undefined;
+    swapTxHash?: undefined;
+    depositTxHash?: undefined;
+    depositAddress?: undefined;
+    message?: undefined;
+    explorerUrl?: undefined;
+} | {
+    success: boolean;
+    wallet: string;
+    tokenIn: string;
+    amountIn: string;
+    usdcAmount: string;
+    swapTxHash: string | null;
+    depositTxHash: string | undefined;
+    depositAddress: string;
+    message: string;
+    explorerUrl: string | undefined;
+    error?: undefined;
+    token?: undefined;
+    amount?: undefined;
+}>;
+/**
+ * Get balances for all supported tokens (requires configured wallet)
+ */
+export declare function handleGetTokenBalances(sdk: PolymarketSDK): Promise<{
+    wallet: string;
+    balances: {
+        token: string;
+        symbol: string;
+        balance: string;
+        decimals: number;
+    }[];
+    nonZeroBalances: {
+        token: string;
+        balance: string;
+    }[];
+    supportedTokens: string[];
+}>;
+/**
+ * Get balances for any wallet address (no private key required)
+ */
+export declare function handleGetWalletBalances(_sdk: PolymarketSDK, input: {
+    address: string;
+}): Promise<{
+    address: string;
+    balances: {
+        token: string;
+        symbol: string;
+        balance: string;
+        decimals: number;
+    }[];
+    nonZeroBalances: {
+        token: string;
+        balance: string;
+    }[];
+    summary: {
+        totalTokens: number;
+        stablecoinValue: string;
+    };
+    supportedTokens: string[];
+}>;
+interface GetSwapQuoteInput {
+    tokenIn: string;
+    tokenOut: string;
+    amount: string;
+}
+/**
+ * Get a swap quote (check route availability and estimate output)
+ * No private key required - uses read-only provider
+ */
+export declare function handleGetSwapQuote(_sdk: PolymarketSDK, input: GetSwapQuoteInput): Promise<{
+    possible: boolean;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    amountOut: string | null;
+    route: string[];
+    routeDescription: string;
+    message: string;
+    poolExists?: undefined;
+    reason?: undefined;
+    suggestion?: undefined;
+} | {
+    possible: boolean;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    amountOut: null;
+    route: string[];
+    poolExists: boolean;
+    reason: string | undefined;
+    suggestion: string;
+    routeDescription?: undefined;
+    message?: undefined;
+}>;
+/**
+ * Get all available liquidity pools on QuickSwap V3
+ */
+export declare function handleGetAvailablePools(_sdk: PolymarketSDK): Promise<{
+    pools: {
+        pair: string;
+        tokenA: string;
+        tokenB: string;
+        poolAddress: string | null;
+    }[];
+    totalPools: number;
+    supportedTokens: string[];
+    note: string;
+}>;
+export {};
+//# sourceMappingURL=wallet.d.ts.map

package/dist/mcp/tools/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AASpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,qBAAqB,EAAE,cAAc,EA6JjD,CAAC;AAGF,UAAU,uBAAuB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;CAClC;AAiCD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,uBAAuB;;;;;;;;;;;;;;;;GAqC/B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,aAAa;;;;;;;;;GAkCjE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;GA8BxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa;;;;;;;;;;;;;;;GA0B7D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,aAAa;;;;;;GAiB5D;AAGD,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CpE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCxF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,aAAa;;;;;;;;;;;;;GA2B9D;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;GA+C3B;AAGD,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;GAkDzB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;GAyBhE"}