@missionsquad/mcp-server-tron 1.2.0

package/build/core/tools/index.js

@@ -0,0 +1,93 @@
+import { requireTenantAuthContext } from "../../tenant/context.js";
+import { registerWalletTools } from "./wallet.js";
+import { registerNetworkTools } from "./network.js";
+import { registerAddressTools } from "./address.js";
+import { registerBlockTools } from "./block.js";
+import { registerBalanceTools } from "./balance.js";
+import { registerTransactionTools } from "./transaction.js";
+import { registerContractTools } from "./contract.js";
+import { registerTransferTools } from "./transfer.js";
+import { registerStakingTools } from "./staking.js";
+import { registerQueryTools } from "./query.js";
+import { registerBroadcastTools } from "./broadcast.js";
+import { registerNodeTools } from "./node.js";
+import { registerMempoolTools } from "./mempool.js";
+import { registerEventTools } from "./event.js";
+import { registerAccountTools } from "./account.js";
+import { registerGovernanceTools } from "./governance.js";
+import { registerProposalTools } from "./proposals.js";
+import { registerAccountDataTools } from "./account-data.js";
+import { registerContractDataTools } from "./contract-data.js";
+import { registerAccountResourceTools } from "./account-resource.js";
+/**
+ * Register all TRON-related tools with the MCP server
+ *
+ * Write operations are registered up front and validate wallet availability
+ * when the tool handler runs. Private keys and mnemonics are never passed as
+ * tool arguments for security reasons.
+ *
+ * @param server The MCP server instance
+ * @param options Registration options (e.g., readOnly mode)
+ */
+export function registerTRONTools(server, options = {}) {
+    /**
+     * Helper to register a tool with read-only gating.
+     * Write tools (`readOnlyHint` not true) are omitted when `options.readOnly` is set;
+     * wallet availability is validated inside handlers when invoked.
+     */
+    const registerTool = (name, definition, handler) => {
+        const annotations = definition.annotations || {};
+        // Default to false: tools without explicit readOnlyHint are treated as write-capable
+        // for safety. This is stricter than prompts.ts (which defaults to read-only) because
+        // tools can directly mutate blockchain state.
+        const isReadOnly = annotations.readOnlyHint === true;
+        // 1. Skip if in read-only mode and the tool is a write operation
+        if (options.readOnly && !isReadOnly) {
+            return;
+        }
+        if (options.transport === "http" && definition.legacyOnly === true) {
+            return;
+        }
+        const wrappedHandler = async (args) => {
+            try {
+                if (options.transport === "http") {
+                    requireTenantAuthContext();
+                }
+                return await handler(args);
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: error instanceof Error ? error.message : String(error),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        };
+        server.registerTool(name, definition, wrappedHandler);
+    };
+    registerWalletTools(registerTool);
+    registerNetworkTools(registerTool);
+    registerAddressTools(registerTool);
+    registerBlockTools(registerTool);
+    registerBalanceTools(registerTool);
+    registerTransactionTools(registerTool);
+    registerContractTools(registerTool);
+    registerTransferTools(registerTool);
+    registerStakingTools(registerTool);
+    registerAccountResourceTools(registerTool);
+    registerQueryTools(registerTool);
+    registerBroadcastTools(registerTool);
+    registerNodeTools(registerTool);
+    registerMempoolTools(registerTool);
+    registerEventTools(registerTool);
+    registerAccountTools(registerTool);
+    registerGovernanceTools(registerTool);
+    registerProposalTools(registerTool);
+    registerAccountDataTools(registerTool);
+    registerContractDataTools(registerTool);
+}
+//# sourceMappingURL=index.js.map

package/build/core/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tools/index.ts"],"names":[],"mappings":"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"}

package/build/core/tools/mempool.d.ts

@@ -0,0 +1,2 @@
+import type { RegisterToolFn } from "./types.js";
+export declare function registerMempoolTools(registerTool: RegisterToolFn): void;

package/build/core/tools/mempool.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import * as services from "../services/index.js";
+export function registerMempoolTools(registerTool) {
+    registerTool("get_pending_transactions", {
+        description: "Get the list of transaction IDs currently in the pending pool (mempool).",
+        inputSchema: {
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Pending Transactions",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const txIds = await services.getTransactionListFromPending(network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: services.helpers.formatJson({
+                            pendingCount: txIds.length,
+                            transactionIds: txIds,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching pending transactions: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_transaction_from_pending", {
+        description: "Get the details of a specific transaction from the pending pool by its transaction ID.",
+        inputSchema: {
+            txId: z
+                .string()
+                .length(64, "Transaction ID must be a 64-character hex string")
+                .regex(/^[0-9a-fA-F]{64}$/, "Transaction ID must be a valid hex string")
+                .describe("The transaction ID (hash) to look up in the pending pool"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Transaction From Pending",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ txId, network = "mainnet" }) => {
+        try {
+            const tx = await services.getTransactionFromPending(txId, network);
+            return {
+                content: [{ type: "text", text: services.helpers.formatJson(tx) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching transaction from pending: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_pending_size", {
+        description: "Get the number of transactions currently in the pending pool (mempool).",
+        inputSchema: {
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Pending Size",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const size = await services.getPendingSize(network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: services.helpers.formatJson({ pendingTransactionSize: size }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching pending size: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=mempool.js.map

package/build/core/tools/mempool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mempool.js","sourceRoot":"","sources":["../../../src/core/tools/mempool.ts"],"names":[],"mappings":"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"}

package/build/core/tools/network.d.ts

@@ -0,0 +1,2 @@
+import type { RegisterToolFn } from "./types.js";
+export declare function registerNetworkTools(registerTool: RegisterToolFn): void;

package/build/core/tools/network.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import { getSupportedNetworks, getRpcUrl } from "../chains.js";
+import * as services from "../services/index.js";
+export function registerNetworkTools(registerTool) {
+    registerTool("get_chain_info", {
+        description: "Get information about a TRON network: current block number and RPC endpoint",
+        inputSchema: {
+            network: z
+                .string()
+                .optional()
+                .describe("Network name (mainnet, nile, shasta). Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Chain Info",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const chainId = await services.getChainId(network);
+            const blockNumber = await services.getBlockNumber(network);
+            const rpcUrl = getRpcUrl(network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ network, chainId, blockNumber: blockNumber.toString(), rpcUrl }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching chain info: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_supported_networks", {
+        description: "Get a list of all supported TRON networks",
+        inputSchema: {},
+        annotations: {
+            title: "Get Supported Networks",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const networks = getSupportedNetworks();
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ supportedNetworks: networks }, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_chain_parameters", {
+        description: "Get current chain parameters including Energy and Bandwidth unit prices. Returns structured fee information similar to gas price queries.",
+        inputSchema: {
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Chain Parameters",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const result = await services.getChainParameters(network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching chain parameters: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=network.js.map

package/build/core/tools/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/core/tools/network.ts"],"names":[],"mappings":"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"}

package/build/core/tools/node.d.ts

@@ -0,0 +1,2 @@
+import type { RegisterToolFn } from "./types.js";
+export declare function registerNodeTools(registerTool: RegisterToolFn): void;

package/build/core/tools/node.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import * as services from "../services/index.js";
+export function registerNodeTools(registerTool) {
+    registerTool("list_nodes", {
+        description: "List all connected node addresses on the TRON network. Returns an array of node IP:port strings.",
+        inputSchema: {
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "List Nodes",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const nodes = await services.listNodes(network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: services.helpers.formatJson({
+                            nodeCount: nodes.length,
+                            nodes,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing nodes: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_node_info", {
+        description: "Get detailed information about the current TRON node, including version, config, peers, and machine info.",
+        inputSchema: {
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Node Info",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const info = await services.getNodeInfo(network);
+            return {
+                content: [{ type: "text", text: services.helpers.formatJson(info) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching node info: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=node.js.map

package/build/core/tools/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/core/tools/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AAGjD,MAAM,UAAU,iBAAiB,CAAC,YAA4B;IAC5D,YAAY,CACV,YAAY,EACZ;QACE,WAAW,EACT,kGAAkG;QACpG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SAC9E;QACD,WAAW,EAAE;YACX,KAAK,EAAE,YAAY;YACnB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,GAAG,SAAS,EAAE,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;4BAChC,SAAS,EAAE,KAAK,CAAC,MAAM;4BACvB,KAAK;yBACN,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACvF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,YAAY,CACV,eAAe,EACf;QACE,WAAW,EACT,2GAA2G;QAC7G,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SAC9E;QACD,WAAW,EAAE;YACX,KAAK,EAAE,eAAe;YACtB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,GAAG,SAAS,EAAE,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACjD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;aACrE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC5F;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/core/tools/proposals.d.ts

@@ -0,0 +1,6 @@
+import type { RegisterToolFn } from "./types.js";
+/**
+ * Register all proposal / governance-voting tools.
+ * Separated from the main tools file to reduce merge conflicts in multi-developer workflows.
+ */
+export declare function registerProposalTools(registerTool: RegisterToolFn): void;

package/build/core/tools/proposals.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+import * as services from "../services/index.js";
+/**
+ * Register all proposal / governance-voting tools.
+ * Separated from the main tools file to reduce merge conflicts in multi-developer workflows.
+ */
+export function registerProposalTools(registerTool) {
+    // ============================================================================
+    // PROPOSALS TOOLS (Read-only)
+    // ============================================================================
+    registerTool("list_proposals", {
+        description: "List all network governance proposals.",
+        inputSchema: {
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "List Proposals",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ network = "mainnet" }) => {
+        try {
+            const proposals = await services.listProposals(network);
+            return {
+                content: [{ type: "text", text: services.helpers.formatJson(proposals) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing proposals: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_proposal", {
+        description: "Get details of a specific governance proposal by its ID.",
+        inputSchema: {
+            proposalId: z.number().int().nonnegative().describe("The proposal ID"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Proposal by ID",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ proposalId, network = "mainnet" }) => {
+        try {
+            const proposal = await services.getProposalById(proposalId, network);
+            return {
+                content: [{ type: "text", text: services.helpers.formatJson(proposal) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error fetching proposal: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ============================================================================
+    // PROPOSALS TOOLS (Write operations — SR only)
+    // ============================================================================
+    registerTool("create_proposal", {
+        description: "Create a new network governance proposal (SR only). Provide a map of chain parameter IDs to proposed values.",
+        inputSchema: {
+            parameters: z
+                .record(z.string(), z.number())
+                .describe("Map of chain parameter key IDs (as string numbers) to proposed values. E.g. { '6': 100 } to propose changing parameter #6 to 100."),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Create Governance Proposal",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ parameters, network = "mainnet" }) => {
+        try {
+            const senderAddress = await services.getOwnerAddress();
+            // Convert string keys to numbers as expected by the service
+            const numericParams = {};
+            for (const [k, v] of Object.entries(parameters)) {
+                numericParams[Number(k)] = v;
+            }
+            const txHash = await services.createProposal(numericParams, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            from: senderAddress,
+                            parameters,
+                            txHash,
+                            message: "Proposal submitted. Use get_transaction_info to check confirmation, then list_proposals to find the proposal ID.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error creating proposal: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("approve_proposal", {
+        description: "Vote to approve or disapprove a governance proposal (SR only).",
+        inputSchema: {
+            proposalId: z.number().int().nonnegative().describe("The proposal ID to vote on"),
+            approve: z.boolean().describe("true to approve, false to disapprove"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Approve / Reject Proposal",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ proposalId, approve, network = "mainnet" }) => {
+        try {
+            const senderAddress = await services.getOwnerAddress();
+            const txHash = await services.approveProposal(proposalId, approve, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            from: senderAddress,
+                            proposalId,
+                            approve,
+                            txHash,
+                            message: `Vote ${approve ? "approved" : "disapproved"} for proposal #${proposalId}.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error approving proposal: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("delete_proposal", {
+        description: "Delete a governance proposal (SR only, only the proposal creator can delete it).",
+        inputSchema: {
+            proposalId: z.number().int().nonnegative().describe("The proposal ID to delete"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Delete Proposal",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ proposalId, network = "mainnet" }) => {
+        try {
+            const senderAddress = await services.getOwnerAddress();
+            const txHash = await services.deleteProposal(proposalId, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            from: senderAddress,
+                            proposalId,
+                            txHash,
+                            message: `Proposal #${proposalId} deletion submitted.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error deleting proposal: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=proposals.js.map