@dynamic-labs/tron 4.40.0 → 4.40.2

package/src/types.d.ts

@@ -1,182 +1,12 @@
-import type { TronWeb, Types } from 'tronweb';
-/**
- * Global window interface extension for Tron wallet providers
- */
-declare global {
-    interface Window {
-        tronLink?: ITronProvider;
-        tronWeb?: TronWeb;
-        bitkeep?: {
-            tron?: ITronProvider;
-        };
-        bybitWallet?: {
-            tronLink?: ITronProvider;
-            tronWeb?: TronWeb;
-        };
-        okxwallet?: {
-            tronLink?: ITronProvider;
-            tronWeb?: TronWeb;
-        };
-        trustwallet?: {
-            tronLink?: ITronProvider;
-            tronWeb?: TronWeb;
-        };
-        tokenpocket?: {
-            tron?: ITronProvider;
-            tronWeb?: TronWeb;
-        };
-    }
-}
-/**
- * Interface that all Tron wallet providers must implement.
- *
- * This interface is designed to be flexible and work with different
- * Tron wallet implementations like TronLink, TokenPocket, etc.
- */
-export interface ITronProvider {
-    /** Whether the wallet is currently connected */
-    isConnected?: boolean;
-    /** Whether the wallet is ready */
-    ready?: boolean;
-    /** The current network chain ID */
-    chainId?: string;
-    /** The current network name */
-    network?: string;
-    /** The current wallet address */
-    address?: string;
-    /** TronWeb instance */
-    tronWeb?: TronWeb;
-    /** TronLink specific flag */
-    isTronLink?: boolean;
-    /**
-     * Request connection to the wallet
-     * @returns Promise that resolves to connection result
-     */
-    request?(params: {
-        method: string;
-        params?: unknown;
-    }): Promise<unknown>;
-    /**
-     * Connect to the wallet (TronLink style)
-     * @returns Promise that resolves to connection result
-     */
-    connect?(): Promise<TronConnectionResult>;
-    /**
-     * Disconnect from the wallet
-     * @returns Promise that resolves when disconnected
-     */
-    disconnect?(): Promise<void>;
-    /**
-     * Sign a message
-     * @param message - Message to sign
-     * @returns Promise that resolves to the signature
-     */
-    signMessage?(message: string): Promise<string>;
-    /**
-     * Sign a transaction
-     * @param transaction - Transaction to sign
-     * @returns Promise that resolves to the signed transaction
-     */
-    signTransaction?(transaction: Types.Transaction): Promise<Types.SignedTransaction>;
-    /**
-     * Send a transaction
-     * @param transaction - Transaction to send
-     * @returns Promise that resolves to transaction result
-     */
-    sendTransaction?(transaction: Types.SignedTransaction): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
-    /**
-     * Send TRX to an address
-     * @param to - Recipient address
-     * @param amount - Amount in TRX
-     * @param options - Optional parameters
-     * @returns Promise that resolves to transaction result
-     */
-    sendTrx?(to: string, amount: number, options?: {
-        from?: string;
-    }): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
-    /**
-     * Send tokens to an address
-     * @param to - Recipient address
-     * @param amount - Amount of tokens
-     * @param tokenId - Token ID
-     * @param options - Optional parameters
-     * @returns Promise that resolves to transaction result
-     */
-    sendToken?(to: string, amount: number, tokenId: string | number, options?: {
-        from?: string;
-    }): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
-    /**
-     * Get account balance
-     * @param address - Optional address (defaults to current account)
-     * @returns Promise that resolves to balance in SUN
-     */
-    getBalance?(address?: string): Promise<number>;
-    /**
-     * Get token balance
-     * @param tokenId - Token ID
-     * @param address - Optional address (defaults to current account)
-     * @returns Promise that resolves to token balance
-     */
-    getTokenBalance?(tokenId: string, address?: string): Promise<number>;
-    /**
-     * Get current network information
-     * @returns Promise that resolves to network info
-     */
-    getNetwork?(): Promise<{
+import type { Adapter, AdapterState, WalletReadyState } from '@tronweb3/tronwallet-abstract-adapter';
+export type { Adapter, AdapterState, WalletReadyState };
+export type TronAdapterEvents = {
+    connect: (address: string) => void;
+    disconnect: () => void;
+    accountsChanged: (address: string, preAddress?: string) => void;
+    chainChanged: (chainData: {
         chainId: string;
-        name: string;
-    }>;
-    /**
-     * Switch network
-     * @param networkId - Network ID to switch to
-     * @returns Promise that resolves when network is switched
-     */
-    switchNetwork?(networkId: string): Promise<void>;
-    /**
-     * Add network
-     * @param network - Network configuration to add
-     * @returns Promise that resolves when network is added
-     */
-    addNetwork?(network: {
-        networkId: string;
-        name: string;
-        rpcUrl: string;
-        chainId?: string;
-    }): Promise<void>;
-    /**
-     * Listen for account changes
-     * @param callback - Callback function for account changes
-     */
-    onAccountChange?(callback: (address: string) => void): void;
-    /**
-     * Listen for network changes
-     * @param callback - Callback function for network changes
-     */
-    onNetworkChange?(callback: (network: {
-        chainId: string;
-        name: string;
-    }) => void): void;
-    /**
-     * Remove account change listener
-     * @param callback - Callback function to remove
-     */
-    removeAccountChangeListener?(callback: (address: string) => void): void;
-    /**
-     * Remove network change listener
-     * @param callback - Callback function to remove
-     */
-    removeNetworkChangeListener?(callback: (network: {
-        chainId: string;
-        name: string;
-    }) => void): void;
-    /** Additional properties that providers may implement */
-    [key: string]: unknown;
-}
-/**
- * Result from wallet connection
- */
-export type TronConnectionResult = {
-    address: string;
-    chainId?: string;
-    network?: string;
-} | string | boolean;
+    }) => void;
+    readyStateChanged: (state: WalletReadyState) => void;
+    error: (error: Error) => void;
+};

package/src/utils/TronUiTransaction/TronUiTransaction.cjs

@@ -6,45 +6,77 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _tslib = require('../../../_virtual/_tslib.cjs');
 var utils = require('@dynamic-labs/utils');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
-var getTronGasEstimation = require('../getTronGasEstimation.cjs');
+var getTronGasEstimation = require('../getTronGasEstimation/getTronGasEstimation.cjs');
 
-// 1 TRX = 1,000,000 SUN (atomic units)
+/**
+ * 1 TRX = 1,000,000 SUN (atomic units)
+ */
 const SUN_PER_TRX = 1000000;
+/**
+ * TronUiTransaction class for managing Tron transactions in the UI
+ */
 class TronUiTransaction {
-    constructor({ onSubmit, from, provider }) {
+    constructor({ onSubmit, from, tronWeb }) {
         this.chain = 'TRON';
         this.data = undefined;
         this.fee = { gas: undefined };
         this.from = from;
         this.onSubmit = onSubmit;
-        this.provider = provider;
+        this.tronWeb = tronWeb;
     }
+    /**
+     * Fetch the estimated transaction fee
+     */
     fetchFee() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
-            if (this.fee.gas)
+            // Skip if we already fetched
+            if (this.fee.gas !== undefined)
                 return;
-            this.fee.gas = yield getTronGasEstimation.getTronGasEstimation({
-                from: this.from,
-                nonNativeAddress: this.nonNativeAddress,
-                nonNativeValue: this.nonNativeValue,
-                provider: this.provider,
-                to: this.to,
-                value: this.value,
-            });
+            // Default to 0 for most Tron transactions (free with bandwidth)
+            this.fee.gas = BigInt(0);
+            // Try to get a more accurate estimate if we have the data
+            if (!this.to || (!this.value && !this.nonNativeValue)) {
+                return;
+            }
+            try {
+                const estimatedFee = yield getTronGasEstimation.getTronGasEstimation({
+                    from: this.from,
+                    nonNativeAddress: this.nonNativeAddress,
+                    nonNativeValue: this.nonNativeValue,
+                    to: this.to,
+                    tronWeb: this.tronWeb,
+                    value: this.value,
+                });
+                // Update with the actual estimate
+                this.fee.gas = estimatedFee;
+            }
+            catch (error) {
+                walletConnectorCore.logger.error('Failed to fetch Tron transaction fee:', error);
+                // Keep the default 0 we already set
+            }
         });
     }
+    /**
+     * Parse string input to bigint (for TRX)
+     */
     parse(input) {
         const numericValue = parseFloat(input);
         if (isNaN(numericValue))
             return BigInt(0);
         return BigInt(Math.floor(numericValue * SUN_PER_TRX));
     }
+    /**
+     * Parse string input to bigint (for TRC20 tokens)
+     */
     parseNonNativeToken(input, decimals) {
         const numericValue = parseFloat(input);
         if (isNaN(numericValue))
             return BigInt(0);
         return BigInt(Math.floor(numericValue * Math.pow(10, decimals)));
     }
+    /**
+     * Format bigint value to string (for TRX)
+     */
     format(value, options) {
         var _a;
         const trxValue = Number(value) / SUN_PER_TRX;
@@ -52,12 +84,18 @@ class TronUiTransaction {
             precision: (_a = options === null || options === void 0 ? void 0 : options.precision) !== null && _a !== void 0 ? _a : 6,
         });
     }
+    /**
+     * Format bigint value to string (for TRC20 tokens)
+     */
     formatNonNativeToken(value, decimals) {
         const tokenValue = Number(value) / Math.pow(10, decimals);
         return utils.formatNumberText(String(tokenValue), {
             precision: decimals > 6 ? 6 : decimals,
         });
     }
+    /**
+     * Submit the transaction
+     */
     submit() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             if (!this.to) {
@@ -69,23 +107,23 @@ class TronUiTransaction {
             return this.onSubmit(this);
         });
     }
+    /**
+     * Get the balance for the from address
+     */
     getBalance() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             try {
-                const { tronWeb } = this.provider;
-                if (!tronWeb)
-                    return BigInt(0);
                 if (this.nonNativeAddress) {
                     // Get TRC20 token balance
-                    const contract = yield tronWeb.contract().at(this.nonNativeAddress);
+                    const contract = yield this.tronWeb
+                        .contract()
+                        .at(this.nonNativeAddress);
                     const balance = yield contract.balanceOf(String(this.from)).call();
                     return BigInt(typeof balance === 'string' ? balance : balance.toString());
                 }
-                else {
-                    // Get native TRX balance
-                    const balance = yield tronWeb.trx.getBalance(String(this.from));
-                    return BigInt(String(balance));
-                }
+                // Get native TRX balance
+                const balance = yield this.tronWeb.trx.getBalance(String(this.from));
+                return BigInt(String(balance));
             }
             catch (error) {
                 walletConnectorCore.logger.error('Error occurred while fetching TRON balance. Please try again or contact support.');
@@ -93,25 +131,28 @@ class TronUiTransaction {
             }
         });
     }
+    /**
+     * Validate Tron address format
+     */
     validateAddressFormat(address) {
         if (address === 'dyn_send_transaction.multiple_recipients') {
             return true;
         }
         try {
-            const { tronWeb } = this.provider;
-            if (!tronWeb)
-                return false;
             // TRON addresses start with 'T' and are 34 characters long
             if (!address.startsWith('T') || address.length !== 34) {
                 return false;
             }
             // Use TronWeb's built-in address validation
-            return tronWeb.isAddress(address);
+            return this.tronWeb.isAddress(address);
         }
         catch (_a) {
             return false;
         }
     }
+    /**
+     * Check if gas is sponsored
+     */
     isGasSponsored() {
         return false;
     }

package/src/utils/TronUiTransaction/TronUiTransaction.d.ts

@@ -1,14 +1,20 @@
+import type { TronWeb } from 'tronweb';
 import { IUITransaction, IUITransactionFormatOptions } from '@dynamic-labs/types';
-import type { ITronProvider } from '../../types';
+/**
+ * 1 TRX = 1,000,000 SUN (atomic units)
+ */
 export declare const SUN_PER_TRX = 1000000;
 type TronUiTransactionProps = {
     /** TRON Address of the sender */
     from: string;
-    /** The TRON provider instance, needed to interact with TronWeb */
-    provider: ITronProvider;
+    /** The TronWeb instance for interacting with the network */
+    tronWeb: TronWeb;
     /** The function to call when the transaction is submitted */
     onSubmit: (transaction: TronUiTransaction) => Promise<string>;
 };
+/**
+ * TronUiTransaction class for managing Tron transactions in the UI
+ */
 export declare class TronUiTransaction implements IUITransaction {
     to: string | undefined;
     from: string;
@@ -24,16 +30,43 @@ export declare class TronUiTransaction implements IUITransaction {
     nonNativeValue?: bigint;
     nativePrice?: number;
     private onSubmit;
-    private provider;
-    constructor({ onSubmit, from, provider }: TronUiTransactionProps);
+    private tronWeb;
+    constructor({ onSubmit, from, tronWeb }: TronUiTransactionProps);
+    /**
+     * Fetch the estimated transaction fee
+     */
     fetchFee(): Promise<void>;
+    /**
+     * Parse string input to bigint (for TRX)
+     */
     parse(input: string): bigint;
+    /**
+     * Parse string input to bigint (for TRC20 tokens)
+     */
     parseNonNativeToken(input: string, decimals: number): bigint;
+    /**
+     * Format bigint value to string (for TRX)
+     */
     format(value: bigint, options?: IUITransactionFormatOptions): string;
+    /**
+     * Format bigint value to string (for TRC20 tokens)
+     */
     formatNonNativeToken(value: bigint, decimals: number): string;
+    /**
+     * Submit the transaction
+     */
     submit(): Promise<string>;
+    /**
+     * Get the balance for the from address
+     */
     getBalance(): Promise<bigint>;
+    /**
+     * Validate Tron address format
+     */
     validateAddressFormat(address: string): boolean;
+    /**
+     * Check if gas is sponsored
+     */
     isGasSponsored(): boolean;
 }
 export {};

package/src/utils/TronUiTransaction/TronUiTransaction.js

@@ -2,45 +2,77 @@
 import { __awaiter } from '../../../_virtual/_tslib.js';
 import { formatNumberText } from '@dynamic-labs/utils';
 import { logger } from '@dynamic-labs/wallet-connector-core';
-import { getTronGasEstimation } from '../getTronGasEstimation.js';
+import { getTronGasEstimation } from '../getTronGasEstimation/getTronGasEstimation.js';
 
-// 1 TRX = 1,000,000 SUN (atomic units)
+/**
+ * 1 TRX = 1,000,000 SUN (atomic units)
+ */
 const SUN_PER_TRX = 1000000;
+/**
+ * TronUiTransaction class for managing Tron transactions in the UI
+ */
 class TronUiTransaction {
-    constructor({ onSubmit, from, provider }) {
+    constructor({ onSubmit, from, tronWeb }) {
         this.chain = 'TRON';
         this.data = undefined;
         this.fee = { gas: undefined };
         this.from = from;
         this.onSubmit = onSubmit;
-        this.provider = provider;
+        this.tronWeb = tronWeb;
     }
+    /**
+     * Fetch the estimated transaction fee
+     */
     fetchFee() {
         return __awaiter(this, void 0, void 0, function* () {
-            if (this.fee.gas)
+            // Skip if we already fetched
+            if (this.fee.gas !== undefined)
                 return;
-            this.fee.gas = yield getTronGasEstimation({
-                from: this.from,
-                nonNativeAddress: this.nonNativeAddress,
-                nonNativeValue: this.nonNativeValue,
-                provider: this.provider,
-                to: this.to,
-                value: this.value,
-            });
+            // Default to 0 for most Tron transactions (free with bandwidth)
+            this.fee.gas = BigInt(0);
+            // Try to get a more accurate estimate if we have the data
+            if (!this.to || (!this.value && !this.nonNativeValue)) {
+                return;
+            }
+            try {
+                const estimatedFee = yield getTronGasEstimation({
+                    from: this.from,
+                    nonNativeAddress: this.nonNativeAddress,
+                    nonNativeValue: this.nonNativeValue,
+                    to: this.to,
+                    tronWeb: this.tronWeb,
+                    value: this.value,
+                });
+                // Update with the actual estimate
+                this.fee.gas = estimatedFee;
+            }
+            catch (error) {
+                logger.error('Failed to fetch Tron transaction fee:', error);
+                // Keep the default 0 we already set
+            }
         });
     }
+    /**
+     * Parse string input to bigint (for TRX)
+     */
     parse(input) {
         const numericValue = parseFloat(input);
         if (isNaN(numericValue))
             return BigInt(0);
         return BigInt(Math.floor(numericValue * SUN_PER_TRX));
     }
+    /**
+     * Parse string input to bigint (for TRC20 tokens)
+     */
     parseNonNativeToken(input, decimals) {
         const numericValue = parseFloat(input);
         if (isNaN(numericValue))
             return BigInt(0);
         return BigInt(Math.floor(numericValue * Math.pow(10, decimals)));
     }
+    /**
+     * Format bigint value to string (for TRX)
+     */
     format(value, options) {
         var _a;
         const trxValue = Number(value) / SUN_PER_TRX;
@@ -48,12 +80,18 @@ class TronUiTransaction {
             precision: (_a = options === null || options === void 0 ? void 0 : options.precision) !== null && _a !== void 0 ? _a : 6,
         });
     }
+    /**
+     * Format bigint value to string (for TRC20 tokens)
+     */
     formatNonNativeToken(value, decimals) {
         const tokenValue = Number(value) / Math.pow(10, decimals);
         return formatNumberText(String(tokenValue), {
             precision: decimals > 6 ? 6 : decimals,
         });
     }
+    /**
+     * Submit the transaction
+     */
     submit() {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.to) {
@@ -65,23 +103,23 @@ class TronUiTransaction {
             return this.onSubmit(this);
         });
     }
+    /**
+     * Get the balance for the from address
+     */
     getBalance() {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const { tronWeb } = this.provider;
-                if (!tronWeb)
-                    return BigInt(0);
                 if (this.nonNativeAddress) {
                     // Get TRC20 token balance
-                    const contract = yield tronWeb.contract().at(this.nonNativeAddress);
+                    const contract = yield this.tronWeb
+                        .contract()
+                        .at(this.nonNativeAddress);
                     const balance = yield contract.balanceOf(String(this.from)).call();
                     return BigInt(typeof balance === 'string' ? balance : balance.toString());
                 }
-                else {
-                    // Get native TRX balance
-                    const balance = yield tronWeb.trx.getBalance(String(this.from));
-                    return BigInt(String(balance));
-                }
+                // Get native TRX balance
+                const balance = yield this.tronWeb.trx.getBalance(String(this.from));
+                return BigInt(String(balance));
             }
             catch (error) {
                 logger.error('Error occurred while fetching TRON balance. Please try again or contact support.');
@@ -89,25 +127,28 @@ class TronUiTransaction {
             }
         });
     }
+    /**
+     * Validate Tron address format
+     */
     validateAddressFormat(address) {
         if (address === 'dyn_send_transaction.multiple_recipients') {
             return true;
         }
         try {
-            const { tronWeb } = this.provider;
-            if (!tronWeb)
-                return false;
             // TRON addresses start with 'T' and are 34 characters long
             if (!address.startsWith('T') || address.length !== 34) {
                 return false;
             }
             // Use TronWeb's built-in address validation
-            return tronWeb.isAddress(address);
+            return this.tronWeb.isAddress(address);
         }
         catch (_a) {
             return false;
         }
     }
+    /**
+     * Check if gas is sponsored
+     */
     isGasSponsored() {
         return false;
     }

package/src/utils/convertChainIdToDecimal/convertChainIdToDecimal.cjs

@@ -0,0 +1,16 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Utility functions for Tron network operations
+ */
+/**
+ * Convert hex chainId to decimal format to match backend expectations
+ * @param chainId - The chainId in hex (0x...) or decimal format
+ * @returns The chainId in decimal format
+ */
+const convertChainIdToDecimal = (chainId) => chainId.startsWith('0x') ? parseInt(chainId, 16).toString() : chainId;
+
+exports.convertChainIdToDecimal = convertChainIdToDecimal;

package/src/utils/convertChainIdToDecimal/convertChainIdToDecimal.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utility functions for Tron network operations
+ */
+/**
+ * Convert hex chainId to decimal format to match backend expectations
+ * @param chainId - The chainId in hex (0x...) or decimal format
+ * @returns The chainId in decimal format
+ */
+export declare const convertChainIdToDecimal: (chainId: string) => string;

package/src/utils/convertChainIdToDecimal/convertChainIdToDecimal.js

@@ -0,0 +1,12 @@
+'use client'
+/**
+ * Utility functions for Tron network operations
+ */
+/**
+ * Convert hex chainId to decimal format to match backend expectations
+ * @param chainId - The chainId in hex (0x...) or decimal format
+ * @returns The chainId in decimal format
+ */
+const convertChainIdToDecimal = (chainId) => chainId.startsWith('0x') ? parseInt(chainId, 16).toString() : chainId;
+
+export { convertChainIdToDecimal };

package/src/utils/convertChainIdToDecimal/index.d.ts

@@ -0,0 +1 @@
+export { convertChainIdToDecimal } from './convertChainIdToDecimal';