@catalyst-team/poly-mcp 0.1.1 → 0.1.3

package/dist/tools/onchain.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Onchain Tools - MCP tools for CTF (Conditional Token Framework) operations
+ *
+ * These tools use the OnchainService from poly-sdk:
+ * - Split: USDC -> YES + NO tokens
+ * - Merge: YES + NO tokens -> USDC
+ * - Redeem: Winning tokens -> USDC (after market resolution)
+ * - Position balance queries
+ * - Market resolution status
+ * - Gas estimation
+ *
+ * ## Token ID Auto-Discovery
+ *
+ * Polymarket CLOB markets use custom ERC-1155 token IDs that differ from
+ * standard CTF calculated positionIds. These tools auto-discover tokenIds
+ * from the CLOB API when not explicitly provided.
+ *
+ * ## Dynamic Outcome Names
+ *
+ * Markets can have different outcome names:
+ * - Yes/No (standard)
+ * - Up/Down (crypto short-term)
+ * - Team A/Team B (sports)
+ *
+ * The tools handle all outcome types dynamically.
+ */
+import { type TokenIds } from '@catalyst-team/poly-sdk';
+import type { ToolDefinition } from '../types.js';
+export declare const onchainToolDefinitions: ToolDefinition[];
+interface CtfSplitInput {
+    conditionId: string;
+    amount: string;
+}
+interface CtfMergeInput {
+    conditionId: string;
+    amount: string;
+    tokenIds?: TokenIds;
+}
+interface CtfRedeemInput {
+    conditionId: string;
+    tokenIds?: TokenIds;
+    /** Dynamic outcome name - can be Yes/No, Up/Down, Team A/B, etc. */
+    outcome?: string;
+}
+interface GetPositionBalanceInput {
+    conditionId: string;
+    tokenIds?: TokenIds;
+}
+interface GetMarketResolutionInput {
+    conditionId: string;
+}
+interface CheckCtfReadyInput {
+    amount: string;
+}
+interface EstimateGasInput {
+    operation: 'split' | 'merge';
+    conditionId: string;
+    amount: string;
+}
+/**
+ * Split USDC into YES + NO tokens
+ */
+export declare function handleCtfSplit(input: CtfSplitInput): Promise<{
+    success: boolean;
+    error: string | undefined;
+    wallet: string;
+    conditionId: string;
+    amount: string;
+    yesTokens?: undefined;
+    noTokens?: undefined;
+    txHash?: undefined;
+    gasUsed?: undefined;
+    explorerUrl?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    wallet: string;
+    conditionId: string;
+    amount: string;
+    yesTokens: string;
+    noTokens: string;
+    txHash: string;
+    gasUsed: string | undefined;
+    explorerUrl: string;
+    message: string;
+    error?: undefined;
+}>;
+/**
+ * Merge primary + secondary tokens back to USDC
+ *
+ * Automatically discovers tokenIds from CLOB API if not provided.
+ */
+export declare function handleCtfMerge(input: CtfMergeInput): Promise<{
+    success: boolean;
+    error: string;
+    wallet: string;
+    conditionId: string;
+    amount: string;
+    tokenIdsSource: "provided" | "auto-discovered" | "calculated";
+    outcomeNames: {
+        primary: string;
+        secondary: string;
+    } | undefined;
+    hint: string | undefined;
+    usdcReceived?: undefined;
+    txHash?: undefined;
+    gasUsed?: undefined;
+    explorerUrl?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    wallet: string;
+    conditionId: string;
+    amount: string;
+    usdcReceived: string;
+    txHash: string;
+    gasUsed: string | undefined;
+    explorerUrl: string;
+    tokenIdsSource: "provided" | "auto-discovered" | "calculated";
+    outcomeNames: {
+        primary: string;
+        secondary: string;
+    } | undefined;
+    message: string;
+    error?: undefined;
+    hint?: undefined;
+}>;
+/**
+ * Redeem winning tokens after market resolution
+ *
+ * Automatically discovers tokenIds from CLOB API if not provided.
+ */
+export declare function handleCtfRedeem(input: CtfRedeemInput): Promise<{
+    success: boolean;
+    error: string;
+    wallet: string;
+    conditionId: string;
+    isResolved: boolean;
+    winningOutcome?: undefined;
+    tokensRedeemed?: undefined;
+    usdcReceived?: undefined;
+    txHash?: undefined;
+    gasUsed?: undefined;
+    explorerUrl?: undefined;
+    tokenIdsSource?: undefined;
+    outcomeNames?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    wallet: string;
+    conditionId: string;
+    winningOutcome: string | undefined;
+    tokensRedeemed: string;
+    usdcReceived: string;
+    txHash: string;
+    gasUsed: string | undefined;
+    explorerUrl: string;
+    tokenIdsSource: "provided" | "auto-discovered" | "calculated";
+    outcomeNames: {
+        primary: string;
+        secondary: string;
+    } | undefined;
+    message: string;
+    error?: undefined;
+    isResolved?: undefined;
+}>;
+/**
+ * Get token balances for a market position
+ *
+ * Automatically discovers tokenIds from CLOB API if not provided.
+ */
+export declare function handleGetPositionBalance(input: GetPositionBalanceInput): Promise<{
+    wallet: string;
+    conditionId: string;
+    balances: {
+        [x: string]: string;
+    };
+    positionIds: {
+        [x: string]: string;
+    };
+    outcomeNames: {
+        primary: string;
+        secondary: string;
+    } | undefined;
+    tokenIdsSource: "provided" | "auto-discovered" | "calculated";
+    hasPosition: boolean;
+}>;
+/**
+ * Check if market is resolved
+ */
+export declare function handleGetMarketResolution(input: GetMarketResolutionInput): Promise<{
+    conditionId: string;
+    isResolved: boolean;
+    winningOutcome: string | undefined;
+    payoutNumerators: [number, number];
+    payoutDenominator: number;
+    message: string;
+}>;
+/**
+ * Check if wallet is ready for CTF trading
+ */
+export declare function handleCheckCtfReady(input: CheckCtfReadyInput): Promise<{
+    wallet: string;
+    ready: boolean;
+    balances: {
+        usdcE: string;
+        nativeUsdc: string;
+        matic: string;
+    };
+    tradingReady: boolean;
+    issues: string[];
+    suggestion: string | undefined;
+    message: string;
+}>;
+/**
+ * Estimate gas for CTF operation
+ */
+export declare function handleEstimateGas(input: EstimateGasInput): Promise<{
+    operation: "split" | "merge";
+    conditionId: string;
+    amount: string;
+    gas: {
+        gasUnits: string;
+        gasPriceGwei: string;
+        costMatic: string;
+        costUsdc: string;
+        maticPrice: number;
+    };
+    message: string;
+}>;
+/**
+ * Get current gas price
+ */
+export declare function handleGetGasPrice(): Promise<{
+    gwei: string;
+    wei: string;
+    message: string;
+}>;
+export {};
+//# sourceMappingURL=onchain.d.ts.map

package/dist/tools/onchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onchain.d.ts","sourceRoot":"","sources":["../../src/tools/onchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+ClD,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAqJlD,CAAC;AAIF,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,UAAU,uBAAuB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAqCD;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;GA2CxD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGxD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2E1D;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB;;;;;;;;;;;;;;;GAuD5E;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB;;;;;;;GAoB9E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;;;;GA8BlE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB;;;;;;;;;;;;GA2C9D;AAED;;GAEG;AACH,wBAAsB,iBAAiB;;;;GAatC"}