@blazium/ton-connect-mobile 1.0.3 → 1.0.5

package/README.md

@@ -223,6 +223,9 @@ new TonConnectMobile(config: TonConnectMobileConfig)
 - `storageKeyPrefix` (optional): Prefix for storage keys (default: `'tonconnect_'`)
 - `connectionTimeout` (optional): Connection timeout in ms (default: `300000`)
 - `transactionTimeout` (optional): Transaction timeout in ms (default: `300000`)
+- `skipCanOpenURLCheck` (optional): Skip canOpenURL check before opening URL (default: `true`)
+  - Set to `false` if you want to check if URL can be opened before attempting to open it
+  - Note: On Android, `canOpenURL` may return `false` for `tonconnect://` even if wallet is installed
 
 #### Methods
 

package/dist/adapters/expo.d.ts

@@ -11,7 +11,7 @@ export declare class ExpoAdapter implements PlatformAdapter {
     private subscription;
     constructor();
     private setupURLListener;
-    openURL(url: string): Promise<boolean>;
+    openURL(url: string, skipCanOpenURLCheck?: boolean): Promise<boolean>;
     getInitialURL(): Promise<string | null>;
     addURLListener(callback: (url: string) => void): () => void;
     setItem(key: string, value: string): Promise<void>;

package/dist/adapters/expo.js

@@ -39,30 +39,38 @@ class ExpoAdapter {
             this.urlListeners.forEach((listener) => listener(event.url));
         });
     }
-    async openURL(url) {
+    async openURL(url, skipCanOpenURLCheck = true) {
         if (!Linking) {
             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) {
-                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:', url);
+            // Optional canOpenURL check (can be disabled via config)
+            if (!skipCanOpenURLCheck) {
+                console.log('[ExpoAdapter] Checking if URL can be opened...');
+                const canOpen = await Linking.canOpenURL(url);
+                console.log('[ExpoAdapter] canOpenURL result:', canOpen);
+                if (!canOpen) {
+                    throw new Error('Cannot open URL. Make sure a wallet app is installed that supports tonconnect:// protocol.');
+                }
             }
-            console.log('[ExpoAdapter] Opening URL...');
+            else {
+                console.log('[ExpoAdapter] Skipping canOpenURL check (Android compatibility)');
+            }
+            // CRITICAL FIX: Android'de canOpenURL() tonconnect:// protokolünü tanımayabilir
+            // Bu yüzden direkt openURL() çağırıyoruz. Eğer açılamazsa hata fırlatır.
             await Linking.openURL(url);
             console.log('[ExpoAdapter] URL opened successfully');
             return true;
         }
         catch (error) {
             console.error('[ExpoAdapter] Error in openURL:', error);
-            // Re-throw with more context
-            if (error.message && error.message.includes('Cannot open URL')) {
-                throw error;
+            // Android'de tonconnect:// protokolü tanınmıyorsa veya cüzdan yüklü değilse hata verir
+            const errorMessage = error?.message || String(error);
+            if (errorMessage.includes('No Activity found') || errorMessage.includes('No app found') || errorMessage.includes('Cannot open URL')) {
+                throw new Error('No TON wallet app found. Please install Tonkeeper or another TON Connect compatible wallet from Google Play Store.');
             }
-            throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
+            throw new Error(`Failed to open wallet app: ${errorMessage}`);
         }
     }
     async getInitialURL() {

package/dist/adapters/react-native.d.ts

@@ -11,7 +11,7 @@ export declare class ReactNativeAdapter implements PlatformAdapter {
     private subscription;
     constructor();
     private setupURLListener;
-    openURL(url: string): Promise<boolean>;
+    openURL(url: string, skipCanOpenURLCheck?: boolean): Promise<boolean>;
     getInitialURL(): Promise<string | null>;
     addURLListener(callback: (url: string) => void): () => void;
     setItem(key: string, value: string): Promise<void>;

package/dist/adapters/react-native.js

@@ -37,30 +37,38 @@ class ReactNativeAdapter {
             this.urlListeners.forEach((listener) => listener(event.url));
         });
     }
-    async openURL(url) {
+    async openURL(url, skipCanOpenURLCheck = true) {
         if (!Linking) {
             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) {
-                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:', url);
+            // Optional canOpenURL check (can be disabled via config)
+            if (!skipCanOpenURLCheck) {
+                console.log('[ReactNativeAdapter] Checking if URL can be opened...');
+                const canOpen = await Linking.canOpenURL(url);
+                console.log('[ReactNativeAdapter] canOpenURL result:', canOpen);
+                if (!canOpen) {
+                    throw new Error('Cannot open URL. Make sure a wallet app is installed that supports tonconnect:// protocol.');
+                }
             }
-            console.log('[ReactNativeAdapter] Opening URL...');
+            else {
+                console.log('[ReactNativeAdapter] Skipping canOpenURL check (Android compatibility)');
+            }
+            // CRITICAL FIX: Android'de canOpenURL() tonconnect:// protokolünü tanımayabilir
+            // Bu yüzden direkt openURL() çağırıyoruz. Eğer açılamazsa hata fırlatır.
             await Linking.openURL(url);
             console.log('[ReactNativeAdapter] URL opened successfully');
             return true;
         }
         catch (error) {
             console.error('[ReactNativeAdapter] Error in openURL:', error);
-            // Re-throw with more context
-            if (error.message && error.message.includes('Cannot open URL')) {
-                throw error;
+            // Android'de tonconnect:// protokolü tanınmıyorsa veya cüzdan yüklü değilse hata verir
+            const errorMessage = error?.message || String(error);
+            if (errorMessage.includes('No Activity found') || errorMessage.includes('No app found') || errorMessage.includes('Cannot open URL')) {
+                throw new Error('No TON wallet app found. Please install Tonkeeper or another TON Connect compatible wallet from Google Play Store.');
             }
-            throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
+            throw new Error(`Failed to open wallet app: ${errorMessage}`);
         }
     }
     async getInitialURL() {

package/dist/adapters/web.d.ts

@@ -13,7 +13,7 @@ export declare class WebAdapter implements PlatformAdapter {
     constructor();
     private setupURLListener;
     private handleURLChange;
-    openURL(url: string): Promise<boolean>;
+    openURL(url: string, skipCanOpenURLCheck?: boolean): Promise<boolean>;
     getInitialURL(): Promise<string | null>;
     addURLListener(callback: (url: string) => void): () => void;
     setItem(key: string, value: string): Promise<void>;

package/dist/adapters/web.js

@@ -42,7 +42,7 @@ class WebAdapter {
             }
         });
     }
-    async openURL(url) {
+    async openURL(url, skipCanOpenURLCheck) {
         try {
             if (typeof window !== 'undefined') {
                 // For web, tonconnect:// deep links don't work

package/dist/core/protocol.d.ts

@@ -14,13 +14,15 @@ export declare function decodeBase64URL<T>(encoded: string): T;
 /**
  * Build connection request URL
  * Format: tonconnect://connect?<base64_encoded_payload>
+ * Or universal link: https://app.tonkeeper.com/ton-connect?<base64_encoded_payload>
  */
-export declare function buildConnectionRequest(manifestUrl: string, returnScheme: string): string;
+export declare function buildConnectionRequest(manifestUrl: string, returnScheme: string, useUniversalLink?: boolean): string;
 /**
  * Build transaction request URL
  * Format: tonconnect://send-transaction?<base64_encoded_payload>
+ * Or universal link: https://app.tonkeeper.com/ton-connect/send-transaction?<base64_encoded_payload>
  */
-export declare function buildTransactionRequest(manifestUrl: string, request: SendTransactionRequest, returnScheme: string): string;
+export declare function buildTransactionRequest(manifestUrl: string, request: SendTransactionRequest, returnScheme: string, useUniversalLink?: boolean): string;
 /**
  * Parse callback URL
  * Format: <scheme>://tonconnect?<base64_encoded_response>

package/dist/core/protocol.js

@@ -18,7 +18,9 @@ exports.validateTransactionRequest = validateTransactionRequest;
  */
 const PROTOCOL_VERSION = '2';
 const CONNECT_PREFIX = 'tonconnect://connect';
+const CONNECT_UNIVERSAL_PREFIX = 'https://app.tonkeeper.com/ton-connect';
 const SEND_TRANSACTION_PREFIX = 'tonconnect://send-transaction';
+const SEND_TRANSACTION_UNIVERSAL_PREFIX = 'https://app.tonkeeper.com/ton-connect/send-transaction';
 const CALLBACK_PREFIX = 'tonconnect';
 /**
  * Get TextEncoder with availability check
@@ -100,21 +102,27 @@ function decodeBase64URL(encoded) {
 /**
  * Build connection request URL
  * Format: tonconnect://connect?<base64_encoded_payload>
+ * Or universal link: https://app.tonkeeper.com/ton-connect?<base64_encoded_payload>
  */
-function buildConnectionRequest(manifestUrl, returnScheme) {
+function buildConnectionRequest(manifestUrl, returnScheme, useUniversalLink = true) {
     const payload = {
         manifestUrl,
         items: [{ name: 'ton_addr' }],
         returnStrategy: 'back',
     };
     const encoded = encodeBase64URL(payload);
+    // Use universal link for better Android compatibility
+    if (useUniversalLink) {
+        return `${CONNECT_UNIVERSAL_PREFIX}?${encoded}`;
+    }
     return `${CONNECT_PREFIX}?${encoded}`;
 }
 /**
  * Build transaction request URL
  * Format: tonconnect://send-transaction?<base64_encoded_payload>
+ * Or universal link: https://app.tonkeeper.com/ton-connect/send-transaction?<base64_encoded_payload>
  */
-function buildTransactionRequest(manifestUrl, request, returnScheme) {
+function buildTransactionRequest(manifestUrl, request, returnScheme, useUniversalLink = true) {
     const payload = {
         manifestUrl,
         request: {
@@ -131,6 +139,10 @@ function buildTransactionRequest(manifestUrl, request, returnScheme) {
         returnStrategy: 'back',
     };
     const encoded = encodeBase64URL(payload);
+    // Use universal link for better Android compatibility
+    if (useUniversalLink) {
+        return `${SEND_TRANSACTION_UNIVERSAL_PREFIX}?${encoded}`;
+    }
     return `${SEND_TRANSACTION_PREFIX}?${encoded}`;
 }
 /**

package/dist/index.js

@@ -91,6 +91,7 @@ class TonConnectMobile {
             storageKeyPrefix: 'tonconnect_',
             connectionTimeout: 300000, // 5 minutes
             transactionTimeout: 300000, // 5 minutes
+            skipCanOpenURLCheck: true, // Skip canOpenURL check by default (Android issue)
             ...config,
         };
         console.log('[TON Connect] Initializing SDK with config:', {
@@ -278,9 +279,9 @@ class TonConnectMobile {
             console.log('[TON Connect] Connection already in progress');
             throw new ConnectionInProgressError();
         }
-        // Build connection request URL
+        // Build connection request URL (use universal link for Android compatibility)
         console.log('[TON Connect] Building connection request URL...');
-        const url = (0, protocol_1.buildConnectionRequest)(this.config.manifestUrl, this.config.scheme);
+        const url = (0, protocol_1.buildConnectionRequest)(this.config.manifestUrl, this.config.scheme, true);
         // DEBUG: Log the URL being opened
         console.log('[TON Connect] Opening URL:', url);
         console.log('[TON Connect] Manifest URL:', this.config.manifestUrl);
@@ -316,7 +317,7 @@ class TonConnectMobile {
             this.connectionPromise.timeout = timeout;
             // Open wallet app
             console.log('[TON Connect] Attempting to open wallet app...');
-            this.adapter.openURL(url).then((success) => {
+            this.adapter.openURL(url, this.config.skipCanOpenURLCheck).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
@@ -353,8 +354,8 @@ class TonConnectMobile {
         if (this.transactionPromise) {
             throw new TransactionInProgressError();
         }
-        // Build transaction request URL
-        const url = (0, protocol_1.buildTransactionRequest)(this.config.manifestUrl, request, this.config.scheme);
+        // Build transaction request URL (use universal link for Android compatibility)
+        const url = (0, protocol_1.buildTransactionRequest)(this.config.manifestUrl, request, this.config.scheme, true);
         // Create promise for transaction
         return new Promise((resolve, reject) => {
             let timeout = null;
@@ -383,7 +384,7 @@ class TonConnectMobile {
             }, this.config.transactionTimeout);
             this.transactionPromise.timeout = timeout;
             // Open wallet app
-            this.adapter.openURL(url).then((success) => {
+            this.adapter.openURL(url, this.config.skipCanOpenURLCheck).then((success) => {
                 // URL opened successfully, wait for callback
                 // If success is false, it should have thrown an error
                 if (!success && this.transactionPromise) {

package/dist/types/index.d.ts

@@ -157,7 +157,7 @@ export interface ErrorResponse {
  */
 export interface PlatformAdapter {
     /** Open a deep link URL */
-    openURL(url: string): Promise<boolean>;
+    openURL(url: string, skipCanOpenURLCheck?: boolean): Promise<boolean>;
     /** Get initial URL when app was opened via deep link */
     getInitialURL(): Promise<string | null>;
     /** Add listener for URL changes */
@@ -185,6 +185,11 @@ export interface TonConnectMobileConfig {
     connectionTimeout?: number;
     /** Optional transaction timeout in ms (default: 300000 = 5 minutes) */
     transactionTimeout?: number;
+    /** Skip canOpenURL check before opening URL (optional, default: true)
+     * Set to false if you want to check if URL can be opened before attempting to open it.
+     * Note: On Android, canOpenURL may return false for tonconnect:// even if wallet is installed.
+     */
+    skipCanOpenURLCheck?: boolean;
 }
 /**
  * Event listener callback type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazium/ton-connect-mobile",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "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",

package/src/adapters/expo.ts

@@ -48,29 +48,42 @@ export class ExpoAdapter implements PlatformAdapter {
     });
   }
 
-  async openURL(url: string): Promise<boolean> {
+  async openURL(url: string, skipCanOpenURLCheck: boolean = true): Promise<boolean> {
     if (!Linking) {
       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) {
-        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:', url);
+      
+      // Optional canOpenURL check (can be disabled via config)
+      if (!skipCanOpenURLCheck) {
+        console.log('[ExpoAdapter] Checking if URL can be opened...');
+        const canOpen = await Linking.canOpenURL(url);
+        console.log('[ExpoAdapter] canOpenURL result:', canOpen);
+        if (!canOpen) {
+          throw new Error(
+            'Cannot open URL. Make sure a wallet app is installed that supports tonconnect:// protocol.'
+          );
+        }
+      } else {
+        console.log('[ExpoAdapter] Skipping canOpenURL check (Android compatibility)');
       }
-      console.log('[ExpoAdapter] Opening URL...');
+      
+      // CRITICAL FIX: Android'de canOpenURL() tonconnect:// protokolünü tanımayabilir
+      // Bu yüzden direkt openURL() çağırıyoruz. Eğer açılamazsa hata fırlatır.
       await Linking.openURL(url);
       console.log('[ExpoAdapter] URL opened successfully');
       return true;
     } 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;
+      // Android'de tonconnect:// protokolü tanınmıyorsa veya cüzdan yüklü değilse hata verir
+      const errorMessage = error?.message || String(error);
+      if (errorMessage.includes('No Activity found') || errorMessage.includes('No app found') || errorMessage.includes('Cannot open URL')) {
+        throw new Error(
+          'No TON wallet app found. Please install Tonkeeper or another TON Connect compatible wallet from Google Play Store.'
+        );
       }
-      throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
+      throw new Error(`Failed to open wallet app: ${errorMessage}`);
     }
   }
 

package/src/adapters/react-native.ts

@@ -46,29 +46,42 @@ export class ReactNativeAdapter implements PlatformAdapter {
     });
   }
 
-  async openURL(url: string): Promise<boolean> {
+  async openURL(url: string, skipCanOpenURLCheck: boolean = true): Promise<boolean> {
     if (!Linking) {
       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) {
-        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:', url);
+      
+      // Optional canOpenURL check (can be disabled via config)
+      if (!skipCanOpenURLCheck) {
+        console.log('[ReactNativeAdapter] Checking if URL can be opened...');
+        const canOpen = await Linking.canOpenURL(url);
+        console.log('[ReactNativeAdapter] canOpenURL result:', canOpen);
+        if (!canOpen) {
+          throw new Error(
+            'Cannot open URL. Make sure a wallet app is installed that supports tonconnect:// protocol.'
+          );
+        }
+      } else {
+        console.log('[ReactNativeAdapter] Skipping canOpenURL check (Android compatibility)');
       }
-      console.log('[ReactNativeAdapter] Opening URL...');
+      
+      // CRITICAL FIX: Android'de canOpenURL() tonconnect:// protokolünü tanımayabilir
+      // Bu yüzden direkt openURL() çağırıyoruz. Eğer açılamazsa hata fırlatır.
       await Linking.openURL(url);
       console.log('[ReactNativeAdapter] URL opened successfully');
       return true;
     } 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;
+      // Android'de tonconnect:// protokolü tanınmıyorsa veya cüzdan yüklü değilse hata verir
+      const errorMessage = error?.message || String(error);
+      if (errorMessage.includes('No Activity found') || errorMessage.includes('No app found') || errorMessage.includes('Cannot open URL')) {
+        throw new Error(
+          'No TON wallet app found. Please install Tonkeeper or another TON Connect compatible wallet from Google Play Store.'
+        );
       }
-      throw new Error(`Failed to open URL: ${url}. ${error?.message || String(error)}`);
+      throw new Error(`Failed to open wallet app: ${errorMessage}`);
     }
   }
 

package/src/adapters/web.ts

@@ -66,7 +66,7 @@ export class WebAdapter implements PlatformAdapter {
     });
   }
 
-  async openURL(url: string): Promise<boolean> {
+  async openURL(url: string, skipCanOpenURLCheck?: boolean): Promise<boolean> {
     try {
       if (typeof window !== 'undefined') {
         // For web, tonconnect:// deep links don't work

package/src/core/protocol.ts

@@ -26,7 +26,9 @@ import {
  */
 const PROTOCOL_VERSION = '2';
 const CONNECT_PREFIX = 'tonconnect://connect';
+const CONNECT_UNIVERSAL_PREFIX = 'https://app.tonkeeper.com/ton-connect';
 const SEND_TRANSACTION_PREFIX = 'tonconnect://send-transaction';
+const SEND_TRANSACTION_UNIVERSAL_PREFIX = 'https://app.tonkeeper.com/ton-connect/send-transaction';
 const CALLBACK_PREFIX = 'tonconnect';
 
 /**
@@ -122,10 +124,12 @@ export function decodeBase64URL<T>(encoded: string): T {
 /**
  * Build connection request URL
  * Format: tonconnect://connect?<base64_encoded_payload>
+ * Or universal link: https://app.tonkeeper.com/ton-connect?<base64_encoded_payload>
  */
 export function buildConnectionRequest(
   manifestUrl: string,
-  returnScheme: string
+  returnScheme: string,
+  useUniversalLink: boolean = true
 ): string {
   const payload: ConnectionRequestPayload = {
     manifestUrl,
@@ -134,17 +138,25 @@ export function buildConnectionRequest(
   };
 
   const encoded = encodeBase64URL(payload);
+  
+  // Use universal link for better Android compatibility
+  if (useUniversalLink) {
+    return `${CONNECT_UNIVERSAL_PREFIX}?${encoded}`;
+  }
+  
   return `${CONNECT_PREFIX}?${encoded}`;
 }
 
 /**
  * Build transaction request URL
  * Format: tonconnect://send-transaction?<base64_encoded_payload>
+ * Or universal link: https://app.tonkeeper.com/ton-connect/send-transaction?<base64_encoded_payload>
  */
 export function buildTransactionRequest(
   manifestUrl: string,
   request: SendTransactionRequest,
-  returnScheme: string
+  returnScheme: string,
+  useUniversalLink: boolean = true
 ): string {
   const payload: TransactionRequestPayload = {
     manifestUrl,
@@ -163,6 +175,12 @@ export function buildTransactionRequest(
   };
 
   const encoded = encodeBase64URL(payload);
+  
+  // Use universal link for better Android compatibility
+  if (useUniversalLink) {
+    return `${SEND_TRANSACTION_UNIVERSAL_PREFIX}?${encoded}`;
+  }
+  
   return `${SEND_TRANSACTION_PREFIX}?${encoded}`;
 }
 

package/src/index.ts

@@ -111,6 +111,7 @@ export class TonConnectMobile {
       storageKeyPrefix: 'tonconnect_',
       connectionTimeout: 300000, // 5 minutes
       transactionTimeout: 300000, // 5 minutes
+      skipCanOpenURLCheck: true, // Skip canOpenURL check by default (Android issue)
       ...config,
     };
 
@@ -319,9 +320,9 @@ export class TonConnectMobile {
       throw new ConnectionInProgressError();
     }
 
-    // Build connection request URL
+    // Build connection request URL (use universal link for Android compatibility)
     console.log('[TON Connect] Building connection request URL...');
-    const url = buildConnectionRequest(this.config.manifestUrl, this.config.scheme);
+    const url = buildConnectionRequest(this.config.manifestUrl, this.config.scheme, true);
     
     // DEBUG: Log the URL being opened
     console.log('[TON Connect] Opening URL:', url);
@@ -363,7 +364,7 @@ export class TonConnectMobile {
 
       // Open wallet app
       console.log('[TON Connect] Attempting to open wallet app...');
-      this.adapter.openURL(url).then((success) => {
+      this.adapter.openURL(url, this.config.skipCanOpenURLCheck).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
@@ -407,8 +408,8 @@ export class TonConnectMobile {
       throw new TransactionInProgressError();
     }
 
-    // Build transaction request URL
-    const url = buildTransactionRequest(this.config.manifestUrl, request, this.config.scheme);
+    // Build transaction request URL (use universal link for Android compatibility)
+    const url = buildTransactionRequest(this.config.manifestUrl, request, this.config.scheme, true);
 
     // Create promise for transaction
     return new Promise<{ boc: string; signature: string }>((resolve, reject) => {
@@ -442,7 +443,7 @@ export class TonConnectMobile {
       this.transactionPromise.timeout = timeout;
 
       // Open wallet app
-      this.adapter.openURL(url).then((success) => {
+      this.adapter.openURL(url, this.config.skipCanOpenURLCheck).then((success) => {
         // URL opened successfully, wait for callback
         // If success is false, it should have thrown an error
         if (!success && this.transactionPromise) {

package/src/types/index.ts

@@ -168,7 +168,7 @@ export interface ErrorResponse {
  */
 export interface PlatformAdapter {
   /** Open a deep link URL */
-  openURL(url: string): Promise<boolean>;
+  openURL(url: string, skipCanOpenURLCheck?: boolean): Promise<boolean>;
   /** Get initial URL when app was opened via deep link */
   getInitialURL(): Promise<string | null>;
   /** Add listener for URL changes */
@@ -197,6 +197,11 @@ export interface TonConnectMobileConfig {
   connectionTimeout?: number;
   /** Optional transaction timeout in ms (default: 300000 = 5 minutes) */
   transactionTimeout?: number;
+  /** Skip canOpenURL check before opening URL (optional, default: true)
+   * Set to false if you want to check if URL can be opened before attempting to open it.
+   * Note: On Android, canOpenURL may return false for tonconnect:// even if wallet is installed.
+   */
+  skipCanOpenURLCheck?: boolean;
 }
 
 /**