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

package/dist/cjs/utils/amount/calc-fiat-value.test.d.ts.map

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

package/dist/cjs/utils/amount/calc-fiat-value.test.js

@@ -0,0 +1,39 @@
+"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 calc_fiat_value_1 = require("./calc-fiat-value");
+(0, vitest_1.describe)('calcFiatValue', () => {
+    (0, vitest_1.it)('should return 0 when rate is undefined', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('100', undefined)).toBe('0');
+    });
+    (0, vitest_1.it)('should return 0 when rate is 0', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('100', '0')).toBe('0');
+    });
+    (0, vitest_1.it)('should return 0 when amount is 0', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('0', '1.5')).toBe('0');
+    });
+    (0, vitest_1.it)('should return 0 when amount is negative', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('-10', '1.5')).toBe('0');
+    });
+    (0, vitest_1.it)('should return 0 when amount is not a valid number', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('abc', '1.5')).toBe('0');
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('', '1.5')).toBe('0');
+    });
+    (0, vitest_1.it)('should calculate fiat value without rounding', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('100', '1.5')).toBe('150');
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('1', '0.001')).toBe('0.001');
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('3', '1.005')).toBe('3.015');
+    });
+    (0, vitest_1.it)('should handle decimal amounts without rounding', () => {
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('0.5', '2')).toBe('1');
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('1.23456', '100')).toBe('123.456');
+        (0, vitest_1.expect)((0, calc_fiat_value_1.calcFiatValue)('2.996876', '1')).toBe('2.996876');
+    });
+});

package/dist/cjs/utils/amount/format-large-value.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 formatLargeValue: (amount: string, decimals?: number, minimumFractionDigits?: number) => string;
+//# sourceMappingURL=format-large-value.d.ts.map

package/dist/cjs/utils/amount/format-large-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-large-value.d.ts","sourceRoot":"","sources":["../../../../src/utils/amount/format-large-value.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,WAAU,MAAU,EAAE,wBAAuB,MAAU,KAAG,MAkC1G,CAAC"}

package/dist/cjs/utils/amount/format-large-value.js

@@ -0,0 +1,40 @@
+"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.formatLargeValue = void 0;
+const formatLargeValue = (amount, decimals = 2, minimumFractionDigits = 0) => {
+    const cleanAmount = amount.toString().replace(/\s/g, '');
+    const intPart = cleanAmount.split('.')[0] || '0';
+    // value > 100 000 000 000 000 => 100 T
+    if (intPart.length > 12) {
+        const value = Number(intPart.slice(0, -10)) / 100;
+        return `${value.toLocaleString('en-US')}T`;
+    }
+    // value > 100 000 000 000 => 100 B
+    if (intPart.length > 9) {
+        const value = Number(intPart.slice(0, -7)) / 100;
+        return `${value.toLocaleString('en-US')}B`;
+    }
+    // value > 10 000 000 => 10 M
+    if (intPart.length > 6) {
+        const value = Number(intPart.slice(0, -4)) / 100;
+        return `${value.toLocaleString('en-US')}M`;
+    }
+    const value = parseFloat(cleanAmount);
+    if (isNaN(value)) {
+        return '0';
+    }
+    const factor = Math.pow(10, decimals);
+    const truncated = Math.floor(value * factor) / factor;
+    return truncated.toLocaleString('en-US', {
+        minimumFractionDigits,
+        maximumFractionDigits: decimals,
+    });
+};
+exports.formatLargeValue = formatLargeValue;

package/dist/cjs/utils/amount/format-large-value.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=format-large-value.test.d.ts.map

package/dist/cjs/utils/amount/format-large-value.test.d.ts.map

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

package/dist/cjs/utils/amount/format-large-value.test.js

@@ -0,0 +1,43 @@
+"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 format_large_value_1 = require("./format-large-value");
+(0, vitest_1.describe)('formatLargeValue', () => {
+    (0, vitest_1.it)('should format trillion values', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1000000000000')).toBe('1T');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1230000000000')).toBe('1.23T');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('12345678901234')).toBe('12.34T');
+    });
+    (0, vitest_1.it)('should format billion values', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1000000000')).toBe('1B');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1230000000')).toBe('1.23B');
+    });
+    (0, vitest_1.it)('should format million values', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1000000')).toBe('1M');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1230000')).toBe('1.23M');
+    });
+    (0, vitest_1.it)('should format smaller values using toLocaleString', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1234.56')).toBe('1,234.56');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('100')).toBe('100');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('0')).toBe('0');
+    });
+    (0, vitest_1.it)('should handle spaces and formatting', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1 000 000')).toBe('1M');
+    });
+    (0, vitest_1.it)('should respect decimals for small values', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1234.5678', 4)).toBe('1,234.5678');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('1234.5678', 2)).toBe('1,234.56');
+    });
+    (0, vitest_1.it)('should round down (floor) fractional values', () => {
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('2.996848', 2)).toBe('2.99');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('2.996848', 6)).toBe('2.996848');
+        (0, vitest_1.expect)((0, format_large_value_1.formatLargeValue)('0.9999', 2)).toBe('0.99');
+    });
+});

package/dist/cjs/utils/amount/truncate-decimals.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 truncateDecimals: (value: string | number, maxDecimals: number) => string;
+//# sourceMappingURL=truncate-decimals.d.ts.map

package/dist/cjs/utils/amount/truncate-decimals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate-decimals.d.ts","sourceRoot":"","sources":["../../../../src/utils/amount/truncate-decimals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,MAAM,EAAE,aAAa,MAAM,KAAG,MAkB9E,CAAC"}

package/dist/cjs/utils/amount/truncate-decimals.js

@@ -0,0 +1,59 @@
+"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.truncateDecimals = void 0;
+/**
+ * Converts a number to a plain decimal string, expanding scientific notation
+ * like "1.23e-9" into "0.00000000123".
+ */
+const toPlainDecimalString = (num) => {
+    const str = num.toString();
+    if (!str.includes('e') && !str.includes('E'))
+        return str;
+    const [base = '0', exponent = '0'] = str.split(/[eE]/);
+    const exp = Number(exponent);
+    const isNegative = base.startsWith('-');
+    const absBase = isNegative ? base.slice(1) : base;
+    const [intPart, decPart = ''] = absBase.split('.');
+    let result;
+    if (exp < 0) {
+        result = '0.' + '0'.repeat(Math.abs(exp) - 1) + intPart + decPart;
+    }
+    else {
+        const addZeros = exp - decPart.length;
+        if (addZeros >= 0) {
+            result = intPart + decPart + '0'.repeat(addZeros);
+        }
+        else {
+            result = intPart + decPart.slice(0, exp) + '.' + decPart.slice(exp);
+        }
+    }
+    return isNegative ? '-' + result : result;
+};
+const truncateDecimals = (value, maxDecimals) => {
+    let strValue;
+    if (typeof value === 'number') {
+        strValue = toPlainDecimalString(value);
+    }
+    else if (value.includes('e') || value.includes('E')) {
+        const num = Number(value);
+        if (Number.isNaN(num))
+            return value;
+        strValue = toPlainDecimalString(num);
+    }
+    else {
+        strValue = value;
+    }
+    const dotIndex = strValue.indexOf('.');
+    if (dotIndex === -1)
+        return strValue;
+    const result = strValue.slice(0, dotIndex + 1 + maxDecimals);
+    return result.endsWith('.') ? result.slice(0, -1) : result;
+};
+exports.truncateDecimals = truncateDecimals;

package/dist/cjs/utils/amount/truncate-decimals.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=truncate-decimals.test.d.ts.map

package/dist/cjs/utils/amount/truncate-decimals.test.d.ts.map

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

package/dist/cjs/utils/amount/truncate-decimals.test.js

@@ -0,0 +1,83 @@
+"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 truncate_decimals_1 = require("./truncate-decimals");
+(0, vitest_1.describe)('truncateDecimals', () => {
+    (0, vitest_1.it)('should return integers unchanged', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('123', 2)).toBe('123');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('0', 5)).toBe('0');
+    });
+    (0, vitest_1.it)('should truncate decimals exceeding maxDecimals', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.23456', 2)).toBe('1.23');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.23456', 4)).toBe('1.2345');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('0.123456789', 9)).toBe('0.123456789');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('0.1234567890', 9)).toBe('0.123456789');
+    });
+    (0, vitest_1.it)('should return value unchanged when decimals are within limit', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.23', 5)).toBe('1.23');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.2', 2)).toBe('1.2');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('5.0', 1)).toBe('5.0');
+    });
+    (0, vitest_1.it)('should handle maxDecimals of 0', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.999', 0)).toBe('1');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('42.1', 0)).toBe('42');
+    });
+    (0, vitest_1.it)('should strip trailing dot', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.', 3)).toBe('1');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.', 0)).toBe('1');
+    });
+    (0, vitest_1.it)('should handle empty string', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('', 2)).toBe('');
+    });
+    (0, vitest_1.it)('should handle number input', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(1.23456, 2)).toBe('1.23');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(42, 3)).toBe('42');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(0.1, 5)).toBe('0.1');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(3.14159, 0)).toBe('3');
+    });
+    (0, vitest_1.it)('should handle scientific notation strings', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.095492908209088e-9', 9)).toBe('0.000000001');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('5e-7', 9)).toBe('0.0000005');
+    });
+    (0, vitest_1.it)('should handle numbers that produce scientific notation', () => {
+        const tiny = 0.000000001 * 1.095492908209088; // 1.095492908209088e-9
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(tiny, 9)).toBe('0.000000001');
+    });
+    (0, vitest_1.it)('should handle negative numbers and negative scientific notation', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('-1.23456', 2)).toBe('-1.23');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('-5e-7', 9)).toBe('-0.0000005');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(-0.0000005, 9)).toBe('-0.0000005');
+    });
+    (0, vitest_1.it)('should handle scientific notation with positive exponents', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.2345e2', 2)).toBe('123.45');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1.2345e+2', 0)).toBe('123');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('5.2e9', 0)).toBe('5200000000');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('-1.23e+9', 0)).toBe('-1230000000');
+    });
+    (0, vitest_1.it)('should handle extreme scientific exponents', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1e-100', 100)).toBe('0.' + '0'.repeat(99) + '1');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('1e21', 0)).toBe('1000000000000000000000');
+    });
+    (0, vitest_1.it)('should handle NaN and Infinity', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(NaN, 2)).toBe('NaN');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(Infinity, 2)).toBe('Infinity');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(-Infinity, 2)).toBe('-Infinity');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('NaN', 2)).toBe('NaN');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)('Infinity', 2)).toBe('Infinity');
+    });
+    (0, vitest_1.it)('should handle native numbers with e (scientific notation)', () => {
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(1e-10, 10)).toBe('0.0000000001');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(1.23e-8, 10)).toBe('0.0000000123');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(-5.43e-7, 9)).toBe('-0.000000543');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(5.2e9, 0)).toBe('5200000000');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(-1.23e9, 0)).toBe('-1230000000');
+        (0, vitest_1.expect)((0, truncate_decimals_1.truncateDecimals)(1e21, 0)).toBe('1000000000000000000000');
+    });
+});

package/dist/cjs/utils/balance/calc-max-spendable.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 TON reserve subtracted from balance when computing the max spendable amount
+ * for a native TON operation — leaves room for network fees. 0.1 TON.
+ */
+export declare const DEFAULT_TON_FEE_RESERVE_NANOS = 100000000n;
+export interface CalcMaxSpendableParams {
+    /** User's balance of `token`, as a decimal string. */
+    balance: string;
+    /** The token the user is going to spend. */
+    token: {
+        address: string;
+        decimals: number;
+    };
+    /**
+     * TON reserve (in nanos) subtracted from balance when the token is native TON.
+     * Ignored for jettons. Defaults to {@link DEFAULT_TON_FEE_RESERVE_NANOS}.
+     */
+    feeReserveNanos?: bigint;
+}
+/**
+ * Compute the max spendable amount a user can place into an input when they click MAX.
+ * For native TON — subtracts a fixed reserve so the user still has room for network fees.
+ * For jettons — returns the full balance (gas is paid from TON separately).
+ */
+export declare const calcMaxSpendable: ({ balance, token, feeReserveNanos, }: CalcMaxSpendableParams) => string;
+//# sourceMappingURL=calc-max-spendable.d.ts.map

package/dist/cjs/utils/balance/calc-max-spendable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calc-max-spendable.d.ts","sourceRoot":"","sources":["../../../../src/utils/balance/calc-max-spendable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,eAAO,MAAM,6BAA6B,aAAe,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACnC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,sCAI9B,sBAAsB,KAAG,MAM3B,CAAC"}

package/dist/cjs/utils/balance/calc-max-spendable.js

@@ -0,0 +1,29 @@
+"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.calcMaxSpendable = exports.DEFAULT_TON_FEE_RESERVE_NANOS = void 0;
+const walletkit_1 = require("@ton/walletkit");
+/**
+ * Default TON reserve subtracted from balance when computing the max spendable amount
+ * for a native TON operation — leaves room for network fees. 0.1 TON.
+ */
+exports.DEFAULT_TON_FEE_RESERVE_NANOS = 100000000n;
+/**
+ * Compute the max spendable amount a user can place into an input when they click MAX.
+ * For native TON — subtracts a fixed reserve so the user still has room for network fees.
+ * For jettons — returns the full balance (gas is paid from TON separately).
+ */
+const calcMaxSpendable = ({ balance, token, feeReserveNanos = exports.DEFAULT_TON_FEE_RESERVE_NANOS, }) => {
+    if (token.address !== 'ton')
+        return balance;
+    const balanceNanos = (0, walletkit_1.parseUnits)(balance, token.decimals);
+    const reducedNanos = balanceNanos > feeReserveNanos ? balanceNanos - feeReserveNanos : 0n;
+    return (0, walletkit_1.formatUnits)(reducedNanos, token.decimals);
+};
+exports.calcMaxSpendable = calcMaxSpendable;

package/dist/cjs/utils/balance/calc-max-spendable.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=calc-max-spendable.test.d.ts.map

package/dist/cjs/utils/balance/calc-max-spendable.test.d.ts.map

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

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

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

package/dist/cjs/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/cjs/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/cjs/utils/balance/get-ton-shortfall.js

@@ -0,0 +1,46 @@
+"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.getTonShortfall = exports.DEFAULT_SAFETY_MARGIN_NANOS = exports.DEFAULT_GAS_BUFFER_NANOS = void 0;
+const walletkit_1 = require("@ton/walletkit");
+/** Default extra TON buffer added on top of built transaction outflow when checking balance before sending. */
+exports.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.
+ */
+exports.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).
+ */
+const getTonShortfall = ({ messages, tonBalance, fromToken, fromAmount, gasBufferNanos = exports.DEFAULT_GAS_BUFFER_NANOS, safetyMarginNanos = exports.DEFAULT_SAFETY_MARGIN_NANOS, }) => {
+    const totalOutNanos = messages.reduce((acc, m) => acc + BigInt(m.amount), 0n);
+    const requiredNanos = totalOutNanos + gasBufferNanos;
+    const tonBalanceNanos = tonBalance ? (0, walletkit_1.parseUnits)(tonBalance, 9) : 0n;
+    if (tonBalanceNanos >= requiredNanos)
+        return;
+    if (fromToken.address === 'ton') {
+        const gasOnlyNanos = totalOutNanos - (0, walletkit_1.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 = (0, walletkit_1.formatUnits)(tonBalanceNanos - nonSwapReservedNanos, 9);
+        return { mode: 'reduce', requiredNanos, suggestedFromAmount };
+    }
+    return { mode: 'topup', requiredNanos, suggestedFromAmount: '' };
+};
+exports.getTonShortfall = getTonShortfall;

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