@catalyst-team/poly-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @prediction-router/poly-sdk
+ *
+ * Unified SDK for Polymarket APIs
+ * - Data API (positions, activity, trades, leaderboard)
+ * - Gamma API (markets, events, trending)
+ * - CLOB API (orderbook, market info, trading)
+ * - Services (WalletService, MarketService)
+ */
+export { RateLimiter, ApiType } from './core/rate-limiter.js';
+export { Cache, CACHE_TTL } from './core/cache.js';
+export { PolymarketError, ErrorCode, withRetry } from './core/errors.js';
+export * from './core/types.js';
+export type { UnifiedCache } from './core/unified-cache.js';
+export { createUnifiedCache } from './core/unified-cache.js';
+export { DataApiClient } from './clients/data-api.js';
+export type { Position, Activity, Trade, LeaderboardEntry, LeaderboardPage, } from './clients/data-api.js';
+export { GammaApiClient } from './clients/gamma-api.js';
+export type { GammaMarket, GammaEvent, MarketSearchParams, } from './clients/gamma-api.js';
+export { ClobApiClient } from './clients/clob-api.js';
+export type { ClobMarket, ClobToken, Orderbook, OrderbookLevel, } from './clients/clob-api.js';
+export { WalletService } from './services/wallet-service.js';
+export type { WalletProfile, WalletActivitySummary, SellActivityResult, } from './services/wallet-service.js';
+export { MarketService, getIntervalMs as getIntervalMsService } from './services/market-service.js';
+export { WebSocketManager } from './clients/websocket-manager.js';
+export type { WebSocketManagerConfig, WebSocketManagerEvents } from './clients/websocket-manager.js';
+export { RealtimeService } from './services/realtime-service.js';
+export type { Subscription, MarketSubscriptionHandlers } from './services/realtime-service.js';
+export { TradingClient, POLYGON_MAINNET, POLYGON_AMOY } from './clients/trading-client.js';
+export type { Side, OrderType, ApiCredentials, OrderParams, MarketOrderParams, Order, OrderResult, TradeInfo, TradingClientConfig, UserEarning, MarketReward, OrderScoring, } from './clients/trading-client.js';
+export { CTFClient, CTF_CONTRACT, USDC_CONTRACT, // USDC.e (0x2791...) - Required for CTF
+NATIVE_USDC_CONTRACT, // Native USDC (0x3c49...) - NOT for CTF
+NEG_RISK_CTF_EXCHANGE, NEG_RISK_ADAPTER, USDC_DECIMALS, calculateConditionId, parseUsdc, formatUsdc, } from './clients/ctf-client.js';
+export type { CTFConfig, SplitResult, MergeResult, RedeemResult, PositionBalance, MarketResolution, GasEstimate, TransactionStatus, TokenIds, } from './clients/ctf-client.js';
+export { RevertReason } from './clients/ctf-client.js';
+export { BridgeClient, SUPPORTED_CHAINS, BRIDGE_TOKENS, estimateBridgeOutput, getExplorerUrl, depositUsdc, swapAndDeposit, getSupportedDepositTokens, } from './clients/bridge-client.js';
+export type { BridgeSupportedAsset, DepositAddress, CreateDepositResponse, DepositStatus, BridgeConfig, DepositResult, DepositOptions, SwapAndDepositOptions, SwapAndDepositResult, } from './clients/bridge-client.js';
+export { SwapService, QUICKSWAP_ROUTER, POLYGON_TOKENS, TOKEN_DECIMALS, } from './services/swap-service.js';
+export type { SupportedToken, SwapQuote, SwapResult, TokenBalance, TransferResult, } from './services/swap-service.js';
+export { AuthorizationService } from './services/authorization-service.js';
+export type { AllowanceInfo, AllowancesResult, ApprovalTxResult, ApprovalsResult, AuthorizationServiceConfig, } from './services/authorization-service.js';
+export { roundPrice, roundSize, validatePrice, validateSize, calculateBuyAmount, calculateSellPayout, calculateSharesForAmount, calculateSpread, calculateMidpoint, formatPrice, formatUSDC, calculatePnL, checkArbitrage, getEffectivePrices, ROUNDING_CONFIG, } from './utils/price-utils.js';
+export type { TickSize } from './utils/price-utils.js';
+export { createMcpHandler, registerMcpTools, getToolDefinitions, allToolDefinitions, } from './mcp/index.js';
+export type { ToolHandler, ToolDefinition, McpErrorResponse, } from './mcp/index.js';
+export { McpToolError, ErrorCode as McpErrorCode } from './mcp/errors.js';
+import { DataApiClient } from './clients/data-api.js';
+import { GammaApiClient } from './clients/gamma-api.js';
+import { ClobApiClient } from './clients/clob-api.js';
+import { WalletService } from './services/wallet-service.js';
+import { MarketService } from './services/market-service.js';
+import type { UnifiedMarket, ProcessedOrderbook, ArbitrageOpportunity, PolySDKOptions } from './core/types.js';
+export interface PolymarketSDKConfig extends PolySDKOptions {
+}
+export declare class PolymarketSDK {
+    private rateLimiter;
+    private cache;
+    readonly dataApi: DataApiClient;
+    readonly gammaApi: GammaApiClient;
+    readonly clobApi: ClobApiClient;
+    readonly wallets: WalletService;
+    readonly markets: MarketService;
+    constructor(config?: PolymarketSDKConfig);
+    /**
+     * Get market by slug or condition ID
+     * Uses Gamma for slug, CLOB for conditionId
+     */
+    getMarket(identifier: string): Promise<UnifiedMarket>;
+    private getMarketBySlug;
+    private getMarketByConditionId;
+    /**
+     * Get processed orderbook with analytics
+     */
+    getOrderbook(conditionId: string): Promise<ProcessedOrderbook>;
+    /**
+     * Detect arbitrage opportunity
+     *
+     * 使用有效价格计算套利机会（正确考虑镜像订单）
+     * 详细文档见: docs/01-polymarket-orderbook-arbitrage.md
+     */
+    detectArbitrage(conditionId: string, threshold?: number): Promise<ArbitrageOpportunity | null>;
+    private mergeMarkets;
+    private fromGammaMarket;
+    private fromClobMarket;
+    /**
+     * Clear all cached data
+     */
+    clearCache(): void;
+    /**
+     * Invalidate cache for a specific market
+     */
+    invalidateMarketCache(conditionId: string): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,258 @@
+/**
+ * @prediction-router/poly-sdk
+ *
+ * Unified SDK for Polymarket APIs
+ * - Data API (positions, activity, trades, leaderboard)
+ * - Gamma API (markets, events, trending)
+ * - CLOB API (orderbook, market info, trading)
+ * - Services (WalletService, MarketService)
+ */
+// Core infrastructure
+export { RateLimiter, ApiType } from './core/rate-limiter.js';
+export { Cache, CACHE_TTL } from './core/cache.js';
+export { PolymarketError, ErrorCode, withRetry } from './core/errors.js';
+export * from './core/types.js';
+export { createUnifiedCache } from './core/unified-cache.js';
+// API Clients
+export { DataApiClient } from './clients/data-api.js';
+export { GammaApiClient } from './clients/gamma-api.js';
+export { ClobApiClient } from './clients/clob-api.js';
+// Services
+export { WalletService } from './services/wallet-service.js';
+export { MarketService, getIntervalMs as getIntervalMsService } from './services/market-service.js';
+// Real-time
+export { WebSocketManager } from './clients/websocket-manager.js';
+export { RealtimeService } from './services/realtime-service.js';
+// NOTE: ArbitrageService has been moved to @prediction-router/arb package
+// See packages/arb/src/services/arbitrage-service.ts
+// Trading
+export { TradingClient, POLYGON_MAINNET, POLYGON_AMOY } from './clients/trading-client.js';
+// CTF (Conditional Token Framework)
+// NOTE: USDC_CONTRACT is USDC.e (bridged), required for Polymarket CTF
+// NATIVE_USDC_CONTRACT is native USDC, NOT compatible with CTF
+export { CTFClient, CTF_CONTRACT, USDC_CONTRACT, // USDC.e (0x2791...) - Required for CTF
+NATIVE_USDC_CONTRACT, // Native USDC (0x3c49...) - NOT for CTF
+NEG_RISK_CTF_EXCHANGE, NEG_RISK_ADAPTER, USDC_DECIMALS, calculateConditionId, parseUsdc, formatUsdc, } from './clients/ctf-client.js';
+export { RevertReason } from './clients/ctf-client.js';
+// Bridge (Cross-chain Deposits)
+export { BridgeClient, SUPPORTED_CHAINS, BRIDGE_TOKENS, estimateBridgeOutput, getExplorerUrl, depositUsdc, swapAndDeposit, getSupportedDepositTokens, } from './clients/bridge-client.js';
+// Swap Service (DEX swaps on Polygon)
+export { SwapService, QUICKSWAP_ROUTER, POLYGON_TOKENS, TOKEN_DECIMALS, } from './services/swap-service.js';
+// Authorization (ERC20/ERC1155 Approvals)
+export { AuthorizationService } from './services/authorization-service.js';
+// Price Utilities
+export { roundPrice, roundSize, validatePrice, validateSize, calculateBuyAmount, calculateSellPayout, calculateSharesForAmount, calculateSpread, calculateMidpoint, formatPrice, formatUSDC, calculatePnL, checkArbitrage, getEffectivePrices, ROUNDING_CONFIG, } from './utils/price-utils.js';
+// NOTE: ArbitrageService has been moved to @prediction-router/arb package
+// See packages/arb/src/services/arbitrage-service.ts
+// MCP (Model Context Protocol) Tools
+export { createMcpHandler, registerMcpTools, getToolDefinitions, allToolDefinitions, } from './mcp/index.js';
+export { McpToolError, ErrorCode as McpErrorCode } from './mcp/errors.js';
+// ===== Main SDK Class =====
+import { RateLimiter } from './core/rate-limiter.js';
+import { DataApiClient } from './clients/data-api.js';
+import { GammaApiClient } from './clients/gamma-api.js';
+import { ClobApiClient } from './clients/clob-api.js';
+import { WalletService } from './services/wallet-service.js';
+import { MarketService } from './services/market-service.js';
+import { PolymarketError, ErrorCode } from './core/errors.js';
+import { createUnifiedCache } from './core/unified-cache.js';
+export class PolymarketSDK {
+    // Infrastructure
+    rateLimiter;
+    cache;
+    // API Clients
+    dataApi;
+    gammaApi;
+    clobApi;
+    // Services
+    wallets;
+    markets;
+    constructor(config = {}) {
+        // Initialize infrastructure
+        this.rateLimiter = new RateLimiter();
+        // Create unified cache (supports both legacy Cache and CacheAdapter)
+        this.cache = createUnifiedCache(config.cache);
+        // Initialize API clients
+        this.dataApi = new DataApiClient(this.rateLimiter, this.cache);
+        this.gammaApi = new GammaApiClient(this.rateLimiter, this.cache);
+        this.clobApi = new ClobApiClient(this.rateLimiter, this.cache, {
+            chainId: config.chainId,
+            signer: config.signer,
+            creds: config.creds,
+        });
+        // Initialize services
+        this.wallets = new WalletService(this.dataApi, this.cache);
+        this.markets = new MarketService(this.gammaApi, this.clobApi, this.dataApi, this.cache);
+    }
+    // ===== Unified Market Access =====
+    /**
+     * Get market by slug or condition ID
+     * Uses Gamma for slug, CLOB for conditionId
+     */
+    async getMarket(identifier) {
+        const isConditionId = identifier.startsWith('0x') || /^\d+$/.test(identifier);
+        if (isConditionId) {
+            return this.getMarketByConditionId(identifier);
+        }
+        else {
+            return this.getMarketBySlug(identifier);
+        }
+    }
+    async getMarketBySlug(slug) {
+        // Gamma as primary source for slug
+        const gammaMarket = await this.gammaApi.getMarketBySlug(slug);
+        if (!gammaMarket) {
+            throw new PolymarketError(ErrorCode.MARKET_NOT_FOUND, `Market not found: ${slug}`);
+        }
+        // Enrich with CLOB data
+        try {
+            const clobMarket = await this.clobApi.getMarket(gammaMarket.conditionId);
+            return this.mergeMarkets(gammaMarket, clobMarket);
+        }
+        catch {
+            return this.fromGammaMarket(gammaMarket);
+        }
+    }
+    async getMarketByConditionId(conditionId) {
+        // CLOB as primary source for conditionId (more reliable)
+        try {
+            const clobMarket = await this.clobApi.getMarket(conditionId);
+            // Try to enrich with Gamma data
+            try {
+                const gammaMarket = await this.gammaApi.getMarketByConditionId(conditionId);
+                if (gammaMarket) {
+                    return this.mergeMarkets(gammaMarket, clobMarket);
+                }
+            }
+            catch {
+                // Gamma enrichment failed, use CLOB only
+            }
+            return this.fromClobMarket(clobMarket);
+        }
+        catch {
+            throw new PolymarketError(ErrorCode.MARKET_NOT_FOUND, `Market not found: ${conditionId}`);
+        }
+    }
+    // ===== Orderbook Analysis =====
+    /**
+     * Get processed orderbook with analytics
+     */
+    async getOrderbook(conditionId) {
+        return this.clobApi.getProcessedOrderbook(conditionId);
+    }
+    /**
+     * Detect arbitrage opportunity
+     *
+     * 使用有效价格计算套利机会（正确考虑镜像订单）
+     * 详细文档见: docs/01-polymarket-orderbook-arbitrage.md
+     */
+    async detectArbitrage(conditionId, threshold = 0.005) {
+        const orderbook = await this.getOrderbook(conditionId);
+        const { effectivePrices, longArbProfit, shortArbProfit } = orderbook.summary;
+        if (longArbProfit > threshold) {
+            return {
+                type: 'long',
+                profit: longArbProfit,
+                action: `Buy YES @ ${effectivePrices.effectiveBuyYes.toFixed(4)} + Buy NO @ ${effectivePrices.effectiveBuyNo.toFixed(4)}, merge for 1 USDC`,
+                expectedProfit: longArbProfit,
+            };
+        }
+        if (shortArbProfit > threshold) {
+            return {
+                type: 'short',
+                profit: shortArbProfit,
+                action: `Split 1 USDC, Sell YES @ ${effectivePrices.effectiveSellYes.toFixed(4)} + Sell NO @ ${effectivePrices.effectiveSellNo.toFixed(4)}`,
+                expectedProfit: shortArbProfit,
+            };
+        }
+        return null;
+    }
+    // ===== Helper Methods =====
+    mergeMarkets(gamma, clob) {
+        const yesToken = clob.tokens.find((t) => t.outcome === 'Yes');
+        const noToken = clob.tokens.find((t) => t.outcome === 'No');
+        return {
+            conditionId: clob.conditionId,
+            slug: gamma.slug,
+            question: clob.question,
+            description: clob.description || gamma.description,
+            tokens: {
+                yes: {
+                    tokenId: yesToken?.tokenId || '',
+                    price: yesToken?.price || gamma.outcomePrices[0] || 0.5,
+                },
+                no: {
+                    tokenId: noToken?.tokenId || '',
+                    price: noToken?.price || gamma.outcomePrices[1] || 0.5,
+                },
+            },
+            volume: gamma.volume,
+            volume24hr: gamma.volume24hr,
+            liquidity: gamma.liquidity,
+            spread: gamma.spread,
+            active: clob.active,
+            closed: clob.closed,
+            acceptingOrders: clob.acceptingOrders,
+            endDate: clob.endDateIso ? new Date(clob.endDateIso) : new Date(),
+            source: 'merged',
+        };
+    }
+    fromGammaMarket(gamma) {
+        return {
+            conditionId: gamma.conditionId,
+            slug: gamma.slug,
+            question: gamma.question,
+            description: gamma.description,
+            tokens: {
+                yes: { tokenId: '', price: gamma.outcomePrices[0] || 0.5 },
+                no: { tokenId: '', price: gamma.outcomePrices[1] || 0.5 },
+            },
+            volume: gamma.volume,
+            volume24hr: gamma.volume24hr,
+            liquidity: gamma.liquidity,
+            spread: gamma.spread,
+            active: gamma.active,
+            closed: gamma.closed,
+            acceptingOrders: !gamma.closed,
+            endDate: gamma.endDate,
+            source: 'gamma',
+        };
+    }
+    fromClobMarket(clob) {
+        const yesToken = clob.tokens.find((t) => t.outcome === 'Yes');
+        const noToken = clob.tokens.find((t) => t.outcome === 'No');
+        return {
+            conditionId: clob.conditionId,
+            slug: clob.marketSlug,
+            question: clob.question,
+            description: clob.description,
+            tokens: {
+                yes: { tokenId: yesToken?.tokenId || '', price: yesToken?.price || 0.5 },
+                no: { tokenId: noToken?.tokenId || '', price: noToken?.price || 0.5 },
+            },
+            volume: 0, // CLOB doesn't have volume
+            volume24hr: undefined,
+            liquidity: 0,
+            spread: undefined,
+            active: clob.active,
+            closed: clob.closed,
+            acceptingOrders: clob.acceptingOrders,
+            endDate: clob.endDateIso ? new Date(clob.endDateIso) : new Date(),
+            source: 'clob',
+        };
+    }
+    // ===== Cache Management =====
+    /**
+     * Clear all cached data
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Invalidate cache for a specific market
+     */
+    invalidateMarketCache(conditionId) {
+        this.cache.invalidate(conditionId);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/errors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MCP Error Handling for Polymarket Tools
+ */
+export declare enum ErrorCode {
+    INVALID_ADDRESS = "INVALID_ADDRESS",
+    MARKET_NOT_FOUND = "MARKET_NOT_FOUND",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    ORDER_REJECTED = "ORDER_REJECTED",
+    RATE_LIMITED = "RATE_LIMITED",
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    INVALID_INPUT = "INVALID_INPUT",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+export declare class McpToolError extends Error {
+    code: ErrorCode;
+    details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined);
+    toResponse(): {
+        error: {
+            code: ErrorCode;
+            message: string;
+            details: Record<string, unknown> | undefined;
+        };
+    };
+}
+export declare function validateAddress(address: string): void;
+export declare function validateConditionId(conditionId: string): void;
+export declare function validateOutcome(outcome: string): void;
+export declare function validateSide(side: string): void;
+export declare function validatePrice(price: number): void;
+export declare function validatePositiveNumber(value: number, name: string): void;
+export declare function wrapError(err: unknown): McpToolError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/mcp/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAED,qBAAa,YAAa,SAAQ,KAAK;IAE5B,IAAI,EAAE,SAAS;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAM1C,UAAU;;;;;;;CASX;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAcrD;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAc7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQrD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ/C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAQjD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQxE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAepD"}

package/dist/mcp/errors.js

@@ -0,0 +1,86 @@
+/**
+ * MCP Error Handling for Polymarket Tools
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["INVALID_ADDRESS"] = "INVALID_ADDRESS";
+    ErrorCode["MARKET_NOT_FOUND"] = "MARKET_NOT_FOUND";
+    ErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    ErrorCode["ORDER_REJECTED"] = "ORDER_REJECTED";
+    ErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    ErrorCode["AUTH_REQUIRED"] = "AUTH_REQUIRED";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class McpToolError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'McpToolError';
+    }
+    toResponse() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                details: this.details,
+            },
+        };
+    }
+}
+export function validateAddress(address) {
+    if (!address || typeof address !== 'string') {
+        throw new McpToolError(ErrorCode.INVALID_ADDRESS, 'Address is required');
+    }
+    if (!address.startsWith('0x') || address.length !== 42) {
+        throw new McpToolError(ErrorCode.INVALID_ADDRESS, 'Address must be a valid Ethereum address (0x...)', { address });
+    }
+}
+export function validateConditionId(conditionId) {
+    if (!conditionId || typeof conditionId !== 'string') {
+        throw new McpToolError(ErrorCode.INVALID_INPUT, 'Condition ID is required');
+    }
+    if (!conditionId.startsWith('0x')) {
+        throw new McpToolError(ErrorCode.INVALID_INPUT, 'Condition ID must start with 0x', { conditionId });
+    }
+}
+export function validateOutcome(outcome) {
+    if (!['Yes', 'No'].includes(outcome)) {
+        throw new McpToolError(ErrorCode.INVALID_INPUT, 'Outcome must be "Yes" or "No"', { outcome });
+    }
+}
+export function validateSide(side) {
+    if (!['BUY', 'SELL'].includes(side)) {
+        throw new McpToolError(ErrorCode.INVALID_INPUT, 'Side must be "BUY" or "SELL"', { side });
+    }
+}
+export function validatePrice(price) {
+    if (typeof price !== 'number' || price < 0.001 || price > 0.999) {
+        throw new McpToolError(ErrorCode.INVALID_INPUT, 'Price must be between 0.001 and 0.999', { price });
+    }
+}
+export function validatePositiveNumber(value, name) {
+    if (typeof value !== 'number' || value <= 0) {
+        throw new McpToolError(ErrorCode.INVALID_INPUT, `${name} must be a positive number`, { [name]: value });
+    }
+}
+export function wrapError(err) {
+    if (err instanceof McpToolError) {
+        return err;
+    }
+    if (err instanceof Error) {
+        // Check for known error types
+        if (err.message.includes('rate limit')) {
+            return new McpToolError(ErrorCode.RATE_LIMITED, 'Rate limit exceeded');
+        }
+        if (err.message.includes('not found')) {
+            return new McpToolError(ErrorCode.MARKET_NOT_FOUND, err.message);
+        }
+        return new McpToolError(ErrorCode.INTERNAL_ERROR, err.message);
+    }
+    return new McpToolError(ErrorCode.INTERNAL_ERROR, 'An unexpected error occurred');
+}
+//# sourceMappingURL=errors.js.map

package/dist/mcp/errors.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Polymarket MCP Tools
+ *
+ * This module provides MCP (Model Context Protocol) tools for interacting with Polymarket.
+ * It can be used to build an MCP server that exposes Polymarket functionality to AI agents.
+ *
+ * Tool Categories:
+ * - Trader Tools: Analyze traders/wallets (positions, trades, profiles, leaderboard)
+ * - Market Tools: Discover and analyze markets (get, search, trending, trades)
+ * - Order Tools: Analyze orderbooks (depth, best prices, execution estimates)
+ * - Trade Tools: Execute trades (limit orders, market orders) - requires API credentials
+ * - Wallet Tools: Deposits and authorization management
+ *
+ * Usage:
+ * ```typescript
+ * import { PolymarketSDK } from '@prediction-router/poly-sdk';
+ * import { createMcpHandler, allToolDefinitions } from '@prediction-router/poly-sdk/mcp';
+ *
+ * const sdk = new PolymarketSDK();
+ * const handler = createMcpHandler(sdk);
+ *
+ * // Use with MCP server
+ * const result = await handler('get_trader_positions', { address: '0x...' });
+ * ```
+ */
+import { PolymarketSDK } from '../index.js';
+export * from './types.js';
+export * from './errors.js';
+export { allToolDefinitions } from './tools/index.js';
+export type ToolHandler = (toolName: string, args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Create an MCP tool handler for the given SDK instance
+ */
+export declare function createMcpHandler(sdk: PolymarketSDK): ToolHandler;
+/**
+ * Get all tool definitions for MCP registration
+ */
+export declare function getToolDefinitions(): import("./types.js").ToolDefinition[];
+/**
+ * MCP Server factory (for use with @modelcontextprotocol/sdk)
+ *
+ * Example usage with MCP SDK:
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ * import { PolymarketSDK } from '@prediction-router/poly-sdk';
+ * import { registerMcpTools } from '@prediction-router/poly-sdk/mcp';
+ *
+ * const server = new Server(
+ *   { name: 'poly-mcp', version: '1.0.0' },
+ *   { capabilities: { tools: {} } }
+ * );
+ *
+ * const sdk = new PolymarketSDK();
+ * registerMcpTools(server, sdk);
+ *
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export declare function registerMcpTools(server: any, sdk: PolymarketSDK): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,MAAM,WAAW,GAAG,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CAwKhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,0CAEjC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAE9B,MAAM,EAAE,GAAG,EACX,GAAG,EAAE,aAAa,GACjB,IAAI,CA0BN"}