@catalyst-team/poly-sdk 0.2.1 → 0.4.0

package/dist/src/core/errors.js

@@ -0,0 +1,86 @@
+/**
+ * Unified error handling for Polymarket SDK
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Network errors
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    // Authentication errors
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["API_KEY_EXPIRED"] = "API_KEY_EXPIRED";
+    ErrorCode["INVALID_SIGNATURE"] = "INVALID_SIGNATURE";
+    // Data errors
+    ErrorCode["MARKET_NOT_FOUND"] = "MARKET_NOT_FOUND";
+    ErrorCode["WALLET_NOT_FOUND"] = "WALLET_NOT_FOUND";
+    ErrorCode["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+    // Trading errors
+    ErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    ErrorCode["ORDER_REJECTED"] = "ORDER_REJECTED";
+    ErrorCode["ORDER_FAILED"] = "ORDER_FAILED";
+    ErrorCode["MARKET_CLOSED"] = "MARKET_CLOSED";
+    // API errors
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    // Internal errors
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    // Configuration errors
+    ErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+})(ErrorCode || (ErrorCode = {}));
+export class PolymarketError extends Error {
+    code;
+    retryable;
+    originalError;
+    constructor(code, message, retryable = false, originalError) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.originalError = originalError;
+        this.name = 'PolymarketError';
+    }
+    /**
+     * Create error from HTTP response status
+     */
+    static fromHttpError(status, body) {
+        const bodyMessage = body && typeof body === 'object' && 'message' in body
+            ? String(body.message)
+            : '';
+        switch (status) {
+            case 429:
+                return new PolymarketError(ErrorCode.RATE_LIMITED, bodyMessage || 'Rate limited', true);
+            case 401:
+                return new PolymarketError(ErrorCode.AUTH_FAILED, bodyMessage || 'Authentication failed');
+            case 403:
+                return new PolymarketError(ErrorCode.AUTH_FAILED, bodyMessage || 'Forbidden');
+            case 404:
+                return new PolymarketError(ErrorCode.MARKET_NOT_FOUND, bodyMessage || 'Resource not found');
+            case 400:
+                return new PolymarketError(ErrorCode.INVALID_RESPONSE, bodyMessage || 'Bad request');
+            default:
+                return new PolymarketError(ErrorCode.NETWORK_ERROR, bodyMessage || `HTTP ${status}`, status >= 500);
+        }
+    }
+}
+/**
+ * Retry decorator for async functions
+ */
+export async function withRetry(fn, options = {}) {
+    const { maxRetries = 3, delay = 1000 } = options;
+    let lastError;
+    for (let i = 0; i < maxRetries; i++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (error instanceof PolymarketError && !error.retryable) {
+                throw error;
+            }
+            if (i < maxRetries - 1) {
+                await new Promise((r) => setTimeout(r, delay * Math.pow(2, i)));
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SA8BX;AA9BD,WAAY,SAAS;IACnB,iBAAiB;IACjB,4CAA+B,CAAA;IAC/B,gCAAmB,CAAA;IACnB,0CAA6B,CAAA;IAE7B,wBAAwB;IACxB,wCAA2B,CAAA;IAC3B,gDAAmC,CAAA;IACnC,oDAAuC,CAAA;IAEvC,cAAc;IACd,kDAAqC,CAAA;IACrC,kDAAqC,CAAA;IACrC,kDAAqC,CAAA;IAErC,iBAAiB;IACjB,0DAA6C,CAAA;IAC7C,8CAAiC,CAAA;IACjC,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;IAE/B,aAAa;IACb,oCAAuB,CAAA;IAEvB,kBAAkB;IAClB,8CAAiC,CAAA;IAEjC,uBAAuB;IACvB,8CAAiC,CAAA;AACnC,CAAC,EA9BW,SAAS,KAAT,SAAS,QA8BpB;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAE/B;IAEA;IACA;IAJT,YACS,IAAe,EACtB,OAAe,EACR,YAAqB,KAAK,EAC1B,aAAqB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,SAAI,GAAJ,IAAI,CAAW;QAEf,cAAS,GAAT,SAAS,CAAiB;QAC1B,kBAAa,GAAb,aAAa,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAc,EAAE,IAAc;QACjD,MAAM,WAAW,GACf,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI;YACnD,CAAC,CAAC,MAAM,CAAE,IAA6B,CAAC,OAAO,CAAC;YAChD,CAAC,CAAC,EAAE,CAAC;QAET,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,GAAG;gBACN,OAAO,IAAI,eAAe,CACxB,SAAS,CAAC,YAAY,EACtB,WAAW,IAAI,cAAc,EAC7B,IAAI,CACL,CAAC;YACJ,KAAK,GAAG;gBACN,OAAO,IAAI,eAAe,CACxB,SAAS,CAAC,WAAW,EACrB,WAAW,IAAI,uBAAuB,CACvC,CAAC;YACJ,KAAK,GAAG;gBACN,OAAO,IAAI,eAAe,CACxB,SAAS,CAAC,WAAW,EACrB,WAAW,IAAI,WAAW,CAC3B,CAAC;YACJ,KAAK,GAAG;gBACN,OAAO,IAAI,eAAe,CACxB,SAAS,CAAC,gBAAgB,EAC1B,WAAW,IAAI,oBAAoB,CACpC,CAAC;YACJ,KAAK,GAAG;gBACN,OAAO,IAAI,eAAe,CACxB,SAAS,CAAC,gBAAgB,EAC1B,WAAW,IAAI,aAAa,CAC7B,CAAC;YACJ;gBACE,OAAO,IAAI,eAAe,CACxB,SAAS,CAAC,aAAa,EACvB,WAAW,IAAI,QAAQ,MAAM,EAAE,EAC/B,MAAM,IAAI,GAAG,CACd,CAAC;QACN,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAmD,EAAE;IAErD,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEjD,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAC3B,IAAI,KAAK,YAAY,eAAe,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACzD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/src/core/rate-limiter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Rate Limiter for Polymarket APIs
+ * - Data API: 100ms minimum interval
+ * - Gamma API: 10 req/s
+ * - CLOB API: 10 req/s
+ */
+export declare enum ApiType {
+    DATA_API = "data-api",
+    GAMMA_API = "gamma-api",
+    CLOB_API = "clob-api",
+    SUBGRAPH = "subgraph",
+    BINANCE = "binance"
+}
+export declare class RateLimiter {
+    private limiters;
+    constructor();
+    /**
+     * Execute a function with rate limiting
+     */
+    execute<T>(api: ApiType, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute multiple functions in order with rate limiting
+     */
+    executeBatch<T>(api: ApiType, fns: (() => Promise<T>)[]): Promise<T[]>;
+    /**
+     * Get current limiter statistics
+     */
+    getStats(api: ApiType): {
+        running: number;
+        queued: number;
+    } | null;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/src/core/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/core/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,oBAAY,OAAO;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AA6BD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAuC;;IAQvD;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMhE;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ5E;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CASnE"}

package/dist/src/core/rate-limiter.js

@@ -0,0 +1,82 @@
+/**
+ * Rate Limiter for Polymarket APIs
+ * - Data API: 100ms minimum interval
+ * - Gamma API: 10 req/s
+ * - CLOB API: 10 req/s
+ */
+import Bottleneck from 'bottleneck';
+export var ApiType;
+(function (ApiType) {
+    ApiType["DATA_API"] = "data-api";
+    ApiType["GAMMA_API"] = "gamma-api";
+    ApiType["CLOB_API"] = "clob-api";
+    ApiType["SUBGRAPH"] = "subgraph";
+    ApiType["BINANCE"] = "binance";
+})(ApiType || (ApiType = {}));
+const API_LIMITS = {
+    [ApiType.DATA_API]: {
+        minTime: 100, // 100ms minimum interval
+        maxConcurrent: 5,
+    },
+    [ApiType.GAMMA_API]: {
+        reservoir: 10,
+        reservoirRefreshAmount: 10,
+        reservoirRefreshInterval: 1000,
+    },
+    [ApiType.CLOB_API]: {
+        reservoir: 10,
+        reservoirRefreshAmount: 10,
+        reservoirRefreshInterval: 1000,
+    },
+    [ApiType.SUBGRAPH]: {
+        minTime: 50, // 50ms minimum interval
+        maxConcurrent: 10,
+    },
+    [ApiType.BINANCE]: {
+        // Binance allows 1200 requests/min, we use 10 req/s to be conservative
+        reservoir: 10,
+        reservoirRefreshAmount: 10,
+        reservoirRefreshInterval: 1000,
+    },
+};
+export class RateLimiter {
+    limiters = new Map();
+    constructor() {
+        for (const [type, config] of Object.entries(API_LIMITS)) {
+            this.limiters.set(type, new Bottleneck(config));
+        }
+    }
+    /**
+     * Execute a function with rate limiting
+     */
+    async execute(api, fn) {
+        const limiter = this.limiters.get(api);
+        if (!limiter)
+            throw new Error(`Unknown API type: ${api}`);
+        return limiter.schedule(fn);
+    }
+    /**
+     * Execute multiple functions in order with rate limiting
+     */
+    async executeBatch(api, fns) {
+        const results = [];
+        for (const fn of fns) {
+            results.push(await this.execute(api, fn));
+        }
+        return results;
+    }
+    /**
+     * Get current limiter statistics
+     */
+    getStats(api) {
+        const limiter = this.limiters.get(api);
+        if (!limiter)
+            return null;
+        const counts = limiter.counts();
+        return {
+            running: counts.RUNNING,
+            queued: counts.QUEUED,
+        };
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/src/core/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../src/core/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,MAAM,CAAN,IAAY,OAMX;AAND,WAAY,OAAO;IACjB,gCAAqB,CAAA;IACrB,kCAAuB,CAAA;IACvB,gCAAqB,CAAA;IACrB,gCAAqB,CAAA;IACrB,8BAAmB,CAAA;AACrB,CAAC,EANW,OAAO,KAAP,OAAO,QAMlB;AAED,MAAM,UAAU,GAAmD;IACjE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAClB,OAAO,EAAE,GAAG,EAAE,yBAAyB;QACvC,aAAa,EAAE,CAAC;KACjB;IACD,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QACnB,SAAS,EAAE,EAAE;QACb,sBAAsB,EAAE,EAAE;QAC1B,wBAAwB,EAAE,IAAI;KAC/B;IACD,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAClB,SAAS,EAAE,EAAE;QACb,sBAAsB,EAAE,EAAE;QAC1B,wBAAwB,EAAE,IAAI;KAC/B;IACD,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAClB,OAAO,EAAE,EAAE,EAAE,wBAAwB;QACrC,aAAa,EAAE,EAAE;KAClB;IACD,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACjB,uEAAuE;QACvE,SAAS,EAAE,EAAE;QACb,sBAAsB,EAAE,EAAE;QAC1B,wBAAwB,EAAE,IAAI;KAC/B;CACF,CAAC;AAEF,MAAM,OAAO,WAAW;IACd,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEvD;QACE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAe,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAI,GAAY,EAAE,EAAoB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAI,GAAY,EAAE,GAAyB;QAC3D,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAY;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;CACF"}