@ton/appkit 0.0.5-alpha.3 → 1.0.0-alpha.1

package/src/core/cache/adapters/lru-app-kit-cache.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 { LRUCache } from 'lru-cache';
+
+import type { AppKitCache } from '../types/app-kit-cache';
+
+export class LruAppKitCache implements AppKitCache {
+    private readonly cache: LRUCache<string, { value: unknown }>;
+
+    constructor(options?: { max?: number; ttl?: number }) {
+        this.cache = new LRUCache({
+            max: options?.max ?? 1000,
+            ttl: options?.ttl ?? 1000 * 60 * 10,
+        });
+    }
+
+    async get<T = unknown>(key: string): Promise<T | undefined> {
+        return this.cache.get(key)?.value as T | undefined;
+    }
+
+    async set(key: string, value: unknown): Promise<void> {
+        this.cache.set(key, { value });
+    }
+
+    async remove(key: string): Promise<void> {
+        this.cache.delete(key);
+    }
+
+    async clear(): Promise<void> {
+        this.cache.clear();
+    }
+}

package/src/core/cache/index.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { LruAppKitCache } from './adapters/lru-app-kit-cache';
+export { getCacheKey } from './utils/get-cache-key';
+
+export type { AppKitCache } from './types/app-kit-cache';

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

@@ -0,0 +1,14 @@
+/**
+ * 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 interface AppKitCache {
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set(key: string, value: unknown): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/src/core/cache/utils/get-cache-key.test.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 { describe, expect, it } from 'vitest';
+
+import { getCacheKey } from './get-cache-key';
+
+describe('getCacheKey', () => {
+    it('should build a key with a single param', () => {
+        const key = getCacheKey('jetton-info');
+        expect(key('EQabc')).toBe('jetton-info:EQabc');
+    });
+
+    it('should build a key with multiple params', () => {
+        const key = getCacheKey('jetton-info');
+        expect(key('mainnet', 'EQabc')).toBe('jetton-info:mainnet:EQabc');
+    });
+
+    it('should build a key with no params', () => {
+        const key = getCacheKey('jetton-info');
+        expect(key()).toBe('jetton-info:');
+    });
+
+    it('should scope keys independently per prefix', () => {
+        const infoKey = getCacheKey('jetton-info');
+        const walletKey = getCacheKey('jetton-wallet');
+        expect(infoKey('EQabc')).not.toBe(walletKey('EQabc'));
+    });
+});

package/src/core/cache/utils/get-cache-key.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 const getCacheKey =
+    (prefix: string) =>
+    (...params: string[]): string =>
+        `${prefix}:${params.join(':')}`;

package/src/index.ts

@@ -27,6 +27,7 @@
 
 // Core
 export * from './core/app-kit';
+export * from './core/cache';
 export * from './core/emitter';
 export * from './core/network';
 export * from './core/streaming';

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

@@ -13,7 +13,7 @@ import { getBalanceByAddress } from '../../actions/balances/get-balance-by-addre
 import type { GetBalanceByAddressOptions } from '../../actions/balances/get-balance-by-address';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork, sleep } from '../../utils';
+import { filterQueryOptions, resolveNetwork, sleep, tryToBounceableAddress } from '../../utils';
 import type { GetBalanceByAddressReturnType } from '../../actions/balances/get-balance-by-address';
 import type { BalanceUpdate } from '../../core/streaming';
 import type { Network } from '../../types/network';
@@ -32,7 +32,11 @@ export const getBalanceByAddressQueryOptions = <selectData = GetBalanceByAddress
     initialOptions: GetBalanceByAddressQueryConfig<selectData> = {},
 ): GetBalanceByAddressQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        address: tryToBounceableAddress(initialOptions.address) ?? initialOptions.address,
+    };
 
     return {
         ...options.query,
@@ -72,14 +76,17 @@ export const handleBalanceUpdate = (
     { address, network }: { address: string; network: Network },
     update: BalanceUpdate,
 ) => {
+    const queryKey = getBalanceByAddressQueryKey({
+        address: tryToBounceableAddress(address) ?? address,
+        network,
+    });
+
     if (update.status === 'finalized') {
-        const queryKey = getBalanceByAddressQueryKey({ address, network });
         queryClient.setQueryData(queryKey, update.balance);
         sleep(5000).then(() => queryClient.invalidateQueries({ queryKey }));
     }
 
     if (update.status === 'invalidated') {
-        const queryKey = getBalanceByAddressQueryKey({ address, network });
         queryClient.invalidateQueries({ queryKey });
     }
 };

package/src/queries/index.ts

@@ -166,12 +166,6 @@ export {
 } from './swap/build-swap-transaction';
 
 // Staking
-export {
-    getStakingProvidersQueryOptions,
-    type GetStakingProvidersData,
-    type GetStakingProvidersErrorType,
-    type GetStakingProvidersQueryConfig,
-} from './staking/get-staking-providers';
 export {
     getStakingQuoteQueryOptions,
     type GetStakingQuoteQueryConfig,

package/src/queries/jettons/get-jetton-balance-by-address.ts

@@ -14,7 +14,7 @@ import { getJettonBalance } from '../../actions/jettons/get-jetton-balance';
 import type { GetJettonBalanceOptions as GetJettonBalanceParameters } from '../../actions/jettons/get-jetton-balance';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork, sleep } from '../../utils';
+import { filterQueryOptions, resolveNetwork, sleep, tryToBounceableAddress } from '../../utils';
 import type { JettonUpdate } from '../../core/streaming';
 import type { Network } from '../../types/network';
 
@@ -37,7 +37,12 @@ export const getJettonBalanceByAddressQueryOptions = <selectData = GetJettonBala
     initialOptions: GetJettonBalanceByAddressQueryConfig<selectData> = {},
 ): GetJettonBalanceByAddressQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        jettonAddress: tryToBounceableAddress(initialOptions.jettonAddress) ?? initialOptions.jettonAddress,
+        ownerAddress: tryToBounceableAddress(initialOptions.ownerAddress) ?? initialOptions.ownerAddress,
+    };
 
     return {
         ...options.query,
@@ -82,22 +87,18 @@ export const handleJettonBalanceUpdate = (
     { ownerAddress, jettonAddress, network }: { ownerAddress: string; jettonAddress: string; network: Network },
     update: JettonUpdate,
 ) => {
+    const queryKey = getJettonBalanceByAddressQueryKey({
+        ownerAddress: tryToBounceableAddress(ownerAddress) ?? ownerAddress,
+        jettonAddress: tryToBounceableAddress(jettonAddress) ?? jettonAddress,
+        network,
+    });
+
     if (update.status === 'finalized') {
-        const queryKey = getJettonBalanceByAddressQueryKey({
-            ownerAddress,
-            jettonAddress,
-            network,
-        });
         queryClient.setQueryData(queryKey, update.balance);
         sleep(5000).then(() => queryClient.invalidateQueries({ queryKey }));
     }
 
     if (update.status === 'invalidated') {
-        const queryKey = getJettonBalanceByAddressQueryKey({
-            ownerAddress,
-            jettonAddress,
-            network,
-        });
         queryClient.invalidateQueries({ queryKey });
     }
 };

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

@@ -12,7 +12,7 @@ import type { GetJettonInfoOptions } from '../../actions/jettons/get-jetton-info
 import type { GetJettonInfoReturnType } from '../../actions/jettons/get-jetton-info';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork } from '../../utils';
+import { filterQueryOptions, resolveNetwork, tryToBounceableAddress } from '../../utils';
 
 export type GetJettonInfoErrorType = Error;
 
@@ -24,7 +24,11 @@ export const getJettonInfoQueryOptions = <selectData = GetJettonInfoData>(
     initialOptions: GetJettonInfoQueryConfig<selectData> = {},
 ): GetJettonInfoQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        address: tryToBounceableAddress(initialOptions.address) ?? initialOptions.address,
+    };
 
     return {
         ...options.query,

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

@@ -13,7 +13,7 @@ import { getJettonWalletAddress } from '../../actions/jettons/get-jetton-wallet-
 import type { GetJettonWalletAddressOptions as GetJettonWalletAddressParameters } from '../../actions/jettons/get-jetton-wallet-address';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork } from '../../utils';
+import { filterQueryOptions, resolveNetwork, tryToBounceableAddress } from '../../utils';
 
 export type GetJettonWalletAddressErrorType = Error;
 
@@ -32,7 +32,12 @@ export const getJettonWalletAddressQueryOptions = <selectData = GetJettonWalletA
     initialOptions: GetJettonWalletAddressQueryConfig<selectData> = {},
 ): GetJettonWalletAddressQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        jettonAddress: tryToBounceableAddress(initialOptions.jettonAddress) ?? initialOptions.jettonAddress,
+        ownerAddress: tryToBounceableAddress(initialOptions.ownerAddress) ?? initialOptions.ownerAddress,
+    };
 
     return {
         ...options.query,

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

@@ -13,7 +13,14 @@ import { getJettonsByAddress } from '../../actions/jettons/get-jettons-by-addres
 import type { GetJettonsByAddressOptions } from '../../actions/jettons/get-jettons-by-address';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork, compareAddress, formatUnits, sleep } from '../../utils';
+import {
+    filterQueryOptions,
+    resolveNetwork,
+    compareAddress,
+    formatUnits,
+    sleep,
+    tryToBounceableAddress,
+} from '../../utils';
 import type { GetJettonsByAddressReturnType } from '../../actions/jettons/get-jettons-by-address';
 import type { JettonUpdate } from '../../core/streaming';
 import type { Network } from '../../types/network';
@@ -32,7 +39,11 @@ export const getJettonsByAddressQueryOptions = <selectData = GetJettonsByAddress
     initialOptions: GetJettonsByAddressQueryConfig<selectData> = {},
 ): GetJettonsByAddressQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        address: tryToBounceableAddress(initialOptions.address) ?? initialOptions.address,
+    };
 
     return {
         ...options.query,
@@ -73,8 +84,12 @@ export const handleJettonsUpdate = (
     { address, network }: { address: string; network: Network },
     update: JettonUpdate,
 ) => {
+    const queryKey = getJettonsByAddressQueryKey({
+        address: tryToBounceableAddress(address) ?? address,
+        network,
+    });
+
     if (update.status === 'finalized') {
-        const queryKey = getJettonsByAddressQueryKey({ address, network });
         const currentData = queryClient.getQueryData(queryKey) as GetJettonsByAddressData | undefined;
 
         if (currentData?.jettons) {
@@ -99,7 +114,6 @@ export const handleJettonsUpdate = (
     }
 
     if (update.status === 'invalidated') {
-        const queryKey = getJettonsByAddressQueryKey({ address, network });
         queryClient.invalidateQueries({ queryKey });
     }
 };

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

@@ -13,7 +13,7 @@ import { getNft } from '../../actions/nft/get-nft';
 import type { GetNftOptions as GetNftParameters } from '../../actions/nft/get-nft';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork } from '../../utils';
+import { filterQueryOptions, resolveNetwork, tryToBounceableAddress } from '../../utils';
 
 export type GetNftErrorType = Error;
 
@@ -25,7 +25,11 @@ export const getNftQueryOptions = <selectData = GetNftData>(
     initialOptions: GetNftQueryConfig<selectData> = {},
 ): GetNftQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        address: tryToBounceableAddress(initialOptions.address) ?? initialOptions.address,
+    };
 
     return {
         ...options.query,
@@ -41,7 +45,7 @@ export const getNftQueryOptions = <selectData = GetNftData>(
     };
 };
 
-export type GetNftQueryFnData = Compute<NFT | null>;
+export type GetNftQueryFnData = Compute<NFT | undefined>;
 
 export type GetNftData = GetNftQueryFnData;
 

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

@@ -11,7 +11,7 @@ import { getNftsByAddress } from '../../actions/nft/get-nfts-by-address';
 import type { GetNftsByAddressOptions } from '../../actions/nft/get-nfts-by-address';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions, resolveNetwork } from '../../utils';
+import { filterQueryOptions, resolveNetwork, tryToBounceableAddress } from '../../utils';
 import type { GetNftsByAddressReturnType } from '../../actions/nft/get-nfts-by-address';
 
 export type GetNFTsErrorType = Error;
@@ -28,7 +28,11 @@ export const getNFTsByAddressQueryOptions = <selectData = GetNFTsByAddressData>(
     initialOptions: GetNFTsByAddressQueryConfig<selectData> = {},
 ): GetNFTsByAddressQueryOptions<selectData> => {
     const network = resolveNetwork(appKit, initialOptions.network);
-    const options = { ...initialOptions, network };
+    const options = {
+        ...initialOptions,
+        network,
+        address: tryToBounceableAddress(initialOptions.address) ?? initialOptions.address,
+    };
 
     return {
         ...options.query,

package/src/queries/staking/get-staked-balance.ts

@@ -12,7 +12,7 @@ import type { GetStakedBalanceReturnType } from '../../actions/staking/get-stake
 import type { AppKit } from '../../core/app-kit';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions } from '../../utils';
+import { filterQueryOptions, resolveNetwork, tryToBounceableAddress } from '../../utils';
 
 export type GetStakedBalanceErrorType = Error;
 
@@ -23,8 +23,15 @@ export type GetStakedBalanceQueryConfig<selectData = GetStakedBalanceData> = Com
 
 export const getStakedBalanceQueryOptions = <selectData = GetStakedBalanceData>(
     appKit: AppKit,
-    options: GetStakedBalanceQueryConfig<selectData> = {},
+    initialOptions: GetStakedBalanceQueryConfig<selectData> = {},
 ): GetStakedBalanceQueryOptions<selectData> => {
+    const network = resolveNetwork(appKit, initialOptions.network);
+    const options = {
+        ...initialOptions,
+        network,
+        userAddress: tryToBounceableAddress(initialOptions.userAddress) ?? initialOptions.userAddress,
+    };
+
     return {
         ...options.query,
         enabled: Boolean(options.userAddress && (options.query?.enabled ?? true)),
@@ -47,7 +54,7 @@ export type GetStakedBalanceData = GetStakedBalanceQueryFnData;
 export const getStakedBalanceQueryKey = (
     options: Compute<ExactPartial<GetStakedBalanceOptions>> = {},
 ): GetStakedBalanceQueryKey => {
-    return ['stakedBalance', filterQueryOptions(options as unknown as Record<string, unknown>)] as const;
+    return ['stakedBalance', filterQueryOptions(options)] as const;
 };
 
 export type GetStakedBalanceQueryKey = readonly ['stakedBalance', Compute<ExactPartial<GetStakedBalanceOptions>>];

package/src/queries/staking/get-staking-provider-info.ts

@@ -12,7 +12,7 @@ import type { GetStakingProviderInfoReturnType } from '../../actions/staking/get
 import type { AppKit } from '../../core/app-kit';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions } from '../../utils';
+import { filterQueryOptions, resolveNetwork } from '../../utils';
 
 export type GetStakingProviderInfoErrorType = Error;
 
@@ -28,8 +28,11 @@ export type GetStakingProviderInfoQueryConfig<selectData = GetStakingProviderInf
 
 export const getStakingProviderInfoQueryOptions = <selectData = GetStakingProviderInfoData>(
     appKit: AppKit,
-    options: GetStakingProviderInfoQueryConfig<selectData> = {},
+    initialOptions: GetStakingProviderInfoQueryConfig<selectData> = {},
 ): GetStakingProviderInfoQueryOptions<selectData> => {
+    const network = resolveNetwork(appKit, initialOptions.network);
+    const options = { ...initialOptions, network };
+
     return {
         ...options.query,
         queryFn: async (context) => {

package/src/queries/staking/get-staking-quote.ts

@@ -12,7 +12,7 @@ import type { GetStakingQuoteReturnType } from '../../actions/staking/get-stakin
 import type { AppKit } from '../../core/app-kit';
 import type { QueryOptions, QueryParameter } from '../../types/query';
 import type { Compute, ExactPartial } from '../../types/utils';
-import { filterQueryOptions } from '../../utils';
+import { filterQueryOptions, resolveNetwork, tryToBounceableAddress } from '../../utils';
 
 export type GetStakingQuoteErrorType = Error;
 
@@ -23,11 +23,20 @@ export type GetStakingQuoteQueryConfig<selectData = GetStakingQuoteData> = Compu
 
 export const getStakingQuoteQueryOptions = <selectData = GetStakingQuoteData>(
     appKit: AppKit,
-    options: GetStakingQuoteQueryConfig<selectData> = {},
+    initialOptions: GetStakingQuoteQueryConfig<selectData> = {},
 ): GetStakingQuoteQueryOptions<selectData> => {
+    const network = resolveNetwork(appKit, initialOptions.network);
+    const options = {
+        ...initialOptions,
+        network,
+        userAddress: tryToBounceableAddress(initialOptions.userAddress) ?? initialOptions.userAddress,
+    };
+
     return {
         ...options.query,
-        enabled: Boolean(options.amount && options.direction && (options.query?.enabled ?? true)),
+        enabled: Boolean(
+            options.amount && options.amount !== '0' && options.direction && (options.query?.enabled ?? true),
+        ),
         queryFn: async (context) => {
             const [, parameters] = context.queryKey as [string, GetStakingQuoteOptions];
             if (!parameters.amount || !parameters.direction) {
@@ -47,7 +56,7 @@ export type GetStakingQuoteData = GetStakingQuoteQueryFnData;
 export const getStakingQuoteQueryKey = (
     options: Compute<ExactPartial<GetStakingQuoteOptions>> = {},
 ): GetStakingQuoteQueryKey => {
-    return ['stakingQuote', filterQueryOptions(options as unknown as Record<string, unknown>)] as const;
+    return ['stakingQuote', filterQueryOptions(options)] as const;
 };
 
 export type GetStakingQuoteQueryKey = readonly ['stakingQuote', Compute<ExactPartial<GetStakingQuoteOptions>>];

package/src/queries/swap/get-swap-quote.ts

@@ -28,7 +28,9 @@ export const getSwapQuoteQueryOptions = <selectData = GetSwapQuoteData>(
 
     return {
         ...options.query,
-        enabled: Boolean(options.amount && options.from && options.to && (options.query?.enabled ?? true)),
+        enabled: Boolean(
+            options.amount && options.amount !== '0' && options.from && options.to && (options.query?.enabled ?? true),
+        ),
         queryFn: async (context) => {
             const [, parameters] = context.queryKey as [string, GetSwapQuoteOptions];
             if (!parameters.amount || !parameters.from || !parameters.to) {

package/src/staking/index.ts

@@ -6,7 +6,14 @@
  *
  */
 
-export { StakingProvider, UnstakeMode, StakingError, StakingManager } from '@ton/walletkit';
+export {
+    DefiError,
+    StakingProvider,
+    UnstakeMode,
+    StakingError,
+    StakingErrorCode,
+    StakingManager,
+} from '@ton/walletkit';
 
 export type {
     UnstakeModes,
@@ -18,4 +25,6 @@ export type {
     StakingProviderInfo,
     StakingProviderInterface,
     StakingQuoteDirection,
+    StakingProviderMetadata,
+    StakingTokenInfo,
 } from '@ton/walletkit';

package/src/swap/index.ts

@@ -6,17 +6,15 @@
  *
  */
 
+export { DefiError, DefiErrorCode, SwapError, SwapErrorCode, SwapProvider, SwapManager } from '@ton/walletkit';
+
 export type {
     SwapToken,
     TokenAmount,
     SwapParams,
     SwapAPI,
-    SwapFee,
     SwapQuote,
     SwapQuoteParams,
     DefiManagerAPI,
     DefiProvider,
-    SwapProvider,
-    SwapError,
-    SwapManager,
 } from '@ton/walletkit';

package/src/types/connector.ts

@@ -21,8 +21,6 @@ export interface Connector {
     /** Protocol type (e.g. 'tonconnect') */
     readonly type: string;
 
-    readonly metadata: ConnectorMetadata;
-
     /** Cleanup connector resources */
     destroy(): void;
 
@@ -36,18 +34,12 @@ export interface Connector {
     getConnectedWallets(): WalletInterface[];
 }
 
-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 */

package/src/types/primitives.ts

@@ -6,4 +6,4 @@
  *
  */
 
-export type { Base64String } from '@ton/walletkit';
+export type { Base64String, UserFriendlyAddress, Hex } from '@ton/walletkit';

package/src/types/provider.ts

@@ -6,9 +6,9 @@
  *
  */
 
-import type { SwapProviderInterface, StakingProviderInterface } from '@ton/walletkit';
+import type { SwapProviderInterface, StakingProviderInterface, StreamingProvider } from '@ton/walletkit';
 
 /**
- * Provider configuration
+ * Available provider types in AppKit.
  */
-export type Provider = SwapProviderInterface | StakingProviderInterface;
+export type AppKitProvider = SwapProviderInterface | StakingProviderInterface | StreamingProvider;

package/src/utils/address/is-valid-address.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 { UserFriendlyAddress } from '../../types/primitives';
+import { isString } from '../predicate/is-string';
+
+export const isValidAddress = (address: unknown): address is string => {
+    if (typeof address !== 'string') {
+        return false;
+    }
+
+    try {
+        Address.parse(address);
+    } catch (_) {
+        return false;
+    }
+
+    return true;
+};
+
+export const isFriendlyTonAddress = (address: unknown): address is UserFriendlyAddress => {
+    if (!isString(address)) {
+        return false;
+    }
+
+    try {
+        Address.parseFriendly(address);
+    } catch (_) {
+        return false;
+    }
+
+    return true;
+};