@continuumdao/ctm-mpc-defi 0.1.3

package/LICENSE

@@ -0,0 +1,18 @@
+Business Source License 1.1 (For this repository)
+
+Copyright (c) 2025 ContinuumDAO
+
+Licensor: ContinuumDAO
+
+Licensed under the Business Source License v1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://mariadb.com/bsl11/.
+
+Software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+IMPORTANT NOTE: This license will automatically transition to the GNU General Public License v3.0 or later on January 1, 2030. After this date, this software will be licensed under GPL-3.0-or-later.
+
+For the full text of the GNU General Public License v3.0, see:
+https://www.gnu.org/licenses/gpl-3.0.txt
+
+CHANGE DATE: 2030-01-01
+
+CHANGE LICENSE: GPL-3.0-or-later

package/README.md

@@ -0,0 +1,111 @@
+# @continuumdao/ctm-mpc-defi
+
+Continuum MPC DeFi protocol library — builds **multiSignRequest** payloads for EVM (and future chain categories). Usable from the Next.js app and from AI agents / Node scripts.
+
+**License:** [Business Source License 1.1](LICENSE) (ContinuumDAO). Converts to GPL-3.0-or-later on 2030-01-01.
+
+## Architecture
+
+| Layer | Path | Role |
+|-------|------|------|
+| Core | `src/core/` | KeyGen, purpose, mpc-auth envelope, registry |
+| Chain categories | `src/chains/<category>/` | EVM batch builder, fees; Solana/NEAR stubs |
+| Protocols | `src/protocols/<category>/<name>/` | DeFi actions (Uniswap V4, Curve DAO, …) |
+
+## Install
+
+```bash
+npm install @continuumdao/ctm-mpc-defi viem
+```
+
+Local link with the app:
+
+```json
+"@continuumdao/ctm-mpc-defi": "file:../ctm-mpc-defi"
+```
+
+Run `npm run build` in this repo after changes so `dist/` is up to date.
+
+## Package exports
+
+- `@continuumdao/ctm-mpc-defi` — core + registry
+- `@continuumdao/ctm-mpc-defi/core`
+- `@continuumdao/ctm-mpc-defi/chains/evm`
+- `@continuumdao/ctm-mpc-defi/protocols/evm/uniswap-v4`
+- `@continuumdao/ctm-mpc-defi/protocols/evm/curve-dao`
+- `@continuumdao/ctm-mpc-defi/agent` — action catalog for agents
+
+## Agent example (Uniswap V4)
+
+```typescript
+import { uniswapV4 } from '@continuumdao/ctm-mpc-defi/protocols/evm/uniswap-v4'
+
+const quote = await uniswapV4.quote({
+  type: 'EXACT_INPUT',
+  amount: '1000000',
+  tokenIn: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+  tokenOut: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+  chainId: 1,
+  uniswapApiKey: process.env.UNISWAP_API_KEY!,
+  swapper: '0xYourMpcExecutor',
+})
+
+const { bodyForSign, messageToSign } = await uniswapV4.buildSwapMultisignBody({ /* … */ })
+// Sign messageToSign, POST { ...bodyForSign, clientSig, signedMessage }
+```
+
+## Agent catalog
+
+Short registry (protocol actions):
+
+```typescript
+import { getAgentCatalog } from '@continuumdao/ctm-mpc-defi/agent'
+console.log(getAgentCatalog().byCategory.evm)
+```
+
+**MCP servers** should use the richer tool definitions (descriptions, input/output schema, handler mapping, prerequisites):
+
+```typescript
+import { getMcpToolDefinitions, getAgentCatalogForMcp } from '@continuumdao/ctm-mpc-defi/agent'
+
+for (const tool of getMcpToolDefinitions()) {
+  // Register each tool with your MCP server using tool.name, tool.description,
+  // tool.inputSchema, tool.outputSchema; invoke via tool.handler.importPath + exportName
+}
+```
+
+Each MCP tool includes:
+- Long `description` (what it does and does not do)
+- `inputSchema` / `outputSchema` (including `MultisignBuildResult` for sign builders)
+- `prerequisites` / `followUp` (typical quote → swap → multisign → sign → POST flow)
+- `handler`: `{ importPath, exportName }` pointing at the library export to call
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run typecheck
+```
+
+## Publish (npm)
+
+Scoped package for the [ContinuumDAO npm org](https://www.npmjs.com/org/continuumdao):
+
+```bash
+npm login
+npm publish
+```
+
+Install in consumers:
+
+```bash
+npm install @continuumdao/ctm-mpc-defi
+```
+
+For local development against the sibling repo:
+
+```json
+"@continuumdao/ctm-mpc-defi": "file:../ctm-mpc-defi"
+```

package/dist/agent/catalog.cjs

@@ -0,0 +1,484 @@
+'use strict';
+
+require('viem');
+
+// src/core/registry.ts
+var modules = [];
+function registerProtocolModule(mod) {
+  const existing = modules.findIndex((m) => m.id === mod.id);
+  if (existing >= 0) {
+    modules[existing] = mod;
+  } else {
+    modules.push(mod);
+  }
+}
+function getProtocolModules() {
+  return modules;
+}
+function getActionsByChainCategory(category) {
+  return modules.filter((m) => m.chainCategory === category).flatMap((m) => m.actions);
+}
+
+// src/chains/evm/chainIdParse.ts
+function parseEvmChainIdToNumber(chainId) {
+  if (chainId == null) return Number.NaN;
+  if (typeof chainId === "bigint") {
+    const n = Number(chainId);
+    return Number.isSafeInteger(n) && n >= 0 ? n : Number.NaN;
+  }
+  if (typeof chainId === "number") {
+    return Number.isInteger(chainId) && chainId >= 0 ? chainId : Number.NaN;
+  }
+  const t = String(chainId).trim();
+  if (!t) return Number.NaN;
+  const low = t.toLowerCase();
+  if (low.startsWith("eip155:")) {
+    const rest = t.slice("eip155:".length).trim();
+    const n = Number.parseInt(rest, 10);
+    return Number.isNaN(n) || n < 0 ? Number.NaN : n;
+  }
+  if (low.startsWith("0x")) {
+    return Number.parseInt(t, 16);
+  }
+  return Number.parseInt(t, 10);
+}
+
+// src/protocols/evm/uniswap-v4/constants.ts
+var UNIVERSAL_ROUTER_SPENDER = {
+  1: "0x66a9893cc07d91d95644aedd05d03f95e1dba8af",
+  5: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  11155111: "0x3a9d48ab9751398bbfa63ad67599bb04e4bdf98b",
+  137: "0x1095692a6237d83c6a72f3f5efedb9a670c49223",
+  80001: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  10: "0x851116d9223fabed8e56c0e6b8ad0c31d98b3507",
+  420: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  42161: "0xa51afafe0263b40edaef0df8781ea9aa03e381a3",
+  421613: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  42220: "0xcb695bc5D3Aa22cAD1E6DF07801b061a05A0233A",
+  44787: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  56: "0x1906c1d672b88cd1b9ac7593301ca990f94eae07",
+  43114: "0x94b75331ae8d42c1b61065089b7d48fe14aa73b7",
+  84531: "0xd0872d928672ae2ff74bdb2f5130ac12229cafaf",
+  8453: "0x6fF5693b99212da76ad316178a184ab56d299b43",
+  81457: "0xeabbcb3e8e415306207ef514f660a3f820025be3",
+  7777777: "0x3315ef7ca28db74abadc6c44570efdf06b04b020",
+  324: "0x28731BCC616B5f51dD52CF2e4dF0E78dD1136C06",
+  480: "0x8ac7bee993bb44dab564ea4bc9ea67bf9eb5e743",
+  1301: "0xf70536b3bcc1bd1a972dc186a2cf84cc6da6be5d",
+  130: "0xef740bf23acae26f6492b10de645d6b98dc8eaf3",
+  10143: "0x3ae6d8a282d67893e17aa70ebffb33ee5aa65893",
+  84532: "0x492e6456d9528771018deb9e87ef7750ef184104",
+  1868: "0x0e2850543f69f678257266e0907ff9a58b3f13de",
+  143: "0x0d97dc33264bfc1c226207428a79b26757fb9dc3",
+  59144: "0x661e93cca42afacb172121ef892830ca3b70f08d",
+  4217: "0x1febb76be10aaf3a1402f04e8e835f2c382f7914",
+  196: "0x5507749f2c558bb3e162c6e90c314c092e7372ff"
+};
+function isUniswapV4ChainSupported(chainId) {
+  if (chainId == null) return false;
+  const n = parseEvmChainIdToNumber(chainId);
+  if (Number.isNaN(n) || n < 0) return false;
+  const a = UNIVERSAL_ROUTER_SPENDER[n];
+  return typeof a === "string" && a.startsWith("0x");
+}
+
+// src/protocols/evm/uniswap-v4/index.ts
+var UNISWAP_V4_PROTOCOL_ID = "uniswap-v4";
+var uniswapV4ProtocolModule = {
+  id: UNISWAP_V4_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    return isUniswapV4ChainSupported(ctx.chainId);
+  },
+  isTokenSupported(token) {
+    if (token.category !== "evm") return false;
+    return token.kind === "native" || token.kind === "erc20";
+  },
+  actions: [
+    {
+      id: "uniswap-v4.swap-exact-input",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Swap ERC-20 or native token via Uniswap V4 Universal Router (classic allowance path)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        tokenIn: { type: "address", required: true, description: "Input token (0x0 for native)" },
+        tokenOut: { type: "address", required: true, description: "Output token address" },
+        amount: { type: "string", required: true, description: "Human or wei amount per trade type" },
+        slippagePercent: { type: "number", required: true, description: "Slippage tolerance percent" },
+        swapTransactionDeadlineUnix: {
+          type: "number",
+          required: false,
+          description: "On-chain swap deadline (unix seconds)"
+        },
+        uniswapApiKey: { type: "string", required: true, description: "Uniswap Trade API key" }
+      }
+    },
+    {
+      id: "uniswap-v4.quote",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Fetch Uniswap Trade API quote",
+      commonParams: ["keyGen"],
+      params: {
+        tokenIn: { type: "address", required: true, description: "Input token" },
+        tokenOut: { type: "address", required: true, description: "Output token" },
+        amount: { type: "string", required: true, description: "Amount for quote" },
+        type: { type: "EXACT_INPUT | EXACT_OUTPUT", required: true, description: "Trade type" }
+      }
+    }
+  ]
+};
+registerProtocolModule(uniswapV4ProtocolModule);
+
+// src/protocols/evm/curve-dao/support.ts
+var CURVE_FULL_NETWORK_CONSTANTS_CHAIN_IDS = /* @__PURE__ */ new Set([
+  1,
+  10,
+  56,
+  100,
+  137,
+  146,
+  196,
+  250,
+  252,
+  324,
+  999,
+  1284,
+  2222,
+  5e3,
+  8453,
+  42161,
+  42220,
+  43114,
+  1313161554
+]);
+function isCurveApiChainSupported(chainId) {
+  const n = parseEvmChainIdToNumber(chainId);
+  if (Number.isNaN(n) || n < 0) return false;
+  return CURVE_FULL_NETWORK_CONSTANTS_CHAIN_IDS.has(n);
+}
+
+// src/protocols/evm/curve-dao/index.ts
+var CURVE_DAO_PROTOCOL_ID = "curve-dao";
+var curveDaoProtocolModule = {
+  id: CURVE_DAO_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    return isCurveApiChainSupported(ctx.chainId);
+  },
+  isTokenSupported(token) {
+    if (token.category !== "evm") return false;
+    return token.kind === "native" || token.kind === "erc20";
+  },
+  actions: [
+    {
+      id: "curve-dao.swap",
+      protocolId: CURVE_DAO_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Swap via Curve Router NG (optional ERC-20 approve batch)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        tokenIn: { type: "address", required: true, description: "ERC-20 token in (native uses WETH path in UI)" },
+        tokenOut: { type: "address", required: true, description: "Output token or 0xeeee\u2026 native placeholder" },
+        amountHuman: { type: "string", required: true, description: "Human-readable input amount" },
+        slippagePercent: { type: "number", required: true, description: "Slippage percent (0\u2013100 exclusive)" }
+      }
+    }
+  ]
+};
+registerProtocolModule(curveDaoProtocolModule);
+
+// src/agent/commonParamDocs.ts
+var EVM_COMMON_PARAM_DOCS = {
+  keyGen: {
+    type: "object",
+    required: true,
+    description: "MPC key slice: { pubkeyhex: string (required), keylist: string[], ClientKeys?: Record<string,string> }. Used for pubKey/keyList on POST /multiSignRequest."
+  },
+  purposeText: {
+    type: "string",
+    required: true,
+    description: "Human-readable purpose for the sign request. Stored in bodyForSign.purpose (may be appended with an automatic batch suffix)."
+  },
+  useCustomGas: {
+    type: "boolean",
+    required: true,
+    description: "When true, apply chain gas settings from chainDetail / customGasChainDetails instead of raw RPC estimates only."
+  },
+  chainId: {
+    type: "number",
+    required: true,
+    description: "EVM chain id (decimal). Becomes destinationChainID on the sign request."
+  },
+  rpcUrl: {
+    type: "string",
+    required: true,
+    description: "HTTPS JSON-RPC URL for gas estimation, nonce, and allowance reads."
+  },
+  executorAddress: {
+    type: "address",
+    required: true,
+    description: "MPC wallet address (from keyGen ethereumaddress) \u2014 tx sender for estimates and approvals."
+  },
+  chainDetail: {
+    type: "object",
+    required: true,
+    description: "Optional gas config: { legacy?, gasLimit?, gasMultiplier?, gasPrice?, baseFee?, priorityFee?, baseFeeMultiplier? }."
+  },
+  customGasChainDetails: {
+    type: "object",
+    required: false,
+    description: "Snapshot written to extraJSON.customGasChainDetails when useCustomGas is true."
+  }
+};
+var MULTISIGN_OUTPUT_DOC = {
+  description: "Unsigned mpc-auth multiSignRequest payload. The caller must sign messageToSign (MetaMask personal_sign or Ed25519) and POST { ...bodyForSign, clientSig, signedMessage: messageToSign } to /multiSignRequest.",
+  fields: {
+    bodyForSign: {
+      type: "object",
+      description: "POST body fields without clientSig: keyList, pubKey, msgHash, msgRaw, destinationChainID, purpose, extraJSON, proposalTxParams (batch), messageHashes/messageRawBatch when N>1 txs."
+    },
+    messageToSign: {
+      type: "string",
+      description: "JSON.stringify(bodyForSign) \u2014 exact string to sign before adding clientSig."
+    }
+  }
+};
+
+// src/agent/mcpTools.ts
+function paramProperties(params, includeCommon = []) {
+  const out = {};
+  for (const k of includeCommon) {
+    const d = EVM_COMMON_PARAM_DOCS[k];
+    if (d) out[k] = { type: d.type, description: d.description };
+  }
+  for (const [k, d] of Object.entries(params)) {
+    out[k] = { type: d.type, description: d.description };
+  }
+  return out;
+}
+function requiredKeys(params, includeCommon = []) {
+  const req = [];
+  for (const k of includeCommon) {
+    if (EVM_COMMON_PARAM_DOCS[k]?.required) req.push(k);
+  }
+  for (const [k, d] of Object.entries(params)) {
+    if (d.required) req.push(k);
+  }
+  return req;
+}
+var multisignOutputSchema = {
+  type: "object",
+  description: MULTISIGN_OUTPUT_DOC.description,
+  properties: {
+    bodyForSign: {
+      type: "object",
+      description: MULTISIGN_OUTPUT_DOC.fields.bodyForSign.description
+    },
+    messageToSign: {
+      type: "string",
+      description: MULTISIGN_OUTPUT_DOC.fields.messageToSign.description
+    }
+  },
+  required: ["bodyForSign", "messageToSign"]
+};
+var MCP_TOOL_DEFINITIONS = [
+  {
+    name: "ctm_uniswap_v4_quote",
+    actionId: "uniswap-v4.quote",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Fetch a Uniswap V4 Trade API quote (POST /v1/quote). Returns classic quote JSON including quote.input/output amounts and routing. Does NOT create a sign request \u2014 use ctm_uniswap_v4_create_swap and ctm_uniswap_v4_build_swap_multisign after quoting. Requires uniswapApiKey and swapper (MPC executor address) or keyGen + managementNodeUrl to resolve swapper.",
+    prerequisites: ["Chain must be supported by Uniswap V4 (Universal Router map)."],
+    followUp: ["ctm_uniswap_v4_create_swap", "ctm_uniswap_v4_build_swap_multisign"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapTradeQuote" },
+    inputSchema: {
+      type: "object",
+      properties: paramProperties({
+        type: { type: "string", required: true, description: "EXACT_INPUT or EXACT_OUTPUT" },
+        amount: { type: "string", required: true, description: "Amount in token-in base units (wei string for ERC-20)" },
+        tokenIn: { type: "address", required: true, description: "Input token; 0x0 for native ETH" },
+        tokenOut: { type: "address", required: true, description: "Output token address" },
+        chainId: { type: "number", required: true, description: "tokenInChainId / same-chain default" },
+        uniswapApiKey: { type: "string", required: true, description: "Uniswap Trade API x-api-key" },
+        swapper: { type: "address", required: false, description: "MPC executor; omit if keyGen + managementNodeUrl provided" },
+        slippage: { type: "number", required: false, description: "Slippage percent; omit for API auto slippage" }
+      }),
+      required: requiredKeys({
+        type: { type: "string", required: true, description: "" },
+        amount: { type: "string", required: true, description: "" },
+        tokenIn: { type: "address", required: true, description: "" },
+        tokenOut: { type: "address", required: true, description: "" },
+        chainId: { type: "number", required: true, description: "" },
+        uniswapApiKey: { type: "string", required: true, description: "" }
+      })
+    },
+    outputSchema: {
+      type: "object",
+      description: "Full Uniswap POST /quote JSON (includes nested quote object with input/output amounts)."
+    }
+  },
+  {
+    name: "ctm_uniswap_v4_create_swap",
+    actionId: "uniswap-v4.create-swap",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Call Uniswap Trade API POST /v1/swap to build Universal Router calldata from a prior quote. Returns { swap: { to, data, value, gasLimit? }, requestId? }. Does NOT produce a multiSignRequest \u2014 call ctm_uniswap_v4_build_swap_multisign next.",
+    prerequisites: ["ctm_uniswap_v4_quote output (fullQuoteFromPermit)"],
+    followUp: ["ctm_uniswap_v4_build_swap_multisign"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapCreateSwap" },
+    inputSchema: {
+      type: "object",
+      properties: paramProperties({
+        uniswapApiKey: { type: "string", required: true, description: "Uniswap Trade API key" },
+        fullQuoteFromPermit: { type: "object", required: true, description: "Full quote JSON from ctm_uniswap_v4_quote" },
+        swapTransactionDeadlineUnix: {
+          type: "number",
+          required: false,
+          description: "On-chain deadline unix seconds; default ~30 min from now"
+        },
+        useServerProxy: {
+          type: "boolean",
+          required: false,
+          description: "Set false in Node/agents; true only in browser via Next API route"
+        }
+      }),
+      required: requiredKeys({
+        uniswapApiKey: { type: "string", required: true, description: "" },
+        fullQuoteFromPermit: { type: "object", required: true, description: "" }
+      })
+    },
+    outputSchema: {
+      type: "object",
+      description: "{ swap: TransactionRequest, requestId?, gasFee? }"
+    }
+  },
+  {
+    name: "ctm_uniswap_v4_build_swap_multisign",
+    actionId: "uniswap-v4.swap-exact-input",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest body for a Uniswap V4 swap. May batch 1\u20133 EVM txs: ERC-20 approve(s) to Permit2/router path + Universal Router swap (or 1 tx for native-in). Estimates gas, serializes unsigned txs, sets proposalTxParams. Output must be signed and POSTed to /multiSignRequest by the caller.",
+    prerequisites: [
+      "ctm_uniswap_v4_create_swap output",
+      "keyGen with pubkeyhex",
+      "executorAddress matching MPC wallet",
+      "RPC URL and chainDetail from node chain config"
+    ],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "buildEvmMultisignBodyUniswapV4SkipPermit2Batch" },
+    inputSchema: {
+      type: "object",
+      properties: paramProperties(
+        {
+          tokenIn: { type: "address", required: true, description: "Token in; 0x0 for native ETH" },
+          swap: { type: "object", required: true, description: "swap field from create_swap response" },
+          createSwapResponse: { type: "object", required: true, description: "Full create_swap response" },
+          fullQuoteSnapshot: { type: "object", required: true, description: "Quote JSON used for the swap" },
+          swapDeadlineUnix: { type: "number", required: true, description: "Same deadline passed to create_swap" },
+          slippagePercent: { type: "number", required: false, description: "Extra approve headroom for EXACT_OUTPUT" }
+        },
+        ["keyGen", "purposeText", "useCustomGas", "chainId", "rpcUrl", "executorAddress", "chainDetail", "customGasChainDetails"]
+      ),
+      required: requiredKeys(
+        {
+          tokenIn: { type: "address", required: true, description: "" },
+          swap: { type: "object", required: true, description: "" },
+          createSwapResponse: { type: "object", required: true, description: "" },
+          fullQuoteSnapshot: { type: "object", required: true, description: "" },
+          swapDeadlineUnix: { type: "number", required: true, description: "" }
+        },
+        ["keyGen", "purposeText", "useCustomGas", "chainId", "rpcUrl", "executorAddress", "chainDetail"]
+      )
+    },
+    outputSchema: multisignOutputSchema
+  },
+  {
+    name: "ctm_curve_dao_build_swap_multisign",
+    actionId: "curve-dao.swap",
+    protocolId: "curve-dao",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest for a Curve Router NG swap via @curvefi/api populateSwap. Optionally batches ERC-20 approve txs when allowance is insufficient, then exchange. Requires JSON-RPC and Curve-supported chain.",
+    prerequisites: ["keyGen", "executorAddress", "tokenIn/tokenOut/amountHuman/slippage", "RPC URL"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: { importPath: "protocols/evm/curve-dao", exportName: "buildEvmMultisignBodyCurveDaoBatch" },
+    inputSchema: {
+      type: "object",
+      properties: paramProperties(
+        {
+          tokenIn: { type: "address", required: true, description: "ERC-20 sold (native in uses WETH path in UI)" },
+          tokenOut: { type: "string", required: true, description: "Output token or 0xeeee\u2026 native placeholder" },
+          amountHuman: { type: "string", required: true, description: "Human-readable amount of tokenIn" },
+          slippagePercent: { type: "number", required: true, description: "Slippage 0\u2013100 exclusive" }
+        },
+        ["keyGen", "purposeText", "useCustomGas", "chainId", "rpcUrl", "executorAddress", "chainDetail", "customGasChainDetails"]
+      ),
+      required: requiredKeys(
+        {
+          tokenIn: { type: "address", required: true, description: "" },
+          tokenOut: { type: "string", required: true, description: "" },
+          amountHuman: { type: "string", required: true, description: "" },
+          slippagePercent: { type: "number", required: true, description: "" }
+        },
+        ["keyGen", "purposeText", "useCustomGas", "chainId", "rpcUrl", "executorAddress", "chainDetail"]
+      )
+    },
+    outputSchema: multisignOutputSchema
+  }
+];
+function getMcpToolDefinitions() {
+  return MCP_TOOL_DEFINITIONS;
+}
+function getMcpToolByName(name) {
+  return MCP_TOOL_DEFINITIONS.find((t) => t.name === name);
+}
+function getAgentCatalogForMcp() {
+  return {
+    tools: MCP_TOOL_DEFINITIONS,
+    protocols: getProtocolModules(),
+    commonParams: EVM_COMMON_PARAM_DOCS,
+    multisignOutput: MULTISIGN_OUTPUT_DOC,
+    workflow: {
+      evmSwapTypical: [
+        "1. Quote (protocol-specific API if needed)",
+        "2. Build protocol calldata (e.g. create_swap)",
+        "3. build_*_multisign \u2192 { bodyForSign, messageToSign }",
+        "4. Sign messageToSign (MetaMask or Ed25519)",
+        "5. POST /multiSignRequest with clientSig and signedMessage"
+      ]
+    }
+  };
+}
+
+// src/agent/catalog.ts
+registerProtocolModule(uniswapV4ProtocolModule);
+registerProtocolModule(curveDaoProtocolModule);
+function getAgentCatalog() {
+  return {
+    protocols: getProtocolModules(),
+    byCategory: {
+      evm: getActionsByChainCategory("evm"),
+      solana: getActionsByChainCategory("solana"),
+      near: getActionsByChainCategory("near")
+    },
+    uniswapV4: uniswapV4ProtocolModule,
+    curveDao: curveDaoProtocolModule,
+    /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
+    mcp: getAgentCatalogForMcp()
+  };
+}
+
+exports.EVM_COMMON_PARAM_DOCS = EVM_COMMON_PARAM_DOCS;
+exports.MCP_TOOL_DEFINITIONS = MCP_TOOL_DEFINITIONS;
+exports.MULTISIGN_OUTPUT_DOC = MULTISIGN_OUTPUT_DOC;
+exports.getActionsByChainCategory = getActionsByChainCategory;
+exports.getAgentCatalog = getAgentCatalog;
+exports.getAgentCatalogForMcp = getAgentCatalogForMcp;
+exports.getMcpToolByName = getMcpToolByName;
+exports.getMcpToolDefinitions = getMcpToolDefinitions;
+exports.getProtocolModules = getProtocolModules;
+//# sourceMappingURL=catalog.cjs.map
+//# sourceMappingURL=catalog.cjs.map