@catalyst-team/poly-sdk 0.1.0 → 0.2.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.
- package/LICENSE +21 -0
- package/README.en.md +538 -0
- package/README.md +357 -78
- package/docs/00-design.md +1 -1
- package/docs/02-API.md +21 -21
- package/docs/arb/test-plan.md +387 -0
- package/docs/arb/test-results.md +336 -0
- package/docs/arbitrage.md +754 -0
- package/docs/reports/smart-money-analysis-2025-12-23-cn.md +840 -0
- package/examples/13-arbitrage-service.ts +211 -0
- package/examples/README.md +1 -1
- package/package.json +19 -19
- package/scripts/arb/faze-bo3-arb.ts +385 -0
- package/scripts/arb/settle-position.ts +190 -0
- package/scripts/arb/token-rebalancer.ts +420 -0
- package/scripts/arb-tests/01-unit-tests.ts +495 -0
- package/scripts/arb-tests/02-integration-tests.ts +412 -0
- package/scripts/arb-tests/03-e2e-tests.ts +503 -0
- package/scripts/arb-tests/README.md +109 -0
- package/scripts/verify/verify-all-apis.ts +1 -1
- package/src/clients/clob-api.ts +1 -1
- package/src/clients/gamma-api.ts +1 -1
- package/src/core/cache-adapter-bridge.ts +1 -1
- package/src/core/types.ts +3 -3
- package/src/core/unified-cache.ts +1 -1
- package/src/index.ts +25 -19
- package/src/services/arbitrage-service.ts +1807 -0
- package/.env +0 -0
- package/dist/__tests__/clob-api.test.d.ts +0 -5
- package/dist/__tests__/clob-api.test.d.ts.map +0 -1
- package/dist/__tests__/clob-api.test.js +0 -240
- package/dist/__tests__/clob-api.test.js.map +0 -1
- package/dist/__tests__/integration/bridge-client.integration.test.d.ts +0 -11
- package/dist/__tests__/integration/bridge-client.integration.test.d.ts.map +0 -1
- package/dist/__tests__/integration/bridge-client.integration.test.js +0 -260
- package/dist/__tests__/integration/bridge-client.integration.test.js.map +0 -1
- package/dist/__tests__/integration/clob-api.integration.test.d.ts +0 -13
- package/dist/__tests__/integration/clob-api.integration.test.d.ts.map +0 -1
- package/dist/__tests__/integration/clob-api.integration.test.js +0 -170
- package/dist/__tests__/integration/clob-api.integration.test.js.map +0 -1
- package/dist/__tests__/integration/ctf-client.integration.test.d.ts +0 -17
- package/dist/__tests__/integration/ctf-client.integration.test.d.ts.map +0 -1
- package/dist/__tests__/integration/ctf-client.integration.test.js +0 -234
- package/dist/__tests__/integration/ctf-client.integration.test.js.map +0 -1
- package/dist/__tests__/integration/data-api.integration.test.d.ts +0 -9
- package/dist/__tests__/integration/data-api.integration.test.d.ts.map +0 -1
- package/dist/__tests__/integration/data-api.integration.test.js +0 -161
- package/dist/__tests__/integration/data-api.integration.test.js.map +0 -1
- package/dist/__tests__/integration/gamma-api.integration.test.d.ts +0 -9
- package/dist/__tests__/integration/gamma-api.integration.test.d.ts.map +0 -1
- package/dist/__tests__/integration/gamma-api.integration.test.js +0 -170
- package/dist/__tests__/integration/gamma-api.integration.test.js.map +0 -1
- package/dist/__tests__/test-utils.d.ts +0 -92
- package/dist/__tests__/test-utils.d.ts.map +0 -1
- package/dist/__tests__/test-utils.js +0 -143
- package/dist/__tests__/test-utils.js.map +0 -1
- package/dist/clients/bridge-client.d.ts +0 -388
- package/dist/clients/bridge-client.d.ts.map +0 -1
- package/dist/clients/bridge-client.js +0 -587
- package/dist/clients/bridge-client.js.map +0 -1
- package/dist/clients/clob-api.d.ts +0 -318
- package/dist/clients/clob-api.d.ts.map +0 -1
- package/dist/clients/clob-api.js +0 -388
- package/dist/clients/clob-api.js.map +0 -1
- package/dist/clients/ctf-client.d.ts +0 -473
- package/dist/clients/ctf-client.d.ts.map +0 -1
- package/dist/clients/ctf-client.js +0 -915
- package/dist/clients/ctf-client.js.map +0 -1
- package/dist/clients/data-api.d.ts +0 -134
- package/dist/clients/data-api.d.ts.map +0 -1
- package/dist/clients/data-api.js +0 -265
- package/dist/clients/data-api.js.map +0 -1
- package/dist/clients/gamma-api.d.ts +0 -401
- package/dist/clients/gamma-api.d.ts.map +0 -1
- package/dist/clients/gamma-api.js +0 -352
- package/dist/clients/gamma-api.js.map +0 -1
- package/dist/clients/trading-client.d.ts +0 -252
- package/dist/clients/trading-client.d.ts.map +0 -1
- package/dist/clients/trading-client.js +0 -543
- package/dist/clients/trading-client.js.map +0 -1
- package/dist/clients/websocket-manager.d.ts +0 -100
- package/dist/clients/websocket-manager.d.ts.map +0 -1
- package/dist/clients/websocket-manager.js +0 -193
- package/dist/clients/websocket-manager.js.map +0 -1
- package/dist/core/cache-adapter-bridge.d.ts +0 -36
- package/dist/core/cache-adapter-bridge.d.ts.map +0 -1
- package/dist/core/cache-adapter-bridge.js +0 -81
- package/dist/core/cache-adapter-bridge.js.map +0 -1
- package/dist/core/cache.d.ts +0 -40
- package/dist/core/cache.d.ts.map +0 -1
- package/dist/core/cache.js +0 -71
- package/dist/core/cache.js.map +0 -1
- package/dist/core/errors.d.ts +0 -38
- package/dist/core/errors.d.ts.map +0 -1
- package/dist/core/errors.js +0 -84
- package/dist/core/errors.js.map +0 -1
- package/dist/core/rate-limiter.d.ts +0 -31
- package/dist/core/rate-limiter.d.ts.map +0 -1
- package/dist/core/rate-limiter.js +0 -70
- package/dist/core/rate-limiter.js.map +0 -1
- package/dist/core/types.d.ts +0 -314
- package/dist/core/types.d.ts.map +0 -1
- package/dist/core/types.js +0 -19
- package/dist/core/types.js.map +0 -1
- package/dist/core/unified-cache.d.ts +0 -63
- package/dist/core/unified-cache.d.ts.map +0 -1
- package/dist/core/unified-cache.js +0 -114
- package/dist/core/unified-cache.js.map +0 -1
- package/dist/index.d.ts +0 -94
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -258
- package/dist/index.js.map +0 -1
- package/dist/mcp/errors.d.ts +0 -33
- package/dist/mcp/errors.d.ts.map +0 -1
- package/dist/mcp/errors.js +0 -86
- package/dist/mcp/errors.js.map +0 -1
- package/dist/mcp/index.d.ts +0 -62
- package/dist/mcp/index.d.ts.map +0 -1
- package/dist/mcp/index.js +0 -173
- package/dist/mcp/index.js.map +0 -1
- package/dist/mcp/server.d.ts +0 -17
- package/dist/mcp/server.d.ts.map +0 -1
- package/dist/mcp/server.js +0 -155
- package/dist/mcp/server.js.map +0 -1
- package/dist/mcp/tools/guide.d.ts +0 -12
- package/dist/mcp/tools/guide.d.ts.map +0 -1
- package/dist/mcp/tools/guide.js +0 -801
- package/dist/mcp/tools/guide.js.map +0 -1
- package/dist/mcp/tools/index.d.ts +0 -11
- package/dist/mcp/tools/index.d.ts.map +0 -1
- package/dist/mcp/tools/index.js +0 -27
- package/dist/mcp/tools/index.js.map +0 -1
- package/dist/mcp/tools/market.d.ts +0 -11
- package/dist/mcp/tools/market.d.ts.map +0 -1
- package/dist/mcp/tools/market.js +0 -314
- package/dist/mcp/tools/market.js.map +0 -1
- package/dist/mcp/tools/order.d.ts +0 -10
- package/dist/mcp/tools/order.d.ts.map +0 -1
- package/dist/mcp/tools/order.js +0 -258
- package/dist/mcp/tools/order.js.map +0 -1
- package/dist/mcp/tools/trade.d.ts +0 -38
- package/dist/mcp/tools/trade.d.ts.map +0 -1
- package/dist/mcp/tools/trade.js +0 -314
- package/dist/mcp/tools/trade.js.map +0 -1
- package/dist/mcp/tools/trader.d.ts +0 -11
- package/dist/mcp/tools/trader.d.ts.map +0 -1
- package/dist/mcp/tools/trader.js +0 -277
- package/dist/mcp/tools/trader.js.map +0 -1
- package/dist/mcp/tools/wallet.d.ts +0 -274
- package/dist/mcp/tools/wallet.d.ts.map +0 -1
- package/dist/mcp/tools/wallet.js +0 -579
- package/dist/mcp/tools/wallet.js.map +0 -1
- package/dist/mcp/types.d.ts +0 -413
- package/dist/mcp/types.d.ts.map +0 -1
- package/dist/mcp/types.js +0 -5
- package/dist/mcp/types.js.map +0 -1
- package/dist/services/authorization-service.d.ts +0 -97
- package/dist/services/authorization-service.d.ts.map +0 -1
- package/dist/services/authorization-service.js +0 -279
- package/dist/services/authorization-service.js.map +0 -1
- package/dist/services/market-service.d.ts +0 -108
- package/dist/services/market-service.d.ts.map +0 -1
- package/dist/services/market-service.js +0 -458
- package/dist/services/market-service.js.map +0 -1
- package/dist/services/realtime-service.d.ts +0 -82
- package/dist/services/realtime-service.d.ts.map +0 -1
- package/dist/services/realtime-service.js +0 -150
- package/dist/services/realtime-service.js.map +0 -1
- package/dist/services/swap-service.d.ts +0 -217
- package/dist/services/swap-service.d.ts.map +0 -1
- package/dist/services/swap-service.js +0 -695
- package/dist/services/swap-service.js.map +0 -1
- package/dist/services/wallet-service.d.ts +0 -94
- package/dist/services/wallet-service.d.ts.map +0 -1
- package/dist/services/wallet-service.js +0 -173
- package/dist/services/wallet-service.js.map +0 -1
- package/dist/utils/price-utils.d.ts +0 -153
- package/dist/utils/price-utils.d.ts.map +0 -1
- package/dist/utils/price-utils.js +0 -236
- package/dist/utils/price-utils.js.map +0 -1
- package/docs/01-mcp.md +0 -2041
- package/docs/e2e/01-trader-tools.md +0 -159
- package/docs/e2e/02-market-tools.md +0 -180
- package/docs/e2e/03-order-tools.md +0 -166
- package/docs/e2e/04-wallet-tools.md +0 -224
- package/docs/e2e/05-trading-tools.md +0 -327
- package/docs/e2e/06-integration-scenarios.md +0 -481
- package/docs/e2e/coordinator.md +0 -376
- package/scripts/truth.md +0 -440
- package/src/mcp/README.md +0 -380
- package/src/mcp/errors.ts +0 -124
- package/src/mcp/index.ts +0 -309
- package/src/mcp/server.ts +0 -183
- package/src/mcp/tools/guide.ts +0 -821
- package/src/mcp/tools/index.ts +0 -73
- package/src/mcp/tools/market.ts +0 -363
- package/src/mcp/tools/order.ts +0 -326
- package/src/mcp/tools/trade.ts +0 -417
- package/src/mcp/tools/trader.ts +0 -322
- package/src/mcp/tools/wallet.ts +0 -683
- package/src/mcp/types.ts +0 -472
package/src/index.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @
|
|
2
|
+
* @catalyst-team/poly-sdk
|
|
3
3
|
*
|
|
4
4
|
* Unified SDK for Polymarket APIs
|
|
5
5
|
* - Data API (positions, activity, trades, leaderboard)
|
|
@@ -60,8 +60,28 @@ export type { WebSocketManagerConfig, WebSocketManagerEvents } from './clients/w
|
|
|
60
60
|
export { RealtimeService } from './services/realtime-service.js';
|
|
61
61
|
export type { Subscription, MarketSubscriptionHandlers } from './services/realtime-service.js';
|
|
62
62
|
|
|
63
|
-
//
|
|
64
|
-
|
|
63
|
+
// ArbitrageService (Real-time arbitrage detection, execution, rebalancing, and settlement)
|
|
64
|
+
export { ArbitrageService } from './services/arbitrage-service.js';
|
|
65
|
+
export type {
|
|
66
|
+
ArbitrageMarketConfig,
|
|
67
|
+
ArbitrageServiceConfig,
|
|
68
|
+
ArbitrageOpportunity as ArbitrageServiceOpportunity,
|
|
69
|
+
ArbitrageExecutionResult,
|
|
70
|
+
ArbitrageServiceEvents,
|
|
71
|
+
OrderbookState,
|
|
72
|
+
BalanceState,
|
|
73
|
+
// Rebalancer types
|
|
74
|
+
RebalanceAction,
|
|
75
|
+
RebalanceResult,
|
|
76
|
+
// Settle types
|
|
77
|
+
SettleResult,
|
|
78
|
+
// Clear position types (smart settle)
|
|
79
|
+
ClearPositionResult,
|
|
80
|
+
ClearAction,
|
|
81
|
+
// Scanning types
|
|
82
|
+
ScanCriteria,
|
|
83
|
+
ScanResult,
|
|
84
|
+
} from './services/arbitrage-service.js';
|
|
65
85
|
|
|
66
86
|
// Trading
|
|
67
87
|
export { TradingClient, POLYGON_MAINNET, POLYGON_AMOY } from './clients/trading-client.js';
|
|
@@ -177,22 +197,8 @@ export {
|
|
|
177
197
|
} from './utils/price-utils.js';
|
|
178
198
|
export type { TickSize } from './utils/price-utils.js';
|
|
179
199
|
|
|
180
|
-
// NOTE:
|
|
181
|
-
// See packages/
|
|
182
|
-
|
|
183
|
-
// MCP (Model Context Protocol) Tools
|
|
184
|
-
export {
|
|
185
|
-
createMcpHandler,
|
|
186
|
-
registerMcpTools,
|
|
187
|
-
getToolDefinitions,
|
|
188
|
-
allToolDefinitions,
|
|
189
|
-
} from './mcp/index.js';
|
|
190
|
-
export type {
|
|
191
|
-
ToolHandler,
|
|
192
|
-
ToolDefinition,
|
|
193
|
-
McpErrorResponse,
|
|
194
|
-
} from './mcp/index.js';
|
|
195
|
-
export { McpToolError, ErrorCode as McpErrorCode } from './mcp/errors.js';
|
|
200
|
+
// NOTE: MCP tools have been moved to @catalyst-team/poly-mcp package
|
|
201
|
+
// See packages/poly-mcp/
|
|
196
202
|
|
|
197
203
|
// ===== Main SDK Class =====
|
|
198
204
|
|