@continuumdao/ctm-mpc-defi 0.1.3 → 0.1.4

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 export { C as ChainCategory, a as ChainSupportContext, E as EvmTokenKind, K as KeyGenSubset, M as MultisignBuildResult, b as MultisignCommonArgs, N as NearTokenKind, P as ParamDoc, c as ProtocolActionDescriptor, d as ProtocolModule, S as SolanaTokenKind, T as TokenRef } from './types-Ce2qNHai.cjs';
 export { K as KeyGenSubsetForPermit, f as firstClientIdFromKeyGen, k as keyListFromKeyGen, r as requirePubKeyHex } from './keygen-CfNp8yKJ.cjs';
-export { mergePurposeText } from './core/index.cjs';
+export { ManagementSigFields, buildManagementPostBody, fetchManagementNonce, fetchNodeKey, managementSigFields, mergePurposeText, messageToSignManagementBody, normalizeManagementNodeKey, withManagementClientSig } from './core/index.cjs';
 export { C as ChainCategoryBuildInput, a as ChainCategoryModule, M as MultisignLeg, c as coreChainCategoryModule, f as finalizeMultisign } from './envelope-DYDPnrHZ.cjs';
 export { g as getActionsByChainCategory, a as getProtocolModule, b as getProtocolModules, r as registerProtocolModule } from './registry-BwZoE668.cjs';
 export { N as NodeReadAuth, n as nodeFetchWithReadAuth } from './nodeRead-BnmSaMGO.cjs';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { C as ChainCategory, a as ChainSupportContext, E as EvmTokenKind, K as KeyGenSubset, M as MultisignBuildResult, b as MultisignCommonArgs, N as NearTokenKind, P as ParamDoc, c as ProtocolActionDescriptor, d as ProtocolModule, S as SolanaTokenKind, T as TokenRef } from './types-Ce2qNHai.js';
 export { K as KeyGenSubsetForPermit, f as firstClientIdFromKeyGen, k as keyListFromKeyGen, r as requirePubKeyHex } from './keygen-DsINazx8.js';
-export { mergePurposeText } from './core/index.js';
+export { ManagementSigFields, buildManagementPostBody, fetchManagementNonce, fetchNodeKey, managementSigFields, mergePurposeText, messageToSignManagementBody, normalizeManagementNodeKey, withManagementClientSig } from './core/index.js';
 export { C as ChainCategoryBuildInput, a as ChainCategoryModule, M as MultisignLeg, c as coreChainCategoryModule, f as finalizeMultisign } from './envelope-CcE5Cz_q.js';
 export { g as getActionsByChainCategory, a as getProtocolModule, b as getProtocolModules, r as registerProtocolModule } from './registry-oMKlO_5z.js';
 export { N as NodeReadAuth, n as nodeFetchWithReadAuth } from './nodeRead-BnmSaMGO.js';

package/dist/index.js

@@ -112,6 +112,75 @@ function nodeFetchWithReadAuth(url, init, auth) {
   }
   return fetch(url, { ...init, headers });
 }
+
+// src/core/managementPostSig.ts
+function normalizeManagementNodeKey(nodeKey) {
+  const nk = nodeKey?.trim().replace(/^0x/i, "");
+  if (!nk || !/^[0-9a-fA-F]{128}$/.test(nk)) {
+    throw new Error("nodeKey is required (128 hex from GET /getNodeKey).");
+  }
+  return nk.toLowerCase();
+}
+function managementSigFields(nonce, nodeKey) {
+  return { nonce, clientSig: "", nodeKey: normalizeManagementNodeKey(nodeKey) };
+}
+function buildManagementPostBody(nonce, nodeKey, fields = {}) {
+  return { ...managementSigFields(nonce, nodeKey), ...fields };
+}
+function messageToSignManagementBody(body) {
+  return JSON.stringify({ ...body, clientSig: "" });
+}
+function withManagementClientSig(body, clientSig) {
+  return { ...body, clientSig: clientSig.trim().replace(/^0x/i, "") };
+}
+
+// src/core/managementNonce.ts
+function mpcAuthData(raw) {
+  const code = raw.Code ?? raw.code;
+  if (code !== 0 && code !== void 0) return void 0;
+  return raw.Data ?? raw.data;
+}
+async function fetchNodeKey(nodeUrl, readAuth = { bearerOnGet: false, jwt: null }) {
+  const base = nodeUrl.trim().replace(/\/$/, "");
+  const res = await nodeFetchWithReadAuth(`${base}/getNodeKey`, { cache: "no-store" }, readAuth);
+  const text = await res.text();
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch {
+    return { nodeKey: "", ok: false };
+  }
+  const data = mpcAuthData(raw);
+  const nk = typeof data === "string" ? data : data != null && typeof data === "object" && !Array.isArray(data) ? String(data.nodeKey ?? data.NodeKey ?? "") : data != null ? String(data) : "";
+  const trimmed = nk.trim().replace(/^0x/i, "");
+  if (!/^[0-9a-fA-F]{128}$/.test(trimmed)) {
+    return { nodeKey: "", ok: false };
+  }
+  return { nodeKey: trimmed.toLowerCase(), ok: res.ok };
+}
+async function fetchManagementNonce(nodeUrl, useEd25519, ed25519PublicKey, readAuth = { bearerOnGet: false, jwt: null }) {
+  const base = nodeUrl.trim().replace(/\/$/, "");
+  const path = useEd25519 ? "/getPublicMgtKeyNonce" : "/getNodeMgtKeyNonce";
+  const url = useEd25519 && ed25519PublicKey && /^[0-9a-fA-F]{64}$/.test(ed25519PublicKey.trim()) ? `${base}${path}?publicKey=${encodeURIComponent(ed25519PublicKey.trim())}` : `${base}${path}`;
+  const res = await nodeFetchWithReadAuth(url, { cache: "no-store" }, readAuth);
+  const text = await res.text();
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch {
+    return { nonce: 0, ok: false, code: -1 };
+  }
+  const code = raw.Code ?? raw.code;
+  const payload = mpcAuthData(raw) ?? raw.Data ?? raw.data;
+  let nonce = 0;
+  if (typeof payload === "number" && !Number.isNaN(payload)) {
+    nonce = payload;
+  } else if (payload && typeof payload === "object") {
+    const n = payload.nonce ?? payload.Nonce;
+    nonce = typeof n === "number" && !Number.isNaN(n) ? n : Number(n) || 0;
+  }
+  return { nonce, ok: res.ok && (code === 0 || code === void 0), code: code ?? -1 };
+}
 function isEvmNativeToken(address) {
   try {
     return getAddress(address) === zeroAddress;
@@ -2219,6 +2288,31 @@ var MULTISIGN_OUTPUT_DOC = {
     }
   }
 };
+var MANAGEMENT_SIG_DOC = {
+  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.",
+  fields: {
+    nonce: {
+      type: "number",
+      description: "From GET /getPublicMgtKeyNonce (Ed25519) or GET /getNodeMgtKeyNonce (Ethereum NodeMgtKey)."
+    },
+    clientSig: {
+      type: "string",
+      description: "Management signature; empty string in the message to sign."
+    },
+    nodeKey: {
+      type: "string",
+      description: "Required. 128-hex MPC node id from GET /getNodeKey (no 0x prefix)."
+    }
+  },
+  helpers: {
+    managementSigFields: "Base envelope with clientSig cleared.",
+    buildManagementPostBody: "Spread managementSigFields then endpoint fields.",
+    messageToSignManagementBody: "Canonical JSON string to sign.",
+    withManagementClientSig: "Attach signature to POST body.",
+    fetchNodeKey: "GET /getNodeKey via nodeFetchWithReadAuth.",
+    fetchManagementNonce: "GET nonce for Ed25519 or Ethereum management key."
+  }
+};
 
 // src/agent/mcpTools.ts
 function paramProperties(params, includeCommon = []) {
@@ -2340,7 +2434,7 @@ var MCP_TOOL_DEFINITIONS = [
       "executorAddress matching MPC wallet",
       "RPC URL and chainDetail from node chain config"
     ],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
     handler: { importPath: "protocols/evm/uniswap-v4", exportName: "buildEvmMultisignBodyUniswapV4SkipPermit2Batch" },
     inputSchema: {
       type: "object",
@@ -2375,7 +2469,7 @@ var MCP_TOOL_DEFINITIONS = [
     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"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
     handler: { importPath: "protocols/evm/curve-dao", exportName: "buildEvmMultisignBodyCurveDaoBatch" },
     inputSchema: {
       type: "object",
@@ -2407,6 +2501,7 @@ function getAgentCatalogForMcp() {
     protocols: getProtocolModules(),
     commonParams: EVM_COMMON_PARAM_DOCS,
     multisignOutput: MULTISIGN_OUTPUT_DOC,
+    managementSig: MANAGEMENT_SIG_DOC,
     workflow: {
       evmSwapTypical: [
         "1. Quote (protocol-specific API if needed)",
@@ -2414,6 +2509,13 @@ function getAgentCatalogForMcp() {
         "3. build_*_multisign \u2192 { bodyForSign, messageToSign }",
         "4. Sign messageToSign (MetaMask or Ed25519)",
         "5. POST /multiSignRequest with clientSig and signedMessage"
+      ],
+      managementPostTypical: [
+        "1. GET /getNodeKey \u2192 nodeKey (128 hex)",
+        "2. GET /getPublicMgtKeyNonce or /getNodeMgtKeyNonce \u2192 nonce",
+        "3. buildManagementPostBody(nonce, nodeKey, { \u2026endpoint fields })",
+        "4. messageToSignManagementBody(body) \u2192 sign \u2192 withManagementClientSig(body, sig)",
+        "5. POST management route with signed body"
       ]
     }
   };
@@ -2441,6 +2543,6 @@ function getAgentCatalog() {
 registerProtocolModule(uniswapV4ProtocolModule);
 registerProtocolModule(curveDaoProtocolModule);
 
-export { NEAR_CHAIN_CATEGORY, SOLANA_CHAIN_CATEGORY, alignEip1559FeesWithLatestBase, buildEvmMultisignBatch, chainSnapshotForCustomGasExtraJSON, composeFeePayloadToTxParams, coreChainCategoryModule, curveDao, curveDaoProtocolModule, evmChainCategoryModule, fetchChainFeeParams, finalizeMultisign, firstClientIdFromKeyGen, gasLimitFromEstimateAndChainConfig, getActionsByChainCategory, getAgentCatalog, getProtocolModule, getProtocolModules, gweiToDecimalString, isEvmNativeToken, keyListFromKeyGen, matchEvmTokenKind, mergePurposeText, nearChainCategoryModule, nodeFetchWithReadAuth, parseEvmChainIdToNumber, proposalTxParamsToFeeSnapshot, registerProtocolModule, requirePubKeyHex, routerSwapGasLimitFromEstimate, solanaChainCategoryModule, triggerTxParamsFromComposeBody, uniswapV4, uniswapV4ProtocolModule };
+export { NEAR_CHAIN_CATEGORY, SOLANA_CHAIN_CATEGORY, alignEip1559FeesWithLatestBase, buildEvmMultisignBatch, buildManagementPostBody, chainSnapshotForCustomGasExtraJSON, composeFeePayloadToTxParams, coreChainCategoryModule, curveDao, curveDaoProtocolModule, evmChainCategoryModule, fetchChainFeeParams, fetchManagementNonce, fetchNodeKey, finalizeMultisign, firstClientIdFromKeyGen, gasLimitFromEstimateAndChainConfig, getActionsByChainCategory, getAgentCatalog, getProtocolModule, getProtocolModules, gweiToDecimalString, isEvmNativeToken, keyListFromKeyGen, managementSigFields, matchEvmTokenKind, mergePurposeText, messageToSignManagementBody, nearChainCategoryModule, nodeFetchWithReadAuth, normalizeManagementNodeKey, parseEvmChainIdToNumber, proposalTxParamsToFeeSnapshot, registerProtocolModule, requirePubKeyHex, routerSwapGasLimitFromEstimate, solanaChainCategoryModule, triggerTxParamsFromComposeBody, uniswapV4, uniswapV4ProtocolModule, withManagementClientSig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map