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

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

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

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

@@ -0,0 +1,16 @@
+type Transaction = any;
+type TransactionInfo = any;
+/**
+ * Get transaction details by transaction hash
+ */
+export declare function getTransaction(txHash: string, network?: string): Promise<Transaction>;
+/**
+ * Get transaction info (receipt equivalent)
+ */
+export declare function getTransactionInfo(txHash: string, network?: string): Promise<TransactionInfo>;
+export declare const getTransactionReceipt: typeof getTransactionInfo;
+/**
+ * Wait for a transaction to be confirmed
+ */
+export declare function waitForTransaction(txHash: string, network?: string): Promise<TransactionInfo>;
+export {};

package/build/core/services/transactions.js

@@ -0,0 +1,42 @@
+import { getTronWeb } from "./clients.js";
+/**
+ * Get transaction details by transaction hash
+ */
+export async function getTransaction(txHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const tx = await tronWeb.trx.getTransaction(txHash);
+    return tx;
+}
+/**
+ * Get transaction info (receipt equivalent)
+ */
+export async function getTransactionInfo(txHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const info = await tronWeb.trx.getTransactionInfo(txHash);
+    return info;
+}
+// Alias for tools expecting 'receipt'
+export const getTransactionReceipt = getTransactionInfo;
+/**
+ * Wait for a transaction to be confirmed
+ */
+export async function waitForTransaction(txHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    // Poll for transaction info
+    const maxAttempts = 30;
+    const interval = 2000; // 2 seconds
+    for (let i = 0; i < maxAttempts; i++) {
+        try {
+            const info = await tronWeb.trx.getTransactionInfo(txHash);
+            if (info && info.id) {
+                return info;
+            }
+        }
+        catch (_e) {
+            // Ignore error and retry
+        }
+        await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    throw new Error(`Transaction ${txHash} not confirmed after ${maxAttempts * interval}ms`);
+}
+//# sourceMappingURL=transactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../src/core/services/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,OAAO,GAAG,SAAS;IACtE,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,OAAO,GAAG,SAAS;IAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,OAAO,GAAG,SAAS;IAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEpC,4BAA4B;IAC5B,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,YAAY;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC1D,IAAI,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,yBAAyB;QAC3B,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,wBAAwB,WAAW,GAAG,QAAQ,IAAI,CAAC,CAAC;AAC3F,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Transfer TRX to an address
+ */
+export declare function transferTRX(privateKey: string, to: string, amount: string, // Amount in TRX (not Sun)
+network?: string): Promise<any>;
+/**
+ * Transfer TRC20 tokens
+ */
+export declare function transferTRC20(tokenAddress: string, to: string, amount: string, // Raw amount (accounting for decimals)
+privateKey: string, network?: string): Promise<{
+    txHash: any;
+    amount: {
+        raw: string;
+        formatted: string;
+    };
+    token: {
+        symbol: any;
+        decimals: number;
+    };
+}>;
+/**
+ * Approve token spending
+ */
+export declare function approveTRC20(tokenAddress: string, spenderAddress: string, amount: string, privateKey: string, network?: string): Promise<any>;

package/build/core/services/transfer.js

@@ -0,0 +1,70 @@
+import { getWallet } from "./clients.js";
+import { utils } from "./utils.js";
+/**
+ * Transfer TRX to an address
+ */
+export async function transferTRX(privateKey, to, amount, // Amount in TRX (not Sun)
+network = "mainnet") {
+    const tronWeb = getWallet(privateKey, network);
+    // Convert TRX to Sun
+    const amountSun = utils.toSun(amount);
+    const tx = await tronWeb.trx.sendTransaction(to, amountSun);
+    // If result is just true/false (older TronWeb), handle it?
+    // Newer TronWeb returns transaction object usually.
+    if (tx.result === true && tx.transaction) {
+        return tx.transaction.txID;
+    }
+    // If it returns the tx object directly
+    if (tx.txID) {
+        return tx.txID;
+    }
+    throw new Error(`Transaction failed: ${JSON.stringify(tx)}`);
+}
+/**
+ * Transfer TRC20 tokens
+ */
+export async function transferTRC20(tokenAddress, to, amount, // Raw amount (accounting for decimals)
+privateKey, network = "mainnet") {
+    const tronWeb = getWallet(privateKey, network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        // TRC20 transfer(to, amount)
+        const txId = await contract.methods.transfer(to, amount).send();
+        // Fetch token info for return
+        const symbol = await contract.methods.symbol().call();
+        const decimals = await contract.methods.decimals().call();
+        // Basic formatting for return
+        const decimalsNum = Number(decimals);
+        const divisor = BigInt(10) ** BigInt(decimalsNum);
+        const formatted = (Number(BigInt(amount)) / Number(divisor)).toString();
+        return {
+            txHash: txId,
+            amount: {
+                raw: amount,
+                formatted: formatted,
+            },
+            token: {
+                symbol: symbol,
+                decimals: decimalsNum,
+            },
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to transfer TRC20: ${error.message}`);
+    }
+}
+/**
+ * Approve token spending
+ */
+export async function approveTRC20(tokenAddress, spenderAddress, amount, privateKey, network = "mainnet") {
+    const tronWeb = getWallet(privateKey, network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        const txId = await contract.methods.approve(spenderAddress, amount).send();
+        return txId;
+    }
+    catch (error) {
+        throw new Error(`Failed to approve TRC20: ${error.message}`);
+    }
+}
+//# sourceMappingURL=transfer.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Utility functions for formatting and parsing values
+ */
+export declare const utils: {
+    toSun: (trx: number | string) => string;
+    fromSun: (sun: number | string | bigint) => string;
+    formatBigInt: (value: bigint | number) => string;
+    formatJson: (obj: unknown) => string;
+    formatNumber: (value: number | string) => string;
+    hexToNumber: (hex: string) => number;
+    numberToHex: (num: number) => string;
+    isAddress: (address: string) => boolean;
+};

package/build/core/services/utils.js

@@ -0,0 +1,39 @@
+// Fix TypeScript error: TronWeb.fromSun returns string, but we can pass string to it (TronWeb types might be outdated or strict)
+import { TronWeb } from "tronweb";
+// Note: TronWeb handles most of these conversions internally or via utility methods.
+// We are wrapping them here for consistent API usage across the application.
+/**
+ * Utility functions for formatting and parsing values
+ */
+export const utils = {
+    // Convert Tron (ether equivalent) to Sun (wei equivalent)
+    // 1 TRX = 1,000,000 SUN
+    toSun: (trx) => {
+        return TronWeb.toSun(trx).toString();
+    },
+    // Convert Sun to Tron
+    fromSun: (sun) => {
+        return TronWeb.fromSun(sun.toString()).toString();
+    },
+    // Format a bigint/number to a string
+    formatBigInt: (value) => value.toString(),
+    // Format an object to JSON with bigint handling
+    formatJson: (obj) => JSON.stringify(obj, (_, value) => (typeof value === "bigint" ? value.toString() : value), 2),
+    // Format a number with commas
+    formatNumber: (value) => {
+        return Number(value).toLocaleString();
+    },
+    // Convert a hex string to a number
+    hexToNumber: (hex) => {
+        return parseInt(hex, 16);
+    },
+    // Convert a number to a hex string
+    numberToHex: (num) => {
+        return "0x" + num.toString(16);
+    },
+    // Tron specific utils
+    isAddress: (address) => {
+        return TronWeb.isAddress(address);
+    },
+};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/services/utils.ts"],"names":[],"mappings":"AAAA,iIAAiI;AAEjI,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qFAAqF;AACrF,6EAA6E;AAE7E;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,0DAA0D;IAC1D,wBAAwB;IACxB,KAAK,EAAE,CAAC,GAAoB,EAAU,EAAE;QACtC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED,sBAAsB;IACtB,OAAO,EAAE,CAAC,GAA6B,EAAU,EAAE;QACjD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED,qCAAqC;IACrC,YAAY,EAAE,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;IAElE,gDAAgD;IAChD,UAAU,EAAE,CAAC,GAAY,EAAU,EAAE,CACnC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE9F,8BAA8B;IAC9B,YAAY,EAAE,CAAC,KAAsB,EAAU,EAAE;QAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC;IACxC,CAAC;IAED,mCAAmC;IACnC,WAAW,EAAE,CAAC,GAAW,EAAU,EAAE;QACnC,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,mCAAmC;IACnC,WAAW,EAAE,CAAC,GAAW,EAAU,EAAE;QACnC,OAAO,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,sBAAsB;IACtB,SAAS,EAAE,CAAC,OAAe,EAAW,EAAE;QACtC,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Get the configured account from environment (private key or mnemonic)
+ *
+ * Configuration options:
+ * - TRON_PRIVATE_KEY: Hex private key (with or without 0x prefix)
+ * - TRON_MNEMONIC: BIP-39 mnemonic phrase (12 or 24 words)
+ * - TRON_ACCOUNT_INDEX: Optional account index for HD wallet derivation (default: 0)
+ */
+export interface ConfiguredWallet {
+    privateKey: string;
+    address: string;
+}
+export declare const getConfiguredWallet: () => ConfiguredWallet;
+/**
+ * Helper to get the configured private key (for services that need it)
+ */
+export declare const getConfiguredPrivateKey: () => string;
+/**
+ * Helper to get wallet address
+ */
+export declare const getWalletAddressFromKey: () => string;
+/**
+ * Sign an arbitrary message using the configured wallet
+ * @param message The message to sign (can be a string or hex data)
+ * @returns The signature as a hex string
+ */
+export declare const signMessage: (message: string) => Promise<string>;
+/**
+ * Sign typed data (EIP-712 equivalent in Tron / TRON-712)
+ * Note: Tron support for EIP-712 is limited/specific.
+ * This implementation assumes standard EIP-712 compatible signing if supported by TronWeb version.
+ */
+export declare const signTypedData: (domain: object, types: object, value: object) => Promise<string>;

package/build/core/services/wallet.js

@@ -0,0 +1,113 @@
+import { TronWeb } from "tronweb";
+import * as bip39 from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
+import { HDKey } from "@scure/bip32";
+export const getConfiguredWallet = () => {
+    const privateKey = process.env.TRON_PRIVATE_KEY;
+    const mnemonic = process.env.TRON_MNEMONIC;
+    const accountIndexStr = process.env.TRON_ACCOUNT_INDEX || "0";
+    const accountIndex = parseInt(accountIndexStr, 10);
+    // Validate account index
+    if (isNaN(accountIndex) || accountIndex < 0 || !Number.isInteger(accountIndex)) {
+        throw new Error(`Invalid TRON_ACCOUNT_INDEX: "${accountIndexStr}". Must be a non-negative integer.`);
+    }
+    if (privateKey) {
+        // Use private key if provided
+        // TronWeb handles private keys without 0x prefix usually.
+        // If it has 0x, we strip it to be safe for TronWeb usage.
+        const cleanKey = privateKey.startsWith("0x") ? privateKey.slice(2) : privateKey;
+        const address = TronWeb.address.fromPrivateKey(cleanKey);
+        if (!address) {
+            throw new Error("Invalid private key provided in TRON_PRIVATE_KEY");
+        }
+        return {
+            privateKey: cleanKey,
+            address: address,
+        };
+    }
+    else if (mnemonic) {
+        // Derive from mnemonic
+        if (!bip39.validateMnemonic(mnemonic, wordlist)) {
+            throw new Error("Invalid mnemonic provided in TRON_MNEMONIC");
+        }
+        // Tron derivation path: m/44'/195'/0'/0/index
+        const seed = bip39.mnemonicToSeedSync(mnemonic);
+        const hdKey = HDKey.fromMasterSeed(seed);
+        const child = hdKey.derive(`m/44'/195'/0'/0/${accountIndex}`);
+        if (!child.privateKey) {
+            throw new Error("Failed to derive private key from mnemonic");
+        }
+        const privateKeyHex = Buffer.from(child.privateKey).toString("hex");
+        const address = TronWeb.address.fromPrivateKey(privateKeyHex);
+        return {
+            privateKey: privateKeyHex,
+            address: address, // TronWeb returns false or string
+        };
+    }
+    else {
+        throw new Error("Neither TRON_PRIVATE_KEY nor TRON_MNEMONIC environment variable is set. " +
+            "Configure one of them to enable write operations.\n" +
+            "- TRON_PRIVATE_KEY: Your private key in hex format\n" +
+            "- TRON_MNEMONIC: Your 12 or 24 word mnemonic phrase\n" +
+            "- TRON_ACCOUNT_INDEX: (Optional) Account index for HD wallet (default: 0)");
+    }
+};
+/**
+ * Helper to get the configured private key (for services that need it)
+ */
+export const getConfiguredPrivateKey = () => {
+    const wallet = getConfiguredWallet();
+    return wallet.privateKey;
+};
+/**
+ * Helper to get wallet address
+ */
+export const getWalletAddressFromKey = () => {
+    const wallet = getConfiguredWallet();
+    return wallet.address;
+};
+/**
+ * Sign an arbitrary message using the configured wallet
+ * @param message The message to sign (can be a string or hex data)
+ * @returns The signature as a hex string
+ */
+export const signMessage = async (message) => {
+    const { privateKey } = getConfiguredWallet();
+    const apiKey = process.env.TRONGRID_API_KEY;
+    // Create a temporary TronWeb instance for signing (network doesn't matter for pure signing usually, but good practice)
+    // Actually we can use TronWeb.Trx.signString equivalent if available statically, or instance.
+    const tronWeb = new TronWeb({
+        fullHost: "https://api.trongrid.io", // Dummy host for signing
+        privateKey: privateKey,
+        headers: apiKey ? { "TRON-PRO-API-KEY": apiKey } : undefined,
+    });
+    // Sign the message
+    // Note: TronWeb signing usually prefixes with standard Tron message prefix
+    const signature = await tronWeb.trx.sign(message);
+    return signature;
+};
+/**
+ * Sign typed data (EIP-712 equivalent in Tron / TRON-712)
+ * Note: Tron support for EIP-712 is limited/specific.
+ * This implementation assumes standard EIP-712 compatible signing if supported by TronWeb version.
+ */
+export const signTypedData = async (domain, types, value) => {
+    const { privateKey } = getConfiguredWallet();
+    const apiKey = process.env.TRONGRID_API_KEY;
+    // TronWeb might support _signTypedData or similar.
+    // For now, we'll use a generic implementation if TronWeb exposes it,
+    // otherwise we might need to construct the hash manually or use a specific library.
+    // Checking TronWeb docs, it supports signTypedData since recently.
+    const tronWeb = new TronWeb({
+        fullHost: "https://api.trongrid.io",
+        privateKey: privateKey,
+        headers: apiKey ? { "TRON-PRO-API-KEY": apiKey } : undefined,
+    });
+    // @ts-ignore - TronWeb types might be missing signTypedData
+    if (typeof tronWeb.trx._signTypedData === "function") {
+        // @ts-ignore
+        return await tronWeb.trx._signTypedData(domain, types, value);
+    }
+    throw new Error("signTypedData not supported by this TronWeb version or configuration");
+};
+//# sourceMappingURL=wallet.js.map

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

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

package/build/core/tools.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all TRON-related tools with the MCP server
+ *
+ * SECURITY: Either TRON_PRIVATE_KEY or TRON_MNEMONIC environment variable must be set for write operations.
+ * Private keys and mnemonics are never passed as tool arguments for security reasons.
+ * Tools will use the configured wallet for all transactions.
+ *
+ * Configuration options:
+ * - TRON_PRIVATE_KEY: Hex private key (with or without 0x prefix)
+ * - TRON_MNEMONIC: BIP-39 mnemonic phrase (12 or 24 words)
+ * - TRON_ACCOUNT_INDEX: Optional account index for HD wallet derivation (default: 0)
+ *
+ * @param server The MCP server instance
+ */
+export declare function registerTRONTools(server: McpServer): void;