@catalyst-team/poly-mcp 0.1.0 → 0.1.2

package/src/tools/guide.ts

@@ -30,6 +30,7 @@ export const guideToolDefinitions: ToolDefinition[] = [
             'copy_trading',
             'deposit_and_auth',
             'trading',
+            'redeem_positions',
           ],
           description:
             'Specific scenario to get detailed guide for. Default: overview',
@@ -54,7 +55,8 @@ const OVERVIEW_GUIDE = `
 | **充值** | deposit_usdc, swap, swap_and_deposit | 资金充值和转换 |
 | **授权** | check_allowances, approve_trading | 交易授权管理 |
 | **交易** | create_order, cancel_order, get_open_orders | 执行交易 |
-| **CTF** | check_ctf_ready | 检查 CTF 准备状态 |
+| **CTF** | ctf_split, ctf_merge, ctf_redeem | 拆分/合并/赎回条件代币 |
+| **结算** | get_market_resolution, get_position_balance | 检查市场结算和仓位余额 |
 
 ## 📋 常见场景
 
@@ -116,6 +118,17 @@ get_market(conditionId) → 查看赔率和截止时间
 get_orderbook → 分析价差和深度
 \`\`\`
 
+### 7. 赎回获胜仓位 (redeem_positions) ⭐ 新增
+\`\`\`
+get_trader_positions(address) → 查找 redeemable=true 的仓位
+  ↓
+get_market(conditionId) → 获取 tokenIds
+  ↓
+get_market_resolution(conditionId) → 确认已结算
+  ↓
+ctf_redeem(conditionId, tokenIds) → 赎回获胜代币
+\`\`\`
+
 ## 💡 Pro Tips
 
 1. **总是先用 get_leaderboard** 获取聪明钱地址列表
@@ -733,6 +746,151 @@ A: 可以，但推荐授权无限额度，避免每次交易都要重新授权
 - "为什么我的 USDC 余额显示为 0？"
 `;
 
+const REDEEM_POSITIONS_GUIDE = `
+# 仓位赎回指南
+
+## 🎯 目标
+在市场结算后赎回获胜仓位，将条件代币转换为 USDC。
+
+## ⚠️ 关键概念
+
+### CLOB 仓位 vs CTF 仓位
+
+| 类型 | 来源 | 代币位置 | 赎回方式 |
+|------|------|----------|----------|
+| **CLOB** | 通过 Polymarket 订单簿交易 | ERC1155 在钱包 | \`ctf_redeem\` ✅ |
+| **CTF Split** | 通过 \`ctf_split\` 拆分 USDC | ERC1155 在钱包 | \`ctf_redeem\` ✅ |
+
+💡 **重要发现**：CLOB 仓位的代币实际上存储在你的钱包里（作为 ERC1155），
+可以使用 \`ctf_redeem\` 手动赎回！
+
+## 📋 赎回流程
+
+### Step 1: 查看可赎回仓位
+\`\`\`
+get_trader_positions(address: "0x...")
+\`\`\`
+筛选条件：
+- \`status.redeemable: true\` - 可赎回
+- \`holding.curPrice: 1\` - 获胜方（价格为 1）
+- \`holding.curPrice: 0\` - 失败方（价格为 0，无需赎回）
+
+### Step 2: 检查市场结算状态
+\`\`\`
+get_market_resolution(conditionId: "0x...")
+\`\`\`
+返回：
+- \`isResolved\`: 是否已结算
+- \`winningOutcome\`: 获胜方 (YES/NO)
+- \`payoutNumerators\`: 赔付比例
+
+### Step 3: 获取 Token IDs
+\`\`\`
+get_market(identifier: "0x...")  // conditionId 或 slug
+\`\`\`
+从返回的 \`tokens\` 数组获取：
+- \`tokens[0].tokenId\`: YES/Up token ID
+- \`tokens[1].tokenId\`: NO/Down token ID
+
+### Step 4: 执行赎回
+\`\`\`
+ctf_redeem(
+  conditionId: "0x...",
+  tokenIds: {
+    yesTokenId: "...",
+    noTokenId: "..."
+  },
+  outcome: "Yes" | "No"  // 可选，会自动检测获胜方
+)
+\`\`\`
+
+返回：
+- \`success\`: 是否成功
+- \`tokensRedeemed\`: 赎回的代币数量
+- \`usdcReceived\`: 收到的 USDC 金额
+- \`txHash\`: 交易哈希
+- \`explorerUrl\`: Polygonscan 链接
+
+## 💡 实战示例
+
+### 示例：赎回 ETH 15分钟市场获胜仓位
+
+\`\`\`
+// 1. 获取市场信息和 token IDs
+get_market(identifier: "0x85c33bef...")
+
+// 返回:
+// tokens: [
+//   { tokenId: "37845751...", outcome: "Up" },
+//   { tokenId: "94775948...", outcome: "Down" }
+// ]
+
+// 2. 检查市场结算
+get_market_resolution(conditionId: "0x85c33bef...")
+
+// 返回:
+// isResolved: true
+// winningOutcome: "NO"  (Down 赢了)
+
+// 3. 执行赎回
+ctf_redeem(
+  conditionId: "0x85c33bef...",
+  tokenIds: {
+    yesTokenId: "37845751...",
+    noTokenId: "94775948..."
+  },
+  outcome: "No"  // Down = No
+)
+
+// 返回:
+// success: true
+// tokensRedeemed: "98.195932"
+// usdcReceived: "98.195932"
+// txHash: "0xe1b35c47..."
+\`\`\`
+
+## 📊 批量赎回策略
+
+如果有多个获胜仓位需要赎回：
+
+\`\`\`
+1. 获取所有仓位
+   get_trader_positions(address)
+
+2. 筛选可赎回仓位
+   filter: redeemable=true AND curPrice=1
+
+3. 对每个仓位:
+   a. get_market → 获取 tokenIds
+   b. get_market_resolution → 确认结算
+   c. ctf_redeem → 执行赎回
+\`\`\`
+
+## ⚠️ 常见问题
+
+### Q: 为什么赎回失败？
+可能原因：
+- 市场尚未结算 → 等待结算
+- 没有获胜代币 → 检查 curPrice 是否为 1
+- Token IDs 错误 → 从 get_market 获取正确的 IDs
+
+### Q: 输掉的仓位需要赎回吗？
+不需要。失败方代币价值为 $0，无需操作。
+
+### Q: Gas 费用多少？
+Polygon 网络约 73,000 gas (~$0.01)。
+
+### Q: Polymarket 不会自动赎回吗？
+会自动赎回，但可能有延迟。手动赎回更快拿到资金。
+
+## 📝 示例问题
+
+- "帮我赎回所有获胜仓位"
+- "检查哪些仓位可以赎回"
+- "这个市场结算了吗？"
+- "帮我赎回 ETH 12:00PM 的仓位"
+`;
+
 const TRADING_GUIDE = `
 # 交易操作指南
 
@@ -806,6 +964,7 @@ export function createGuideHandlers(): Record<string, GuideHandler> {
         copy_trading: COPY_TRADING_GUIDE,
         deposit_and_auth: DEPOSIT_AND_AUTH_GUIDE,
         trading: TRADING_GUIDE,
+        redeem_positions: REDEEM_POSITIONS_GUIDE,
       };
 
       const guide = guides[scenario] || OVERVIEW_GUIDE;

package/src/tools/index.ts

@@ -12,8 +12,11 @@ export {
   traderToolDefinitions,
   handleGetTraderPositions,
   handleGetTraderTrades,
+  handleGetTraderActivity,
   handleGetTraderProfile,
   handleGetLeaderboard,
+  handleGetClosedPositions,
+  handleGetAccountValue,
 } from './trader.js';
 
 export {
@@ -22,6 +25,12 @@ export {
   handleSearchMarkets,
   handleGetTrendingMarkets,
   handleGetMarketTrades,
+  handleGetKLines,
+  handleGetPriceHistory,
+  handleDetectArbitrage,
+  handleDetectMarketSignals,
+  handleGetRealtimeSpread,
+  handleScanCryptoShortTermMarkets,
 } from './market.js';
 
 export {
@@ -37,10 +46,20 @@ export {
   handlePlaceMarketOrder,
   handleCancelOrder,
   handleGetMyOrders,
+  handleCancelAllOrders,
+  handleGetMyTrades,
+  handleGetEarnings,
+  handleGetCurrentRewards,
+  handleCheckOrderScoring,
 } from './trade.js';
 
 export {
   walletToolDefinitions,
+  // Wallet management handlers
+  handleListWallets,
+  handleGetActiveWallet,
+  handleSetActiveWallet,
+  // Deposit and swap handlers
   handleGetSupportedAssets,
   handleGetDepositAddresses,
   handleDepositUsdc,
@@ -54,6 +73,44 @@ export {
   handleGetAvailablePools,
 } from './wallet.js';
 
+export {
+  onchainToolDefinitions,
+  handleCtfSplit,
+  handleCtfMerge,
+  handleCtfRedeem,
+  handleGetPositionBalance,
+  handleGetMarketResolution,
+  handleCheckCtfReady,
+  handleEstimateGas,
+  handleGetGasPrice,
+} from './onchain.js';
+
+export {
+  walletClassificationToolDefinitions,
+  handleGetTagDefinitions,
+  handleAddTagDefinition,
+  handleGetWalletClassification,
+  handleClassifyWallet,
+  handleGetWalletsByTag,
+  handleRemoveWalletTag,
+} from './wallet-classification.js';
+
+export {
+  insiderDetectionToolDefinitions,
+  handleAnalyzeWalletInsider,
+  handleScanInsiderWallets,
+  handleGetInsiderCandidates,
+  handleGetPoliticalMarkets,
+} from './insider-detection.js';
+
+export {
+  insiderSignalsToolDefinitions,
+  handleGetInsiderSignals,
+  handleGetInsiderSignalCount,
+  handleMarkInsiderSignalRead,
+  handleMarkAllInsiderSignalsRead,
+} from './insider-signals.js';
+
 // Combined tool definitions
 import { guideToolDefinitions } from './guide.js';
 import { traderToolDefinitions } from './trader.js';
@@ -61,6 +118,10 @@ import { marketToolDefinitions } from './market.js';
 import { orderToolDefinitions } from './order.js';
 import { tradeToolDefinitions } from './trade.js';
 import { walletToolDefinitions } from './wallet.js';
+import { onchainToolDefinitions } from './onchain.js';
+import { walletClassificationToolDefinitions } from './wallet-classification.js';
+import { insiderDetectionToolDefinitions } from './insider-detection.js';
+import { insiderSignalsToolDefinitions } from './insider-signals.js';
 
 // Guide tool FIRST so AI sees it prominently
 export const allToolDefinitions = [
@@ -70,4 +131,8 @@ export const allToolDefinitions = [
   ...orderToolDefinitions,
   ...tradeToolDefinitions,
   ...walletToolDefinitions,
+  ...onchainToolDefinitions,
+  ...walletClassificationToolDefinitions,
+  ...insiderDetectionToolDefinitions,
+  ...insiderSignalsToolDefinitions,
 ];