@continuumdao/ctm-mpc-defi 0.2.52 → 0.2.54

package/dist/agent/catalog.d.ts

@@ -519,12 +519,30 @@ declare const evmMultisignCommonInputSchema: z.ZodObject<{
 declare const multisignOutputSchema: z.ZodObject<{
     bodyForSign: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     messageToSign: z.ZodString;
+    proposalCatalog: z.ZodOptional<z.ZodObject<{
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        canonical: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        payload: Record<string, unknown>;
+        canonical: string;
+    }, {
+        payload: Record<string, unknown>;
+        canonical: string;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     bodyForSign: Record<string, unknown>;
     messageToSign: string;
+    proposalCatalog?: {
+        payload: Record<string, unknown>;
+        canonical: string;
+    } | undefined;
 }, {
     bodyForSign: Record<string, unknown>;
     messageToSign: string;
+    proposalCatalog?: {
+        payload: Record<string, unknown>;
+        canonical: string;
+    } | undefined;
 }>;
 /** Loose JSON object for protocol API responses passed between MCP tools. */
 declare const jsonObjectSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -11911,6 +11929,7 @@ declare const mcpContinuumDaoRegisterProposalInputSchema: z.ZodObject<{
     forumKey: z.ZodString;
     type: z.ZodNumber;
     configuration: z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>]>;
+    nWinners: z.ZodOptional<z.ZodNumber>;
     actions: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
     options: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -11923,6 +11942,7 @@ declare const mcpContinuumDaoRegisterProposalInputSchema: z.ZodObject<{
     onchainId: string;
     actions?: unknown[] | undefined;
     options?: unknown[] | undefined;
+    nWinners?: number | undefined;
 }, {
     type: number;
     description: string;
@@ -11933,6 +11953,7 @@ declare const mcpContinuumDaoRegisterProposalInputSchema: z.ZodObject<{
     onchainId: string;
     actions?: unknown[] | undefined;
     options?: unknown[] | undefined;
+    nWinners?: number | undefined;
 }>;
 declare const mcpContinuumDaoRegisterProposalOutputSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;

package/dist/agent/catalog.js

@@ -570,7 +570,7 @@ function listContinuumDaoDefaultAssets() {
   }
   return out;
 }
-var CONTINUUM_DAO_PROTOCOL_ID, CONTINUUM_DAO_ETHEREUM_CHAIN_ID, CONTINUUM_DAO_LINEA_CHAIN_ID, CONTINUUM_DAO_LINEA_SEPOLIA_CHAIN_ID, CTM_TOKEN_NAME, CTM_TOKEN_SYMBOL, VECTM_TOKEN_NAME, VECTM_TOKEN_SYMBOL, CTM_TOKEN_DECIMALS, UNSET, CTM_TOKEN_ADDRESS, VOTING_ESCROW_LINEA_ADDRESS, VOTING_ESCROW_MARKETPLACE_LINEA_ADDRESS, CONTINUUM_DAO_MARKETPLACE_PROTOCOL_ID, CONTINUUM_DAO_DEPLOYMENTS;
+var CONTINUUM_DAO_PROTOCOL_ID, CONTINUUM_DAO_ETHEREUM_CHAIN_ID, CONTINUUM_DAO_LINEA_CHAIN_ID, CONTINUUM_DAO_LINEA_SEPOLIA_CHAIN_ID, CTM_TOKEN_NAME, CTM_TOKEN_SYMBOL, VECTM_TOKEN_NAME, VECTM_TOKEN_SYMBOL, CTM_TOKEN_DECIMALS, UNSET, CTM_TOKEN_ADDRESS, VOTING_ESCROW_LINEA_ADDRESS, VOTING_ESCROW_MARKETPLACE_LINEA_ADDRESS, CONTINUUM_DAO_MARKETPLACE_PROTOCOL_ID, CONTINUUM_DAO_LINEA_GOVERNOR_ADDRESS, CONTINUUM_DAO_DEPLOYMENTS;
 var init_constants2 = __esm({
   "src/protocols/evm/continuum-dao/constants.ts"() {
     CONTINUUM_DAO_PROTOCOL_ID = "continuum-dao";
@@ -596,18 +596,14 @@ var init_constants2 = __esm({
     getAddress("0xe5D7C2a44FfDDf6b295A15c148167daaAf5Cf34f");
     getAddress("0x176211869cA2b568f2A7D4EE941E073a821EE1ff");
     CONTINUUM_DAO_MARKETPLACE_PROTOCOL_ID = "continuum-dao-marketplace";
-    getAddress("0x76FF2CB03175900F1D83328C82D27EA9aeaF2355");
+    CONTINUUM_DAO_LINEA_GOVERNOR_ADDRESS = getAddress("0x76FF2CB03175900F1D83328C82D27EA9aeaF2355");
     getAddress("0x4800F9f1dC1b6daCA841B71E0531F547D374168E");
-    [
-      getAddress("0xd23eecBe0362F36b254F774C274823Cbfc482a10"),
-      getAddress("0x482cdCbdd72ef307997153Ee7eb627B7a2348d34"),
-      getAddress("0x14C189354702b7f2aC7b19e61522A41632226BD8")
-    ];
     CONTINUUM_DAO_DEPLOYMENTS = {
       [CONTINUUM_DAO_LINEA_CHAIN_ID]: {
         ...UNSET,
         ctm: CTM_TOKEN_ADDRESS,
-        votingEscrow: VOTING_ESCROW_LINEA_ADDRESS
+        votingEscrow: VOTING_ESCROW_LINEA_ADDRESS,
+        governor: CONTINUUM_DAO_LINEA_GOVERNOR_ADDRESS
       },
       [CONTINUUM_DAO_LINEA_SEPOLIA_CHAIN_ID]: { ...UNSET },
       [CONTINUUM_DAO_ETHEREUM_CHAIN_ID]: {
@@ -617,6 +613,20 @@ var init_constants2 = __esm({
     };
   }
 });
+var init_committeeList = __esm({
+  "src/protocols/evm/continuum-dao/committeeList.ts"() {
+  }
+});
+var init_proposalCatalog = __esm({
+  "src/protocols/evm/continuum-dao/proposalCatalog.ts"() {
+    ({
+      name: "linea",
+      label: "Linea",
+      chainId: "59144",
+      c3governor: getAddress("0x58B610a359c870E0fc941139821a51F5aa23f14E")
+    });
+  }
+});
 var init_forum = __esm({
   "src/protocols/evm/continuum-dao/forum.ts"() {
   }
@@ -1282,7 +1292,11 @@ var multisignOutputSchema = z.object({
   bodyForSign: z.record(z.unknown()).describe(
     "POST body fields without clientSig: keyList, pubKey, msgHash, msgRaw, destinationChainID, purpose, extraJSON, proposalTxParams (batch), messageHashes/messageRawBatch when N>1 txs."
   ),
-  messageToSign: z.string().describe("JSON.stringify(bodyForSign) \u2014 exact string to sign before adding clientSig.")
+  messageToSign: z.string().describe("JSON.stringify(bodyForSign) \u2014 exact string to sign before adding clientSig."),
+  proposalCatalog: z.object({
+    payload: z.record(z.unknown()),
+    canonical: z.string()
+  }).optional().describe("Unsigned POST /proposals/create body and the canonical string to sign before the multisign is submitted.")
 }).describe(
   "Unsigned mpc-auth multiSignRequest payload from protocol builders (used internally before management submit)."
 );
@@ -3297,8 +3311,11 @@ var govOptionSchema = z.object({
 var forumTopicKeyField = z.string().min(1).describe(
   "URL of the Governance forum thread created first with ctm_continuum_dao_forum_create_topic (decision / election / treasury / constitution / admin). Must be /topic/:tid or /t/:tid. Ideas threads and the homepage are refused."
 );
+var proposalTypeField = z.number().int().min(0).max(4).describe("0 Admin, 1 Constitution, 2 Decision, 3 Election, 4 Treasury. Must match the forum thread section.");
 var mcpContinuumDaoProposeBravoInputSchema = mcpMultisignInput({
   title: z.string().min(1).max(128),
+  description: z.string().describe("Catalog description stored by POST /proposals/create."),
+  type: proposalTypeField,
   actions: z.array(govActionSchema).optional(),
   governor: evmAddressSchema.optional(),
   noOpTarget: evmAddressSchema.optional(),
@@ -3307,6 +3324,8 @@ var mcpContinuumDaoProposeBravoInputSchema = mcpMultisignInput({
 });
 var mcpContinuumDaoProposeDeltaInputSchema = mcpMultisignInput({
   title: z.string().min(1).max(128),
+  description: z.string().describe("Catalog description stored by POST /proposals/create."),
+  type: proposalTypeField,
   options: z.array(govOptionSchema).min(2),
   nWinners: z.union([z.string(), z.number()]),
   governor: evmAddressSchema.optional(),
@@ -3689,6 +3708,7 @@ var mcpContinuumDaoRegisterProposalInputSchema = z.object({
   forumKey: forumTopicKeyField,
   type: z.number().int().min(0).max(4),
   configuration: z.union([z.literal(0), z.literal(1)]),
+  nWinners: z.number().int().min(0).optional(),
   actions: z.array(z.unknown()).optional(),
   options: z.array(z.unknown()).optional()
 });
@@ -4018,12 +4038,14 @@ var mcpContinuumDaoForumSignInEligibleOutputSchema = z.object({
   tokenId: z.string().optional()
 });
 var mcpContinuumDaoForumSignInInputSchema = mcpMultisignInput({
-  nodeKey: z.string().optional().describe("Node key bound to this KeyGen. Required when useNodeKeyUsername is true. A node key does not choose the username by itself."),
+  nodeKey: z.string().optional().describe(
+    "Node key bound to this KeyGen. Always required on KeyGen forum sign-in, including when username is a custom name. The server fills it from this node when omitted. useNodeKeyUsername does not replace it."
+  ),
   username: z.string().min(2).max(16).regex(/^[A-Za-z0-9._-]+$/).optional().describe(
     "Custom forum username for a wallet or a KeyGen. Ask the operator before calling. 2\u201316 letters, numbers, . _ -."
   ),
   useNodeKeyUsername: z.boolean().optional().describe(
-    "Set true only after the operator declines a custom username. The forum assigns the first 16 characters of nodeKey."
+    "Set true only after the operator declines a custom username. The forum assigns the first 16 characters of nodeKey as the username. Still pass nodeKey."
   ),
   forumUrl: z.string().optional()
 });
@@ -7101,7 +7123,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.propose-bravo",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build ContinuumDAO.propose for a Bravo (For/Against/Abstain) proposal. Refuses if getVotes(KeyGen) < live proposalThreshold() or propose() reverts. Sequential execute dry-run is the Foundry forge scripts from ctm_continuum_dao_simulate_proposal (not isolated eth_call). For a draft from a different EOA use that tool with account. forumKey is required and must be a Governance thread (/topic/:tid) from ctm_continuum_dao_forum_create_topic (decision / election / treasury / constitution / admin). Ideas threads and the homepage are refused. Empty actions insert a no-op to the KeyGen address. Linea only. No billing legs. After the request is mined, call ctm_continuum_dao_register_proposal with the same forumKey.",
+    description: "Build ContinuumDAO.propose for a Bravo (For/Against/Abstain) proposal and POST /proposals/create (pendingOnChain) before the multi-sign request is submitted. Requires description and type (0\u20134) matching the forum section. Refuses if getVotes(KeyGen) < live proposalThreshold(), the forum section does not match type, or propose() reverts. forumKey must be a Governance thread from ctm_continuum_dao_forum_create_topic. Ideas threads and the homepage are refused. Empty actions insert a no-op to the KeyGen address. Linea only. No billing legs. register_proposal is only a retry if this POST failed.",
     prerequisites: [
       "keyGen",
       "Linea RPC",
@@ -7110,7 +7132,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
       "forumKey from forum_create_topic",
       "governor-executed actions must simulate without revert"
     ],
-    followUp: [...MCP_MULTISIGN_SUBMIT_FOLLOW_UP, "ctm_continuum_dao_register_proposal"],
+    followUp: [...MCP_MULTISIGN_SUBMIT_FOLLOW_UP],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoProposeBravo" },
     inputZod: mcpContinuumDaoProposeBravoInputSchema
   }),
@@ -7119,7 +7141,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.propose-delta",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build ContinuumDAO.propose for a Delta multi-option proposal. Refuses if getVotes(KeyGen) < live proposalThreshold() or propose() reverts. Sequential execute dry-run is the Foundry forge scripts from ctm_continuum_dao_simulate_proposal (not isolated eth_call). For a draft from a different EOA use that tool with account. forumKey is required and must be a Governance thread from ctm_continuum_dao_forum_create_topic. Ideas threads are not valid forumKey values. Empty options get a no-op so indices increment. Linea only. No billing legs.",
+    description: "Build ContinuumDAO.propose for a Delta multi-option proposal and POST /proposals/create (pendingOnChain) before the multi-sign request is submitted. Requires description and type (0\u20134) matching the forum section. Refuses if getVotes(KeyGen) < live proposalThreshold(), the forum section does not match type, or propose() reverts. forumKey must be a Governance thread from ctm_continuum_dao_forum_create_topic. Empty options get a no-op so indices increment. Linea only. No billing legs.",
     prerequisites: [
       "keyGen",
       "at least 2 options",
@@ -7128,7 +7150,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
       "forumKey from forum_create_topic",
       "governor-executed actions must simulate without revert"
     ],
-    followUp: [...MCP_MULTISIGN_SUBMIT_FOLLOW_UP, "ctm_continuum_dao_register_proposal"],
+    followUp: [...MCP_MULTISIGN_SUBMIT_FOLLOW_UP],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoProposeDeltaFromMcp" },
     inputZod: mcpContinuumDaoProposeDeltaInputSchema
   }),
@@ -7177,11 +7199,11 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-sign-in",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build an EIP-712 forum login multi-sign (no EVM tx). Refuses when this node already has a live forum session for the KeyGen (getForumSession plus forum_me loggedIn) and returns that ticket instead of creating a sign request. Checks current balanceOfNFT on an owned or attached veCTM against MultiSignAgentWallet.veCtmThresholdPower and refuses if that power is short, so other nodes never enter the sign loop. Ask the operator for a custom username (2\u201316 letters, numbers, . _ -) and pass it as username. If they decline, set useNodeKeyUsername true with nodeKey; the forum assigns the first 16 characters of the node key. After Get Sig, node-app stores the ticket on the node.",
+    description: "Build an EIP-712 forum login multi-sign (no EVM tx). Refuses when this node already has a live forum session for the KeyGen (getForumSession plus forum_me loggedIn) and returns that ticket instead of creating a sign request. Checks current balanceOfNFT on an owned or attached veCTM against MultiSignAgentWallet.veCtmThresholdPower and refuses if that power is short, so other nodes never enter the sign loop. Always include nodeKey from this node; a custom username does not omit it. Ask the operator for a custom username (2\u201316 letters, numbers, . _ -) and pass it as username. If they decline, set useNodeKeyUsername true; the forum assigns the first 16 characters of the node key as the username. After Get Sig, node-app stores the ticket on the node. The forum stores the verified node key on that user, including when the user already exists, which is what allows MPA Wallet Chat.",
     prerequisites: [
       "keyGen",
       "current balanceOfNFT on an owned or attached veCTM at or above MultiSignAgentWallet.veCtmThresholdPower",
-      "username from the operator, or useNodeKeyUsername with nodeKey"
+      "nodeKey from this node, plus username from the operator or useNodeKeyUsername"
     ],
     followUp: [...MCP_MULTISIGN_SUBMIT_FOLLOW_UP, "ctm_continuum_dao_forum_me"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoForumSignIn" },
@@ -9400,7 +9422,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.register-proposal",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "POST /proposals/create so app.continuumdao.org stays in sync. Call after the propose multi-sign request is mined. Does not revert the chain tx if this fails \u2014 retry.",
+    description: "Retry POST /proposals/create when the propose tool\u2019s optimistic catalog write failed. The node signs with Ed25519. Does not revert a chain tx.",
     prerequisites: ["onchainId from hashProposal or ProposalCreated", "title", "proposer", "forumKey", "type", "configuration"],
     followUp: [],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoRegisterProposal" },
@@ -9664,7 +9686,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-me",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Current forum user, votes, canPropose (Governance), canPostIdea (Ideas), and canPostMpa (MPA Wallet Chat listings / mailbox).",
+    description: "Current forum user, votes, canPropose (Governance), canPostIdea (Ideas), and canPostMpa (MPA Wallet Chat listings / mailbox). canPropose is governor getVotes(address, clock-1) >= proposalThreshold(). Null votes means that read failed \u2014 do not say the KeyGen has no veCTM. Attachment is get_ve_ctm_attach_status, not this flag.",
     prerequisites: [],
     followUp: [
       "ctm_continuum_dao_forum_unread",
@@ -12352,6 +12374,8 @@ var continuumDaoMarketplaceProtocolModule = {
 
 // src/protocols/evm/continuum-dao/index.ts
 init_constants2();
+init_committeeList();
+init_proposalCatalog();
 init_governance();
 init_simulateProposal();
 init_foundryProposalScript();
@@ -14360,7 +14384,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. 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). After naming a proposal, offer ctm_continuum_dao_fetch_proposal_votes to see who voted and how. 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. After naming a proposal, offer ctm_continuum_dao_fetch_proposal_votes to see who voted and how. 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). After naming a proposal, offer ctm_continuum_dao_fetch_proposal_votes to see who voted and how. 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. build_propose_* writes POST /proposals/create before the multi-sign request; register_proposal is only a retry. 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. After naming a proposal, offer ctm_continuum_dao_fetch_proposal_votes to see who voted and how. 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. build_propose_* writes POST /proposals/create before the multi-sign request; register_proposal is only a retry. Queue is not implemented.`
       };
     }
   }),