mcp-server-tld 1.0.0

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

@@ -0,0 +1,23 @@
+/**
+ * Get TRC20 token metadata (name, symbol, decimals, totalSupply).
+ */
+export declare function getTRC20TokenInfo(tokenAddress: string, network?: string): Promise<{
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: bigint;
+    formattedTotalSupply: string;
+}>;
+/**
+ * Get TRC721 (NFT) token metadata for a specific tokenId.
+ */
+export declare function getTRC721TokenMetadata(tokenAddress: string, tokenId: bigint, network?: string): Promise<{
+    name: string;
+    symbol: string;
+    tokenURI: string;
+}>;
+/**
+ * Get the URI for a TRC1155 token ID.
+ */
+export declare function getTRC1155TokenURI(tokenAddress: string, tokenId: bigint, network?: string): Promise<string>;
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/core/services/tokens.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,SAAY,GAClB,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC,CA4BD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,SAAY,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB7D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,SAAY,GAClB,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/build/core/services/tokens.js

@@ -0,0 +1,63 @@
+import { getTronWeb } from "./clients.js";
+/**
+ * Get TRC20 token metadata (name, symbol, decimals, totalSupply).
+ */
+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);
+        const formattedTotalSupply = (Number(totalSupplyBigInt) / Number(divisor)).toString();
+        return {
+            name: String(name),
+            symbol: String(symbol),
+            decimals: decimalsNum,
+            totalSupply: totalSupplyBigInt,
+            formattedTotalSupply,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC20 token info: ${error.message}`);
+    }
+}
+/**
+ * Get TRC721 (NFT) token metadata for a specific tokenId.
+ */
+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: String(name), symbol: String(symbol), tokenURI: String(tokenURI) };
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC721 metadata: ${error.message}`);
+    }
+}
+/**
+ * Get the URI for a TRC1155 token ID.
+ */
+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 String(uri);
+    }
+    catch (error) {
+        throw new Error(`Failed to get TRC1155 URI: ${error.message}`);
+    }
+}
+//# sourceMappingURL=tokens.js.map

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,19 @@
+type Transaction = any;
+type TransactionInfo = any;
+/**
+ * Get full transaction details by hash.
+ */
+export declare function getTransaction(txHash: string, network?: string): Promise<Transaction>;
+/**
+ * Get transaction info (receipt) by hash.
+ */
+export declare function getTransactionInfo(txHash: string, network?: string): Promise<TransactionInfo>;
+/** Alias for tools expecting 'receipt'. */
+export declare const getTransactionReceipt: typeof getTransactionInfo;
+/**
+ * Poll until a transaction is confirmed and return its info.
+ * Throws after maxAttempts * 2s.
+ */
+export declare function waitForTransaction(txHash: string, network?: string): Promise<TransactionInfo>;
+export {};
+//# sourceMappingURL=transactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/core/services/transactions.ts"],"names":[],"mappings":"AAEA,KAAK,WAAW,GAAG,GAAG,CAAC;AACvB,KAAK,eAAe,GAAG,GAAG,CAAC;AAE3B;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAG9F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,SAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,2BAAqB,CAAC;AAExD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,SAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CAgB1B"}

package/build/core/services/transactions.js

@@ -0,0 +1,39 @@
+import { getTronWeb } from "./clients.js";
+/**
+ * Get full transaction details by hash.
+ */
+export async function getTransaction(txHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    return tronWeb.trx.getTransaction(txHash);
+}
+/**
+ * Get transaction info (receipt) by hash.
+ */
+export async function getTransactionInfo(txHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    return tronWeb.trx.getTransactionInfo(txHash);
+}
+/** Alias for tools expecting 'receipt'. */
+export const getTransactionReceipt = getTransactionInfo;
+/**
+ * Poll until a transaction is confirmed and return its info.
+ * Throws after maxAttempts * 2s.
+ */
+export async function waitForTransaction(txHash, network = "mainnet") {
+    const tronWeb = getTronWeb(network);
+    const maxAttempts = 30;
+    const interval = 2000;
+    for (let i = 0; i < maxAttempts; i++) {
+        try {
+            const info = await tronWeb.trx.getTransactionInfo(txHash);
+            if (info && info.id)
+                return info;
+        }
+        catch {
+            // not confirmed yet, keep polling
+        }
+        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,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAC5C,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,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,OAAO,GAAG,SAAS;IAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC;IAEtB,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;gBAAE,OAAO,IAAI,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,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,26 @@
+/**
+ * Transfer TRX to an address.
+ * @param amount - Amount in TRX (not Sun).
+ */
+export declare function transferTRX(privateKey: string, to: string, amount: string, network?: string): Promise<any>;
+/**
+ * Transfer TRC20 tokens.
+ * @param amount - Raw token amount (accounting for decimals).
+ */
+export declare function transferTRC20(tokenAddress: string, to: string, amount: string, privateKey: string, network?: string): Promise<{
+    txHash: any;
+    amount: {
+        raw: string;
+        formatted: string;
+    };
+    token: {
+        symbol: string;
+        decimals: number;
+    };
+}>;
+/**
+ * Approve a spender to spend TRC20 tokens.
+ * @param amount - Raw approval amount.
+ */
+export declare function approveTRC20(tokenAddress: string, spenderAddress: string, amount: string, privateKey: string, network?: string): Promise<any>;
+//# sourceMappingURL=transfer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/core/services/transfer.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,SAAY,gBAcpB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,SAAY;;;;;;;;;;GAuBpB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,SAAY,gBAWpB"}

package/build/core/services/transfer.js

@@ -0,0 +1,58 @@
+import { getWallet } from "./clients.js";
+import { utils } from "./utils.js";
+/**
+ * Transfer TRX to an address.
+ * @param amount - Amount in TRX (not Sun).
+ */
+export async function transferTRX(privateKey, to, amount, network = "mainnet") {
+    const tronWeb = getWallet(privateKey, network);
+    const amountSun = utils.toSun(amount);
+    const tx = await tronWeb.trx.sendTransaction(to, amountSun);
+    if (tx.result === true && tx.transaction) {
+        return tx.transaction.txID;
+    }
+    if (tx.txID) {
+        return tx.txID;
+    }
+    throw new Error(`Transaction failed: ${JSON.stringify(tx)}`);
+}
+/**
+ * Transfer TRC20 tokens.
+ * @param amount - Raw token amount (accounting for decimals).
+ */
+export async function transferTRC20(tokenAddress, to, amount, privateKey, network = "mainnet") {
+    const tronWeb = getWallet(privateKey, network);
+    try {
+        const contract = await tronWeb.contract().at(tokenAddress);
+        const txId = await contract.methods.transfer(to, amount).send();
+        const symbol = await contract.methods.symbol().call();
+        const decimals = await contract.methods.decimals().call();
+        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 },
+            token: { symbol: String(symbol), decimals: decimalsNum },
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to transfer TRC20: ${error.message}`);
+    }
+}
+/**
+ * Approve a spender to spend TRC20 tokens.
+ * @param amount - Raw approval amount.
+ */
+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,23 @@
+/**
+ * Utility functions for formatting and converting TRON values.
+ * 1 TRX = 1,000,000 SUN
+ */
+export declare const utils: {
+    /** Convert TRX to Sun (smallest unit). */
+    toSun: (trx: number | string) => string;
+    /** Convert Sun to TRX. */
+    fromSun: (sun: number | string | bigint) => string;
+    /** Stringify a bigint or number. */
+    formatBigInt: (value: bigint | number) => string;
+    /** JSON-serialize an object, converting BigInts to strings. */
+    formatJson: (obj: unknown) => string;
+    /** Format a number with locale comma separators. */
+    formatNumber: (value: number | string) => string;
+    /** Convert a hex string to a decimal number. */
+    hexToNumber: (hex: string) => number;
+    /** Convert a decimal number to a hex string (0x-prefixed). */
+    numberToHex: (num: number) => string;
+    /** Check whether a string is a valid TRON address. */
+    isAddress: (address: string) => boolean;
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/services/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,KAAK;IAChB,0CAA0C;iBAC7B,MAAM,GAAG,MAAM,KAAG,MAAM;IAIrC,0BAA0B;mBACX,MAAM,GAAG,MAAM,GAAG,MAAM,KAAG,MAAM;IAIhD,oCAAoC;0BACd,MAAM,GAAG,MAAM,KAAG,MAAM;IAE9C,+DAA+D;sBAC7C,OAAO,KAAG,MAAM;IAGlC,oDAAoD;0BAC9B,MAAM,GAAG,MAAM,KAAG,MAAM;IAE9C,gDAAgD;uBAC7B,MAAM,KAAG,MAAM;IAElC,8DAA8D;uBAC3C,MAAM,KAAG,MAAM;IAElC,sDAAsD;yBACjC,MAAM,KAAG,OAAO;CACtC,CAAC"}

package/build/core/services/utils.js

@@ -0,0 +1,28 @@
+import { TronWeb } from "tronweb";
+/**
+ * Utility functions for formatting and converting TRON values.
+ * 1 TRX = 1,000,000 SUN
+ */
+export const utils = {
+    /** Convert TRX to Sun (smallest unit). */
+    toSun: (trx) => {
+        return TronWeb.toSun(trx).toString();
+    },
+    /** Convert Sun to TRX. */
+    fromSun: (sun) => {
+        return TronWeb.fromSun(sun.toString()).toString();
+    },
+    /** Stringify a bigint or number. */
+    formatBigInt: (value) => value.toString(),
+    /** JSON-serialize an object, converting BigInts to strings. */
+    formatJson: (obj) => JSON.stringify(obj, (_, value) => (typeof value === "bigint" ? value.toString() : value), 2),
+    /** Format a number with locale comma separators. */
+    formatNumber: (value) => Number(value).toLocaleString(),
+    /** Convert a hex string to a decimal number. */
+    hexToNumber: (hex) => parseInt(hex, 16),
+    /** Convert a decimal number to a hex string (0x-prefixed). */
+    numberToHex: (num) => "0x" + num.toString(16),
+    /** Check whether a string is a valid TRON address. */
+    isAddress: (address) => 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,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,0CAA0C;IAC1C,KAAK,EAAE,CAAC,GAAoB,EAAU,EAAE;QACtC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED,0BAA0B;IAC1B,OAAO,EAAE,CAAC,GAA6B,EAAU,EAAE;QACjD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED,oCAAoC;IACpC,YAAY,EAAE,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;IAElE,+DAA+D;IAC/D,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,oDAAoD;IACpD,YAAY,EAAE,CAAC,KAAsB,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE;IAEhF,gDAAgD;IAChD,WAAW,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;IAEvD,8DAA8D;IAC9D,WAAW,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;IAE7D,sDAAsD;IACtD,SAAS,EAAE,CAAC,OAAe,EAAW,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;CACpE,CAAC"}

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

@@ -0,0 +1,25 @@
+export interface ConfiguredWallet {
+    privateKey: string;
+    address: string;
+}
+/**
+ * Get the configured wallet from environment variables.
+ * Supports TRON_PRIVATE_KEY or TRON_MNEMONIC + TRON_ACCOUNT_INDEX.
+ */
+export declare function getConfiguredWallet(): ConfiguredWallet;
+export declare function getConfiguredPrivateKey(): string;
+export declare function getWalletAddress(): string;
+/** Alias matching the mcp-server-tron API. */
+export declare const getWalletAddressFromKey: typeof getWalletAddress;
+/**
+ * Sign an arbitrary message using the configured wallet.
+ * TronWeb prefixes the message with the standard TRON message prefix.
+ * @returns Signature as a hex string.
+ */
+export declare function signMessage(message: string): Promise<string>;
+/**
+ * Sign typed data (EIP-712 / TRON-712) using the configured wallet.
+ * Requires a TronWeb version that supports _signTypedData.
+ */
+export declare function signTypedData(domain: object, types: object, value: object): Promise<string>;
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/core/services/wallet.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAmCtD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,yBAAmB,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/build/core/services/wallet.js

@@ -0,0 +1,82 @@
+import { TronWeb } from "tronweb";
+import * as bip39 from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
+import { HDKey } from "@scure/bip32";
+/**
+ * Get the configured wallet from environment variables.
+ * Supports TRON_PRIVATE_KEY or TRON_MNEMONIC + TRON_ACCOUNT_INDEX.
+ */
+export function 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);
+    if (isNaN(accountIndex) || accountIndex < 0 || !Number.isInteger(accountIndex)) {
+        throw new Error(`Invalid TRON_ACCOUNT_INDEX: "${accountIndexStr}". Must be a non-negative integer.`);
+    }
+    if (privateKey) {
+        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 };
+    }
+    if (mnemonic) {
+        if (!bip39.validateMnemonic(mnemonic, wordlist)) {
+            throw new Error("Invalid mnemonic provided in TRON_MNEMONIC");
+        }
+        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 };
+    }
+    throw new Error("Neither TRON_PRIVATE_KEY nor TRON_MNEMONIC environment variable is set.\n" +
+        "Configure one to enable write operations (supply, borrow, repay, etc.).");
+}
+export function getConfiguredPrivateKey() {
+    return getConfiguredWallet().privateKey;
+}
+export function getWalletAddress() {
+    return getConfiguredWallet().address;
+}
+/** Alias matching the mcp-server-tron API. */
+export const getWalletAddressFromKey = getWalletAddress;
+/**
+ * Sign an arbitrary message using the configured wallet.
+ * TronWeb prefixes the message with the standard TRON message prefix.
+ * @returns Signature as a hex string.
+ */
+export async function signMessage(message) {
+    const { privateKey } = getConfiguredWallet();
+    const apiKey = process.env.TRONGRID_API_KEY;
+    const tronWeb = new TronWeb({
+        fullHost: "https://api.trongrid.io",
+        privateKey,
+        headers: apiKey ? { "TRON-PRO-API-KEY": apiKey } : undefined,
+    });
+    return tronWeb.trx.sign(message);
+}
+/**
+ * Sign typed data (EIP-712 / TRON-712) using the configured wallet.
+ * Requires a TronWeb version that supports _signTypedData.
+ */
+export async function signTypedData(domain, types, value) {
+    const { privateKey } = getConfiguredWallet();
+    const apiKey = process.env.TRONGRID_API_KEY;
+    const tronWeb = new TronWeb({
+        fullHost: "https://api.trongrid.io",
+        privateKey,
+        headers: apiKey ? { "TRON-PRO-API-KEY": apiKey } : undefined,
+    });
+    // @ts-ignore — TronWeb types may not expose _signTypedData yet
+    if (typeof tronWeb.trx._signTypedData === "function") {
+        // @ts-ignore
+        return 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,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all JustLend MCP tools.
+ *
+ * SECURITY: Private keys are read from environment variables, never passed as tool arguments.
+ * Write operations require TRON_PRIVATE_KEY or TRON_MNEMONIC to be set.
+ */
+export declare function registerJustLendTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/build/core/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/core/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAmdtD"}