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

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

@@ -5,5 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export type { SwapToken, TokenAmount, SwapParams, SwapAPI, SwapFee, SwapQuote, SwapQuoteParams, DefiManagerAPI, DefiProvider, SwapProvider, SwapError, SwapManager, } from '@ton/walletkit';
+export { DefiError, SwapError, SwapProvider, SwapManager } from '@ton/walletkit';
+export type { SwapToken, TokenAmount, SwapParams, SwapAPI, SwapQuote, SwapQuoteParams, DefiManagerAPI, DefiProvider, } from '@ton/walletkit';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/swap/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/swap/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,OAAO,EACP,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,GACd,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/swap/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEjF,YAAY,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,GACf,MAAM,gBAAgB,CAAC"}

package/dist/esm/swap/index.js

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export {};
+export { DefiError, SwapError, SwapProvider, SwapManager } from '@ton/walletkit';

package/dist/esm/types/connector.d.ts

@@ -37,7 +37,6 @@ export interface ConnectorMetadata {
 export interface ConnectorFactoryContext {
     networkManager: AppKitNetworkManager;
     eventEmitter: AppKitEmitter;
-    ssr?: boolean;
 }
 /** Factory function that creates a connector from context */
 export type ConnectorFactory = (ctx: ConnectorFactoryContext) => Connector;

package/dist/esm/types/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAEhB,uBAAuB;IACvB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,0BAA0B;IAC1B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,4BAA4B;IAC5B,mBAAmB,IAAI,eAAe,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,EAAE,aAAa,CAAC;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,uBAAuB,KAAK,SAAS,CAAC;AAE3E,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAE1D,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAEhB,uBAAuB;IACvB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,0BAA0B;IAC1B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,4BAA4B;IAC5B,mBAAmB,IAAI,eAAe,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,EAAE,aAAa,CAAC;CAC/B;AAED,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,uBAAuB,KAAK,SAAS,CAAC;AAE3E,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAE1D,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E"}

package/dist/esm/types/primitives.d.ts

@@ -5,5 +5,5 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export type { Base64String } from '@ton/walletkit';
+export type { Base64String, UserFriendlyAddress, Hex } from '@ton/walletkit';
 //# sourceMappingURL=primitives.d.ts.map

package/dist/esm/types/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/types/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/types/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/utils/address/is-valid-address.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type { UserFriendlyAddress } from '../../types/primitives';
+export declare const isValidAddress: (address: unknown) => address is string;
+export declare const isFriendlyTonAddress: (address: unknown) => address is UserFriendlyAddress;
+//# sourceMappingURL=is-valid-address.d.ts.map

package/dist/esm/utils/address/is-valid-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-address.d.ts","sourceRoot":"","sources":["../../../../src/utils/address/is-valid-address.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,MAY5D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,mBAYlE,CAAC"}

package/dist/esm/utils/address/is-valid-address.js

@@ -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.
+ *
+ */
+import { Address } from '@ton/core';
+import { isString } from '../predicate/is-string';
+export const isValidAddress = (address) => {
+    if (typeof address !== 'string') {
+        return false;
+    }
+    try {
+        Address.parse(address);
+    }
+    catch (_) {
+        return false;
+    }
+    return true;
+};
+export const isFriendlyTonAddress = (address) => {
+    if (!isString(address)) {
+        return false;
+    }
+    try {
+        Address.parseFriendly(address);
+    }
+    catch (_) {
+        return false;
+    }
+    return true;
+};

package/dist/esm/utils/address/to-bounceble-address.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { Address } from '@ton/core';
+export declare const toBounceableAddress: (address?: Address | string | null) => string;
+export declare const tryToBounceableAddress: (address?: Address | string | null) => string | undefined;
+//# sourceMappingURL=to-bounceble-address.d.ts.map

package/dist/esm/utils/address/to-bounceble-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-bounceble-address.d.ts","sourceRoot":"","sources":["../../../../src/utils/address/to-bounceble-address.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,mBAAmB,GAAI,UAAU,OAAO,GAAG,MAAM,GAAG,IAAI,KAAG,MAcvE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,GAAG,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAMnF,CAAC"}

package/dist/esm/utils/address/to-bounceble-address.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { Address } from '@ton/core';
+import { getErrorMessage } from '../errors/get-error-message';
+export const toBounceableAddress = (address) => {
+    if (!address) {
+        throw new Error(`Address is empty`);
+    }
+    if (address instanceof Address) {
+        return address.toString({ bounceable: true });
+    }
+    try {
+        return Address.parse(address).toString({ bounceable: true });
+    }
+    catch (e) {
+        throw new Error(`Can not convert to bounceble address from "${address}". Error: ${getErrorMessage(e)}`);
+    }
+};
+export const tryToBounceableAddress = (address) => {
+    try {
+        return toBounceableAddress(address);
+    }
+    catch {
+        return undefined;
+    }
+};

package/dist/esm/utils/address/to-non-bounceble-address.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { Address } from '@ton/core';
+export declare const toNonBounceableAddress: (address?: Address | string | null) => string;
+export declare const tryToNonBounceableAddress: (address?: Address | string | null) => string | undefined;
+//# sourceMappingURL=to-non-bounceble-address.d.ts.map

package/dist/esm/utils/address/to-non-bounceble-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-non-bounceble-address.d.ts","sourceRoot":"","sources":["../../../../src/utils/address/to-non-bounceble-address.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,GAAG,MAAM,GAAG,IAAI,KAAG,MAc1E,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,UAAU,OAAO,GAAG,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAMtF,CAAC"}

package/dist/esm/utils/address/to-non-bounceble-address.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { Address } from '@ton/core';
+import { getErrorMessage } from '../errors/get-error-message';
+export const toNonBounceableAddress = (address) => {
+    if (!address) {
+        throw new Error(`Address is empty`);
+    }
+    if (address instanceof Address) {
+        return address.toString({ bounceable: false });
+    }
+    try {
+        return Address.parse(address).toString({ bounceable: false });
+    }
+    catch (e) {
+        throw new Error(`Can not convert to non-bounceable address from "${address}". Error: ${getErrorMessage(e)}`);
+    }
+};
+export const tryToNonBounceableAddress = (address) => {
+    try {
+        return toNonBounceableAddress(address);
+    }
+    catch {
+        return undefined;
+    }
+};

package/dist/esm/utils/amount/calc-fiat-value.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * Calculates the fiat value of a token amount.
+ * Returns null when rate is unavailable or amount is zero/invalid.
+ */
+export declare function calcFiatValue(amount: string, rate: string | undefined): string;
+//# sourceMappingURL=calc-fiat-value.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calc-fiat-value.d.ts","sourceRoot":"","sources":["../../../../src/utils/amount/calc-fiat-value.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK9E"}

package/dist/esm/utils/amount/calc-fiat-value.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * Calculates the fiat value of a token amount.
+ * Returns null when rate is unavailable or amount is zero/invalid.
+ */
+export function calcFiatValue(amount, rate) {
+    if (!rate)
+        return '0';
+    const num = parseFloat(amount);
+    if (!num || num <= 0)
+        return '0';
+    return Number((num * parseFloat(rate)).toFixed(10)).toString();
+}

package/dist/esm/utils/amount/calc-fiat-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=calc-fiat-value.test.d.ts.map

package/dist/esm/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/esm/utils/amount/calc-fiat-value.test.js

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

package/dist/esm/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/esm/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/esm/utils/amount/format-large-value.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.
+ *
+ */
+export 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,
+    });
+};

package/dist/esm/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/esm/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/esm/utils/amount/format-large-value.test.js

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

package/dist/esm/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/esm/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/esm/utils/amount/truncate-decimals.js

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

package/dist/esm/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/esm/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/esm/utils/amount/truncate-decimals.test.js

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

package/dist/esm/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/esm/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/esm/utils/balance/calc-max-spendable.js

@@ -0,0 +1,25 @@
+/**
+ * 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 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 const 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).
+ */
+export const calcMaxSpendable = ({ balance, token, feeReserveNanos = DEFAULT_TON_FEE_RESERVE_NANOS, }) => {
+    if (token.address !== 'ton')
+        return balance;
+    const balanceNanos = parseUnits(balance, token.decimals);
+    const reducedNanos = balanceNanos > feeReserveNanos ? balanceNanos - feeReserveNanos : 0n;
+    return formatUnits(reducedNanos, token.decimals);
+};

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