@catalyst-team/poly-sdk 0.1.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 (244) hide show
  1. package/.env +0 -0
  2. package/README.md +803 -0
  3. package/dist/__tests__/clob-api.test.d.ts +5 -0
  4. package/dist/__tests__/clob-api.test.d.ts.map +1 -0
  5. package/dist/__tests__/clob-api.test.js +240 -0
  6. package/dist/__tests__/clob-api.test.js.map +1 -0
  7. package/dist/__tests__/integration/bridge-client.integration.test.d.ts +11 -0
  8. package/dist/__tests__/integration/bridge-client.integration.test.d.ts.map +1 -0
  9. package/dist/__tests__/integration/bridge-client.integration.test.js +260 -0
  10. package/dist/__tests__/integration/bridge-client.integration.test.js.map +1 -0
  11. package/dist/__tests__/integration/clob-api.integration.test.d.ts +13 -0
  12. package/dist/__tests__/integration/clob-api.integration.test.d.ts.map +1 -0
  13. package/dist/__tests__/integration/clob-api.integration.test.js +170 -0
  14. package/dist/__tests__/integration/clob-api.integration.test.js.map +1 -0
  15. package/dist/__tests__/integration/ctf-client.integration.test.d.ts +17 -0
  16. package/dist/__tests__/integration/ctf-client.integration.test.d.ts.map +1 -0
  17. package/dist/__tests__/integration/ctf-client.integration.test.js +234 -0
  18. package/dist/__tests__/integration/ctf-client.integration.test.js.map +1 -0
  19. package/dist/__tests__/integration/data-api.integration.test.d.ts +9 -0
  20. package/dist/__tests__/integration/data-api.integration.test.d.ts.map +1 -0
  21. package/dist/__tests__/integration/data-api.integration.test.js +161 -0
  22. package/dist/__tests__/integration/data-api.integration.test.js.map +1 -0
  23. package/dist/__tests__/integration/gamma-api.integration.test.d.ts +9 -0
  24. package/dist/__tests__/integration/gamma-api.integration.test.d.ts.map +1 -0
  25. package/dist/__tests__/integration/gamma-api.integration.test.js +170 -0
  26. package/dist/__tests__/integration/gamma-api.integration.test.js.map +1 -0
  27. package/dist/__tests__/test-utils.d.ts +92 -0
  28. package/dist/__tests__/test-utils.d.ts.map +1 -0
  29. package/dist/__tests__/test-utils.js +143 -0
  30. package/dist/__tests__/test-utils.js.map +1 -0
  31. package/dist/clients/bridge-client.d.ts +388 -0
  32. package/dist/clients/bridge-client.d.ts.map +1 -0
  33. package/dist/clients/bridge-client.js +587 -0
  34. package/dist/clients/bridge-client.js.map +1 -0
  35. package/dist/clients/clob-api.d.ts +318 -0
  36. package/dist/clients/clob-api.d.ts.map +1 -0
  37. package/dist/clients/clob-api.js +388 -0
  38. package/dist/clients/clob-api.js.map +1 -0
  39. package/dist/clients/ctf-client.d.ts +473 -0
  40. package/dist/clients/ctf-client.d.ts.map +1 -0
  41. package/dist/clients/ctf-client.js +915 -0
  42. package/dist/clients/ctf-client.js.map +1 -0
  43. package/dist/clients/data-api.d.ts +134 -0
  44. package/dist/clients/data-api.d.ts.map +1 -0
  45. package/dist/clients/data-api.js +265 -0
  46. package/dist/clients/data-api.js.map +1 -0
  47. package/dist/clients/gamma-api.d.ts +401 -0
  48. package/dist/clients/gamma-api.d.ts.map +1 -0
  49. package/dist/clients/gamma-api.js +352 -0
  50. package/dist/clients/gamma-api.js.map +1 -0
  51. package/dist/clients/trading-client.d.ts +252 -0
  52. package/dist/clients/trading-client.d.ts.map +1 -0
  53. package/dist/clients/trading-client.js +543 -0
  54. package/dist/clients/trading-client.js.map +1 -0
  55. package/dist/clients/websocket-manager.d.ts +100 -0
  56. package/dist/clients/websocket-manager.d.ts.map +1 -0
  57. package/dist/clients/websocket-manager.js +193 -0
  58. package/dist/clients/websocket-manager.js.map +1 -0
  59. package/dist/core/cache-adapter-bridge.d.ts +36 -0
  60. package/dist/core/cache-adapter-bridge.d.ts.map +1 -0
  61. package/dist/core/cache-adapter-bridge.js +81 -0
  62. package/dist/core/cache-adapter-bridge.js.map +1 -0
  63. package/dist/core/cache.d.ts +40 -0
  64. package/dist/core/cache.d.ts.map +1 -0
  65. package/dist/core/cache.js +71 -0
  66. package/dist/core/cache.js.map +1 -0
  67. package/dist/core/errors.d.ts +38 -0
  68. package/dist/core/errors.d.ts.map +1 -0
  69. package/dist/core/errors.js +84 -0
  70. package/dist/core/errors.js.map +1 -0
  71. package/dist/core/rate-limiter.d.ts +31 -0
  72. package/dist/core/rate-limiter.d.ts.map +1 -0
  73. package/dist/core/rate-limiter.js +70 -0
  74. package/dist/core/rate-limiter.js.map +1 -0
  75. package/dist/core/types.d.ts +314 -0
  76. package/dist/core/types.d.ts.map +1 -0
  77. package/dist/core/types.js +19 -0
  78. package/dist/core/types.js.map +1 -0
  79. package/dist/core/unified-cache.d.ts +63 -0
  80. package/dist/core/unified-cache.d.ts.map +1 -0
  81. package/dist/core/unified-cache.js +114 -0
  82. package/dist/core/unified-cache.js.map +1 -0
  83. package/dist/index.d.ts +94 -0
  84. package/dist/index.d.ts.map +1 -0
  85. package/dist/index.js +258 -0
  86. package/dist/index.js.map +1 -0
  87. package/dist/mcp/errors.d.ts +33 -0
  88. package/dist/mcp/errors.d.ts.map +1 -0
  89. package/dist/mcp/errors.js +86 -0
  90. package/dist/mcp/errors.js.map +1 -0
  91. package/dist/mcp/index.d.ts +62 -0
  92. package/dist/mcp/index.d.ts.map +1 -0
  93. package/dist/mcp/index.js +173 -0
  94. package/dist/mcp/index.js.map +1 -0
  95. package/dist/mcp/server.d.ts +17 -0
  96. package/dist/mcp/server.d.ts.map +1 -0
  97. package/dist/mcp/server.js +155 -0
  98. package/dist/mcp/server.js.map +1 -0
  99. package/dist/mcp/tools/guide.d.ts +12 -0
  100. package/dist/mcp/tools/guide.d.ts.map +1 -0
  101. package/dist/mcp/tools/guide.js +801 -0
  102. package/dist/mcp/tools/guide.js.map +1 -0
  103. package/dist/mcp/tools/index.d.ts +11 -0
  104. package/dist/mcp/tools/index.d.ts.map +1 -0
  105. package/dist/mcp/tools/index.js +27 -0
  106. package/dist/mcp/tools/index.js.map +1 -0
  107. package/dist/mcp/tools/market.d.ts +11 -0
  108. package/dist/mcp/tools/market.d.ts.map +1 -0
  109. package/dist/mcp/tools/market.js +314 -0
  110. package/dist/mcp/tools/market.js.map +1 -0
  111. package/dist/mcp/tools/order.d.ts +10 -0
  112. package/dist/mcp/tools/order.d.ts.map +1 -0
  113. package/dist/mcp/tools/order.js +258 -0
  114. package/dist/mcp/tools/order.js.map +1 -0
  115. package/dist/mcp/tools/trade.d.ts +38 -0
  116. package/dist/mcp/tools/trade.d.ts.map +1 -0
  117. package/dist/mcp/tools/trade.js +314 -0
  118. package/dist/mcp/tools/trade.js.map +1 -0
  119. package/dist/mcp/tools/trader.d.ts +11 -0
  120. package/dist/mcp/tools/trader.d.ts.map +1 -0
  121. package/dist/mcp/tools/trader.js +277 -0
  122. package/dist/mcp/tools/trader.js.map +1 -0
  123. package/dist/mcp/tools/wallet.d.ts +274 -0
  124. package/dist/mcp/tools/wallet.d.ts.map +1 -0
  125. package/dist/mcp/tools/wallet.js +579 -0
  126. package/dist/mcp/tools/wallet.js.map +1 -0
  127. package/dist/mcp/types.d.ts +413 -0
  128. package/dist/mcp/types.d.ts.map +1 -0
  129. package/dist/mcp/types.js +5 -0
  130. package/dist/mcp/types.js.map +1 -0
  131. package/dist/services/authorization-service.d.ts +97 -0
  132. package/dist/services/authorization-service.d.ts.map +1 -0
  133. package/dist/services/authorization-service.js +279 -0
  134. package/dist/services/authorization-service.js.map +1 -0
  135. package/dist/services/market-service.d.ts +108 -0
  136. package/dist/services/market-service.d.ts.map +1 -0
  137. package/dist/services/market-service.js +458 -0
  138. package/dist/services/market-service.js.map +1 -0
  139. package/dist/services/realtime-service.d.ts +82 -0
  140. package/dist/services/realtime-service.d.ts.map +1 -0
  141. package/dist/services/realtime-service.js +150 -0
  142. package/dist/services/realtime-service.js.map +1 -0
  143. package/dist/services/swap-service.d.ts +217 -0
  144. package/dist/services/swap-service.d.ts.map +1 -0
  145. package/dist/services/swap-service.js +695 -0
  146. package/dist/services/swap-service.js.map +1 -0
  147. package/dist/services/wallet-service.d.ts +94 -0
  148. package/dist/services/wallet-service.d.ts.map +1 -0
  149. package/dist/services/wallet-service.js +173 -0
  150. package/dist/services/wallet-service.js.map +1 -0
  151. package/dist/utils/price-utils.d.ts +153 -0
  152. package/dist/utils/price-utils.d.ts.map +1 -0
  153. package/dist/utils/price-utils.js +236 -0
  154. package/dist/utils/price-utils.js.map +1 -0
  155. package/docs/00-design.md +760 -0
  156. package/docs/01-mcp.md +2041 -0
  157. package/docs/02-API.md +1148 -0
  158. package/docs/e2e/01-trader-tools.md +159 -0
  159. package/docs/e2e/02-market-tools.md +180 -0
  160. package/docs/e2e/03-order-tools.md +166 -0
  161. package/docs/e2e/04-wallet-tools.md +224 -0
  162. package/docs/e2e/05-trading-tools.md +327 -0
  163. package/docs/e2e/06-integration-scenarios.md +481 -0
  164. package/docs/e2e/coordinator.md +376 -0
  165. package/examples/01-basic-usage.ts +68 -0
  166. package/examples/02-smart-money.ts +95 -0
  167. package/examples/03-market-analysis.ts +108 -0
  168. package/examples/04-kline-aggregation.ts +158 -0
  169. package/examples/05-follow-wallet-strategy.ts +156 -0
  170. package/examples/06-services-demo.ts +124 -0
  171. package/examples/07-realtime-websocket.ts +117 -0
  172. package/examples/08-trading-orders.ts +278 -0
  173. package/examples/09-rewards-tracking.ts +187 -0
  174. package/examples/10-ctf-operations.ts +336 -0
  175. package/examples/11-live-arbitrage-scan.ts +221 -0
  176. package/examples/12-trending-arb-monitor.ts +406 -0
  177. package/examples/README.md +179 -0
  178. package/package.json +62 -0
  179. package/scripts/README.md +163 -0
  180. package/scripts/approvals/approve-erc1155.ts +129 -0
  181. package/scripts/approvals/approve-neg-risk-erc1155.ts +149 -0
  182. package/scripts/approvals/approve-neg-risk.ts +102 -0
  183. package/scripts/approvals/check-all-allowances.ts +150 -0
  184. package/scripts/approvals/check-allowance.ts +129 -0
  185. package/scripts/approvals/check-ctf-approval.ts +158 -0
  186. package/scripts/datas/001-report.md +486 -0
  187. package/scripts/datas/clone-modal-screenshot.png +0 -0
  188. package/scripts/deposit/deposit-native-usdc.ts +179 -0
  189. package/scripts/deposit/deposit-usdc.ts +155 -0
  190. package/scripts/deposit/swap-usdc-to-usdce.ts +375 -0
  191. package/scripts/research/research-markets.ts +166 -0
  192. package/scripts/trading/check-orders.ts +50 -0
  193. package/scripts/trading/sell-nvidia-positions.ts +206 -0
  194. package/scripts/trading/test-order.ts +172 -0
  195. package/scripts/truth.md +440 -0
  196. package/scripts/verify/test-approve-trading.ts +98 -0
  197. package/scripts/verify/test-provider-fix.ts +43 -0
  198. package/scripts/verify/test-search-mcp.ts +113 -0
  199. package/scripts/verify/verify-all-apis.ts +160 -0
  200. package/scripts/wallet/check-wallet-balances.ts +75 -0
  201. package/scripts/wallet/test-wallet-operations.ts +191 -0
  202. package/scripts/wallet/verify-wallet-tools.ts +124 -0
  203. package/src/__tests__/clob-api.test.ts +301 -0
  204. package/src/__tests__/integration/bridge-client.integration.test.ts +314 -0
  205. package/src/__tests__/integration/clob-api.integration.test.ts +218 -0
  206. package/src/__tests__/integration/ctf-client.integration.test.ts +331 -0
  207. package/src/__tests__/integration/data-api.integration.test.ts +194 -0
  208. package/src/__tests__/integration/gamma-api.integration.test.ts +206 -0
  209. package/src/__tests__/test-utils.ts +170 -0
  210. package/src/clients/bridge-client.ts +841 -0
  211. package/src/clients/clob-api.ts +629 -0
  212. package/src/clients/ctf-client.ts +1216 -0
  213. package/src/clients/data-api.ts +469 -0
  214. package/src/clients/gamma-api.ts +597 -0
  215. package/src/clients/trading-client.ts +749 -0
  216. package/src/clients/websocket-manager.ts +267 -0
  217. package/src/core/cache-adapter-bridge.ts +94 -0
  218. package/src/core/cache.ts +85 -0
  219. package/src/core/errors.ts +117 -0
  220. package/src/core/rate-limiter.ts +74 -0
  221. package/src/core/types.ts +360 -0
  222. package/src/core/unified-cache.ts +153 -0
  223. package/src/index.ts +455 -0
  224. package/src/mcp/README.md +380 -0
  225. package/src/mcp/errors.ts +124 -0
  226. package/src/mcp/index.ts +309 -0
  227. package/src/mcp/server.ts +183 -0
  228. package/src/mcp/tools/guide.ts +821 -0
  229. package/src/mcp/tools/index.ts +73 -0
  230. package/src/mcp/tools/market.ts +363 -0
  231. package/src/mcp/tools/order.ts +326 -0
  232. package/src/mcp/tools/trade.ts +417 -0
  233. package/src/mcp/tools/trader.ts +322 -0
  234. package/src/mcp/tools/wallet.ts +683 -0
  235. package/src/mcp/types.ts +472 -0
  236. package/src/services/authorization-service.ts +357 -0
  237. package/src/services/market-service.ts +544 -0
  238. package/src/services/realtime-service.ts +196 -0
  239. package/src/services/swap-service.ts +896 -0
  240. package/src/services/wallet-service.ts +259 -0
  241. package/src/utils/price-utils.ts +307 -0
  242. package/tsconfig.json +8 -0
  243. package/vitest.config.ts +19 -0
  244. package/vitest.integration.config.ts +18 -0
@@ -0,0 +1,357 @@
1
+ /**
2
+ * Authorization Service
3
+ *
4
+ * Manages ERC20 and ERC1155 approvals required for trading on Polymarket.
5
+ *
6
+ * Required approvals for trading:
7
+ * - ERC20 (USDC): Approve USDC spending for CTF Exchange, Neg Risk Exchange, etc.
8
+ * - ERC1155 (Conditional Tokens): Approve operators for conditional token transfers
9
+ *
10
+ * @see https://docs.polymarket.com/
11
+ */
12
+
13
+ import { ethers } from 'ethers';
14
+ import {
15
+ CTF_CONTRACT,
16
+ NEG_RISK_CTF_EXCHANGE,
17
+ NEG_RISK_ADAPTER,
18
+ USDC_CONTRACT,
19
+ } from '../clients/ctf-client.js';
20
+
21
+ // Contract addresses
22
+ const CTF_EXCHANGE = '0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E';
23
+ const CONDITIONAL_TOKENS = CTF_CONTRACT;
24
+
25
+ // ABIs
26
+ const ERC20_ABI = [
27
+ 'function balanceOf(address owner) view returns (uint256)',
28
+ 'function allowance(address owner, address spender) view returns (uint256)',
29
+ 'function approve(address spender, uint256 amount) returns (bool)',
30
+ ];
31
+
32
+ const ERC1155_ABI = [
33
+ 'function setApprovalForAll(address operator, bool approved) external',
34
+ 'function isApprovedForAll(address account, address operator) view returns (bool)',
35
+ ];
36
+
37
+ // Types
38
+ export interface AllowanceInfo {
39
+ contract: string;
40
+ address: string;
41
+ approved: boolean;
42
+ allowance?: string;
43
+ }
44
+
45
+ export interface AllowancesResult {
46
+ wallet: string;
47
+ usdcBalance: string;
48
+ erc20Allowances: AllowanceInfo[];
49
+ erc1155Approvals: AllowanceInfo[];
50
+ tradingReady: boolean;
51
+ issues: string[];
52
+ }
53
+
54
+ export interface ApprovalTxResult {
55
+ contract: string;
56
+ txHash?: string;
57
+ success: boolean;
58
+ error?: string;
59
+ }
60
+
61
+ export interface ApprovalsResult {
62
+ wallet: string;
63
+ erc20Approvals: ApprovalTxResult[];
64
+ erc1155Approvals: ApprovalTxResult[];
65
+ allApproved: boolean;
66
+ summary: string;
67
+ }
68
+
69
+ export interface AuthorizationServiceConfig {
70
+ provider?: ethers.providers.Provider;
71
+ }
72
+
73
+ // Contracts that need ERC20 approval
74
+ const ERC20_SPENDERS = [
75
+ { name: 'CTF Exchange', address: CTF_EXCHANGE },
76
+ { name: 'Neg Risk CTF Exchange', address: NEG_RISK_CTF_EXCHANGE },
77
+ { name: 'Neg Risk Adapter', address: NEG_RISK_ADAPTER },
78
+ { name: 'Conditional Tokens', address: CONDITIONAL_TOKENS },
79
+ ];
80
+
81
+ // Operators that need ERC1155 approval
82
+ const ERC1155_OPERATORS = [
83
+ { name: 'CTF Exchange', address: CTF_EXCHANGE },
84
+ { name: 'Neg Risk CTF Exchange', address: NEG_RISK_CTF_EXCHANGE },
85
+ { name: 'Neg Risk Adapter', address: NEG_RISK_ADAPTER },
86
+ ];
87
+
88
+ /**
89
+ * Service for managing trading authorizations on Polymarket
90
+ *
91
+ * @example
92
+ * ```typescript
93
+ * const authService = new AuthorizationService(signer);
94
+ *
95
+ * // Check all allowances
96
+ * const status = await authService.checkAllowances();
97
+ * console.log(`Trading ready: ${status.tradingReady}`);
98
+ * if (!status.tradingReady) {
99
+ * console.log('Issues:', status.issues);
100
+ * }
101
+ *
102
+ * // Set up all approvals
103
+ * const result = await authService.approveAll();
104
+ * console.log(result.summary);
105
+ * ```
106
+ */
107
+ export class AuthorizationService {
108
+ private signer: ethers.Wallet;
109
+ private provider: ethers.providers.Provider;
110
+
111
+ constructor(signer: ethers.Wallet, config: AuthorizationServiceConfig = {}) {
112
+ this.signer = signer;
113
+ this.provider = config.provider || signer.provider || new ethers.providers.JsonRpcProvider('https://polygon-rpc.com');
114
+ }
115
+
116
+ /**
117
+ * Get the wallet address
118
+ */
119
+ get walletAddress(): string {
120
+ return this.signer.address;
121
+ }
122
+
123
+ /**
124
+ * Check all ERC20 and ERC1155 allowances required for trading
125
+ *
126
+ * @returns Status of all allowances and whether trading is ready
127
+ */
128
+ async checkAllowances(): Promise<AllowancesResult> {
129
+ const walletAddress = this.signer.address;
130
+
131
+ const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, this.provider);
132
+ const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, this.provider);
133
+
134
+ // Check USDC balance
135
+ const balance = await usdc.balanceOf(walletAddress);
136
+ const balanceFormatted = ethers.utils.formatUnits(balance, 6);
137
+
138
+ // Check ERC20 allowances
139
+ const erc20Allowances: AllowanceInfo[] = [];
140
+ for (const spender of ERC20_SPENDERS) {
141
+ const allowance = await usdc.allowance(walletAddress, spender.address);
142
+ const allowanceNum = parseFloat(ethers.utils.formatUnits(allowance, 6));
143
+ const isUnlimited = allowanceNum > 1e12;
144
+
145
+ erc20Allowances.push({
146
+ contract: spender.name,
147
+ address: spender.address,
148
+ approved: isUnlimited,
149
+ allowance: isUnlimited ? 'unlimited' : allowanceNum.toFixed(2),
150
+ });
151
+ }
152
+
153
+ // Check ERC1155 approvals
154
+ const erc1155Approvals: AllowanceInfo[] = [];
155
+ for (const operator of ERC1155_OPERATORS) {
156
+ const isApproved = await conditionalTokens.isApprovedForAll(walletAddress, operator.address);
157
+
158
+ erc1155Approvals.push({
159
+ contract: operator.name,
160
+ address: operator.address,
161
+ approved: isApproved,
162
+ });
163
+ }
164
+
165
+ // Determine issues
166
+ const issues: string[] = [];
167
+ for (const a of erc20Allowances) {
168
+ if (!a.approved) {
169
+ issues.push(`ERC20: ${a.contract} needs USDC approval`);
170
+ }
171
+ }
172
+ for (const a of erc1155Approvals) {
173
+ if (!a.approved) {
174
+ issues.push(`ERC1155: ${a.contract} needs approval for Conditional Tokens`);
175
+ }
176
+ }
177
+
178
+ const tradingReady = issues.length === 0;
179
+
180
+ return {
181
+ wallet: walletAddress,
182
+ usdcBalance: balanceFormatted,
183
+ erc20Allowances,
184
+ erc1155Approvals,
185
+ tradingReady,
186
+ issues,
187
+ };
188
+ }
189
+
190
+ /**
191
+ * Set up all required approvals for trading
192
+ *
193
+ * @returns Results of all approval transactions
194
+ */
195
+ async approveAll(): Promise<ApprovalsResult> {
196
+ const walletAddress = this.signer.address;
197
+
198
+ const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, this.signer);
199
+ const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, this.signer);
200
+
201
+ // Get gas price with buffer
202
+ const gasPrice = await this.provider.getGasPrice();
203
+ const adjustedGasPrice = gasPrice.mul(150).div(100); // 1.5x
204
+
205
+ // Process ERC20 approvals
206
+ const erc20Results: ApprovalTxResult[] = [];
207
+ for (const spender of ERC20_SPENDERS) {
208
+ // Check current allowance
209
+ const allowance = await usdc.allowance(walletAddress, spender.address);
210
+ const allowanceNum = parseFloat(ethers.utils.formatUnits(allowance, 6));
211
+
212
+ if (allowanceNum > 1e12) {
213
+ // Already approved
214
+ erc20Results.push({
215
+ contract: spender.name,
216
+ success: true,
217
+ });
218
+ continue;
219
+ }
220
+
221
+ try {
222
+ const tx = await usdc.approve(spender.address, ethers.constants.MaxUint256, {
223
+ gasPrice: adjustedGasPrice,
224
+ });
225
+ await tx.wait();
226
+ erc20Results.push({
227
+ contract: spender.name,
228
+ txHash: tx.hash,
229
+ success: true,
230
+ });
231
+ } catch (err) {
232
+ erc20Results.push({
233
+ contract: spender.name,
234
+ success: false,
235
+ error: err instanceof Error ? err.message : 'Unknown error',
236
+ });
237
+ }
238
+ }
239
+
240
+ // Process ERC1155 approvals
241
+ const erc1155Results: ApprovalTxResult[] = [];
242
+ for (const operator of ERC1155_OPERATORS) {
243
+ // Check current approval
244
+ const isApproved = await conditionalTokens.isApprovedForAll(walletAddress, operator.address);
245
+
246
+ if (isApproved) {
247
+ // Already approved
248
+ erc1155Results.push({
249
+ contract: operator.name,
250
+ success: true,
251
+ });
252
+ continue;
253
+ }
254
+
255
+ try {
256
+ const tx = await conditionalTokens.setApprovalForAll(operator.address, true, {
257
+ gasPrice: adjustedGasPrice,
258
+ gasLimit: 100000,
259
+ });
260
+ await tx.wait();
261
+ erc1155Results.push({
262
+ contract: operator.name,
263
+ txHash: tx.hash,
264
+ success: true,
265
+ });
266
+ } catch (err) {
267
+ erc1155Results.push({
268
+ contract: operator.name,
269
+ success: false,
270
+ error: err instanceof Error ? err.message : 'Unknown error',
271
+ });
272
+ }
273
+ }
274
+
275
+ const allApproved =
276
+ erc20Results.every((r) => r.success) && erc1155Results.every((r) => r.success);
277
+
278
+ const newApprovals = [...erc20Results, ...erc1155Results].filter((r) => r.txHash).length;
279
+
280
+ return {
281
+ wallet: walletAddress,
282
+ erc20Approvals: erc20Results,
283
+ erc1155Approvals: erc1155Results,
284
+ allApproved,
285
+ summary: allApproved
286
+ ? newApprovals > 0
287
+ ? `All approvals set. ${newApprovals} new approval(s) submitted.`
288
+ : 'All approvals already set. Ready to trade.'
289
+ : 'Some approvals failed. Check the results for details.',
290
+ };
291
+ }
292
+
293
+ /**
294
+ * Approve USDC spending for a specific contract
295
+ *
296
+ * @param spenderAddress - The contract address to approve
297
+ * @param amount - The amount to approve (default: unlimited)
298
+ */
299
+ async approveUsdc(
300
+ spenderAddress: string,
301
+ amount: ethers.BigNumber = ethers.constants.MaxUint256
302
+ ): Promise<ApprovalTxResult> {
303
+ const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, this.signer);
304
+ const gasPrice = await this.provider.getGasPrice();
305
+
306
+ try {
307
+ const tx = await usdc.approve(spenderAddress, amount, {
308
+ gasPrice: gasPrice.mul(150).div(100),
309
+ });
310
+ await tx.wait();
311
+ return {
312
+ contract: spenderAddress,
313
+ txHash: tx.hash,
314
+ success: true,
315
+ };
316
+ } catch (err) {
317
+ return {
318
+ contract: spenderAddress,
319
+ success: false,
320
+ error: err instanceof Error ? err.message : 'Unknown error',
321
+ };
322
+ }
323
+ }
324
+
325
+ /**
326
+ * Set approval for an ERC1155 operator
327
+ *
328
+ * @param operatorAddress - The operator address to approve
329
+ * @param approved - Whether to approve or revoke
330
+ */
331
+ async setErc1155Approval(
332
+ operatorAddress: string,
333
+ approved: boolean = true
334
+ ): Promise<ApprovalTxResult> {
335
+ const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, this.signer);
336
+ const gasPrice = await this.provider.getGasPrice();
337
+
338
+ try {
339
+ const tx = await conditionalTokens.setApprovalForAll(operatorAddress, approved, {
340
+ gasPrice: gasPrice.mul(150).div(100),
341
+ gasLimit: 100000,
342
+ });
343
+ await tx.wait();
344
+ return {
345
+ contract: operatorAddress,
346
+ txHash: tx.hash,
347
+ success: true,
348
+ };
349
+ } catch (err) {
350
+ return {
351
+ contract: operatorAddress,
352
+ success: false,
353
+ error: err instanceof Error ? err.message : 'Unknown error',
354
+ };
355
+ }
356
+ }
357
+ }