@dynamic-labs/ton 4.51.2 → 4.52.0

package/CHANGELOG.md

@@ -1,4 +1,13 @@
 
+## [4.52.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.51.2...v4.52.0) (2025-12-22)
+
+
+### Features
+
+* add dynamic waas ton connector ([#9981](https://github.com/dynamic-labs/dynamic-auth/issues/9981)) ([95f2ecf](https://github.com/dynamic-labs/dynamic-auth/commit/95f2ecf253550ec8badad588a904599321a5846d))
+* add getTransactionHistory to react-native ([#10132](https://github.com/dynamic-labs/dynamic-auth/issues/10132)) ([bed6ce1](https://github.com/dynamic-labs/dynamic-auth/commit/bed6ce13b5e12f80121eebf6421355ae2b87968d))
+* add useGetTransactionHistory hook ([#10131](https://github.com/dynamic-labs/dynamic-auth/issues/10131)) ([431e7e1](https://github.com/dynamic-labs/dynamic-auth/commit/431e7e1a70cd0556c14f55c2827bb419f38a59c9))
+
 ### [4.51.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.51.1...v4.51.2) (2025-12-19)
 
 

package/_virtual/_tslib.cjs

@@ -0,0 +1,36 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+exports.__awaiter = __awaiter;

package/_virtual/_tslib.js

@@ -0,0 +1,32 @@
+'use client'
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+export { __awaiter };

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.51.2";
+var version = "4.52.0";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.51.2";
+var version = "4.52.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/ton",
-  "version": "4.51.2",
+  "version": "4.52.0",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,6 +18,10 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.51.2"
+    "@dynamic-labs/assert-package-version": "4.52.0",
+    "@dynamic-labs/types": "4.52.0",
+    "@dynamic-labs/utils": "4.52.0",
+    "@dynamic-labs/wallet-connector-core": "4.52.0",
+    "@ton/ton": "16.0.0"
   }
 }

package/src/index.cjs

@@ -1,7 +1,13 @@
 'use client'
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var assertPackageVersion = require('@dynamic-labs/assert-package-version');
 var _package = require('../package.cjs');
+var TonUiTransaction = require('./utils/TonUiTransaction/TonUiTransaction.cjs');
 
 assertPackageVersion.assertPackageVersion('@dynamic-labs/ton', _package.version);
+
+exports.NANOTON_PER_TON = TonUiTransaction.NANOTON_PER_TON;
+exports.TonUiTransaction = TonUiTransaction.TonUiTransaction;

package/src/index.d.ts

@@ -1 +1 @@
-export {};
+export * from './utils';

package/src/index.js

@@ -1,5 +1,6 @@
 'use client'
 import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
 import { version } from '../package.js';
+export { NANOTON_PER_TON, TonUiTransaction } from './utils/TonUiTransaction/TonUiTransaction.js';
 
 assertPackageVersion('@dynamic-labs/ton', version);

package/src/utils/TonUiTransaction/TonUiTransaction.cjs

@@ -0,0 +1,158 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var ton = require('@ton/ton');
+var utils = require('@dynamic-labs/utils');
+var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+
+/**
+ * 1 TON = 1,000,000,000 nanoTON (atomic units)
+ */
+const NANOTON_PER_TON = 1000000000;
+/**
+ * TonUiTransaction class for managing TON transactions in the UI
+ */
+class TonUiTransaction {
+    constructor({ onSubmit, from, client }) {
+        this.chain = 'TON';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.client = client;
+    }
+    /**
+     * TODO: Implement dynamic fee estimation using client.estimateFee()
+     */
+    fetchFee() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (this.fee.gas !== undefined)
+                return;
+            // Default conservative estimate: 0.01 TON for simple transfers
+            // This covers most native TON transfers
+            const DEFAULT_FEE = BigInt(10000000);
+            // For jetton transfers, fees are higher due to multiple messages
+            const DEFAULT_JETTON_FEE = BigInt(50000000);
+            if (this.nonNativeAddress) {
+                this.fee.gas = DEFAULT_JETTON_FEE;
+            }
+            else {
+                this.fee.gas = DEFAULT_FEE;
+            }
+        });
+    }
+    /**
+     * Parse string input to bigint (for TON)
+     */
+    parse(input) {
+        const [whole, fraction = '0'] = input.split('.');
+        const numericWhole = parseInt(whole, 10);
+        if (isNaN(numericWhole))
+            return BigInt(0);
+        const paddedFraction = fraction.padEnd(9, '0').slice(0, 9);
+        return (BigInt(numericWhole) * BigInt(NANOTON_PER_TON) +
+            BigInt(parseInt(paddedFraction, 10)));
+    }
+    /**
+     * Parse string input to bigint (for Jetton tokens)
+     */
+    parseNonNativeToken(input, decimals) {
+        const [whole, fraction = '0'] = input.split('.');
+        const numericWhole = parseInt(whole, 10);
+        if (isNaN(numericWhole))
+            return BigInt(0);
+        const paddedFraction = fraction.padEnd(decimals, '0').slice(0, decimals);
+        return (BigInt(numericWhole) * BigInt(Math.pow(10, decimals)) +
+            BigInt(parseInt(paddedFraction, 10)));
+    }
+    /**
+     * Format bigint value to string (for TON)
+     */
+    format(value, options) {
+        var _a;
+        const precision = (_a = options === null || options === void 0 ? void 0 : options.precision) !== null && _a !== void 0 ? _a : 9;
+        const divisor = BigInt(NANOTON_PER_TON);
+        const whole = value / divisor;
+        const remainder = value % divisor;
+        const fractional = remainder.toString().padStart(9, '0');
+        return utils.formatNumberText(`${whole}.${fractional}`, { precision });
+    }
+    /**
+     * Format bigint value to string (for Jetton tokens)
+     */
+    formatNonNativeToken(value, decimals) {
+        const divisor = BigInt(Math.pow(10, decimals));
+        const whole = value / divisor;
+        const remainder = value % divisor;
+        const fractional = remainder.toString().padStart(decimals, '0');
+        return utils.formatNumberText(`${whole}.${fractional}`, {
+            precision: decimals > 9 ? 9 : decimals,
+        });
+    }
+    /**
+     * Submit the transaction
+     */
+    submit() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!this.to) {
+                throw new Error('Destination address is required');
+            }
+            if (!this.value && !this.nonNativeValue) {
+                throw new Error('Transaction value is required');
+            }
+            return this.onSubmit(this);
+        });
+    }
+    /**
+     * Get the balance for the from address
+     */
+    getBalance() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.nonNativeAddress) {
+                    walletConnectorCore.logger.debug('Jetton balance fetching not yet implemented');
+                    return BigInt(0);
+                }
+                const address = ton.Address.parse(this.from);
+                const balance = yield this.client.getBalance(address);
+                return balance;
+            }
+            catch (error) {
+                walletConnectorCore.logger.error('Error occurred while fetching TON balance. Please try again or contact support.');
+                return BigInt(0);
+            }
+        });
+    }
+    /**
+     * Validate TON address format
+     *
+     * TON addresses can be in multiple formats:
+     * - Raw: 0:<64 hex chars> (workchain:hash)
+     * - User-friendly: Base64 encoded, starts with E/U (bounceable) or 0 (non-bounceable)
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        try {
+            // Use @ton/ton's Address.parse which handles all formats
+            ton.Address.parse(address);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    /**
+     * Check if gas is sponsored
+     */
+    isGasSponsored() {
+        return false;
+    }
+}
+
+exports.NANOTON_PER_TON = NANOTON_PER_TON;
+exports.TonUiTransaction = TonUiTransaction;

package/src/utils/TonUiTransaction/TonUiTransaction.d.ts

@@ -0,0 +1,76 @@
+import { TonClient } from '@ton/ton';
+import { IUITransaction, IUITransactionFormatOptions } from '@dynamic-labs/types';
+/**
+ * 1 TON = 1,000,000,000 nanoTON (atomic units)
+ */
+export declare const NANOTON_PER_TON = 1000000000;
+type TonUiTransactionProps = {
+    /** TON Address of the sender */
+    from: string;
+    /** The TonClient instance for interacting with the network */
+    client: TonClient;
+    /** The function to call when the transaction is submitted */
+    onSubmit: (transaction: TonUiTransaction) => Promise<string>;
+};
+/**
+ * TonUiTransaction class for managing TON transactions in the UI
+ */
+export declare class TonUiTransaction implements IUITransaction {
+    to: string | undefined;
+    from: string;
+    value: bigint | undefined;
+    chain: string;
+    receipt: string | undefined;
+    data: undefined;
+    fee: {
+        gas: bigint | undefined;
+    };
+    nonNativeAddress?: string;
+    nonNativeDecimal?: number;
+    nonNativeValue?: bigint;
+    nativePrice?: number;
+    private onSubmit;
+    private client;
+    constructor({ onSubmit, from, client }: TonUiTransactionProps);
+    /**
+     * TODO: Implement dynamic fee estimation using client.estimateFee()
+     */
+    fetchFee(): Promise<void>;
+    /**
+     * Parse string input to bigint (for TON)
+     */
+    parse(input: string): bigint;
+    /**
+     * Parse string input to bigint (for Jetton tokens)
+     */
+    parseNonNativeToken(input: string, decimals: number): bigint;
+    /**
+     * Format bigint value to string (for TON)
+     */
+    format(value: bigint, options?: IUITransactionFormatOptions): string;
+    /**
+     * Format bigint value to string (for Jetton tokens)
+     */
+    formatNonNativeToken(value: bigint, decimals: number): string;
+    /**
+     * Submit the transaction
+     */
+    submit(): Promise<string>;
+    /**
+     * Get the balance for the from address
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Validate TON address format
+     *
+     * TON addresses can be in multiple formats:
+     * - Raw: 0:<64 hex chars> (workchain:hash)
+     * - User-friendly: Base64 encoded, starts with E/U (bounceable) or 0 (non-bounceable)
+     */
+    validateAddressFormat(address: string): boolean;
+    /**
+     * Check if gas is sponsored
+     */
+    isGasSponsored(): boolean;
+}
+export {};

package/src/utils/TonUiTransaction/TonUiTransaction.js

@@ -0,0 +1,153 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { Address } from '@ton/ton';
+import { formatNumberText } from '@dynamic-labs/utils';
+import { logger } from '@dynamic-labs/wallet-connector-core';
+
+/**
+ * 1 TON = 1,000,000,000 nanoTON (atomic units)
+ */
+const NANOTON_PER_TON = 1000000000;
+/**
+ * TonUiTransaction class for managing TON transactions in the UI
+ */
+class TonUiTransaction {
+    constructor({ onSubmit, from, client }) {
+        this.chain = 'TON';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.client = client;
+    }
+    /**
+     * TODO: Implement dynamic fee estimation using client.estimateFee()
+     */
+    fetchFee() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fee.gas !== undefined)
+                return;
+            // Default conservative estimate: 0.01 TON for simple transfers
+            // This covers most native TON transfers
+            const DEFAULT_FEE = BigInt(10000000);
+            // For jetton transfers, fees are higher due to multiple messages
+            const DEFAULT_JETTON_FEE = BigInt(50000000);
+            if (this.nonNativeAddress) {
+                this.fee.gas = DEFAULT_JETTON_FEE;
+            }
+            else {
+                this.fee.gas = DEFAULT_FEE;
+            }
+        });
+    }
+    /**
+     * Parse string input to bigint (for TON)
+     */
+    parse(input) {
+        const [whole, fraction = '0'] = input.split('.');
+        const numericWhole = parseInt(whole, 10);
+        if (isNaN(numericWhole))
+            return BigInt(0);
+        const paddedFraction = fraction.padEnd(9, '0').slice(0, 9);
+        return (BigInt(numericWhole) * BigInt(NANOTON_PER_TON) +
+            BigInt(parseInt(paddedFraction, 10)));
+    }
+    /**
+     * Parse string input to bigint (for Jetton tokens)
+     */
+    parseNonNativeToken(input, decimals) {
+        const [whole, fraction = '0'] = input.split('.');
+        const numericWhole = parseInt(whole, 10);
+        if (isNaN(numericWhole))
+            return BigInt(0);
+        const paddedFraction = fraction.padEnd(decimals, '0').slice(0, decimals);
+        return (BigInt(numericWhole) * BigInt(Math.pow(10, decimals)) +
+            BigInt(parseInt(paddedFraction, 10)));
+    }
+    /**
+     * Format bigint value to string (for TON)
+     */
+    format(value, options) {
+        var _a;
+        const precision = (_a = options === null || options === void 0 ? void 0 : options.precision) !== null && _a !== void 0 ? _a : 9;
+        const divisor = BigInt(NANOTON_PER_TON);
+        const whole = value / divisor;
+        const remainder = value % divisor;
+        const fractional = remainder.toString().padStart(9, '0');
+        return formatNumberText(`${whole}.${fractional}`, { precision });
+    }
+    /**
+     * Format bigint value to string (for Jetton tokens)
+     */
+    formatNonNativeToken(value, decimals) {
+        const divisor = BigInt(Math.pow(10, decimals));
+        const whole = value / divisor;
+        const remainder = value % divisor;
+        const fractional = remainder.toString().padStart(decimals, '0');
+        return formatNumberText(`${whole}.${fractional}`, {
+            precision: decimals > 9 ? 9 : decimals,
+        });
+    }
+    /**
+     * Submit the transaction
+     */
+    submit() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.to) {
+                throw new Error('Destination address is required');
+            }
+            if (!this.value && !this.nonNativeValue) {
+                throw new Error('Transaction value is required');
+            }
+            return this.onSubmit(this);
+        });
+    }
+    /**
+     * Get the balance for the from address
+     */
+    getBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.nonNativeAddress) {
+                    logger.debug('Jetton balance fetching not yet implemented');
+                    return BigInt(0);
+                }
+                const address = Address.parse(this.from);
+                const balance = yield this.client.getBalance(address);
+                return balance;
+            }
+            catch (error) {
+                logger.error('Error occurred while fetching TON balance. Please try again or contact support.');
+                return BigInt(0);
+            }
+        });
+    }
+    /**
+     * Validate TON address format
+     *
+     * TON addresses can be in multiple formats:
+     * - Raw: 0:<64 hex chars> (workchain:hash)
+     * - User-friendly: Base64 encoded, starts with E/U (bounceable) or 0 (non-bounceable)
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        try {
+            // Use @ton/ton's Address.parse which handles all formats
+            Address.parse(address);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    /**
+     * Check if gas is sponsored
+     */
+    isGasSponsored() {
+        return false;
+    }
+}
+
+export { NANOTON_PER_TON, TonUiTransaction };

package/src/utils/TonUiTransaction/index.d.ts

@@ -0,0 +1 @@
+export { TonUiTransaction, NANOTON_PER_TON } from './TonUiTransaction';

package/src/utils/index.d.ts

@@ -0,0 +1 @@
+export { TonUiTransaction, NANOTON_PER_TON, } from './TonUiTransaction/TonUiTransaction';