@ton/appkit 0.0.1-alpha.1 → 0.0.1

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

@@ -0,0 +1,64 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import { transferNft } from '../../actions/nft/transfer-nft';
+import type { TransferNftParameters, TransferNftReturnType } from '../../actions/nft/transfer-nft';
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+
+export type { TransferNftParameters, TransferNftReturnType };
+
+export type TransferNftErrorType = Error;
+
+export type TransferNftOptions<context = unknown> = MutationParameter<
+    TransferNftData,
+    TransferNftErrorType,
+    TransferNftVariables,
+    context
+>;
+
+export const transferNftMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: TransferNftOptions<context> = {},
+): TransferNftMutationOptions<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            return transferNft(appKit, variables);
+        },
+        mutationKey: ['transferNft'],
+    };
+};
+
+export type TransferNftMutationOptions<context = unknown> = MutationOptions<
+    TransferNftData,
+    TransferNftErrorType,
+    TransferNftVariables,
+    context
+>;
+
+export type TransferNftData = Compute<TransferNftReturnType>;
+
+export type TransferNftVariables = TransferNftParameters;
+
+export type TransferNftMutate<context = unknown> = (
+    variables: TransferNftVariables,
+    options?:
+        | Compute<MutateOptions<TransferNftData, TransferNftErrorType, Compute<TransferNftVariables>, context>>
+        | undefined,
+) => void;
+
+export type TransferNftMutateAsync<context = unknown> = (
+    variables: TransferNftVariables,
+    options?:
+        | Compute<MutateOptions<TransferNftData, TransferNftErrorType, Compute<TransferNftVariables>, context>>
+        | undefined,
+) => Promise<TransferNftData>;

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

@@ -0,0 +1,62 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import { signBinary } from '../../actions/signing/sign-binary';
+import type { SignBinaryParameters, SignBinaryReturnType } from '../../actions/signing/sign-binary';
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+
+export type SignBinaryErrorType = Error;
+
+export type SignBinaryOptions<context = unknown> = MutationParameter<
+    SignBinaryData,
+    SignBinaryErrorType,
+    SignBinaryVariables,
+    context
+>;
+
+export const signBinaryMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: SignBinaryOptions<context> = {},
+): SignBinaryMutationOptions<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            return signBinary(appKit, variables);
+        },
+        mutationKey: ['signBinary'],
+    };
+};
+
+export type SignBinaryMutationOptions<context = unknown> = MutationOptions<
+    SignBinaryData,
+    SignBinaryErrorType,
+    SignBinaryVariables,
+    context
+>;
+
+export type SignBinaryData = Compute<SignBinaryReturnType>;
+
+export type SignBinaryVariables = SignBinaryParameters;
+
+export type SignBinaryMutate<context = unknown> = (
+    variables: SignBinaryVariables,
+    options?:
+        | Compute<MutateOptions<SignBinaryData, SignBinaryErrorType, Compute<SignBinaryVariables>, context>>
+        | undefined,
+) => void;
+
+export type SignBinaryMutateAsync<context = unknown> = (
+    variables: SignBinaryVariables,
+    options?:
+        | Compute<MutateOptions<SignBinaryData, SignBinaryErrorType, Compute<SignBinaryVariables>, context>>
+        | undefined,
+) => Promise<SignBinaryData>;

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

@@ -0,0 +1,58 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import { signCell } from '../../actions/signing/sign-cell';
+import type { SignCellParameters, SignCellReturnType } from '../../actions/signing/sign-cell';
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+
+export type SignCellErrorType = Error;
+
+export type SignCellOptions<context = unknown> = MutationParameter<
+    SignCellData,
+    SignCellErrorType,
+    SignCellVariables,
+    context
+>;
+
+export const signCellMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: SignCellOptions<context> = {},
+): SignCellMutationOptions<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            return signCell(appKit, variables);
+        },
+        mutationKey: ['signCell'],
+    };
+};
+
+export type SignCellMutationOptions<context = unknown> = MutationOptions<
+    SignCellData,
+    SignCellErrorType,
+    SignCellVariables,
+    context
+>;
+
+export type SignCellData = Compute<SignCellReturnType>;
+
+export type SignCellVariables = SignCellParameters;
+
+export type SignCellMutate<context = unknown> = (
+    variables: SignCellVariables,
+    options?: Compute<MutateOptions<SignCellData, SignCellErrorType, Compute<SignCellVariables>, context>> | undefined,
+) => void;
+
+export type SignCellMutateAsync<context = unknown> = (
+    variables: SignCellVariables,
+    options?: Compute<MutateOptions<SignCellData, SignCellErrorType, Compute<SignCellVariables>, context>> | undefined,
+) => Promise<SignCellData>;

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

@@ -0,0 +1,58 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import { signText } from '../../actions/signing/sign-text';
+import type { SignTextParameters, SignTextReturnType } from '../../actions/signing/sign-text';
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+
+export type SignTextErrorType = Error;
+
+export type SignTextOptions<context = unknown> = MutationParameter<
+    SignTextData,
+    SignTextErrorType,
+    SignTextVariables,
+    context
+>;
+
+export const signTextMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: SignTextOptions<context> = {},
+): SignTextMutationOptions<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            return signText(appKit, variables);
+        },
+        mutationKey: ['signText'],
+    };
+};
+
+export type SignTextMutationOptions<context = unknown> = MutationOptions<
+    SignTextData,
+    SignTextErrorType,
+    SignTextVariables,
+    context
+>;
+
+export type SignTextData = Compute<SignTextReturnType>;
+
+export type SignTextVariables = SignTextParameters;
+
+export type SignTextMutate<context = unknown> = (
+    variables: SignTextVariables,
+    options?: Compute<MutateOptions<SignTextData, SignTextErrorType, Compute<SignTextVariables>, context>> | undefined,
+) => void;
+
+export type SignTextMutateAsync<context = unknown> = (
+    variables: SignTextVariables,
+    options?: Compute<MutateOptions<SignTextData, SignTextErrorType, Compute<SignTextVariables>, context>> | undefined,
+) => Promise<SignTextData>;

package/src/queries/swap/build-swap-transaction.ts

@@ -0,0 +1,84 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+import { buildSwapTransaction } from '../../actions/swap/build-swap-transaction';
+import type {
+    BuildSwapTransactionOptions,
+    BuildSwapTransactionReturnType,
+} from '../../actions/swap/build-swap-transaction';
+
+export type BuildSwapTransactionMutationOptions<context = unknown> = MutationParameter<
+    BuildSwapTransactionData,
+    BuildSwapTransactionErrorType,
+    BuildSwapTransactionVariables,
+    context
+>;
+
+export const buildSwapTransactionMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: BuildSwapTransactionMutationOptions<context> = {},
+): BuildSwapTransactionMutationConfig<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            const { quote, userAddress } = variables;
+            if (!quote || !userAddress) {
+                throw new Error('Required parameters "quote" and "userAddress" are missing');
+            }
+
+            return buildSwapTransaction(appKit, variables);
+        },
+        mutationKey: ['buildSwapTransaction'],
+    };
+};
+
+export type BuildSwapTransactionMutationConfig<context = unknown> = MutationOptions<
+    BuildSwapTransactionData,
+    BuildSwapTransactionErrorType,
+    BuildSwapTransactionVariables,
+    context
+>;
+
+export type BuildSwapTransactionData = Compute<Awaited<BuildSwapTransactionReturnType>>;
+
+export type BuildSwapTransactionErrorType = Error;
+
+export type BuildSwapTransactionVariables = BuildSwapTransactionOptions;
+
+export type BuildSwapTransactionMutate<context = unknown> = (
+    variables: BuildSwapTransactionVariables,
+    options?:
+        | Compute<
+              MutateOptions<
+                  BuildSwapTransactionData,
+                  BuildSwapTransactionErrorType,
+                  Compute<BuildSwapTransactionVariables>,
+                  context
+              >
+          >
+        | undefined,
+) => void;
+
+export type BuildSwapTransactionMutateAsync<context = unknown> = (
+    variables: BuildSwapTransactionVariables,
+    options?:
+        | Compute<
+              MutateOptions<
+                  BuildSwapTransactionData,
+                  BuildSwapTransactionErrorType,
+                  Compute<BuildSwapTransactionVariables>,
+                  context
+              >
+          >
+        | undefined,
+) => Promise<BuildSwapTransactionData>;

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

@@ -0,0 +1,70 @@
+/**
+ * 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 { getSwapQuote } from '../../actions/swap/get-swap-quote';
+import type { GetSwapQuoteOptions } from '../../actions/swap/get-swap-quote';
+import type { GetSwapQuoteReturnType } from '../../actions/swap/get-swap-quote';
+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';
+
+export type GetSwapQuoteErrorType = Error;
+
+export type GetSwapQuoteQueryConfig<selectData = GetSwapQuoteData> = Compute<ExactPartial<GetSwapQuoteOptions>> &
+    QueryParameter<GetSwapQuoteQueryFnData, GetSwapQuoteErrorType, selectData, GetSwapQuoteQueryKey>;
+
+export const getSwapQuoteQueryOptions = <selectData = GetSwapQuoteData>(
+    appKit: AppKit,
+    options: GetSwapQuoteQueryConfig<selectData> = {},
+): GetSwapQuoteQueryOptions<selectData> => {
+    return {
+        ...options.query,
+        enabled: Boolean(options.amount && 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) {
+                throw new Error('amount, fromToken, and toToken are required');
+            }
+
+            return getSwapQuote(appKit, parameters);
+        },
+        queryKey: getSwapQuoteQueryKey(options),
+        // refetchInterval: (query) => {
+        //     const data = query.state.data as GetSwapQuoteData | undefined;
+        //     if (!data?.expiresAt) {
+        //         return false;
+        //     }
+
+        //     const now = Date.now();
+        //     const expiresAt = data.expiresAt * 1000;
+        //     const timeUntilExpiration = expiresAt - now;
+
+        //     return Math.max(0, timeUntilExpiration);
+        // },
+    };
+};
+
+export type GetSwapQuoteQueryFnData = Compute<Awaited<GetSwapQuoteReturnType>>;
+
+export type GetSwapQuoteData = GetSwapQuoteQueryFnData;
+
+export const getSwapQuoteQueryKey = (
+    options: Compute<ExactPartial<GetSwapQuoteOptions>> = {},
+): GetSwapQuoteQueryKey => {
+    return ['swapQuote', filterQueryOptions(options as unknown as Record<string, unknown>)] as const;
+};
+
+export type GetSwapQuoteQueryKey = readonly ['swapQuote', Compute<ExactPartial<GetSwapQuoteOptions>>];
+
+export type GetSwapQuoteQueryOptions<selectData = GetSwapQuoteData> = QueryOptions<
+    GetSwapQuoteQueryFnData,
+    GetSwapQuoteErrorType,
+    selectData,
+    GetSwapQuoteQueryKey
+>;

package/src/queries/transaction/send-transaction.ts

@@ -0,0 +1,70 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import { sendTransaction } from '../../actions/transaction/send-transaction';
+import type {
+    SendTransactionErrorType,
+    SendTransactionParameters,
+    SendTransactionReturnType,
+} from '../../actions/transaction/send-transaction';
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+
+export type { SendTransactionErrorType, SendTransactionParameters, SendTransactionReturnType };
+
+export type SendTransactionOptions<context = unknown> = MutationParameter<
+    SendTransactionData,
+    SendTransactionErrorType,
+    SendTransactionVariables,
+    context
+>;
+
+export const sendTransactionMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: SendTransactionOptions<context> = {},
+): SendTransactionMutationOptions<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            return sendTransaction(appKit, variables);
+        },
+        mutationKey: ['sendTransaction'],
+    };
+};
+
+export type SendTransactionMutationOptions<context = unknown> = MutationOptions<
+    SendTransactionData,
+    SendTransactionErrorType,
+    SendTransactionVariables,
+    context
+>;
+
+export type SendTransactionData = Compute<SendTransactionReturnType>;
+
+export type SendTransactionVariables = SendTransactionParameters;
+
+export type SendTransactionMutate<context = unknown> = (
+    variables: SendTransactionVariables,
+    options?:
+        | Compute<
+              MutateOptions<SendTransactionData, SendTransactionErrorType, Compute<SendTransactionVariables>, context>
+          >
+        | undefined,
+) => void;
+
+export type SendTransactionMutateAsync<context = unknown> = (
+    variables: SendTransactionVariables,
+    options?:
+        | Compute<
+              MutateOptions<SendTransactionData, SendTransactionErrorType, Compute<SendTransactionVariables>, context>
+          >
+        | undefined,
+) => Promise<SendTransactionData>;

package/src/queries/transaction/transfer-ton.ts

@@ -0,0 +1,66 @@
+/**
+ * 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 { MutateOptions, MutationOptions } from '@tanstack/query-core';
+
+import { transferTon } from '../../actions/transaction/transfer-ton';
+import type {
+    TransferTonErrorType,
+    TransferTonParameters,
+    TransferTonReturnType,
+} from '../../actions/transaction/transfer-ton';
+import type { AppKit } from '../../core/app-kit';
+import type { MutationParameter } from '../../types/query';
+import type { Compute } from '../../types/utils';
+
+export type { TransferTonErrorType, TransferTonParameters, TransferTonReturnType };
+
+export type TransferTonOptions<context = unknown> = MutationParameter<
+    TransferTonData,
+    TransferTonErrorType,
+    TransferTonVariables,
+    context
+>;
+
+export const transferTonMutationOptions = <context = unknown>(
+    appKit: AppKit,
+    options: TransferTonOptions<context> = {},
+): TransferTonMutationOptions<context> => {
+    return {
+        ...options.mutation,
+        mutationFn(variables) {
+            return transferTon(appKit, variables);
+        },
+        mutationKey: ['transferTon'],
+    };
+};
+
+export type TransferTonMutationOptions<context = unknown> = MutationOptions<
+    TransferTonData,
+    TransferTonErrorType,
+    TransferTonVariables,
+    context
+>;
+
+export type TransferTonData = Compute<TransferTonReturnType>;
+
+export type TransferTonVariables = TransferTonParameters;
+
+export type TransferTonMutate<context = unknown> = (
+    variables: TransferTonVariables,
+    options?:
+        | Compute<MutateOptions<TransferTonData, TransferTonErrorType, Compute<TransferTonVariables>, context>>
+        | undefined,
+) => void;
+
+export type TransferTonMutateAsync<context = unknown> = (
+    variables: TransferTonVariables,
+    options?:
+        | Compute<MutateOptions<TransferTonData, TransferTonErrorType, Compute<TransferTonVariables>, context>>
+        | undefined,
+) => Promise<TransferTonData>;

package/src/swap/index.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 type { SwapToken, TokenAmount, SwapParams } from '@ton/walletkit';

package/src/swap/omniston/index.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/swap/omniston';

package/src/types/balance.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 { TokenAmount } from '@ton/walletkit';
+
+export type Balance = TokenAmount;

package/src/types/connector.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 { NetworkManager } from '@ton/walletkit';
+
+import type { WalletInterface } from './wallet';
+import type { AppKitEmitter } from '../core/app-kit';
+
+/**
+ * Interface for wallet connectors
+ */
+export interface Connector {
+    /** Provider unique identifier */
+    readonly id: string;
+
+    /** Protocol type (e.g. 'tonconnect', 'ledger', 'mnemonic') */
+    readonly type: string;
+
+    readonly metadata: ConnectorMetadata;
+
+    /** Initialize connector (restore connections, setup event listeners) */
+    initialize(emitter: AppKitEmitter, networkManager: NetworkManager): Promise<void>;
+
+    /** Cleanup connector resources */
+    destroy(): void;
+
+    /** Connect a wallet */
+    connectWallet(): Promise<void>;
+
+    /** Disconnect a wallet */
+    disconnectWallet(): Promise<void>;
+
+    /** Get connected wallets */
+    getConnectedWallets(): WalletInterface[];
+}
+
+export interface ConnectorMetadata {
+    name: string;
+    iconUrl?: string;
+}

package/src/types/jetton.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 type { Jetton, JettonInfo } from '@ton/walletkit';

package/src/types/network.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 { Network } from '@ton/walletkit';

package/src/types/nft.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 type { NFT } from '@ton/walletkit';

package/src/types/primitives.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 type { Base64String } from '@ton/walletkit';

package/src/types/provider.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.
+ *
+ */
+
+import type { SwapProviderInterface } from '@ton/walletkit';
+
+/**
+ * Provider configuration
+ */
+export type Provider = SwapProviderInterface;