@dynamic-labs/ton 4.52.4 → 4.53.0

package/CHANGELOG.md

@@ -1,4 +1,34 @@
 
+## [4.53.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.52.5...v4.53.0) (2026-01-13)
+
+
+### Features
+
+* add contract deployment bundle into first transaction ([#10089](https://github.com/dynamic-labs/dynamic-auth/issues/10089)) ([1291f2a](https://github.com/dynamic-labs/dynamic-auth/commit/1291f2ae2d4881c047a3e6e4e6cf4281a868f626))
+* add ton balance to wallet connector ([#10186](https://github.com/dynamic-labs/dynamic-auth/issues/10186)) ([7b1bdf3](https://github.com/dynamic-labs/dynamic-auth/commit/7b1bdf38f9685cb74974de0592e0e824146d343d))
+* add waas btc support in demo ([#10192](https://github.com/dynamic-labs/dynamic-auth/issues/10192)) ([36aedd6](https://github.com/dynamic-labs/dynamic-auth/commit/36aedd614b7fe781c7150efb4c1a77a5fe55a1ae))
+* merge waas-bitcoin to existing bitcoin package ([#10190](https://github.com/dynamic-labs/dynamic-auth/issues/10190)) ([70dfc6b](https://github.com/dynamic-labs/dynamic-auth/commit/70dfc6baca4f69af56a10ad29faca0fb361ec17b))
+* update sdk-react-core to support btc from waas ([#10191](https://github.com/dynamic-labs/dynamic-auth/issues/10191)) ([c39a99c](https://github.com/dynamic-labs/dynamic-auth/commit/c39a99c544e567a75f43e9b83d4969b70d3c01d1))
+
+
+### Bug Fixes
+
+* udpate ESM compatibility issues in build scripts for iconic ([#10201](https://github.com/dynamic-labs/dynamic-auth/issues/10201)) ([55059ad](https://github.com/dynamic-labs/dynamic-auth/commit/55059ad8c874b7f04699c277467242783f5d6eff))
+
+### [4.52.5](https://github.com/dynamic-labs/dynamic-auth/compare/v4.52.4...v4.52.5) (2026-01-08)
+
+
+### Features
+
+* add generate ton connect proof method to demo v2 ([#9989](https://github.com/dynamic-labs/dynamic-auth/issues/9989)) ([9727e2e](https://github.com/dynamic-labs/dynamic-auth/commit/9727e2e25742c4a2b0345c8c4a83159cc88892d7))
+* add waas ton to demo v2 ([#9988](https://github.com/dynamic-labs/dynamic-auth/issues/9988)) ([8edda43](https://github.com/dynamic-labs/dynamic-auth/commit/8edda43aeb58b5a77aef197d6cf20c1b633d1610))
+
+
+### Bug Fixes
+
+* trigger onAuthSuccess callback for passkey MFA flows ([#10174](https://github.com/dynamic-labs/dynamic-auth/issues/10174)) ([a37753a](https://github.com/dynamic-labs/dynamic-auth/commit/a37753afd6f3b814198d2acf6dc267feb11021e2))
+* **wallet-book:** add mobile app IDs for Binance Wallet to fix mobile filtering ([#10176](https://github.com/dynamic-labs/dynamic-auth/issues/10176)) ([010a48f](https://github.com/dynamic-labs/dynamic-auth/commit/010a48fd28a49861a26b9188babe4a174cefeedb))
+
 ### [4.52.4](https://github.com/dynamic-labs/dynamic-auth/compare/v4.52.3...v4.52.4) (2026-01-07)
 
 ### [4.52.3](https://github.com/dynamic-labs/dynamic-auth/compare/v4.52.2...v4.52.3) (2026-01-06)

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/ton",
-  "version": "4.52.4",
+  "version": "4.53.0",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,10 +18,16 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.52.4",
-    "@dynamic-labs/types": "4.52.4",
-    "@dynamic-labs/utils": "4.52.4",
-    "@dynamic-labs/wallet-connector-core": "4.52.4",
+    "@dynamic-labs/assert-package-version": "4.53.0",
+    "@dynamic-labs/logger": "4.53.0",
+    "@dynamic-labs/sdk-api-core": "0.0.843",
+    "@dynamic-labs/types": "4.53.0",
+    "@dynamic-labs/utils": "4.53.0",
+    "@dynamic-labs/waas": "4.53.0",
+    "@dynamic-labs/wallet-book": "4.53.0",
+    "@dynamic-labs/wallet-connector-core": "4.53.0",
+    "@ton/core": "0.62.0",
+    "@ton/crypto": "3.3.0",
     "@ton/ton": "16.0.0"
   }
 }

package/src/TonWalletConnector.cjs

@@ -0,0 +1,87 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../_virtual/_tslib.cjs');
+var ton = require('@ton/ton');
+var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+var utils = require('@dynamic-labs/utils');
+var TonWallet = require('./wallet/TonWallet.cjs');
+var types = require('./types.cjs');
+
+/**
+ * Base TonWalletConnector class for TON blockchain wallets.
+ * Provides core functionality for connecting to and interacting with TON wallets.
+ */
+class TonWalletConnector extends walletConnectorCore.WalletConnectorBase {
+    constructor(opts) {
+        super(opts);
+        this.ChainWallet = TonWallet.TonWallet;
+        this.connectedChain = 'TON';
+        this.supportedChains = ['TON'];
+        this.tonNetworks = opts.tonNetworks;
+    }
+    /**
+     * Get the enabled networks for the wallet.
+     * Networks are configured via project settings.
+     */
+    getEnabledNetworks() {
+        return this.tonNetworks;
+    }
+    /**
+     * Get the current network ID.
+     * Returns the first network's networkId as default.
+     */
+    getNetwork() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            return ((_c = (_b = (_a = this.tonNetworks) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.networkId) === null || _c === void 0 ? void 0 : _c.toString()) || types.CHAIN.MAINNET;
+        });
+    }
+    /**
+     * Get the currently selected network.
+     */
+    getSelectedNetwork() {
+        var _a;
+        return (_a = this.tonNetworks) === null || _a === void 0 ? void 0 : _a[0];
+    }
+    /**
+     * Get TonClient for the current or specified network.
+     */
+    getTonClient(chainId) {
+        var _a, _b, _c;
+        const selectedNetwork = this.getSelectedNetwork();
+        const targetChainId = chainId || (selectedNetwork === null || selectedNetwork === void 0 ? void 0 : selectedNetwork.chainId);
+        const network = chainId
+            ? (_a = this.tonNetworks) === null || _a === void 0 ? void 0 : _a.find((net) => net.chainId === targetChainId)
+            : selectedNetwork;
+        if (!network) {
+            throw new utils.DynamicError(`Network configuration not found for chainId: ${targetChainId}`);
+        }
+        const endpoint = ((_b = network.privateCustomerRpcUrls) === null || _b === void 0 ? void 0 : _b[0]) || ((_c = network.rpcUrls) === null || _c === void 0 ? void 0 : _c[0]);
+        if (!endpoint) {
+            throw new utils.DynamicError(`No RPC endpoint found for chainId: ${targetChainId}`);
+        }
+        return new ton.TonClient({ endpoint });
+    }
+    /**
+     * Get the balance for a TON address.
+     */
+    getBalance(address) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const client = this.getTonClient();
+                const tonAddress = ton.Address.parse(address);
+                const balanceNano = yield client.getBalance(tonAddress);
+                return ton.fromNano(balanceNano);
+            }
+            catch (error) {
+                walletConnectorCore.logger.error('Error fetching TON balance', { address, error });
+                return undefined;
+            }
+        });
+    }
+}
+
+exports.TonWalletConnector = TonWalletConnector;

package/src/TonWalletConnector.d.ts

@@ -0,0 +1,38 @@
+import { TonClient } from '@ton/ton';
+import { Chain, WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
+import { GenericNetwork } from '@dynamic-labs/types';
+import { TonWallet } from './wallet/TonWallet';
+import { TonWalletConnectorOpts } from './types';
+/**
+ * Base TonWalletConnector class for TON blockchain wallets.
+ * Provides core functionality for connecting to and interacting with TON wallets.
+ */
+export declare abstract class TonWalletConnector extends WalletConnectorBase<typeof TonWallet> {
+    ChainWallet: typeof TonWallet;
+    connectedChain: Chain;
+    supportedChains: Chain[];
+    tonNetworks: GenericNetwork[];
+    constructor(opts: TonWalletConnectorOpts);
+    /**
+     * Get the enabled networks for the wallet.
+     * Networks are configured via project settings.
+     */
+    getEnabledNetworks(): GenericNetwork[];
+    /**
+     * Get the current network ID.
+     * Returns the first network's networkId as default.
+     */
+    getNetwork(): Promise<string | undefined>;
+    /**
+     * Get the currently selected network.
+     */
+    getSelectedNetwork(): GenericNetwork | undefined;
+    /**
+     * Get TonClient for the current or specified network.
+     */
+    getTonClient(chainId?: string): TonClient;
+    /**
+     * Get the balance for a TON address.
+     */
+    getBalance(address: string): Promise<string | undefined>;
+}

package/src/TonWalletConnector.js

@@ -0,0 +1,83 @@
+'use client'
+import { __awaiter } from '../_virtual/_tslib.js';
+import { TonClient, Address, fromNano } from '@ton/ton';
+import { WalletConnectorBase, logger } from '@dynamic-labs/wallet-connector-core';
+import { DynamicError } from '@dynamic-labs/utils';
+import { TonWallet } from './wallet/TonWallet.js';
+import { CHAIN } from './types.js';
+
+/**
+ * Base TonWalletConnector class for TON blockchain wallets.
+ * Provides core functionality for connecting to and interacting with TON wallets.
+ */
+class TonWalletConnector extends WalletConnectorBase {
+    constructor(opts) {
+        super(opts);
+        this.ChainWallet = TonWallet;
+        this.connectedChain = 'TON';
+        this.supportedChains = ['TON'];
+        this.tonNetworks = opts.tonNetworks;
+    }
+    /**
+     * Get the enabled networks for the wallet.
+     * Networks are configured via project settings.
+     */
+    getEnabledNetworks() {
+        return this.tonNetworks;
+    }
+    /**
+     * Get the current network ID.
+     * Returns the first network's networkId as default.
+     */
+    getNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            return ((_c = (_b = (_a = this.tonNetworks) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.networkId) === null || _c === void 0 ? void 0 : _c.toString()) || CHAIN.MAINNET;
+        });
+    }
+    /**
+     * Get the currently selected network.
+     */
+    getSelectedNetwork() {
+        var _a;
+        return (_a = this.tonNetworks) === null || _a === void 0 ? void 0 : _a[0];
+    }
+    /**
+     * Get TonClient for the current or specified network.
+     */
+    getTonClient(chainId) {
+        var _a, _b, _c;
+        const selectedNetwork = this.getSelectedNetwork();
+        const targetChainId = chainId || (selectedNetwork === null || selectedNetwork === void 0 ? void 0 : selectedNetwork.chainId);
+        const network = chainId
+            ? (_a = this.tonNetworks) === null || _a === void 0 ? void 0 : _a.find((net) => net.chainId === targetChainId)
+            : selectedNetwork;
+        if (!network) {
+            throw new DynamicError(`Network configuration not found for chainId: ${targetChainId}`);
+        }
+        const endpoint = ((_b = network.privateCustomerRpcUrls) === null || _b === void 0 ? void 0 : _b[0]) || ((_c = network.rpcUrls) === null || _c === void 0 ? void 0 : _c[0]);
+        if (!endpoint) {
+            throw new DynamicError(`No RPC endpoint found for chainId: ${targetChainId}`);
+        }
+        return new TonClient({ endpoint });
+    }
+    /**
+     * Get the balance for a TON address.
+     */
+    getBalance(address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const client = this.getTonClient();
+                const tonAddress = Address.parse(address);
+                const balanceNano = yield client.getBalance(tonAddress);
+                return fromNano(balanceNano);
+            }
+            catch (error) {
+                logger.error('Error fetching TON balance', { address, error });
+                return undefined;
+            }
+        });
+    }
+}
+
+export { TonWalletConnector };

package/src/index.cjs

@@ -5,9 +5,49 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var assertPackageVersion = require('@dynamic-labs/assert-package-version');
 var _package = require('../package.cjs');
+var TonWalletConnector = require('./TonWalletConnector.cjs');
+var types = require('./types.cjs');
+var TonWallet = require('./wallet/TonWallet.cjs');
+var isTonWallet = require('./wallet/isTonWallet/isTonWallet.cjs');
+var WaasTonWallet = require('./wallet/WaasTonWallet.cjs');
 var TonUiTransaction = require('./utils/TonUiTransaction/TonUiTransaction.cjs');
+var prepareTransaction = require('./utils/prepareTransaction/prepareTransaction.cjs');
+var prepareTonTransfer = require('./utils/prepareTonTransfer/prepareTonTransfer.cjs');
+var prepareJettonTransfer = require('./utils/prepareJettonTransfer/prepareJettonTransfer.cjs');
+var getJettonWalletAddress = require('./utils/getJettonWalletAddress/getJettonWalletAddress.cjs');
+var getWalletSeqno = require('./utils/getWalletSeqno/getWalletSeqno.cjs');
+var executeTransaction = require('./utils/executeTransaction/executeTransaction.cjs');
+var extractDisplayInfoFromRequest = require('./utils/extractDisplayInfoFromRequest/extractDisplayInfoFromRequest.cjs');
+var convertSendTransactionRequest = require('./utils/convertSendTransactionRequest/convertSendTransactionRequest.cjs');
+var generateTonConnectProofHash = require('./utils/generateTonConnectProofHash/generateTonConnectProofHash.cjs');
+require('./utils/logger/logger.cjs');
+require('../_virtual/_tslib.cjs');
+require('@ton/ton');
+var DynamicWaasTonConnector = require('./waas/connector/DynamicWaasTonConnector.cjs');
+var DynamicWaasTonConnectors = require('./waas/DynamicWaasTonConnectors.cjs');
+var DynamicWaasTonSigner = require('./waas/signer/DynamicWaasTonSigner.cjs');
 
 assertPackageVersion.assertPackageVersion('@dynamic-labs/ton', _package.version);
 
+exports.TonWalletConnector = TonWalletConnector.TonWalletConnector;
+Object.defineProperty(exports, 'CHAIN', {
+  enumerable: true,
+  get: function () { return types.CHAIN; }
+});
+exports.TonWallet = TonWallet.TonWallet;
+exports.isTonWallet = isTonWallet.isTonWallet;
+exports.WaasTonWallet = WaasTonWallet.WaasTonWallet;
 exports.NANOTON_PER_TON = TonUiTransaction.NANOTON_PER_TON;
 exports.TonUiTransaction = TonUiTransaction.TonUiTransaction;
+exports.prepareTransaction = prepareTransaction.prepareTransaction;
+exports.prepareTonTransfer = prepareTonTransfer.prepareTonTransfer;
+exports.prepareJettonTransfer = prepareJettonTransfer.prepareJettonTransfer;
+exports.getJettonWalletAddress = getJettonWalletAddress.getJettonWalletAddress;
+exports.getWalletSeqno = getWalletSeqno.getWalletSeqno;
+exports.executeTransaction = executeTransaction.executeTransaction;
+exports.extractDisplayInfoFromRequest = extractDisplayInfoFromRequest.extractDisplayInfoFromRequest;
+exports.convertSendTransactionRequest = convertSendTransactionRequest.convertSendTransactionRequest;
+exports.generateTonConnectProofHash = generateTonConnectProofHash.generateTonConnectProofHash;
+exports.DynamicWaasTonConnector = DynamicWaasTonConnector.DynamicWaasTonConnector;
+exports.DynamicWaasTonConnectors = DynamicWaasTonConnectors.DynamicWaasTonConnectors;
+exports.DynamicWaasTonSigner = DynamicWaasTonSigner.DynamicWaasTonSigner;

package/src/index.d.ts

@@ -1 +1,9 @@
-export * from './utils';
+export { TonWalletConnector } from './TonWalletConnector';
+export * from './types';
+export { TonWallet, isTonWallet, WaasTonWallet } from './wallet';
+export { TonUiTransaction, NANOTON_PER_TON, prepareTransaction, prepareTonTransfer, prepareJettonTransfer, getJettonWalletAddress, getWalletSeqno, executeTransaction, extractDisplayInfoFromRequest, convertSendTransactionRequest, generateTonConnectProofHash, } from './utils';
+export type { PrepareTransactionParams, PrepareTransactionResult, PrepareTonTransferParams, PrepareJettonTransferParams, GetJettonWalletAddressParams, ExecuteTransactionParams, ExecuteTransactionResult, GenerateTonConnectProofHashParams, TransactionRequestDisplayInfo, } from './utils';
+export { DynamicWaasTonConnector } from './waas/connector/DynamicWaasTonConnector';
+export type { DynamicWaasTonConnectorProps } from './waas/connector/DynamicWaasTonConnector';
+export { DynamicWaasTonConnectors } from './waas/DynamicWaasTonConnectors';
+export { DynamicWaasTonSigner } from './waas/signer/DynamicWaasTonSigner';

package/src/index.js

@@ -1,6 +1,26 @@
 'use client'
 import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
 import { version } from '../package.js';
+export { TonWalletConnector } from './TonWalletConnector.js';
+export { CHAIN } from './types.js';
+export { TonWallet } from './wallet/TonWallet.js';
+export { isTonWallet } from './wallet/isTonWallet/isTonWallet.js';
+export { WaasTonWallet } from './wallet/WaasTonWallet.js';
 export { NANOTON_PER_TON, TonUiTransaction } from './utils/TonUiTransaction/TonUiTransaction.js';
+export { prepareTransaction } from './utils/prepareTransaction/prepareTransaction.js';
+export { prepareTonTransfer } from './utils/prepareTonTransfer/prepareTonTransfer.js';
+export { prepareJettonTransfer } from './utils/prepareJettonTransfer/prepareJettonTransfer.js';
+export { getJettonWalletAddress } from './utils/getJettonWalletAddress/getJettonWalletAddress.js';
+export { getWalletSeqno } from './utils/getWalletSeqno/getWalletSeqno.js';
+export { executeTransaction } from './utils/executeTransaction/executeTransaction.js';
+export { extractDisplayInfoFromRequest } from './utils/extractDisplayInfoFromRequest/extractDisplayInfoFromRequest.js';
+export { convertSendTransactionRequest } from './utils/convertSendTransactionRequest/convertSendTransactionRequest.js';
+export { generateTonConnectProofHash } from './utils/generateTonConnectProofHash/generateTonConnectProofHash.js';
+import './utils/logger/logger.js';
+import '../_virtual/_tslib.js';
+import '@ton/ton';
+export { DynamicWaasTonConnector } from './waas/connector/DynamicWaasTonConnector.js';
+export { DynamicWaasTonConnectors } from './waas/DynamicWaasTonConnectors.js';
+export { DynamicWaasTonSigner } from './waas/signer/DynamicWaasTonSigner.js';
 
 assertPackageVersion('@dynamic-labs/ton', version);

package/src/types.cjs

@@ -0,0 +1,13 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Network chain identifier for TON
+ */
+exports.CHAIN = void 0;
+(function (CHAIN) {
+    CHAIN["MAINNET"] = "-239";
+    CHAIN["TESTNET"] = "-3";
+})(exports.CHAIN || (exports.CHAIN = {}));

package/src/types.d.ts

@@ -1,6 +1,82 @@
+import { WalletBookSchema } from '@dynamic-labs/wallet-book';
+import { WalletMetadata } from '@dynamic-labs/wallet-connector-core';
+import { GenericNetwork } from '@dynamic-labs/types';
 /**
- * Type definitions for TON (The Open Network) blockchain integration.
- *
- * This file will contain type definitions for TON-specific types,
- * interfaces, and utilities as the package is developed.
+ * Domain information for TON Connect protocol
  */
+export interface TonConnectDomain {
+    /** Length of domain value in bytes */
+    lengthBytes: number;
+    /** Domain value (e.g., example.com) */
+    value: string;
+}
+/**
+ * Complete TON Connect proof object
+ */
+export interface TonConnectProof {
+    /** Wallet address string */
+    address: string;
+    /** Domain information */
+    domain: TonConnectDomain;
+    /** Unix timestamp in seconds */
+    timestamp: number;
+    /** Payload string */
+    payload: string;
+    /** Signature as base64 string */
+    signature: string;
+}
+/**
+ * Network chain identifier for TON
+ */
+export declare enum CHAIN {
+    MAINNET = "-239",
+    TESTNET = "-3"
+}
+/**
+ * TON Connect compatible transaction request
+ * @see https://ton-connect.github.io/sdk/interfaces/_tonconnect_ui.SendTransactionRequest.html
+ */
+export interface SendTransactionRequest {
+    /** The sender address from which DApp intends to send the transaction */
+    from?: string;
+    /** Messages to send */
+    messages: {
+        /** Receiver's address */
+        address: string;
+        /** Amount to send in nanoTon */
+        amount: string;
+        /** Extra currencies to send */
+        extraCurrency?: {
+            [k: number]: string;
+        };
+        /** Contract specific data to add to the transaction (base64 encoded BOC) */
+        payload?: string;
+        /** Contract specific data to add to the transaction (base64 encoded BOC) */
+        stateInit?: string;
+    }[];
+    /** The network where DApp intends to send the transaction */
+    network?: CHAIN;
+    /** Sending transaction deadline in unix epoch seconds */
+    validUntil: number;
+}
+/**
+ * Generic transaction data used internally for signing and execution
+ */
+export interface TonTransactionData {
+    /** Sender wallet address */
+    address: string;
+    /** Current wallet seqno */
+    seqno: number;
+    /** Base64-encoded message body (the transaction to be signed) */
+    messageBody: string;
+    /** Transaction timeout in seconds */
+    timeout: number;
+}
+/**
+ * Options for creating a TonWalletConnector
+ */
+export type TonWalletConnectorOpts = {
+    walletBook: WalletBookSchema;
+    tonNetworks: GenericNetwork[];
+    metadata?: WalletMetadata;
+};

package/src/types.js

@@ -0,0 +1,11 @@
+'use client'
+/**
+ * Network chain identifier for TON
+ */
+var CHAIN;
+(function (CHAIN) {
+    CHAIN["MAINNET"] = "-239";
+    CHAIN["TESTNET"] = "-3";
+})(CHAIN || (CHAIN = {}));
+
+export { CHAIN };

package/src/utils/convertSendTransactionRequest/convertSendTransactionRequest.cjs

@@ -0,0 +1,117 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var ton = require('@ton/ton');
+var core = require('@ton/core');
+
+/**
+ * Parses a base64 BOC payload into a Cell
+ *
+ * @param payload - Base64 encoded BOC string
+ * @returns Parsed Cell
+ */
+const parsePayload = (payload) => {
+    if (!payload) {
+        return ton.beginCell().endCell();
+    }
+    try {
+        return ton.Cell.fromBase64(payload);
+    }
+    catch (e) {
+        throw new Error(`Invalid payload BOC: ${e instanceof Error ? e.message : String(e)}`);
+    }
+};
+/**
+ * Parses a base64 BOC stateInit into code and data cells
+ *
+ * @param stateInit - Base64 encoded BOC string
+ * @returns Object with code and data cells, or undefined if no stateInit
+ */
+const parseStateInit = (stateInit) => {
+    if (!stateInit) {
+        return undefined;
+    }
+    try {
+        const stateInitCell = ton.Cell.fromBase64(stateInit);
+        const slice = stateInitCell.beginParse();
+        slice.skip(2); // skip split_depth and special flags
+        return {
+            code: slice.loadRef(),
+            data: slice.loadRef(),
+        };
+    }
+    catch (e) {
+        throw new Error(`Invalid stateInit BOC: ${e instanceof Error ? e.message : String(e)}`);
+    }
+};
+/**
+ * Determines the bounce flag from address format
+ *
+ * In base64 user-friendly format:
+ * - Bounceable addresses start with: EQ (mainnet) or kQ (testnet)
+ * - Non-bounceable addresses start with: UQ (mainnet) or 0Q (testnet)
+ * Default to true (bounceable) for safety with smart contracts
+ *
+ * @param address - TON address string
+ * @returns Boolean bounce flag
+ */
+// Non-bounceable addresses start with UQ (mainnet) or 0Q (testnet)
+// All other formats (EQ, kQ, raw) default to bounceable
+const determineBounceFlag = (address) => !address.startsWith('UQ') && !address.startsWith('0Q');
+/**
+ * Creates an internal message object
+ *
+ * @param destAddr - Destination address
+ * @param amount - Amount in nanotons
+ * @param body - Message body cell
+ * @param bounce - Bounce flag
+ * @param init - Optional state init with code and data
+ * @returns Internal message object
+ */
+const createInternalMessage = (destAddr, amount, body, bounce, init) => (Object.assign({ body, info: {
+        bounce,
+        bounced: false,
+        createdAt: 0,
+        createdLt: BigInt(0),
+        dest: destAddr,
+        forwardFee: BigInt(0),
+        ihrDisabled: true,
+        ihrFee: BigInt(0),
+        src: null,
+        type: 'internal',
+        value: { coins: amount },
+    } }, (init && { init })));
+/**
+ * Creates an OutActionSendMsg from an internal message
+ *
+ * @param internalMessage - The internal message object
+ * @returns OutActionSendMsg action
+ */
+const createSendMsgAction = (internalMessage) => ({
+    mode: core.SendMode.PAY_GAS_SEPARATELY | core.SendMode.IGNORE_ERRORS,
+    outMsg: internalMessage,
+    type: 'sendMsg',
+});
+/**
+ * Converts a TON Connect SendTransactionRequest to internal actions array
+ *
+ * @param request - TON Connect transaction request
+ * @returns Array of OutActionSendMsg actions
+ */
+const convertSendTransactionRequest = (request) => {
+    const actions = [];
+    for (const msg of request.messages) {
+        const destAddr = ton.Address.parse(msg.address);
+        const amount = BigInt(msg.amount);
+        const body = parsePayload(msg.payload);
+        const init = parseStateInit(msg.stateInit);
+        const bounce = determineBounceFlag(msg.address);
+        const internalMessage = createInternalMessage(destAddr, amount, body, bounce, init);
+        actions.push(createSendMsgAction(internalMessage));
+    }
+    return actions;
+};
+
+exports.convertSendTransactionRequest = convertSendTransactionRequest;

package/src/utils/convertSendTransactionRequest/convertSendTransactionRequest.d.ts

@@ -0,0 +1,9 @@
+import { OutActionSendMsg } from '@ton/core';
+import { SendTransactionRequest } from '../../types';
+/**
+ * Converts a TON Connect SendTransactionRequest to internal actions array
+ *
+ * @param request - TON Connect transaction request
+ * @returns Array of OutActionSendMsg actions
+ */
+export declare const convertSendTransactionRequest: (request: SendTransactionRequest) => OutActionSendMsg[];