@tonappchain/sdk 0.7.2-scaled-ui-support-1 → 0.7.2-scaled-ui-support-2

package/dist/src/assets/FT.d.ts

@@ -14,8 +14,10 @@ export declare class FT implements Asset {
     private _decimals;
     private _transferAmount;
     private _evmAddress?;
-    private _displayMultiplierNumerator?;
-    private _displayMultiplierDenominator?;
+    private _displayMultiplierNumerator;
+    private _displayMultiplierDenominator;
+    private _displayMultiplierFetchedAt;
+    private _displayMultiplierCacheDuration;
     get address(): string;
     static getJettonData(configuration: IConfiguration, address: TVMAddress): Promise<JettonMinterData>;
     getJettonData(): Promise<JettonMinterData>;
@@ -32,15 +34,13 @@ export declare class FT implements Asset {
     withRawAmount(rawAmount: bigint): FT;
     addAmount(amount: number): FT;
     addRawAmount(rawAmount: bigint): FT;
-    withDisplayAmount(displayAmount: bigint): Promise<FT>;
-    addDisplayAmount(displayAmount: bigint): Promise<FT>;
     getDecimals(): Promise<number>;
-    getDisplayMultiplier(): Promise<{
-        numerator: bigint;
-        denominator: bigint;
-    }>;
-    toDisplayAmount(onchainAmount: bigint): Promise<bigint>;
-    fromDisplayAmount(displayAmount: bigint): Promise<bigint>;
+    private refreshDisplayMultiplierInternal;
+    private ensureFreshDisplayMultiplier;
+    refreshDisplayMultiplier(): Promise<void>;
+    setDisplayMultiplierCacheDuration(durationMs: number): void;
+    toDisplayAmount(onchainAmount: bigint): bigint;
+    fromDisplayAmount(displayAmount: bigint): bigint;
     getEVMAddress(): Promise<string>;
     getTVMAddress(): Promise<string>;
     generatePayload(params: {

package/dist/src/assets/FT.js

@@ -85,6 +85,10 @@ class FT {
     }
     constructor(address, origin, configuration, decimals) {
         this.type = Struct_1.AssetType.FT;
+        this._displayMultiplierNumerator = 1n;
+        this._displayMultiplierDenominator = 1n;
+        this._displayMultiplierFetchedAt = 0;
+        this._displayMultiplierCacheDuration = Consts_1.FIVE_MINUTES;
         this._tvmAddress = ton_1.Address.parse(address);
         this._configuration = configuration;
         this._jettonMinter = this._configuration.TONParams.contractOpener.open(configuration.artifacts.ton.wrappers.JettonMinter.createFromAddress(this._tvmAddress));
@@ -137,6 +141,8 @@ class FT {
         if (finalEvmAddress || (0, ethers_1.isAddress)(address)) {
             token._evmAddress = finalEvmAddress || address;
         }
+        // Fetch and cache display multiplier for TEP-526 support
+        await token.refreshDisplayMultiplierInternal();
         return token;
     }
     get rawAmount() {
@@ -148,15 +154,19 @@ class FT {
         ft._evmAddress = this._evmAddress;
         ft._displayMultiplierNumerator = this._displayMultiplierNumerator;
         ft._displayMultiplierDenominator = this._displayMultiplierDenominator;
+        ft._displayMultiplierFetchedAt = this._displayMultiplierFetchedAt;
+        ft._displayMultiplierCacheDuration = this._displayMultiplierCacheDuration;
         return ft;
     }
     withAmount(amount) {
+        const rawAmount = (0, Utils_1.calculateRawAmount)(amount, this._decimals);
+        const onchainAmount = this.fromDisplayAmount(rawAmount);
         if (this._transferAmount > 0n) {
             const newToken = this.clone;
-            newToken._transferAmount = (0, Utils_1.calculateRawAmount)(amount, this._decimals);
+            newToken._transferAmount = onchainAmount;
             return newToken;
         }
-        this._transferAmount = (0, Utils_1.calculateRawAmount)(amount, this._decimals);
+        this._transferAmount = onchainAmount;
         return this;
     }
     withRawAmount(rawAmount) {
@@ -169,60 +179,48 @@ class FT {
         return this;
     }
     addAmount(amount) {
-        this._transferAmount = this._transferAmount + (0, Utils_1.calculateRawAmount)(amount, this._decimals);
+        const rawAmount = (0, Utils_1.calculateRawAmount)(amount, this._decimals);
+        const onchainAmount = this.fromDisplayAmount(rawAmount);
+        this._transferAmount = this._transferAmount + onchainAmount;
         return this;
     }
     addRawAmount(rawAmount) {
         this._transferAmount = this._transferAmount + rawAmount;
         return this;
     }
-    async withDisplayAmount(displayAmount) {
-        const onchainAmount = await this.fromDisplayAmount(displayAmount);
-        if (this._transferAmount > 0n) {
-            const newToken = this.clone;
-            newToken._transferAmount = onchainAmount;
-            return newToken;
-        }
-        this._transferAmount = onchainAmount;
-        return this;
-    }
-    async addDisplayAmount(displayAmount) {
-        const onchainAmount = await this.fromDisplayAmount(displayAmount);
-        this._transferAmount = this._transferAmount + onchainAmount;
-        return this;
-    }
     async getDecimals() {
         return this._decimals;
     }
-    async getDisplayMultiplier() {
-        // Return cached values if available
-        if (this._displayMultiplierNumerator !== undefined && this._displayMultiplierDenominator !== undefined) {
-            return {
-                numerator: this._displayMultiplierNumerator,
-                denominator: this._displayMultiplierDenominator,
-            };
-        }
-        // Fetch and cache the multiplier
+    async refreshDisplayMultiplierInternal() {
         try {
             const multiplier = await this._jettonMinter.getDisplayMultiplier();
             this._displayMultiplierNumerator = multiplier.numerator;
             this._displayMultiplierDenominator = multiplier.denominator;
-            return multiplier;
+            this._displayMultiplierFetchedAt = Date.now();
         }
         catch {
-            // If the method doesn't exist or fails, assume no scaling (1:1)
             this._displayMultiplierNumerator = 1n;
             this._displayMultiplierDenominator = 1n;
-            return { numerator: 1n, denominator: 1n };
+            this._displayMultiplierFetchedAt = Date.now();
         }
     }
-    async toDisplayAmount(onchainAmount) {
-        const { numerator, denominator } = await this.getDisplayMultiplier();
-        return (0, Utils_1.muldivr)(onchainAmount, numerator, denominator);
+    async ensureFreshDisplayMultiplier() {
+        const age = Date.now() - this._displayMultiplierFetchedAt;
+        if (age > this._displayMultiplierCacheDuration) {
+            await this.refreshDisplayMultiplierInternal();
+        }
+    }
+    async refreshDisplayMultiplier() {
+        await this.refreshDisplayMultiplierInternal();
+    }
+    setDisplayMultiplierCacheDuration(durationMs) {
+        this._displayMultiplierCacheDuration = durationMs;
+    }
+    toDisplayAmount(onchainAmount) {
+        return (0, Utils_1.muldivr)(onchainAmount, this._displayMultiplierNumerator, this._displayMultiplierDenominator);
     }
-    async fromDisplayAmount(displayAmount) {
-        const { numerator, denominator } = await this.getDisplayMultiplier();
-        return (0, Utils_1.muldivr)(displayAmount, denominator, numerator);
+    fromDisplayAmount(displayAmount) {
+        return (0, Utils_1.muldivr)(displayAmount, this._displayMultiplierDenominator, this._displayMultiplierNumerator);
     }
     async getEVMAddress() {
         if (this._evmAddress) {
@@ -269,10 +267,12 @@ class FT {
         return (await this._jettonMinter.getWalletAddress(ton_1.Address.parse(userAddress))).toString({ bounceable: true });
     }
     async getUserBalance(userAddress) {
+        await this.ensureFreshDisplayMultiplier();
         const wallet = await this.getWallet(userAddress);
         return BigInt(await wallet.getJettonBalance());
     }
     async getUserBalanceExtended(userAddress) {
+        await this.ensureFreshDisplayMultiplier();
         const masterState = await this._configuration.TONParams.contractOpener.getContractState(this._tvmAddress);
         if (masterState.state !== 'active') {
             return { exists: false };
@@ -283,7 +283,7 @@ class FT {
         return {
             rawAmount,
             decimals,
-            amount: (0, Utils_1.calculateAmount)(rawAmount, decimals),
+            amount: (0, Utils_1.calculateAmount)(this.toDisplayAmount(rawAmount), decimals),
             exists: true,
         };
     }

package/dist/src/interfaces/Asset.d.ts

@@ -8,6 +8,7 @@ export interface Asset {
     /**
      * Returns a new asset instance with the specified transfer amount in human-readable units.
      * Does not mutate the current asset instance.
+     * For FT assets, this applies TEP-526 scaling automatically if supported by the token.
      * @param amount Amount in human units (e.g., 1.5 TON). Decimals are resolved during asset creation.
      * @returns A new Asset reflecting the requested amount.
      */
@@ -15,6 +16,7 @@ export interface Asset {
     /**
      * Returns a new asset instance with the specified transfer amount in raw base units.
      * Does not mutate the current asset instance.
+     * No TEP-526 scaling is applied - sets the raw onchain amount directly.
      * @param rawAmount Amount in raw base units (bigint).
      * @returns A new Asset reflecting the requested raw amount.
      */
@@ -22,6 +24,7 @@ export interface Asset {
     /**
      * Increases the transfer amount by the specified value (human-readable units) and returns a new asset instance.
      * Does not mutate the current asset instance.
+     * For FT assets, this applies TEP-526 scaling automatically if supported by the token.
      * @param amount Amount in human units (e.g., 1.5 TON). Decimals are resolved during asset creation.
      * @returns A new Asset with the increased amount.
      */
@@ -29,6 +32,7 @@ export interface Asset {
     /**
      * Increases the transfer amount by the specified raw base units and returns a new asset instance.
      * Does not mutate the current asset instance.
+     * No TEP-526 scaling is applied - adds to the raw onchain amount directly.
      * @param rawAmount Amount in raw base units (bigint).
      * @returns A new Asset with the increased amount in raw units.
      */

package/dist/src/sdk/Consts.d.ts

@@ -13,3 +13,4 @@ export declare const TAC_SYMBOL = "TAC";
 export declare const FIFTEEN_MINUTES: number;
 export declare const TON_DECIMALS = 9;
 export declare const TAC_DECIMALS = 18;
+export declare const FIVE_MINUTES: number;

package/dist/src/sdk/Consts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TAC_DECIMALS = exports.TON_DECIMALS = exports.FIFTEEN_MINUTES = exports.TAC_SYMBOL = exports.TON_SYMBOL = exports.MAX_MSG_DEPTH = exports.MAX_HIGHLOAD_GROUP_MSG_NUM = exports.MAX_EXT_MSG_SIZE = exports.SOLIDITY_METHOD_NAME_REGEX = exports.SOLIDITY_SIGNATURE_REGEX = exports.DEFAULT_DELAY = exports.MAX_ITERATION_COUNT = exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = exports.TRANSACTION_TON_AMOUNT = void 0;
+exports.FIVE_MINUTES = exports.TAC_DECIMALS = exports.TON_DECIMALS = exports.FIFTEEN_MINUTES = exports.TAC_SYMBOL = exports.TON_SYMBOL = exports.MAX_MSG_DEPTH = exports.MAX_HIGHLOAD_GROUP_MSG_NUM = exports.MAX_EXT_MSG_SIZE = exports.SOLIDITY_METHOD_NAME_REGEX = exports.SOLIDITY_SIGNATURE_REGEX = exports.DEFAULT_DELAY = exports.MAX_ITERATION_COUNT = exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = exports.TRANSACTION_TON_AMOUNT = void 0;
 const ton_1 = require("@ton/ton");
 exports.TRANSACTION_TON_AMOUNT = (0, ton_1.toNano)(0.55);
 exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = (0, ton_1.toNano)(0.2);
@@ -17,3 +17,4 @@ exports.TAC_SYMBOL = 'TAC';
 exports.FIFTEEN_MINUTES = 15 * 60 * 1000;
 exports.TON_DECIMALS = 9;
 exports.TAC_DECIMALS = 18;
+exports.FIVE_MINUTES = 5 * 60 * 1000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonappchain/sdk",
-  "version": "0.7.2-scaled-ui-support-1",
+  "version": "0.7.2-scaled-ui-support-2",
   "repository": "https://github.com/TacBuild/tac-sdk.git",
   "author": "TAC. <developers@tac>",
   "license": "MIT",