@missionsquad/mcp-server-tron 1.2.0

package/build/core/chains.js

@@ -0,0 +1,87 @@
+// Tron Network Definitions
+export var TronNetwork;
+(function (TronNetwork) {
+    TronNetwork["Mainnet"] = "mainnet";
+    TronNetwork["Nile"] = "nile";
+    TronNetwork["Shasta"] = "shasta";
+})(TronNetwork || (TronNetwork = {}));
+const BOA_MAINNET_HOST = "https://hptg.bankofai.io";
+function isTronGridApiKeyConfigured() {
+    const apiKey = process.env.TRONGRID_API_KEY;
+    return typeof apiKey === "string" && apiKey.length > 0;
+}
+export const NETWORKS = {
+    [TronNetwork.Mainnet]: {
+        name: "Mainnet",
+        fullNode: "https://api.trongrid.io",
+        solidityNode: "https://api.trongrid.io",
+        eventServer: "https://api.trongrid.io",
+        explorer: "https://tronscan.org",
+    },
+    [TronNetwork.Nile]: {
+        name: "Nile",
+        fullNode: "https://nile.trongrid.io",
+        solidityNode: "https://nile.trongrid.io",
+        eventServer: "https://nile.trongrid.io",
+        explorer: "https://nile.tronscan.org",
+    },
+    [TronNetwork.Shasta]: {
+        name: "Shasta",
+        fullNode: "https://api.shasta.trongrid.io",
+        solidityNode: "https://api.shasta.trongrid.io",
+        eventServer: "https://api.shasta.trongrid.io",
+        explorer: "https://shasta.tronscan.org",
+    },
+};
+export const DEFAULT_NETWORK = TronNetwork.Mainnet;
+export function getNetworkConfig(network = DEFAULT_NETWORK) {
+    const normalizedNetwork = network.toLowerCase();
+    // Direct match
+    if (Object.values(TronNetwork).includes(normalizedNetwork)) {
+        const resolved = normalizedNetwork;
+        return applyNetworkOverrides(resolved, getBaseNetworkConfig(resolved));
+    }
+    // Aliases
+    if (normalizedNetwork === "tron" ||
+        normalizedNetwork === "trx" ||
+        normalizedNetwork === "mainnet") {
+        return applyNetworkOverrides(TronNetwork.Mainnet, getBaseNetworkConfig(TronNetwork.Mainnet));
+    }
+    if (normalizedNetwork === "testnet") {
+        return applyNetworkOverrides(TronNetwork.Nile, NETWORKS[TronNetwork.Nile]); // Default testnet to Nile
+    }
+    throw new Error(`Unsupported network: ${network}`);
+}
+export function getSupportedNetworks() {
+    return Object.values(TronNetwork);
+}
+export function getRpcUrl(network = DEFAULT_NETWORK) {
+    return getNetworkConfig(network).fullNode;
+}
+function getBaseNetworkConfig(network) {
+    if (network === TronNetwork.Mainnet && !isTronGridApiKeyConfigured()) {
+        return {
+            ...NETWORKS[TronNetwork.Mainnet],
+            fullNode: BOA_MAINNET_HOST,
+            solidityNode: BOA_MAINNET_HOST,
+            eventServer: BOA_MAINNET_HOST,
+        };
+    }
+    return NETWORKS[network];
+}
+function applyNetworkOverrides(network, config) {
+    const prefix = `TRON_${network.toUpperCase()}_`;
+    const fullNode = process.env[`${prefix}FULL_NODE`];
+    const solidityNode = process.env[`${prefix}SOLIDITY_NODE`];
+    const eventServer = process.env[`${prefix}EVENT_SERVER`];
+    if (!fullNode && !solidityNode && !eventServer) {
+        return config;
+    }
+    return {
+        ...config,
+        fullNode: fullNode || config.fullNode,
+        solidityNode: solidityNode || config.solidityNode,
+        eventServer: eventServer || config.eventServer,
+    };
+}
+//# sourceMappingURL=chains.js.map

package/build/core/chains.js.map

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

package/build/core/prompts.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register task-oriented prompts with the MCP server
+ *
+ * All prompts follow a consistent structure:
+ * - Clear objective statement
+ * - Step-by-step instructions
+ * - Expected outputs
+ * - Safety/security considerations
+ *
+ * Prompts guide the model through complex workflows that would otherwise
+ * require multiple tool calls in the correct sequence.
+ *
+ * @param server The MCP server instance
+ * @param options Registration options
+ */
+export declare function registerTRONPrompts(server: McpServer, options?: {
+    readOnly?: boolean;
+}): void;

package/build/core/prompts.js

@@ -0,0 +1,485 @@
+import { z } from "zod";
+/**
+ * Register task-oriented prompts with the MCP server
+ *
+ * All prompts follow a consistent structure:
+ * - Clear objective statement
+ * - Step-by-step instructions
+ * - Expected outputs
+ * - Safety/security considerations
+ *
+ * Prompts guide the model through complex workflows that would otherwise
+ * require multiple tool calls in the correct sequence.
+ *
+ * @param server The MCP server instance
+ * @param options Registration options
+ */
+export function registerTRONPrompts(server, options = {}) {
+    /**
+     * Helper to register a prompt with read-only gating.
+     * Prompts are registered up front; write guidance is hidden only in readonly
+     * mode and wallet availability is checked when the underlying tools run.
+     */
+    const registerPrompt = (name, definition, handler, extra = {}) => {
+        // Default to true: most prompts are informational and safe in readonly mode.
+        // This differs from tools.ts where the default is false (write-capable) because
+        // unregistered tools could mutate state, while prompts only guide the LLM.
+        const isReadOnly = extra.isReadOnly !== false;
+        // 1. Skip if in read-only mode and the prompt is for write operations
+        if (options.readOnly && !isReadOnly) {
+            return;
+        }
+        server.registerPrompt(name, definition, handler);
+    };
+    // ============================================================================
+    // TRANSACTION PROMPTS
+    // ============================================================================
+    registerPrompt("prepare_transfer", {
+        description: "Safely prepare and execute a token transfer with validation checks",
+        argsSchema: {
+            tokenType: z
+                .enum(["trx", "trc20"])
+                .describe("Token type: 'trx' for native or 'trc20' for contract tokens"),
+            recipient: z.string().describe("Recipient address"),
+            amount: z.string().describe("Amount to transfer (in TRX or token units)"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+            tokenAddress: z.string().optional().describe("Token contract address (required for TRC20)"),
+        },
+    }, ({ tokenType, recipient, amount, network = "mainnet", tokenAddress }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Token Transfer Task
+
+**Objective**: Safely transfer ${amount} ${tokenType === "trx" ? "TRX" : "TRC20 tokens"} to ${recipient} on ${network}
+
+## Validation & Checks
+Before executing any transfer:
+1. **Wallet Verification**: Call \`get_wallet_address\` to confirm the sending wallet
+2. **Balance Check**:
+   ${tokenType === "trx"
+                        ? "- Call `get_balance` to verify TRX balance"
+                        : `- Call \`get_token_balance\` with tokenAddress=${tokenAddress} to verify balance`}
+3. **Resource Analysis**: Call \`get_chain_parameters\` to assess current network costs (Energy/Bandwidth)
+
+## Execution Steps
+${tokenType === "trx"
+                        ? `
+1. Summarize: sender address, recipient, amount, and estimated cost
+2. Request confirmation from user
+3. Call \`transfer_trx\` with to="${recipient}", amount="${amount}", network="${network}"
+4. Return transaction hash to user
+5. Call \`get_transaction_info\` to confirm completion
+`
+                        : `
+1. Summarize: sender, recipient, token, amount
+2. Request confirmation
+3. Call \`transfer_trc20\` with tokenAddress, recipient, amount
+4. Wait for confirmation with \`get_transaction_info\`
+`}
+
+## Output Format
+- **Transaction Hash**: Clear hex value
+- **Status**: Pending or Confirmed
+- **User Confirmation**: Always ask before sending
+
+## Safety Considerations
+- Never send more than available balance
+- Double-check recipient address
+- Explain any approval requirements
+`,
+                },
+            },
+        ],
+    }), { isReadOnly: false });
+    registerPrompt("interact_with_contract", {
+        description: "Safely execute write operations on a smart contract with validation and confirmation",
+        argsSchema: {
+            contractAddress: z.string().describe("Contract address to interact with"),
+            functionName: z.string().describe("Function to call (e.g., 'mint', 'swap', 'stake')"),
+            args: z.string().optional().describe("Comma-separated function arguments"),
+            value: z.string().optional().describe("TRX value to send (for payable functions)"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+        },
+    }, ({ contractAddress, functionName, args, value, network = "mainnet" }) => {
+        const argsList = args ? args.split(",").map((a) => a.trim()) : [];
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Smart Contract Interaction
+
+**Objective**: Safely execute ${functionName} on contract ${contractAddress} on ${network}
+
+## Prerequisites Check
+
+### 1. Wallet Verification
+- Call \`get_wallet_address\` to confirm the wallet that will execute this transaction
+- Verify this is the correct wallet for this operation
+
+### 2. Contract Analysis
+- Use \`read_contract\` or external knowledge to understand the function parameters
+- Check function type:
+  * **View/Pure**: Read-only (use \`read_contract\` instead)
+  * **Nonpayable**: State-changing, no TRX required
+  * **Payable**: State-changing, can accept TRX
+
+### 3. Function Parameter Validation
+For function: **${functionName}**
+${argsList.length > 0 ? `Arguments provided: ${argsList.join(", ")}` : "No arguments provided"}
+
+- Verify parameter types match the contract requirements
+- Validate addresses are correct (Base58 or Hex)
+- Check numeric values are in correct units
+
+### 4. Pre-execution Checks
+
+**Balance Check**:
+- Call \`get_balance\` to verify sufficient TRX balance
+- Account for Energy/Bandwidth costs + value (if payable)
+
+**Resource Estimation**:
+- Call \`get_chain_parameters\` to check current unit prices
+- Estimate Energy and Bandwidth usage
+
+## Execution Process
+
+### 1. Present Summary to User
+Before executing, show:
+- **Contract**: ${contractAddress}
+- **Network**: ${network}
+- **Function**: ${functionName}
+- **Arguments**: ${argsList.length > 0 ? argsList.join(", ") : "None"}
+${value ? `- **Value**: ${value} TRX` : ""}
+- **From**: [wallet address from step 1]
+- **Estimated Resource Cost**: [Energy / Bandwidth estimation]
+
+### 2. Request User Confirmation
+⚠️ **IMPORTANT**: Always ask user to confirm before executing write operations
+- Clearly state what will happen
+- Show all costs involved
+- Explain any risks or irreversible actions
+
+### 3. Execute Transaction
+Only after user confirms:
+\`\`\`
+Call write_contract with:
+- contractAddress: "${contractAddress}"
+- functionName: "${functionName}"
+${argsList.length > 0 ? `- args: ${JSON.stringify(argsList)}` : ""}
+${value ? `- value: "${value}"` : ""}
+- network: "${network}"
+\`\`\`
+
+### 4. Monitor Transaction
+After execution:
+1. Return transaction hash to user
+2. Call \`get_transaction_info\` to verify success
+3. If failed, call \`diagnose_transaction\` to understand why
+
+## Output Format
+
+**Pre-Execution Summary**:
+- Contract details
+- Function and parameters
+- Cost breakdown
+- Risk assessment
+
+**Confirmation Request**:
+"Ready to execute ${functionName} on ${contractAddress}. Proceed? (yes/no)"
+
+**Execution Result**:
+- Transaction Hash: [hash]
+- Status: Pending/Confirmed/Failed
+- Energy Used: [actual energy used]
+- Bandwidth Used: [actual bandwidth used]
+
+## Safety Considerations
+
+### Critical Checks
+- ✅ Check function parameters are correct type and format
+- ✅ Ensure sufficient balance for fees + value
+- ✅ Validate addresses (no typos, correct network)
+- ✅ Understand what the function does before calling
+
+### Common Risks
+- **Irreversible**: Most blockchain transactions cannot be undone
+- **Fee Loss**: Failed transactions still consume Energy/Bandwidth
+- **Approval Risks**: Be careful with unlimited approvals
+- **Access Control**: Verify you have permission to call this function
+`,
+                    },
+                },
+            ],
+        };
+    }, { isReadOnly: false });
+    registerPrompt("diagnose_transaction", {
+        description: "Analyze transaction status, failures, and provide debugging insights",
+        argsSchema: {
+            txHash: z.string().describe("Transaction hash to diagnose"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+        },
+    }, ({ txHash, network = "mainnet" }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Transaction Diagnosis
+
+**Objective**: Analyze transaction ${txHash} on ${network} and identify any issues
+
+## Investigation Process
+
+### 1. Gather Transaction Data
+- Call \`get_transaction\` to fetch transaction details
+- Call \`get_transaction_info\` to get status and energy/bandwidth used
+- Note: both calls are read-only and free
+
+### 2. Status Assessment
+Determine transaction state:
+- **Pending**: Not yet mined
+- **Confirmed**: Successfully executed (contractRet='SUCCESS')
+- **Failed**: Execution failed (contractRet='REVERT' or other error)
+
+### 3. Failure Analysis
+If transaction failed, investigate:
+
+**Out of Energy**:
+- Check energy_usage vs energy_limit
+- If usage >= limit, suggest increasing fee limit
+
+**Contract Revert**:
+- Check function called and parameters
+- Verify sufficient balance/approvals
+- Look for require/revert statements in contract
+
+### 4. Resource Analysis
+- Calculate energy/bandwidth cost
+- Compare to current chain parameters
+
+## Output Format
+
+Provide structured diagnosis:
+- **Status**: Pending/Confirmed/Failed with reason
+- **Transaction Hash**: The hash analyzed
+- **From/To**: Addresses involved
+- **Resource Usage**: Energy / Bandwidth used
+- **Issue (if failed)**: Root cause and explanation
+- **Recommended Actions**: Next steps to resolve
+`,
+                },
+            },
+        ],
+    }));
+    registerPrompt("explain_tron_concept", {
+        description: "Explain TRON and blockchain concepts with examples",
+        argsSchema: {
+            concept: z
+                .string()
+                .describe("Concept to explain (Energy, Bandwidth, Super Representative, TRC20, TRC721, etc)"),
+        },
+    }, ({ concept }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Concept Explanation: ${concept}
+
+**Objective**: Provide clear, practical explanation of "${concept}"
+
+## Explanation Structure
+
+### 1. Definition
+- What is it?
+- Simple one-sentence summary
+- Technical name/terminology
+
+### 2. How It Works
+- Step-by-step explanation
+- Why it exists/why it's important (e.g., Resource model prevents spam)
+- How it relates to TRON blockchain
+
+### 3. Real-World Analogy
+- Compare to familiar concept (e.g., Bandwidth like internet data, Energy like CPU time)
+- Make it relatable for beginners
+- Highlight key differences
+
+### 4. Practical Examples
+- Real transaction scenarios
+- Numbers and metrics where applicable (e.g., Transfer costs ~300 Bandwidth)
+- Common scenarios
+- Edge cases or gotchas
+
+### 5. Relevance to Users
+- Why should developers/users care?
+- How does it affect transactions/costs?
+- How to optimize (e.g., Staking for resources)?
+- Common mistakes to avoid
+
+## Output Format
+
+Provide explanation in sections:
+
+**What is ${concept}?**
+[Definition and overview]
+
+**How Does It Work?**
+[Mechanics and process]
+
+**Example**
+[Real or hypothetical scenario]
+
+**Key Takeaways**
+[Bullet points of important facts]
+
+**Common Questions**
+- Question 1? Answer
+- Question 2? Answer
+
+## Important
+- Use clear, non-technical language first
+- Progress to technical details
+- Include concrete numbers where helpful
+- Be honest about complexity
+- Suggest further learning if needed
+`,
+                },
+            },
+        ],
+    }));
+    // ============================================================================
+    // WALLET ANALYSIS PROMPTS
+    // ============================================================================
+    registerPrompt("analyze_wallet", {
+        description: "Get comprehensive overview of wallet assets, balances, and activity",
+        argsSchema: {
+            address: z.string().describe("Wallet address to analyze"),
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+            tokens: z.string().optional().describe("Comma-separated token addresses to check"),
+        },
+    }, ({ address, network = "mainnet", tokens }) => {
+        const tokenList = tokens ? tokens.split(",").map((t) => t.trim()) : [];
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Wallet Analysis
+
+**Objective**: Provide complete asset overview for ${address} on ${network}
+
+## Information Gathering
+
+### 1. Address Resolution
+- Call \`convert_address\` to get both Hex and Base58 formats
+
+### 2. Native Token Balance
+- Call \`get_balance\` to fetch TRX balance
+- Report both sun and TRX formats
+
+### 3. Token Balances
+${tokenList.length > 0
+                            ? `- Call \`get_token_balance\` for each token:\n${tokenList.map((t) => `  * ${t}`).join("\n")}`
+                            : `- If specific tokens provided: call \`get_token_balance\` for each`}
+
+## Output Format
+
+Provide analysis with clear sections:
+
+**Wallet Overview**
+- Address (Base58): [address]
+- Address (Hex): [hex]
+- Network: [network]
+
+**TRX Balance**
+- TRX: [formatted amount]
+- Sun: [raw amount]
+
+**Token Holdings** (if requested)
+- Token: [address]
+- Symbol: [symbol]
+- Balance: [formatted]
+- Decimals: [decimals]
+
+**Summary**
+- Primary holdings
+- Notable observations
+`,
+                    },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // NETWORK & EDUCATION PROMPTS
+    // ============================================================================
+    registerPrompt("check_network_status", {
+        description: "Check current network health and conditions",
+        argsSchema: {
+            network: z.string().optional().describe("Network name (default: mainnet)"),
+        },
+    }, ({ network = "mainnet" }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Network Status Check
+
+**Objective**: Assess health and current conditions of ${network}
+
+## Status Assessment
+
+### 1. Gather Current Data
+Call these read-only tools:
+- \`get_chain_info\` for chain ID and current block number
+- \`get_latest_block\` for block details and timing
+- \`get_chain_parameters\` for current resource costs
+
+### 2. Network Health Analysis
+
+**Block Production**:
+- Current block number
+- Block timing (normal ~3 sec for Tron)
+- Consistent vs irregular blocks
+
+**Resource Market**:
+- Energy Fee
+- Bandwidth Fee
+
+**Overall Status**:
+- Operational: Yes/No
+- Issues detected: Yes/No
+
+## Output Format
+
+**Network Status Report: ${network}**
+
+**Overall Status**
+- Operational Status: [Online/Degraded/Offline]
+- Current Block: [number]
+- Network Time: [timestamp]
+
+**Performance Metrics**
+- Block Time: [seconds] (normal: 3s)
+- Energy Fee: [amount]
+- Bandwidth Fee: [amount]
+
+**Recommendations**
+
+For **sending transactions now**:
+- Status is Green/Yellow/Red
+`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/build/core/prompts.js.map

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

package/build/core/resources.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register TRON-related resources with the MCP server
+ *
+ * Resources are application-driven, read-only data that clients can explicitly load.
+ * For an AI agent use case, most data should be exposed through tools instead,
+ * which allow the model to discover and autonomously fetch information.
+ *
+ * The supported_networks resource provides a static reference list that clients
+ * may want to browse when configuring which networks to use.
+ *
+ * @param server The MCP server instance
+ */
+export declare function registerTRONResources(server: McpServer): void;

package/build/core/resources.js

@@ -0,0 +1,42 @@
+import { getSupportedNetworks } from "./chains.js";
+/**
+ * Register TRON-related resources with the MCP server
+ *
+ * Resources are application-driven, read-only data that clients can explicitly load.
+ * For an AI agent use case, most data should be exposed through tools instead,
+ * which allow the model to discover and autonomously fetch information.
+ *
+ * The supported_networks resource provides a static reference list that clients
+ * may want to browse when configuring which networks to use.
+ *
+ * @param server The MCP server instance
+ */
+export function registerTRONResources(server) {
+    server.registerResource("supported_networks", "tron://networks", {
+        description: "Get list of all supported TRON networks and their configuration",
+        mimeType: "application/json",
+    }, async (uri) => {
+        try {
+            const networks = getSupportedNetworks();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({ supportedNetworks: networks }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=resources.js.map

package/build/core/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/core/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,gBAAgB,CACrB,oBAAoB,EACpB,iBAAiB,EACjB;QACE,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;YACxC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC/D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACzE;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}