@blazium/ton-connect-mobile 1.0.9 → 1.1.1

package/dist/core/protocol.js

@@ -106,10 +106,15 @@ function decodeBase64URL(encoded) {
  * Or custom wallet universal link
  */
 function buildConnectionRequest(manifestUrl, returnScheme, walletUniversalLink) {
+    // TON Connect protocol: payload should only contain manifestUrl, items, and returnStrategy
+    // returnScheme is NOT part of the official protocol payload
+    // For mobile apps, wallets should infer the callback scheme from the manifest or use a default
     const payload = {
         manifestUrl,
         items: [{ name: 'ton_addr' }],
         returnStrategy: 'back',
+        // NOTE: returnScheme is NOT in the official TON Connect protocol
+        // Wallets should handle mobile app callbacks differently
     };
     const encoded = encodeBase64URL(payload);
     // Use custom wallet universal link if provided
@@ -140,6 +145,8 @@ function buildTransactionRequest(manifestUrl, request, returnScheme, walletUnive
             from: request.from,
         },
         returnStrategy: 'back',
+        // NOTE: returnScheme is NOT in the official TON Connect protocol
+        // Wallets should handle mobile app callbacks differently
     };
     const encoded = encodeBase64URL(payload);
     // Use custom wallet universal link if provided

package/dist/types/index.d.ts

@@ -75,7 +75,7 @@ export interface ConnectionRequestPayload {
     items: Array<{
         name: 'ton_addr';
     }>;
-    /** Return URL scheme */
+    /** Return strategy - how wallet should return to the app */
     returnStrategy?: 'back' | 'none';
 }
 /**
@@ -130,7 +130,9 @@ export interface TransactionRequestPayload {
         /** Optional from address */
         from?: string;
     };
-    /** Return URL scheme */
+    /** Return URL scheme (for mobile apps) */
+    returnScheme?: string;
+    /** Return strategy */
     returnStrategy?: 'back' | 'none';
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazium/ton-connect-mobile",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "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/core/protocol.ts

@@ -132,10 +132,15 @@ export function buildConnectionRequest(
   returnScheme: string,
   walletUniversalLink?: string
 ): string {
+  // TON Connect protocol: payload should only contain manifestUrl, items, and returnStrategy
+  // returnScheme is NOT part of the official protocol payload
+  // For mobile apps, wallets should infer the callback scheme from the manifest or use a default
   const payload: ConnectionRequestPayload = {
     manifestUrl,
     items: [{ name: 'ton_addr' }],
     returnStrategy: 'back',
+    // NOTE: returnScheme is NOT in the official TON Connect protocol
+    // Wallets should handle mobile app callbacks differently
   };
 
   const encoded = encodeBase64URL(payload);
@@ -175,6 +180,8 @@ export function buildTransactionRequest(
       from: request.from,
     },
     returnStrategy: 'back',
+    // NOTE: returnScheme is NOT in the official TON Connect protocol
+    // Wallets should handle mobile app callbacks differently
   };
 
   const encoded = encodeBase64URL(payload);

package/src/types/index.ts

@@ -81,8 +81,10 @@ export interface ConnectionRequestPayload {
   items: Array<{
     name: 'ton_addr';
   }>;
-  /** Return URL scheme */
+  /** Return strategy - how wallet should return to the app */
   returnStrategy?: 'back' | 'none';
+  // NOTE: returnScheme is NOT part of the official TON Connect protocol
+  // For mobile apps, wallets should handle callbacks based on the manifest URL
 }
 
 /**
@@ -138,7 +140,9 @@ export interface TransactionRequestPayload {
     /** Optional from address */
     from?: string;
   };
-  /** Return URL scheme */
+  /** Return URL scheme (for mobile apps) */
+  returnScheme?: string;
+  /** Return strategy */
   returnStrategy?: 'back' | 'none';
 }