@blazium/ton-connect-mobile 1.0.4 → 1.0.6

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,12 +39,24 @@ 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] 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)');
+            }
             // 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);
@@ -55,7 +67,7 @@ class ExpoAdapter {
             console.error('[ExpoAdapter] Error in openURL:', 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')) {
+            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 wallet app: ${errorMessage}`);

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,12 +37,24 @@ 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] 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)');
+            }
             // 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);
@@ -53,7 +65,7 @@ class ReactNativeAdapter {
             console.error('[ReactNativeAdapter] Error in openURL:', 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')) {
+            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 wallet app: ${errorMessage}`);

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,17 @@ 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>
+ * Or custom wallet universal link
  */
-export declare function buildConnectionRequest(manifestUrl: string, returnScheme: string): string;
+export declare function buildConnectionRequest(manifestUrl: string, returnScheme: string, walletUniversalLink?: string): 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>
+ * Or custom wallet universal link
  */
-export declare function buildTransactionRequest(manifestUrl: string, request: SendTransactionRequest, returnScheme: string): string;
+export declare function buildTransactionRequest(manifestUrl: string, request: SendTransactionRequest, returnScheme: string, walletUniversalLink?: string): 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,30 @@ 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>
+ * Or custom wallet universal link
  */
-function buildConnectionRequest(manifestUrl, returnScheme) {
+function buildConnectionRequest(manifestUrl, returnScheme, walletUniversalLink) {
     const payload = {
         manifestUrl,
         items: [{ name: 'ton_addr' }],
         returnStrategy: 'back',
     };
     const encoded = encodeBase64URL(payload);
-    return `${CONNECT_PREFIX}?${encoded}`;
+    // Use custom wallet universal link if provided
+    if (walletUniversalLink) {
+        return `${walletUniversalLink}?${encoded}`;
+    }
+    // Default to Tonkeeper universal link for Android compatibility
+    return `${CONNECT_UNIVERSAL_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>
+ * Or custom wallet universal link
  */
-function buildTransactionRequest(manifestUrl, request, returnScheme) {
+function buildTransactionRequest(manifestUrl, request, returnScheme, walletUniversalLink) {
     const payload = {
         manifestUrl,
         request: {
@@ -131,7 +142,16 @@ function buildTransactionRequest(manifestUrl, request, returnScheme) {
         returnStrategy: 'back',
     };
     const encoded = encodeBase64URL(payload);
-    return `${SEND_TRANSACTION_PREFIX}?${encoded}`;
+    // Use custom wallet universal link if provided
+    if (walletUniversalLink) {
+        // For transaction, append /send-transaction to the base universal link
+        const baseUrl = walletUniversalLink.endsWith('/ton-connect')
+            ? walletUniversalLink
+            : `${walletUniversalLink}/ton-connect`;
+        return `${baseUrl}/send-transaction?${encoded}`;
+    }
+    // Default to Tonkeeper universal link for Android compatibility
+    return `${SEND_TRANSACTION_UNIVERSAL_PREFIX}?${encoded}`;
 }
 /**
  * Parse callback URL

package/dist/core/wallets.d.ts

@@ -0,0 +1,34 @@
+/**
+ * TON Connect compatible wallet definitions
+ * Each wallet has its own universal link format
+ */
+export interface WalletDefinition {
+    /** Wallet name for display */
+    name: string;
+    /** Wallet app name */
+    appName: string;
+    /** Universal link base URL for this wallet */
+    universalLink: string;
+    /** Deep link scheme (if supported) */
+    deepLink?: string;
+    /** Wallet icon URL (optional) */
+    iconUrl?: string;
+    /** Platform support */
+    platforms: ('ios' | 'android' | 'web')[];
+}
+/**
+ * List of supported TON Connect wallets
+ */
+export declare const SUPPORTED_WALLETS: WalletDefinition[];
+/**
+ * Get wallet definition by name
+ */
+export declare function getWalletByName(name: string): WalletDefinition | undefined;
+/**
+ * Get default wallet (Tonkeeper)
+ */
+export declare function getDefaultWallet(): WalletDefinition;
+/**
+ * Get all wallets for a specific platform
+ */
+export declare function getWalletsForPlatform(platform: 'ios' | 'android' | 'web'): WalletDefinition[];

package/dist/core/wallets.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * TON Connect compatible wallet definitions
+ * Each wallet has its own universal link format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_WALLETS = void 0;
+exports.getWalletByName = getWalletByName;
+exports.getDefaultWallet = getDefaultWallet;
+exports.getWalletsForPlatform = getWalletsForPlatform;
+/**
+ * List of supported TON Connect wallets
+ */
+exports.SUPPORTED_WALLETS = [
+    {
+        name: 'Tonkeeper',
+        appName: 'Tonkeeper',
+        universalLink: 'https://app.tonkeeper.com/ton-connect',
+        deepLink: 'tonkeeper://',
+        platforms: ['ios', 'android'],
+    },
+    {
+        name: 'MyTonWallet',
+        appName: 'MyTonWallet',
+        universalLink: 'https://connect.mytonwallet.org',
+        deepLink: 'mytonwallet://',
+        platforms: ['ios', 'android', 'web'],
+    },
+    {
+        name: 'Wallet in Telegram',
+        appName: 'Wallet',
+        universalLink: 'https://wallet.tonapi.io/ton-connect',
+        deepLink: 'tg://',
+        platforms: ['ios', 'android'],
+    },
+    {
+        name: 'Tonhub',
+        appName: 'Tonhub',
+        universalLink: 'https://tonhub.com/ton-connect',
+        deepLink: 'tonhub://',
+        platforms: ['ios', 'android'],
+    },
+];
+/**
+ * Get wallet definition by name
+ */
+function getWalletByName(name) {
+    return exports.SUPPORTED_WALLETS.find((wallet) => wallet.name.toLowerCase() === name.toLowerCase() || wallet.appName.toLowerCase() === name.toLowerCase());
+}
+/**
+ * Get default wallet (Tonkeeper)
+ */
+function getDefaultWallet() {
+    return exports.SUPPORTED_WALLETS[0]; // Tonkeeper
+}
+/**
+ * Get all wallets for a specific platform
+ */
+function getWalletsForPlatform(platform) {
+    return exports.SUPPORTED_WALLETS.filter((wallet) => wallet.platforms.includes(platform));
+}

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  * Production-ready implementation for React Native and Expo
  */
 import { TonConnectMobileConfig, ConnectionStatus, WalletInfo, SendTransactionRequest, StatusChangeCallback } from './types';
+import { type WalletDefinition } from './core/wallets';
 /**
  * Custom error classes
  */
@@ -34,6 +35,7 @@ export declare class TonConnectMobile {
     private statusChangeCallbacks;
     private currentStatus;
     private urlUnsubscribe;
+    private currentWallet;
     private connectionPromise;
     private transactionPromise;
     constructor(config: TonConnectMobileConfig);
@@ -80,6 +82,18 @@ export declare class TonConnectMobile {
      * Get current connection status
      */
     getStatus(): ConnectionStatus;
+    /**
+     * Get list of supported wallets
+     */
+    getSupportedWallets(): WalletDefinition[];
+    /**
+     * Get current wallet being used
+     */
+    getCurrentWallet(): WalletDefinition;
+    /**
+     * Set preferred wallet for connections
+     */
+    setPreferredWallet(walletName: string): void;
     /**
      * Subscribe to status changes
      */
@@ -110,3 +124,5 @@ export declare class TonConnectMobile {
     destroy(): void;
 }
 export * from './types';
+export type { WalletDefinition } from './core/wallets';
+export { SUPPORTED_WALLETS, getWalletByName, getDefaultWallet, getWalletsForPlatform } from './core/wallets';

package/dist/index.js

@@ -18,12 +18,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TonConnectMobile = exports.TransactionInProgressError = exports.ConnectionInProgressError = exports.UserRejectedError = exports.TransactionTimeoutError = exports.ConnectionTimeoutError = exports.TonConnectError = void 0;
+exports.getWalletsForPlatform = exports.getDefaultWallet = exports.getWalletByName = exports.SUPPORTED_WALLETS = exports.TonConnectMobile = exports.TransactionInProgressError = exports.ConnectionInProgressError = exports.UserRejectedError = exports.TransactionTimeoutError = exports.ConnectionTimeoutError = exports.TonConnectError = void 0;
 const protocol_1 = require("./core/protocol");
 const crypto_1 = require("./core/crypto");
 const expo_1 = require("./adapters/expo");
 const react_native_1 = require("./adapters/react-native");
 const web_1 = require("./adapters/web");
+const wallets_1 = require("./core/wallets");
 /**
  * Custom error classes
  */
@@ -91,11 +92,30 @@ class TonConnectMobile {
             storageKeyPrefix: 'tonconnect_',
             connectionTimeout: 300000, // 5 minutes
             transactionTimeout: 300000, // 5 minutes
+            skipCanOpenURLCheck: true, // Skip canOpenURL check by default (Android issue)
+            preferredWallet: config.preferredWallet,
             ...config,
         };
+        // Determine which wallet to use
+        if (this.config.preferredWallet) {
+            const wallet = (0, wallets_1.getWalletByName)(this.config.preferredWallet);
+            if (wallet) {
+                this.currentWallet = wallet;
+                console.log('[TON Connect] Using preferred wallet:', wallet.name);
+            }
+            else {
+                console.warn('[TON Connect] Preferred wallet not found, using default');
+                this.currentWallet = (0, wallets_1.getDefaultWallet)();
+            }
+        }
+        else {
+            this.currentWallet = (0, wallets_1.getDefaultWallet)();
+        }
         console.log('[TON Connect] Initializing SDK with config:', {
             manifestUrl: this.config.manifestUrl,
             scheme: this.config.scheme,
+            wallet: this.currentWallet.name,
+            universalLink: this.currentWallet.universalLink,
         });
         // Initialize platform adapter
         this.adapter = this.createAdapter();
@@ -278,9 +298,11 @@ class TonConnectMobile {
             console.log('[TON Connect] Connection already in progress');
             throw new ConnectionInProgressError();
         }
-        // Build connection request URL
-        console.log('[TON Connect] Building connection request URL...');
-        const url = (0, protocol_1.buildConnectionRequest)(this.config.manifestUrl, this.config.scheme);
+        // Build connection request URL (use wallet's universal link)
+        console.log('[TON Connect] Building connection request URL for wallet:', this.currentWallet.name);
+        console.log('[TON Connect] Using universal link:', this.currentWallet.universalLink);
+        const url = (0, protocol_1.buildConnectionRequest)(this.config.manifestUrl, this.config.scheme, this.currentWallet.universalLink);
+        console.log('[TON Connect] Built URL:', url.substring(0, 100) + '...');
         // DEBUG: Log the URL being opened
         console.log('[TON Connect] Opening URL:', url);
         console.log('[TON Connect] Manifest URL:', this.config.manifestUrl);
@@ -316,7 +338,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 +375,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, this.currentWallet.universalLink);
         // Create promise for transaction
         return new Promise((resolve, reject) => {
             let timeout = null;
@@ -383,7 +405,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) {
@@ -413,6 +435,29 @@ class TonConnectMobile {
     getStatus() {
         return { ...this.currentStatus };
     }
+    /**
+     * Get list of supported wallets
+     */
+    getSupportedWallets() {
+        return wallets_1.SUPPORTED_WALLETS;
+    }
+    /**
+     * Get current wallet being used
+     */
+    getCurrentWallet() {
+        return this.currentWallet;
+    }
+    /**
+     * Set preferred wallet for connections
+     */
+    setPreferredWallet(walletName) {
+        const wallet = (0, wallets_1.getWalletByName)(walletName);
+        if (!wallet) {
+            throw new TonConnectError(`Wallet "${walletName}" not found. Available wallets: ${wallets_1.SUPPORTED_WALLETS.map(w => w.name).join(', ')}`);
+        }
+        this.currentWallet = wallet;
+        console.log('[TON Connect] Preferred wallet changed to:', wallet.name);
+    }
     /**
      * Subscribe to status changes
      */
@@ -548,3 +593,8 @@ class TonConnectMobile {
 exports.TonConnectMobile = TonConnectMobile;
 // Export types
 __exportStar(require("./types"), exports);
+var wallets_2 = require("./core/wallets");
+Object.defineProperty(exports, "SUPPORTED_WALLETS", { enumerable: true, get: function () { return wallets_2.SUPPORTED_WALLETS; } });
+Object.defineProperty(exports, "getWalletByName", { enumerable: true, get: function () { return wallets_2.getWalletByName; } });
+Object.defineProperty(exports, "getDefaultWallet", { enumerable: true, get: function () { return wallets_2.getDefaultWallet; } });
+Object.defineProperty(exports, "getWalletsForPlatform", { enumerable: true, get: function () { return wallets_2.getWalletsForPlatform; } });

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,16 @@ 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;
+    /** Preferred wallet name (optional)
+     * If not specified, will use default wallet (Tonkeeper)
+     * Available: 'Tonkeeper', 'MyTonWallet', 'Wallet in Telegram', 'Tonhub'
+     */
+    preferredWallet?: string;
 }
 /**
  * Event listener callback type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazium/ton-connect-mobile",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "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,12 +48,27 @@ 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] 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)');
+      }
+      
       // 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);
@@ -63,7 +78,7 @@ export class ExpoAdapter implements PlatformAdapter {
       console.error('[ExpoAdapter] Error in openURL:', 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')) {
+      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.'
         );

package/src/adapters/react-native.ts

@@ -46,12 +46,27 @@ 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] 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)');
+      }
+      
       // 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);
@@ -61,7 +76,7 @@ export class ReactNativeAdapter implements PlatformAdapter {
       console.error('[ReactNativeAdapter] Error in openURL:', 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')) {
+      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.'
         );

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,13 @@ 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>
+ * Or custom wallet universal link
  */
 export function buildConnectionRequest(
   manifestUrl: string,
-  returnScheme: string
+  returnScheme: string,
+  walletUniversalLink?: string
 ): string {
   const payload: ConnectionRequestPayload = {
     manifestUrl,
@@ -134,17 +139,27 @@ export function buildConnectionRequest(
   };
 
   const encoded = encodeBase64URL(payload);
-  return `${CONNECT_PREFIX}?${encoded}`;
+  
+  // Use custom wallet universal link if provided
+  if (walletUniversalLink) {
+    return `${walletUniversalLink}?${encoded}`;
+  }
+  
+  // Default to Tonkeeper universal link for Android compatibility
+  return `${CONNECT_UNIVERSAL_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>
+ * Or custom wallet universal link
  */
 export function buildTransactionRequest(
   manifestUrl: string,
   request: SendTransactionRequest,
-  returnScheme: string
+  returnScheme: string,
+  walletUniversalLink?: string
 ): string {
   const payload: TransactionRequestPayload = {
     manifestUrl,
@@ -163,7 +178,18 @@ export function buildTransactionRequest(
   };
 
   const encoded = encodeBase64URL(payload);
-  return `${SEND_TRANSACTION_PREFIX}?${encoded}`;
+  
+  // Use custom wallet universal link if provided
+  if (walletUniversalLink) {
+    // For transaction, append /send-transaction to the base universal link
+    const baseUrl = walletUniversalLink.endsWith('/ton-connect') 
+      ? walletUniversalLink 
+      : `${walletUniversalLink}/ton-connect`;
+    return `${baseUrl}/send-transaction?${encoded}`;
+  }
+  
+  // Default to Tonkeeper universal link for Android compatibility
+  return `${SEND_TRANSACTION_UNIVERSAL_PREFIX}?${encoded}`;
 }
 
 /**

package/src/core/wallets.ts

@@ -0,0 +1,77 @@
+/**
+ * TON Connect compatible wallet definitions
+ * Each wallet has its own universal link format
+ */
+
+export interface WalletDefinition {
+  /** Wallet name for display */
+  name: string;
+  /** Wallet app name */
+  appName: string;
+  /** Universal link base URL for this wallet */
+  universalLink: string;
+  /** Deep link scheme (if supported) */
+  deepLink?: string;
+  /** Wallet icon URL (optional) */
+  iconUrl?: string;
+  /** Platform support */
+  platforms: ('ios' | 'android' | 'web')[];
+}
+
+/**
+ * List of supported TON Connect wallets
+ */
+export const SUPPORTED_WALLETS: WalletDefinition[] = [
+  {
+    name: 'Tonkeeper',
+    appName: 'Tonkeeper',
+    universalLink: 'https://app.tonkeeper.com/ton-connect',
+    deepLink: 'tonkeeper://',
+    platforms: ['ios', 'android'],
+  },
+  {
+    name: 'MyTonWallet',
+    appName: 'MyTonWallet',
+    universalLink: 'https://connect.mytonwallet.org',
+    deepLink: 'mytonwallet://',
+    platforms: ['ios', 'android', 'web'],
+  },
+  {
+    name: 'Wallet in Telegram',
+    appName: 'Wallet',
+    universalLink: 'https://wallet.tonapi.io/ton-connect',
+    deepLink: 'tg://',
+    platforms: ['ios', 'android'],
+  },
+  {
+    name: 'Tonhub',
+    appName: 'Tonhub',
+    universalLink: 'https://tonhub.com/ton-connect',
+    deepLink: 'tonhub://',
+    platforms: ['ios', 'android'],
+  },
+];
+
+/**
+ * Get wallet definition by name
+ */
+export function getWalletByName(name: string): WalletDefinition | undefined {
+  return SUPPORTED_WALLETS.find(
+    (wallet) => wallet.name.toLowerCase() === name.toLowerCase() || wallet.appName.toLowerCase() === name.toLowerCase()
+  );
+}
+
+/**
+ * Get default wallet (Tonkeeper)
+ */
+export function getDefaultWallet(): WalletDefinition {
+  return SUPPORTED_WALLETS[0]; // Tonkeeper
+}
+
+/**
+ * Get all wallets for a specific platform
+ */
+export function getWalletsForPlatform(platform: 'ios' | 'android' | 'web'): WalletDefinition[] {
+  return SUPPORTED_WALLETS.filter((wallet) => wallet.platforms.includes(platform));
+}
+

package/src/index.ts

@@ -32,6 +32,7 @@ import { verifyConnectionProof, generateSessionId } from './core/crypto';
 import { ExpoAdapter } from './adapters/expo';
 import { ReactNativeAdapter } from './adapters/react-native';
 import { WebAdapter } from './adapters/web';
+import { getWalletByName, getDefaultWallet, SUPPORTED_WALLETS, type WalletDefinition } from './core/wallets';
 
 /**
  * Custom error classes
@@ -83,10 +84,11 @@ export class TransactionInProgressError extends TonConnectError {
  */
 export class TonConnectMobile {
   private adapter: PlatformAdapter;
-  private config: Required<TonConnectMobileConfig>;
+  private config: Required<Omit<TonConnectMobileConfig, 'preferredWallet'>> & { preferredWallet?: string };
   private statusChangeCallbacks: Set<StatusChangeCallback> = new Set();
   private currentStatus: ConnectionStatus = { connected: false, wallet: null };
   private urlUnsubscribe: (() => void) | null = null;
+  private currentWallet!: WalletDefinition;
   private connectionPromise: {
     resolve: (wallet: WalletInfo) => void;
     reject: (error: Error) => void;
@@ -111,12 +113,30 @@ export class TonConnectMobile {
       storageKeyPrefix: 'tonconnect_',
       connectionTimeout: 300000, // 5 minutes
       transactionTimeout: 300000, // 5 minutes
+      skipCanOpenURLCheck: true, // Skip canOpenURL check by default (Android issue)
+      preferredWallet: config.preferredWallet,
       ...config,
-    };
+    } as Required<Omit<TonConnectMobileConfig, 'preferredWallet'>> & { preferredWallet?: string };
+
+    // Determine which wallet to use
+    if (this.config.preferredWallet) {
+      const wallet = getWalletByName(this.config.preferredWallet);
+      if (wallet) {
+        this.currentWallet = wallet;
+        console.log('[TON Connect] Using preferred wallet:', wallet.name);
+      } else {
+        console.warn('[TON Connect] Preferred wallet not found, using default');
+        this.currentWallet = getDefaultWallet();
+      }
+    } else {
+      this.currentWallet = getDefaultWallet();
+    }
 
     console.log('[TON Connect] Initializing SDK with config:', {
       manifestUrl: this.config.manifestUrl,
       scheme: this.config.scheme,
+      wallet: this.currentWallet.name,
+      universalLink: this.currentWallet.universalLink,
     });
 
     // Initialize platform adapter
@@ -319,9 +339,11 @@ export class TonConnectMobile {
       throw new ConnectionInProgressError();
     }
 
-    // Build connection request URL
-    console.log('[TON Connect] Building connection request URL...');
-    const url = buildConnectionRequest(this.config.manifestUrl, this.config.scheme);
+    // Build connection request URL (use wallet's universal link)
+    console.log('[TON Connect] Building connection request URL for wallet:', this.currentWallet.name);
+    console.log('[TON Connect] Using universal link:', this.currentWallet.universalLink);
+    const url = buildConnectionRequest(this.config.manifestUrl, this.config.scheme, this.currentWallet.universalLink);
+    console.log('[TON Connect] Built URL:', url.substring(0, 100) + '...');
     
     // DEBUG: Log the URL being opened
     console.log('[TON Connect] Opening URL:', url);
@@ -363,7 +385,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 +429,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, this.currentWallet.universalLink);
 
     // Create promise for transaction
     return new Promise<{ boc: string; signature: string }>((resolve, reject) => {
@@ -442,7 +464,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) {
@@ -480,6 +502,32 @@ export class TonConnectMobile {
     return { ...this.currentStatus };
   }
 
+  /**
+   * Get list of supported wallets
+   */
+  getSupportedWallets(): WalletDefinition[] {
+    return SUPPORTED_WALLETS;
+  }
+
+  /**
+   * Get current wallet being used
+   */
+  getCurrentWallet(): WalletDefinition {
+    return this.currentWallet;
+  }
+
+  /**
+   * Set preferred wallet for connections
+   */
+  setPreferredWallet(walletName: string): void {
+    const wallet = getWalletByName(walletName);
+    if (!wallet) {
+      throw new TonConnectError(`Wallet "${walletName}" not found. Available wallets: ${SUPPORTED_WALLETS.map(w => w.name).join(', ')}`);
+    }
+    this.currentWallet = wallet;
+    console.log('[TON Connect] Preferred wallet changed to:', wallet.name);
+  }
+
   /**
    * Subscribe to status changes
    */
@@ -628,4 +676,6 @@ export class TonConnectMobile {
 
 // Export types
 export * from './types';
+export type { WalletDefinition } from './core/wallets';
+export { SUPPORTED_WALLETS, getWalletByName, getDefaultWallet, getWalletsForPlatform } from './core/wallets';
 

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,16 @@ 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;
+  /** Preferred wallet name (optional)
+   * If not specified, will use default wallet (Tonkeeper)
+   * Available: 'Tonkeeper', 'MyTonWallet', 'Wallet in Telegram', 'Tonhub'
+   */
+  preferredWallet?: string;
 }
 
 /**