@ton/appkit 0.0.5-alpha.1 → 0.0.5-alpha.2

package/dist/esm/queries/transaction/get-transaction-status.js

@@ -6,7 +6,10 @@
  *
  */
 import { getTransactionStatus } from '../../actions/transaction/get-transaction-status';
-export const getTransactionStatusQueryOptions = (appKit, options) => {
+import { resolveNetwork } from '../../utils';
+export const getTransactionStatusQueryOptions = (appKit, initialOptions) => {
+    const network = resolveNetwork(appKit, initialOptions.network);
+    const options = { ...initialOptions, network };
     return {
         ...options.query,
         queryFn: () => {

package/dist/esm/staking/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ *
+ */
+export { StakingProvider, UnstakeMode, StakingError, StakingManager } from '@ton/walletkit';
+export type { UnstakeModes, StakeParams, StakingAPI, StakingQuote, StakingQuoteParams, StakingBalance, StakingProviderInfo, StakingProviderInterface, StakingQuoteDirection, } from '@ton/walletkit';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/staking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/staking/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5F,YAAY,EACR,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/esm/staking/index.js

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ *
+ */
+export { StakingProvider, UnstakeMode, StakingError, StakingManager } from '@ton/walletkit';

package/dist/esm/staking/tonstakers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ *
+ */
+export * from '@ton/walletkit/staking/tonstakers';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/staking/tonstakers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/staking/tonstakers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mCAAmC,CAAC"}

package/dist/esm/staking/tonstakers/index.js

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ *
+ */
+export * from '@ton/walletkit/staking/tonstakers';

package/dist/esm/types/connector.d.ts

@@ -15,11 +15,9 @@ import type { Network } from './network';
 export interface Connector {
     /** Provider unique identifier */
     readonly id: string;
-    /** Protocol type (e.g. 'tonconnect', 'ledger', 'mnemonic') */
+    /** Protocol type (e.g. 'tonconnect') */
     readonly type: string;
     readonly metadata: ConnectorMetadata;
-    /** Initialize connector (restore connections, setup event listeners) */
-    initialize(emitter: AppKitEmitter, networkManager: AppKitNetworkManager): Promise<void>;
     /** Cleanup connector resources */
     destroy(): void;
     /** Connect a wallet */
@@ -33,4 +31,18 @@ export interface ConnectorMetadata {
     name: string;
     iconUrl?: string;
 }
+/**
+ * Context passed to connector factory functions.
+ */
+export interface ConnectorFactoryContext {
+    networkManager: AppKitNetworkManager;
+    eventEmitter: AppKitEmitter;
+    ssr?: boolean;
+}
+/** Factory function that creates a connector from context */
+export type ConnectorFactory = (ctx: ConnectorFactoryContext) => Connector;
+/** A connector instance or a factory that creates one */
+export type ConnectorInput = Connector | ConnectorFactory;
+/** Helper for creating typed connector factories */
+export declare function createConnector(factory: ConnectorFactory): ConnectorFactory;
 //# sourceMappingURL=connector.d.ts.map

package/dist/esm/types/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,wEAAwE;IACxE,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAEhB,uBAAuB;IACvB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,0BAA0B;IAC1B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,4BAA4B;IAC5B,mBAAmB,IAAI,eAAe,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAEhB,uBAAuB;IACvB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,0BAA0B;IAC1B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,4BAA4B;IAC5B,mBAAmB,IAAI,eAAe,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,EAAE,aAAa,CAAC;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,uBAAuB,KAAK,SAAS,CAAC;AAE3E,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAE1D,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E"}

package/dist/esm/types/connector.js

@@ -5,4 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export {};
+/** Helper for creating typed connector factories */
+export function createConnector(factory) {
+    return factory;
+}

package/dist/esm/types/provider.d.ts

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-import type { SwapProviderInterface } from '@ton/walletkit';
+import type { SwapProviderInterface, StakingProviderInterface } from '@ton/walletkit';
 /**
  * Provider configuration
  */
-export type Provider = SwapProviderInterface;
+export type Provider = SwapProviderInterface | StakingProviderInterface;
 //# sourceMappingURL=provider.d.ts.map

package/dist/esm/types/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/types/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/types/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,qBAAqB,GAAG,wBAAwB,CAAC"}

package/dist/esm/utils/index.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export { formatUnits, parseUnits } from '@ton/walletkit';
+export { formatUnits, parseUnits, compareAddress } from '@ton/walletkit';
 export * from './amount/validate-numeric-string';
 export * from './arrays/key-by';
 export * from './arrays/random-from-array';

package/dist/esm/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEzE,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/dist/esm/utils/index.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export { formatUnits, parseUnits } from '@ton/walletkit';
+export { formatUnits, parseUnits, compareAddress } from '@ton/walletkit';
 export * from './amount/validate-numeric-string';
 export * from './arrays/key-by';
 export * from './arrays/random-from-array';

package/docs/actions.md

@@ -32,6 +32,35 @@ const balanceByAddress = await getBalanceByAddress(appKit, {
 console.log('Balance by address:', balanceByAddress.toString());
 ```
 
+### `watchBalance`
+
+Watch the TON balance of the currently selected wallet in real-time.
+
+```ts
+const unsubscribe = watchBalance(appKit, {
+    onChange: (update) => {
+        console.log('Balance updated:', update.balance);
+    },
+});
+
+// Later: unsubscribe();
+```
+
+### `watchBalanceByAddress`
+
+Watch the TON balance of a specific address in real-time.
+
+```ts
+const unsubscribe = watchBalanceByAddress(appKit, {
+    address: 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c',
+    onChange: (update) => {
+        console.log('Balance by address updated:', update.balance);
+    },
+});
+
+// Later: unsubscribe();
+```
+
 ## Connectors
 
 ### `connect`
@@ -51,7 +80,7 @@ Add a wallet connector to AppKit (e.g., TonConnect).
 ```ts
 const stopWatching = addConnector(
     appKit,
-    new TonConnectConnector({
+    createTonConnectConnector({
         tonConnectOptions: {
             manifestUrl: 'https://tonconnect-sdk-demo-dapp.vercel.app/tonconnect-manifest.json',
         },
@@ -260,6 +289,18 @@ const networks = getNetworks(appKit);
 console.log('Configured networks:', networks);
 ```
 
+### `getApiClient`
+
+Get the API client for a specific network.
+
+```ts
+const apiClient = getApiClient(appKit, {
+    network: Network.mainnet(),
+});
+
+console.log('API Client:', apiClient);
+```
+
 ### `watchNetworks`
 
 Watch configured networks.
@@ -274,6 +315,15 @@ const unsubscribe = watchNetworks(appKit, {
 // Later: unsubscribe();
 ```
 
+### `hasStreamingProvider`
+
+Check if a real-time streaming provider is registered for a specific network.
+
+```ts
+const isSupported = hasStreamingProvider(appKit, Network.mainnet());
+console.log('Mainnet streaming support:', isSupported);
+```
+
 ### `getBlockNumber`
 
 Get the current masterchain block number.
@@ -352,7 +402,7 @@ Get information about a specific NFT by its address.
 
 ```ts
 const nft = await getNft(appKit, {
-    address: 'EQCA14o1-VWhS29szfbpmbu_m7A_9S4m_Ba6sAyALH_mU68j',
+    address: 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c',
 });
 
 if (nft) {
@@ -367,7 +417,7 @@ Create a transaction for transferring a NFT without sending it.
 
 ```ts
 const tx = await createTransferNftTransaction(appKit, {
-    nftAddress: 'EQCA14o1-VWhS29szfbpmbu_m7A_9S4m_Ba6sAyALH_mU68j',
+    nftAddress: 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c',
     recipientAddress: 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c',
     comment: 'Gift NFT',
 });
@@ -381,7 +431,7 @@ Transfer a NFT to a recipient address.
 
 ```ts
 const result = await transferNft(appKit, {
-    nftAddress: 'EQCA14o1-VWhS29szfbpmbu_m7A_9S4m_Ba6sAyALH_mU68j',
+    nftAddress: 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c',
     recipientAddress: 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c',
 });
 
@@ -392,7 +442,7 @@ console.log('NFT Transfer Result:', result);
 
 ### `registerProvider`
 
-Register a custom token swap provider in AppKit (e.g., Omniston).
+Register a custom provider in AppKit (e.g., Swap or Streaming).
 
 ```ts
 const omnistonProvider = new OmnistonSwapProvider({
@@ -483,6 +533,63 @@ const transactionResponse = await sendTransaction(appKit, transactionRequest);
 console.log('Swap Transaction:', transactionResponse);
 ```
 
+## Staking
+
+### `getStakingProviders`
+
+Get all available staking provider IDs.
+
+```ts
+const providers = await getStakingProviders(appKit);
+console.log('Available Staking Providers:', providers);
+```
+
+### `getStakingProviderInfo`
+
+Get information about a specific staking provider.
+
+```ts
+const providerInfo = await getStakingProviderInfo(appKit, {
+    providerId: 'tonstakers',
+});
+console.log('Provider Info:', providerInfo);
+```
+
+### `getStakingQuote`
+
+Get a staking or unstaking quote.
+
+```ts
+const quote = await getStakingQuote(appKit, {
+    amount: '1000000000',
+    direction: 'stake',
+});
+console.log('Staking Quote:', quote);
+```
+
+### `buildStakeTransaction`
+
+Build a stake transaction based on a quote.
+
+```ts
+const txRequest = await buildStakeTransaction(appKit, {
+    quote,
+    userAddress,
+});
+console.log('Stake Transaction:', txRequest);
+```
+
+### `getStakedBalance`
+
+Get the user's staked balance.
+
+```ts
+const balance = await getStakedBalance(appKit, {
+    userAddress,
+});
+console.log('Staked Balance:', balance);
+```
+
 ## Transaction
 
 ### `createTransferTonTransaction`

package/docs/connectors.md

@@ -41,7 +41,7 @@ const appKit = new AppKit({
         },
     },
     connectors: [
-        new TonConnectConnector({
+        createTonConnectConnector({
             tonConnectOptions: {
                 manifestUrl: 'https://my-app.com/tonconnect-manifest.json',
             },
@@ -68,7 +68,7 @@ const appKit = new AppKit({
             },
         },
     },
-    connectors: [new TonConnectConnector({ tonConnectUI })],
+    connectors: [createTonConnectConnector({ tonConnectUI })],
 });
 ```
 
@@ -89,8 +89,8 @@ const appKit = new AppKit({
     },
 });
 
-// 2. Initialize TonConnect connector
-const connector = new TonConnectConnector({
+// 2. Initialize TonConnect connector function
+const connector = createTonConnectConnector({
     tonConnectOptions: {
         manifestUrl: 'https://my-app.com/tonconnect-manifest.json',
     },

package/docs/staking.md

@@ -0,0 +1,58 @@
+<!--
+This file is auto-generated. Do not edit manually.
+Changes will be overwritten when running the docs update script.
+Source template: template/packages/appkit/docs/staking.md
+-->
+
+# Staking
+
+AppKit supports staking through various providers. Available providers:
+
+- **createTonstakersProvider** – [Tonstakers](https://tonstakers.com) liquid staking (`TonStakersStakingProvider` instance type)
+
+## Installation
+
+Staking providers are included in the `@ton/appkit` package. No extra dependencies are required.
+
+## Setup
+
+You can set up staking providers by passing them to the `AppKit` constructor.
+
+```ts
+// Initialize AppKit with staking providers
+const network = Network.mainnet();
+const toncenterApiClient = new ApiClientToncenter({ network });
+const appKit = new AppKit({
+    networks: {
+        [network.chainId]: {
+            apiClient: toncenterApiClient,
+        },
+    },
+    providers: [createTonstakersProvider()],
+});
+```
+
+### Register Dynamically
+
+Alternatively, you can register providers dynamically using `registerProvider`:
+
+```ts
+// 1. Initialize AppKit
+const appKit = new AppKit({
+    networks: {
+        [Network.mainnet().chainId]: {
+            apiClient: {
+                url: 'https://toncenter.com',
+                key: 'your-key',
+            },
+        },
+    },
+});
+
+// 2. Register staking providers
+registerProvider(appKit, createTonstakersProvider());
+```
+
+## Configuration
+
+- **Tonstakers**: [Tonstakers documentation](https://docs.tonstakers.com) and [provider README](https://github.com/ton-connect/kit/blob/main/packages/walletkit/src/defi/staking/tonstakers/README.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/appkit",
-  "version": "0.0.5-alpha.1",
+  "version": "0.0.5-alpha.2",
   "description": "",
   "repository": {
     "type": "git",
@@ -50,23 +50,36 @@
         "types": "./dist/cjs/swap/dedust/index.d.ts",
         "default": "./dist/cjs/swap/dedust/index.js"
       }
+    },
+    "./staking/tonstakers": {
+      "import": {
+        "types": "./dist/esm/staking/tonstakers/index.d.ts",
+        "default": "./dist/esm/staking/tonstakers/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/staking/tonstakers/index.d.ts",
+        "default": "./dist/cjs/staking/tonstakers/index.js"
+      }
     }
   },
   "typesVersions": {
     "*": {
       "queries": [
-        "./dist/cjs/queries/index.d.ts"
+        "./dist/esm/queries/index.d.ts"
       ],
       "swap/omniston": [
-        "./dist/cjs/swap/omniston/index.d.ts"
+        "./dist/esm/swap/omniston/index.d.ts"
       ],
       "swap/dedust": [
-        "./dist/cjs/swap/dedust/index.d.ts"
+        "./dist/esm/swap/dedust/index.d.ts"
+      ],
+      "staking/tonstakers": [
+        "./dist/esm/staking/tonstakers/index.d.ts"
       ]
     }
   },
   "dependencies": {
-    "@ton/walletkit": "0.0.12-alpha.1"
+    "@ton/walletkit": "0.0.12-alpha.2"
   },
   "peerDependencies": {
     "@tanstack/query-core": ">=5.0.0",
@@ -89,11 +102,11 @@
   "author": "",
   "license": "ISC",
   "devDependencies": {
-    "@tanstack/query-core": "5.90.20",
-    "@ton/core": "^0.63.0",
-    "@tonconnect/ui": "2.4.1",
-    "typescript": "~5.8.3",
-    "vitest": "^4.0.17"
+    "@tanstack/query-core": "5.99.0",
+    "@ton/core": "0.63.1",
+    "@tonconnect/ui": "2.4.4",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "pnpm build:clean && pnpm build:cjs && pnpm build:esm",

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

@@ -0,0 +1,35 @@
+/**
+ * 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 { Address } from '@ton/core';
+import type { BalanceUpdate, Network } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+
+export interface WatchBalanceByAddressOptions {
+    address: string | Address;
+    network?: Network;
+    onChange: (update: BalanceUpdate) => void;
+}
+
+export type WatchBalanceByAddressReturnType = () => void;
+
+/**
+ * Watch account balance changes by address.
+ */
+export const watchBalanceByAddress = (
+    appKit: AppKit,
+    options: WatchBalanceByAddressOptions,
+): WatchBalanceByAddressReturnType => {
+    const { address, network, onChange } = options;
+    const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
+    const resolvedNetwork = resolveNetwork(appKit, network);
+
+    return appKit.streamingManager.watchBalance(resolvedNetwork, addressString, onChange);
+};

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

@@ -0,0 +1,56 @@
+/**
+ * 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 { BalanceUpdate, Network } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+import { WALLETS_EVENTS } from '../../core/app-kit';
+import { getSelectedWallet } from '../wallets/get-selected-wallet';
+import { watchBalanceByAddress } from './watch-balance-by-address';
+
+export interface WatchBalanceOptions {
+    network?: Network;
+    onChange: (update: BalanceUpdate) => void;
+}
+
+export type WatchBalanceReturnType = () => void;
+
+/**
+ * Watch account balance changes for the selected wallet.
+ */
+export const watchBalance = (appKit: AppKit, options: WatchBalanceOptions): WatchBalanceReturnType => {
+    const { network, onChange } = options;
+    let unsubscribe: (() => void) | null = null;
+
+    const updateSubscription = () => {
+        if (unsubscribe) {
+            unsubscribe();
+            unsubscribe = null;
+        }
+
+        const selectedWallet = getSelectedWallet(appKit);
+        if (selectedWallet) {
+            unsubscribe = watchBalanceByAddress(appKit, {
+                address: selectedWallet.getAddress(),
+                network: network ?? selectedWallet.getNetwork(),
+                onChange,
+            });
+        }
+    };
+
+    const off = appKit.emitter.on(WALLETS_EVENTS.SELECTION_CHANGED, updateSubscription);
+    const offUpdate = appKit.emitter.on(WALLETS_EVENTS.UPDATED, updateSubscription);
+
+    updateSubscription();
+
+    return () => {
+        if (unsubscribe) unsubscribe();
+        off();
+        offUpdate();
+    };
+};

package/src/actions/connectors/add-connector.ts

@@ -7,15 +7,15 @@
  */
 
 import type { AppKit } from '../../core/app-kit';
-import type { Connector } from '../../types/connector';
+import type { ConnectorInput } from '../../types/connector';
 
-export type AddConnectorParameters = Connector;
+export type AddConnectorParameters = ConnectorInput;
 
 export type AddConnectorReturnType = () => void;
 
 /**
  * Add a wallet connector
  */
-export const addConnector = (appKit: AppKit, connector: AddConnectorParameters): AddConnectorReturnType => {
-    return appKit.addConnector(connector);
+export const addConnector = (appKit: AppKit, connectorFn: AddConnectorParameters): AddConnectorReturnType => {
+    return appKit.addConnector(connectorFn);
 };