@bankofai/mcp-server-tron 1.1.1

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,OAAO,GAAG,SAAS;IACtE,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzD,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,2FAA2F;QACpH,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,iBAAiB;QACnD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACpC,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAoB,EACpB,aAAqB,EACrB,OAAO,GAAG,SAAS;IAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;QAC3D,2BAA2B;QAC3B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAEtD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE1D,mBAAmB;QACnB,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEvE,OAAO;YACL,GAAG,EAAE,aAAa;YAClB,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE;gBACL,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;gBAC1B,OAAO,EAAE,YAAY;aACtB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,eAAuB,EACvB,YAAoB,EACpB,OAAe,EACf,OAAO,GAAG,SAAS;IAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1F,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

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"}

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

@@ -0,0 +1,50 @@
+/**
+ * Read from a smart contract (view/pure functions)
+ */
+export declare function readContract(params: {
+    address: string;
+    functionName: string;
+    args?: any[];
+    abi?: any[];
+}, network?: string): Promise<any>;
+/**
+ * Write to a smart contract (state changing functions)
+ */
+export declare function writeContract(privateKey: string, params: {
+    address: string;
+    functionName: string;
+    args?: any[];
+    value?: string;
+    abi?: any[];
+}, network?: string): Promise<any>;
+/**
+ * Fetch contract ABI via TronWeb (available for verified contracts)
+ */
+export declare function fetchContractABI(contractAddress: string, network?: string): Promise<any>;
+/**
+ * Parse ABI (helper to ensure correct format for TronWeb if needed)
+ */
+export declare function parseABI(abiJson: string | any[]): any[];
+/**
+ * Get readable function signatures from ABI
+ */
+export declare function getReadableFunctions(abi: any[]): string[];
+/**
+ * Helper to get a specific function definition from ABI
+ */
+export declare function getFunctionFromABI(abi: any[], functionName: string): any;
+/**
+ * Multicall (Simulated or Native Multicall2/3)
+ */
+export declare function multicall(params: {
+    calls: Array<{
+        address: string;
+        functionName: string;
+        args?: any[];
+        abi: any[];
+        allowFailure?: boolean;
+    }>;
+    multicallAddress?: string;
+    version?: 2 | 3;
+    allowFailure?: boolean;
+}, network?: string): Promise<any>;

package/build/core/services/contracts.js

@@ -0,0 +1,225 @@
+import { getTronWeb, getWallet } from "./clients.js";
+import { MULTICALL2_ABI, MULTICALL3_ABI } from "./multicall-abi.js";
+/**
+ * Read from a smart contract (view/pure functions)
+ */
+export async function readContract(params, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        let contract;
+        if (params.abi) {
+            contract = tronWeb.contract(params.abi, params.address);
+        }
+        else {
+            contract = await tronWeb.contract().at(params.address);
+        }
+        const method = contract.methods[params.functionName];
+        if (!method) {
+            throw new Error(`Function ${params.functionName} not found in contract`);
+        }
+        const args = params.args || [];
+        const result = await method(...args).call();
+        return result;
+    }
+    catch (error) {
+        throw new Error(`Read contract failed: ${error.message}`);
+    }
+}
+/**
+ * Write to a smart contract (state changing functions)
+ */
+export async function writeContract(privateKey, params, network = "mainnet") {
+    const tronWeb = getWallet(privateKey, network);
+    try {
+        let contract;
+        if (params.abi) {
+            contract = tronWeb.contract(params.abi, params.address);
+        }
+        else {
+            contract = await tronWeb.contract().at(params.address);
+        }
+        const method = contract.methods[params.functionName];
+        if (!method) {
+            throw new Error(`Function ${params.functionName} not found in contract`);
+        }
+        const args = params.args || [];
+        const options = {};
+        if (params.value) {
+            options.callValue = params.value;
+        }
+        const txId = await method(...args).send(options);
+        return txId;
+    }
+    catch (error) {
+        throw new Error(`Write contract failed: ${error.message}`);
+    }
+}
+/**
+ * Fetch contract ABI via TronWeb (available for verified contracts)
+ */
+export async function fetchContractABI(contractAddress, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const contract = await tronWeb.trx.getContract(contractAddress);
+        if (contract && contract.abi) {
+            return contract.abi.entrys;
+        }
+        throw new Error("ABI not found in contract data");
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch ABI: ${error.message}`);
+    }
+}
+/**
+ * Parse ABI (helper to ensure correct format for TronWeb if needed)
+ */
+export function parseABI(abiJson) {
+    if (typeof abiJson === "string") {
+        return JSON.parse(abiJson);
+    }
+    return abiJson;
+}
+/**
+ * Get readable function signatures from ABI
+ */
+export function getReadableFunctions(abi) {
+    return abi
+        .filter((item) => item.type === "function")
+        .map((item) => {
+        const inputs = item.inputs
+            ? item.inputs.map((i) => `${i.type} ${i.name}`).join(", ")
+            : "";
+        const outputs = item.outputs
+            ? item.outputs.map((i) => `${i.type} ${i.name || ""}`).join(", ")
+            : "";
+        return `${item.name}(${inputs}) -> (${outputs})`;
+    });
+}
+/**
+ * Helper to get a specific function definition from ABI
+ */
+export function getFunctionFromABI(abi, functionName) {
+    const func = abi.find((item) => item.type === "function" && item.name === functionName);
+    if (!func) {
+        throw new Error(`Function ${functionName} not found in ABI`);
+    }
+    return func;
+}
+/**
+ * Multicall (Simulated or Native Multicall2/3)
+ */
+export async function multicall(params, network = "mainnet") {
+    const { calls, version = 3, allowFailure: globalAllowFailure = true } = params;
+    const mAddress = params.multicallAddress;
+    const fallbackToSimulation = async (error) => {
+        if (error)
+            console.error(`Multicall failed, falling back to simulation: ${error}`);
+        const results = await Promise.allSettled(calls.map((call) => readContract(call, network)));
+        return results.map((result, idx) => {
+            if (result.status === "fulfilled") {
+                return { success: true, result: result.value };
+            }
+            else {
+                return {
+                    success: false,
+                    error: `Call to ${calls[idx].functionName} failed: ${result.reason}`,
+                };
+            }
+        });
+    };
+    if (!mAddress) {
+        return fallbackToSimulation();
+    }
+    const tronWeb = getTronWeb(network);
+    try {
+        const callDataWithFuncs = calls.map((call) => {
+            const func = call.abi.find((i) => i.name === call.functionName && i.type === "function");
+            if (!func) {
+                throw new Error(`Function ${call.functionName} not found in ABI for ${call.address}`);
+            }
+            const inputs = func.inputs || [];
+            const types = inputs.map((i) => i.type);
+            const signature = `${call.functionName}(${types.join(",")})`;
+            const fullHash = tronWeb.sha3(signature);
+            const selector = fullHash.startsWith("0x")
+                ? fullHash.slice(0, 10)
+                : "0x" + fullHash.slice(0, 8);
+            const values = call.args || [];
+            const encodedArgs = tronWeb.utils.abi.encodeParams(types, values).replace(/^0x/, "");
+            const callData = selector + encodedArgs;
+            const callAllowFailure = call.allowFailure !== undefined ? call.allowFailure : globalAllowFailure;
+            return {
+                callData: version === 3 ? [call.address, callAllowFailure, callData] : [call.address, callData],
+                func,
+            };
+        });
+        const encodedCalls = callDataWithFuncs.map((item) => item.callData);
+        const multicallAbi = version === 3 ? MULTICALL3_ABI : MULTICALL2_ABI;
+        const method = version === 3 ? "aggregate3" : "tryAggregate";
+        const multicallArgs = version === 3 ? [encodedCalls] : [!globalAllowFailure, encodedCalls];
+        const contract = tronWeb.contract(multicallAbi, mAddress);
+        const results = await contract[method](...multicallArgs).call();
+        // TronWeb might wrap the result array in another array
+        const finalResults = Array.isArray(results) &&
+            results.length === 1 &&
+            Array.isArray(results[0]) &&
+            (Array.isArray(results[0][0]) || typeof results[0][0] === "object")
+            ? results[0]
+            : results;
+        return finalResults.map((res, index) => {
+            const success = res.success !== undefined ? res.success : res[0];
+            const returnData = res.returnData !== undefined ? res.returnData : res[1];
+            if (!success) {
+                return {
+                    success: false,
+                    error: `Call to ${calls[index].functionName} failed in multicall`,
+                };
+            }
+            const func = callDataWithFuncs[index].func;
+            const outputs = func.outputs || [];
+            const outputTypes = outputs.map((o) => o.type);
+            const outputNames = outputs.map((o) => o.name || "");
+            try {
+                const decoded = tronWeb.utils.abi.decodeParams(outputNames, outputTypes, returnData, true);
+                let result;
+                if (outputTypes.length === 1) {
+                    if (typeof decoded === "object" && !Array.isArray(decoded)) {
+                        // TronWeb decodeParams returns an object with both index keys and named keys
+                        // For example: { "0": 123n, "timestamp": 123n }
+                        // We want to return the raw value if it's a single output,
+                        // but we need to be careful if the user expects the object structure.
+                        // MCP tools usually prefer the raw value for single outputs for simplicity.
+                        const entries = Object.entries(decoded);
+                        const namedEntry = entries.find(([k]) => isNaN(Number(k)) && k !== "");
+                        // If it's a single output AND it has a name, we return the WHOLE object
+                        // so results[0].result.timestamp works.
+                        // If it has NO name (just "0"), we return the raw value.
+                        if (namedEntry) {
+                            result = decoded;
+                        }
+                        else {
+                            result = entries[0] ? entries[0][1] : decoded;
+                        }
+                    }
+                    else {
+                        result = Array.isArray(decoded) && decoded.length === 1 ? decoded[0] : decoded;
+                    }
+                }
+                else {
+                    result = decoded;
+                }
+                return { success: true, result };
+            }
+            catch (e) {
+                return {
+                    success: false,
+                    error: `Failed to decode ${calls[index].functionName}: ${e.message}`,
+                };
+            }
+        });
+    }
+    catch (error) {
+        return fallbackToSimulation(error.message);
+    }
+}
+//# sourceMappingURL=contracts.js.map

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

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

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

@@ -0,0 +1,119 @@
+export * from "./clients.js";
+export * from "./balance.js";
+export * from "./transfer.js";
+export * from "./blocks.js";
+export * from "./transactions.js";
+export * from "./contracts.js";
+export * from "./tokens.js";
+export * from "./address.js";
+export * from "./wallet.js";
+export * from "./multicall-abi.js";
+export * from "./utils.js";
+import * as wallet from "./wallet.js";
+import * as transactions from "./transactions.js";
+export declare const helpers: {
+    formatJson: (obj: unknown) => string;
+    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;
+    };
+    toHexAddress(address: string): string;
+    toBase58Address(address: string): string;
+    isBase58(address: string): boolean;
+    isHex(address: string): boolean;
+    resolveAddress: (nameOrAddress: string, _network?: string) => Promise<string>;
+    transferTRX(privateKey: string, to: string, amount: string, network?: string): Promise<any>;
+    transferTRC20(tokenAddress: string, to: string, amount: string, privateKey: string, network?: string): Promise<{
+        txHash: any;
+        amount: {
+            raw: string;
+            formatted: string;
+        };
+        token: {
+            symbol: any;
+            decimals: number;
+        };
+    }>;
+    approveTRC20(tokenAddress: string, spenderAddress: string, amount: string, privateKey: string, network?: string): Promise<any>;
+    getTRC20TokenInfo(tokenAddress: string, network?: string): Promise<{
+        name: string;
+        symbol: string;
+        decimals: number;
+        totalSupply: bigint;
+        formattedTotalSupply: string;
+    }>;
+    getTRC721TokenMetadata(tokenAddress: string, tokenId: bigint, network?: string): Promise<{
+        name: string;
+        symbol: string;
+        tokenURI: string;
+    }>;
+    getTRC1155TokenURI(tokenAddress: string, tokenId: bigint, network?: string): Promise<string>;
+    readContract(params: {
+        address: string;
+        functionName: string;
+        args?: any[];
+        abi?: any[];
+    }, network?: string): Promise<any>;
+    writeContract(privateKey: string, params: {
+        address: string;
+        functionName: string;
+        args?: any[];
+        value?: string;
+        abi?: any[];
+    }, network?: string): Promise<any>;
+    fetchContractABI(contractAddress: string, network?: string): Promise<any>;
+    parseABI(abiJson: string | any[]): any[];
+    getReadableFunctions(abi: any[]): string[];
+    getFunctionFromABI(abi: any[], functionName: string): any;
+    multicall(params: {
+        calls: Array<{
+            address: string;
+            functionName: string;
+            args?: any[];
+            abi: any[];
+            allowFailure?: boolean;
+        }>;
+        multicallAddress?: string;
+        version?: 2 | 3;
+        allowFailure?: boolean;
+    }, network?: string): Promise<any>;
+    getTransaction(txHash: string, network?: string): Promise<any>;
+    getTransactionInfo(txHash: string, network?: string): Promise<any>;
+    waitForTransaction(txHash: string, network?: string): Promise<any>;
+    getTransactionReceipt: typeof transactions.getTransactionInfo;
+    getBlockByNumber(blockNumber: number, network?: string): Promise<any>;
+    getBlockByHash(blockHash: string, network?: string): Promise<any>;
+    getLatestBlock(network?: string): Promise<any>;
+    getBlockNumber(network?: string): Promise<number>;
+    getChainId(network?: string): Promise<number>;
+    getTRXBalance(address: string, network?: string): Promise<{
+        wei: bigint;
+        ether: string;
+        formatted: string;
+        symbol: string;
+        decimals: number;
+    }>;
+    getTRC20Balance(tokenAddress: string, walletAddress: string, network?: string): Promise<{
+        raw: bigint;
+        formatted: string;
+        token: {
+            symbol: any;
+            decimals: number;
+            address: string;
+        };
+    }>;
+    getTRC1155Balance(contractAddress: string, ownerAddress: string, tokenId: bigint, network?: string): Promise<bigint>;
+    getConfiguredWallet: () => wallet.ConfiguredWallet;
+    getConfiguredPrivateKey: () => string;
+    getWalletAddressFromKey: () => string;
+    signMessage: (message: string) => Promise<string>;
+    signTypedData: (domain: object, types: object, value: object) => Promise<string>;
+    getTronWeb(network?: string): import("tronweb").TronWeb;
+    getWallet(privateKey: string, network?: string): import("tronweb").TronWeb;
+};

package/build/core/services/index.js

@@ -0,0 +1,39 @@
+// Export all services
+export * from "./clients.js";
+export * from "./balance.js";
+export * from "./transfer.js";
+export * from "./blocks.js";
+export * from "./transactions.js";
+export * from "./contracts.js";
+export * from "./tokens.js";
+export * from "./address.js";
+export * from "./wallet.js";
+export * from "./multicall-abi.js";
+export * from "./utils.js"; // Export utils as top level as well
+// Add a helper object for easier access to everything
+import * as clients from "./clients.js";
+import * as wallet from "./wallet.js";
+import * as balance from "./balance.js";
+import * as blocks from "./blocks.js";
+import * as transactions from "./transactions.js";
+import * as contracts from "./contracts.js";
+import * as tokens from "./tokens.js";
+import * as transfer from "./transfer.js";
+import * as utils from "./utils.js";
+import * as address from "./address.js";
+// Re-export specific utils function as 'helpers' for backward compatibility with tools code
+export const helpers = {
+    ...clients,
+    ...wallet,
+    ...balance,
+    ...blocks,
+    ...transactions,
+    ...contracts,
+    ...tokens,
+    ...transfer,
+    ...address,
+    ...utils,
+    // Specifically map formatJson from utils to helpers root as tools expect it there
+    formatJson: utils.utils.formatJson,
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/services/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC,CAAC,oCAAoC;AAEhE,sDAAsD;AACtD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAExC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,OAAO;IACV,GAAG,MAAM;IACT,GAAG,OAAO;IACV,GAAG,MAAM;IACT,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,MAAM;IACT,GAAG,QAAQ;IACX,GAAG,OAAO;IACV,GAAG,KAAK;IACR,kFAAkF;IAClF,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;CACnC,CAAC"}