@blazium/ton-connect-mobile 1.2.0 → 1.2.3

package/dist/react/TonConnectUIProvider.js

@@ -51,17 +51,37 @@ const TonConnectUIContext = (0, react_1.createContext)(null);
  * Compatible with @tonconnect/ui-react API
  */
 function TonConnectUIProvider({ config, children, sdkInstance, }) {
-    const [sdk] = (0, react_1.useState)(() => sdkInstance || new index_1.TonConnectMobile(config));
+    // CRITICAL: Initialize SDK only once
+    const [sdk] = (0, react_1.useState)(() => {
+        if (sdkInstance) {
+            return sdkInstance;
+        }
+        try {
+            return new index_1.TonConnectMobile(config);
+        }
+        catch (error) {
+            console.error('[TonConnectUIProvider] Failed to initialize SDK:', error);
+            throw error;
+        }
+    });
     const [walletState, setWalletState] = (0, react_1.useState)(null);
     const [modalOpen, setModalOpen] = (0, react_1.useState)(false);
     const [isConnecting, setIsConnecting] = (0, react_1.useState)(false);
+    const [customWalletList, setCustomWalletList] = (0, react_1.useState)(null);
+    // Get chain ID based on network
+    const getChainId = (0, react_1.useCallback)((network) => {
+        // TON mainnet chain ID: -239
+        // TON testnet chain ID: -3
+        return network === 'testnet' ? -3 : -239;
+    }, []);
     // Update wallet state from SDK status
     const updateWalletState = (0, react_1.useCallback)((status) => {
         if (status.connected && status.wallet) {
+            const network = sdk.getNetwork();
             setWalletState({
                 account: {
                     address: status.wallet.address,
-                    chain: -239, // TON mainnet chain ID
+                    chain: getChainId(network),
                     publicKey: status.wallet.publicKey,
                 },
                 wallet: status.wallet,
@@ -75,7 +95,7 @@ function TonConnectUIProvider({ config, children, sdkInstance, }) {
                 connected: false,
             });
         }
-    }, []);
+    }, [sdk, getChainId]);
     // Subscribe to SDK status changes
     (0, react_1.useEffect)(() => {
         // Set initial state
@@ -135,19 +155,94 @@ function TonConnectUIProvider({ config, children, sdkInstance, }) {
     }, [sdk]);
     // Send transaction
     const sendTransaction = (0, react_1.useCallback)(async (transaction) => {
-        const response = await sdk.sendTransaction(transaction);
-        return {
-            boc: response.boc,
-            signature: response.signature,
-        };
+        try {
+            // Validate transaction before sending
+            if (!transaction || !transaction.messages || transaction.messages.length === 0) {
+                throw new Error('Invalid transaction: messages array is required and cannot be empty');
+            }
+            if (!transaction.validUntil || transaction.validUntil <= Date.now()) {
+                throw new Error('Invalid transaction: validUntil must be in the future');
+            }
+            const response = await sdk.sendTransaction(transaction);
+            return {
+                boc: response.boc,
+                signature: response.signature,
+            };
+        }
+        catch (error) {
+            console.error('[TonConnectUIProvider] Transaction error:', error);
+            throw error;
+        }
     }, [sdk]);
     // Sign data
     const signData = (0, react_1.useCallback)(async (request) => {
-        const response = await sdk.signData(request.data, request.version);
-        return {
-            signature: response.signature,
-            timestamp: response.timestamp,
-        };
+        try {
+            // Validate request
+            if (!request || (!request.data && request.data !== '')) {
+                throw new Error('Invalid sign data request: data is required');
+            }
+            const response = await sdk.signData(request.data, request.version);
+            return {
+                signature: response.signature,
+                timestamp: response.timestamp,
+            };
+        }
+        catch (error) {
+            console.error('[TonConnectUIProvider] Sign data error:', error);
+            throw error;
+        }
+    }, [sdk]);
+    // Restore connection from stored session
+    const restoreConnection = (0, react_1.useCallback)(async () => {
+        try {
+            // SDK automatically loads session on initialization
+            // This method triggers a re-check of the stored session
+            const status = sdk.getStatus();
+            if (status.connected && status.wallet) {
+                updateWalletState(status);
+            }
+        }
+        catch (error) {
+            console.error('[TonConnectUIProvider] Restore connection error:', error);
+            throw error;
+        }
+    }, [sdk, updateWalletState]);
+    // Set wallet list (customize available wallets)
+    const setWalletList = (0, react_1.useCallback)((wallets) => {
+        if (!wallets || !Array.isArray(wallets)) {
+            throw new Error('Wallet list must be an array');
+        }
+        setCustomWalletList(wallets);
+    }, []);
+    // Get network
+    const getNetwork = (0, react_1.useCallback)(() => {
+        return sdk.getNetwork();
+    }, [sdk]);
+    // Set network
+    const setNetwork = (0, react_1.useCallback)((network) => {
+        sdk.setNetwork(network);
+        // Update wallet state to reflect new chain ID
+        const status = sdk.getStatus();
+        updateWalletState(status);
+    }, [sdk, updateWalletState]);
+    // Get balance
+    const getBalance = (0, react_1.useCallback)(async (address) => {
+        return await sdk.getBalance(address);
+    }, [sdk]);
+    // Get transaction status
+    const getTransactionStatus = (0, react_1.useCallback)(async (boc, maxAttempts = 10, intervalMs = 2000) => {
+        return await sdk.getTransactionStatus(boc, maxAttempts, intervalMs);
+    }, [sdk]);
+    // Get transaction status by hash
+    const getTransactionStatusByHash = (0, react_1.useCallback)(async (txHash, address) => {
+        return await sdk.getTransactionStatusByHash(txHash, address);
+    }, [sdk]);
+    // Event listeners
+    const on = (0, react_1.useCallback)((event, listener) => {
+        return sdk.on(event, listener);
+    }, [sdk]);
+    const off = (0, react_1.useCallback)((event, listener) => {
+        sdk.off(event, listener);
     }, [sdk]);
     // Create TonConnectUI instance
     const tonConnectUI = {
@@ -157,6 +252,15 @@ function TonConnectUIProvider({ config, children, sdkInstance, }) {
         disconnect,
         sendTransaction,
         signData,
+        restoreConnection,
+        setWalletList,
+        getNetwork,
+        setNetwork,
+        getBalance,
+        getTransactionStatus,
+        getTransactionStatusByHash,
+        on,
+        off,
         wallet: walletState,
         modalState: {
             open: modalOpen,
@@ -169,7 +273,7 @@ function TonConnectUIProvider({ config, children, sdkInstance, }) {
     };
     return (react_1.default.createElement(TonConnectUIContext.Provider, { value: contextValue },
         children,
-        react_1.default.createElement(WalletSelectionModal_1.WalletSelectionModal, { visible: modalOpen && !walletState?.connected, onClose: closeModal })));
+        react_1.default.createElement(WalletSelectionModal_1.WalletSelectionModal, { visible: modalOpen && !walletState?.connected, onClose: closeModal, wallets: customWalletList || undefined })));
 }
 /**
  * Hook to access TonConnectUI instance

package/dist/react/WalletSelectionModal.d.ts

@@ -1,6 +1,7 @@
 /**
  * WalletSelectionModal component
  * Provides a beautiful wallet selection UI compatible with @tonconnect/ui-react
+ * Matches the exact UI/UX of @tonconnect/ui-react wallet selection modal
  */
 import type { WalletDefinition } from '../index';
 export interface WalletSelectionModalProps {

package/dist/react/WalletSelectionModal.js

@@ -2,6 +2,7 @@
 /**
  * WalletSelectionModal component
  * Provides a beautiful wallet selection UI compatible with @tonconnect/ui-react
+ * Matches the exact UI/UX of @tonconnect/ui-react wallet selection modal
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -20,25 +21,53 @@ function WalletSelectionModal({ visible, onClose, wallets: customWallets, style,
     const sdk = (0, index_1.useTonConnectSDK)();
     const [wallets, setWallets] = react_1.default.useState([]);
     const [connectingWallet, setConnectingWallet] = react_1.default.useState(null);
-    // Load wallets
+    const [walletAvailability, setWalletAvailability] = react_1.default.useState({});
+    // Load wallets and check availability
     react_1.default.useEffect(() => {
-        if (customWallets) {
-            setWallets(customWallets);
+        const loadWallets = async () => {
+            if (customWallets) {
+                setWallets(customWallets);
+            }
+            else {
+                const supportedWallets = sdk.getSupportedWallets();
+                // Show all wallets (like @tonconnect/ui-react does)
+                // Availability will be checked and displayed
+                setWallets(supportedWallets);
+            }
+            // Check availability for all wallets
+            const availability = {};
+            const walletsToCheck = customWallets || sdk.getSupportedWallets();
+            for (const wallet of walletsToCheck) {
+                try {
+                    const isAvailable = await sdk.isWalletAvailable(wallet.name);
+                    availability[wallet.name] = isAvailable;
+                }
+                catch (error) {
+                    availability[wallet.name] = false;
+                }
+            }
+            setWalletAvailability(availability);
+        };
+        if (visible) {
+            loadWallets();
         }
-        else {
-            const supportedWallets = sdk.getSupportedWallets();
-            // Filter wallets for current platform
-            const platform = react_native_1.Platform.OS === 'ios' ? 'ios' : react_native_1.Platform.OS === 'android' ? 'android' : 'web';
-            const platformWallets = supportedWallets.filter((w) => w.platforms.includes(platform));
-            setWallets(platformWallets);
-        }
-    }, [sdk, customWallets]);
+    }, [sdk, customWallets, visible]);
     // Handle wallet selection
     const handleSelectWallet = async (wallet) => {
+        // Prevent multiple simultaneous connection attempts
+        if (connectingWallet) {
+            return;
+        }
         try {
             setConnectingWallet(wallet.name);
             // Set preferred wallet
-            sdk.setPreferredWallet(wallet.name);
+            try {
+                sdk.setPreferredWallet(wallet.name);
+            }
+            catch (error) {
+                console.error('[WalletSelectionModal] Failed to set preferred wallet:', error);
+                // Continue anyway - SDK will use default wallet
+            }
             // Close modal
             onClose();
             // Small delay to ensure modal closes
@@ -47,38 +76,44 @@ function WalletSelectionModal({ visible, onClose, wallets: customWallets, style,
             await tonConnectUI.connectWallet();
         }
         catch (error) {
-            console.error('Wallet connection error:', error);
+            console.error('[WalletSelectionModal] Wallet connection error:', error);
             setConnectingWallet(null);
-            // Re-open modal on error
-            onClose();
-            setTimeout(() => {
-                // Modal will be re-opened by parent if needed
-            }, 500);
+            // Error is handled by SDK/UI, just reset connecting state
         }
     };
     return (react_1.default.createElement(react_native_1.Modal, { visible: visible, animationType: "slide", transparent: true, onRequestClose: onClose },
         react_1.default.createElement(react_native_1.View, { style: [styles.overlay, style] },
             react_1.default.createElement(react_native_1.View, { style: styles.modalContainer },
                 react_1.default.createElement(react_native_1.View, { style: styles.header },
-                    react_1.default.createElement(react_native_1.Text, { style: styles.title }, "Connect your TON wallet"),
-                    react_1.default.createElement(react_native_1.Text, { style: styles.subtitle }, "Choose a wallet to connect to this app"),
+                    react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.backButton, onPress: onClose },
+                        react_1.default.createElement(react_native_1.Text, { style: styles.backButtonText }, "\u2190")),
+                    react_1.default.createElement(react_native_1.Text, { style: styles.title }, "Wallets"),
                     react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.closeButton, onPress: onClose },
                         react_1.default.createElement(react_native_1.Text, { style: styles.closeButtonText }, "\u2715"))),
-                react_1.default.createElement(react_native_1.ScrollView, { style: styles.walletList, showsVerticalScrollIndicator: false }, wallets.length === 0 ? (react_1.default.createElement(react_native_1.View, { style: styles.emptyState },
+                react_1.default.createElement(react_native_1.ScrollView, { style: styles.walletList, showsVerticalScrollIndicator: false, contentContainerStyle: styles.walletGrid }, wallets.length === 0 ? (react_1.default.createElement(react_native_1.View, { style: styles.emptyState },
                     react_1.default.createElement(react_native_1.Text, { style: styles.emptyStateText }, "No wallets available"),
                     react_1.default.createElement(react_native_1.Text, { style: styles.emptyStateSubtext }, "Please install a TON wallet app to continue"))) : (wallets.map((wallet) => {
                     const isConnecting = connectingWallet === wallet.name;
-                    return (react_1.default.createElement(react_native_1.TouchableOpacity, { key: wallet.name, style: [styles.walletItem, isConnecting && styles.walletItemConnecting], onPress: () => handleSelectWallet(wallet), disabled: isConnecting },
-                        react_1.default.createElement(react_native_1.View, { style: styles.walletIconContainer }, wallet.iconUrl ? (react_1.default.createElement(react_native_1.Image, { source: { uri: wallet.iconUrl }, style: styles.walletIcon })) : (react_1.default.createElement(react_native_1.View, { style: styles.walletIconPlaceholder },
+                    const isAvailable = walletAvailability[wallet.name] !== false;
+                    return (react_1.default.createElement(react_native_1.TouchableOpacity, { key: wallet.name, style: [
+                            styles.walletCard,
+                            !isAvailable && styles.walletCardUnavailable,
+                            isConnecting && styles.walletCardConnecting,
+                        ], onPress: () => isAvailable && !isConnecting && handleSelectWallet(wallet), disabled: !isAvailable || isConnecting },
+                        react_1.default.createElement(react_native_1.View, { style: styles.walletIconContainer }, wallet.iconUrl && react_native_1.Platform.OS !== 'web' ? (react_1.default.createElement(react_native_1.Image, { source: { uri: wallet.iconUrl }, style: styles.walletIcon, onError: () => {
+                                // Fallback to placeholder on error
+                            }, resizeMode: "cover" })) : (react_1.default.createElement(react_native_1.View, { style: styles.walletIconPlaceholder },
                             react_1.default.createElement(react_native_1.Text, { style: styles.walletIconText }, wallet.name.charAt(0).toUpperCase())))),
-                        react_1.default.createElement(react_native_1.View, { style: styles.walletInfo },
-                            react_1.default.createElement(react_native_1.Text, { style: styles.walletName }, wallet.name),
-                            react_1.default.createElement(react_native_1.Text, { style: styles.walletAppName }, wallet.appName)),
-                        isConnecting && (react_1.default.createElement(react_native_1.View, { style: styles.connectingIndicator },
-                            react_1.default.createElement(react_native_1.Text, { style: styles.connectingText }, "Connecting...")))));
+                        react_1.default.createElement(react_native_1.Text, { style: styles.walletName, numberOfLines: 1 }, wallet.name),
+                        isConnecting && (react_1.default.createElement(react_native_1.ActivityIndicator, { size: "small", color: "#0088cc", style: styles.connectingSpinner }))));
                 }))),
                 react_1.default.createElement(react_native_1.View, { style: styles.footer },
-                    react_1.default.createElement(react_native_1.Text, { style: styles.footerText }, "By connecting, you agree to the app's Terms of Service and Privacy Policy"))))));
+                    react_1.default.createElement(react_native_1.View, { style: styles.footerContent },
+                        react_1.default.createElement(react_native_1.View, { style: styles.tonConnectLogo },
+                            react_1.default.createElement(react_native_1.Text, { style: styles.tonConnectLogoText }, "TON")),
+                        react_1.default.createElement(react_native_1.Text, { style: styles.footerText }, "TON Connect")),
+                    react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.helpButton },
+                        react_1.default.createElement(react_native_1.Text, { style: styles.helpButtonText }, "?")))))));
 }
 const styles = react_native_1.StyleSheet.create({
     overlay: {
@@ -90,30 +125,36 @@ const styles = react_native_1.StyleSheet.create({
         backgroundColor: '#1a1a1a',
         borderTopLeftRadius: 24,
         borderTopRightRadius: 24,
-        maxHeight: '85%',
+        maxHeight: '90%',
         paddingBottom: react_native_1.Platform.OS === 'ios' ? 34 : 20,
     },
     header: {
-        padding: 24,
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        padding: 16,
         borderBottomWidth: 1,
         borderBottomColor: '#2a2a2a',
-        position: 'relative',
+    },
+    backButton: {
+        width: 32,
+        height: 32,
+        justifyContent: 'center',
+        alignItems: 'center',
+    },
+    backButtonText: {
+        color: '#ffffff',
+        fontSize: 20,
+        fontWeight: '600',
     },
     title: {
-        fontSize: 28,
+        fontSize: 20,
         fontWeight: 'bold',
         color: '#ffffff',
-        marginBottom: 8,
-    },
-    subtitle: {
-        fontSize: 15,
-        color: '#999999',
-        lineHeight: 20,
+        flex: 1,
+        textAlign: 'center',
     },
     closeButton: {
-        position: 'absolute',
-        top: 24,
-        right: 24,
         width: 32,
         height: 32,
         borderRadius: 16,
@@ -127,66 +168,65 @@ const styles = react_native_1.StyleSheet.create({
         fontWeight: '600',
     },
     walletList: {
-        padding: 16,
-        maxHeight: 400,
+        flex: 1,
     },
-    walletItem: {
+    walletGrid: {
         flexDirection: 'row',
-        alignItems: 'center',
+        flexWrap: 'wrap',
         padding: 16,
-        backgroundColor: '#2a2a2a',
-        borderRadius: 16,
-        marginBottom: 12,
-        minHeight: 72,
+        justifyContent: 'flex-start',
+    },
+    walletCard: {
+        width: '25%',
+        aspectRatio: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 8,
+        marginBottom: 16,
+    },
+    walletCardUnavailable: {
+        opacity: 0.5,
     },
-    walletItemConnecting: {
+    walletCardConnecting: {
         opacity: 0.7,
     },
     walletIconContainer: {
-        marginRight: 16,
+        width: 64,
+        height: 64,
+        marginBottom: 8,
     },
     walletIcon: {
-        width: 48,
-        height: 48,
-        borderRadius: 12,
+        width: 64,
+        height: 64,
+        borderRadius: 16,
     },
     walletIconPlaceholder: {
-        width: 48,
-        height: 48,
-        borderRadius: 12,
-        backgroundColor: '#3a3a3a',
+        width: 64,
+        height: 64,
+        borderRadius: 16,
+        backgroundColor: '#2a2a2a',
         justifyContent: 'center',
         alignItems: 'center',
     },
     walletIconText: {
         color: '#ffffff',
-        fontSize: 20,
+        fontSize: 24,
         fontWeight: 'bold',
     },
-    walletInfo: {
-        flex: 1,
-    },
     walletName: {
-        fontSize: 17,
-        fontWeight: '600',
+        fontSize: 12,
+        fontWeight: '500',
         color: '#ffffff',
-        marginBottom: 4,
-    },
-    walletAppName: {
-        fontSize: 14,
-        color: '#999999',
+        textAlign: 'center',
+        maxWidth: '100%',
     },
-    connectingIndicator: {
-        marginLeft: 12,
-    },
-    connectingText: {
-        fontSize: 14,
-        color: '#0088cc',
-        fontWeight: '500',
+    connectingSpinner: {
+        marginTop: 4,
     },
     emptyState: {
         padding: 40,
         alignItems: 'center',
+        width: '100%',
     },
     emptyStateText: {
         fontSize: 18,
@@ -200,14 +240,47 @@ const styles = react_native_1.StyleSheet.create({
         textAlign: 'center',
     },
     footer: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
         padding: 16,
         borderTopWidth: 1,
         borderTopColor: '#2a2a2a',
     },
+    footerContent: {
+        flexDirection: 'row',
+        alignItems: 'center',
+    },
+    tonConnectLogo: {
+        width: 20,
+        height: 20,
+        borderRadius: 4,
+        backgroundColor: '#0088cc',
+        justifyContent: 'center',
+        alignItems: 'center',
+        marginRight: 8,
+    },
+    tonConnectLogoText: {
+        color: '#ffffff',
+        fontSize: 10,
+        fontWeight: 'bold',
+    },
     footerText: {
         fontSize: 12,
-        color: '#666666',
-        textAlign: 'center',
-        lineHeight: 16,
+        color: '#ffffff',
+        fontWeight: '500',
+    },
+    helpButton: {
+        width: 24,
+        height: 24,
+        borderRadius: 12,
+        backgroundColor: '#2a2a2a',
+        justifyContent: 'center',
+        alignItems: 'center',
+    },
+    helpButtonText: {
+        color: '#999999',
+        fontSize: 14,
+        fontWeight: '600',
     },
 });

package/dist/react/index.d.ts

@@ -4,6 +4,7 @@
  */
 export { TonConnectUIProvider, useTonConnectUI, useTonWallet, useTonConnectModal, useTonConnectSDK, } from './TonConnectUIProvider';
 export type { TonConnectUIProviderProps, TonConnectUI, WalletState, Account, TransactionResponse, SignDataRequest, SignDataResponse, } from './TonConnectUIProvider';
+export type { Network, BalanceResponse, TransactionStatusResponse, TransactionStatus } from '../types';
 export { TonConnectButton } from './TonConnectButton';
 export type { TonConnectButtonProps } from './TonConnectButton';
 export { WalletSelectionModal } from './WalletSelectionModal';

package/dist/types/index.d.ts

@@ -175,6 +175,10 @@ export interface PlatformAdapter {
     /** Generate random bytes */
     randomBytes(length: number): Promise<Uint8Array>;
 }
+/**
+ * Network type
+ */
+export type Network = 'mainnet' | 'testnet';
 /**
  * SDK configuration
  */
@@ -199,8 +203,50 @@ export interface TonConnectMobileConfig {
      * Available: 'Tonkeeper', 'MyTonWallet', 'Wallet in Telegram', 'Tonhub'
      */
     preferredWallet?: string;
+    /** Network (mainnet/testnet) - default: 'mainnet' */
+    network?: Network;
+    /** TON API endpoint for balance checking (optional)
+     * Default: 'https://toncenter.com/api/v2' for mainnet, 'https://testnet.toncenter.com/api/v2' for testnet
+     */
+    tonApiEndpoint?: string;
 }
 /**
  * Event listener callback type
  */
 export type StatusChangeCallback = (status: ConnectionStatus) => void;
+/**
+ * Event types for TonConnectMobile
+ */
+export type TonConnectEventType = 'connect' | 'disconnect' | 'transaction' | 'error' | 'statusChange';
+/**
+ * Event listener callback
+ */
+export type TonConnectEventListener<T = any> = (data: T) => void;
+/**
+ * Transaction status
+ */
+export type TransactionStatus = 'pending' | 'confirmed' | 'failed' | 'unknown';
+/**
+ * Transaction status response
+ */
+export interface TransactionStatusResponse {
+    /** Transaction status */
+    status: TransactionStatus;
+    /** Transaction hash (if available) */
+    hash?: string;
+    /** Block number (if confirmed) */
+    blockNumber?: number;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Balance response
+ */
+export interface BalanceResponse {
+    /** Balance in nanotons */
+    balance: string;
+    /** Balance in TON (formatted) */
+    balanceTon: string;
+    /** Network */
+    network: Network;
+}

package/dist/utils/transactionBuilder.js

@@ -42,12 +42,29 @@ function nanoToTon(nanotons) {
  * @returns Transaction request
  */
 function buildTransferTransaction(to, amount, validUntil) {
+    // Validate address
+    if (!to || typeof to !== 'string') {
+        throw new Error('Recipient address is required');
+    }
+    if (!isValidTonAddress(to)) {
+        throw new Error(`Invalid TON address format: ${to}`);
+    }
+    // Validate amount
+    const nanoAmount = tonToNano(amount);
+    if (BigInt(nanoAmount) <= 0n) {
+        throw new Error('Transaction amount must be greater than 0');
+    }
+    // Validate validUntil
+    const expiration = validUntil || Date.now() + 5 * 60 * 1000; // 5 minutes default
+    if (expiration <= Date.now()) {
+        throw new Error('Transaction expiration must be in the future');
+    }
     return {
-        validUntil: validUntil || Date.now() + 5 * 60 * 1000, // 5 minutes default
+        validUntil: expiration,
         messages: [
             {
                 address: to,
-                amount: tonToNano(amount),
+                amount: nanoAmount,
             },
         ],
     };
@@ -59,12 +76,38 @@ function buildTransferTransaction(to, amount, validUntil) {
  * @returns Transaction request
  */
 function buildMultiTransferTransaction(transfers, validUntil) {
-    return {
-        validUntil: validUntil || Date.now() + 5 * 60 * 1000,
-        messages: transfers.map((transfer) => ({
+    // Validate transfers array
+    if (!transfers || !Array.isArray(transfers) || transfers.length === 0) {
+        throw new Error('Transfers array is required and cannot be empty');
+    }
+    if (transfers.length > 255) {
+        throw new Error('Maximum 255 transfers allowed per transaction');
+    }
+    // Validate each transfer
+    const messages = transfers.map((transfer, index) => {
+        if (!transfer.to || typeof transfer.to !== 'string') {
+            throw new Error(`Transfer ${index + 1}: Recipient address is required`);
+        }
+        if (!isValidTonAddress(transfer.to)) {
+            throw new Error(`Transfer ${index + 1}: Invalid TON address format: ${transfer.to}`);
+        }
+        const nanoAmount = tonToNano(transfer.amount);
+        if (BigInt(nanoAmount) <= 0n) {
+            throw new Error(`Transfer ${index + 1}: Amount must be greater than 0`);
+        }
+        return {
             address: transfer.to,
-            amount: tonToNano(transfer.amount),
-        })),
+            amount: nanoAmount,
+        };
+    });
+    // Validate validUntil
+    const expiration = validUntil || Date.now() + 5 * 60 * 1000;
+    if (expiration <= Date.now()) {
+        throw new Error('Transaction expiration must be in the future');
+    }
+    return {
+        validUntil: expiration,
+        messages,
     };
 }
 /**