@continuumdao/ctm-mpc-defi 0.2.16 → 0.2.17

package/dist/agent/catalog.cjs

@@ -411,7 +411,7 @@ var EVM_COMMON_PARAM_DOCS = {
   }
 };
 var MULTISIGN_SUBMIT_OUTPUT_DOC = {
-  description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result. Do not call the same build tool again if requestId was returned.",
+  description: "Submitted mpc-auth multiSignRequest id. continuum-mcp-server builds, signs the management envelope, and POSTs /multiSignRequest. Continue with sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result. Do not poll wait_for_sign_request_ready after submit (Join may take days). Do not call the same build tool again if requestId was returned.",
   fields: {
     requestId: {
       type: "string",
@@ -423,7 +423,7 @@ var MULTISIGN_SUBMIT_OUTPUT_DOC = {
     },
     followUp: {
       type: "string",
-      description: "Lifecycle next steps (wait_for_sign_request_ready \u2192 agree \u2192 trigger \u2192 broadcast)."
+      description: "Lifecycle next steps (sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result). No polling after submit."
     }
   }
 };
@@ -481,7 +481,6 @@ var MANAGEMENT_SIG_DOC = {
 // src/agent/mcpMultisignSubmitMeta.ts
 var MCP_MULTISIGN_SUBMIT_DESCRIPTION_SUFFIX = "Builds the unsigned batch, signs the management envelope, and POSTs /multiSignRequest. Returns { requestId } on success \u2014 do not call again; use list_sign_requests to verify duplicates.";
 var MCP_MULTISIGN_SUBMIT_FOLLOW_UP = [
-  "wait_for_sign_request_ready",
   "sign_request_agree",
   "trigger_sign_result",
   "broadcast_sign_result"
@@ -1259,9 +1258,10 @@ var mcpServerSubmitOutputSchema = zod.z.object({
   status: zod.z.literal("submitted").optional().describe("Present when POST /multiSignRequest succeeded. Confirms the request exists on the node."),
   followUp: zod.z.string().optional().describe(
     "Next MCP lifecycle steps. Do not call the same build_*_multisign tool again unless the user explicitly wants a duplicate order."
-  )
+  ),
+  fees: zod.z.record(zod.z.unknown()).optional().describe("Protocol fee summary when available (e.g. Circle CCTP Forwarding Service quote used at propose).")
 }).describe(
-  "Submitted mpc-auth multiSignRequest. Continue with wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result."
+  "Submitted mpc-auth multiSignRequest. Continue with sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result. Do not poll wait_for_sign_request_ready \u2014 Join agreement may take days."
 );
 var MCP_NON_SUBMIT_TOOL_NAMES = /* @__PURE__ */ new Set([
   "ctm_uniswap_v4_quote",
@@ -2034,6 +2034,70 @@ var mcpHyperliquidUndelegateInputSchema = mcpHyperliquidMultisignInput(
   },
   preprocessHyperliquidUndelegateInput
 );
+var mcpCctpFeeFieldsSchema = zod.z.object({
+  feeTierUsed: zod.z.enum(["low", "med", "high"]),
+  maxFee: zod.z.string().describe("Selected tier max fee in USDC base units (6 decimals)"),
+  maxFeeHuman: zod.z.string().describe("Human-readable USDC max forwarding fee for feeTierUsed"),
+  forwardFeeLow: zod.z.string(),
+  forwardFeeLowHuman: zod.z.string(),
+  forwardFeeMed: zod.z.string(),
+  forwardFeeMedHuman: zod.z.string(),
+  forwardFeeHigh: zod.z.string(),
+  forwardFeeHighHuman: zod.z.string(),
+  transferAmount: zod.z.string().optional(),
+  transferAmountHuman: zod.z.string().optional(),
+  totalBurn: zod.z.string().optional().describe("transferAmount + maxFee when transferAmountHuman was provided"),
+  totalBurnHuman: zod.z.string().optional(),
+  feeSummary: zod.z.string().describe("Plain-language fee summary for agents")
+});
+var mcpCctpFetchSupportedRoutesInputSchema = zod.z.object({
+  network: zod.z.enum(["mainnet", "testnet"]).optional().describe("Filter routes by network; omit for all")
+});
+var mcpCctpFetchSupportedRoutesOutputSchema = jsonObjectSchema.describe(
+  "{ routes: [{ sourceChainId, destChainId, sourceDomain, destDomain, sourceLabel, destLabel, network }] }"
+);
+var mcpCctpFetchBurnFeesInputSchema = zod.z.object({
+  sourceChainId: agentEvmChainIdSchema.describe("Source chain EIP-155 id (burn chain)"),
+  destChainId: agentEvmChainIdSchema.describe("Destination chain EIP-155 id (mint chain)"),
+  transferAmountHuman: zod.z.string().min(1).optional().describe("Human USDC amount recipient receives (6 decimals). Omit for tier fees only; include for totalBurn."),
+  feeTier: zod.z.enum(["low", "med", "high"]).optional().describe("Iris forwardFee tier; default med")
+});
+var mcpCctpFetchBurnFeesOutputSchema = zod.z.object({
+  sourceChainId: zod.z.number(),
+  destChainId: zod.z.number(),
+  sourceDomain: zod.z.number(),
+  destDomain: zod.z.number(),
+  sourceLabel: zod.z.string(),
+  destLabel: zod.z.string(),
+  network: zod.z.enum(["mainnet", "testnet"]),
+  fees: mcpCctpFeeFieldsSchema
+}).passthrough().describe("Iris Forwarding Service fee quote with human-readable USDC amounts in fees and top-level fee fields");
+var mcpCctpFetchUsdcBalanceInputSchema = zod.z.object({
+  chainId: agentEvmChainIdSchema.describe("Source chain to read USDC balance on"),
+  executorAddress: evmAddressSchema.optional().describe("Server-filled from keyGenId when omitted"),
+  rpcUrl: zod.z.string().min(1).optional().describe("Server-filled from chain registry"),
+  transferAmountHuman: zod.z.string().min(1).optional().describe("When set with feeSnapshot, returns requiredTotalBurn* and sufficientForTransfer"),
+  feeSnapshot: jsonObjectSchema.optional().describe("Output from ctm_cctp_fetch_burn_fees (uses maxFee) for balance sufficiency check")
+});
+var mcpCctpFetchUsdcBalanceOutputSchema = jsonObjectSchema.describe(
+  "{ balanceUsdcHuman, balanceRaw, usdcAddress, requiredTotalBurnHuman?, sufficientForTransfer?, feeSummary? }"
+);
+var mcpCctpFetchTransferStatusInputSchema = zod.z.object({
+  sourceChainId: agentEvmChainIdSchema.describe("Source chain where burn was executed"),
+  sourceDomain: zod.z.number().int().min(0).describe("CCTP domain id of source chain"),
+  burnTxHash: zod.z.string().min(1).describe("Burn transaction hash (0x-prefixed or raw)")
+});
+var mcpCctpFetchTransferStatusOutputSchema = jsonObjectSchema.describe(
+  "{ status, attestation?, message?, eventNonce? } from Iris /v2/messages"
+);
+var mcpCctpBuildBurnMultisignInputSchema = mcpMultisignInput({
+  destChainId: agentEvmChainIdSchema.describe("Destination chain EIP-155 id (mint chain)"),
+  transferAmountHuman: zod.z.string().min(1).describe("Human USDC amount recipient receives"),
+  mintRecipient: evmAddressSchema.optional().describe("Recipient on destination chain; defaults to MPC executor address"),
+  feeTier: zod.z.enum(["low", "med", "high"]).optional(),
+  minFinalityThreshold: zod.z.number().int().positive().optional(),
+  feeSnapshot: jsonObjectSchema.optional().describe("Optional output from ctm_cctp_fetch_burn_fees")
+});
 
 // src/agent/mcpProtocolTools.ts
 function defineProtocolMcpTool(def) {
@@ -2588,6 +2652,26 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     prerequisites: ["keyGen", "executorAddress", "delegation from fetch_delegations"],
     handler: { importPath: "protocols/evm/hyperliquid", exportName: "buildEvmMultisignBodyHyperliquidUndelegateBatch" },
     inputZod: mcpHyperliquidUndelegateInputSchema
+  }),
+  defineProtocolMcpTool({
+    name: "ctm_cctp_build_burn_multisign",
+    actionId: "circle-cctp.burn-forward",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Create and submit mpc-auth multiSignRequest for CCTP Forwarding Service USDC transfer (approve + depositForBurnWithHook on source chain).",
+    prerequisites: [
+      "ctm_cctp_fetch_burn_fees (required)",
+      "keyGenId",
+      "chainId = source chain",
+      "destChainId",
+      "transferAmountHuman",
+      "sufficient USDC on source"
+    ],
+    handler: {
+      importPath: "protocols/evm/circle-cctp",
+      exportName: "buildEvmMultisignBodyCctpBurnBatchFromMcp"
+    },
+    inputZod: mcpCctpBuildBurnMultisignInputSchema
   })
 ];
 
@@ -3122,6 +3206,54 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     inputZod: mcpEulerV2FetchLendVaultsInputSchema,
     outputZod: mcpEulerV2FetchLendVaultsOutputSchema
   }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_supported_routes",
+    actionId: "circle-cctp.fetch-routes",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "List supported Circle CCTP V2 Forwarding Service routes (EVM source \u2192 destination pairs on mainnet or testnet). Read-only.",
+    prerequisites: ["load_defi_protocol", "get_chain_registry"],
+    followUp: ["ctm_cctp_fetch_burn_fees"],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchSupportedRoutes" },
+    inputZod: mcpCctpFetchSupportedRoutesInputSchema,
+    outputZod: mcpCctpFetchSupportedRoutesOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_burn_fees",
+    actionId: "circle-cctp.fetch-fees",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Quote Circle Iris Forwarding Service burn fees (?forward=true) for a CCTP route. Returns human-readable USDC fee tiers and totalBurn when transferAmountHuman is set. Does NOT create a sign request.",
+    prerequisites: ["supported route (ctm_cctp_fetch_supported_routes)"],
+    followUp: ["ctm_cctp_fetch_usdc_balance", "ctm_cctp_build_burn_multisign"],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchBurnFeesForRoute" },
+    inputZod: mcpCctpFetchBurnFeesInputSchema,
+    outputZod: mcpCctpFetchBurnFeesOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_usdc_balance",
+    actionId: "circle-cctp.fetch-usdc-balance",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Read MPC wallet USDC balance on a CCTP source chain. Read-only.",
+    prerequisites: ["chainId (source)", "executorAddress or keyGenId"],
+    followUp: ["ctm_cctp_build_burn_multisign"],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchUsdcBalance" },
+    inputZod: mcpCctpFetchUsdcBalanceInputSchema,
+    outputZod: mcpCctpFetchUsdcBalanceOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_cctp_fetch_transfer_status",
+    actionId: "circle-cctp.fetch-status",
+    protocolId: "circle-cctp",
+    chainCategory: "evm",
+    description: "Poll Circle Iris for CCTP message/attestation status after source-chain burn Execute. Read-only.",
+    prerequisites: ["sourceChainId", "sourceDomain", "burnTxHash from broadcast"],
+    followUp: [],
+    handler: { importPath: "protocols/evm/circle-cctp", exportName: "cctpFetchTransferStatus" },
+    inputZod: mcpCctpFetchTransferStatusInputSchema,
+    outputZod: mcpCctpFetchTransferStatusOutputSchema
+  }),
   defineMcpTool({
     name: "ctm_morpho_fetch_earn_vaults",
     actionId: "morpho.fetch-earn-vaults",
@@ -3189,7 +3321,7 @@ function getAgentCatalogForMcp() {
         "1. Quote (protocol-specific API if needed)",
         "2. Build protocol calldata (e.g. create_swap)",
         "3. build_*_multisign \u2192 { requestId } (MCP auto-submits)",
-        "4. wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result"
+        "4. sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result (do not poll wait_for_sign_request_ready \u2014 Join may take days)"
       ],
       evmSwapManualTypical: [
         "1. Quote (protocol-specific API if needed)",
@@ -3208,7 +3340,7 @@ function getAgentCatalogForMcp() {
         "1. load_defi_protocol for the target protocol",
         "2. get_defi_protocol_supported_chains / get_token_registry to pick chainId and tokens",
         "3. MCP build_* tool with keyGenId + chainId \u2192 { requestId }",
-        "4. Base MCP: wait_for_sign_request_ready \u2192 sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result"
+        "4. Base MCP: sign_request_agree \u2192 trigger_sign_result \u2192 broadcast_sign_result (no wait_for_sign_request_ready polling after submit)"
       ]
     }
   };
@@ -4093,6 +4225,185 @@ var morphoProtocolModule = {
   ]
 };
 registerProtocolModule(morphoProtocolModule);
+
+// src/protocols/evm/circle-cctp/constants.ts
+var CIRCLE_CCTP_PROTOCOL_ID = "circle-cctp";
+var TOKEN_MESSENGER_V2_MAINNET = "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+var TOKEN_MESSENGER_V2_TESTNET = "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+var CCTP_EVM_CHAINS = [
+  {
+    chainId: 1,
+    domain: 0,
+    network: "mainnet",
+    usdc: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Ethereum"
+  },
+  {
+    chainId: 43114,
+    domain: 1,
+    network: "mainnet",
+    usdc: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Avalanche"
+  },
+  {
+    chainId: 10,
+    domain: 2,
+    network: "mainnet",
+    usdc: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "OP Mainnet"
+  },
+  {
+    chainId: 42161,
+    domain: 3,
+    network: "mainnet",
+    usdc: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Arbitrum"
+  },
+  {
+    chainId: 8453,
+    domain: 6,
+    network: "mainnet",
+    usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Base"
+  },
+  {
+    chainId: 137,
+    domain: 7,
+    network: "mainnet",
+    usdc: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    tokenMessenger: TOKEN_MESSENGER_V2_MAINNET,
+    label: "Polygon PoS"
+  },
+  {
+    chainId: 11155111,
+    domain: 0,
+    network: "testnet",
+    usdc: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Ethereum Sepolia"
+  },
+  {
+    chainId: 43113,
+    domain: 1,
+    network: "testnet",
+    usdc: "0x5425890298aed601595a70AB815c96711a31Bc65",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Avalanche Fuji"
+  },
+  {
+    chainId: 11155420,
+    domain: 2,
+    network: "testnet",
+    usdc: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "OP Sepolia"
+  },
+  {
+    chainId: 421614,
+    domain: 3,
+    network: "testnet",
+    usdc: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Arbitrum Sepolia"
+  },
+  {
+    chainId: 84532,
+    domain: 6,
+    network: "testnet",
+    usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Base Sepolia"
+  },
+  {
+    chainId: 80002,
+    domain: 7,
+    network: "testnet",
+    usdc: "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
+    tokenMessenger: TOKEN_MESSENGER_V2_TESTNET,
+    label: "Polygon Amoy"
+  }
+];
+function cctpChainConfig(chainId) {
+  return CCTP_EVM_CHAINS.find((c) => c.chainId === chainId) ?? null;
+}
+function parseCctpEvmChainId(chainId) {
+  if (typeof chainId === "number") {
+    return Number.isFinite(chainId) ? chainId : Number.NaN;
+  }
+  const t = String(chainId).trim();
+  if (!t) return Number.NaN;
+  const low = t.toLowerCase();
+  if (low.startsWith("eip155:")) {
+    const n2 = Number.parseInt(t.slice("eip155:".length).trim(), 10);
+    return Number.isFinite(n2) ? n2 : Number.NaN;
+  }
+  if (low.startsWith("0x")) {
+    const n2 = Number.parseInt(t, 16);
+    return Number.isFinite(n2) ? n2 : Number.NaN;
+  }
+  const n = Number.parseInt(t, 10);
+  return Number.isFinite(n) ? n : Number.NaN;
+}
+function isCctpSourceChainSupported(chainId) {
+  const n = parseCctpEvmChainId(chainId);
+  return Number.isFinite(n) && cctpChainConfig(n) != null;
+}
+
+// src/protocols/evm/circle-cctp/index.ts
+var circleCctpProtocolModule = {
+  id: CIRCLE_CCTP_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    return isCctpSourceChainSupported(ctx.chainId);
+  },
+  isTokenSupported(token) {
+    return token.category === "evm" && token.kind === "erc20";
+  },
+  actions: [
+    {
+      id: "circle-cctp.fetch-routes",
+      protocolId: CIRCLE_CCTP_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "List supported CCTP Forwarding Service routes (EVM)",
+      commonParams: [],
+      params: {
+        network: { type: "string", required: false, description: "mainnet | testnet" }
+      }
+    },
+    {
+      id: "circle-cctp.fetch-fees",
+      protocolId: CIRCLE_CCTP_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Quote Iris Forwarding Service burn fees for a route",
+      commonParams: [],
+      params: {
+        sourceChainId: { type: "number", required: true, description: "Source EIP-155 chain id" },
+        destChainId: { type: "number", required: true, description: "Destination EIP-155 chain id" },
+        transferAmountHuman: { type: "string", required: true, description: "USDC amount recipient receives" }
+      }
+    },
+    {
+      id: "circle-cctp.burn-forward",
+      protocolId: CIRCLE_CCTP_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Burn USDC on source chain via CCTP Forwarding Service (approve + depositForBurnWithHook batch)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        sourceChainId: { type: "number", required: true, description: "Source EIP-155 chain id" },
+        destChainId: { type: "number", required: true, description: "Destination EIP-155 chain id" },
+        transferAmountHuman: { type: "string", required: true, description: "USDC amount recipient receives" },
+        mintRecipient: { type: "address", required: false, description: "Destination mint recipient (default executor)" }
+      }
+    }
+  ]
+};
+registerProtocolModule(circleCctpProtocolModule);
 var skillsDir = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('catalog.cjs', document.baseURI).href)))), "skills");
 var SKILL_PROTOCOL_IDS = [
   "aave-v4",
@@ -4105,7 +4416,8 @@ var SKILL_PROTOCOL_IDS = [
   "sky",
   "gmx",
   "hyperliquid",
-  "morpho"
+  "morpho",
+  "circle-cctp"
 ];
 function getToolsForProtocol(protocolId) {
   return MCP_TOOL_DEFINITIONS.filter((t) => t.protocolId === protocolId);
@@ -4432,6 +4744,7 @@ registerProtocolModule(eulerV2ProtocolModule);
 registerProtocolModule(gmxProtocolModule);
 registerProtocolModule(hyperliquidProtocolModule);
 registerProtocolModule(morphoProtocolModule);
+registerProtocolModule(circleCctpProtocolModule);
 function getAgentCatalog() {
   return {
     protocols: getProtocolModules(),
@@ -4451,6 +4764,7 @@ function getAgentCatalog() {
     gmx: gmxProtocolModule,
     hyperliquid: hyperliquidProtocolModule,
     morpho: morphoProtocolModule,
+    circleCctp: circleCctpProtocolModule,
     /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
     mcp: getAgentCatalogForMcp()
   };