@continuumdao/ctm-mpc-defi 0.2.60 → 0.2.62

package/dist/agent/catalog.cjs

@@ -4600,7 +4600,8 @@ var mcpRailgunFetchPrivateBalancesOutputSchema = zod.z.object({
   scanned: zod.z.boolean(),
   scanStatus: zod.z.enum(["scanning", "ready", "empty", "error", "unscanned"]),
   balances: zod.z.array(mcpRailgunPrivateBalanceSchema),
-  notes: zod.z.string()
+  notes: zod.z.string(),
+  shieldSignature: zod.z.string().optional()
 }).strict();
 var mcpRailgunEnsureWalletInputSchema = zod.z.object({
   keyGenId: zod.z.string().min(1),
@@ -4608,40 +4609,66 @@ var mcpRailgunEnsureWalletInputSchema = zod.z.object({
 }).strict();
 var mcpRailgunEnsureWalletOutputSchema = zod.z.object({
   railgunAddress: zod.z.string(),
-  created: zod.z.boolean()
+  created: zod.z.boolean(),
+  shieldSignature: zod.z.string().optional()
 }).strict();
 var mcpRailgunShieldInputSchema = mcpMultisignInput({
   tokenAddress: evmAddressSchema.describe("ERC-20 contract to shield"),
   amountWei: zod.z.string().min(1).describe("Amount in wei"),
   railgunAddress: zod.z.string().min(1).describe("Recipient 0zk address"),
-  shieldSignature: zod.z.string().min(1).optional().describe("personal_sign result from the first shield call. Omit on the first call.")
+  shieldSignature: zod.z.string().min(1).optional().describe("Stored Railgun shield key. Omit this. The server reads it from the KeyGen.")
 });
 var mcpRailgunPrivateTransferInputSchema = zod.z.object({
   keyGenId: zod.z.string().min(1),
   chainId: agentEvmChainIdSchema,
   tokenAddress: evmAddressSchema,
   amountWei: zod.z.string().min(1),
-  recipientAddress: zod.z.string().min(1).describe("Recipient 0zk address"),
-  memoText: zod.z.string().optional()
+  recipientAddress: zod.z.string().min(1).optional().describe("Recipient 0zk address. Omit when toContactName is set."),
+  toContactName: zod.z.string().min(1).optional().describe("Address-book contact name. Uses that contact\u2019s saved 0zk address, not their Ethereum address."),
+  memoText: zod.z.string().optional(),
+  purpose: zod.z.string().max(256).optional().describe("Purpose shown on Join, Execute, and History. Same field as a normal sign request.")
 }).strict();
 var mcpRailgunUnshieldInputSchema = zod.z.object({
   keyGenId: zod.z.string().min(1),
   chainId: agentEvmChainIdSchema,
   tokenAddress: evmAddressSchema,
   amountWei: zod.z.string().min(1),
-  recipientAddress: evmAddressSchema.optional().describe("Public recipient. Defaults to this KeyGen Ethereum address.")
+  recipientAddress: evmAddressSchema.optional().describe("Public recipient. Defaults to this KeyGen Ethereum address."),
+  purpose: zod.z.string().max(256).optional().describe("Purpose shown on Join, Execute, and History. Same field as a normal sign request.")
 }).strict();
 var mcpRailgunAgreeSpendInputSchema = zod.z.object({
   keyGenId: zod.z.string().min(1),
-  spendId: zod.z.string().min(1)
+  spendId: zod.z.string().min(1),
+  thoughts: zod.z.string().max(256).optional().describe("Optional comment stored for this node, the same thoughts field as sign_request_agree.")
+}).strict();
+var mcpRailgunFeeQuoteInputSchema = zod.z.object({
+  keyGenId: zod.z.string().min(1),
+  chainId: agentEvmChainIdSchema,
+  kind: zod.z.enum(["shield", "transfer", "unshield"]),
+  tokenAddress: evmAddressSchema,
+  amountWei: zod.z.string().min(1).describe("Amount in wei. Use 0 to read the percentage and broadcaster fee before an amount is chosen."),
+  recipientAddress: zod.z.string().optional().describe("0zk address for a private transfer, or a public address for an unshield."),
+  memoText: zod.z.string().optional()
+}).strict();
+var mcpRailgunFeeQuoteSchema = zod.z.object({
+  kind: zod.z.enum(["shield", "transfer", "unshield"]),
+  amountWei: zod.z.string(),
+  protocolFeeBasisPoints: zod.z.string(),
+  protocolFeeWei: zod.z.string(),
+  receivedWei: zod.z.string(),
+  broadcasterFeeWei: zod.z.string(),
+  broadcasterTokenAddress: zod.z.string(),
+  totalDebitWei: zod.z.string(),
+  broadcasterError: zod.z.string().optional()
 }).strict();
 var mcpRailgunPrivateActionOutputSchema = zod.z.object({
-  status: zod.z.enum(["pending", "submitted", "failed"]),
+  status: zod.z.enum(["pending", "ready", "executing", "executed", "failed"]),
   spendId: zod.z.string(),
   approvals: zod.z.number().int().nonnegative(),
   quorum: zod.z.number().int().positive(),
   txHash: zod.z.string().optional(),
-  error: zod.z.string().optional()
+  error: zod.z.string().optional(),
+  fee: mcpRailgunFeeQuoteSchema.optional()
 }).strict();
 var mcpSkyFetchSusdsRateInputSchema = zod.z.object({
   rpcUrl: zod.z.string().min(1).optional().describe("Server-filled from chain registry. Agents should omit.")
@@ -8006,7 +8033,7 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "railgun.shield",
     protocolId: "railgun",
     chainCategory: "evm",
-    description: "Shield an ERC-20 into a Railgun 0zk address. The first call omits shieldSignature and returns a personal_sign. After trigger_sign_result, broadcast_sign_result returns that signature in txHashes[0] and does not send a transaction. Call this tool again with shieldSignature set to that hex to build the approve-and-shield transaction.",
+    description: "Shield an ERC-20 into a Railgun 0zk address. Call ctm_railgun_fee_quote first and tell the user the Railgun fee taken from the amount. purposeText is the Purpose shown on the sign request. If this KeyGen already has a shield key, this builds the approve-and-shield transaction. Otherwise it returns a personal_sign. After that request is signed, the shield key is stored on the KeyGen. Call this tool again without shieldSignature. The result includes railgunFee.",
     prerequisites: ["keyGen", "executorAddress", "RPC URL", "0zk recipient"],
     handler: { importPath: "protocols/evm/railgun", exportName: "buildEvmMultisignBodyRailgunShield" },
     inputZod: mcpRailgunShieldInputSchema
@@ -11058,7 +11085,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "railgun.ensure-wallet",
     protocolId: "railgun",
     chainCategory: "evm",
-    description: "Create the Railgun wallet on this KeyGen if it does not exist yet, and return its 0zk address. The spending key is split across the KeyGen nodes. No node receives a key it can spend alone. Does not return a mnemonic. Use this from the node agent and from Telegram before shield, unshield, or private transfer.",
+    description: "Create the Railgun wallet on this KeyGen if it does not exist yet, and return its 0zk address. Returns shieldSignature when this KeyGen already has a shield key. The spending key is split across the KeyGen nodes. No node receives a key it can spend alone. Does not return a mnemonic. Use this from the node agent and from Telegram before shield, unshield, or private transfer.",
     prerequisites: ["keyGenId"],
     followUp: ["ctm_railgun_fetch_private_balances", "ctm_railgun_build_shield_multisign"],
     handler: { importPath: "protocols/evm/railgun", exportName: "railgunFetchPrivateBalancesSummary" },
@@ -11070,7 +11097,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "railgun.fetch-private-balances",
     protocolId: "railgun",
     chainCategory: "evm",
-    description: "Shielded balances stored on the KeyGen record for this chain. Scans on the node when no scan is stored, or when refresh is true, then writes the result back to the KeyGen. Does not return a mnemonic or viewing key. Works from the node agent and from Telegram.",
+    description: "Shielded balances stored on the KeyGen record for this chain. Returns shieldSignature when this KeyGen already has a shield key. Scans on the node when no scan is stored, or when refresh is true, then writes the result back to the KeyGen. Does not return a mnemonic or viewing key. Works from the node agent and from Telegram.",
     prerequisites: ["keyGenId", "chainId", "ctm_railgun_ensure_wallet"],
     followUp: ["ctm_railgun_private_transfer", "ctm_railgun_unshield"],
     handler: { importPath: "protocols/evm/railgun", exportName: "railgunFetchPrivateBalancesSummary" },
@@ -11082,8 +11109,8 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "railgun.private-transfer",
     protocolId: "railgun",
     chainCategory: "evm",
-    description: "Start a private Railgun transfer. It stays pending until the KeyGen signing quorum agrees with ctm_railgun_agree_spend. No single node can spend. Do not pass a mnemonic.",
-    prerequisites: ["keyGenId", "chainId", "0zk recipient", "ctm_railgun_ensure_wallet"],
+    description: "Propose a private Railgun transfer. This node signs it with its management key, then agrees its share. Call ctm_railgun_fee_quote first and tell the user the broadcaster fee. Pass toContactName to use that contact\u2019s saved 0zk address, or recipientAddress as a 0zk address. Do not pass the contact\u2019s Ethereum address. purpose is shown on Join the same way as a normal sign request. The other nodes accept on Join and can attach thoughts. The originator executes with broadcast_sign_result and the RailgunSpend request id. There is no Get Sig. Do not pass a mnemonic. The result includes fee.",
+    prerequisites: ["keyGenId", "chainId", "0zk recipient or toContactName", "ctm_railgun_ensure_wallet"],
     followUp: ["ctm_railgun_fetch_private_balances"],
     handler: { importPath: "protocols/evm/railgun", exportName: "railgunPrivateTransfer" },
     inputZod: mcpRailgunPrivateTransferInputSchema,
@@ -11094,7 +11121,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "railgun.unshield",
     protocolId: "railgun",
     chainCategory: "evm",
-    description: "Start an unshield to a public address. It stays pending until the KeyGen signing quorum agrees with ctm_railgun_agree_spend. Recipient defaults to the KeyGen Ethereum address. No single node can spend. Do not pass a mnemonic.",
+    description: "Start an unshield to a public address. This node signs it with its management key, then agrees its share. Call ctm_railgun_fee_quote first and tell the user the Railgun fee and the broadcaster fee. purpose is shown on Join the same way as a normal sign request. It stays pending until the other nodes accept on Join. They can attach thoughts with sign_request_agree. Recipient defaults to the KeyGen Ethereum address. The originator executes with broadcast_sign_result. There is no Get Sig. Do not pass a mnemonic. The result includes fee.",
     prerequisites: ["keyGenId", "chainId", "ctm_railgun_ensure_wallet"],
     followUp: ["ctm_railgun_fetch_private_balances"],
     handler: { importPath: "protocols/evm/railgun", exportName: "railgunUnshield" },
@@ -11106,12 +11133,24 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "railgun.agree-spend",
     protocolId: "railgun",
     chainCategory: "evm",
-    description: "Agree this node\u2019s Railgun spending share for a pending spendId. Read the pending spend on the KeyGen record before agreeing. One share cannot spend the 0zk wallet.",
+    description: "Agree this node\u2019s Railgun spending share for a pending spendId. thoughts is optional and is stored on the spend, the same way as sign_request_agree. Read the pending spend, including its purpose, before agreeing. One share cannot spend the 0zk wallet.",
     prerequisites: ["keyGenId", "spendId"],
     followUp: ["ctm_railgun_fetch_private_balances"],
     handler: { importPath: "protocols/evm/railgun", exportName: "railgunFetchPrivateBalancesSummary" },
     inputZod: mcpRailgunAgreeSpendInputSchema,
     outputZod: mcpRailgunPrivateActionOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_railgun_fee_quote",
+    actionId: "railgun.fee-quote",
+    protocolId: "railgun",
+    chainCategory: "evm",
+    description: "Quote the fee taken before a shield, private transfer, or unshield. Shield and unshield include the live Railgun basis points taken from the amount. Private transfer has no protocol fee. Unshield and private transfer also include the broadcaster fee, which is extra and comes out of the private balance. Tell the user these amounts before calling the shield, transfer, or unshield tool. broadcasterError is set when that fee cannot be estimated; the protocol numbers are still returned.",
+    prerequisites: ["keyGenId", "chainId", "tokenAddress", "kind"],
+    followUp: ["ctm_railgun_build_shield_multisign", "ctm_railgun_private_transfer", "ctm_railgun_unshield"],
+    handler: { importPath: "protocols/evm/railgun", exportName: "railgunFetchPrivateBalancesSummary" },
+    inputZod: mcpRailgunFeeQuoteInputSchema,
+    outputZod: mcpRailgunFeeQuoteSchema
   })
 ];
 var MCP_TOOL_DEFINITIONS = [
@@ -11426,7 +11465,16 @@ var railgunProtocolModule = {
       params: {
         tokenAddress: { type: "string", required: true, description: "Shielded ERC-20" },
         amountWei: { type: "string", required: true, description: "Amount in wei" },
-        recipientAddress: { type: "string", required: true, description: "Recipient 0zk address" }
+        recipientAddress: {
+          type: "string",
+          required: false,
+          description: "Recipient 0zk address. Omit when toContactName is set."
+        },
+        toContactName: {
+          type: "string",
+          required: false,
+          description: "Address-book contact name. Uses that contact\u2019s saved 0zk address, not their Ethereum address."
+        }
       }
     },
     {
@@ -15828,6 +15876,8 @@ exports.mcpPredictionMarketRowSchema = mcpPredictionMarketRowSchema;
 exports.mcpRailgunAgreeSpendInputSchema = mcpRailgunAgreeSpendInputSchema;
 exports.mcpRailgunEnsureWalletInputSchema = mcpRailgunEnsureWalletInputSchema;
 exports.mcpRailgunEnsureWalletOutputSchema = mcpRailgunEnsureWalletOutputSchema;
+exports.mcpRailgunFeeQuoteInputSchema = mcpRailgunFeeQuoteInputSchema;
+exports.mcpRailgunFeeQuoteSchema = mcpRailgunFeeQuoteSchema;
 exports.mcpRailgunFetchPopularAssetsInputSchema = mcpRailgunFetchPopularAssetsInputSchema;
 exports.mcpRailgunFetchPopularAssetsOutputSchema = mcpRailgunFetchPopularAssetsOutputSchema;
 exports.mcpRailgunFetchPrivateBalancesInputSchema = mcpRailgunFetchPrivateBalancesInputSchema;