@continuumdao/ctm-mpc-defi 0.2.37 → 0.2.39

package/dist/agent/catalog.js

@@ -1063,7 +1063,9 @@ var evmAddressSchema = z.string().min(1).describe("EVM address (0x-prefixed, 40
 var keyGenSchema = z.object({
   pubkeyhex: z.string().min(1).describe("MPC secp256k1 public key hex (required for multiSignRequest pubKey)"),
   keylist: z.array(z.string()).optional().describe("Key list on the sign request"),
-  ClientKeys: z.record(z.string()).optional().describe("Optional client key map from keyGen")
+  ClientKeys: z.record(z.string()).optional().describe("Optional client key map from keyGen"),
+  groupId: z.string().optional().describe("mpc-auth GroupId of this KeyGen (server-filled from getKeyGenGroupId)"),
+  GroupId: z.string().optional().describe("Alias for groupId from KeyGen result payloads")
 }).describe(
   "MPC key slice: { pubkeyhex, keylist?, ClientKeys? }. Used for pubKey/keyList on POST /multiSignRequest."
 );
@@ -2804,8 +2806,8 @@ var mcpMorphoMidnightRepayInputSchema = withMultisignKeySourceRefine(
   )
 );
 var mcpContinuumDaoCreateLockInputSchema = mcpMultisignInput({
-  amountHuman: z.string().min(1).describe("CTM amount to lock"),
-  lockDurationSeconds: z.union([z.string(), z.number()]).describe("Lock duration in seconds"),
+  amountHuman: z.string().min(1).describe("CTM amount to lock. Must be >= VotingEscrow.minimumLock (default 1 CTM)."),
+  lockDurationSeconds: z.union([z.string(), z.number()]).describe("Lock duration in seconds. Must be 1\u2013208 weeks (week-aligned on-chain)."),
   ctm: evmAddressSchema.optional(),
   votingEscrow: evmAddressSchema.optional()
 });
@@ -2822,7 +2824,7 @@ var mcpContinuumDaoIncreaseUnlockTimeInputSchema = mcpMultisignInput({
 });
 var mcpContinuumDaoSplitInputSchema = mcpMultisignInput({
   tokenId: z.union([z.string(), z.number()]),
-  extractedHuman: z.string().min(1),
+  extractedHuman: z.string().min(1).describe("CTM extracted into the new lock. Minimum 1 CTM; original lock must also keep 1 CTM."),
   votingEscrow: evmAddressSchema.optional()
 });
 var mcpContinuumDaoMergeInputSchema = mcpMultisignInput({
@@ -5448,8 +5450,14 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.create-lock",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build batch: CTM approve (if needed) + VotingEscrow.create_lock. Linea only. Do not prepend billing legs.",
-    prerequisites: ["keyGen", "executorAddress", "Linea RPC", "configured CTM and VotingEscrow addresses"],
+    description: "Build batch: CTM approve (if needed) + VotingEscrow.create_lock. Amount must be >= on-chain minimumLock (default 1 CTM). Duration 1\u2013208 weeks. Linea only. Do not prepend billing legs.",
+    prerequisites: [
+      "keyGen",
+      "executorAddress",
+      "Linea RPC",
+      "amountHuman >= 1 CTM (or live minimumLock)",
+      "lockDurationSeconds 1\u2013208 weeks"
+    ],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoCreateLock" },
     inputZod: mcpContinuumDaoCreateLockInputSchema
   }),
@@ -5458,8 +5466,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.increase-amount",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build batch: CTM approve (if needed) + increase_amount.",
-    prerequisites: ["keyGen", "tokenId", "Linea RPC"],
+    description: "Build batch: CTM approve (if needed) + increase_amount. Refuses expired locks, zero amount, and amounts above KeyGen CTM balance.",
+    prerequisites: ["keyGen", "tokenId", "unexpired lock", "Linea RPC"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoIncreaseAmount" },
     inputZod: mcpContinuumDaoIncreaseAmountInputSchema
   }),
@@ -5468,8 +5476,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.increase-unlock-time",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build increase_unlock_time. lockDurationSeconds is from the week boundary to the new unlock.",
-    prerequisites: ["keyGen", "tokenId", "Linea RPC"],
+    description: "Build increase_unlock_time on Linea VotingEscrow. lockDurationSeconds is from the week boundary to the new unlock (1\u2013208 weeks) and must land after the current lock end. No billing legs \u2014 allowed on an unpaid KeyGen (does not increment globalNonce). To attach in the same request, extend first then attachVeCtm so attach sees the new voting power.",
+    prerequisites: ["keyGen", "tokenId", "unexpired lock", "Linea RPC"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoIncreaseUnlockTime" },
     inputZod: mcpContinuumDaoIncreaseUnlockTimeInputSchema
   }),
@@ -5478,8 +5486,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.split",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build VotingEscrow.split. Blocked on-chain while the token is node-attached.",
-    prerequisites: ["keyGen", "tokenId", "Linea RPC"],
+    description: "Build VotingEscrow.split. New lock and remainder must each keep at least minimumLock (default 1 CTM). Blocked while node-attached or expired.",
+    prerequisites: ["keyGen", "tokenId", "extractedHuman >= 1 CTM", "remainder >= 1 CTM", "unattached lock"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoSplit" },
     inputZod: mcpContinuumDaoSplitInputSchema
   }),
@@ -5488,8 +5496,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.merge",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build VotingEscrow.merge. Blocked on-chain while either token is node-attached.",
-    prerequisites: ["keyGen", "fromTokenId", "toTokenId", "Linea RPC"],
+    description: "Build VotingEscrow.merge. Both NFTs must be owned by the KeyGen and unattached. Blocked if either token is node-attached.",
+    prerequisites: ["keyGen", "fromTokenId", "toTokenId", "same owner", "neither attached"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoMerge" },
     inputZod: mcpContinuumDaoMergeInputSchema
   }),
@@ -5498,8 +5506,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.withdraw",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build VotingEscrow.withdraw for an expired, unattached lock.",
-    prerequisites: ["keyGen", "tokenId", "Linea RPC"],
+    description: "Build VotingEscrow.withdraw for an expired, unattached lock. Refuses if still locked or node-attached.",
+    prerequisites: ["keyGen", "tokenId", "lock expired", "unattached"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoWithdraw" },
     inputZod: mcpContinuumDaoTokenIdInputSchema
   }),
@@ -5508,8 +5516,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.liquidate",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build VotingEscrow.liquidate. Blocked on-chain while the token is node-attached.",
-    prerequisites: ["keyGen", "tokenId", "Linea RPC"],
+    description: "Build VotingEscrow.liquidate. Refuses if attached, liquidations disabled, locked amount <= 100 gwei, or penalty would be zero. Expired locks withdraw instead on-chain.",
+    prerequisites: ["keyGen", "tokenId", "liquidationsEnabled", "unattached"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoLiquidate" },
     inputZod: mcpContinuumDaoTokenIdInputSchema
   }),
@@ -5518,7 +5526,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.delegate",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build VotingEscrow.delegate(delegatee). Moves all veCTM voting power from the KeyGen to delegatee. Governor getVotes is then at the delegatee. Use undelegate to return power to the KeyGen.",
+    description: "Build VotingEscrow.delegate(delegatee). Moves all veCTM voting power from the KeyGen to delegatee. Refuses the zero address and this KeyGen (use undelegate). Governor getVotes is then at the delegatee. Does not change the fee waiver or VPN gate \u2014 those use the attached NFT balanceOfNFTAt at UTC month start, not getVotes.",
     prerequisites: ["keyGen", "delegatee", "Linea RPC"],
     followUp: ["ctm_continuum_dao_fetch_delegates", "ctm_continuum_dao_build_undelegate_multisign"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoDelegate" },
@@ -5529,7 +5537,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.undelegate",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Return veCTM voting power to the KeyGen. There is no undelegate() on VotingEscrow \u2014 this calls delegate(self). address(0) would also become self on-chain.",
+    description: "Return veCTM voting power to the KeyGen. There is no undelegate() on VotingEscrow \u2014 this calls delegate(self). Refuses if power is already at this KeyGen.",
     prerequisites: ["keyGen", "Linea RPC"],
     followUp: ["ctm_continuum_dao_fetch_delegates"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoUndelegate" },
@@ -5540,8 +5548,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.transfer",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build VotingEscrow.transferFrom. Blocked on-chain while the token is node-attached.",
-    prerequisites: ["keyGen", "tokenId", "to", "Linea RPC"],
+    description: "Build VotingEscrow.transferFrom. Refuses node-attached tokens, the zero address, and self-transfers.",
+    prerequisites: ["keyGen", "tokenId", "to", "unattached"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoTransfer" },
     inputZod: mcpContinuumDaoTransferInputSchema
   }),
@@ -5550,8 +5558,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.attach",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build MultiSignAgentWallet.attachVeCtm. Authority KeyGen only. Cannot replace an attached NFT. No billing legs.",
-    prerequisites: ["keyGen", "nodeKey", "tokenId", "mpaWallet"],
+    description: "Build MultiSignAgentWallet.attachVeCtm(nodeKey, tokenId, nodeInfo, groupId). groupId is the attaching KeyGen's mpc-auth GroupId (server-filled; do not pick another group) and binds the fee waiver immediately. Caller must be nodeWithdrawAuthority and own the NFT. This KeyGen cannot attach a second NFT; a second group on the same node attaches after rotating authority to that group's secp256k1 KeyGen. Locked CTM must meet veCtmThresholdPower at attach; the monthly waiver/VPN then use that NFT's balanceOfNFTAt at UTC month start (governor getVotes and inbound delegation do not count). No billing legs.",
+    prerequisites: ["keyGen is nodeWithdrawAuthority", "owns tokenId", "this KeyGen has no attach", "mpaWallet"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoAttachVeCtmFromMcp" },
     inputZod: mcpContinuumDaoAttachInputSchema
   }),
@@ -5560,8 +5568,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.request-detach",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build NodeProperties.setNodeRemovalStatus(tokenId, true). Governance must complete detach.",
-    prerequisites: ["keyGen", "tokenId", "nodeProperties"],
+    description: "Build NodeProperties.setNodeRemovalStatus(tokenId, true). Compose from the KeyGen that owns the attached NFT (not the current withdraw authority unless they are the same). Refuses if not attached or detach already requested. Only governance detachNode actually detaches.",
+    prerequisites: ["keyGen is attached owner", "tokenId attached", "detach not already requested"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoRequestDetach" },
     inputZod: mcpContinuumDaoRequestDetachInputSchema
   }),
@@ -5604,8 +5612,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.cast-vote-bravo",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build ContinuumDAO.castVote. support: 0 against, 1 for, 2 abstain.",
-    prerequisites: ["keyGen", "proposalId", "Active proposal"],
+    description: "Build ContinuumDAO.castVote. support: 0 against, 1 for, 2 abstain. Refuses unless the proposal is Active, the KeyGen has snapshot voting power, and has not already voted.",
+    prerequisites: ["keyGen", "proposalId", "Active proposal", "snapshot votes > 0", "hasVoted false"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoCastVoteBravoFromMcp" },
     inputZod: mcpContinuumDaoCastVoteBravoInputSchema
   }),
@@ -5614,8 +5622,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.cast-vote-delta",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build ContinuumDAO.castVoteWithReasonAndParams. weights must be nOptions + 1 (final slot is NOTA).",
-    prerequisites: ["keyGen", "proposalId", "weights including NOTA"],
+    description: "Build ContinuumDAO.castVoteWithReasonAndParams. weights must be nOptions + 1 (final slot is NOTA). Same Active / snapshot / hasVoted gates as Bravo.",
+    prerequisites: ["keyGen", "proposalId", "weights including NOTA", "Active proposal", "snapshot votes > 0"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoCastVoteDelta" },
     inputZod: mcpContinuumDaoCastVoteDeltaInputSchema
   }),
@@ -9575,15 +9583,18 @@ var UNSET = {
   rewards: zeroAddress,
   governor: zeroAddress
 };
+var CTM_TOKEN_ADDRESS = getAddress("0x2026027054F5beBCEB650aBD62dC623e327658e7");
+var VOTING_ESCROW_LINEA_ADDRESS = getAddress("0x221EC90B3B083A8501A37bdeb7035CeaedF3C31f");
 var CONTINUUM_DAO_DEPLOYMENTS = {
-  [CONTINUUM_DAO_LINEA_CHAIN_ID]: { ...UNSET },
+  [CONTINUUM_DAO_LINEA_CHAIN_ID]: {
+    ...UNSET,
+    ctm: CTM_TOKEN_ADDRESS,
+    votingEscrow: VOTING_ESCROW_LINEA_ADDRESS
+  },
   [CONTINUUM_DAO_LINEA_SEPOLIA_CHAIN_ID]: { ...UNSET },
   [CONTINUUM_DAO_ETHEREUM_CHAIN_ID]: {
-    ctm: zeroAddress,
-    votingEscrow: zeroAddress,
-    nodeProperties: zeroAddress,
-    rewards: zeroAddress,
-    governor: zeroAddress
+    ...UNSET,
+    ctm: CTM_TOKEN_ADDRESS
   }
 };
 function isConfiguredAddress(addr) {
@@ -9667,7 +9678,7 @@ var continuumDaoProtocolModule = {
     { id: "continuum-dao.undelegate", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Return voting power to the KeyGen (delegate to self)", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
     { id: "continuum-dao.fetch-delegates", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Read VotingEscrow.delegates(account)", commonParams: [], params: { account: { type: "string", required: true, description: "KeyGen or wallet address" } } },
     { id: "continuum-dao.transfer", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Transfer a veCTM NFT", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { tokenId: { type: "string", required: true, description: "veCTM token id" }, to: { type: "string", required: true, description: "Recipient" } } },
-    { id: "continuum-dao.attach", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Attach veCTM to the node (authority KeyGen)", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { nodeKey: { type: "string", required: true, description: "Node key" }, tokenId: { type: "string", required: true, description: "veCTM token id" }, mpaWallet: { type: "string", required: true, description: "MultiSignAgentWallet address" } } },
+    { id: "continuum-dao.attach", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Attach veCTM to the node (authority KeyGen). groupId is implicit from that KeyGen and binds the fee waiver. A second group attaches after rotating authority.", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { nodeKey: { type: "string", required: true, description: "Node key" }, tokenId: { type: "string", required: true, description: "veCTM token id" }, mpaWallet: { type: "string", required: true, description: "MultiSignAgentWallet address" } } },
     { id: "continuum-dao.request-detach", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Request governance detach", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { tokenId: { type: "string", required: true, description: "Attached token id" }, nodeProperties: { type: "string", required: true, description: "NodeProperties address" } } },
     { id: "continuum-dao.propose-bravo", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Propose a Bravo (For/Against/Abstain) proposal", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { title: { type: "string", required: true, description: "On-chain description (title)" }, forumKey: { type: "string", required: true, description: "Created forum thread URL from forum_create_topic" } } },
     { id: "continuum-dao.propose-delta", protocolId: CONTINUUM_DAO_PROTOCOL_ID, chainCategory: "evm", description: "Propose a Delta multi-option proposal", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { title: { type: "string", required: true, description: "On-chain description (title)" }, nWinners: { type: "number", required: true, description: "Winning options to execute" }, forumKey: { type: "string", required: true, description: "Created forum thread URL from forum_create_topic" } } },
@@ -11161,7 +11172,7 @@ var PROTOCOL_SUPPORT_ADVISORS = {
       if (ve) tokens.push({ address: ve, symbol: "veCTM", roles: ["position_nft"] });
       return {
         tokens,
-        notes: tokens.length === 0 ? "ContinuumDAO addresses are placeholders until redeploy. Lock/attach/governance stay Linea-only. Prefer live GET /protocol/dao. For \u201Cwhat proposals are live now?\u201D use ctm_continuum_dao_fetch_live_proposals (not fetch_proposals). Propose requires getVotes >= live proposalThreshold() (max of 1000e18 ve power and 1% of total votes). Bravo empty actions insert a KeyGen no-op; Delta votes need nOptions+1 weights (last is NOTA). No billing legs. After propose is mined, ctm_continuum_dao_register_proposal. Queue is not implemented." : `Default ContinuumDAO assets: ${listContinuumDaoDefaultAssets().filter((a) => a.chainId === chainId).map((a) => a.symbol).join(", ")}. Lock/attach/governance stay Linea-only. For \u201Cwhat proposals are live now?\u201D use ctm_continuum_dao_fetch_live_proposals. Propose requires getVotes >= live proposalThreshold() (max of 1000e18 ve power and 1% of total votes). Bravo empty actions insert a KeyGen no-op; Delta votes need nOptions+1 weights (last is NOTA). No billing legs. After propose is mined, ctm_continuum_dao_register_proposal. Queue is not implemented.`
+        notes: tokens.length === 0 ? "ContinuumDAO addresses are placeholders until redeploy. Lock/attach/governance stay Linea-only. Create lock needs >= 1 CTM (live minimumLock) and 1\u2013208 weeks. Prefer live GET /protocol/dao. For \u201Cwhat proposals are live now?\u201D use ctm_continuum_dao_fetch_live_proposals (not fetch_proposals). Propose requires getVotes >= live proposalThreshold() (max of 1000e18 ve power and 1% of total votes). Bravo empty actions insert a KeyGen no-op; Delta votes need nOptions+1 weights (last is NOTA). No billing legs. After propose is mined, ctm_continuum_dao_register_proposal. Queue is not implemented." : `Default ContinuumDAO assets: ${listContinuumDaoDefaultAssets().filter((a) => a.chainId === chainId).map((a) => a.symbol).join(", ")}. Lock/attach/governance stay Linea-only. Create lock needs >= 1 CTM (live minimumLock) and 1\u2013208 weeks. For \u201Cwhat proposals are live now?\u201D use ctm_continuum_dao_fetch_live_proposals. Propose requires getVotes >= live proposalThreshold() (max of 1000e18 ve power and 1% of total votes). Bravo empty actions insert a KeyGen no-op; Delta votes need nOptions+1 weights (last is NOTA). No billing legs. After propose is mined, ctm_continuum_dao_register_proposal. Queue is not implemented.`
       };
     }
   }),