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

package/dist/cjs/utils/balance/get-ton-shortfall.test.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * 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.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const get_ton_shortfall_1 = require("./get-ton-shortfall");
+const TON = { address: 'ton' };
+const JETTON = { address: 'EQA_jetton_address' };
+// Helper — convert a decimal string of TON to nanos as a string (for message amounts).
+const toNanos = (ton) => BigInt(Math.round(Number(ton) * 1e9)).toString();
+(0, vitest_1.describe)('getTonShortfall', () => {
+    (0, vitest_1.it)('returns undefined when TON balance covers the built transaction', () => {
+        // Swap 1 TON, total tx outflow 1.3 TON (1 TON swap + 0.3 TON attached gas), balance 2 TON.
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '2',
+            fromToken: TON,
+            fromAmount: '1',
+        });
+        (0, vitest_1.expect)(result).toBeUndefined();
+    });
+    (0, vitest_1.it)('returns topup when fromToken is a jetton and TON balance is below outflow + buffer', () => {
+        // Jetton swap, tx needs 0.05 TON for gas, user has 0 TON.
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('0.05') }],
+            tonBalance: '0',
+            fromToken: JETTON,
+            fromAmount: '100',
+        });
+        (0, vitest_1.expect)(result).toEqual({
+            mode: 'topup',
+            requiredNanos: 50000000n + get_ton_shortfall_1.DEFAULT_GAS_BUFFER_NANOS,
+            suggestedFromAmount: '',
+        });
+    });
+    (0, vitest_1.it)('returns reduce for TON-from when balance covers gas but not full amount', () => {
+        // User wants 1 TON swap, total outflow 1.3 TON, has 1 TON. Gas only = 0.3 TON.
+        // Balance (1) > nonSwapReserved (0.3 gas + 0.1 buffer + 0.02 safety = 0.42) → reduce mode.
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '1',
+            fromToken: TON,
+            fromAmount: '1',
+        });
+        (0, vitest_1.expect)(result?.mode).toBe('reduce');
+        if (result?.mode !== 'reduce')
+            return;
+        // Suggested = 1 - 0.42 = 0.58
+        (0, vitest_1.expect)(result.suggestedFromAmount).toBe('0.58');
+        (0, vitest_1.expect)(result.requiredNanos).toBe(1300000000n + get_ton_shortfall_1.DEFAULT_GAS_BUFFER_NANOS);
+    });
+    (0, vitest_1.it)('returns topup for TON-from when balance cannot cover even gas (reducing would not help)', () => {
+        // User wants 1 TON swap, total outflow 1.3 TON → gas = 0.3 TON. Balance 0.2 TON.
+        // nonSwapReserved = 0.3 + 0.1 buffer + 0.02 safety = 0.42 TON → balance (0.2) <= 0.42 → topup.
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '0.2',
+            fromToken: TON,
+            fromAmount: '1',
+        });
+        (0, vitest_1.expect)(result).toEqual({
+            mode: 'topup',
+            requiredNanos: 1300000000n + get_ton_shortfall_1.DEFAULT_GAS_BUFFER_NANOS,
+            suggestedFromAmount: '',
+        });
+    });
+    (0, vitest_1.it)('treats an undefined tonBalance as zero', () => {
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('0.05') }],
+            tonBalance: undefined,
+            fromToken: JETTON,
+            fromAmount: '100',
+        });
+        (0, vitest_1.expect)(result?.mode).toBe('topup');
+    });
+    (0, vitest_1.it)('sums amounts across multiple messages', () => {
+        // Two messages attaching 0.6 TON each → totalOut = 1.2 TON. Balance 1 TON → shortfall.
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('0.6') }, { amount: toNanos('0.6') }],
+            tonBalance: '1',
+            fromToken: JETTON,
+            fromAmount: '100',
+        });
+        (0, vitest_1.expect)(result?.mode).toBe('topup');
+        (0, vitest_1.expect)(result?.requiredNanos).toBe(1200000000n + get_ton_shortfall_1.DEFAULT_GAS_BUFFER_NANOS);
+    });
+    (0, vitest_1.it)('respects a custom gasBufferNanos', () => {
+        const baseParams = {
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '1.3',
+            fromToken: TON,
+            fromAmount: '1',
+        };
+        // With the default buffer (0.1 TON), balance 1.3 is insufficient (needs 1.4).
+        (0, vitest_1.expect)((0, get_ton_shortfall_1.getTonShortfall)(baseParams)?.mode).toBe('reduce');
+        // With a zero buffer, 1.3 TON balance covers the 1.3 TON outflow exactly.
+        (0, vitest_1.expect)((0, get_ton_shortfall_1.getTonShortfall)({ ...baseParams, gasBufferNanos: 0n })).toBeUndefined();
+    });
+    (0, vitest_1.it)('respects a custom safetyMarginNanos in the reduce branch', () => {
+        // Default margin: suggested = balance - gas - buffer - 0.02 = 1 - 0.3 - 0.1 - 0.02 = 0.58
+        // Zero margin:    suggested = balance - gas - buffer       = 1 - 0.3 - 0.1       = 0.6
+        const baseParams = {
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '1',
+            fromToken: TON,
+            fromAmount: '1',
+        };
+        const withDefault = (0, get_ton_shortfall_1.getTonShortfall)(baseParams);
+        (0, vitest_1.expect)(withDefault?.mode === 'reduce' ? withDefault.suggestedFromAmount : null).toBe('0.58');
+        const withZero = (0, get_ton_shortfall_1.getTonShortfall)({ ...baseParams, safetyMarginNanos: 0n });
+        (0, vitest_1.expect)(withZero?.mode === 'reduce' ? withZero.suggestedFromAmount : null).toBe('0.6');
+    });
+    (0, vitest_1.it)('flips from reduce to topup when a large custom safetyMarginNanos eats the balance', () => {
+        // Balance 1 TON, gas 0.3 TON, buffer 0.1 TON. With a 1 TON safety margin, nonSwapReserved becomes 1.4 TON → topup.
+        const result = (0, get_ton_shortfall_1.getTonShortfall)({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '1',
+            fromToken: TON,
+            fromAmount: '1',
+            safetyMarginNanos: 1000000000n,
+        });
+        (0, vitest_1.expect)(result?.mode).toBe('topup');
+    });
+    (0, vitest_1.it)('exports sane default constants', () => {
+        (0, vitest_1.expect)(get_ton_shortfall_1.DEFAULT_GAS_BUFFER_NANOS).toBe(100000000n);
+        (0, vitest_1.expect)(get_ton_shortfall_1.DEFAULT_SAFETY_MARGIN_NANOS).toBe(20000000n);
+    });
+});

package/dist/cjs/utils/functions/debounce.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 DebounceOptions {
+    /**
+     * An optional AbortSignal to cancel the debounced function.
+     */
+    signal?: AbortSignal;
+    /**
+     * An optional array specifying whether the function should be invoked on the leading edge, trailing edge, or both.
+     * If `edges` include "leading", the function will be invoked at the start of the delay period.
+     * If `edges` include "trailing", the function will be invoked at the end of the delay period.
+     * If both "leading" and "trailing" are included, the function will be invoked at both the start and end of the delay period.
+     * @default ["trailing"]
+     */
+    edges?: Array<'leading' | 'trailing'>;
+}
+export interface DebouncedFunction<F extends (...args: unknown[]) => void> {
+    (...args: Parameters<F>): void;
+    /**
+     * Schedules the execution of the debounced function after the specified debounced delay.
+     * This method resets any existing timer, ensuring that the function is only invoked
+     * after the delay has elapsed since the last call to the debounced function.
+     * It is typically called internally whenever the debounced function is invoked.
+     *
+     * @returns {void}
+     */
+    schedule: () => void;
+    /**
+     * Cancels any pending execution of the debounced function.
+     * This method clears the active timer and resets any stored context or arguments.
+     */
+    cancel: () => void;
+    /**
+     * Immediately invokes the debounced function if there is a pending execution.
+     * This method executes the function right away if there is a pending execution.
+     */
+    flush: () => void;
+}
+/**
+ * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
+ * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
+ * method to cancel any pending execution.
+ *
+ * @template F - The type of function.
+ * @param {F} func - The function to debounce.
+ * @param {number} debounceMs - The number of milliseconds to delay.
+ * @param {DebounceOptions} options - The options object
+ * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.
+ * @returns A new debounced function with a `cancel` method.
+ *
+ * @example
+ * const debouncedFunction = debounce(() => {
+ *   console.log('Function executed');
+ * }, 1000);
+ *
+ * // Will log 'Function executed' after 1 second if not called again in that time
+ * debouncedFunction();
+ *
+ * // Will not log anything as the previous call is canceled
+ * debouncedFunction.cancel();
+ *
+ * // With AbortSignal
+ * const controller = new AbortController();
+ * const signal = controller.signal;
+ * const debouncedWithSignal = debounce(() => {
+ *  console.log('Function executed');
+ * }, 1000, { signal });
+ *
+ * debouncedWithSignal();
+ *
+ * // Will cancel the debounced function call
+ * controller.abort();
+ */
+export declare const debounce: <F extends (...args: unknown[]) => void>(func: F, debounceMs: number, { signal, edges }?: DebounceOptions) => DebouncedFunction<F>;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/cjs/utils/functions/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../../src/utils/functions/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI;IACrE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB;;;OAGG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAC3D,MAAM,CAAC,EACP,YAAY,MAAM,EAClB,oBAAmB,eAAoB,KACxC,iBAAiB,CAAC,CAAC,CA+ErB,CAAC"}

package/dist/cjs/utils/functions/debounce.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * 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.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debounce = void 0;
+/**
+ * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
+ * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
+ * method to cancel any pending execution.
+ *
+ * @template F - The type of function.
+ * @param {F} func - The function to debounce.
+ * @param {number} debounceMs - The number of milliseconds to delay.
+ * @param {DebounceOptions} options - The options object
+ * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.
+ * @returns A new debounced function with a `cancel` method.
+ *
+ * @example
+ * const debouncedFunction = debounce(() => {
+ *   console.log('Function executed');
+ * }, 1000);
+ *
+ * // Will log 'Function executed' after 1 second if not called again in that time
+ * debouncedFunction();
+ *
+ * // Will not log anything as the previous call is canceled
+ * debouncedFunction.cancel();
+ *
+ * // With AbortSignal
+ * const controller = new AbortController();
+ * const signal = controller.signal;
+ * const debouncedWithSignal = debounce(() => {
+ *  console.log('Function executed');
+ * }, 1000, { signal });
+ *
+ * debouncedWithSignal();
+ *
+ * // Will cancel the debounced function call
+ * controller.abort();
+ */
+const debounce = (func, debounceMs, { signal, edges } = {}) => {
+    let pendingThis = undefined;
+    let pendingArgs = null;
+    const leading = edges != null && edges.includes('leading');
+    const trailing = edges == null || edges.includes('trailing');
+    const invoke = () => {
+        if (pendingArgs !== null) {
+            func.apply(pendingThis, pendingArgs);
+            pendingThis = undefined;
+            pendingArgs = null;
+        }
+    };
+    const onTimerEnd = () => {
+        if (trailing) {
+            invoke();
+        }
+        cancel();
+    };
+    let timeoutId = null;
+    const schedule = () => {
+        if (timeoutId != null) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            timeoutId = null;
+            onTimerEnd();
+        }, debounceMs);
+    };
+    const cancelTimer = () => {
+        if (timeoutId !== null) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+    };
+    const cancel = () => {
+        cancelTimer();
+        pendingThis = undefined;
+        pendingArgs = null;
+    };
+    const flush = () => {
+        invoke();
+    };
+    const debounced = function (...args) {
+        if (signal?.aborted) {
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        pendingThis = this;
+        pendingArgs = args;
+        const isFirstCall = timeoutId == null;
+        schedule();
+        if (leading && isFirstCall) {
+            invoke();
+        }
+    };
+    debounced.schedule = schedule;
+    debounced.cancel = cancel;
+    debounced.flush = flush;
+    signal?.addEventListener('abort', cancel, { once: true });
+    return debounced;
+};
+exports.debounce = debounce;

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

@@ -6,14 +6,24 @@
  *
  */
 export { formatUnits, parseUnits, compareAddress } from '@ton/walletkit';
+export * from './address/is-valid-address';
+export * from './address/to-bounceble-address';
+export * from './address/to-non-bounceble-address';
+export * from './amount/calc-fiat-value';
+export * from './amount/format-large-value';
+export * from './amount/truncate-decimals';
 export * from './amount/validate-numeric-string';
+export * from './balance/calc-max-spendable';
+export * from './balance/get-ton-shortfall';
 export * from './arrays/key-by';
 export * from './arrays/random-from-array';
 export * from './errors/get-error-message';
+export * from './functions/debounce';
 export * from './functions/noop';
 export * from './jetton/jetton-info';
 export * from './nft/nft-info';
 export * from './object/map-values';
+export * from './predicate/is-number';
 export * from './predicate/is-string';
 export * from './promise/cancel-promise';
 export * from './promise/sleep';

package/dist/cjs/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,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"}
+{"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,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,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/cjs/utils/index.js

@@ -26,14 +26,24 @@ var walletkit_1 = require("@ton/walletkit");
 Object.defineProperty(exports, "formatUnits", { enumerable: true, get: function () { return walletkit_1.formatUnits; } });
 Object.defineProperty(exports, "parseUnits", { enumerable: true, get: function () { return walletkit_1.parseUnits; } });
 Object.defineProperty(exports, "compareAddress", { enumerable: true, get: function () { return walletkit_1.compareAddress; } });
+__exportStar(require("./address/is-valid-address"), exports);
+__exportStar(require("./address/to-bounceble-address"), exports);
+__exportStar(require("./address/to-non-bounceble-address"), exports);
+__exportStar(require("./amount/calc-fiat-value"), exports);
+__exportStar(require("./amount/format-large-value"), exports);
+__exportStar(require("./amount/truncate-decimals"), exports);
 __exportStar(require("./amount/validate-numeric-string"), exports);
+__exportStar(require("./balance/calc-max-spendable"), exports);
+__exportStar(require("./balance/get-ton-shortfall"), exports);
 __exportStar(require("./arrays/key-by"), exports);
 __exportStar(require("./arrays/random-from-array"), exports);
 __exportStar(require("./errors/get-error-message"), exports);
+__exportStar(require("./functions/debounce"), exports);
 __exportStar(require("./functions/noop"), exports);
 __exportStar(require("./jetton/jetton-info"), exports);
 __exportStar(require("./nft/nft-info"), exports);
 __exportStar(require("./object/map-values"), exports);
+__exportStar(require("./predicate/is-number"), exports);
 __exportStar(require("./predicate/is-string"), exports);
 __exportStar(require("./promise/cancel-promise"), exports);
 __exportStar(require("./promise/sleep"), exports);

package/dist/cjs/utils/jetton/jetton-info.d.ts

@@ -5,7 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-import type { Jetton } from '@ton/walletkit';
+import type { Jetton, JettonInfo } from '../../types/jetton';
+export declare const isJettonInfo: (value: unknown) => value is JettonInfo;
 export declare const getJettonsSymbol: (jetton: Jetton) => string | undefined;
 export declare const getJettonsName: (jetton: Jetton) => string | undefined;
 export declare const getJettonsImage: (jetton: Jetton) => string | undefined;

package/dist/cjs/utils/jetton/jetton-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jetton-info.d.ts","sourceRoot":"","sources":["../../../../src/utils/jetton/jetton-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAM1D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAMxD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAazD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM;;;;;;;;;;CAkBpD,CAAC"}
+{"version":3,"file":"jetton-info.d.ts","sourceRoot":"","sources":["../../../../src/utils/jetton/jetton-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7D,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,UAStD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAM1D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAMxD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAazD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM;;;;;;;;;;CAkBpD,CAAC"}

package/dist/cjs/utils/jetton/jetton-info.js

@@ -7,7 +7,17 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFormattedJettonInfo = exports.getJettonsImage = exports.getJettonsName = exports.getJettonsSymbol = void 0;
+exports.getFormattedJettonInfo = exports.getJettonsImage = exports.getJettonsName = exports.getJettonsSymbol = exports.isJettonInfo = void 0;
+const isJettonInfo = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return (typeof v.address === 'string' &&
+        typeof v.name === 'string' &&
+        typeof v.symbol === 'string' &&
+        typeof v.description === 'string');
+};
+exports.isJettonInfo = isJettonInfo;
 const getJettonsSymbol = (jetton) => {
     if (!jetton?.info?.symbol) {
         return;

package/dist/cjs/utils/jetton/jetton-info.test.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 {};
+//# sourceMappingURL=jetton-info.test.d.ts.map

package/dist/cjs/utils/jetton/jetton-info.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jetton-info.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/jetton/jetton-info.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/cjs/utils/jetton/jetton-info.test.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * 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.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const jetton_info_1 = require("./jetton-info");
+(0, vitest_1.describe)('isJettonInfo', () => {
+    (0, vitest_1.it)('should return true for a valid JettonInfo object', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({
+            address: 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs',
+            name: 'Tether USD',
+            symbol: 'USDT',
+            description: 'Tether USD stablecoin',
+        })).toBe(true);
+    });
+    (0, vitest_1.it)('should return true when optional fields are present', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({
+            address: 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs',
+            name: 'Tether USD',
+            symbol: 'USDT',
+            description: 'Tether USD stablecoin',
+            decimals: 6,
+            image: 'https://example.com/image.png',
+            uri: 'https://example.com/meta.json',
+        })).toBe(true);
+    });
+    (0, vitest_1.it)('should return false for null', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)(null)).toBe(false);
+    });
+    (0, vitest_1.it)('should return false for primitives', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)('string')).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)(42)).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)(true)).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)(undefined)).toBe(false);
+    });
+    (0, vitest_1.it)('should return false when required string fields are missing', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({ name: 'Test', symbol: 'TST', description: 'desc' })).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({ address: 'EQ...', symbol: 'TST', description: 'desc' })).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({ address: 'EQ...', name: 'Test', description: 'desc' })).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({ address: 'EQ...', name: 'Test', symbol: 'TST' })).toBe(false);
+    });
+    (0, vitest_1.it)('should return false when required fields are not strings', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({ address: 1, name: 'Test', symbol: 'TST', description: 'desc' })).toBe(false);
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({ address: 'EQ...', name: null, symbol: 'TST', description: 'desc' })).toBe(false);
+    });
+    (0, vitest_1.it)('should return false for an empty object', () => {
+        (0, vitest_1.expect)((0, jetton_info_1.isJettonInfo)({})).toBe(false);
+    });
+});

package/dist/cjs/utils/predicate/is-number.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 declare const isNumber: (value: unknown) => value is number;
+//# sourceMappingURL=is-number.d.ts.map

package/dist/cjs/utils/predicate/is-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-number.d.ts","sourceRoot":"","sources":["../../../../src/utils/predicate/is-number.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAUlD,CAAC"}

package/dist/cjs/utils/predicate/is-number.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * 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.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNumber = void 0;
+const isNumber = (value) => {
+    if (typeof value !== 'number') {
+        return false;
+    }
+    if (Number.isNaN(value)) {
+        return false;
+    }
+    return Number.isFinite(value);
+};
+exports.isNumber = isNumber;

package/dist/cjs/utils/predicate/is-string.d.ts

@@ -5,5 +5,5 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export declare function isString(value: unknown): value is string;
+export declare const isString: (value: unknown) => value is string;
 //# sourceMappingURL=is-string.d.ts.map

package/dist/cjs/utils/predicate/is-string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-string.d.ts","sourceRoot":"","sources":["../../../../src/utils/predicate/is-string.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}
+{"version":3,"file":"is-string.d.ts","sourceRoot":"","sources":["../../../../src/utils/predicate/is-string.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAElD,CAAC"}

package/dist/cjs/utils/predicate/is-string.js

@@ -7,7 +7,8 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isString = isString;
-function isString(value) {
+exports.isString = void 0;
+const isString = (value) => {
     return typeof value === 'string';
-}
+};
+exports.isString = isString;

package/dist/esm/actions/connectors/watch-connector-by-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-connector-by-id.d.ts","sourceRoot":"","sources":["../../../../src/actions/connectors/watch-connector-by-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,WAAW,4BAA4B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,MAAM,4BAA4B,GAAG,MAAM,IAAI,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC3B,QAAQ,MAAM,EACd,YAAY,4BAA4B,KACzC,4BAQF,CAAC"}
+{"version":3,"file":"watch-connector-by-id.d.ts","sourceRoot":"","sources":["../../../../src/actions/connectors/watch-connector-by-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,WAAW,4BAA4B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,MAAM,4BAA4B,GAAG,MAAM,IAAI,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC3B,QAAQ,MAAM,EACd,YAAY,4BAA4B,KACzC,4BAcF,CAAC"}

package/dist/esm/actions/connectors/watch-connector-by-id.js

@@ -12,8 +12,13 @@ import { getConnectorById } from './get-connector-by-id';
  */
 export const watchConnectorById = (appKit, parameters) => {
     const { id, onChange } = parameters;
-    const unsubscribe = appKit.emitter.on(CONNECTOR_EVENTS.CONNECTED, () => {
+    const handler = () => {
         onChange(getConnectorById(appKit, { id }));
-    });
-    return unsubscribe;
+    };
+    const unsubscribeAdded = appKit.emitter.on(CONNECTOR_EVENTS.ADDED, handler);
+    const unsubscribeRemoved = appKit.emitter.on(CONNECTOR_EVENTS.REMOVED, handler);
+    return () => {
+        unsubscribeAdded();
+        unsubscribeRemoved();
+    };
 };

package/dist/esm/actions/connectors/watch-connectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-connectors.d.ts","sourceRoot":"","sources":["../../../../src/actions/connectors/watch-connectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,KAAK,IAAI,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,IAAI,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,YAAY,yBAAyB,KAAG,yBAQvF,CAAC"}
+{"version":3,"file":"watch-connectors.d.ts","sourceRoot":"","sources":["../../../../src/actions/connectors/watch-connectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,KAAK,IAAI,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,IAAI,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,YAAY,yBAAyB,KAAG,yBAcvF,CAAC"}

package/dist/esm/actions/connectors/watch-connectors.js

@@ -12,8 +12,13 @@ import { getConnectors } from './get-connectors';
  */
 export const watchConnectors = (appKit, parameters) => {
     const { onChange } = parameters;
-    const unsubscribe = appKit.emitter.on(CONNECTOR_EVENTS.CONNECTED, () => {
+    const handler = () => {
         onChange(getConnectors(appKit));
-    });
-    return unsubscribe;
+    };
+    const unsubscribeAdded = appKit.emitter.on(CONNECTOR_EVENTS.ADDED, handler);
+    const unsubscribeRemoved = appKit.emitter.on(CONNECTOR_EVENTS.REMOVED, handler);
+    return () => {
+        unsubscribeAdded();
+        unsubscribeRemoved();
+    };
 };

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

@@ -43,14 +43,22 @@ export { signText, type SignTextParameters, type SignTextReturnType } from './si
 export { signBinary, type SignBinaryParameters, type SignBinaryReturnType } from './signing/sign-binary';
 export { signCell, type SignCellParameters, type SignCellReturnType } from './signing/sign-cell';
 export { getSwapManager, type GetSwapManagerReturnType } from './swap/get-swap-manager';
+export { getSwapProvider, type GetSwapProviderOptions, type GetSwapProviderReturnType } from './swap/get-swap-provider';
+export { getSwapProviders, type GetSwapProvidersReturnType } from './swap/get-swap-providers';
+export { setDefaultSwapProvider, type SetDefaultSwapProviderParameters, type SetDefaultSwapProviderReturnType, } from './swap/set-default-swap-provider';
 export { getSwapQuote, type GetSwapQuoteOptions, type GetSwapQuoteReturnType } from './swap/get-swap-quote';
+export { watchSwapProviders, type WatchSwapProvidersParameters, type WatchSwapProvidersReturnType, } from './swap/watch-swap-providers';
 export { buildSwapTransaction, type BuildSwapTransactionOptions, type BuildSwapTransactionReturnType, } from './swap/build-swap-transaction';
 export { getStakingManager, type GetStakingManagerReturnType } from './staking/get-staking-manager';
 export { getStakingProviders, type GetStakingProvidersReturnType } from './staking/get-staking-providers';
+export { getStakingProvider, type GetStakingProviderOptions, type GetStakingProviderReturnType, } from './staking/get-staking-provider';
+export { setDefaultStakingProvider, type SetDefaultStakingProviderParameters, type SetDefaultStakingProviderReturnType, } from './staking/set-default-staking-provider';
+export { watchStakingProviders, type WatchStakingProvidersParameters, type WatchStakingProvidersReturnType, } from './staking/watch-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';
+export { getStakingProviderMetadata, type GetStakingProviderMetadataOptions, type GetStakingProviderMetadataReturnType, } from './staking/get-staking-provider-metadata';
 export { sendTransaction, type SendTransactionParameters, type SendTransactionReturnType, } from './transaction/send-transaction';
 export { transferTon, type TransferTonParameters, type TransferTonReturnType } from './transaction/transfer-ton';
 export { getTransactionStatus, type GetTransactionStatusParameters, type GetTransactionStatusReturnType, type GetTransactionStatusErrorType, } from './transaction/get-transaction-status';