@tonconnect/sdk 3.4.0-beta.0 → 3.4.0-beta.1

package/lib/types/index.d.ts

@@ -6,7 +6,7 @@ export declare interface Account {
     /**
      * User's selected chain.
      */
-    chain: CHAIN;
+    chain: ChainId;
     /**
      * Base64 (not url safe) encoded wallet contract stateInit.
      * Can be used to get user's public key from the stateInit if the wallet contract doesn't support corresponding get method.
@@ -70,6 +70,8 @@ export declare enum CHAIN {
     TESTNET = "-3"
 }
 
+export declare type ChainId = CHAIN | string;
+
 export declare function checkRequiredWalletFeatures(features: Feature[], walletsRequiredFeatures?: RequiredFeatures): boolean;
 
 export declare enum CONNECT_EVENT_ERROR_CODES {
@@ -665,6 +667,12 @@ export declare interface ITonConnect {
      * Unpause bridge HTTP connection if it is paused.
      */
     unPauseConnection(): Promise<void>;
+    /**
+     * Set desired network for the connection. Can only be set before connecting.
+     * If wallet connects with a different chain, the SDK will throw an error and abort connection.
+     * @param network desired network id (e.g., '-239', '-3', or custom). Pass undefined to allow any network.
+     */
+    setConnectionNetwork(network?: ChainId): void;
     /**
      * Disconnect form thw connected wallet and drop current session.
      */
@@ -852,7 +860,7 @@ export declare interface SendTransactionRequest {
     /**
      * The network (mainnet or testnet) where DApp intends to send the transaction. If not set, the transaction is sent to the network currently set in the wallet, but this is not safe and DApp should always strive to set the network. If the network parameter is set, but the wallet has a different network set, the wallet should show an alert and DO NOT ALLOW TO SEND this transaction.
      */
-    network?: CHAIN;
+    network?: ChainId;
     /**
      * The sender address in '<wc>:<hex>' format from which DApp intends to send the transaction. Current account.address by default.
      */
@@ -925,7 +933,7 @@ export declare type SignDataFeature = {
 };
 
 export declare type SignDataPayload = {
-    network?: CHAIN;
+    network?: ChainId;
     from?: string;
 } & (SignDataPayloadText | SignDataPayloadBinary | SignDataPayloadCell);
 
@@ -967,17 +975,22 @@ export declare type TelegramUser = {
 
 export declare interface TonAddressItem {
     name: 'ton_addr';
+    /**
+     * Desired network global_id. If provided, wallet should connect on this network.
+     */
+    network?: ChainId;
 }
 
 export declare interface TonAddressItemReply {
     name: 'ton_addr';
     address: string;
-    network: CHAIN;
+    network: ChainId;
     walletStateInit: string;
     publicKey: string;
 }
 
 declare class TonConnect implements ITonConnect {
+    private desiredChainId;
     private static readonly walletsList;
     /**
      * Check if specified wallet is injected and available to use with the app.
@@ -1075,6 +1088,12 @@ declare class TonConnect implements ITonConnect {
         onRequestSent?: () => void;
         signal?: AbortSignal;
     }>): Promise<Traceable<SignDataResponse>>;
+    /**
+     * Set desired network for the connection. Can only be set before connecting.
+     * If wallet connects with a different chain, the SDK will throw an error and abort connection.
+     * @param network desired network id (e.g., '-239', '-3', or custom). Pass undefined to allow any network.
+     */
+    setConnectionNetwork(network?: ChainId): void;
     /**
      * Disconnect form thw connected wallet and drop current session.
      */
@@ -1632,6 +1651,18 @@ export declare class WalletsListManager {
     private isCorrectWalletConfigDTO;
 }
 
+export declare class WalletWrongNetworkError extends TonConnectError<{
+    expectedChainId: string;
+    actualChainId: string;
+}> {
+    constructor(message: string, options: {
+        cause: {
+            expectedChainId: string;
+            actualChainId: string;
+        };
+    });
+}
+
 /**
  * Parameters without version field.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonconnect/sdk",
-  "version": "3.4.0-beta.0",
+  "version": "3.4.0-beta.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ton-connect/sdk.git"
@@ -22,7 +22,7 @@
   "dependencies": {
     "@tonconnect/isomorphic-eventsource": "0.0.2",
     "@tonconnect/isomorphic-fetch": "0.0.3",
-    "@tonconnect/protocol": "2.3.0"
+    "@tonconnect/protocol": "2.4.0-beta.0"
   },
   "files": [
     "lib",