@catalyst-team/poly-sdk 0.2.0 → 0.3.0

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 (242) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +548 -813
  3. package/README.zh-CN.md +805 -0
  4. package/dist/__tests__/clob-api.test.d.ts +5 -0
  5. package/dist/__tests__/clob-api.test.d.ts.map +1 -0
  6. package/dist/__tests__/clob-api.test.js +240 -0
  7. package/dist/__tests__/clob-api.test.js.map +1 -0
  8. package/dist/__tests__/integration/arbitrage-service.integration.test.d.ts +12 -0
  9. package/dist/__tests__/integration/arbitrage-service.integration.test.d.ts.map +1 -0
  10. package/dist/__tests__/integration/arbitrage-service.integration.test.js +267 -0
  11. package/dist/__tests__/integration/arbitrage-service.integration.test.js.map +1 -0
  12. package/dist/__tests__/integration/bridge-client.integration.test.d.ts +11 -0
  13. package/dist/__tests__/integration/bridge-client.integration.test.d.ts.map +1 -0
  14. package/dist/__tests__/integration/bridge-client.integration.test.js +260 -0
  15. package/dist/__tests__/integration/bridge-client.integration.test.js.map +1 -0
  16. package/dist/__tests__/integration/clob-api.integration.test.d.ts +13 -0
  17. package/dist/__tests__/integration/clob-api.integration.test.d.ts.map +1 -0
  18. package/dist/__tests__/integration/clob-api.integration.test.js +170 -0
  19. package/dist/__tests__/integration/clob-api.integration.test.js.map +1 -0
  20. package/dist/__tests__/integration/ctf-client.integration.test.d.ts +17 -0
  21. package/dist/__tests__/integration/ctf-client.integration.test.d.ts.map +1 -0
  22. package/dist/__tests__/integration/ctf-client.integration.test.js +234 -0
  23. package/dist/__tests__/integration/ctf-client.integration.test.js.map +1 -0
  24. package/dist/__tests__/integration/data-api.integration.test.d.ts +9 -0
  25. package/dist/__tests__/integration/data-api.integration.test.d.ts.map +1 -0
  26. package/dist/__tests__/integration/data-api.integration.test.js +164 -0
  27. package/dist/__tests__/integration/data-api.integration.test.js.map +1 -0
  28. package/dist/__tests__/integration/gamma-api.integration.test.d.ts +9 -0
  29. package/dist/__tests__/integration/gamma-api.integration.test.d.ts.map +1 -0
  30. package/dist/__tests__/integration/gamma-api.integration.test.js +170 -0
  31. package/dist/__tests__/integration/gamma-api.integration.test.js.map +1 -0
  32. package/dist/__tests__/integration/market-service.integration.test.d.ts +10 -0
  33. package/dist/__tests__/integration/market-service.integration.test.d.ts.map +1 -0
  34. package/dist/__tests__/integration/market-service.integration.test.js +173 -0
  35. package/dist/__tests__/integration/market-service.integration.test.js.map +1 -0
  36. package/dist/__tests__/integration/realtime-service-v2.integration.test.d.ts +10 -0
  37. package/dist/__tests__/integration/realtime-service-v2.integration.test.d.ts.map +1 -0
  38. package/dist/__tests__/integration/realtime-service-v2.integration.test.js +307 -0
  39. package/dist/__tests__/integration/realtime-service-v2.integration.test.js.map +1 -0
  40. package/dist/__tests__/integration/trading-service.integration.test.d.ts +10 -0
  41. package/dist/__tests__/integration/trading-service.integration.test.d.ts.map +1 -0
  42. package/dist/__tests__/integration/trading-service.integration.test.js +58 -0
  43. package/dist/__tests__/integration/trading-service.integration.test.js.map +1 -0
  44. package/dist/__tests__/test-utils.d.ts +92 -0
  45. package/dist/__tests__/test-utils.d.ts.map +1 -0
  46. package/dist/__tests__/test-utils.js +143 -0
  47. package/dist/__tests__/test-utils.js.map +1 -0
  48. package/dist/clients/bridge-client.d.ts +388 -0
  49. package/dist/clients/bridge-client.d.ts.map +1 -0
  50. package/dist/clients/bridge-client.js +587 -0
  51. package/dist/clients/bridge-client.js.map +1 -0
  52. package/dist/clients/clob-api.d.ts +391 -0
  53. package/dist/clients/clob-api.d.ts.map +1 -0
  54. package/dist/clients/clob-api.js +448 -0
  55. package/dist/clients/clob-api.js.map +1 -0
  56. package/dist/clients/ctf-client.d.ts +473 -0
  57. package/dist/clients/ctf-client.d.ts.map +1 -0
  58. package/dist/clients/ctf-client.js +915 -0
  59. package/dist/clients/ctf-client.js.map +1 -0
  60. package/dist/clients/data-api.d.ts +439 -0
  61. package/dist/clients/data-api.d.ts.map +1 -0
  62. package/dist/clients/data-api.js +592 -0
  63. package/dist/clients/data-api.js.map +1 -0
  64. package/dist/clients/gamma-api.d.ts +401 -0
  65. package/dist/clients/gamma-api.d.ts.map +1 -0
  66. package/dist/clients/gamma-api.js +352 -0
  67. package/dist/clients/gamma-api.js.map +1 -0
  68. package/dist/clients/subgraph.d.ts +196 -0
  69. package/dist/clients/subgraph.d.ts.map +1 -0
  70. package/dist/clients/subgraph.js +332 -0
  71. package/dist/clients/subgraph.js.map +1 -0
  72. package/dist/clients/trading-client.d.ts +252 -0
  73. package/dist/clients/trading-client.d.ts.map +1 -0
  74. package/dist/clients/trading-client.js +543 -0
  75. package/dist/clients/trading-client.js.map +1 -0
  76. package/dist/clients/websocket-manager.d.ts +103 -0
  77. package/dist/clients/websocket-manager.d.ts.map +1 -0
  78. package/dist/clients/websocket-manager.js +200 -0
  79. package/dist/clients/websocket-manager.js.map +1 -0
  80. package/dist/core/cache-adapter-bridge.d.ts +36 -0
  81. package/dist/core/cache-adapter-bridge.d.ts.map +1 -0
  82. package/dist/core/cache-adapter-bridge.js +81 -0
  83. package/dist/core/cache-adapter-bridge.js.map +1 -0
  84. package/dist/core/cache.d.ts +41 -0
  85. package/dist/core/cache.d.ts.map +1 -0
  86. package/dist/core/cache.js +72 -0
  87. package/dist/core/cache.js.map +1 -0
  88. package/dist/core/errors.d.ts +39 -0
  89. package/dist/core/errors.d.ts.map +1 -0
  90. package/dist/core/errors.js +86 -0
  91. package/dist/core/errors.js.map +1 -0
  92. package/dist/core/rate-limiter.d.ts +32 -0
  93. package/dist/core/rate-limiter.d.ts.map +1 -0
  94. package/dist/core/rate-limiter.js +75 -0
  95. package/dist/core/rate-limiter.js.map +1 -0
  96. package/dist/core/types.d.ts +402 -0
  97. package/dist/core/types.d.ts.map +1 -0
  98. package/dist/core/types.js +19 -0
  99. package/dist/core/types.js.map +1 -0
  100. package/dist/core/types.test.d.ts +7 -0
  101. package/dist/core/types.test.d.ts.map +1 -0
  102. package/dist/core/types.test.js +122 -0
  103. package/dist/core/types.test.js.map +1 -0
  104. package/dist/core/unified-cache.d.ts +63 -0
  105. package/dist/core/unified-cache.d.ts.map +1 -0
  106. package/dist/core/unified-cache.js +114 -0
  107. package/dist/core/unified-cache.js.map +1 -0
  108. package/dist/index.d.ts +151 -0
  109. package/dist/index.d.ts.map +1 -0
  110. package/dist/index.js +248 -0
  111. package/dist/index.js.map +1 -0
  112. package/dist/services/arbitrage-service.d.ts +409 -0
  113. package/dist/services/arbitrage-service.d.ts.map +1 -0
  114. package/dist/services/arbitrage-service.js +1440 -0
  115. package/dist/services/arbitrage-service.js.map +1 -0
  116. package/dist/services/authorization-service.d.ts +97 -0
  117. package/dist/services/authorization-service.d.ts.map +1 -0
  118. package/dist/services/authorization-service.js +279 -0
  119. package/dist/services/authorization-service.js.map +1 -0
  120. package/dist/services/market-service.d.ts +208 -0
  121. package/dist/services/market-service.d.ts.map +1 -0
  122. package/dist/services/market-service.js +774 -0
  123. package/dist/services/market-service.js.map +1 -0
  124. package/dist/services/onchain-service.d.ts +309 -0
  125. package/dist/services/onchain-service.d.ts.map +1 -0
  126. package/dist/services/onchain-service.js +417 -0
  127. package/dist/services/onchain-service.js.map +1 -0
  128. package/dist/services/realtime-service-v2.d.ts +361 -0
  129. package/dist/services/realtime-service-v2.d.ts.map +1 -0
  130. package/dist/services/realtime-service-v2.js +840 -0
  131. package/dist/services/realtime-service-v2.js.map +1 -0
  132. package/dist/services/realtime-service.d.ts +82 -0
  133. package/dist/services/realtime-service.d.ts.map +1 -0
  134. package/dist/services/realtime-service.js +182 -0
  135. package/dist/services/realtime-service.js.map +1 -0
  136. package/dist/services/smart-money-service.d.ts +196 -0
  137. package/dist/services/smart-money-service.d.ts.map +1 -0
  138. package/dist/services/smart-money-service.js +358 -0
  139. package/dist/services/smart-money-service.js.map +1 -0
  140. package/dist/services/swap-service.d.ts +217 -0
  141. package/dist/services/swap-service.d.ts.map +1 -0
  142. package/dist/services/swap-service.js +695 -0
  143. package/dist/services/swap-service.js.map +1 -0
  144. package/dist/services/trading-service.d.ts +156 -0
  145. package/dist/services/trading-service.d.ts.map +1 -0
  146. package/dist/services/trading-service.js +356 -0
  147. package/dist/services/trading-service.js.map +1 -0
  148. package/dist/services/wallet-service.d.ts +275 -0
  149. package/dist/services/wallet-service.d.ts.map +1 -0
  150. package/dist/services/wallet-service.js +630 -0
  151. package/dist/services/wallet-service.js.map +1 -0
  152. package/dist/utils/price-utils.d.ts +153 -0
  153. package/dist/utils/price-utils.d.ts.map +1 -0
  154. package/dist/utils/price-utils.js +236 -0
  155. package/dist/utils/price-utils.js.map +1 -0
  156. package/dist/utils/price-utils.test.d.ts +5 -0
  157. package/dist/utils/price-utils.test.d.ts.map +1 -0
  158. package/dist/utils/price-utils.test.js +192 -0
  159. package/dist/utils/price-utils.test.js.map +1 -0
  160. package/package.json +10 -4
  161. package/README.en.md +0 -538
  162. package/docs/00-design.md +0 -760
  163. package/docs/02-API.md +0 -1148
  164. package/docs/arb/test-plan.md +0 -387
  165. package/docs/arb/test-results.md +0 -336
  166. package/docs/arbitrage.md +0 -754
  167. package/docs/reports/smart-money-analysis-2025-12-23-cn.md +0 -840
  168. package/examples/01-basic-usage.ts +0 -68
  169. package/examples/02-smart-money.ts +0 -95
  170. package/examples/03-market-analysis.ts +0 -108
  171. package/examples/04-kline-aggregation.ts +0 -158
  172. package/examples/05-follow-wallet-strategy.ts +0 -156
  173. package/examples/06-services-demo.ts +0 -124
  174. package/examples/07-realtime-websocket.ts +0 -117
  175. package/examples/08-trading-orders.ts +0 -278
  176. package/examples/09-rewards-tracking.ts +0 -187
  177. package/examples/10-ctf-operations.ts +0 -336
  178. package/examples/11-live-arbitrage-scan.ts +0 -221
  179. package/examples/12-trending-arb-monitor.ts +0 -406
  180. package/examples/13-arbitrage-service.ts +0 -211
  181. package/examples/README.md +0 -179
  182. package/scripts/README.md +0 -163
  183. package/scripts/approvals/approve-erc1155.ts +0 -129
  184. package/scripts/approvals/approve-neg-risk-erc1155.ts +0 -149
  185. package/scripts/approvals/approve-neg-risk.ts +0 -102
  186. package/scripts/approvals/check-all-allowances.ts +0 -150
  187. package/scripts/approvals/check-allowance.ts +0 -129
  188. package/scripts/approvals/check-ctf-approval.ts +0 -158
  189. package/scripts/arb/faze-bo3-arb.ts +0 -385
  190. package/scripts/arb/settle-position.ts +0 -190
  191. package/scripts/arb/token-rebalancer.ts +0 -420
  192. package/scripts/arb-tests/01-unit-tests.ts +0 -495
  193. package/scripts/arb-tests/02-integration-tests.ts +0 -412
  194. package/scripts/arb-tests/03-e2e-tests.ts +0 -503
  195. package/scripts/arb-tests/README.md +0 -109
  196. package/scripts/datas/001-report.md +0 -486
  197. package/scripts/datas/clone-modal-screenshot.png +0 -0
  198. package/scripts/deposit/deposit-native-usdc.ts +0 -179
  199. package/scripts/deposit/deposit-usdc.ts +0 -155
  200. package/scripts/deposit/swap-usdc-to-usdce.ts +0 -375
  201. package/scripts/research/research-markets.ts +0 -166
  202. package/scripts/trading/check-orders.ts +0 -50
  203. package/scripts/trading/sell-nvidia-positions.ts +0 -206
  204. package/scripts/trading/test-order.ts +0 -172
  205. package/scripts/verify/test-approve-trading.ts +0 -98
  206. package/scripts/verify/test-provider-fix.ts +0 -43
  207. package/scripts/verify/test-search-mcp.ts +0 -113
  208. package/scripts/verify/verify-all-apis.ts +0 -160
  209. package/scripts/wallet/check-wallet-balances.ts +0 -75
  210. package/scripts/wallet/test-wallet-operations.ts +0 -191
  211. package/scripts/wallet/verify-wallet-tools.ts +0 -124
  212. package/src/__tests__/clob-api.test.ts +0 -301
  213. package/src/__tests__/integration/bridge-client.integration.test.ts +0 -314
  214. package/src/__tests__/integration/clob-api.integration.test.ts +0 -218
  215. package/src/__tests__/integration/ctf-client.integration.test.ts +0 -331
  216. package/src/__tests__/integration/data-api.integration.test.ts +0 -194
  217. package/src/__tests__/integration/gamma-api.integration.test.ts +0 -206
  218. package/src/__tests__/test-utils.ts +0 -170
  219. package/src/clients/bridge-client.ts +0 -841
  220. package/src/clients/clob-api.ts +0 -629
  221. package/src/clients/ctf-client.ts +0 -1216
  222. package/src/clients/data-api.ts +0 -469
  223. package/src/clients/gamma-api.ts +0 -597
  224. package/src/clients/trading-client.ts +0 -749
  225. package/src/clients/websocket-manager.ts +0 -267
  226. package/src/core/cache-adapter-bridge.ts +0 -94
  227. package/src/core/cache.ts +0 -85
  228. package/src/core/errors.ts +0 -117
  229. package/src/core/rate-limiter.ts +0 -74
  230. package/src/core/types.ts +0 -360
  231. package/src/core/unified-cache.ts +0 -153
  232. package/src/index.ts +0 -461
  233. package/src/services/arbitrage-service.ts +0 -1807
  234. package/src/services/authorization-service.ts +0 -357
  235. package/src/services/market-service.ts +0 -544
  236. package/src/services/realtime-service.ts +0 -196
  237. package/src/services/swap-service.ts +0 -896
  238. package/src/services/wallet-service.ts +0 -259
  239. package/src/utils/price-utils.ts +0 -307
  240. package/tsconfig.json +0 -8
  241. package/vitest.config.ts +0 -19
  242. package/vitest.integration.config.ts +0 -18
@@ -0,0 +1,200 @@
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
+ * @deprecated This class uses the third-party @nevuamarkets/poly-websockets package.
34
+ * Please migrate to RealtimeServiceV2 which uses the official @polymarket/real-time-data-client.
35
+ */
36
+ async ensureInitialized() {
37
+ if (this.initialized)
38
+ return;
39
+ try {
40
+ // Dynamic import to handle the package not being installed
41
+ // Uses Function() to avoid TypeScript type checking on the module
42
+ const importModule = new Function('modulePath', 'return import(modulePath)');
43
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
44
+ const polyWs = await importModule('@nevuamarkets/poly-websockets');
45
+ this.wsManager = new polyWs.WSSubscriptionManager({
46
+ onPolymarketPriceUpdate: this.handlePriceUpdate.bind(this),
47
+ onBook: this.handleBookUpdate.bind(this),
48
+ onLastTradePrice: this.handleLastTradePrice.bind(this),
49
+ onWSOpen: this.handleOpen.bind(this),
50
+ onWSClose: this.handleClose.bind(this),
51
+ onError: this.handleError.bind(this),
52
+ }, {
53
+ maxMarketsPerWS: this.config.maxMarketsPerWS,
54
+ });
55
+ this.initialized = true;
56
+ }
57
+ catch (error) {
58
+ throw new Error('WebSocketManager requires @nevuamarkets/poly-websockets which is no longer bundled. ' +
59
+ 'Please use RealtimeServiceV2 instead, which uses the official @polymarket/real-time-data-client.');
60
+ }
61
+ }
62
+ // ===== Subscription Management =====
63
+ /**
64
+ * Subscribe to asset price updates
65
+ */
66
+ async subscribe(assetIds) {
67
+ await this.ensureInitialized();
68
+ const newIds = assetIds.filter((id) => !this.subscriptions.has(id));
69
+ if (newIds.length === 0)
70
+ return;
71
+ const manager = this.wsManager;
72
+ await manager.addSubscriptions(newIds);
73
+ newIds.forEach((id) => this.subscriptions.add(id));
74
+ }
75
+ /**
76
+ * Unsubscribe from asset price updates
77
+ */
78
+ async unsubscribe(assetIds) {
79
+ if (!this.initialized)
80
+ return;
81
+ const existingIds = assetIds.filter((id) => this.subscriptions.has(id));
82
+ if (existingIds.length === 0)
83
+ return;
84
+ const manager = this.wsManager;
85
+ await manager.removeSubscriptions(existingIds);
86
+ existingIds.forEach((id) => {
87
+ this.subscriptions.delete(id);
88
+ this.priceCache.delete(id);
89
+ this.bookCache.delete(id);
90
+ });
91
+ }
92
+ /**
93
+ * Unsubscribe from all assets and cleanup
94
+ */
95
+ async unsubscribeAll() {
96
+ if (!this.initialized)
97
+ return;
98
+ const manager = this.wsManager;
99
+ await manager.clearState();
100
+ this.subscriptions.clear();
101
+ this.priceCache.clear();
102
+ this.bookCache.clear();
103
+ }
104
+ // ===== Price Cache Access =====
105
+ /**
106
+ * Get cached price for an asset
107
+ */
108
+ getPrice(assetId) {
109
+ return this.priceCache.get(assetId);
110
+ }
111
+ /**
112
+ * Get all cached prices
113
+ */
114
+ getAllPrices() {
115
+ return new Map(this.priceCache);
116
+ }
117
+ /**
118
+ * Get cached order book for an asset
119
+ */
120
+ getBook(assetId) {
121
+ return this.bookCache.get(assetId);
122
+ }
123
+ // ===== State Query =====
124
+ /**
125
+ * Get subscribed asset IDs
126
+ */
127
+ getSubscribedAssets() {
128
+ return Array.from(this.subscriptions);
129
+ }
130
+ /**
131
+ * Get connection statistics
132
+ */
133
+ getStatistics() {
134
+ if (!this.initialized)
135
+ return null;
136
+ const manager = this.wsManager;
137
+ return manager.getStatistics();
138
+ }
139
+ /**
140
+ * Check if initialized
141
+ */
142
+ isInitialized() {
143
+ return this.initialized;
144
+ }
145
+ // ===== Event Handlers =====
146
+ async handlePriceUpdate(events) {
147
+ for (const event of events) {
148
+ const update = {
149
+ assetId: event.asset_id,
150
+ price: parseFloat(event.price),
151
+ midpoint: parseFloat(event.midpoint),
152
+ spread: parseFloat(event.spread),
153
+ timestamp: parseInt(event.timestamp, 10),
154
+ };
155
+ this.priceCache.set(event.asset_id, update);
156
+ this.emit('priceUpdate', update);
157
+ }
158
+ }
159
+ async handleBookUpdate(events) {
160
+ for (const event of events) {
161
+ // Parse and sort bids descending (highest price = best bid first)
162
+ const bids = event.bids
163
+ .map((l) => ({ price: parseFloat(l.price), size: parseFloat(l.size) }))
164
+ .sort((a, b) => b.price - a.price);
165
+ // Parse and sort asks ascending (lowest price = best ask first)
166
+ const asks = event.asks
167
+ .map((l) => ({ price: parseFloat(l.price), size: parseFloat(l.size) }))
168
+ .sort((a, b) => a.price - b.price);
169
+ const update = {
170
+ assetId: event.asset_id,
171
+ bids,
172
+ asks,
173
+ timestamp: parseInt(event.timestamp, 10),
174
+ };
175
+ this.bookCache.set(event.asset_id, update);
176
+ this.emit('bookUpdate', update);
177
+ }
178
+ }
179
+ async handleLastTradePrice(events) {
180
+ for (const event of events) {
181
+ this.emit('lastTrade', {
182
+ assetId: event.asset_id,
183
+ price: parseFloat(event.price),
184
+ side: event.side,
185
+ size: parseFloat(event.size),
186
+ timestamp: parseInt(event.timestamp, 10),
187
+ });
188
+ }
189
+ }
190
+ async handleOpen(groupId, assetIds) {
191
+ this.emit('connected', { groupId, assetIds });
192
+ }
193
+ async handleClose(groupId, code, reason) {
194
+ this.emit('disconnected', { groupId, code, reason });
195
+ }
196
+ async handleError(error) {
197
+ this.emit('error', error);
198
+ }
199
+ }
200
+ //# 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,41 @@
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
+ ACTIVITY: number;
40
+ };
41
+ //# 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;;;;;;CAMrB,CAAC"}
@@ -0,0 +1,72 @@
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
+ ACTIVITY: 2 * 60 * 1000, // 2 minutes (wallet activity data)
71
+ };
72
+ //# 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;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,mCAAmC;CAC7D,CAAC"}
@@ -0,0 +1,39 @@
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
+ INVALID_CONFIG = "INVALID_CONFIG"
21
+ }
22
+ export declare class PolymarketError extends Error {
23
+ code: ErrorCode;
24
+ retryable: boolean;
25
+ originalError?: Error | undefined;
26
+ constructor(code: ErrorCode, message: string, retryable?: boolean, originalError?: Error | undefined);
27
+ /**
28
+ * Create error from HTTP response status
29
+ */
30
+ static fromHttpError(status: number, body?: unknown): PolymarketError;
31
+ }
32
+ /**
33
+ * Retry decorator for async functions
34
+ */
35
+ export declare function withRetry<T>(fn: () => Promise<T>, options?: {
36
+ maxRetries?: number;
37
+ delay?: number;
38
+ }): Promise<T>;
39
+ //# 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;IAGjC,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,86 @@
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
+ // Configuration errors
28
+ ErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
29
+ })(ErrorCode || (ErrorCode = {}));
30
+ export class PolymarketError extends Error {
31
+ code;
32
+ retryable;
33
+ originalError;
34
+ constructor(code, message, retryable = false, originalError) {
35
+ super(message);
36
+ this.code = code;
37
+ this.retryable = retryable;
38
+ this.originalError = originalError;
39
+ this.name = 'PolymarketError';
40
+ }
41
+ /**
42
+ * Create error from HTTP response status
43
+ */
44
+ static fromHttpError(status, body) {
45
+ const bodyMessage = body && typeof body === 'object' && 'message' in body
46
+ ? String(body.message)
47
+ : '';
48
+ switch (status) {
49
+ case 429:
50
+ return new PolymarketError(ErrorCode.RATE_LIMITED, bodyMessage || 'Rate limited', true);
51
+ case 401:
52
+ return new PolymarketError(ErrorCode.AUTH_FAILED, bodyMessage || 'Authentication failed');
53
+ case 403:
54
+ return new PolymarketError(ErrorCode.AUTH_FAILED, bodyMessage || 'Forbidden');
55
+ case 404:
56
+ return new PolymarketError(ErrorCode.MARKET_NOT_FOUND, bodyMessage || 'Resource not found');
57
+ case 400:
58
+ return new PolymarketError(ErrorCode.INVALID_RESPONSE, bodyMessage || 'Bad request');
59
+ default:
60
+ return new PolymarketError(ErrorCode.NETWORK_ERROR, bodyMessage || `HTTP ${status}`, status >= 500);
61
+ }
62
+ }
63
+ }
64
+ /**
65
+ * Retry decorator for async functions
66
+ */
67
+ export async function withRetry(fn, options = {}) {
68
+ const { maxRetries = 3, delay = 1000 } = options;
69
+ let lastError;
70
+ for (let i = 0; i < maxRetries; i++) {
71
+ try {
72
+ return await fn();
73
+ }
74
+ catch (error) {
75
+ lastError = error;
76
+ if (error instanceof PolymarketError && !error.retryable) {
77
+ throw error;
78
+ }
79
+ if (i < maxRetries - 1) {
80
+ await new Promise((r) => setTimeout(r, delay * Math.pow(2, i)));
81
+ }
82
+ }
83
+ }
84
+ throw lastError;
85
+ }
86
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
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
+ SUBGRAPH = "subgraph"
12
+ }
13
+ export declare class RateLimiter {
14
+ private limiters;
15
+ constructor();
16
+ /**
17
+ * Execute a function with rate limiting
18
+ */
19
+ execute<T>(api: ApiType, fn: () => Promise<T>): Promise<T>;
20
+ /**
21
+ * Execute multiple functions in order with rate limiting
22
+ */
23
+ executeBatch<T>(api: ApiType, fns: (() => Promise<T>)[]): Promise<T[]>;
24
+ /**
25
+ * Get current limiter statistics
26
+ */
27
+ getStats(api: ApiType): {
28
+ running: number;
29
+ queued: number;
30
+ } | null;
31
+ }
32
+ //# 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;IACrB,QAAQ,aAAa;CACtB;AAuBD,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"}