@dynamic-labs/ton 4.61.7 → 4.63.0

package/src/types.d.ts

@@ -82,14 +82,16 @@ export type SendTonOptions = {
  * Options for sending Jetton (token) transactions
  */
 export type SendJettonOptions = {
-    /** Jetton contract address */
-    jettonAddress: string;
-    /** Recipient address */
-    to: string;
-    /** Amount in jetton units */
-    amount: string;
-    /** Optional comment/message */
-    comment?: string;
+    /** Jetton master contract address */
+    jettonMasterAddress: string;
+    /** Recipient wallet address */
+    recipientAddress: string;
+    /** Amount of jettons in base units */
+    jettonAmount: bigint;
+    /** Amount of TON to forward with the transfer notification */
+    forwardTonAmount: bigint;
+    /** Optional comment/memo forwarded with the transfer */
+    forwardPayload?: string;
 };
 /**
  * Result of a transaction send operation
@@ -139,6 +141,8 @@ export type TonConnectConnectorOpts = {
     manifestUrl?: string;
     /** Optional override key for the connector */
     overrideKey?: string;
+    /** TonConnect wallet app name used with openSingleWalletModal (e.g. 'tonkeeper', 'mytonwallet', 'telegram-wallet') */
+    tonConnectAppName?: string;
 };
 /**
  * TON network configuration.

package/src/utils/fetchTonWalletConnectors/fetchTonWalletConnectors.cjs

@@ -4,7 +4,6 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var TonConnectConnector = require('../../connectors/TonConnectConnector/TonConnectConnector.cjs');
-var debugLog = require('../debugLog/debugLog.cjs');
 
 /**
  * Checks if a wallet configuration supports TON Connect.
@@ -16,70 +15,41 @@ var debugLog = require('../debugLog/debugLog.cjs');
  * @returns true if the wallet supports TON Connect, false otherwise
  */
 const isValidTonConnectWallet = (wallet) => { var _a; return Boolean((_a = wallet.injectedConfig) === null || _a === void 0 ? void 0 : _a.find((config) => config.chain === 'ton')); };
+// Maps wallet-book keys to TonConnect app_name values where they differ.
+// Most wallets use the same key in both, but Telegram Wallet uses
+// 'telegramwallet' in the wallet-book and 'telegram-wallet' in the
+// TonConnect registry.
+const WALLET_BOOK_TO_TC_APP_NAME = {
+    telegramwallet: 'telegram-wallet',
+};
 /**
- * Discovers TON Connect wallets and creates connectors.
- *
- * TON Connect wallets are discovered from the official wallets list maintained at:
- * https://github.com/ton-connect/wallets-list
- *
- * The TON Connect SDK automatically fetches this list when getWallets() is called.
- * When a user clicks to connect, the SDK shows a UI with all available wallets
- * from the official list, so individual connectors aren't needed for each wallet.
- *
- * This function:
- * 1. Creates connectors for wallets found in the wallet book (for custom metadata/icons)
- * 2. Falls back to a generic connector that uses TON Connect SDK's built-in wallet selection
+ * Creates per-wallet TonConnect connectors. Each wallet-book entry that
+ * supports TON gets its own connector class which opens the TonConnect UI
+ * single-wallet modal for the matching wallet.
  *
  * @param walletBook - The wallet book schema containing all wallet configurations
  * @param tonNetworks - Optional TON networks configuration
- * @returns Array of wallet connector constructors for TON Connect enabled wallets
- *
- * @example
- * ```typescript
- * const tonConnectors = fetchTonWalletConnectors({ walletBook, tonNetworks });
- * // Returns connectors for wallets like Tonkeeper, MyTonWallet, etc.
- * ```
+ * @returns Array of per-wallet TonConnectConnector constructors
  */
 const fetchTonWalletConnectors = ({ walletBook, tonNetworks = [], }) => {
-    var _a;
-    // Create connectors from wallet book entries (these provide custom metadata/icons)
-    const allWallets = Object.entries((_a = walletBook === null || walletBook === void 0 ? void 0 : walletBook.wallets) !== null && _a !== void 0 ? _a : {});
-    const tonWallets = allWallets.filter(([_, wallet]) => isValidTonConnectWallet(wallet));
-    // Debug logging
-    debugLog.debugLogMultiline(['[TON] Total wallets in wallet book:', allWallets.length], ['[TON] TON wallets found:', tonWallets.length], ['[TON] TON wallet keys:', tonWallets.map(([key]) => key)]);
-    const walletBookConnectors = tonWallets.map(([key, wallet]) => {
-        const { shortName } = wallet;
-        const name = shortName || wallet.name;
-        return class extends TonConnectConnector.TonConnectConnector {
+    const connectors = [];
+    for (const [key, wallet] of Object.entries(walletBook.wallets)) {
+        if (!isValidTonConnectWallet(wallet)) {
+            continue;
+        }
+        const tonConnectAppName = WALLET_BOOK_TO_TC_APP_NAME[key] || key;
+        connectors.push(class extends TonConnectConnector.TonConnectConnector {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             constructor(props) {
-                super(Object.assign(Object.assign({}, props), { overrideKey: key, tonNetworks,
+                super(Object.assign(Object.assign({}, props), { overrideKey: key, tonConnectAppName,
+                    tonNetworks,
                     walletBook }));
-                this.name = name;
+                this.name = wallet.name;
                 this.overrideKey = key;
             }
-        };
-    });
-    // If wallets found in wallet book, return them
-    if (walletBookConnectors.length > 0) {
-        debugLog.debugLog('[TON] Returning', walletBookConnectors.length, 'connector(s) from wallet book');
-        return walletBookConnectors;
+        });
     }
-    // Return a generic connector that uses TON Connect SDK's built-in wallet selection
-    // The SDK automatically fetches wallets from the official list at:
-    // https://raw.githubusercontent.com/ton-connect/wallets-list/main/wallets.json
-    // When connect() is called, it shows a UI with all available wallets
-    return [
-        class extends TonConnectConnector.TonConnectConnector {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            constructor(props) {
-                super(Object.assign(Object.assign({}, props), { tonNetworks,
-                    walletBook }));
-                this.name = 'TON Connect';
-                this.overrideKey = 'tonconnect';
-            }
-        },
-    ];
+    return connectors;
 };
 
 exports.fetchTonWalletConnectors = fetchTonWalletConnectors;

package/src/utils/fetchTonWalletConnectors/fetchTonWalletConnectors.d.ts

@@ -12,28 +12,13 @@ import type { GenericNetwork } from '@dynamic-labs/types';
  */
 export declare const isValidTonConnectWallet: (wallet: WalletBookSchema['wallets'][string]) => boolean;
 /**
- * Discovers TON Connect wallets and creates connectors.
- *
- * TON Connect wallets are discovered from the official wallets list maintained at:
- * https://github.com/ton-connect/wallets-list
- *
- * The TON Connect SDK automatically fetches this list when getWallets() is called.
- * When a user clicks to connect, the SDK shows a UI with all available wallets
- * from the official list, so individual connectors aren't needed for each wallet.
- *
- * This function:
- * 1. Creates connectors for wallets found in the wallet book (for custom metadata/icons)
- * 2. Falls back to a generic connector that uses TON Connect SDK's built-in wallet selection
+ * Creates per-wallet TonConnect connectors. Each wallet-book entry that
+ * supports TON gets its own connector class which opens the TonConnect UI
+ * single-wallet modal for the matching wallet.
  *
  * @param walletBook - The wallet book schema containing all wallet configurations
  * @param tonNetworks - Optional TON networks configuration
- * @returns Array of wallet connector constructors for TON Connect enabled wallets
- *
- * @example
- * ```typescript
- * const tonConnectors = fetchTonWalletConnectors({ walletBook, tonNetworks });
- * // Returns connectors for wallets like Tonkeeper, MyTonWallet, etc.
- * ```
+ * @returns Array of per-wallet TonConnectConnector constructors
  */
 export declare const fetchTonWalletConnectors: ({ walletBook, tonNetworks, }: {
     walletBook: WalletBookSchema;

package/src/utils/fetchTonWalletConnectors/fetchTonWalletConnectors.js

@@ -1,6 +1,5 @@
 'use client'
 import { TonConnectConnector } from '../../connectors/TonConnectConnector/TonConnectConnector.js';
-import { debugLogMultiline, debugLog } from '../debugLog/debugLog.js';
 
 /**
  * Checks if a wallet configuration supports TON Connect.
@@ -12,70 +11,41 @@ import { debugLogMultiline, debugLog } from '../debugLog/debugLog.js';
  * @returns true if the wallet supports TON Connect, false otherwise
  */
 const isValidTonConnectWallet = (wallet) => { var _a; return Boolean((_a = wallet.injectedConfig) === null || _a === void 0 ? void 0 : _a.find((config) => config.chain === 'ton')); };
+// Maps wallet-book keys to TonConnect app_name values where they differ.
+// Most wallets use the same key in both, but Telegram Wallet uses
+// 'telegramwallet' in the wallet-book and 'telegram-wallet' in the
+// TonConnect registry.
+const WALLET_BOOK_TO_TC_APP_NAME = {
+    telegramwallet: 'telegram-wallet',
+};
 /**
- * Discovers TON Connect wallets and creates connectors.
- *
- * TON Connect wallets are discovered from the official wallets list maintained at:
- * https://github.com/ton-connect/wallets-list
- *
- * The TON Connect SDK automatically fetches this list when getWallets() is called.
- * When a user clicks to connect, the SDK shows a UI with all available wallets
- * from the official list, so individual connectors aren't needed for each wallet.
- *
- * This function:
- * 1. Creates connectors for wallets found in the wallet book (for custom metadata/icons)
- * 2. Falls back to a generic connector that uses TON Connect SDK's built-in wallet selection
+ * Creates per-wallet TonConnect connectors. Each wallet-book entry that
+ * supports TON gets its own connector class which opens the TonConnect UI
+ * single-wallet modal for the matching wallet.
  *
  * @param walletBook - The wallet book schema containing all wallet configurations
  * @param tonNetworks - Optional TON networks configuration
- * @returns Array of wallet connector constructors for TON Connect enabled wallets
- *
- * @example
- * ```typescript
- * const tonConnectors = fetchTonWalletConnectors({ walletBook, tonNetworks });
- * // Returns connectors for wallets like Tonkeeper, MyTonWallet, etc.
- * ```
+ * @returns Array of per-wallet TonConnectConnector constructors
  */
 const fetchTonWalletConnectors = ({ walletBook, tonNetworks = [], }) => {
-    var _a;
-    // Create connectors from wallet book entries (these provide custom metadata/icons)
-    const allWallets = Object.entries((_a = walletBook === null || walletBook === void 0 ? void 0 : walletBook.wallets) !== null && _a !== void 0 ? _a : {});
-    const tonWallets = allWallets.filter(([_, wallet]) => isValidTonConnectWallet(wallet));
-    // Debug logging
-    debugLogMultiline(['[TON] Total wallets in wallet book:', allWallets.length], ['[TON] TON wallets found:', tonWallets.length], ['[TON] TON wallet keys:', tonWallets.map(([key]) => key)]);
-    const walletBookConnectors = tonWallets.map(([key, wallet]) => {
-        const { shortName } = wallet;
-        const name = shortName || wallet.name;
-        return class extends TonConnectConnector {
+    const connectors = [];
+    for (const [key, wallet] of Object.entries(walletBook.wallets)) {
+        if (!isValidTonConnectWallet(wallet)) {
+            continue;
+        }
+        const tonConnectAppName = WALLET_BOOK_TO_TC_APP_NAME[key] || key;
+        connectors.push(class extends TonConnectConnector {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             constructor(props) {
-                super(Object.assign(Object.assign({}, props), { overrideKey: key, tonNetworks,
+                super(Object.assign(Object.assign({}, props), { overrideKey: key, tonConnectAppName,
+                    tonNetworks,
                     walletBook }));
-                this.name = name;
+                this.name = wallet.name;
                 this.overrideKey = key;
             }
-        };
-    });
-    // If wallets found in wallet book, return them
-    if (walletBookConnectors.length > 0) {
-        debugLog('[TON] Returning', walletBookConnectors.length, 'connector(s) from wallet book');
-        return walletBookConnectors;
+        });
     }
-    // Return a generic connector that uses TON Connect SDK's built-in wallet selection
-    // The SDK automatically fetches wallets from the official list at:
-    // https://raw.githubusercontent.com/ton-connect/wallets-list/main/wallets.json
-    // When connect() is called, it shows a UI with all available wallets
-    return [
-        class extends TonConnectConnector {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            constructor(props) {
-                super(Object.assign(Object.assign({}, props), { tonNetworks,
-                    walletBook }));
-                this.name = 'TON Connect';
-                this.overrideKey = 'tonconnect';
-            }
-        },
-    ];
+    return connectors;
 };
 
 export { fetchTonWalletConnectors, isValidTonConnectWallet };

package/src/wallet/TonWallet/TonWallet.cjs

@@ -7,7 +7,9 @@ var _tslib = require('../../../_virtual/_tslib.cjs');
 var utils = require('@dynamic-labs/utils');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
 var sdk = require('@tonconnect/sdk');
+var prepareJettonTransfer = require('../../utils/prepareJettonTransfer/prepareJettonTransfer.cjs');
 
+const DEFAULT_FORWARD_TON_AMOUNT = BigInt(1);
 /**
  * TON wallet implementation
  *
@@ -45,24 +47,32 @@ class TonWallet extends walletConnectorCore.Wallet {
         });
     }
     /**
-     * Send balance (native TON) - implements the base Wallet interface
+     * Send balance - implements the base Wallet interface.
+     * Supports both native TON and Jetton (token) transfers.
      *
-     * @param options - Send options
-     * @returns Transaction hash
+     * For Jetton transfers, pass the token param with the Jetton master address.
+     * For full control over Jetton transfer params, use sendJetton() instead.
      */
     sendBalance(_a) {
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ amount, comment, toAddress, }) {
-            // Keys are ordered alphabetically in the destructuring for linting
-            // but we maintain logical order in usage
+        return _tslib.__awaiter(this, arguments, void 0, function* ({ amount, comment, toAddress, token, }) {
+            if (token === null || token === void 0 ? void 0 : token.address) {
+                return this.sendJettonViaConnector({
+                    forwardPayload: comment,
+                    forwardTonAmount: DEFAULT_FORWARD_TON_AMOUNT,
+                    jettonAmount: BigInt(amount),
+                    jettonMasterAddress: token.address,
+                    recipientAddress: toAddress,
+                });
+            }
             const result = yield this._connector.sendTransaction({
                 messages: [
                     Object.assign({ address: toAddress, amount: amount }, (comment
                         ? { payload: this._connector.encodeComment(comment) }
                         : {})),
                 ],
-                validUntil: Math.floor(Date.now() / 1000) + 300, // 5 minutes from now
+                validUntil: Math.floor(Date.now() / 1000) + 300,
             });
-            return (result === null || result === void 0 ? void 0 : result.boc) || (result === null || result === void 0 ? void 0 : result.hash);
+            return result;
         });
     }
     /**
@@ -73,7 +83,8 @@ class TonWallet extends walletConnectorCore.Wallet {
      */
     sendJetton(options) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
-            return this._connector.sendJettonTransaction(options);
+            const boc = yield this.sendJettonViaConnector(options);
+            return { boc, hash: boc };
         });
     }
     /**
@@ -115,10 +126,9 @@ class TonWallet extends walletConnectorCore.Wallet {
     getNetworkDetails() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             const network = yield this._connector.getNetwork();
-            // Network is returned as a string (chain ID)
             const chainId = network
                 ? parseInt(network, 10)
-                : parseInt(sdk.CHAIN.MAINNET, 10); // Mainnet default
+                : parseInt(sdk.CHAIN.MAINNET, 10);
             let name;
             if (chainId === parseInt(sdk.CHAIN.MAINNET, 10)) {
                 name = 'mainnet';
@@ -135,6 +145,20 @@ class TonWallet extends walletConnectorCore.Wallet {
             };
         });
     }
+    sendJettonViaConnector(options) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!this.address) {
+                throw new utils.DynamicError('Wallet address is required');
+            }
+            const client = this._connector.getTonClient();
+            const networkStr = yield this._connector.getNetwork();
+            const network = (networkStr || sdk.CHAIN.MAINNET);
+            const request = yield prepareJettonTransfer.prepareJettonTransfer(Object.assign({ client, forwardTonAmount: options.forwardTonAmount, jettonAmount: options.jettonAmount, jettonMasterAddress: options.jettonMasterAddress, network, recipientAddress: options.recipientAddress, timeout: 60, walletAddress: this.address }, (options.forwardPayload
+                ? { forwardPayload: options.forwardPayload }
+                : {})));
+            return this._connector.sendTransaction(request);
+        });
+    }
 }
 
 exports.TonWallet = TonWallet;

package/src/wallet/TonWallet/TonWallet.d.ts

@@ -22,15 +22,20 @@ export declare class TonWallet extends Wallet<TonConnectConnector> {
      */
     sendTon(to: string, amount: string | number, comment?: string): Promise<TonTransactionResult>;
     /**
-     * Send balance (native TON) - implements the base Wallet interface
+     * Send balance - implements the base Wallet interface.
+     * Supports both native TON and Jetton (token) transfers.
      *
-     * @param options - Send options
-     * @returns Transaction hash
+     * For Jetton transfers, pass the token param with the Jetton master address.
+     * For full control over Jetton transfer params, use sendJetton() instead.
      */
-    sendBalance({ amount, comment, toAddress, }: {
+    sendBalance({ amount, comment, toAddress, token, }: {
         amount: string;
         comment?: string;
         toAddress: string;
+        token?: {
+            address: string;
+            decimals?: number;
+        };
     }): Promise<string | undefined>;
     /**
      * Send Jetton (token) to an address
@@ -62,4 +67,5 @@ export declare class TonWallet extends Wallet<TonConnectConnector> {
         chainId: number;
         name: string;
     }>;
+    private sendJettonViaConnector;
 }

package/src/wallet/TonWallet/TonWallet.js

@@ -3,7 +3,9 @@ import { __awaiter } from '../../../_virtual/_tslib.js';
 import { DynamicError } from '@dynamic-labs/utils';
 import { Wallet } from '@dynamic-labs/wallet-connector-core';
 import { CHAIN } from '@tonconnect/sdk';
+import { prepareJettonTransfer } from '../../utils/prepareJettonTransfer/prepareJettonTransfer.js';
 
+const DEFAULT_FORWARD_TON_AMOUNT = BigInt(1);
 /**
  * TON wallet implementation
  *
@@ -41,24 +43,32 @@ class TonWallet extends Wallet {
         });
     }
     /**
-     * Send balance (native TON) - implements the base Wallet interface
+     * Send balance - implements the base Wallet interface.
+     * Supports both native TON and Jetton (token) transfers.
      *
-     * @param options - Send options
-     * @returns Transaction hash
+     * For Jetton transfers, pass the token param with the Jetton master address.
+     * For full control over Jetton transfer params, use sendJetton() instead.
      */
     sendBalance(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ amount, comment, toAddress, }) {
-            // Keys are ordered alphabetically in the destructuring for linting
-            // but we maintain logical order in usage
+        return __awaiter(this, arguments, void 0, function* ({ amount, comment, toAddress, token, }) {
+            if (token === null || token === void 0 ? void 0 : token.address) {
+                return this.sendJettonViaConnector({
+                    forwardPayload: comment,
+                    forwardTonAmount: DEFAULT_FORWARD_TON_AMOUNT,
+                    jettonAmount: BigInt(amount),
+                    jettonMasterAddress: token.address,
+                    recipientAddress: toAddress,
+                });
+            }
             const result = yield this._connector.sendTransaction({
                 messages: [
                     Object.assign({ address: toAddress, amount: amount }, (comment
                         ? { payload: this._connector.encodeComment(comment) }
                         : {})),
                 ],
-                validUntil: Math.floor(Date.now() / 1000) + 300, // 5 minutes from now
+                validUntil: Math.floor(Date.now() / 1000) + 300,
             });
-            return (result === null || result === void 0 ? void 0 : result.boc) || (result === null || result === void 0 ? void 0 : result.hash);
+            return result;
         });
     }
     /**
@@ -69,7 +79,8 @@ class TonWallet extends Wallet {
      */
     sendJetton(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._connector.sendJettonTransaction(options);
+            const boc = yield this.sendJettonViaConnector(options);
+            return { boc, hash: boc };
         });
     }
     /**
@@ -111,10 +122,9 @@ class TonWallet extends Wallet {
     getNetworkDetails() {
         return __awaiter(this, void 0, void 0, function* () {
             const network = yield this._connector.getNetwork();
-            // Network is returned as a string (chain ID)
             const chainId = network
                 ? parseInt(network, 10)
-                : parseInt(CHAIN.MAINNET, 10); // Mainnet default
+                : parseInt(CHAIN.MAINNET, 10);
             let name;
             if (chainId === parseInt(CHAIN.MAINNET, 10)) {
                 name = 'mainnet';
@@ -131,6 +141,20 @@ class TonWallet extends Wallet {
             };
         });
     }
+    sendJettonViaConnector(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.address) {
+                throw new DynamicError('Wallet address is required');
+            }
+            const client = this._connector.getTonClient();
+            const networkStr = yield this._connector.getNetwork();
+            const network = (networkStr || CHAIN.MAINNET);
+            const request = yield prepareJettonTransfer(Object.assign({ client, forwardTonAmount: options.forwardTonAmount, jettonAmount: options.jettonAmount, jettonMasterAddress: options.jettonMasterAddress, network, recipientAddress: options.recipientAddress, timeout: 60, walletAddress: this.address }, (options.forwardPayload
+                ? { forwardPayload: options.forwardPayload }
+                : {})));
+            return this._connector.sendTransaction(request);
+        });
+    }
 }
 
 export { TonWallet };

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

@@ -1 +0,0 @@
-export { selectTonWallet, checkWalletFeatures } from './selectTonWallet';

package/src/utils/selectTonWallet/selectTonWallet.d.ts

@@ -1,16 +0,0 @@
-import { type WalletInfo, type RequiredFeatures } from '@tonconnect/sdk';
-/**
- * Selects the best wallet from available wallets, preferring injected wallets.
- *
- * @param wallets - Array of available TON Connect wallets
- * @returns The selected wallet, or undefined if no wallet is available
- */
-export declare const selectTonWallet: (wallets: WalletInfo[]) => WalletInfo | undefined;
-/**
- * Checks if a wallet supports the required features and logs a warning if not.
- *
- * @param wallet - The wallet to check
- * @param requiredFeatures - The required features configuration
- * @returns true if the wallet supports all required features, false otherwise
- */
-export declare const checkWalletFeatures: (wallet: WalletInfo, requiredFeatures: RequiredFeatures) => boolean;