@missionsquad/mcp-server-tron 1.2.0

package/build/core/tools/account-resource.js

@@ -0,0 +1,269 @@
+import { z } from "zod";
+import * as services from "../services/index.js";
+export function registerAccountResourceTools(registerTool) {
+    // ============================================================================
+    // ACCOUNT RESOURCE TOOLS (Delegate resources)
+    // ============================================================================
+    registerTool("delegate_resource", {
+        description: "Delegate staked resources (BANDWIDTH or ENERGY) from the configured wallet to another address.",
+        inputSchema: {
+            receiverAddress: z
+                .string()
+                .describe("The address that will receive the delegated resources"),
+            amount: z.coerce
+                .number()
+                .describe("Amount of resources to delegate in Sun (1 TRX = 1,000,000 Sun)"),
+            resource: z
+                .enum(["BANDWIDTH", "ENERGY"])
+                .describe("Resource type to delegate (BANDWIDTH or ENERGY)"),
+            lock: z
+                .boolean()
+                .optional()
+                .describe("Whether the delegation is locked (non-revocable within the lock period). Defaults to false."),
+            lockPeriod: z
+                .number()
+                .optional()
+                .describe("Lock period in blocks when lock is true. Ignored if lock is false. Defaults to 0."),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Delegate Resource",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ receiverAddress, amount, resource, lock, lockPeriod, network = "mainnet" }) => {
+        try {
+            const senderAddress = await services.getOwnerAddress();
+            const txHash = await services.delegateResource({
+                amount,
+                receiverAddress,
+                resource: resource,
+                lock,
+                lockPeriod,
+            }, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            from: senderAddress,
+                            to: receiverAddress,
+                            amount,
+                            resource,
+                            lock: lock ?? false,
+                            lockPeriod: lock ? (lockPeriod ?? 0) : 0,
+                            txHash,
+                            message: "Delegate resource transaction sent. Make sure you have enough frozen balance to cover this delegation.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error delegating resource: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("undelegate_resource", {
+        description: "Revoke previously delegated staked resources (BANDWIDTH or ENERGY) from a receiver address back to the configured wallet.",
+        inputSchema: {
+            receiverAddress: z
+                .string()
+                .describe("The address from which delegated resources will be revoked"),
+            amount: z.coerce
+                .number()
+                .describe("Amount of resources to revoke in Sun (1 TRX = 1,000,000 Sun)"),
+            resource: z
+                .enum(["BANDWIDTH", "ENERGY"])
+                .describe("Resource type to revoke (BANDWIDTH or ENERGY)"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Undelegate Resource",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ receiverAddress, amount, resource, network = "mainnet" }) => {
+        try {
+            const senderAddress = await services.getOwnerAddress();
+            const txHash = await services.undelegateResource({
+                amount,
+                receiverAddress,
+                resource: resource,
+            }, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            from: senderAddress,
+                            to: receiverAddress,
+                            amount,
+                            resource,
+                            txHash,
+                            message: "Undelegate resource transaction sent. This revokes previously delegated resources.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error undelegating resource: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_can_delegated_max_size", {
+        description: "Get the maximum amount of TRX (in Sun) that an address can currently delegate as resources (BANDWIDTH or ENERGY) under Stake 2.0.",
+        inputSchema: {
+            address: z.string().describe("Wallet address (Base58 or hex)"),
+            resource: z
+                .enum(["BANDWIDTH", "ENERGY"])
+                .describe("Resource type to query (BANDWIDTH or ENERGY)"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Can Delegated Max Size",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ address, resource, network = "mainnet" }) => {
+        try {
+            const result = await services.getCanDelegatedMaxSize(address, resource, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            address: result.address,
+                            resource: result.resource,
+                            maxSizeSun: result.maxSizeSun.toString(),
+                            message: "This is the maximum amount (in Sun) that can currently be delegated as the specified resource.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting can delegated max size: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_delegated_resource_v2", {
+        description: "Get delegated resource details (bandwidth and energy) between two addresses under Stake 2.0.",
+        inputSchema: {
+            fromAddress: z.string().describe("Delegator address (Base58 or hex)"),
+            toAddress: z.string().describe("Delegatee address (Base58 or hex)"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Delegated Resource V2",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ fromAddress, toAddress, network = "mainnet" }) => {
+        try {
+            const result = await services.getDelegatedResourceV2(fromAddress, toAddress, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            from: result.from,
+                            to: result.to,
+                            delegatedResource: result.delegatedResource,
+                            message: "Delegated resource details between the two addresses, including bandwidth and energy stake information.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting delegated resource v2: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    registerTool("get_delegated_resource_account_index_v2", {
+        description: "Get delegated resource account index for an address under Stake 2.0 (who delegated to this address and who this address delegated to).",
+        inputSchema: {
+            address: z.string().describe("Wallet address (Base58 or hex)"),
+            network: z.string().optional().describe("Network name. Defaults to mainnet."),
+        },
+        annotations: {
+            title: "Get Delegated Resource Account Index V2",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ address, network = "mainnet" }) => {
+        try {
+            const result = await services.getDelegatedResourceAccountIndexV2(address, network);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            network,
+                            account: result.account,
+                            fromAccounts: result.fromAccounts,
+                            toAccounts: result.toAccounts,
+                            message: "Delegated resource account index for the address, including who delegated to it and who it delegated to.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting delegated resource account index v2: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=account-resource.js.map

package/build/core/tools/account-resource.js.map

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

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

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