@catalyst-team/poly-sdk 0.1.1 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/LICENSE +1 -1
  2. package/README.en.md +502 -0
  3. package/README.md +6 -1
  4. package/README.zh-CN.md +502 -0
  5. package/dist/__tests__/clob-api.test.d.ts +5 -0
  6. package/dist/__tests__/clob-api.test.d.ts.map +1 -0
  7. package/dist/__tests__/clob-api.test.js +240 -0
  8. package/dist/__tests__/clob-api.test.js.map +1 -0
  9. package/dist/__tests__/integration/bridge-client.integration.test.d.ts +11 -0
  10. package/dist/__tests__/integration/bridge-client.integration.test.d.ts.map +1 -0
  11. package/dist/__tests__/integration/bridge-client.integration.test.js +260 -0
  12. package/dist/__tests__/integration/bridge-client.integration.test.js.map +1 -0
  13. package/dist/__tests__/integration/clob-api.integration.test.d.ts +13 -0
  14. package/dist/__tests__/integration/clob-api.integration.test.d.ts.map +1 -0
  15. package/dist/__tests__/integration/clob-api.integration.test.js +170 -0
  16. package/dist/__tests__/integration/clob-api.integration.test.js.map +1 -0
  17. package/dist/__tests__/integration/ctf-client.integration.test.d.ts +17 -0
  18. package/dist/__tests__/integration/ctf-client.integration.test.d.ts.map +1 -0
  19. package/dist/__tests__/integration/ctf-client.integration.test.js +234 -0
  20. package/dist/__tests__/integration/ctf-client.integration.test.js.map +1 -0
  21. package/dist/__tests__/integration/data-api.integration.test.d.ts +9 -0
  22. package/dist/__tests__/integration/data-api.integration.test.d.ts.map +1 -0
  23. package/dist/__tests__/integration/data-api.integration.test.js +161 -0
  24. package/dist/__tests__/integration/data-api.integration.test.js.map +1 -0
  25. package/dist/__tests__/integration/gamma-api.integration.test.d.ts +9 -0
  26. package/dist/__tests__/integration/gamma-api.integration.test.d.ts.map +1 -0
  27. package/dist/__tests__/integration/gamma-api.integration.test.js +170 -0
  28. package/dist/__tests__/integration/gamma-api.integration.test.js.map +1 -0
  29. package/dist/__tests__/test-utils.d.ts +92 -0
  30. package/dist/__tests__/test-utils.d.ts.map +1 -0
  31. package/dist/__tests__/test-utils.js +143 -0
  32. package/dist/__tests__/test-utils.js.map +1 -0
  33. package/dist/clients/bridge-client.d.ts +388 -0
  34. package/dist/clients/bridge-client.d.ts.map +1 -0
  35. package/dist/clients/bridge-client.js +587 -0
  36. package/dist/clients/bridge-client.js.map +1 -0
  37. package/dist/clients/clob-api.d.ts +318 -0
  38. package/dist/clients/clob-api.d.ts.map +1 -0
  39. package/dist/clients/clob-api.js +388 -0
  40. package/dist/clients/clob-api.js.map +1 -0
  41. package/dist/clients/ctf-client.d.ts +473 -0
  42. package/dist/clients/ctf-client.d.ts.map +1 -0
  43. package/dist/clients/ctf-client.js +915 -0
  44. package/dist/clients/ctf-client.js.map +1 -0
  45. package/dist/clients/data-api.d.ts +134 -0
  46. package/dist/clients/data-api.d.ts.map +1 -0
  47. package/dist/clients/data-api.js +265 -0
  48. package/dist/clients/data-api.js.map +1 -0
  49. package/dist/clients/gamma-api.d.ts +401 -0
  50. package/dist/clients/gamma-api.d.ts.map +1 -0
  51. package/dist/clients/gamma-api.js +352 -0
  52. package/dist/clients/gamma-api.js.map +1 -0
  53. package/dist/clients/trading-client.d.ts +252 -0
  54. package/dist/clients/trading-client.d.ts.map +1 -0
  55. package/dist/clients/trading-client.js +543 -0
  56. package/dist/clients/trading-client.js.map +1 -0
  57. package/dist/clients/websocket-manager.d.ts +100 -0
  58. package/dist/clients/websocket-manager.d.ts.map +1 -0
  59. package/dist/clients/websocket-manager.js +193 -0
  60. package/dist/clients/websocket-manager.js.map +1 -0
  61. package/dist/core/cache-adapter-bridge.d.ts +36 -0
  62. package/dist/core/cache-adapter-bridge.d.ts.map +1 -0
  63. package/dist/core/cache-adapter-bridge.js +81 -0
  64. package/dist/core/cache-adapter-bridge.js.map +1 -0
  65. package/dist/core/cache.d.ts +40 -0
  66. package/dist/core/cache.d.ts.map +1 -0
  67. package/dist/core/cache.js +71 -0
  68. package/dist/core/cache.js.map +1 -0
  69. package/dist/core/errors.d.ts +38 -0
  70. package/dist/core/errors.d.ts.map +1 -0
  71. package/dist/core/errors.js +84 -0
  72. package/dist/core/errors.js.map +1 -0
  73. package/dist/core/rate-limiter.d.ts +31 -0
  74. package/dist/core/rate-limiter.d.ts.map +1 -0
  75. package/dist/core/rate-limiter.js +70 -0
  76. package/dist/core/rate-limiter.js.map +1 -0
  77. package/{src/core/types.ts → dist/core/types.d.ts} +169 -215
  78. package/dist/core/types.d.ts.map +1 -0
  79. package/dist/core/types.js +19 -0
  80. package/dist/core/types.js.map +1 -0
  81. package/dist/core/unified-cache.d.ts +63 -0
  82. package/dist/core/unified-cache.d.ts.map +1 -0
  83. package/dist/core/unified-cache.js +114 -0
  84. package/dist/core/unified-cache.js.map +1 -0
  85. package/dist/index.d.ts +93 -0
  86. package/dist/index.d.ts.map +1 -0
  87. package/dist/index.js +255 -0
  88. package/dist/index.js.map +1 -0
  89. package/dist/services/arbitrage-service.d.ts +408 -0
  90. package/dist/services/arbitrage-service.d.ts.map +1 -0
  91. package/dist/services/arbitrage-service.js +1422 -0
  92. package/dist/services/arbitrage-service.js.map +1 -0
  93. package/dist/services/authorization-service.d.ts +97 -0
  94. package/dist/services/authorization-service.d.ts.map +1 -0
  95. package/dist/services/authorization-service.js +279 -0
  96. package/dist/services/authorization-service.js.map +1 -0
  97. package/dist/services/market-service.d.ts +108 -0
  98. package/dist/services/market-service.d.ts.map +1 -0
  99. package/dist/services/market-service.js +458 -0
  100. package/dist/services/market-service.js.map +1 -0
  101. package/dist/services/realtime-service.d.ts +82 -0
  102. package/dist/services/realtime-service.d.ts.map +1 -0
  103. package/dist/services/realtime-service.js +150 -0
  104. package/dist/services/realtime-service.js.map +1 -0
  105. package/dist/services/swap-service.d.ts +217 -0
  106. package/dist/services/swap-service.d.ts.map +1 -0
  107. package/dist/services/swap-service.js +695 -0
  108. package/dist/services/swap-service.js.map +1 -0
  109. package/dist/services/wallet-service.d.ts +94 -0
  110. package/dist/services/wallet-service.d.ts.map +1 -0
  111. package/dist/services/wallet-service.js +173 -0
  112. package/dist/services/wallet-service.js.map +1 -0
  113. package/dist/utils/price-utils.d.ts +153 -0
  114. package/dist/utils/price-utils.d.ts.map +1 -0
  115. package/dist/utils/price-utils.js +236 -0
  116. package/dist/utils/price-utils.js.map +1 -0
  117. package/package.json +7 -2
  118. package/docs/00-design.md +0 -760
  119. package/docs/02-API.md +0 -1148
  120. package/docs/arbitrage.md +0 -754
  121. package/docs/reports/smart-money-analysis-2025-12-23-cn.md +0 -840
  122. package/examples/01-basic-usage.ts +0 -68
  123. package/examples/02-smart-money.ts +0 -95
  124. package/examples/03-market-analysis.ts +0 -108
  125. package/examples/04-kline-aggregation.ts +0 -158
  126. package/examples/05-follow-wallet-strategy.ts +0 -156
  127. package/examples/06-services-demo.ts +0 -124
  128. package/examples/07-realtime-websocket.ts +0 -117
  129. package/examples/08-trading-orders.ts +0 -278
  130. package/examples/09-rewards-tracking.ts +0 -187
  131. package/examples/10-ctf-operations.ts +0 -336
  132. package/examples/11-live-arbitrage-scan.ts +0 -221
  133. package/examples/12-trending-arb-monitor.ts +0 -406
  134. package/examples/13-arbitrage-service.ts +0 -211
  135. package/examples/README.md +0 -179
  136. package/scripts/README.md +0 -163
  137. package/scripts/approvals/approve-erc1155.ts +0 -129
  138. package/scripts/approvals/approve-neg-risk-erc1155.ts +0 -149
  139. package/scripts/approvals/approve-neg-risk.ts +0 -102
  140. package/scripts/approvals/check-all-allowances.ts +0 -150
  141. package/scripts/approvals/check-allowance.ts +0 -129
  142. package/scripts/approvals/check-ctf-approval.ts +0 -158
  143. package/scripts/arb/faze-bo3-arb.ts +0 -385
  144. package/scripts/arb/settle-position.ts +0 -190
  145. package/scripts/arb/token-rebalancer.ts +0 -420
  146. package/scripts/datas/001-report.md +0 -486
  147. package/scripts/datas/clone-modal-screenshot.png +0 -0
  148. package/scripts/deposit/deposit-native-usdc.ts +0 -179
  149. package/scripts/deposit/deposit-usdc.ts +0 -155
  150. package/scripts/deposit/swap-usdc-to-usdce.ts +0 -375
  151. package/scripts/research/research-markets.ts +0 -166
  152. package/scripts/trading/check-orders.ts +0 -50
  153. package/scripts/trading/sell-nvidia-positions.ts +0 -206
  154. package/scripts/trading/test-order.ts +0 -172
  155. package/scripts/verify/test-approve-trading.ts +0 -98
  156. package/scripts/verify/test-provider-fix.ts +0 -43
  157. package/scripts/verify/test-search-mcp.ts +0 -113
  158. package/scripts/verify/verify-all-apis.ts +0 -160
  159. package/scripts/wallet/check-wallet-balances.ts +0 -75
  160. package/scripts/wallet/test-wallet-operations.ts +0 -191
  161. package/scripts/wallet/verify-wallet-tools.ts +0 -124
  162. package/src/__tests__/clob-api.test.ts +0 -301
  163. package/src/__tests__/integration/bridge-client.integration.test.ts +0 -314
  164. package/src/__tests__/integration/clob-api.integration.test.ts +0 -218
  165. package/src/__tests__/integration/ctf-client.integration.test.ts +0 -331
  166. package/src/__tests__/integration/data-api.integration.test.ts +0 -194
  167. package/src/__tests__/integration/gamma-api.integration.test.ts +0 -206
  168. package/src/__tests__/test-utils.ts +0 -170
  169. package/src/clients/bridge-client.ts +0 -841
  170. package/src/clients/clob-api.ts +0 -629
  171. package/src/clients/ctf-client.ts +0 -1216
  172. package/src/clients/data-api.ts +0 -469
  173. package/src/clients/gamma-api.ts +0 -597
  174. package/src/clients/trading-client.ts +0 -749
  175. package/src/clients/websocket-manager.ts +0 -267
  176. package/src/core/cache-adapter-bridge.ts +0 -94
  177. package/src/core/cache.ts +0 -85
  178. package/src/core/errors.ts +0 -117
  179. package/src/core/rate-limiter.ts +0 -74
  180. package/src/core/unified-cache.ts +0 -153
  181. package/src/index.ts +0 -461
  182. package/src/services/arbitrage-service.ts +0 -1807
  183. package/src/services/authorization-service.ts +0 -357
  184. package/src/services/market-service.ts +0 -544
  185. package/src/services/realtime-service.ts +0 -196
  186. package/src/services/swap-service.ts +0 -896
  187. package/src/services/wallet-service.ts +0 -259
  188. package/src/utils/price-utils.ts +0 -307
  189. package/tsconfig.json +0 -8
  190. package/vitest.config.ts +0 -19
  191. package/vitest.integration.config.ts +0 -18
@@ -0,0 +1,193 @@
1
+ /**
2
+ * WebSocket Manager
3
+ *
4
+ * Wraps @nevuamarkets/poly-websockets for real-time market data:
5
+ * - Price updates (derived from order book and trades)
6
+ * - Order book snapshots
7
+ * - Last trade price events
8
+ *
9
+ * Features:
10
+ * - Automatic connection management
11
+ * - Rate limiting built-in
12
+ * - Price caching for quick access
13
+ * - EventEmitter-based event distribution
14
+ */
15
+ import { EventEmitter } from 'events';
16
+ export class WebSocketManager extends EventEmitter {
17
+ wsManager; // WSSubscriptionManager instance
18
+ subscriptions = new Set();
19
+ priceCache = new Map();
20
+ bookCache = new Map();
21
+ initialized = false;
22
+ config;
23
+ constructor(config = {}) {
24
+ super();
25
+ this.config = {
26
+ maxMarketsPerWS: config.maxMarketsPerWS || 100,
27
+ enableLogging: config.enableLogging ?? false,
28
+ };
29
+ }
30
+ /**
31
+ * Initialize the WebSocket manager (lazy initialization)
32
+ */
33
+ async ensureInitialized() {
34
+ if (this.initialized)
35
+ return;
36
+ try {
37
+ // Dynamic import to handle the package not being installed
38
+ const { WSSubscriptionManager } = await import('@nevuamarkets/poly-websockets');
39
+ this.wsManager = new WSSubscriptionManager({
40
+ onPolymarketPriceUpdate: this.handlePriceUpdate.bind(this),
41
+ onBook: this.handleBookUpdate.bind(this),
42
+ onLastTradePrice: this.handleLastTradePrice.bind(this),
43
+ onWSOpen: this.handleOpen.bind(this),
44
+ onWSClose: this.handleClose.bind(this),
45
+ onError: this.handleError.bind(this),
46
+ }, {
47
+ maxMarketsPerWS: this.config.maxMarketsPerWS,
48
+ });
49
+ this.initialized = true;
50
+ }
51
+ catch (error) {
52
+ throw new Error('Failed to initialize WebSocket manager. Make sure @nevuamarkets/poly-websockets is installed.');
53
+ }
54
+ }
55
+ // ===== Subscription Management =====
56
+ /**
57
+ * Subscribe to asset price updates
58
+ */
59
+ async subscribe(assetIds) {
60
+ await this.ensureInitialized();
61
+ const newIds = assetIds.filter((id) => !this.subscriptions.has(id));
62
+ if (newIds.length === 0)
63
+ return;
64
+ const manager = this.wsManager;
65
+ await manager.addSubscriptions(newIds);
66
+ newIds.forEach((id) => this.subscriptions.add(id));
67
+ }
68
+ /**
69
+ * Unsubscribe from asset price updates
70
+ */
71
+ async unsubscribe(assetIds) {
72
+ if (!this.initialized)
73
+ return;
74
+ const existingIds = assetIds.filter((id) => this.subscriptions.has(id));
75
+ if (existingIds.length === 0)
76
+ return;
77
+ const manager = this.wsManager;
78
+ await manager.removeSubscriptions(existingIds);
79
+ existingIds.forEach((id) => {
80
+ this.subscriptions.delete(id);
81
+ this.priceCache.delete(id);
82
+ this.bookCache.delete(id);
83
+ });
84
+ }
85
+ /**
86
+ * Unsubscribe from all assets and cleanup
87
+ */
88
+ async unsubscribeAll() {
89
+ if (!this.initialized)
90
+ return;
91
+ const manager = this.wsManager;
92
+ await manager.clearState();
93
+ this.subscriptions.clear();
94
+ this.priceCache.clear();
95
+ this.bookCache.clear();
96
+ }
97
+ // ===== Price Cache Access =====
98
+ /**
99
+ * Get cached price for an asset
100
+ */
101
+ getPrice(assetId) {
102
+ return this.priceCache.get(assetId);
103
+ }
104
+ /**
105
+ * Get all cached prices
106
+ */
107
+ getAllPrices() {
108
+ return new Map(this.priceCache);
109
+ }
110
+ /**
111
+ * Get cached order book for an asset
112
+ */
113
+ getBook(assetId) {
114
+ return this.bookCache.get(assetId);
115
+ }
116
+ // ===== State Query =====
117
+ /**
118
+ * Get subscribed asset IDs
119
+ */
120
+ getSubscribedAssets() {
121
+ return Array.from(this.subscriptions);
122
+ }
123
+ /**
124
+ * Get connection statistics
125
+ */
126
+ getStatistics() {
127
+ if (!this.initialized)
128
+ return null;
129
+ const manager = this.wsManager;
130
+ return manager.getStatistics();
131
+ }
132
+ /**
133
+ * Check if initialized
134
+ */
135
+ isInitialized() {
136
+ return this.initialized;
137
+ }
138
+ // ===== Event Handlers =====
139
+ async handlePriceUpdate(events) {
140
+ for (const event of events) {
141
+ const update = {
142
+ assetId: event.asset_id,
143
+ price: parseFloat(event.price),
144
+ midpoint: parseFloat(event.midpoint),
145
+ spread: parseFloat(event.spread),
146
+ timestamp: parseInt(event.timestamp, 10),
147
+ };
148
+ this.priceCache.set(event.asset_id, update);
149
+ this.emit('priceUpdate', update);
150
+ }
151
+ }
152
+ async handleBookUpdate(events) {
153
+ for (const event of events) {
154
+ // Parse and sort bids descending (highest price = best bid first)
155
+ const bids = event.bids
156
+ .map((l) => ({ price: parseFloat(l.price), size: parseFloat(l.size) }))
157
+ .sort((a, b) => b.price - a.price);
158
+ // Parse and sort asks ascending (lowest price = best ask first)
159
+ const asks = event.asks
160
+ .map((l) => ({ price: parseFloat(l.price), size: parseFloat(l.size) }))
161
+ .sort((a, b) => a.price - b.price);
162
+ const update = {
163
+ assetId: event.asset_id,
164
+ bids,
165
+ asks,
166
+ timestamp: parseInt(event.timestamp, 10),
167
+ };
168
+ this.bookCache.set(event.asset_id, update);
169
+ this.emit('bookUpdate', update);
170
+ }
171
+ }
172
+ async handleLastTradePrice(events) {
173
+ for (const event of events) {
174
+ this.emit('lastTrade', {
175
+ assetId: event.asset_id,
176
+ price: parseFloat(event.price),
177
+ side: event.side,
178
+ size: parseFloat(event.size),
179
+ timestamp: parseInt(event.timestamp, 10),
180
+ });
181
+ }
182
+ }
183
+ async handleOpen(groupId, assetIds) {
184
+ this.emit('connected', { groupId, assetIds });
185
+ }
186
+ async handleClose(groupId, code, reason) {
187
+ this.emit('disconnected', { groupId, code, reason });
188
+ }
189
+ async handleError(error) {
190
+ this.emit('error', error);
191
+ }
192
+ }
193
+ //# sourceMappingURL=websocket-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"websocket-manager.js","sourceRoot":"","sources":["../../src/clients/websocket-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Bridge adapter between legacy Cache class and new CacheAdapter interface
3
+ *
4
+ * This allows the SDK to work with both:
5
+ * 1. Legacy internal Cache (synchronous, millisecond TTL)
6
+ * 2. New CacheAdapter interface (async, second TTL)
7
+ */
8
+ import type { CacheAdapter } from '@catalyst-team/cache';
9
+ import { Cache } from './cache.js';
10
+ /**
11
+ * Wraps the legacy Cache class to implement CacheAdapter interface
12
+ */
13
+ export declare class LegacyCacheAdapter implements CacheAdapter {
14
+ private cache;
15
+ constructor(cache: Cache);
16
+ get<T>(key: string): Promise<T | null>;
17
+ set<T>(key: string, value: T, ttl?: number): Promise<void>;
18
+ del(key: string): Promise<void>;
19
+ exists(key: string): Promise<boolean>;
20
+ clear(): Promise<void>;
21
+ }
22
+ /**
23
+ * Wraps a CacheAdapter to provide the legacy Cache interface
24
+ * This allows using new cache adapters with code expecting the old Cache class
25
+ */
26
+ export declare class CacheAdapterWrapper {
27
+ private adapter;
28
+ constructor(adapter: CacheAdapter);
29
+ get<T>(key: string): T | undefined;
30
+ set<T>(key: string, value: T, ttlMs: number): void;
31
+ getOrSet<T>(key: string, ttlMs: number, factory: () => Promise<T>): Promise<T>;
32
+ invalidate(pattern: string): void;
33
+ clear(): void;
34
+ size(): number;
35
+ }
36
+ //# sourceMappingURL=cache-adapter-bridge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-adapter-bridge.d.ts","sourceRoot":"","sources":["../../src/core/cache-adapter-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAE1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAEzC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAUb,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAIf"}
@@ -0,0 +1,81 @@
1
+ /**
2
+ * Bridge adapter between legacy Cache class and new CacheAdapter interface
3
+ *
4
+ * This allows the SDK to work with both:
5
+ * 1. Legacy internal Cache (synchronous, millisecond TTL)
6
+ * 2. New CacheAdapter interface (async, second TTL)
7
+ */
8
+ /**
9
+ * Wraps the legacy Cache class to implement CacheAdapter interface
10
+ */
11
+ export class LegacyCacheAdapter {
12
+ cache;
13
+ constructor(cache) {
14
+ this.cache = cache;
15
+ }
16
+ async get(key) {
17
+ const value = this.cache.get(key);
18
+ return value === undefined ? null : value;
19
+ }
20
+ async set(key, value, ttl) {
21
+ // Convert seconds to milliseconds (CacheAdapter uses seconds, Cache uses ms)
22
+ const ttlMs = ttl ? ttl * 1000 : 60000; // Default 60s
23
+ this.cache.set(key, value, ttlMs);
24
+ }
25
+ async del(key) {
26
+ this.cache.invalidate(key);
27
+ }
28
+ async exists(key) {
29
+ const value = this.cache.get(key);
30
+ return value !== undefined;
31
+ }
32
+ async clear() {
33
+ this.cache.clear();
34
+ }
35
+ }
36
+ /**
37
+ * Wraps a CacheAdapter to provide the legacy Cache interface
38
+ * This allows using new cache adapters with code expecting the old Cache class
39
+ */
40
+ export class CacheAdapterWrapper {
41
+ adapter;
42
+ constructor(adapter) {
43
+ this.adapter = adapter;
44
+ }
45
+ get(key) {
46
+ // Note: This makes an async operation sync, which may cause issues
47
+ // However, we need to maintain backward compatibility
48
+ let result;
49
+ this.adapter.get(key).then((value) => {
50
+ result = value ?? undefined;
51
+ });
52
+ return result;
53
+ }
54
+ set(key, value, ttlMs) {
55
+ // Convert milliseconds to seconds
56
+ const ttlSeconds = Math.ceil(ttlMs / 1000);
57
+ void this.adapter.set(key, value, ttlSeconds);
58
+ }
59
+ async getOrSet(key, ttlMs, factory) {
60
+ const cached = await this.adapter.get(key);
61
+ if (cached !== null)
62
+ return cached;
63
+ const value = await factory();
64
+ const ttlSeconds = Math.ceil(ttlMs / 1000);
65
+ await this.adapter.set(key, value, ttlSeconds);
66
+ return value;
67
+ }
68
+ invalidate(pattern) {
69
+ // CacheAdapter doesn't have pattern matching, so we can't implement this
70
+ // This is a limitation of the adapter approach
71
+ console.warn('invalidate(pattern) not supported with external cache adapter');
72
+ }
73
+ clear() {
74
+ void this.adapter.clear?.();
75
+ }
76
+ size() {
77
+ // CacheAdapter doesn't expose size, return -1 to indicate unknown
78
+ return -1;
79
+ }
80
+ }
81
+ //# sourceMappingURL=cache-adapter-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-adapter-bridge.js","sourceRoot":"","sources":["../../src/core/cache-adapter-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAEpC,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QACrC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,GAAY;QAC9C,6EAA6E;QAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACV;IAApB,YAAoB,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAE7C,GAAG,CAAI,GAAW;QAChB,mEAAmE;QACnE,sDAAsD;QACtD,IAAI,MAAqB,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,MAAM,GAAG,KAAK,IAAI,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAa;QACzC,kCAAkC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,KAAa,EACb,OAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAEnC,MAAM,KAAK,GAAG,MAAM,OAAO,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,yEAAyE;QACzE,+CAA+C;QAC/C,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAChF,CAAC;IAED,KAAK;QACH,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,kEAAkE;QAClE,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;CACF"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Simple in-memory cache with TTL support
3
+ */
4
+ export declare class Cache {
5
+ private store;
6
+ /**
7
+ * Get a cached value
8
+ */
9
+ get<T>(key: string): T | undefined;
10
+ /**
11
+ * Set a cached value with TTL
12
+ */
13
+ set<T>(key: string, value: T, ttlMs: number): void;
14
+ /**
15
+ * Get a cached value or set it if not present
16
+ */
17
+ getOrSet<T>(key: string, ttlMs: number, factory: () => Promise<T>): Promise<T>;
18
+ /**
19
+ * Invalidate all keys matching a pattern
20
+ */
21
+ invalidate(pattern: string): void;
22
+ /**
23
+ * Clear all cached values
24
+ */
25
+ clear(): void;
26
+ /**
27
+ * Get the number of cached entries
28
+ */
29
+ size(): number;
30
+ }
31
+ /**
32
+ * Cache TTL constants (in milliseconds)
33
+ */
34
+ export declare const CACHE_TTL: {
35
+ MARKET_INFO: number;
36
+ WALLET_POSITIONS: number;
37
+ LEADERBOARD: number;
38
+ TICK_SIZE: number;
39
+ };
40
+ //# sourceMappingURL=cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAA+C;IAE5D;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOlD;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAQb;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;CAKrB,CAAC"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Simple in-memory cache with TTL support
3
+ */
4
+ export class Cache {
5
+ store = new Map();
6
+ /**
7
+ * Get a cached value
8
+ */
9
+ get(key) {
10
+ const entry = this.store.get(key);
11
+ if (!entry)
12
+ return undefined;
13
+ if (Date.now() > entry.expiresAt) {
14
+ this.store.delete(key);
15
+ return undefined;
16
+ }
17
+ return entry.value;
18
+ }
19
+ /**
20
+ * Set a cached value with TTL
21
+ */
22
+ set(key, value, ttlMs) {
23
+ this.store.set(key, {
24
+ value,
25
+ expiresAt: Date.now() + ttlMs,
26
+ });
27
+ }
28
+ /**
29
+ * Get a cached value or set it if not present
30
+ */
31
+ async getOrSet(key, ttlMs, factory) {
32
+ const cached = this.get(key);
33
+ if (cached !== undefined)
34
+ return cached;
35
+ const value = await factory();
36
+ this.set(key, value, ttlMs);
37
+ return value;
38
+ }
39
+ /**
40
+ * Invalidate all keys matching a pattern
41
+ */
42
+ invalidate(pattern) {
43
+ for (const key of this.store.keys()) {
44
+ if (key.includes(pattern)) {
45
+ this.store.delete(key);
46
+ }
47
+ }
48
+ }
49
+ /**
50
+ * Clear all cached values
51
+ */
52
+ clear() {
53
+ this.store.clear();
54
+ }
55
+ /**
56
+ * Get the number of cached entries
57
+ */
58
+ size() {
59
+ return this.store.size;
60
+ }
61
+ }
62
+ /**
63
+ * Cache TTL constants (in milliseconds)
64
+ */
65
+ export const CACHE_TTL = {
66
+ MARKET_INFO: 60 * 1000, // 1 minute
67
+ WALLET_POSITIONS: 5 * 60 * 1000, // 5 minutes
68
+ LEADERBOARD: 60 * 60 * 1000, // 1 hour
69
+ TICK_SIZE: 24 * 60 * 60 * 1000, // 24 hours
70
+ };
71
+ //# sourceMappingURL=cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,OAAO,KAAK;IACR,KAAK,GAAqC,IAAI,GAAG,EAAE,CAAC;IAE5D;;OAEG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAa;QACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,KAAa,EACb,OAAyB;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,WAAW;IACnC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAC7C,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IACtC,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;CAC5C,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Unified error handling for Polymarket SDK
3
+ */
4
+ export declare enum ErrorCode {
5
+ NETWORK_ERROR = "NETWORK_ERROR",
6
+ TIMEOUT = "TIMEOUT",
7
+ RATE_LIMITED = "RATE_LIMITED",
8
+ AUTH_FAILED = "AUTH_FAILED",
9
+ API_KEY_EXPIRED = "API_KEY_EXPIRED",
10
+ INVALID_SIGNATURE = "INVALID_SIGNATURE",
11
+ MARKET_NOT_FOUND = "MARKET_NOT_FOUND",
12
+ WALLET_NOT_FOUND = "WALLET_NOT_FOUND",
13
+ INVALID_RESPONSE = "INVALID_RESPONSE",
14
+ INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
15
+ ORDER_REJECTED = "ORDER_REJECTED",
16
+ ORDER_FAILED = "ORDER_FAILED",
17
+ MARKET_CLOSED = "MARKET_CLOSED",
18
+ API_ERROR = "API_ERROR",
19
+ INTERNAL_ERROR = "INTERNAL_ERROR"
20
+ }
21
+ export declare class PolymarketError extends Error {
22
+ code: ErrorCode;
23
+ retryable: boolean;
24
+ originalError?: Error | undefined;
25
+ constructor(code: ErrorCode, message: string, retryable?: boolean, originalError?: Error | undefined);
26
+ /**
27
+ * Create error from HTTP response status
28
+ */
29
+ static fromHttpError(status: number, body?: unknown): PolymarketError;
30
+ }
31
+ /**
32
+ * Retry decorator for async functions
33
+ */
34
+ export declare function withRetry<T>(fn: () => Promise<T>, options?: {
35
+ maxRetries?: number;
36
+ delay?: number;
37
+ }): Promise<T>;
38
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IAEnB,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAG7B,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IAGvC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IAGrC,oBAAoB,yBAAyB;IAC7C,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAG/B,SAAS,cAAc;IAGvB,cAAc,mBAAmB;CAClC;AAED,qBAAa,eAAgB,SAAQ,KAAK;IAE/B,IAAI,EAAE,SAAS;IAEf,SAAS,EAAE,OAAO;IAClB,aAAa,CAAC,EAAE,KAAK;gBAHrB,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,SAAS,GAAE,OAAe,EAC1B,aAAa,CAAC,EAAE,KAAK,YAAA;IAM9B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,eAAe;CAyCtE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,CAAC,CAAC,CAoBZ"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * Unified error handling for Polymarket SDK
3
+ */
4
+ export var ErrorCode;
5
+ (function (ErrorCode) {
6
+ // Network errors
7
+ ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
8
+ ErrorCode["TIMEOUT"] = "TIMEOUT";
9
+ ErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
10
+ // Authentication errors
11
+ ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
12
+ ErrorCode["API_KEY_EXPIRED"] = "API_KEY_EXPIRED";
13
+ ErrorCode["INVALID_SIGNATURE"] = "INVALID_SIGNATURE";
14
+ // Data errors
15
+ ErrorCode["MARKET_NOT_FOUND"] = "MARKET_NOT_FOUND";
16
+ ErrorCode["WALLET_NOT_FOUND"] = "WALLET_NOT_FOUND";
17
+ ErrorCode["INVALID_RESPONSE"] = "INVALID_RESPONSE";
18
+ // Trading errors
19
+ ErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
20
+ ErrorCode["ORDER_REJECTED"] = "ORDER_REJECTED";
21
+ ErrorCode["ORDER_FAILED"] = "ORDER_FAILED";
22
+ ErrorCode["MARKET_CLOSED"] = "MARKET_CLOSED";
23
+ // API errors
24
+ ErrorCode["API_ERROR"] = "API_ERROR";
25
+ // Internal errors
26
+ ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
27
+ })(ErrorCode || (ErrorCode = {}));
28
+ export class PolymarketError extends Error {
29
+ code;
30
+ retryable;
31
+ originalError;
32
+ constructor(code, message, retryable = false, originalError) {
33
+ super(message);
34
+ this.code = code;
35
+ this.retryable = retryable;
36
+ this.originalError = originalError;
37
+ this.name = 'PolymarketError';
38
+ }
39
+ /**
40
+ * Create error from HTTP response status
41
+ */
42
+ static fromHttpError(status, body) {
43
+ const bodyMessage = body && typeof body === 'object' && 'message' in body
44
+ ? String(body.message)
45
+ : '';
46
+ switch (status) {
47
+ case 429:
48
+ return new PolymarketError(ErrorCode.RATE_LIMITED, bodyMessage || 'Rate limited', true);
49
+ case 401:
50
+ return new PolymarketError(ErrorCode.AUTH_FAILED, bodyMessage || 'Authentication failed');
51
+ case 403:
52
+ return new PolymarketError(ErrorCode.AUTH_FAILED, bodyMessage || 'Forbidden');
53
+ case 404:
54
+ return new PolymarketError(ErrorCode.MARKET_NOT_FOUND, bodyMessage || 'Resource not found');
55
+ case 400:
56
+ return new PolymarketError(ErrorCode.INVALID_RESPONSE, bodyMessage || 'Bad request');
57
+ default:
58
+ return new PolymarketError(ErrorCode.NETWORK_ERROR, bodyMessage || `HTTP ${status}`, status >= 500);
59
+ }
60
+ }
61
+ }
62
+ /**
63
+ * Retry decorator for async functions
64
+ */
65
+ export async function withRetry(fn, options = {}) {
66
+ const { maxRetries = 3, delay = 1000 } = options;
67
+ let lastError;
68
+ for (let i = 0; i < maxRetries; i++) {
69
+ try {
70
+ return await fn();
71
+ }
72
+ catch (error) {
73
+ lastError = error;
74
+ if (error instanceof PolymarketError && !error.retryable) {
75
+ throw error;
76
+ }
77
+ if (i < maxRetries - 1) {
78
+ await new Promise((r) => setTimeout(r, delay * Math.pow(2, i)));
79
+ }
80
+ }
81
+ }
82
+ throw lastError;
83
+ }
84
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SA2BX;AA3BD,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;AACnC,CAAC,EA3BW,SAAS,KAAT,SAAS,QA2BpB;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"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Rate Limiter for Polymarket APIs
3
+ * - Data API: 100ms minimum interval
4
+ * - Gamma API: 10 req/s
5
+ * - CLOB API: 10 req/s
6
+ */
7
+ export declare enum ApiType {
8
+ DATA_API = "data-api",
9
+ GAMMA_API = "gamma-api",
10
+ CLOB_API = "clob-api"
11
+ }
12
+ export declare class RateLimiter {
13
+ private limiters;
14
+ constructor();
15
+ /**
16
+ * Execute a function with rate limiting
17
+ */
18
+ execute<T>(api: ApiType, fn: () => Promise<T>): Promise<T>;
19
+ /**
20
+ * Execute multiple functions in order with rate limiting
21
+ */
22
+ executeBatch<T>(api: ApiType, fns: (() => Promise<T>)[]): Promise<T[]>;
23
+ /**
24
+ * Get current limiter statistics
25
+ */
26
+ getStats(api: ApiType): {
27
+ running: number;
28
+ queued: number;
29
+ } | null;
30
+ }
31
+ //# sourceMappingURL=rate-limiter.d.ts.map
@@ -0,0 +1 @@
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;CACtB;AAmBD,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"}