@catalyst-team/poly-sdk 0.1.0

package/dist/services/authorization-service.js

@@ -0,0 +1,279 @@
+/**
+ * Authorization Service
+ *
+ * Manages ERC20 and ERC1155 approvals required for trading on Polymarket.
+ *
+ * Required approvals for trading:
+ * - ERC20 (USDC): Approve USDC spending for CTF Exchange, Neg Risk Exchange, etc.
+ * - ERC1155 (Conditional Tokens): Approve operators for conditional token transfers
+ *
+ * @see https://docs.polymarket.com/
+ */
+import { ethers } from 'ethers';
+import { CTF_CONTRACT, NEG_RISK_CTF_EXCHANGE, NEG_RISK_ADAPTER, USDC_CONTRACT, } from '../clients/ctf-client.js';
+// Contract addresses
+const CTF_EXCHANGE = '0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E';
+const CONDITIONAL_TOKENS = CTF_CONTRACT;
+// ABIs
+const ERC20_ABI = [
+    'function balanceOf(address owner) view returns (uint256)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+];
+const ERC1155_ABI = [
+    'function setApprovalForAll(address operator, bool approved) external',
+    'function isApprovedForAll(address account, address operator) view returns (bool)',
+];
+// Contracts that need ERC20 approval
+const ERC20_SPENDERS = [
+    { name: 'CTF Exchange', address: CTF_EXCHANGE },
+    { name: 'Neg Risk CTF Exchange', address: NEG_RISK_CTF_EXCHANGE },
+    { name: 'Neg Risk Adapter', address: NEG_RISK_ADAPTER },
+    { name: 'Conditional Tokens', address: CONDITIONAL_TOKENS },
+];
+// Operators that need ERC1155 approval
+const ERC1155_OPERATORS = [
+    { name: 'CTF Exchange', address: CTF_EXCHANGE },
+    { name: 'Neg Risk CTF Exchange', address: NEG_RISK_CTF_EXCHANGE },
+    { name: 'Neg Risk Adapter', address: NEG_RISK_ADAPTER },
+];
+/**
+ * Service for managing trading authorizations on Polymarket
+ *
+ * @example
+ * ```typescript
+ * const authService = new AuthorizationService(signer);
+ *
+ * // Check all allowances
+ * const status = await authService.checkAllowances();
+ * console.log(`Trading ready: ${status.tradingReady}`);
+ * if (!status.tradingReady) {
+ *   console.log('Issues:', status.issues);
+ * }
+ *
+ * // Set up all approvals
+ * const result = await authService.approveAll();
+ * console.log(result.summary);
+ * ```
+ */
+export class AuthorizationService {
+    signer;
+    provider;
+    constructor(signer, config = {}) {
+        this.signer = signer;
+        this.provider = config.provider || signer.provider || new ethers.providers.JsonRpcProvider('https://polygon-rpc.com');
+    }
+    /**
+     * Get the wallet address
+     */
+    get walletAddress() {
+        return this.signer.address;
+    }
+    /**
+     * Check all ERC20 and ERC1155 allowances required for trading
+     *
+     * @returns Status of all allowances and whether trading is ready
+     */
+    async checkAllowances() {
+        const walletAddress = this.signer.address;
+        const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, this.provider);
+        const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, this.provider);
+        // Check USDC balance
+        const balance = await usdc.balanceOf(walletAddress);
+        const balanceFormatted = ethers.utils.formatUnits(balance, 6);
+        // Check ERC20 allowances
+        const erc20Allowances = [];
+        for (const spender of ERC20_SPENDERS) {
+            const allowance = await usdc.allowance(walletAddress, spender.address);
+            const allowanceNum = parseFloat(ethers.utils.formatUnits(allowance, 6));
+            const isUnlimited = allowanceNum > 1e12;
+            erc20Allowances.push({
+                contract: spender.name,
+                address: spender.address,
+                approved: isUnlimited,
+                allowance: isUnlimited ? 'unlimited' : allowanceNum.toFixed(2),
+            });
+        }
+        // Check ERC1155 approvals
+        const erc1155Approvals = [];
+        for (const operator of ERC1155_OPERATORS) {
+            const isApproved = await conditionalTokens.isApprovedForAll(walletAddress, operator.address);
+            erc1155Approvals.push({
+                contract: operator.name,
+                address: operator.address,
+                approved: isApproved,
+            });
+        }
+        // Determine issues
+        const issues = [];
+        for (const a of erc20Allowances) {
+            if (!a.approved) {
+                issues.push(`ERC20: ${a.contract} needs USDC approval`);
+            }
+        }
+        for (const a of erc1155Approvals) {
+            if (!a.approved) {
+                issues.push(`ERC1155: ${a.contract} needs approval for Conditional Tokens`);
+            }
+        }
+        const tradingReady = issues.length === 0;
+        return {
+            wallet: walletAddress,
+            usdcBalance: balanceFormatted,
+            erc20Allowances,
+            erc1155Approvals,
+            tradingReady,
+            issues,
+        };
+    }
+    /**
+     * Set up all required approvals for trading
+     *
+     * @returns Results of all approval transactions
+     */
+    async approveAll() {
+        const walletAddress = this.signer.address;
+        const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, this.signer);
+        const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, this.signer);
+        // Get gas price with buffer
+        const gasPrice = await this.provider.getGasPrice();
+        const adjustedGasPrice = gasPrice.mul(150).div(100); // 1.5x
+        // Process ERC20 approvals
+        const erc20Results = [];
+        for (const spender of ERC20_SPENDERS) {
+            // Check current allowance
+            const allowance = await usdc.allowance(walletAddress, spender.address);
+            const allowanceNum = parseFloat(ethers.utils.formatUnits(allowance, 6));
+            if (allowanceNum > 1e12) {
+                // Already approved
+                erc20Results.push({
+                    contract: spender.name,
+                    success: true,
+                });
+                continue;
+            }
+            try {
+                const tx = await usdc.approve(spender.address, ethers.constants.MaxUint256, {
+                    gasPrice: adjustedGasPrice,
+                });
+                await tx.wait();
+                erc20Results.push({
+                    contract: spender.name,
+                    txHash: tx.hash,
+                    success: true,
+                });
+            }
+            catch (err) {
+                erc20Results.push({
+                    contract: spender.name,
+                    success: false,
+                    error: err instanceof Error ? err.message : 'Unknown error',
+                });
+            }
+        }
+        // Process ERC1155 approvals
+        const erc1155Results = [];
+        for (const operator of ERC1155_OPERATORS) {
+            // Check current approval
+            const isApproved = await conditionalTokens.isApprovedForAll(walletAddress, operator.address);
+            if (isApproved) {
+                // Already approved
+                erc1155Results.push({
+                    contract: operator.name,
+                    success: true,
+                });
+                continue;
+            }
+            try {
+                const tx = await conditionalTokens.setApprovalForAll(operator.address, true, {
+                    gasPrice: adjustedGasPrice,
+                    gasLimit: 100000,
+                });
+                await tx.wait();
+                erc1155Results.push({
+                    contract: operator.name,
+                    txHash: tx.hash,
+                    success: true,
+                });
+            }
+            catch (err) {
+                erc1155Results.push({
+                    contract: operator.name,
+                    success: false,
+                    error: err instanceof Error ? err.message : 'Unknown error',
+                });
+            }
+        }
+        const allApproved = erc20Results.every((r) => r.success) && erc1155Results.every((r) => r.success);
+        const newApprovals = [...erc20Results, ...erc1155Results].filter((r) => r.txHash).length;
+        return {
+            wallet: walletAddress,
+            erc20Approvals: erc20Results,
+            erc1155Approvals: erc1155Results,
+            allApproved,
+            summary: allApproved
+                ? newApprovals > 0
+                    ? `All approvals set. ${newApprovals} new approval(s) submitted.`
+                    : 'All approvals already set. Ready to trade.'
+                : 'Some approvals failed. Check the results for details.',
+        };
+    }
+    /**
+     * Approve USDC spending for a specific contract
+     *
+     * @param spenderAddress - The contract address to approve
+     * @param amount - The amount to approve (default: unlimited)
+     */
+    async approveUsdc(spenderAddress, amount = ethers.constants.MaxUint256) {
+        const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, this.signer);
+        const gasPrice = await this.provider.getGasPrice();
+        try {
+            const tx = await usdc.approve(spenderAddress, amount, {
+                gasPrice: gasPrice.mul(150).div(100),
+            });
+            await tx.wait();
+            return {
+                contract: spenderAddress,
+                txHash: tx.hash,
+                success: true,
+            };
+        }
+        catch (err) {
+            return {
+                contract: spenderAddress,
+                success: false,
+                error: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Set approval for an ERC1155 operator
+     *
+     * @param operatorAddress - The operator address to approve
+     * @param approved - Whether to approve or revoke
+     */
+    async setErc1155Approval(operatorAddress, approved = true) {
+        const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, this.signer);
+        const gasPrice = await this.provider.getGasPrice();
+        try {
+            const tx = await conditionalTokens.setApprovalForAll(operatorAddress, approved, {
+                gasPrice: gasPrice.mul(150).div(100),
+                gasLimit: 100000,
+            });
+            await tx.wait();
+            return {
+                contract: operatorAddress,
+                txHash: tx.hash,
+                success: true,
+            };
+        }
+        catch (err) {
+            return {
+                contract: operatorAddress,
+                success: false,
+                error: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    }
+}
+//# sourceMappingURL=authorization-service.js.map

package/dist/services/authorization-service.js.map

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

package/dist/services/market-service.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Market Service
+ *
+ * Provides enhanced market analysis features:
+ * - K-Line aggregation from trade data
+ * - Dual token K-Lines (YES + NO)
+ * - Spread analysis
+ * - Market signal detection
+ */
+import { DataApiClient } from '../clients/data-api.js';
+import { GammaApiClient, GammaMarket } from '../clients/gamma-api.js';
+import { ClobApiClient } from '../clients/clob-api.js';
+import type { UnifiedCache } from '../core/unified-cache.js';
+import type { UnifiedMarket, ProcessedOrderbook, ArbitrageOpportunity, KLineInterval, KLineCandle, DualKLineData, RealtimeSpreadAnalysis } from '../core/types.js';
+export declare class MarketService {
+    private gammaApi;
+    private clobApi;
+    private dataApi;
+    private cache;
+    constructor(gammaApi: GammaApiClient, clobApi: ClobApiClient, dataApi: DataApiClient, cache: UnifiedCache);
+    /**
+     * Get market by slug or condition ID
+     */
+    getMarket(identifier: string): Promise<UnifiedMarket>;
+    private getMarketBySlug;
+    private getMarketByConditionId;
+    /**
+     * Get K-Line candles for a market (single token)
+     */
+    getKLines(conditionId: string, interval: KLineInterval, options?: {
+        limit?: number;
+        tokenId?: string;
+        outcomeIndex?: number;
+    }): Promise<KLineCandle[]>;
+    /**
+     * Get dual K-Lines (YES + NO tokens)
+     */
+    getDualKLines(conditionId: string, interval: KLineInterval, options?: {
+        limit?: number;
+    }): Promise<DualKLineData>;
+    /**
+     * Aggregate trades into K-Line candles
+     */
+    private aggregateToKLines;
+    /**
+     * Analyze historical spread from trade close prices (for backtesting)
+     *
+     * This uses trade close prices, not orderbook bid/ask.
+     * Useful for:
+     * - Historical analysis / backtesting
+     * - Understanding past price movements
+     * - Identifying patterns when orderbook data unavailable
+     */
+    private analyzeHistoricalSpread;
+    /**
+     * Calculate real-time spread from orderbook (for live trading)
+     *
+     * This uses orderbook bid/ask prices for accurate arbitrage detection.
+     * Useful for:
+     * - Real-time arbitrage execution
+     * - Live trading decisions
+     * - Accurate profit calculations
+     */
+    private calculateRealtimeSpread;
+    /**
+     * Get real-time spread analysis only (without K-lines)
+     * Use this for quick arbitrage checks
+     */
+    getRealtimeSpread(conditionId: string): Promise<RealtimeSpreadAnalysis>;
+    /**
+     * 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>;
+    /**
+     * Get trending markets
+     */
+    getTrendingMarkets(limit?: number): Promise<GammaMarket[]>;
+    /**
+     * Search markets
+     */
+    searchMarkets(params: {
+        active?: boolean;
+        closed?: boolean;
+        limit?: number;
+        offset?: number;
+        order?: string;
+    }): Promise<GammaMarket[]>;
+    /**
+     * Detect market signals (volume surge, depth imbalance, whale trades)
+     */
+    detectMarketSignals(conditionId: string): Promise<Array<{
+        type: 'volume_surge' | 'depth_imbalance' | 'whale_trade' | 'momentum';
+        severity: 'low' | 'medium' | 'high';
+        details: Record<string, unknown>;
+    }>>;
+    private mergeMarkets;
+    private fromGammaMarket;
+    private fromClobMarket;
+}
+export declare function getIntervalMs(interval: KLineInterval): number;
+//# sourceMappingURL=market-service.d.ts.map

package/dist/services/market-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-service.d.ts","sourceRoot":"","sources":["../../src/services/market-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAS,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAc,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAmB,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAEpL,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;gBAHL,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,YAAY;IAK7B;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YAU7C,eAAe;YAcf,sBAAsB;IAkDpC;;OAEG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,WAAW,EAAE,CAAC;IAczB;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,aAAa,CAAC;IAoCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwCzB;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA0C/B;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;;OAGG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO7E;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIpE;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA6BnG;;OAEG;IACG,kBAAkB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAM1B;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CACrD,KAAK,CAAC;QACJ,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,aAAa,GAAG,UAAU,CAAC;QACtE,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC,CACH;IA6DD,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,cAAc;CAwBvB;AAID,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAa7D"}