@continuumdao/ctm-mpc-defi 0.1.3 → 0.2.0

package/dist/agent/catalog.d.cts

@@ -1,7 +1,9 @@
+import * as zod from 'zod';
+import { z } from 'zod';
 import { C as ChainCategory, d as ProtocolModule, P as ParamDoc, c as ProtocolActionDescriptor } from '../types-Ce2qNHai.cjs';
 export { g as getActionsByChainCategory, b as getProtocolModules } from '../registry-BwZoE668.cjs';
 
-/** JSON-schema-like object for MCP tool `inputSchema` / `outputSchema`. */
+/** JSON-schema-like object for MCP tool `inputSchema` / `outputSchema` (derived from Zod). */
 type McpSchemaProperty = {
     type: string;
     description?: string;
@@ -20,30 +22,51 @@ type McpToolHandler = {
     /** Named export to invoke */
     exportName: string;
 };
-type McpToolDefinition = {
-    /** Stable MCP tool name (snake_case). */
+/**
+ * MCP tool definition. **Zod schemas are the source of truth** for types and runtime validation;
+ * `inputSchema` / `outputSchema` are JSON Schema snapshots for MCP server registration.
+ */
+type McpToolDefinition<TInput = unknown, TOutput = unknown> = {
     name: string;
-    /** Registry action id, e.g. uniswap-v4.quote */
     actionId: string;
     protocolId: string;
     chainCategory: ChainCategory;
-    /** Long description for the LLM — what it does, when to use it, what it does NOT do. */
     description: string;
-    /** Prerequisites (other tools or data that must exist first). */
     prerequisites: string[];
-    /** Typical next tools after this one succeeds. */
     followUp: string[];
+    inputZod: z.ZodType<TInput>;
+    outputZod: z.ZodType<TOutput>;
     inputSchema: McpJsonSchema;
     outputSchema: McpJsonSchema;
     handler: McpToolHandler;
+    parseInput: (data: unknown) => TInput;
+    parseOutput: (data: unknown) => TOutput;
+};
+
+declare const MCP_TOOL_DEFINITIONS: readonly McpToolDefinition[];
+/** Map tool name → input Zod schema (for typed dispatch in MCP servers). */
+declare const MCP_TOOL_INPUT_SCHEMAS: Record<string, z.ZodType<any, z.ZodTypeDef, any>>;
+/** Map tool name → output Zod schema. */
+declare const MCP_TOOL_OUTPUT_SCHEMAS: Record<string, z.ZodType<any, z.ZodTypeDef, any>>;
+/** Union of registered MCP tool names. */
+type McpToolName = (typeof MCP_TOOL_DEFINITIONS)[number]['name'];
+type McpToolInputMap = {
+    [K in McpToolName]: z.infer<(typeof MCP_TOOL_INPUT_SCHEMAS)[K]>;
+};
+type McpToolOutputMap = {
+    [K in McpToolName]: z.infer<(typeof MCP_TOOL_OUTPUT_SCHEMAS)[K]>;
 };
-/** Curated MCP tools with rich descriptions — use this to register MCP server tools. */
-declare const MCP_TOOL_DEFINITIONS: McpToolDefinition[];
 declare function getMcpToolDefinitions(): readonly McpToolDefinition[];
 declare function getMcpToolByName(name: string): McpToolDefinition | undefined;
+declare function getMcpToolInputSchema(name: McpToolName): z.ZodType;
+declare function getMcpToolOutputSchema(name: McpToolName): z.ZodType;
+/** Parse and validate MCP tool arguments with the registered Zod schema. */
+declare function parseMcpToolInput(name: McpToolName, data: unknown): unknown;
+/** Parse and validate MCP tool handler output. */
+declare function parseMcpToolOutput(name: McpToolName, data: unknown): unknown;
 /** Summary from protocol registry (shorter) plus full MCP tool list. */
 declare function getAgentCatalogForMcp(): {
-    tools: McpToolDefinition[];
+    tools: readonly McpToolDefinition[];
     protocols: readonly ProtocolModule[];
     commonParams: Record<string, ParamDoc>;
     multisignOutput: {
@@ -59,8 +82,37 @@ declare function getAgentCatalogForMcp(): {
             };
         };
     };
+    managementSig: {
+        readonly description: "Management POST bodies embed NodeMgtKeySig: { nonce, clientSig, nodeKey }. Sign JSON with clientSig cleared; POST with clientSig set to the Ed25519 128-hex or EIP-191 signature. Legacy Nonce/Sig/sig field names are not accepted.";
+        readonly fields: {
+            readonly nonce: {
+                readonly type: "number";
+                readonly description: "From GET /getPublicMgtKeyNonce (Ed25519) or GET /getNodeMgtKeyNonce (Ethereum NodeMgtKey).";
+            };
+            readonly clientSig: {
+                readonly type: "string";
+                readonly description: "Management signature; empty string in the message to sign.";
+            };
+            readonly nodeKey: {
+                readonly type: "string";
+                readonly description: "Required. 128-hex MPC node id from GET /getNodeKey (no 0x prefix).";
+            };
+        };
+        readonly helpers: {
+            readonly managementSigFields: "Base envelope with clientSig cleared.";
+            readonly buildManagementPostBody: "Spread managementSigFields then endpoint fields.";
+            readonly messageToSignManagementBody: "Canonical JSON string to sign.";
+            readonly withManagementClientSig: "Attach signature to POST body.";
+            readonly fetchNodeKey: "GET /getNodeKey via nodeFetchWithReadAuth.";
+            readonly fetchManagementNonce: "GET nonce for Ed25519 or Ethereum management key.";
+        };
+    };
+    /** Zod schemas for MCP tool I/O — source of truth for continuum-mcp-server validation. */
+    inputSchemas: Record<string, z.ZodType<any, z.ZodTypeDef, any>>;
+    outputSchemas: Record<string, z.ZodType<any, z.ZodTypeDef, any>>;
     workflow: {
         evmSwapTypical: string[];
+        managementPostTypical: string[];
     };
 };
 
@@ -79,6 +131,742 @@ declare const MULTISIGN_OUTPUT_DOC: {
         };
     };
 };
+/** mpc-auth NodeMgtKeySig envelope for management POST routes (Get Sig, shelve, keyGen, groups, …). */
+declare const MANAGEMENT_SIG_DOC: {
+    readonly description: "Management POST bodies embed NodeMgtKeySig: { nonce, clientSig, nodeKey }. Sign JSON with clientSig cleared; POST with clientSig set to the Ed25519 128-hex or EIP-191 signature. Legacy Nonce/Sig/sig field names are not accepted.";
+    readonly fields: {
+        readonly nonce: {
+            readonly type: "number";
+            readonly description: "From GET /getPublicMgtKeyNonce (Ed25519) or GET /getNodeMgtKeyNonce (Ethereum NodeMgtKey).";
+        };
+        readonly clientSig: {
+            readonly type: "string";
+            readonly description: "Management signature; empty string in the message to sign.";
+        };
+        readonly nodeKey: {
+            readonly type: "string";
+            readonly description: "Required. 128-hex MPC node id from GET /getNodeKey (no 0x prefix).";
+        };
+    };
+    readonly helpers: {
+        readonly managementSigFields: "Base envelope with clientSig cleared.";
+        readonly buildManagementPostBody: "Spread managementSigFields then endpoint fields.";
+        readonly messageToSignManagementBody: "Canonical JSON string to sign.";
+        readonly withManagementClientSig: "Attach signature to POST body.";
+        readonly fetchNodeKey: "GET /getNodeKey via nodeFetchWithReadAuth.";
+        readonly fetchManagementNonce: "GET nonce for Ed25519 or Ethereum management key.";
+    };
+};
+
+/**
+ * Convert a Zod schema to MCP-compatible JSON Schema (`inputSchema` / `outputSchema`).
+ * Zod is the source of truth; JSON Schema is derived for MCP server registration only.
+ */
+declare function zodSchemaToMcpJsonSchema(schema: z.ZodType): McpJsonSchema;
+
+/** EVM address (0x + 40 hex). Handlers may normalize via viem `getAddress`. */
+declare const evmAddressSchema: z.ZodString;
+/** MPC key slice for POST /multiSignRequest (pubKey, keyList). */
+declare const keyGenSchema: z.ZodObject<{
+    pubkeyhex: z.ZodString;
+    keylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ClientKeys: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    pubkeyhex: string;
+    keylist?: string[] | undefined;
+    ClientKeys?: Record<string, string> | undefined;
+}, {
+    pubkeyhex: string;
+    keylist?: string[] | undefined;
+    ClientKeys?: Record<string, string> | undefined;
+}>;
+/** Chain gas config row from GET /getChainDetails (subset). */
+declare const chainDetailSchema: z.ZodObject<{
+    legacy: z.ZodOptional<z.ZodBoolean>;
+    gasLimit: z.ZodOptional<z.ZodNumber>;
+    gasMultiplier: z.ZodOptional<z.ZodNumber>;
+    gasPrice: z.ZodOptional<z.ZodNumber>;
+    baseFee: z.ZodOptional<z.ZodNumber>;
+    priorityFee: z.ZodOptional<z.ZodNumber>;
+    baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    legacy: z.ZodOptional<z.ZodBoolean>;
+    gasLimit: z.ZodOptional<z.ZodNumber>;
+    gasMultiplier: z.ZodOptional<z.ZodNumber>;
+    gasPrice: z.ZodOptional<z.ZodNumber>;
+    baseFee: z.ZodOptional<z.ZodNumber>;
+    priorityFee: z.ZodOptional<z.ZodNumber>;
+    baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    legacy: z.ZodOptional<z.ZodBoolean>;
+    gasLimit: z.ZodOptional<z.ZodNumber>;
+    gasMultiplier: z.ZodOptional<z.ZodNumber>;
+    gasPrice: z.ZodOptional<z.ZodNumber>;
+    baseFee: z.ZodOptional<z.ZodNumber>;
+    priorityFee: z.ZodOptional<z.ZodNumber>;
+    baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Shared inputs for all EVM multisign MCP tools. */
+declare const evmMultisignCommonInputSchema: z.ZodObject<{
+    keyGen: z.ZodObject<{
+        pubkeyhex: z.ZodString;
+        keylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ClientKeys: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    }, {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    }>;
+    purposeText: z.ZodString;
+    useCustomGas: z.ZodBoolean;
+    chainId: z.ZodNumber;
+    rpcUrl: z.ZodString;
+    executorAddress: z.ZodString;
+    chainDetail: z.ZodObject<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+    customGasChainDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    keyGen: {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    };
+    purposeText: string;
+    useCustomGas: boolean;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: string;
+    chainDetail: {
+        legacy?: boolean | undefined;
+        gasLimit?: number | undefined;
+        gasPrice?: number | undefined;
+        gasMultiplier?: number | undefined;
+        baseFee?: number | undefined;
+        priorityFee?: number | undefined;
+        baseFeeMultiplier?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    customGasChainDetails?: Record<string, unknown> | undefined;
+}, {
+    keyGen: {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    };
+    purposeText: string;
+    useCustomGas: boolean;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: string;
+    chainDetail: {
+        legacy?: boolean | undefined;
+        gasLimit?: number | undefined;
+        gasPrice?: number | undefined;
+        gasMultiplier?: number | undefined;
+        baseFee?: number | undefined;
+        priorityFee?: number | undefined;
+        baseFeeMultiplier?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    customGasChainDetails?: Record<string, unknown> | undefined;
+}>;
+/** Standard output of all `build_*_multisign` MCP tools. */
+declare const multisignOutputSchema: z.ZodObject<{
+    bodyForSign: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    messageToSign: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}, {
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+/** Loose JSON object for protocol API responses passed between MCP tools. */
+declare const jsonObjectSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+type EvmMultisignCommonInput = z.infer<typeof evmMultisignCommonInputSchema>;
+type MultisignOutput = z.infer<typeof multisignOutputSchema>;
+type KeyGenMcpInput = z.infer<typeof keyGenSchema>;
+type ChainDetailMcpInput = z.infer<typeof chainDetailSchema>;
+
+declare const uniswapQuoteTradeTypeSchema: z.ZodEnum<["EXACT_INPUT", "EXACT_OUTPUT"]>;
+/** Input for MCP tool `ctm_uniswap_v4_quote` → handler `uniswapTradeQuote`. */
+declare const mcpUniswapV4QuoteInputSchema: z.ZodObject<{
+    type: z.ZodEnum<["EXACT_INPUT", "EXACT_OUTPUT"]>;
+    amount: z.ZodString;
+    tokenIn: z.ZodString;
+    tokenOut: z.ZodString;
+    chainId: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    uniswapApiKey: z.ZodString;
+    swapper: z.ZodOptional<z.ZodString>;
+    slippage: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    keyGen: z.ZodOptional<z.ZodString>;
+    managementNodeUrl: z.ZodOptional<z.ZodString>;
+    tokenInChainId: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    tokenOutChainId: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    permit2Disabled: z.ZodOptional<z.ZodBoolean>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    universalRouterVersion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    chainId: string | number;
+    type: "EXACT_INPUT" | "EXACT_OUTPUT";
+    amount: string;
+    tokenIn: string;
+    tokenOut: string;
+    uniswapApiKey: string;
+    keyGen?: string | undefined;
+    tokenInChainId?: string | number | undefined;
+    tokenOutChainId?: string | number | undefined;
+    slippage?: string | number | undefined;
+    permit2Disabled?: boolean | undefined;
+    swapper?: string | undefined;
+    managementNodeUrl?: string | undefined;
+    baseUrl?: string | undefined;
+    universalRouterVersion?: string | undefined;
+}, {
+    chainId: string | number;
+    type: "EXACT_INPUT" | "EXACT_OUTPUT";
+    amount: string;
+    tokenIn: string;
+    tokenOut: string;
+    uniswapApiKey: string;
+    keyGen?: string | undefined;
+    tokenInChainId?: string | number | undefined;
+    tokenOutChainId?: string | number | undefined;
+    slippage?: string | number | undefined;
+    permit2Disabled?: boolean | undefined;
+    swapper?: string | undefined;
+    managementNodeUrl?: string | undefined;
+    baseUrl?: string | undefined;
+    universalRouterVersion?: string | undefined;
+}>;
+/** Output: full Uniswap POST /quote JSON (dynamic shape from Trade API). */
+declare const mcpUniswapV4QuoteOutputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** Input for MCP tool `ctm_uniswap_v4_create_swap` → handler `uniswapCreateSwap`. */
+declare const mcpUniswapV4CreateSwapInputSchema: z.ZodObject<{
+    uniswapApiKey: z.ZodString;
+    fullQuoteFromPermit: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    swapTransactionDeadlineUnix: z.ZodOptional<z.ZodNumber>;
+    useServerProxy: z.ZodOptional<z.ZodBoolean>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    universalRouterVersion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    uniswapApiKey: string;
+    fullQuoteFromPermit: Record<string, unknown>;
+    baseUrl?: string | undefined;
+    universalRouterVersion?: string | undefined;
+    useServerProxy?: boolean | undefined;
+    swapTransactionDeadlineUnix?: number | undefined;
+}, {
+    uniswapApiKey: string;
+    fullQuoteFromPermit: Record<string, unknown>;
+    baseUrl?: string | undefined;
+    universalRouterVersion?: string | undefined;
+    useServerProxy?: boolean | undefined;
+    swapTransactionDeadlineUnix?: number | undefined;
+}>;
+declare const mcpUniswapV4CreateSwapOutputSchema: z.ZodObject<{
+    swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    requestId: z.ZodOptional<z.ZodString>;
+    gasFee: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    requestId: z.ZodOptional<z.ZodString>;
+    gasFee: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    requestId: z.ZodOptional<z.ZodString>;
+    gasFee: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Input for MCP tool `ctm_uniswap_v4_build_swap_multisign`. */
+declare const mcpUniswapV4BuildSwapMultisignInputSchema: z.ZodObject<{
+    keyGen: z.ZodObject<{
+        pubkeyhex: z.ZodString;
+        keylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ClientKeys: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    }, {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    }>;
+    purposeText: z.ZodString;
+    useCustomGas: z.ZodBoolean;
+    chainId: z.ZodNumber;
+    rpcUrl: z.ZodString;
+    executorAddress: z.ZodString;
+    chainDetail: z.ZodObject<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+    customGasChainDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+} & {
+    tokenIn: z.ZodString;
+    swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createSwapResponse: z.ZodObject<{
+        swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        requestId: z.ZodOptional<z.ZodString>;
+        gasFee: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        requestId: z.ZodOptional<z.ZodString>;
+        gasFee: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        swap: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        requestId: z.ZodOptional<z.ZodString>;
+        gasFee: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    fullQuoteSnapshot: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    swapDeadlineUnix: z.ZodNumber;
+    slippagePercent: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    keyGen: {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    };
+    purposeText: string;
+    useCustomGas: boolean;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: string;
+    chainDetail: {
+        legacy?: boolean | undefined;
+        gasLimit?: number | undefined;
+        gasPrice?: number | undefined;
+        gasMultiplier?: number | undefined;
+        baseFee?: number | undefined;
+        priorityFee?: number | undefined;
+        baseFeeMultiplier?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    tokenIn: string;
+    swap: Record<string, unknown>;
+    createSwapResponse: {
+        swap: Record<string, unknown>;
+        requestId?: string | undefined;
+        gasFee?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    fullQuoteSnapshot: Record<string, unknown>;
+    swapDeadlineUnix: number;
+    customGasChainDetails?: Record<string, unknown> | undefined;
+    slippagePercent?: number | undefined;
+}, {
+    keyGen: {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    };
+    purposeText: string;
+    useCustomGas: boolean;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: string;
+    chainDetail: {
+        legacy?: boolean | undefined;
+        gasLimit?: number | undefined;
+        gasPrice?: number | undefined;
+        gasMultiplier?: number | undefined;
+        baseFee?: number | undefined;
+        priorityFee?: number | undefined;
+        baseFeeMultiplier?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    tokenIn: string;
+    swap: Record<string, unknown>;
+    createSwapResponse: {
+        swap: Record<string, unknown>;
+        requestId?: string | undefined;
+        gasFee?: string | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    fullQuoteSnapshot: Record<string, unknown>;
+    swapDeadlineUnix: number;
+    customGasChainDetails?: Record<string, unknown> | undefined;
+    slippagePercent?: number | undefined;
+}>;
+type McpUniswapV4QuoteInput = z.infer<typeof mcpUniswapV4QuoteInputSchema>;
+type McpUniswapV4QuoteOutput = z.infer<typeof mcpUniswapV4QuoteOutputSchema>;
+type McpUniswapV4CreateSwapInput = z.infer<typeof mcpUniswapV4CreateSwapInputSchema>;
+type McpUniswapV4CreateSwapOutput = z.infer<typeof mcpUniswapV4CreateSwapOutputSchema>;
+type McpUniswapV4BuildSwapMultisignInput = z.infer<typeof mcpUniswapV4BuildSwapMultisignInputSchema>;
+
+/** Input for MCP tool `ctm_curve_dao_build_swap_multisign`. */
+declare const mcpCurveDaoBuildSwapMultisignInputSchema: z.ZodObject<{
+    keyGen: z.ZodObject<{
+        pubkeyhex: z.ZodString;
+        keylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ClientKeys: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    }, {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    }>;
+    purposeText: z.ZodString;
+    useCustomGas: z.ZodBoolean;
+    chainId: z.ZodNumber;
+    rpcUrl: z.ZodString;
+    executorAddress: z.ZodString;
+    chainDetail: z.ZodObject<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        legacy: z.ZodOptional<z.ZodBoolean>;
+        gasLimit: z.ZodOptional<z.ZodNumber>;
+        gasMultiplier: z.ZodOptional<z.ZodNumber>;
+        gasPrice: z.ZodOptional<z.ZodNumber>;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        priorityFee: z.ZodOptional<z.ZodNumber>;
+        baseFeeMultiplier: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+    customGasChainDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+} & {
+    tokenIn: z.ZodString;
+    tokenOut: z.ZodString;
+    amountHuman: z.ZodString;
+    slippagePercent: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    keyGen: {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    };
+    purposeText: string;
+    useCustomGas: boolean;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: string;
+    chainDetail: {
+        legacy?: boolean | undefined;
+        gasLimit?: number | undefined;
+        gasPrice?: number | undefined;
+        gasMultiplier?: number | undefined;
+        baseFee?: number | undefined;
+        priorityFee?: number | undefined;
+        baseFeeMultiplier?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    tokenIn: string;
+    tokenOut: string;
+    slippagePercent: number;
+    amountHuman: string;
+    customGasChainDetails?: Record<string, unknown> | undefined;
+}, {
+    keyGen: {
+        pubkeyhex: string;
+        keylist?: string[] | undefined;
+        ClientKeys?: Record<string, string> | undefined;
+    };
+    purposeText: string;
+    useCustomGas: boolean;
+    chainId: number;
+    rpcUrl: string;
+    executorAddress: string;
+    chainDetail: {
+        legacy?: boolean | undefined;
+        gasLimit?: number | undefined;
+        gasPrice?: number | undefined;
+        gasMultiplier?: number | undefined;
+        baseFee?: number | undefined;
+        priorityFee?: number | undefined;
+        baseFeeMultiplier?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    tokenIn: string;
+    tokenOut: string;
+    slippagePercent: number;
+    amountHuman: string;
+    customGasChainDetails?: Record<string, unknown> | undefined;
+}>;
+type McpCurveDaoBuildSwapMultisignInput = z.infer<typeof mcpCurveDaoBuildSwapMultisignInputSchema>;
+
+/** Extend common multisign inputs with protocol-specific fields. */
+declare function mcpMultisignInput(fields: z.ZodRawShape): z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+
+declare const mcpLidoSubmitInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpLidoRequestWithdrawalsInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpLidoClaimWithdrawalInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpLidoWrapStEthInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpLidoUnwrapWstEthInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEthenaStakeInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEthenaRedeemInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEthenaCooldownInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEthenaClaimInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpMapleDepositInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpMapleRequestRedeemInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkyLockstakeStakeInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkyLockstakeDrawInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkyLockstakeWipeInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkyLockstakeCloseInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkyLockstakeGetRewardInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkySusdsDepositInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpSkySusdsRedeemInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpAaveV4DepositInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpAaveV4WithdrawInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpAaveV4BorrowInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpAaveV4RepayInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEulerV2IsolatedLendInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEulerV2IsolatedBorrowInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEulerV2VaultWithdrawInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEulerV2BorrowRepayInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEulerV2CollateralDepositInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+declare const mcpEulerV2CollateralWithdrawInputSchema: z.ZodObject<{} & {
+    [x: string]: z.ZodTypeAny;
+}, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+type McpLidoSubmitInput = z.infer<typeof mcpLidoSubmitInputSchema>;
+type McpEthenaStakeInput = z.infer<typeof mcpEthenaStakeInputSchema>;
+type McpMapleDepositInput = z.infer<typeof mcpMapleDepositInputSchema>;
+type McpSkyLockstakeStakeInput = z.infer<typeof mcpSkyLockstakeStakeInputSchema>;
+type McpAaveV4DepositInput = z.infer<typeof mcpAaveV4DepositInputSchema>;
+type McpEulerV2IsolatedLendInput = z.infer<typeof mcpEulerV2IsolatedLendInputSchema>;
 
 /** Machine-readable catalog of protocol actions grouped by chain category. */
 declare function getAgentCatalog(): {
@@ -90,9 +878,15 @@ declare function getAgentCatalog(): {
     };
     uniswapV4: ProtocolModule;
     curveDao: ProtocolModule;
+    lido: ProtocolModule;
+    ethena: ProtocolModule;
+    maple: ProtocolModule;
+    sky: ProtocolModule;
+    aaveV4: ProtocolModule;
+    eulerV2: ProtocolModule;
     /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
     mcp: {
-        tools: McpToolDefinition[];
+        tools: readonly McpToolDefinition[];
         protocols: readonly ProtocolModule[];
         commonParams: Record<string, ParamDoc>;
         multisignOutput: {
@@ -108,10 +902,38 @@ declare function getAgentCatalog(): {
                 };
             };
         };
+        managementSig: {
+            readonly description: "Management POST bodies embed NodeMgtKeySig: { nonce, clientSig, nodeKey }. Sign JSON with clientSig cleared; POST with clientSig set to the Ed25519 128-hex or EIP-191 signature. Legacy Nonce/Sig/sig field names are not accepted.";
+            readonly fields: {
+                readonly nonce: {
+                    readonly type: "number";
+                    readonly description: "From GET /getPublicMgtKeyNonce (Ed25519) or GET /getNodeMgtKeyNonce (Ethereum NodeMgtKey).";
+                };
+                readonly clientSig: {
+                    readonly type: "string";
+                    readonly description: "Management signature; empty string in the message to sign.";
+                };
+                readonly nodeKey: {
+                    readonly type: "string";
+                    readonly description: "Required. 128-hex MPC node id from GET /getNodeKey (no 0x prefix).";
+                };
+            };
+            readonly helpers: {
+                readonly managementSigFields: "Base envelope with clientSig cleared.";
+                readonly buildManagementPostBody: "Spread managementSigFields then endpoint fields.";
+                readonly messageToSignManagementBody: "Canonical JSON string to sign.";
+                readonly withManagementClientSig: "Attach signature to POST body.";
+                readonly fetchNodeKey: "GET /getNodeKey via nodeFetchWithReadAuth.";
+                readonly fetchManagementNonce: "GET nonce for Ed25519 or Ethereum management key.";
+            };
+        };
+        inputSchemas: Record<string, zod.ZodType<any, zod.ZodTypeDef, any>>;
+        outputSchemas: Record<string, zod.ZodType<any, zod.ZodTypeDef, any>>;
         workflow: {
             evmSwapTypical: string[];
+            managementPostTypical: string[];
         };
     };
 };
 
-export { EVM_COMMON_PARAM_DOCS, MCP_TOOL_DEFINITIONS, MULTISIGN_OUTPUT_DOC, getAgentCatalog, getAgentCatalogForMcp, getMcpToolByName, getMcpToolDefinitions };
+export { type ChainDetailMcpInput, EVM_COMMON_PARAM_DOCS, type EvmMultisignCommonInput, type KeyGenMcpInput, MANAGEMENT_SIG_DOC, MCP_TOOL_DEFINITIONS, MCP_TOOL_INPUT_SCHEMAS, MCP_TOOL_OUTPUT_SCHEMAS, MULTISIGN_OUTPUT_DOC, type McpAaveV4DepositInput, type McpCurveDaoBuildSwapMultisignInput, type McpEthenaStakeInput, type McpEulerV2IsolatedLendInput, type McpJsonSchema, type McpLidoSubmitInput, type McpMapleDepositInput, type McpSchemaProperty, type McpSkyLockstakeStakeInput, type McpToolDefinition, type McpToolHandler, type McpToolInputMap, type McpToolName, type McpToolOutputMap, type McpUniswapV4BuildSwapMultisignInput, type McpUniswapV4CreateSwapInput, type McpUniswapV4CreateSwapOutput, type McpUniswapV4QuoteInput, type McpUniswapV4QuoteOutput, type MultisignOutput, chainDetailSchema, evmAddressSchema, evmMultisignCommonInputSchema, getAgentCatalog, getAgentCatalogForMcp, getMcpToolByName, getMcpToolDefinitions, getMcpToolInputSchema, getMcpToolOutputSchema, jsonObjectSchema, keyGenSchema, mcpAaveV4BorrowInputSchema, mcpAaveV4DepositInputSchema, mcpAaveV4RepayInputSchema, mcpAaveV4WithdrawInputSchema, mcpCurveDaoBuildSwapMultisignInputSchema, mcpEthenaClaimInputSchema, mcpEthenaCooldownInputSchema, mcpEthenaRedeemInputSchema, mcpEthenaStakeInputSchema, mcpEulerV2BorrowRepayInputSchema, mcpEulerV2CollateralDepositInputSchema, mcpEulerV2CollateralWithdrawInputSchema, mcpEulerV2IsolatedBorrowInputSchema, mcpEulerV2IsolatedLendInputSchema, mcpEulerV2VaultWithdrawInputSchema, mcpLidoClaimWithdrawalInputSchema, mcpLidoRequestWithdrawalsInputSchema, mcpLidoSubmitInputSchema, mcpLidoUnwrapWstEthInputSchema, mcpLidoWrapStEthInputSchema, mcpMapleDepositInputSchema, mcpMapleRequestRedeemInputSchema, mcpMultisignInput, multisignOutputSchema as mcpMultisignOutputSchema, mcpSkyLockstakeCloseInputSchema, mcpSkyLockstakeDrawInputSchema, mcpSkyLockstakeGetRewardInputSchema, mcpSkyLockstakeStakeInputSchema, mcpSkyLockstakeWipeInputSchema, mcpSkySusdsDepositInputSchema, mcpSkySusdsRedeemInputSchema, mcpUniswapV4BuildSwapMultisignInputSchema, mcpUniswapV4CreateSwapInputSchema, mcpUniswapV4CreateSwapOutputSchema, mcpUniswapV4QuoteInputSchema, mcpUniswapV4QuoteOutputSchema, multisignOutputSchema, parseMcpToolInput, parseMcpToolOutput, uniswapQuoteTradeTypeSchema, zodSchemaToMcpJsonSchema };