@ton/appkit 0.0.2 → 0.0.3

package/dist/esm/utils/network/resolve-network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-network.d.ts","sourceRoot":"","sources":["../../../../src/utils/network/resolve-network.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIjD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,EAAE,UAAU,OAAO,KAAG,OAOlE,CAAC"}

package/dist/esm/utils/network/resolve-network.js

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { Network } from '../../types/network';
+import { getSelectedWallet } from '../../actions/wallets/get-selected-wallet';
+import { getDefaultNetwork } from '../../actions/network/get-default-network';
+/**
+ * Resolve the network to use for API requests.
+ *
+ * Priority:
+ * 1. Explicitly passed `network` parameter
+ * 2. Selected wallet's network
+ * 3. Configured default network
+ * 4. Mainnet (last resort)
+ */
+export const resolveNetwork = (appKit, network) => {
+    if (network)
+        return network;
+    const wallet = getSelectedWallet(appKit);
+    if (wallet)
+        return wallet.getNetwork();
+    return getDefaultNetwork(appKit) ?? Network.mainnet();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/appkit",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "",
   "repository": {
     "type": "git",
@@ -53,7 +53,7 @@
     }
   },
   "dependencies": {
-    "@ton/walletkit": "0.0.9"
+    "@ton/walletkit": "0.0.10"
   },
   "peerDependencies": {
     "@tanstack/query-core": ">=5.0.0",

package/src/actions/balances/get-balance-by-address.ts

@@ -7,10 +7,11 @@
  */
 
 import { Address } from '@ton/core';
-import type { TokenAmount } from '@ton/walletkit';
-import { Network, formatUnits } from '@ton/walletkit';
+import type { TokenAmount, Network } from '@ton/walletkit';
+import { formatUnits } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
 
 export interface GetBalanceByAddressOptions {
     address: string | Address;
@@ -26,7 +27,7 @@ export const getBalanceByAddress = async (
     const { address, network } = options;
     const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
     const balance = await client.getBalance(addressString);
 
     return formatUnits(balance, 9);

package/src/actions/balances/get-balance.ts

@@ -6,11 +6,12 @@
  *
  */
 
-import type { TokenAmount, Network } from '@ton/walletkit';
+import type { TokenAmount } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
 import { getBalanceByAddress } from './get-balance-by-address';
+import type { Network } from '../../types/network';
 
 export interface GetBalanceOptions {
     network?: Network;
@@ -27,6 +28,6 @@ export const getBalance = async (appKit: AppKit, options: GetBalanceOptions = {}
 
     return getBalanceByAddress(appKit, {
         address: selectedWallet.getAddress(),
-        network: options.network,
+        network: options.network ?? selectedWallet.getNetwork(),
     });
 };

package/src/actions/connectors/connect.ts

@@ -7,6 +7,7 @@
  */
 
 import type { AppKit } from '../../core/app-kit';
+import { getDefaultNetwork } from '../network/get-default-network';
 
 export type ConnectParameters = {
     connectorId: string;
@@ -25,5 +26,6 @@ export const connect = async (appKit: AppKit, parameters: ConnectParameters): Pr
         throw new Error(`Connector with id "${connectorId}" not found`);
     }
 
-    await connector.connectWallet();
+    const network = getDefaultNetwork(appKit);
+    await connector.connectWallet(network);
 };

package/src/actions/index.ts

@@ -68,6 +68,17 @@ export {
 export { getNetworks, type GetNetworksReturnType } from './network/get-networks';
 export { getNetwork, type GetNetworkReturnType } from './network/get-network';
 export { watchNetworks, type WatchNetworksParameters, type WatchNetworksReturnType } from './network/watch-networks';
+export { getDefaultNetwork, type GetDefaultNetworkReturnType } from './network/get-default-network';
+export {
+    setDefaultNetwork,
+    type SetDefaultNetworkParameters,
+    type SetDefaultNetworkReturnType,
+} from './network/set-default-network';
+export {
+    watchDefaultNetwork,
+    type WatchDefaultNetworkParameters,
+    type WatchDefaultNetworkReturnType,
+} from './network/watch-default-network';
 
 // NFT
 export {

package/src/actions/jettons/get-jetton-balance.ts

@@ -6,11 +6,13 @@
  *
  */
 
-import { Network, getJettonBalanceFromClient, formatUnits } from '@ton/walletkit';
+import { getJettonBalanceFromClient, formatUnits } from '@ton/walletkit';
 import type { TokenAmount, UserFriendlyAddress } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
 import { getJettonWalletAddress } from './get-jetton-wallet-address';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+import type { Network } from '../../types/network';
 
 export interface GetJettonBalanceOptions {
     jettonAddress: UserFriendlyAddress;
@@ -27,7 +29,7 @@ export const getJettonBalance = async (
 ): Promise<GetJettonBalanceReturnType> => {
     const { jettonAddress, ownerAddress, jettonDecimals, network } = options;
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
 
     const jettonWalletAddress = await getJettonWalletAddress(appKit, {
         jettonAddress,

package/src/actions/jettons/get-jetton-info.ts

@@ -7,9 +7,10 @@
  */
 
 import type { JettonInfo } from '@ton/walletkit';
-import { Network } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+import type { Network } from '../../types/network';
 
 export interface GetJettonInfoOptions {
     address: string;
@@ -24,7 +25,7 @@ export const getJettonInfo = async (
 ): Promise<GetJettonInfoReturnType> => {
     const { address, network } = options;
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
 
     const response = await client.jettonsByAddress({
         address: address,

package/src/actions/jettons/get-jetton-wallet-address.ts

@@ -6,10 +6,12 @@
  *
  */
 
-import { Network, getJettonWalletAddressFromClient } from '@ton/walletkit';
+import { getJettonWalletAddressFromClient } from '@ton/walletkit';
 import type { UserFriendlyAddress } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+import type { Network } from '../../types/network';
 
 export interface GetJettonWalletAddressOptions {
     jettonAddress: UserFriendlyAddress;
@@ -25,7 +27,7 @@ export const getJettonWalletAddress = async (
 ): Promise<GetJettonWalletAddressReturnType> => {
     const { jettonAddress, ownerAddress, network } = options;
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
 
     return getJettonWalletAddressFromClient(client, jettonAddress, ownerAddress);
 };

package/src/actions/jettons/get-jettons-by-address.ts

@@ -8,9 +8,11 @@
 
 import { Address } from '@ton/core';
 import type { Jetton, JettonsResponse } from '@ton/walletkit';
-import { Network, getJettonsFromClient, formatUnits } from '@ton/walletkit';
+import { getJettonsFromClient, formatUnits } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+import type { Network } from '../../types/network';
 
 export interface GetJettonsByAddressOptions {
     address: string | Address;
@@ -28,7 +30,7 @@ export const getJettonsByAddress = async (
     const { address, network, limit, offset } = options;
     const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
     const response = await getJettonsFromClient(client, addressString, {
         pagination: {
             limit,

package/src/actions/jettons/get-jettons.ts

@@ -6,11 +6,12 @@
  *
  */
 
-import type { JettonsResponse, Network } from '@ton/walletkit';
+import type { JettonsResponse } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
 import { getJettonsByAddress } from './get-jettons-by-address';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
+import type { Network } from '../../types/network';
 
 export interface GetJettonsOptions {
     network?: Network;

package/src/actions/network/get-default-network.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import type { Network } from '../../types/network';
+import type { AppKit } from '../../core/app-kit';
+
+export type GetDefaultNetworkReturnType = Network | undefined;
+
+/**
+ * Get the current default network
+ */
+export const getDefaultNetwork = (appKit: AppKit): GetDefaultNetworkReturnType => {
+    return appKit.networkManager.getDefaultNetwork();
+};

package/src/actions/network/get-network.ts

@@ -6,8 +6,7 @@
  *
  */
 
-import type { Network } from '@ton/walletkit';
-
+import type { Network } from '../../types/network';
 import type { AppKit } from '../../core/app-kit';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
 

package/src/actions/network/get-networks.ts

@@ -6,8 +6,7 @@
  *
  */
 
-import type { Network } from '@ton/walletkit';
-
+import type { Network } from '../../types/network';
 import type { AppKit } from '../../core/app-kit';
 
 export type GetNetworksReturnType = Network[];

package/src/actions/network/set-default-network.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import type { Network } from '../../types/network';
+import type { AppKit } from '../../core/app-kit';
+
+export type SetDefaultNetworkParameters = {
+    network: Network | undefined;
+};
+
+export type SetDefaultNetworkReturnType = void;
+
+/**
+ * Set the default network for wallet connections.
+ * If set, connectors will enforce this network when connecting.
+ * Set to `undefined` to allow any network.
+ */
+export const setDefaultNetwork = (
+    appKit: AppKit,
+    parameters: SetDefaultNetworkParameters,
+): SetDefaultNetworkReturnType => {
+    appKit.networkManager.setDefaultNetwork(parameters.network);
+};

package/src/actions/network/watch-default-network.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import type { Network } from '../../types/network';
+import type { AppKit } from '../../core/app-kit';
+import { getDefaultNetwork } from './get-default-network';
+import { NETWORKS_EVENTS } from '../../core/app-kit';
+
+export type WatchDefaultNetworkParameters = {
+    onChange: (network: Network | undefined) => void;
+};
+
+export type WatchDefaultNetworkReturnType = () => void;
+
+/**
+ * Watch default network changes
+ */
+export const watchDefaultNetwork = (
+    appKit: AppKit,
+    parameters: WatchDefaultNetworkParameters,
+): WatchDefaultNetworkReturnType => {
+    const { onChange } = parameters;
+
+    const unsubscribe = appKit.emitter.on(NETWORKS_EVENTS.DEFAULT_CHANGED, () => {
+        onChange(getDefaultNetwork(appKit));
+    });
+
+    return unsubscribe;
+};

package/src/actions/network/watch-networks.ts

@@ -6,8 +6,7 @@
  *
  */
 
-import type { Network } from '@ton/walletkit';
-
+import type { Network } from '../../types/network';
 import { getNetworks } from './get-networks';
 import type { AppKit } from '../../core/app-kit';
 import { NETWORKS_EVENTS } from '../../core/app-kit';

package/src/actions/nft/get-nft.ts

@@ -7,10 +7,12 @@
  */
 
 import { Address } from '@ton/core';
-import type { NFT } from '@ton/walletkit';
-import { Network, getNftFromClient } from '@ton/walletkit';
+import { getNftFromClient } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+import type { Network } from '../../types/network';
+import type { NFT } from '../../types/nft';
 
 export interface GetNftOptions {
     address: string | Address;
@@ -23,7 +25,7 @@ export const getNft = async (appKit: AppKit, options: GetNftOptions): Promise<Ge
     const { address, network } = options;
     const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
 
     return getNftFromClient(client, addressString);
 };

package/src/actions/nft/get-nfts-by-address.ts

@@ -8,9 +8,11 @@
 
 import { Address } from '@ton/core';
 import type { NFTsResponse } from '@ton/walletkit';
-import { Network, getNftsFromClient } from '@ton/walletkit';
+import { getNftsFromClient } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+import type { Network } from '../../types/network';
 
 export interface GetNftsByAddressOptions {
     address: string | Address;
@@ -28,7 +30,7 @@ export const getNftsByAddress = async (
     const { address, network, limit, offset } = options;
     const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
 
     return getNftsFromClient(client, addressString, {
         pagination: {

package/src/actions/nft/get-nfts.ts

@@ -6,11 +6,12 @@
  *
  */
 
-import type { NFTsResponse, Network } from '@ton/walletkit';
+import type { NFTsResponse } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
 import { getNftsByAddress } from './get-nfts-by-address';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
+import type { Network } from '../../types/network';
 
 export interface GetNftsOptions {
     network?: Network;

package/src/actions/signing/sign-binary.ts

@@ -6,12 +6,12 @@
  *
  */
 
-import type { Network } from '@ton/walletkit';
-
+import type { Network } from '../../types/network';
 import type { AppKit } from '../../core/app-kit';
 import type { SignDataResponse } from '../../types/signing';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
 import type { Base64String } from '../../types/primitives';
+import { getDefaultNetwork } from '../network/get-default-network';
 
 export interface SignBinaryParameters {
     /** Binary data to sign (base64 encoded) */
@@ -39,7 +39,7 @@ export const signBinary = async (appKit: AppKit, parameters: SignBinaryParameter
     }
 
     return await wallet.signData({
-        network: parameters.network,
+        network: parameters.network ?? getDefaultNetwork(appKit),
         data: {
             type: 'binary',
             value: { content: parameters.bytes },

package/src/actions/signing/sign-cell.ts

@@ -6,12 +6,12 @@
  *
  */
 
-import type { Network } from '@ton/walletkit';
-
+import type { Network } from '../../types/network';
 import type { AppKit } from '../../core/app-kit';
 import type { SignDataResponse } from '../../types/signing';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
 import type { Base64String } from '../../types/primitives';
+import { getDefaultNetwork } from '../network/get-default-network';
 
 export interface SignCellParameters {
     /** Base64 encoded Bag of Cells */
@@ -45,7 +45,7 @@ export const signCell = async (appKit: AppKit, parameters: SignCellParameters):
     }
 
     return await wallet.signData({
-        network: parameters.network,
+        network: parameters.network ?? getDefaultNetwork(appKit),
         data: {
             type: 'cell',
             value: {

package/src/actions/signing/sign-text.ts

@@ -6,11 +6,11 @@
  *
  */
 
-import type { Network } from '@ton/walletkit';
-
+import type { Network } from '../../types/network';
 import type { AppKit } from '../../core/app-kit';
 import type { SignDataResponse } from '../../types/signing';
 import { getSelectedWallet } from '../wallets/get-selected-wallet';
+import { getDefaultNetwork } from '../network/get-default-network';
 
 export interface SignTextParameters {
     /** Text message to sign */
@@ -38,7 +38,7 @@ export const signText = async (appKit: AppKit, parameters: SignTextParameters):
     }
 
     return await wallet.signData({
-        network: parameters.network,
+        network: parameters.network ?? getDefaultNetwork(appKit),
         data: {
             type: 'text',
             value: { content: parameters.text },

package/src/actions/transaction/get-transaction-status.ts

@@ -10,7 +10,8 @@ import type { TransactionStatusResponse } from '@ton/walletkit';
 import { getTransactionStatus as walletKitGetTransactionStatus } from '@ton/walletkit';
 
 import type { AppKit } from '../../core/app-kit';
-import { Network } from '../../types/network';
+import type { Network } from '../../types/network';
+import { resolveNetwork } from '../../utils/network/resolve-network';
 
 export type GetTransactionStatusParameters = {
     /** Network to check the transaction on */
@@ -56,7 +57,7 @@ export const getTransactionStatus = async (
 ): Promise<GetTransactionStatusReturnType> => {
     const { boc, normalizedHash, network } = parameters;
 
-    const client = appKit.networkManager.getClient(network ?? Network.mainnet());
+    const client = appKit.networkManager.getClient(resolveNetwork(appKit, network));
 
     if (boc) {
         return walletKitGetTransactionStatus(client, { boc });

package/src/connectors/tonconnect/adapters/ton-connect-wallet-adapter.ts

@@ -10,7 +10,7 @@ import { Address } from '@ton/core';
 import type { Wallet as TonConnectWallet } from '@tonconnect/sdk';
 import type { SignDataPayload as TonConnectSignDataPayload } from '@tonconnect/sdk';
 import type { SendTransactionResponse, UserFriendlyAddress, Hex } from '@ton/walletkit';
-import { Network, asHex, createWalletId, getNormalizedExtMessageHash } from '@ton/walletkit';
+import { asHex, createWalletId, getNormalizedExtMessageHash } from '@ton/walletkit';
 import type { TonConnectUI } from '@tonconnect/ui';
 
 import type { TransactionRequest } from '../../../types/transaction';
@@ -18,6 +18,7 @@ import type { Base64String } from '../../../types/primitives';
 import { getValidUntil } from '../utils/transaction';
 import type { WalletInterface } from '../../../types/wallet';
 import type { SignDataRequest, SignDataResponse } from '../../../types/signing';
+import { Network } from '../../../types/network';
 
 /**
  * Configuration for TonConnectWalletAdapter

package/src/connectors/tonconnect/connectors/ton-connect-connector.ts

@@ -9,12 +9,14 @@
 import { TonConnectUI } from '@tonconnect/ui';
 import type { TonConnectUiCreateOptions } from '@tonconnect/ui';
 
+import type { Network } from '../../../types/network';
 import { TonConnectWalletAdapter } from '../adapters/ton-connect-wallet-adapter';
-import { CONNECTOR_EVENTS } from '../../../core/app-kit';
+import { CONNECTOR_EVENTS, NETWORKS_EVENTS } from '../../../core/app-kit';
 import type { Connector, ConnectorMetadata } from '../../../types/connector';
 import type { WalletInterface } from '../../../types/wallet';
 import type { AppKitEmitter } from '../../../core/app-kit';
 import { TONCONNECT_DEFAULT_CONNECTOR_ID } from '../constants/id';
+import type { AppKitNetworkManager } from '../../../core/network';
 
 export interface TonConnectConnectorConfig {
     id?: string;
@@ -49,7 +51,7 @@ export class TonConnectConnector implements Connector {
         };
     }
 
-    async initialize(emitter: AppKitEmitter): Promise<void> {
+    async initialize(emitter: AppKitEmitter, networkManager: AppKitNetworkManager): Promise<void> {
         this.emitter = emitter;
 
         // Subscribe to TonConnect status changes
@@ -63,6 +65,12 @@ export class TonConnectConnector implements Connector {
             }
         });
 
+        // Set default network and subscribe to changes
+        this.tonConnectUI.setConnectionNetwork(networkManager.getDefaultNetwork()?.chainId);
+        this.emitter?.on(NETWORKS_EVENTS.DEFAULT_CHANGED, ({ payload }) => {
+            this.tonConnectUI.setConnectionNetwork(payload.network?.chainId);
+        });
+
         // Restore existing connection
         await this.tonConnectUI.connector.restoreConnection();
     }
@@ -73,7 +81,8 @@ export class TonConnectConnector implements Connector {
         this.emitter = null;
     }
 
-    async connectWallet(): Promise<void> {
+    async connectWallet(network?: Network): Promise<void> {
+        this.tonConnectUI.setConnectionNetwork(network?.chainId);
         await this.tonConnectUI.openModal();
     }
 

package/src/core/app-kit/constants/events.ts

@@ -27,6 +27,7 @@ export const WALLETS_EVENTS = {
  */
 export const NETWORKS_EVENTS = {
     UPDATED: 'networks:updated',
+    DEFAULT_CHANGED: 'networks:default-changed',
 } as const;
 
 /**

package/src/core/app-kit/index.ts

@@ -16,4 +16,5 @@ export type {
     WalletConnectedPayload,
     WalletDisconnectedPayload,
     PluginRegisteredPayload,
+    DefaultNetworkChangedPayload,
 } from './types/events';

package/src/core/app-kit/services/app-kit.ts

@@ -6,8 +6,7 @@
  *
  */
 
-import type { NetworkManager } from '@ton/walletkit';
-import { Network, SwapManager } from '@ton/walletkit';
+import { SwapManager } from '@ton/walletkit';
 import type { Provider } from 'src/types/provider';
 
 import type { AppKitConfig } from '../types/config';
@@ -17,7 +16,8 @@ import { CONNECTOR_EVENTS, WALLETS_EVENTS } from '../constants/events';
 import type { AppKitEmitter, AppKitEvents } from '../types/events';
 import type { WalletInterface } from '../../../types/wallet';
 import { WalletsManager } from '../../wallets-manager';
-import { AppKitNetworkManager } from './app-kit-network-manager';
+import { AppKitNetworkManager } from '../../network';
+import { Network } from '../../../types/network';
 
 /**
  * Central hub for wallet management.
@@ -29,7 +29,7 @@ export class AppKit {
     readonly walletsManager: WalletsManager;
     readonly swapManager: SwapManager;
 
-    readonly networkManager: NetworkManager;
+    readonly networkManager: AppKitNetworkManager;
     readonly config: AppKitConfig;
 
     constructor(config: AppKitConfig) {

package/src/core/app-kit/types/config.ts

@@ -10,6 +10,7 @@ import type { NetworkAdapters } from '@ton/walletkit';
 
 import type { Connector } from '../../../types/connector';
 import type { Provider } from '../../../types/provider';
+import type { Network } from '../../../types/network';
 
 /**
  * Configuration for AppKit
@@ -23,6 +24,14 @@ export interface AppKitConfig {
      * Values contain apiClient configuration (url and optional API key)
      */
     networks?: NetworkAdapters;
+
+    /**
+     * Default network for wallet connections.
+     * If set, connectors (e.g. TonConnect) will enforce this network when connecting.
+     * Set to `undefined` to allow any network.
+     */
+    defaultNetwork?: Network;
+
     connectors?: Connector[];
     providers?: Provider[];
 }