@sun-protocol/tron-mcp-server 1.0.0-beta.1

package/build/core/prompts.js

@@ -0,0 +1,268 @@
+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
+ */
+export function registerTRONPrompts(server) {
+    // ============================================================================
+    // TRANSACTION PROMPTS
+    // ============================================================================
+    server.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
+`,
+                },
+            },
+        ],
+    }));
+    server.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
+`,
+                },
+            },
+        ],
+    }));
+    // ============================================================================
+    // WALLET ANALYSIS PROMPTS
+    // ============================================================================
+    server.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
+    // ============================================================================
+    server.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"}

package/build/core/services/address.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Service for handling address conversions (Hex <-> Base58)
+ */
+export declare function toHexAddress(address: string): string;
+export declare function toBase58Address(address: string): string;
+export declare function isBase58(address: string): boolean;
+export declare function isHex(address: string): boolean;
+export declare const resolveAddress: (nameOrAddress: string, _network?: string) => Promise<string>;

package/build/core/services/address.js

@@ -0,0 +1,52 @@
+import { TronWeb } from "tronweb";
+/**
+ * Service for handling address conversions (Hex <-> Base58)
+ */
+export function toHexAddress(address) {
+    if (address.startsWith("T")) {
+        return TronWeb.address.toHex(address);
+    }
+    return address;
+}
+export function toBase58Address(address) {
+    if (address.startsWith("41")) {
+        return TronWeb.address.fromHex(address);
+    }
+    if (address.startsWith("0x")) {
+        // TronWeb expects 41 prefix for hex addresses usually, but 0x might be passed from EVM habits
+        // 0x prefix usually needs to be replaced with 41 if it's a valid Tron address in hex
+        // However, TronWeb.address.fromHex handles 0x prefix by assuming it's an ETH address and converting?
+        // Let's rely on TronWeb's robust handling
+        return TronWeb.address.fromHex(address);
+    }
+    return address;
+}
+export function isBase58(address) {
+    return address.startsWith("T") && TronWeb.isAddress(address);
+}
+export function isHex(address) {
+    // Base58 addresses start with T, Hex addresses don't (0-9, a-f)
+    if (address.startsWith("T"))
+        return false;
+    let cleanAddress = address;
+    if (address.startsWith("0x")) {
+        cleanAddress = address.substring(2);
+    }
+    // If it's a 20-byte hex (40 chars), prefix with 41 to verify as a Tron address
+    // TronWeb.address.fromHex handles this auto-prefixing, so isHex should validate it too
+    if (cleanAddress.length === 40) {
+        cleanAddress = "41" + cleanAddress;
+    }
+    return TronWeb.isAddress(cleanAddress);
+}
+// Re-export utility for convenience
+export const resolveAddress = async (nameOrAddress, _network) => {
+    // Tron doesn't have ENS exactly like ETH.
+    // If it's a valid address, return it.
+    if (TronWeb.isAddress(nameOrAddress)) {
+        return nameOrAddress;
+    }
+    // Future: Implement Tron NS resolution if needed
+    throw new Error(`Invalid address or unsupported name service: ${nameOrAddress}`);
+};
+//# sourceMappingURL=address.js.map

package/build/core/services/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/core/services/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AAEH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,8FAA8F;QAC9F,qFAAqF;QACrF,qGAAqG;QACrG,0CAA0C;QAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,gEAAgE;IAChE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,+EAA+E;IAC/E,uFAAuF;IACvF,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC/B,YAAY,GAAG,IAAI,GAAG,YAAY,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,aAAqB,EAAE,QAAiB,EAAmB,EAAE;IAChG,0CAA0C;IAC1C,sCAAsC;IACtC,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QACrC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,iDAAiD;IACjD,MAAM,IAAI,KAAK,CAAC,gDAAgD,aAAa,EAAE,CAAC,CAAC;AACnF,CAAC,CAAC"}

package/build/core/services/balance.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get TRX balance for an address
+ */
+export declare function getTRXBalance(address: string, network?: string): Promise<{
+    wei: bigint;
+    ether: string;
+    formatted: string;
+    symbol: string;
+    decimals: number;
+}>;
+/**
+ * Get TRC20 token balance
+ */
+export declare function getTRC20Balance(tokenAddress: string, walletAddress: string, network?: string): Promise<{
+    raw: bigint;
+    formatted: string;
+    token: {
+        symbol: any;
+        decimals: number;
+        address: string;
+    };
+}>;
+/**
+ * Get TRC1155 balance
+ */
+export declare function getTRC1155Balance(contractAddress: string, ownerAddress: string, tokenId: bigint, network?: string): Promise<bigint>;

package/build/core/services/balance.js

@@ -0,0 +1,60 @@
+import { getTronWeb } from "./clients.js";
+import { utils } from "./utils.js";
+/**
+ * Get TRX balance for an address
+ */
+export async function getTRXBalance(address, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const balanceSun = await tronWeb.trx.getBalance(address);
+    return {
+        wei: BigInt(balanceSun), // Keeping 'wei' property name for compatibility if tools rely on it, but strictly it's Sun
+        ether: utils.fromSun(balanceSun), // 'ether' -> TRX
+        formatted: utils.fromSun(balanceSun),
+        symbol: "TRX",
+        decimals: 6,
+    };
+}
+/**
+ * Get TRC20 token balance
+ */
+export async function getTRC20Balance(tokenAddress, walletAddress, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        // TRC20 standard functions
+        const balance = await contract.methods.balanceOf(walletAddress).call();
+        const decimals = await contract.methods.decimals().call();
+        const symbol = await contract.methods.symbol().call();
+        const balanceBigInt = BigInt(balance.toString());
+        const divisor = BigInt(10) ** BigInt(decimals.toString());
+        // Basic formatting
+        const formatted = (Number(balanceBigInt) / Number(divisor)).toString();
+        return {
+            raw: balanceBigInt,
+            formatted: formatted,
+            token: {
+                symbol: symbol,
+                decimals: Number(decimals),
+                address: tokenAddress,
+            },
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC20 balance: ${error.message}`);
+    }
+}
+/**
+ * Get TRC1155 balance
+ */
+export async function getTRC1155Balance(contractAddress, ownerAddress, tokenId, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const contract = await tronWeb.contract().at(contractAddress);
+        const balance = await contract.methods.balanceOf(ownerAddress, tokenId.toString()).call();
+        return BigInt(balance.toString());
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC1155 balance: ${error.message}`);
+    }
+}
+//# sourceMappingURL=balance.js.map

package/build/core/services/balance.js.map

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

package/build/core/services/blocks.d.ts

@@ -0,0 +1,16 @@
+type Block = any;
+/**
+ * Get block details by block number or hash
+ */
+export declare function getBlockByNumber(blockNumber: number, network?: string): Promise<Block>;
+export declare function getBlockByHash(blockHash: string, network?: string): Promise<Block>;
+/**
+ * Get the latest block from the network
+ */
+export declare function getLatestBlock(network?: string): Promise<Block>;
+/**
+ * Get current block number
+ */
+export declare function getBlockNumber(network?: string): Promise<number>;
+export declare function getChainId(network?: string): Promise<number>;
+export {};

package/build/core/services/blocks.js

@@ -0,0 +1,46 @@
+import { getTronWeb } from "./clients.js";
+/**
+ * Get block details by block number or hash
+ */
+export async function getBlockByNumber(blockNumber, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const block = await tronWeb.trx.getBlock(blockNumber);
+    return block;
+}
+export async function getBlockByHash(blockHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const block = await tronWeb.trx.getBlock(blockHash);
+    return block;
+}
+/**
+ * Get the latest block from the network
+ */
+export async function getLatestBlock(network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const block = await tronWeb.trx.getCurrentBlock();
+    return block;
+}
+/**
+ * Get current block number
+ */
+export async function getBlockNumber(network = "mainnet") {
+    const block = await getLatestBlock(network);
+    // Type assertion or checking structure; TronWeb block structure varies slightly by version/response
+    return block.block_header.raw_data.number;
+}
+// Chain ID is not standard in TronWeb like EVM, but we can return network ID or similar
+// For compatibility with tool interface
+export async function getChainId(network = "mainnet") {
+    // Tron Mainnet ID is often considered 0x2b6653dc (hex) or similar in some contexts,
+    // but typically we just return a placeholder or specific known ID if needed.
+    // FullNode info might have it.
+    // For now, mapping known networks to some integer IDs if needed, or just return 0
+    if (network === "mainnet")
+        return 728126428; // Tron Mainnet ID (often used)
+    if (network === "nile")
+        return 20191029; // Nile ID
+    if (network === "shasta")
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=blocks.js.map

package/build/core/services/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/core/services/blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,OAAO,GAAG,SAAS;IAC7E,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAO,GAAG,SAAS;IACzE,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAO,GAAG,SAAS;IACtD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAO,GAAG,SAAS;IACtD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,oGAAoG;IACpG,OAAQ,KAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;AACrD,CAAC;AAED,wFAAwF;AACxF,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAO,GAAG,SAAS;IAClD,oFAAoF;IACpF,6EAA6E;IAC7E,+BAA+B;IAE/B,kFAAkF;IAClF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,CAAC,+BAA+B;IAC5E,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,QAAQ,CAAC,CAAC,UAAU;IACnD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/build/core/services/clients.d.ts

@@ -0,0 +1,9 @@
+import { TronWeb } from "tronweb";
+/**
+ * Get a TronWeb instance for a specific network
+ */
+export declare function getTronWeb(network?: string): TronWeb;
+/**
+ * Create a TronWeb instance with a private key for signing
+ */
+export declare function getWallet(privateKey: string, network?: string): TronWeb;

package/build/core/services/clients.js

@@ -0,0 +1,46 @@
+import { TronWeb } from "tronweb";
+import { getNetworkConfig } from "../chains.js";
+// Cache for clients to avoid recreating them for each request
+const clientCache = new Map();
+/**
+ * Get a TronWeb instance for a specific network
+ */
+export function getTronWeb(network = "mainnet") {
+    const cacheKey = String(network);
+    // Return cached client if available
+    if (clientCache.has(cacheKey)) {
+        return clientCache.get(cacheKey);
+    }
+    // Create a new client
+    const config = getNetworkConfig(network);
+    const apiKey = process.env.TRONGRID_API_KEY;
+    const client = new TronWeb({
+        fullHost: config.fullNode,
+        solidityNode: config.solidityNode,
+        eventServer: config.eventServer,
+        headers: apiKey ? { "TRON-PRO-API-KEY": apiKey } : undefined,
+    });
+    // Set a default address for read-only calls that might require it
+    client.setAddress("T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb");
+    // Cache the client
+    clientCache.set(cacheKey, client);
+    return client;
+}
+/**
+ * Create a TronWeb instance with a private key for signing
+ */
+export function getWallet(privateKey, network = "mainnet") {
+    const config = getNetworkConfig(network);
+    const apiKey = process.env.TRONGRID_API_KEY;
+    // TronWeb expects private key without 0x prefix usually, but handles it if present?
+    // Let's strip 0x to be safe as TronWeb often prefers clean hex
+    const cleanKey = privateKey.startsWith("0x") ? privateKey.slice(2) : privateKey;
+    return new TronWeb({
+        fullHost: config.fullNode,
+        solidityNode: config.solidityNode,
+        eventServer: config.eventServer,
+        privateKey: cleanKey,
+        headers: apiKey ? { "TRON-PRO-API-KEY": apiKey } : undefined,
+    });
+}
+//# sourceMappingURL=clients.js.map

package/build/core/services/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../../src/core/services/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,8DAA8D;AAC9D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAG,SAAS;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAEjC,oCAAoC;IACpC,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;IACpC,CAAC;IAED,sBAAsB;IACtB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC,CAAC;IAEH,kEAAkE;IAClE,MAAM,CAAC,UAAU,CAAC,oCAAoC,CAAC,CAAC;IAExD,mBAAmB;IACnB,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,OAAO,GAAG,SAAS;IAC/D,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE5C,oFAAoF;IACpF,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAEhF,OAAO,IAAI,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC,CAAC;AACL,CAAC"}