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

package/src/actions/index.ts

@@ -12,7 +12,13 @@ export {
     type GetBalanceByAddressOptions,
     type GetBalanceByAddressReturnType,
 } from './balances/get-balance-by-address';
+export {
+    watchBalanceByAddress,
+    type WatchBalanceByAddressOptions,
+    type WatchBalanceByAddressReturnType,
+} from './balances/watch-balance-by-address';
 export { getBalance, type GetBalanceOptions, type GetBalanceReturnType } from './balances/get-balance';
+export { watchBalance, type WatchBalanceOptions, type WatchBalanceReturnType } from './balances/watch-balance';
 
 // Connectors
 export { addConnector, type AddConnectorParameters, type AddConnectorReturnType } from './connectors/add-connector';
@@ -52,7 +58,13 @@ export {
     type GetJettonsByAddressOptions,
     type GetJettonsByAddressReturnType,
 } from './jettons/get-jettons-by-address';
+export {
+    watchJettonsByAddress,
+    type WatchJettonsByAddressOptions,
+    type WatchJettonsByAddressReturnType,
+} from './jettons/watch-jettons-by-address';
 export { getJettons, type GetJettonsOptions, type GetJettonsReturnType } from './jettons/get-jettons';
+export { watchJettons, type WatchJettonsOptions, type WatchJettonsReturnType } from './jettons/watch-jettons';
 export {
     createTransferJettonTransaction,
     type CreateTransferJettonTransactionParameters,
@@ -67,6 +79,7 @@ export {
 // Network
 export { getNetworks, type GetNetworksReturnType } from './network/get-networks';
 export { getNetwork, type GetNetworkReturnType } from './network/get-network';
+export { getApiClient, type GetApiClientOptions, type GetApiClientReturnType } from './network/get-api-client';
 export { watchNetworks, type WatchNetworksParameters, type WatchNetworksReturnType } from './network/watch-networks';
 export { getBlockNumber, type GetBlockNumberOptions, type GetBlockNumberReturnType } from './network/get-block-number';
 export { getDefaultNetwork, type GetDefaultNetworkReturnType } from './network/get-default-network';
@@ -80,6 +93,7 @@ export {
     type WatchDefaultNetworkParameters,
     type WatchDefaultNetworkReturnType,
 } from './network/watch-default-network';
+export { hasStreamingProvider, type HasStreamingProviderReturnType } from './network/has-streaming-provider';
 
 // NFT
 export {
@@ -108,6 +122,30 @@ export {
     type BuildSwapTransactionReturnType,
 } from './swap/build-swap-transaction';
 
+// Staking
+export { getStakingManager, type GetStakingManagerReturnType } from './staking/get-staking-manager';
+export { getStakingProviders, type GetStakingProvidersReturnType } from './staking/get-staking-providers';
+export {
+    getStakingQuote,
+    type GetStakingQuoteOptions,
+    type GetStakingQuoteReturnType,
+} from './staking/get-staking-quote';
+export {
+    buildStakeTransaction,
+    type BuildStakeTransactionOptions,
+    type BuildStakeTransactionReturnType,
+} from './staking/build-stake-transaction';
+export {
+    getStakedBalance,
+    type GetStakedBalanceOptions,
+    type GetStakedBalanceReturnType,
+} from './staking/get-staked-balance';
+export {
+    getStakingProviderInfo,
+    type GetStakingProviderInfoOptions,
+    type GetStakingProviderInfoReturnType,
+} from './staking/get-staking-provider-info';
+
 // Transactions
 export {
     sendTransaction,
@@ -121,6 +159,16 @@ export {
     type GetTransactionStatusReturnType,
     type GetTransactionStatusErrorType,
 } from './transaction/get-transaction-status';
+export {
+    watchTransactionsByAddress,
+    type WatchTransactionsByAddressOptions,
+    type WatchTransactionsByAddressReturnType,
+} from './transaction/watch-transactions-by-address';
+export {
+    watchTransactions,
+    type WatchTransactionsOptions,
+    type WatchTransactionsReturnType,
+} from './transaction/watch-transactions';
 export {
     createTransferNftTransaction,
     type CreateTransferNftTransactionParameters,

package/src/actions/jettons/watch-jettons-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 { JettonUpdate, Network } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+
+export interface WatchJettonsByAddressOptions {
+    address: string | Address;
+    onChange: (update: JettonUpdate) => void;
+    network?: Network;
+}
+
+export type WatchJettonsByAddressReturnType = () => void;
+
+/**
+ * Watch jetton updates by owner address.
+ */
+export const watchJettonsByAddress = (
+    appKit: AppKit,
+    options: WatchJettonsByAddressOptions,
+): WatchJettonsByAddressReturnType => {
+    const { address, network, onChange } = options;
+    const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
+    const resolvedNetwork = resolveNetwork(appKit, network);
+
+    return appKit.streamingManager.watchJettons(resolvedNetwork, addressString, onChange);
+};

package/src/actions/jettons/watch-jettons.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 { JettonUpdate, 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 { watchJettonsByAddress } from './watch-jettons-by-address';
+
+export interface WatchJettonsOptions {
+    onChange: (update: JettonUpdate) => void;
+    network?: Network;
+}
+
+export type WatchJettonsReturnType = () => void;
+
+/**
+ * Watch jetton updates for the selected wallet.
+ */
+export const watchJettons = (appKit: AppKit, options: WatchJettonsOptions): WatchJettonsReturnType => {
+    const { network, onChange } = options;
+    let unsubscribe: (() => void) | null = null;
+
+    const updateSubscription = () => {
+        if (unsubscribe) {
+            unsubscribe();
+            unsubscribe = null;
+        }
+
+        const selectedWallet = getSelectedWallet(appKit);
+        if (selectedWallet) {
+            unsubscribe = watchJettonsByAddress(appKit, {
+                address: selectedWallet.getAddress(),
+                network: network ?? selectedWallet.getNetwork(),
+                onChange,
+            });
+        }
+    };
+
+    const offSelection = appKit.emitter.on(WALLETS_EVENTS.SELECTION_CHANGED, updateSubscription);
+    const offUpdate = appKit.emitter.on(WALLETS_EVENTS.UPDATED, updateSubscription);
+
+    updateSubscription();
+
+    return () => {
+        if (unsubscribe) unsubscribe();
+        offSelection();
+        offUpdate();
+    };
+};

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

@@ -0,0 +1,22 @@
+/**
+ * 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 type { ApiClient } from '../../core/network';
+
+export type GetApiClientReturnType = ApiClient;
+
+export type GetApiClientOptions = { network: Network };
+
+/**
+ * Get API client for a network
+ */
+export const getApiClient = (appKit: AppKit, options: GetApiClientOptions): GetApiClientReturnType => {
+    return appKit.networkManager.getClient(options.network);
+};

package/src/actions/network/has-streaming-provider.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 { AppKit } from '../../core/app-kit/services/app-kit';
+import type { Network } from '../../types/network';
+
+export type HasStreamingProviderReturnType = boolean;
+
+/**
+ * Check if a streaming provider is registered for a specific network.
+ */
+export const hasStreamingProvider = (appKit: AppKit, network: Network): HasStreamingProviderReturnType => {
+    return appKit.streamingManager.hasProvider(network);
+};

package/src/actions/providers/register-provider.ts

@@ -6,10 +6,11 @@
  *
  */
 
-import type { Provider } from '../../types/provider';
+import type { ProviderInput } from '@ton/walletkit';
+
 import type { AppKit } from '../../core/app-kit';
 
-export type RegisterProviderOptions = Provider;
+export type RegisterProviderOptions = ProviderInput;
 
 /**
  * Register provider

package/src/actions/staking/build-stake-transaction.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 { StakeParams } from '@ton/walletkit';
+
+import type { TransactionRequest } from '../../types/transaction';
+import type { AppKit } from '../../core/app-kit';
+
+export type BuildStakeTransactionOptions = StakeParams & {
+    providerId?: string;
+};
+
+export type BuildStakeTransactionReturnType = Promise<TransactionRequest>;
+
+/**
+ * Build stake transaction
+ */
+export const buildStakeTransaction = async (
+    appKit: AppKit,
+    options: BuildStakeTransactionOptions,
+): BuildStakeTransactionReturnType => {
+    return appKit.stakingManager.buildStakeTransaction(options, options.providerId);
+};

package/src/actions/staking/get-staked-balance.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 { StakingBalance, UserFriendlyAddress, Network } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils';
+
+export type GetStakedBalanceOptions = {
+    userAddress: UserFriendlyAddress;
+    network?: Network;
+    providerId?: string;
+};
+
+export type GetStakedBalanceReturnType = Promise<StakingBalance>;
+
+/**
+ * Get staked balance
+ */
+export const getStakedBalance = async (
+    appKit: AppKit,
+    options: GetStakedBalanceOptions,
+): GetStakedBalanceReturnType => {
+    return appKit.stakingManager.getStakedBalance(
+        options.userAddress,
+        resolveNetwork(appKit, options.network),
+        options.providerId,
+    );
+};

package/src/actions/staking/get-staking-manager.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 { StakingManager } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+
+export type GetStakingManagerReturnType = StakingManager;
+
+/**
+ * Get staking manager instance
+ */
+export const getStakingManager = (appKit: AppKit): GetStakingManagerReturnType => {
+    return appKit.stakingManager;
+};

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

@@ -0,0 +1,29 @@
+/**
+ * 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 { StakingProviderInfo, Network } from '@ton/walletkit';
+
+import { resolveNetwork } from '../../utils';
+import type { AppKit } from '../../core/app-kit';
+
+export type GetStakingProviderInfoOptions = {
+    network?: Network;
+    providerId?: string;
+};
+
+export type GetStakingProviderInfoReturnType = Promise<StakingProviderInfo>;
+
+/**
+ * Get staking provider info
+ */
+export const getStakingProviderInfo = async (
+    appKit: AppKit,
+    options: GetStakingProviderInfoOptions = {},
+): GetStakingProviderInfoReturnType => {
+    return appKit.stakingManager.getStakingProviderInfo(resolveNetwork(appKit, options.network), options.providerId);
+};

package/src/actions/staking/get-staking-providers.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 { AppKit } from '../../core/app-kit';
+
+export type GetStakingProvidersReturnType = string[];
+
+/**
+ * Get available staking provider IDs
+ */
+export const getStakingProviders = (appKit: AppKit): GetStakingProvidersReturnType => {
+    return appKit.stakingManager.getRegisteredProviders();
+};

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

@@ -0,0 +1,30 @@
+/**
+ * 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 { StakingQuote, StakingQuoteParams } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils';
+
+export type GetStakingQuoteOptions = StakingQuoteParams & {
+    providerId?: string;
+};
+
+export type GetStakingQuoteReturnType = Promise<StakingQuote>;
+
+/**
+ * Get staking quote
+ */
+export const getStakingQuote = async (appKit: AppKit, options: GetStakingQuoteOptions): GetStakingQuoteReturnType => {
+    const optionsWithNetwork = {
+        ...options,
+        network: resolveNetwork(appKit, options.network),
+    };
+
+    return appKit.stakingManager.getQuote(optionsWithNetwork, options.providerId);
+};

package/src/actions/transaction/watch-transactions-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 { TransactionsUpdate, Network } from '@ton/walletkit';
+
+import type { AppKit } from '../../core/app-kit';
+import { resolveNetwork } from '../../utils/network/resolve-network';
+
+export interface WatchTransactionsByAddressOptions {
+    address: string | Address;
+    onChange: (update: TransactionsUpdate) => void;
+    network?: Network;
+}
+
+export type WatchTransactionsByAddressReturnType = () => void;
+
+/**
+ * Watch transactions by address.
+ */
+export const watchTransactionsByAddress = (
+    appKit: AppKit,
+    options: WatchTransactionsByAddressOptions,
+): WatchTransactionsByAddressReturnType => {
+    const { address, network, onChange } = options;
+    const addressString = Address.isAddress(address) ? address.toString() : Address.parse(address).toString();
+    const resolvedNetwork = resolveNetwork(appKit, network);
+
+    return appKit.streamingManager.watchTransactions(resolvedNetwork, addressString, onChange);
+};

package/src/actions/transaction/watch-transactions.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 { TransactionsUpdate, 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 { watchTransactionsByAddress } from './watch-transactions-by-address';
+
+export interface WatchTransactionsOptions {
+    onChange: (update: TransactionsUpdate) => void;
+    network?: Network;
+}
+
+export type WatchTransactionsReturnType = () => void;
+
+/**
+ * Watch transactions for the selected wallet.
+ */
+export const watchTransactions = (appKit: AppKit, options: WatchTransactionsOptions): WatchTransactionsReturnType => {
+    const { network, onChange } = options;
+    let unsubscribe: (() => void) | null = null;
+
+    const updateSubscription = () => {
+        if (unsubscribe) {
+            unsubscribe();
+            unsubscribe = null;
+        }
+
+        const selectedWallet = getSelectedWallet(appKit);
+        if (selectedWallet) {
+            unsubscribe = watchTransactionsByAddress(appKit, {
+                address: selectedWallet.getAddress(),
+                network: network ?? selectedWallet.getNetwork(),
+                onChange,
+            });
+        }
+    };
+
+    const offSelection = appKit.emitter.on(WALLETS_EVENTS.SELECTION_CHANGED, updateSubscription);
+    const offUpdate = appKit.emitter.on(WALLETS_EVENTS.UPDATED, updateSubscription);
+
+    updateSubscription();
+
+    return () => {
+        if (unsubscribe) unsubscribe();
+        offSelection();
+        offUpdate();
+    };
+};