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

package/dist/esm/utils/balance/calc-max-spendable.test.js

@@ -0,0 +1,36 @@
+/**
+ * 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 { calcMaxSpendable, DEFAULT_TON_FEE_RESERVE_NANOS } from './calc-max-spendable';
+const TON = { address: 'ton', decimals: 9 };
+const JETTON = { address: 'EQA_jetton', decimals: 6 };
+describe('calcMaxSpendable', () => {
+    it('returns balance minus the TON fee reserve for native TON', () => {
+        // 1 TON balance, default reserve 0.1 TON → 0.9 TON spendable.
+        expect(calcMaxSpendable({ balance: '1', token: TON })).toBe('0.9');
+    });
+    it('returns the full balance for a jetton (no reserve)', () => {
+        expect(calcMaxSpendable({ balance: '100', token: JETTON })).toBe('100');
+    });
+    it('clamps to zero when balance is below the reserve', () => {
+        expect(calcMaxSpendable({ balance: '0.05', token: TON })).toBe('0');
+    });
+    it('clamps to zero when balance equals the reserve', () => {
+        expect(calcMaxSpendable({ balance: '0.1', token: TON })).toBe('0');
+    });
+    it('respects a custom feeReserveNanos', () => {
+        // 1 TON balance, 0.5 TON reserve → 0.5 TON spendable.
+        expect(calcMaxSpendable({ balance: '1', token: TON, feeReserveNanos: 500000000n })).toBe('0.5');
+    });
+    it('ignores feeReserveNanos for jettons', () => {
+        expect(calcMaxSpendable({ balance: '100', token: JETTON, feeReserveNanos: 999999999999n })).toBe('100');
+    });
+    it('exports a sane default reserve', () => {
+        expect(DEFAULT_TON_FEE_RESERVE_NANOS).toBe(100000000n);
+    });
+});

package/dist/esm/utils/balance/get-ton-shortfall.d.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.
+ *
+ */
+/** Default extra TON buffer added on top of built transaction outflow when checking balance before sending. */
+export declare const DEFAULT_GAS_BUFFER_NANOS = 100000000n;
+/**
+ * Default extra headroom baked into the suggested reduced amount, on top of the gas buffer.
+ * Covers quote/gas drift between the current built tx and the one that will actually be sent
+ * after the amount changes. 0.02 TON.
+ */
+export declare const DEFAULT_SAFETY_MARGIN_NANOS = 20000000n;
+export type TonShortfall = {
+    mode: 'reduce';
+    requiredNanos: bigint;
+    suggestedFromAmount: string;
+} | {
+    mode: 'topup';
+    requiredNanos: bigint;
+    suggestedFromAmount: '';
+};
+export interface GetTonShortfallParams {
+    /** Messages of the built transaction. Each `amount` is the TON value in nanos attached to the message. */
+    messages: Array<{
+        amount: string;
+    }>;
+    /** User's current TON balance as a decimal string (same format `formatUnits(balance, 9)` returns). */
+    tonBalance: string | undefined;
+    /** The outgoing token — `{ address: 'ton' }` when the user spends TON, otherwise a jetton. */
+    fromToken: {
+        address: string;
+    };
+    /** Amount the user intends to spend in `fromToken` units, as a decimal string. */
+    fromAmount: string;
+    /**
+     * Extra TON headroom on top of built-tx outflow when checking balance before sending.
+     * Defaults to {@link DEFAULT_GAS_BUFFER_NANOS}.
+     */
+    gasBufferNanos?: bigint;
+    /**
+     * Extra headroom baked into the suggested reduced amount, on top of the gas buffer.
+     * Defaults to {@link DEFAULT_SAFETY_MARGIN_NANOS}.
+     */
+    safetyMarginNanos?: bigint;
+}
+/**
+ * Check whether the user's TON balance covers the built transaction.
+ * - Returns `null` if the balance is sufficient.
+ * - Returns `{ mode: 'reduce', ... }` with a smaller suggested `fromAmount` when `fromToken` is TON
+ *   and the balance is enough to cover at least gas (user can fix it by reducing the amount).
+ * - Returns `{ mode: 'topup', ... }` when `fromToken` is a jetton (reducing jetton amount won't free up TON gas),
+ *   or when `fromToken` is TON but the balance can't even cover gas (reducing won't help — user must top up).
+ */
+export declare const getTonShortfall: ({ messages, tonBalance, fromToken, fromAmount, gasBufferNanos, safetyMarginNanos, }: GetTonShortfallParams) => TonShortfall | undefined;
+//# sourceMappingURL=get-ton-shortfall.d.ts.map

package/dist/esm/utils/balance/get-ton-shortfall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ton-shortfall.d.ts","sourceRoot":"","sources":["../../../../src/utils/balance/get-ton-shortfall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,+GAA+G;AAC/G,eAAO,MAAM,wBAAwB,aAAe,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,YAAc,CAAC;AAEvD,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,EAAE,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,qBAAqB;IAClC,0GAA0G;IAC1G,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,sGAAsG;IACtG,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,8FAA8F;IAC9F,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,qFAO7B,qBAAqB,KAAG,YAAY,GAAG,SAqBzC,CAAC"}

package/dist/esm/utils/balance/get-ton-shortfall.js

@@ -0,0 +1,42 @@
+/**
+ * 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 { formatUnits, parseUnits } from '@ton/walletkit';
+/** Default extra TON buffer added on top of built transaction outflow when checking balance before sending. */
+export const DEFAULT_GAS_BUFFER_NANOS = 100000000n;
+/**
+ * Default extra headroom baked into the suggested reduced amount, on top of the gas buffer.
+ * Covers quote/gas drift between the current built tx and the one that will actually be sent
+ * after the amount changes. 0.02 TON.
+ */
+export const DEFAULT_SAFETY_MARGIN_NANOS = 20000000n;
+/**
+ * Check whether the user's TON balance covers the built transaction.
+ * - Returns `null` if the balance is sufficient.
+ * - Returns `{ mode: 'reduce', ... }` with a smaller suggested `fromAmount` when `fromToken` is TON
+ *   and the balance is enough to cover at least gas (user can fix it by reducing the amount).
+ * - Returns `{ mode: 'topup', ... }` when `fromToken` is a jetton (reducing jetton amount won't free up TON gas),
+ *   or when `fromToken` is TON but the balance can't even cover gas (reducing won't help — user must top up).
+ */
+export const getTonShortfall = ({ messages, tonBalance, fromToken, fromAmount, gasBufferNanos = DEFAULT_GAS_BUFFER_NANOS, safetyMarginNanos = DEFAULT_SAFETY_MARGIN_NANOS, }) => {
+    const totalOutNanos = messages.reduce((acc, m) => acc + BigInt(m.amount), 0n);
+    const requiredNanos = totalOutNanos + gasBufferNanos;
+    const tonBalanceNanos = tonBalance ? parseUnits(tonBalance, 9) : 0n;
+    if (tonBalanceNanos >= requiredNanos)
+        return;
+    if (fromToken.address === 'ton') {
+        const gasOnlyNanos = totalOutNanos - parseUnits(fromAmount, 9);
+        const nonSwapReservedNanos = gasOnlyNanos + gasBufferNanos + safetyMarginNanos;
+        // Balance can't cover even gas for a minimal outgoing tx — reducing the amount won't help.
+        if (tonBalanceNanos <= nonSwapReservedNanos) {
+            return { mode: 'topup', requiredNanos, suggestedFromAmount: '' };
+        }
+        const suggestedFromAmount = formatUnits(tonBalanceNanos - nonSwapReservedNanos, 9);
+        return { mode: 'reduce', requiredNanos, suggestedFromAmount };
+    }
+    return { mode: 'topup', requiredNanos, suggestedFromAmount: '' };
+};

package/dist/esm/utils/balance/get-ton-shortfall.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=get-ton-shortfall.test.d.ts.map

package/dist/esm/utils/balance/get-ton-shortfall.test.d.ts.map

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

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

@@ -0,0 +1,131 @@
+/**
+ * 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 { DEFAULT_GAS_BUFFER_NANOS, DEFAULT_SAFETY_MARGIN_NANOS, getTonShortfall } from './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();
+describe('getTonShortfall', () => {
+    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 = getTonShortfall({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '2',
+            fromToken: TON,
+            fromAmount: '1',
+        });
+        expect(result).toBeUndefined();
+    });
+    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 = getTonShortfall({
+            messages: [{ amount: toNanos('0.05') }],
+            tonBalance: '0',
+            fromToken: JETTON,
+            fromAmount: '100',
+        });
+        expect(result).toEqual({
+            mode: 'topup',
+            requiredNanos: 50000000n + DEFAULT_GAS_BUFFER_NANOS,
+            suggestedFromAmount: '',
+        });
+    });
+    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 = getTonShortfall({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '1',
+            fromToken: TON,
+            fromAmount: '1',
+        });
+        expect(result?.mode).toBe('reduce');
+        if (result?.mode !== 'reduce')
+            return;
+        // Suggested = 1 - 0.42 = 0.58
+        expect(result.suggestedFromAmount).toBe('0.58');
+        expect(result.requiredNanos).toBe(1300000000n + DEFAULT_GAS_BUFFER_NANOS);
+    });
+    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 = getTonShortfall({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '0.2',
+            fromToken: TON,
+            fromAmount: '1',
+        });
+        expect(result).toEqual({
+            mode: 'topup',
+            requiredNanos: 1300000000n + DEFAULT_GAS_BUFFER_NANOS,
+            suggestedFromAmount: '',
+        });
+    });
+    it('treats an undefined tonBalance as zero', () => {
+        const result = getTonShortfall({
+            messages: [{ amount: toNanos('0.05') }],
+            tonBalance: undefined,
+            fromToken: JETTON,
+            fromAmount: '100',
+        });
+        expect(result?.mode).toBe('topup');
+    });
+    it('sums amounts across multiple messages', () => {
+        // Two messages attaching 0.6 TON each → totalOut = 1.2 TON. Balance 1 TON → shortfall.
+        const result = getTonShortfall({
+            messages: [{ amount: toNanos('0.6') }, { amount: toNanos('0.6') }],
+            tonBalance: '1',
+            fromToken: JETTON,
+            fromAmount: '100',
+        });
+        expect(result?.mode).toBe('topup');
+        expect(result?.requiredNanos).toBe(1200000000n + DEFAULT_GAS_BUFFER_NANOS);
+    });
+    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).
+        expect(getTonShortfall(baseParams)?.mode).toBe('reduce');
+        // With a zero buffer, 1.3 TON balance covers the 1.3 TON outflow exactly.
+        expect(getTonShortfall({ ...baseParams, gasBufferNanos: 0n })).toBeUndefined();
+    });
+    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 = getTonShortfall(baseParams);
+        expect(withDefault?.mode === 'reduce' ? withDefault.suggestedFromAmount : null).toBe('0.58');
+        const withZero = getTonShortfall({ ...baseParams, safetyMarginNanos: 0n });
+        expect(withZero?.mode === 'reduce' ? withZero.suggestedFromAmount : null).toBe('0.6');
+    });
+    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 = getTonShortfall({
+            messages: [{ amount: toNanos('1.3') }],
+            tonBalance: '1',
+            fromToken: TON,
+            fromAmount: '1',
+            safetyMarginNanos: 1000000000n,
+        });
+        expect(result?.mode).toBe('topup');
+    });
+    it('exports sane default constants', () => {
+        expect(DEFAULT_GAS_BUFFER_NANOS).toBe(100000000n);
+        expect(DEFAULT_SAFETY_MARGIN_NANOS).toBe(20000000n);
+    });
+});

package/dist/esm/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/esm/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/esm/utils/functions/debounce.js

@@ -0,0 +1,103 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 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 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;
+};

package/dist/esm/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/esm/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,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/esm/utils/index.js

@@ -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/esm/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/esm/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/esm/utils/jetton/jetton-info.js

@@ -5,6 +5,15 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
+export 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');
+};
 export const getJettonsSymbol = (jetton) => {
     if (!jetton?.info?.symbol) {
         return;

package/dist/esm/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/esm/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/esm/utils/jetton/jetton-info.test.js

@@ -0,0 +1,52 @@
+/**
+ * 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 { isJettonInfo } from './jetton-info';
+describe('isJettonInfo', () => {
+    it('should return true for a valid JettonInfo object', () => {
+        expect(isJettonInfo({
+            address: 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs',
+            name: 'Tether USD',
+            symbol: 'USDT',
+            description: 'Tether USD stablecoin',
+        })).toBe(true);
+    });
+    it('should return true when optional fields are present', () => {
+        expect(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);
+    });
+    it('should return false for null', () => {
+        expect(isJettonInfo(null)).toBe(false);
+    });
+    it('should return false for primitives', () => {
+        expect(isJettonInfo('string')).toBe(false);
+        expect(isJettonInfo(42)).toBe(false);
+        expect(isJettonInfo(true)).toBe(false);
+        expect(isJettonInfo(undefined)).toBe(false);
+    });
+    it('should return false when required string fields are missing', () => {
+        expect(isJettonInfo({ name: 'Test', symbol: 'TST', description: 'desc' })).toBe(false);
+        expect(isJettonInfo({ address: 'EQ...', symbol: 'TST', description: 'desc' })).toBe(false);
+        expect(isJettonInfo({ address: 'EQ...', name: 'Test', description: 'desc' })).toBe(false);
+        expect(isJettonInfo({ address: 'EQ...', name: 'Test', symbol: 'TST' })).toBe(false);
+    });
+    it('should return false when required fields are not strings', () => {
+        expect(isJettonInfo({ address: 1, name: 'Test', symbol: 'TST', description: 'desc' })).toBe(false);
+        expect(isJettonInfo({ address: 'EQ...', name: null, symbol: 'TST', description: 'desc' })).toBe(false);
+    });
+    it('should return false for an empty object', () => {
+        expect(isJettonInfo({})).toBe(false);
+    });
+});

package/dist/esm/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/esm/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"}