@michaleffffff/mcp-trading-server 3.0.4 → 3.0.7

package/dist/tools/getPositions.js

@@ -1,77 +0,0 @@
-import { resolveClient } from "../auth/resolveClient.js";
-import { getPositions } from "../services/positionService.js";
-import { getDirectionDesc } from "../utils/mappings.js";
-export const getPositionsTool = {
-    name: "get_positions",
-    description: "Get all open positions for the current account.",
-    schema: {},
-    handler: async () => {
-        try {
-            const { client, address, chainId } = await resolveClient();
-            const data = await getPositions(client, address);
-            const positions = Array.isArray(data) ? data : (Array.isArray(data?.data) ? data.data : []);
-            if (positions.length === 0) {
-                return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: [] }) }] };
-            }
-            // 1. Fetch Tickers for all relevant pools
-            const poolIds = [...new Set(positions.map((p) => p.poolId))];
-            const tickersRes = await client.markets.getTickerList({ chainId, poolIds });
-            const tickers = Array.isArray(tickersRes) ? tickersRes : (tickersRes?.data ?? []);
-            // 2. Fetch Pool Level Configs to get MM (Maintenance Margin Rate)
-            const configs = await Promise.all(poolIds.map(async (pid) => {
-                try {
-                    const res = await client.markets.getPoolLevelConfig(pid, chainId);
-                    return { poolId: pid, config: res?.levelConfig || res?.data?.levelConfig };
-                }
-                catch {
-                    return { poolId: pid, config: null };
-                }
-            }));
-            const enhancedData = positions.map((pos) => {
-                const ticker = tickers.find((t) => t.poolId === pos.poolId);
-                const currentPrice = Number(ticker?.price || 0);
-                const entryPrice = Number(pos.entryPrice || 0);
-                const size = Number(pos.size || 0);
-                const collateral = Number(pos.collateralAmount || 0);
-                const direction = pos.direction; // 0 = LONG, 1 = SHORT
-                const mm = configs.find(c => c.poolId === pos.poolId)?.config?.maintainCollateralRate || 0.02;
-                // Estimated PnL
-                let estimatedPnl = 0;
-                if (direction === 0) { // LONG
-                    estimatedPnl = (currentPrice - entryPrice) * size;
-                }
-                else { // SHORT
-                    estimatedPnl = (entryPrice - currentPrice) * size;
-                }
-                // ROI
-                const roi = collateral > 0 ? (estimatedPnl / collateral) * 100 : 0;
-                // Liquidation Price
-                // Long: (Entry * Size - Collateral) / (Size * (1 - MM))
-                // Short: (Entry * Size + Collateral) / (Size * (1 + MM))
-                let liqPrice = 0;
-                if (size > 0) {
-                    if (direction === 0) {
-                        liqPrice = (entryPrice * size - collateral) / (size * (1 - mm));
-                    }
-                    else {
-                        liqPrice = (entryPrice * size + collateral) / (size * (1 + mm));
-                    }
-                }
-                if (liqPrice < 0)
-                    liqPrice = 0;
-                return {
-                    ...pos,
-                    directionDesc: getDirectionDesc(pos.direction),
-                    currentPrice: currentPrice.toString(),
-                    estimatedPnl: estimatedPnl.toFixed(4),
-                    roi: roi.toFixed(2) + "%",
-                    liquidationPrice: liqPrice.toFixed(4)
-                };
-            });
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: enhancedData }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};

package/dist/tools/marketInfo.js

@@ -1,88 +0,0 @@
-import { z } from "zod";
-import { resolveClient, getChainId } from "../auth/resolveClient.js";
-import { getMarketDetail, resolvePool } from "../services/marketService.js";
-import { getPoolInfo, getLiquidityInfo } from "../services/poolService.js";
-import { extractErrorMessage } from "../utils/errorMessage.js";
-import { parseUserPrice30 } from "../utils/units.js";
-const INTEGER_RE = /^\d+$/;
-const DECIMAL_RE = /^\d+(\.\d+)?$/;
-function normalizeMarketPrice30Input(value) {
-    const text = String(value ?? "").trim();
-    if (!text)
-        throw new Error("marketPrice is required.");
-    // Keep backward compatibility: plain integers are treated as already-raw 30-dec units.
-    if (INTEGER_RE.test(text))
-        return text;
-    if (!DECIMAL_RE.test(text) && !/^raw:/i.test(text) && !/^human:/i.test(text)) {
-        throw new Error("marketPrice must be numeric, or prefixed with raw:/human:.");
-    }
-    return parseUserPrice30(text, "marketPrice");
-}
-export const getMarketDetailTool = {
-    name: "get_market_detail",
-    description: "Get detailed information for a specific trading pool (fee rates, open interest, etc.). Supports PoolId, Token Address, or Keywords.",
-    schema: {
-        poolId: z.string().describe("Pool ID, Token Address, or Keyword"),
-        chainId: z.number().int().positive().optional().describe("Optional chainId override"),
-    },
-    handler: async (args) => {
-        try {
-            const { client } = await resolveClient();
-            const poolId = await resolvePool(client, args.poolId);
-            const chainId = args.chainId ?? getChainId();
-            const data = await getMarketDetail(client, poolId, chainId);
-            if (!data)
-                throw new Error(`Market detail for ${poolId} not found.`);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${extractErrorMessage(error)}` }], isError: true };
-        }
-    },
-};
-export const getPoolInfoTool = {
-    name: "get_pool_info",
-    description: "Get pool on-chain information (reserves, utilization, etc.). Supports PoolId, Token Address, or Keywords.",
-    schema: {
-        poolId: z.string().describe("Pool ID, Token Address, or Keyword"),
-        chainId: z.number().int().positive().optional().describe("Optional chainId override"),
-    },
-    handler: async (args) => {
-        try {
-            const { client } = await resolveClient();
-            const poolId = await resolvePool(client, args.poolId);
-            const chainId = args.chainId ?? getChainId();
-            const data = await getPoolInfo(poolId, chainId, client);
-            if (!data)
-                throw new Error(`Pool info for ${poolId} returned undefined. The pool may not exist on chainId ${chainId}.`);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${extractErrorMessage(error)}` }], isError: true };
-        }
-    },
-};
-export const getLiquidityInfoTool = {
-    name: "get_liquidity_info",
-    description: "Get pool liquidity utilization and depth information. Supports PoolId, Token Address, or Keywords.",
-    schema: {
-        poolId: z.string().describe("Pool ID, Token Address, or Keyword"),
-        marketPrice: z.union([z.string(), z.number()]).describe("Current market price. Supports raw 30-dec integer, raw:..., or human price like 2172.5 / human:2172.5."),
-        chainId: z.number().int().positive().optional().describe("Optional chainId override"),
-    },
-    handler: async (args) => {
-        try {
-            const { client } = await resolveClient();
-            const poolId = await resolvePool(client, args.poolId);
-            const chainId = args.chainId ?? getChainId();
-            const marketPrice = normalizeMarketPrice30Input(args.marketPrice);
-            const data = await getLiquidityInfo(client, poolId, marketPrice, chainId);
-            if (!data)
-                throw new Error(`Liquidity info for ${poolId} not available.`);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${extractErrorMessage(error)}` }], isError: true };
-        }
-    },
-};

package/dist/tools/orderQueries.js

@@ -1,51 +0,0 @@
-import { z } from "zod";
-import { resolveClient, getChainId } from "../auth/resolveClient.js";
-import { getOrderTypeDesc, getOrderStatusDesc, getDirectionDesc, getHistoryOrderStatusDesc, getExecTypeDesc } from "../utils/mappings.js";
-export const getOpenOrdersTool = {
-    name: "get_open_orders",
-    description: "List all currently open/pending orders.",
-    schema: {},
-    handler: async () => {
-        try {
-            const { client, address } = await resolveClient();
-            const result = await client.order.getOrders(address);
-            const enhancedData = (result?.data || []).map((order) => ({
-                ...order,
-                orderTypeDesc: getOrderTypeDesc(order.orderType),
-                statusDesc: getOrderStatusDesc(order.status),
-                directionDesc: getDirectionDesc(order.direction)
-            }));
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: enhancedData }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};
-export const getOrderHistoryTool = {
-    name: "get_order_history",
-    description: "Get historical orders with optional pool filter.",
-    schema: {
-        poolId: z.string().optional().describe("Filter by pool ID"),
-        limit: z.number().int().positive().optional().describe("Results per page (default 20)"),
-    },
-    handler: async (args) => {
-        try {
-            const { client, address } = await resolveClient();
-            const chainId = getChainId();
-            const query = { chainId, poolId: args.poolId, limit: args.limit ?? 20 };
-            const result = await client.order.getOrderHistory(query, address);
-            const enhancedData = (result?.data || []).map((order) => ({
-                ...order,
-                orderTypeDesc: getOrderTypeDesc(order.orderType),
-                orderStatusDesc: getHistoryOrderStatusDesc(order.orderStatus),
-                directionDesc: getDirectionDesc(order.direction),
-                execTypeDesc: getExecTypeDesc(order.execType)
-            }));
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: { ...result, data: enhancedData } }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};

package/dist/tools/poolConfig.js

@@ -1,22 +0,0 @@
-import { z } from "zod";
-import { resolveClient, getChainId } from "../auth/resolveClient.js";
-import { getPoolLevelConfig } from "../services/marketService.js";
-export const getPoolLevelConfigTool = {
-    name: "get_pool_level_config",
-    description: "Get the level configuration and trading limits for a specific pool.",
-    schema: {
-        poolId: z.string().describe("Pool ID"),
-        chainId: z.number().int().positive().optional().describe("Optional chainId override"),
-    },
-    handler: async (args) => {
-        try {
-            const { client } = await resolveClient();
-            const chainId = args.chainId ?? getChainId();
-            const result = await getPoolLevelConfig(client, args.poolId, chainId);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};

package/dist/tools/positionHistory.js

@@ -1,28 +0,0 @@
-import { z } from "zod";
-import { resolveClient, getChainId } from "../auth/resolveClient.js";
-import { getDirectionDesc, getCloseTypeDesc } from "../utils/mappings.js";
-export const getPositionHistoryTool = {
-    name: "get_position_history",
-    description: "Get historical closed positions with optional pool filter.",
-    schema: {
-        poolId: z.string().optional().describe("Filter by pool ID"),
-        limit: z.number().int().positive().optional().describe("Results per page (default 20)"),
-    },
-    handler: async (args) => {
-        try {
-            const { client, address } = await resolveClient();
-            const chainId = getChainId();
-            const query = { chainId, poolId: args.poolId, limit: args.limit ?? 20 };
-            const result = await client.position.getPositionHistory(query, address);
-            const enhancedData = (result?.data || []).map((pos) => ({
-                ...pos,
-                directionDesc: getDirectionDesc(pos.direction),
-                closeTypeDesc: getCloseTypeDesc(pos.closeType)
-            }));
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: { ...result, data: enhancedData } }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};

package/dist/tools/searchMarket.js

@@ -1,21 +0,0 @@
-import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
-import { searchMarket } from "../services/marketService.js";
-export const searchMarketTool = {
-    name: "search_market",
-    description: "Search active markets by keyword. Leave keyword empty to list active markets.",
-    schema: {
-        keyword: z.string().optional().describe('Search keyword, e.g. "BTC", "ETH". Leave empty to return active markets.'),
-        limit: z.number().int().positive().optional().describe("Max results (default 100)"),
-    },
-    handler: async (args) => {
-        try {
-            const { client } = await resolveClient();
-            const activeMarkets = await searchMarket(client, args.keyword ?? "", args.limit ?? 100);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: activeMarkets }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};

package/dist/tools/setTpSl.js

@@ -1,50 +0,0 @@
-import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
-import { setPositionTpSl } from "../services/tradeService.js";
-import { finalizeMutationResult } from "../utils/mutationResult.js";
-import { mapDirection, mapTriggerType } from "../utils/mappings.js";
-import { SLIPPAGE_PCT_4DP_DESC } from "../utils/slippage.js";
-export const setTpSlTool = {
-    name: "set_tp_sl",
-    description: "Create TP/SL order using SDK-native parameters.",
-    schema: {
-        poolId: z.string().describe("Hex Pool ID, e.g. '0x14a19...'. Get via get_pool_list."),
-        positionId: z.string().describe("Active Position ID. Get via get_positions."),
-        direction: z.any().describe("0=LONG, 1=SHORT, or strings like 'BUY'/'SELL'/'LONG'/'SHORT'."),
-        leverage: z.coerce.number().describe("Leverage multiplier, e.g., 10."),
-        executionFeeToken: z.string().describe("Address of token to pay gas/execution fees."),
-        tpTriggerType: z.union([z.number(), z.string()]).optional().describe("0/NONE, 1/GTE, 2/LTE. e.g. 'GTE'."),
-        slTriggerType: z.union([z.number(), z.string()]).optional().describe("0/NONE, 1/GTE, 2/LTE. e.g. 'LTE'."),
-        slippagePct: z.coerce.string().default("50").describe(`${SLIPPAGE_PCT_4DP_DESC}. Default is 50 (0.5%).`),
-        tpPrice: z.coerce.string().optional().describe("Take Profit trigger price. e.g. '2.5' or 'raw:...' (30 decimals)."),
-        tpSize: z.coerce.string().optional().describe("TP size in base tokens. Use '0' to disable."),
-        slPrice: z.coerce.string().optional().describe("Stop Loss trigger price. e.g. '2.1' or 'raw:...' (30 decimals)."),
-        slSize: z.coerce.string().optional().describe("SL size in base tokens. Use '0' to disable."),
-    },
-    handler: async (args) => {
-        try {
-            const { client, address, signer } = await resolveClient();
-            const { chainId } = await resolveClient();
-            const poolId = args.poolId;
-            // Fetch pool detail to get quoteToken for execution fee
-            const poolResponse = await client.markets.getMarketDetail({ chainId, poolId });
-            const poolData = poolResponse?.data || (poolResponse?.marketId ? poolResponse : null);
-            if (!poolData)
-                throw new Error(`Could not find pool metadata for ID: ${poolId}`);
-            // Map inputs
-            const mappedArgs = {
-                ...args,
-                direction: mapDirection(args.direction),
-                tpTriggerType: args.tpTriggerType !== undefined ? mapTriggerType(args.tpTriggerType) : undefined,
-                slTriggerType: args.slTriggerType !== undefined ? mapTriggerType(args.slTriggerType) : undefined,
-                executionFeeToken: poolData.quoteToken || args.executionFeeToken
-            };
-            const raw = await setPositionTpSl(client, address, mappedArgs);
-            const data = await finalizeMutationResult(raw, signer, "set_tp_sl");
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};

package/dist/tools/updateOrderTpSl.js

@@ -1,34 +0,0 @@
-import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
-import { updateOrderTpSl } from "../services/tradeService.js";
-import { finalizeMutationResult } from "../utils/mutationResult.js";
-import { extractErrorMessage } from "../utils/errorMessage.js";
-export const updateOrderTpSlTool = {
-    name: "update_order_tp_sl",
-    description: "Update an existing take profit or stop loss order.",
-    schema: {
-        orderId: z.string().describe("The ID of the order to update"),
-        marketId: z.string().describe("The market ID (config hash) for the order"),
-        poolId: z.string().optional().describe("Optional poolId hint for decimal resolution."),
-        size: z.union([z.string(), z.number()]).describe("Order size (raw or human-readable)"),
-        price: z.union([z.string(), z.number()]).describe("Order price (raw or human-readable, 30 decimals)"),
-        tpPrice: z.union([z.string(), z.number()]).describe("TP price (raw or human-readable, 30 decimals)"),
-        tpSize: z.union([z.string(), z.number()]).describe("TP size (raw or human-readable)"),
-        slPrice: z.union([z.string(), z.number()]).describe("SL price (raw or human-readable, 30 decimals)"),
-        slSize: z.union([z.string(), z.number()]).describe("SL size (raw or human-readable)"),
-        useOrderCollateral: z.coerce.boolean().describe("Whether to use order collateral"),
-        isTpSlOrder: z.coerce.boolean().optional().describe("Whether this is a TP/SL order"),
-        quoteToken: z.string().describe("Quote token address"),
-    },
-    handler: async (args) => {
-        try {
-            const { client, address, signer } = await resolveClient();
-            const raw = await updateOrderTpSl(client, address, args);
-            const data = await finalizeMutationResult(raw, signer, "update_order_tp_sl");
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${extractErrorMessage(error)}` }], isError: true };
-        }
-    },
-};