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

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

package/build/core/services/multicall-abi.d.ts

@@ -0,0 +1,55 @@
+export declare const MULTICALL2_ABI: {
+    inputs: ({
+        internalType: string;
+        name: string;
+        type: string;
+        components?: undefined;
+    } | {
+        components: {
+            internalType: string;
+            name: string;
+            type: string;
+        }[];
+        internalType: string;
+        name: string;
+        type: string;
+    })[];
+    name: string;
+    outputs: {
+        components: {
+            internalType: string;
+            name: string;
+            type: string;
+        }[];
+        internalType: string;
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+}[];
+export declare const MULTICALL3_ABI: {
+    inputs: {
+        components: {
+            internalType: string;
+            name: string;
+            type: string;
+        }[];
+        internalType: string;
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        components: {
+            internalType: string;
+            name: string;
+            type: string;
+        }[];
+        internalType: string;
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+}[];

package/build/core/services/multicall-abi.js

@@ -0,0 +1,61 @@
+export const MULTICALL2_ABI = [
+    {
+        inputs: [
+            { internalType: "bool", name: "requireSuccess", type: "bool" },
+            {
+                components: [
+                    { internalType: "address", name: "target", type: "address" },
+                    { internalType: "bytes", name: "callData", type: "bytes" },
+                ],
+                internalType: "struct Multicall2.Call[]",
+                name: "calls",
+                type: "tuple[]",
+            },
+        ],
+        name: "tryAggregate",
+        outputs: [
+            {
+                components: [
+                    { internalType: "bool", name: "success", type: "bool" },
+                    { internalType: "bytes", name: "returnData", type: "bytes" },
+                ],
+                internalType: "struct Multicall2.Result[]",
+                name: "returnData",
+                type: "tuple[]",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+];
+export const MULTICALL3_ABI = [
+    {
+        inputs: [
+            {
+                components: [
+                    { internalType: "address", name: "target", type: "address" },
+                    { internalType: "bool", name: "allowFailure", type: "bool" },
+                    { internalType: "bytes", name: "callData", type: "bytes" },
+                ],
+                internalType: "struct Multicall3.Call3[]",
+                name: "calls",
+                type: "tuple[]",
+            },
+        ],
+        name: "aggregate3",
+        outputs: [
+            {
+                components: [
+                    { internalType: "bool", name: "success", type: "bool" },
+                    { internalType: "bytes", name: "returnData", type: "bytes" },
+                ],
+                internalType: "struct Multicall3.Result[]",
+                name: "returnData",
+                type: "tuple[]",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+];
+//# sourceMappingURL=multicall-abi.js.map

package/build/core/services/multicall-abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicall-abi.js","sourceRoot":"","sources":["../../../src/core/services/multicall-abi.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,MAAM,EAAE;YACN,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE;YAC9D;gBACE,UAAU,EAAE;oBACV,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC5D,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;iBAC3D;gBACD,YAAY,EAAE,0BAA0B;gBACxC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;aAChB;SACF;QACD,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE;YACP;gBACE,UAAU,EAAE;oBACV,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;oBACvD,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;iBAC7D;gBACD,YAAY,EAAE,4BAA4B;gBAC1C,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,SAAS;aAChB;SACF;QACD,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,MAAM,EAAE;YACN;gBACE,UAAU,EAAE;oBACV,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC5D,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE;oBAC5D,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;iBAC3D;gBACD,YAAY,EAAE,2BAA2B;gBACzC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;aAChB;SACF;QACD,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE;YACP;gBACE,UAAU,EAAE;oBACV,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;oBACvD,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;iBAC7D;gBACD,YAAY,EAAE,4BAA4B;gBAC1C,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,SAAS;aAChB;SACF;QACD,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;CACF,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Get TRC20 token information
+ */
+export declare function getTRC20TokenInfo(tokenAddress: string, network?: string): Promise<{
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: bigint;
+    formattedTotalSupply: string;
+}>;
+/**
+ * Get TRC721 token metadata
+ */
+export declare function getTRC721TokenMetadata(tokenAddress: string, tokenId: bigint, network?: string): Promise<{
+    name: string;
+    symbol: string;
+    tokenURI: string;
+}>;
+/**
+ * Get TRC1155 token URI
+ */
+export declare function getTRC1155TokenURI(tokenAddress: string, tokenId: bigint, network?: string): Promise<string>;

package/build/core/services/tokens.js

@@ -0,0 +1,68 @@
+import { getTronWeb } from "./clients.js";
+/**
+ * Get TRC20 token information
+ */
+export async function getTRC20TokenInfo(tokenAddress, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        const [name, symbol, decimals, totalSupply] = await Promise.all([
+            contract.methods.name().call(),
+            contract.methods.symbol().call(),
+            contract.methods.decimals().call(),
+            contract.methods.totalSupply().call(),
+        ]);
+        const decimalsNum = Number(decimals);
+        const totalSupplyBigInt = BigInt(totalSupply.toString());
+        const divisor = BigInt(10) ** BigInt(decimalsNum);
+        // Formatting total supply
+        const formattedTotalSupply = (Number(totalSupplyBigInt) / Number(divisor)).toString();
+        return {
+            name,
+            symbol,
+            decimals: decimalsNum,
+            totalSupply: totalSupplyBigInt,
+            formattedTotalSupply,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC20 token info: ${error.message}`);
+    }
+}
+/**
+ * Get TRC721 token metadata
+ */
+export async function getTRC721TokenMetadata(tokenAddress, tokenId, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        const [name, symbol, tokenURI] = await Promise.all([
+            contract.methods.name().call(),
+            contract.methods.symbol().call(),
+            contract.methods.tokenURI(tokenId.toString()).call(),
+        ]);
+        return {
+            name,
+            symbol,
+            tokenURI,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC721 metadata: ${error.message}`);
+    }
+}
+/**
+ * Get TRC1155 token URI
+ */
+export async function getTRC1155TokenURI(tokenAddress, tokenId, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        const uri = await contract.methods.uri(tokenId.toString()).call();
+        return uri;
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC1155 URI: ${error.message}`);
+    }
+}
+//# sourceMappingURL=tokens.js.map