@blazium/ton-connect-mobile 1.0.0 → 1.0.2

package/README.md

@@ -10,6 +10,7 @@ Production-ready TON Connect Mobile SDK for React Native and Expo. This SDK impl
 - ✅ **Transaction Signing** - Send and sign transactions
 - ✅ **Signature Verification** - Verifies wallet signatures
 - ✅ **Cross-Platform** - Works with Expo Managed, Expo Bare, and React Native CLI
+- ⚠️ **Web Limitation** - Deep links (`tonconnect://`) only work on mobile devices (Android/iOS), not in web browsers
 - ✅ **TypeScript** - Fully typed with TypeScript
 - ✅ **Production Ready** - No placeholders, no mocks, ready for production use
 
@@ -125,6 +126,21 @@ try {
 }
 ```
 
+### Platform Support
+
+**⚠️ Important**: TON Connect deep links (`tonconnect://`) only work on **mobile devices** (Android/iOS). They do not work in web browsers.
+
+- ✅ **Android**: Full support via Expo or React Native CLI
+- ✅ **iOS**: Full support via Expo or React Native CLI  
+- ⚠️ **Web**: Deep links are not supported. The SDK will throw a clear error message if you try to use it in a web browser.
+
+**Why?** The `tonconnect://` protocol is a custom URI scheme that requires a mobile app handler. Web browsers cannot handle these custom protocols.
+
+**Testing**: To test wallet connections, use:
+- Android device or emulator
+- iOS device or simulator
+- Not web browsers
+
 ### Disconnect
 
 ```typescript

package/dist/adapters/expo.js

@@ -44,15 +44,25 @@ class ExpoAdapter {
             throw new Error('expo-linking is not available');
         }
         try {
+            console.log('[ExpoAdapter] Checking if URL can be opened:', url);
             const canOpen = await Linking.canOpenURL(url);
+            console.log('[ExpoAdapter] canOpenURL result:', canOpen);
             if (!canOpen) {
-                return false;
+                console.error('[ExpoAdapter] Cannot open URL - no app found that handles tonconnect:// protocol');
+                throw new Error(`Cannot open URL: ${url}. Make sure a wallet app is installed that supports tonconnect:// protocol.`);
             }
+            console.log('[ExpoAdapter] Opening URL...');
             await Linking.openURL(url);
+            console.log('[ExpoAdapter] URL opened successfully');
             return true;
         }
         catch (error) {
-            return false;
+            console.error('[ExpoAdapter] Error in openURL:', error);
+            // Re-throw with more context
+            if (error.message && error.message.includes('Cannot open URL')) {
+                throw error;
+            }
+            throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
         }
     }
     async getInitialURL() {

package/dist/adapters/react-native.js

@@ -42,15 +42,25 @@ class ReactNativeAdapter {
             throw new Error('react-native Linking is not available');
         }
         try {
+            console.log('[ReactNativeAdapter] Checking if URL can be opened:', url);
             const canOpen = await Linking.canOpenURL(url);
+            console.log('[ReactNativeAdapter] canOpenURL result:', canOpen);
             if (!canOpen) {
-                return false;
+                console.error('[ReactNativeAdapter] Cannot open URL - no app found that handles tonconnect:// protocol');
+                throw new Error(`Cannot open URL: ${url}. Make sure a wallet app is installed that supports tonconnect:// protocol.`);
             }
+            console.log('[ReactNativeAdapter] Opening URL...');
             await Linking.openURL(url);
+            console.log('[ReactNativeAdapter] URL opened successfully');
             return true;
         }
         catch (error) {
-            return false;
+            console.error('[ReactNativeAdapter] Error in openURL:', error);
+            // Re-throw with more context
+            if (error.message && error.message.includes('Cannot open URL')) {
+                throw error;
+            }
+            throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
         }
     }
     async getInitialURL() {

package/dist/adapters/web.js

@@ -45,18 +45,26 @@ class WebAdapter {
     async openURL(url) {
         try {
             if (typeof window !== 'undefined') {
-                // For web, we can use window.open or window.location
-                // For deep links to mobile wallets, we'll use window.location
+                // For web, tonconnect:// deep links don't work
+                // They only work on mobile devices (Android/iOS)
                 if (url.startsWith('tonconnect://')) {
-                    // Try to open in new window/tab, fallback to current window
-                    const opened = window.open(url, '_blank');
-                    if (!opened) {
-                        // Popup blocked, try current window
-                        window.location.href = url;
+                    // Show user-friendly error message
+                    const errorMessage = 'TON Connect deep links only work on mobile devices (Android/iOS).\n\n' +
+                        'Please test this on a mobile device or use the mobile app.\n\n' +
+                        'Deep link: ' + url.substring(0, 100) + '...';
+                    // Try to show alert (if available)
+                    if (typeof window.alert !== 'undefined') {
+                        window.alert(errorMessage);
                     }
-                    return true;
+                    else {
+                        console.error('TON Connect Web Error:', errorMessage);
+                    }
+                    // Throw error so SDK can handle it properly
+                    throw new Error('TON Connect deep links are not supported in web browsers. ' +
+                        'Please use this SDK on a mobile device (Android/iOS) or test with a mobile app.');
                 }
                 else {
+                    // Regular HTTP/HTTPS URLs work fine
                     window.location.href = url;
                     return true;
                 }
@@ -64,7 +72,8 @@ class WebAdapter {
             return false;
         }
         catch (error) {
-            return false;
+            // Re-throw the error so SDK can handle it
+            throw error;
         }
     }
     async getInitialURL() {

package/dist/index.js

@@ -108,6 +108,7 @@ class TonConnectMobile {
         // eslint-disable-next-line no-undef
         if (typeof globalThis !== 'undefined' && globalThis.window && globalThis.document) {
             // Web platform
+            console.log('[TON Connect] Using WebAdapter');
             return new web_1.WebAdapter();
         }
         // Try to detect Expo environment
@@ -116,15 +117,18 @@ class TonConnectMobile {
             if (typeof require !== 'undefined') {
                 const expoLinking = require('expo-linking');
                 if (expoLinking) {
+                    console.log('[TON Connect] Using ExpoAdapter');
                     return new expo_1.ExpoAdapter();
                 }
             }
         }
-        catch {
+        catch (error) {
+            console.log('[TON Connect] ExpoAdapter not available:', error);
             // expo-linking not available, continue to React Native adapter
         }
         // Fall back to React Native adapter
         // This will work for both React Native CLI and Expo (since Expo also has react-native)
+        console.log('[TON Connect] Using ReactNativeAdapter');
         return new react_native_1.ReactNativeAdapter();
     }
     /**
@@ -260,6 +264,10 @@ class TonConnectMobile {
         }
         // Build connection request URL
         const url = (0, protocol_1.buildConnectionRequest)(this.config.manifestUrl, this.config.scheme);
+        // DEBUG: Log the URL being opened
+        console.log('[TON Connect] Opening URL:', url);
+        console.log('[TON Connect] Manifest URL:', this.config.manifestUrl);
+        console.log('[TON Connect] Return scheme:', this.config.scheme);
         // Create promise for connection
         return new Promise((resolve, reject) => {
             let timeout = null;
@@ -283,12 +291,27 @@ class TonConnectMobile {
             // Set timeout
             timeout = setTimeout(() => {
                 if (this.connectionPromise) {
+                    console.log('[TON Connect] Connection timeout after', this.config.connectionTimeout, 'ms');
                     this.connectionPromise.reject(new ConnectionTimeoutError());
                 }
             }, this.config.connectionTimeout);
             this.connectionPromise.timeout = timeout;
             // Open wallet app
-            this.adapter.openURL(url).catch((error) => {
+            console.log('[TON Connect] Attempting to open wallet app...');
+            this.adapter.openURL(url).then((success) => {
+                console.log('[TON Connect] openURL result:', success);
+                // URL opened successfully, wait for callback
+                // If success is false, it should have thrown an error
+                if (!success && this.connectionPromise) {
+                    console.log('[TON Connect] openURL returned false, rejecting promise');
+                    this.connectionPromise.reject(new TonConnectError('Failed to open wallet app. Please make sure a TON wallet is installed.'));
+                }
+                else {
+                    console.log('[TON Connect] URL opened successfully, waiting for wallet callback...');
+                }
+            }).catch((error) => {
+                // Error opening URL - reject the promise
+                console.error('[TON Connect] Error opening URL:', error);
                 if (this.connectionPromise) {
                     this.connectionPromise.reject(new TonConnectError(`Failed to open wallet: ${error?.message || String(error)}`));
                 }
@@ -342,7 +365,14 @@ class TonConnectMobile {
             }, this.config.transactionTimeout);
             this.transactionPromise.timeout = timeout;
             // Open wallet app
-            this.adapter.openURL(url).catch((error) => {
+            this.adapter.openURL(url).then((success) => {
+                // URL opened successfully, wait for callback
+                // If success is false, it should have thrown an error
+                if (!success && this.transactionPromise) {
+                    this.transactionPromise.reject(new TonConnectError('Failed to open wallet app. Please make sure a TON wallet is installed.'));
+                }
+            }).catch((error) => {
+                // Error opening URL - reject the promise
                 if (this.transactionPromise) {
                     this.transactionPromise.reject(new TonConnectError(`Failed to open wallet: ${error?.message || String(error)}`));
                 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@blazium/ton-connect-mobile",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Production-ready TON Connect Mobile SDK for React Native and Expo. Implements the real TonConnect protocol for mobile applications using deep links and callbacks.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/blaziumdev/ton-connect-mobile.git"
+    "url": "git+https://github.com/blaziumdev/ton-connect-mobile.git"
   },
   "scripts": {
     "build": "tsc",

package/src/adapters/expo.ts

@@ -53,14 +53,24 @@ export class ExpoAdapter implements PlatformAdapter {
       throw new Error('expo-linking is not available');
     }
     try {
+      console.log('[ExpoAdapter] Checking if URL can be opened:', url);
       const canOpen = await Linking.canOpenURL(url);
+      console.log('[ExpoAdapter] canOpenURL result:', canOpen);
       if (!canOpen) {
-        return false;
+        console.error('[ExpoAdapter] Cannot open URL - no app found that handles tonconnect:// protocol');
+        throw new Error(`Cannot open URL: ${url}. Make sure a wallet app is installed that supports tonconnect:// protocol.`);
       }
+      console.log('[ExpoAdapter] Opening URL...');
       await Linking.openURL(url);
+      console.log('[ExpoAdapter] URL opened successfully');
       return true;
-    } catch (error) {
-      return false;
+    } catch (error: any) {
+      console.error('[ExpoAdapter] Error in openURL:', error);
+      // Re-throw with more context
+      if (error.message && error.message.includes('Cannot open URL')) {
+        throw error;
+      }
+      throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
     }
   }
 

package/src/adapters/react-native.ts

@@ -51,14 +51,24 @@ export class ReactNativeAdapter implements PlatformAdapter {
       throw new Error('react-native Linking is not available');
     }
     try {
+      console.log('[ReactNativeAdapter] Checking if URL can be opened:', url);
       const canOpen = await Linking.canOpenURL(url);
+      console.log('[ReactNativeAdapter] canOpenURL result:', canOpen);
       if (!canOpen) {
-        return false;
+        console.error('[ReactNativeAdapter] Cannot open URL - no app found that handles tonconnect:// protocol');
+        throw new Error(`Cannot open URL: ${url}. Make sure a wallet app is installed that supports tonconnect:// protocol.`);
       }
+      console.log('[ReactNativeAdapter] Opening URL...');
       await Linking.openURL(url);
+      console.log('[ReactNativeAdapter] URL opened successfully');
       return true;
-    } catch (error) {
-      return false;
+    } catch (error: any) {
+      console.error('[ReactNativeAdapter] Error in openURL:', error);
+      // Re-throw with more context
+      if (error.message && error.message.includes('Cannot open URL')) {
+        throw error;
+      }
+      throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
     }
   }
 

package/src/adapters/web.ts

@@ -11,6 +11,7 @@ declare const window: {
   open(url: string, target?: string): any;
   addEventListener(type: string, listener: () => void): void;
   removeEventListener(type: string, listener: () => void): void;
+  alert(message: string): void;
   localStorage: {
     setItem(key: string, value: string): void;
     getItem(key: string): string | null;
@@ -68,24 +69,37 @@ export class WebAdapter implements PlatformAdapter {
   async openURL(url: string): Promise<boolean> {
     try {
       if (typeof window !== 'undefined') {
-        // For web, we can use window.open or window.location
-        // For deep links to mobile wallets, we'll use window.location
+        // For web, tonconnect:// deep links don't work
+        // They only work on mobile devices (Android/iOS)
         if (url.startsWith('tonconnect://')) {
-          // Try to open in new window/tab, fallback to current window
-          const opened = window.open(url, '_blank');
-          if (!opened) {
-            // Popup blocked, try current window
-            window.location.href = url;
+          // Show user-friendly error message
+          const errorMessage = 
+            'TON Connect deep links only work on mobile devices (Android/iOS).\n\n' +
+            'Please test this on a mobile device or use the mobile app.\n\n' +
+            'Deep link: ' + url.substring(0, 100) + '...';
+          
+          // Try to show alert (if available)
+          if (typeof window.alert !== 'undefined') {
+            window.alert(errorMessage);
+          } else {
+            console.error('TON Connect Web Error:', errorMessage);
           }
-          return true;
+          
+          // Throw error so SDK can handle it properly
+          throw new Error(
+            'TON Connect deep links are not supported in web browsers. ' +
+            'Please use this SDK on a mobile device (Android/iOS) or test with a mobile app.'
+          );
         } else {
+          // Regular HTTP/HTTPS URLs work fine
           window.location.href = url;
           return true;
         }
       }
       return false;
     } catch (error) {
-      return false;
+      // Re-throw the error so SDK can handle it
+      throw error;
     }
   }
 

package/src/index.ts

@@ -132,6 +132,7 @@ export class TonConnectMobile {
     // eslint-disable-next-line no-undef
     if (typeof globalThis !== 'undefined' && (globalThis as any).window && (globalThis as any).document) {
       // Web platform
+      console.log('[TON Connect] Using WebAdapter');
       return new WebAdapter();
     }
 
@@ -141,15 +142,18 @@ export class TonConnectMobile {
       if (typeof require !== 'undefined') {
         const expoLinking = require('expo-linking');
         if (expoLinking) {
+          console.log('[TON Connect] Using ExpoAdapter');
           return new ExpoAdapter();
         }
       }
-    } catch {
+    } catch (error) {
+      console.log('[TON Connect] ExpoAdapter not available:', error);
       // expo-linking not available, continue to React Native adapter
     }
 
     // Fall back to React Native adapter
     // This will work for both React Native CLI and Expo (since Expo also has react-native)
+    console.log('[TON Connect] Using ReactNativeAdapter');
     return new ReactNativeAdapter();
   }
 
@@ -300,6 +304,11 @@ export class TonConnectMobile {
 
     // Build connection request URL
     const url = buildConnectionRequest(this.config.manifestUrl, this.config.scheme);
+    
+    // DEBUG: Log the URL being opened
+    console.log('[TON Connect] Opening URL:', url);
+    console.log('[TON Connect] Manifest URL:', this.config.manifestUrl);
+    console.log('[TON Connect] Return scheme:', this.config.scheme);
 
     // Create promise for connection
     return new Promise<WalletInfo>((resolve, reject) => {
@@ -326,6 +335,7 @@ export class TonConnectMobile {
       // Set timeout
       timeout = setTimeout(() => {
         if (this.connectionPromise) {
+          console.log('[TON Connect] Connection timeout after', this.config.connectionTimeout, 'ms');
           this.connectionPromise.reject(new ConnectionTimeoutError());
         }
       }, this.config.connectionTimeout) as unknown as number;
@@ -333,7 +343,22 @@ export class TonConnectMobile {
       this.connectionPromise.timeout = timeout;
 
       // Open wallet app
-      this.adapter.openURL(url).catch((error) => {
+      console.log('[TON Connect] Attempting to open wallet app...');
+      this.adapter.openURL(url).then((success) => {
+        console.log('[TON Connect] openURL result:', success);
+        // URL opened successfully, wait for callback
+        // If success is false, it should have thrown an error
+        if (!success && this.connectionPromise) {
+          console.log('[TON Connect] openURL returned false, rejecting promise');
+          this.connectionPromise.reject(
+            new TonConnectError('Failed to open wallet app. Please make sure a TON wallet is installed.')
+          );
+        } else {
+          console.log('[TON Connect] URL opened successfully, waiting for wallet callback...');
+        }
+      }).catch((error) => {
+        // Error opening URL - reject the promise
+        console.error('[TON Connect] Error opening URL:', error);
         if (this.connectionPromise) {
           this.connectionPromise.reject(
             new TonConnectError(`Failed to open wallet: ${error?.message || String(error)}`)
@@ -398,7 +423,16 @@ export class TonConnectMobile {
       this.transactionPromise.timeout = timeout;
 
       // Open wallet app
-      this.adapter.openURL(url).catch((error) => {
+      this.adapter.openURL(url).then((success) => {
+        // URL opened successfully, wait for callback
+        // If success is false, it should have thrown an error
+        if (!success && this.transactionPromise) {
+          this.transactionPromise.reject(
+            new TonConnectError('Failed to open wallet app. Please make sure a TON wallet is installed.')
+          );
+        }
+      }).catch((error) => {
+        // Error opening URL - reject the promise
         if (this.transactionPromise) {
           this.transactionPromise.reject(
             new TonConnectError(`Failed to open wallet: ${error?.message || String(error)}`)