@blazium/ton-connect-mobile 1.2.0 → 1.2.3

package/src/types/index.ts

@@ -187,6 +187,11 @@ export interface PlatformAdapter {
   randomBytes(length: number): Promise<Uint8Array>;
 }
 
+/**
+ * Network type
+ */
+export type Network = 'mainnet' | 'testnet';
+
 /**
  * SDK configuration
  */
@@ -211,6 +216,12 @@ export interface TonConnectMobileConfig {
    * Available: 'Tonkeeper', 'MyTonWallet', 'Wallet in Telegram', 'Tonhub'
    */
   preferredWallet?: string;
+  /** Network (mainnet/testnet) - default: 'mainnet' */
+  network?: Network;
+  /** TON API endpoint for balance checking (optional)
+   * Default: 'https://toncenter.com/api/v2' for mainnet, 'https://testnet.toncenter.com/api/v2' for testnet
+   */
+  tonApiEndpoint?: string;
 }
 
 /**
@@ -218,3 +229,44 @@ export interface TonConnectMobileConfig {
  */
 export type StatusChangeCallback = (status: ConnectionStatus) => void;
 
+/**
+ * Event types for TonConnectMobile
+ */
+export type TonConnectEventType = 'connect' | 'disconnect' | 'transaction' | 'error' | 'statusChange';
+
+/**
+ * Event listener callback
+ */
+export type TonConnectEventListener<T = any> = (data: T) => void;
+
+/**
+ * Transaction status
+ */
+export type TransactionStatus = 'pending' | 'confirmed' | 'failed' | 'unknown';
+
+/**
+ * Transaction status response
+ */
+export interface TransactionStatusResponse {
+  /** Transaction status */
+  status: TransactionStatus;
+  /** Transaction hash (if available) */
+  hash?: string;
+  /** Block number (if confirmed) */
+  blockNumber?: number;
+  /** Error message (if failed) */
+  error?: string;
+}
+
+/**
+ * Balance response
+ */
+export interface BalanceResponse {
+  /** Balance in nanotons */
+  balance: string;
+  /** Balance in TON (formatted) */
+  balanceTon: string;
+  /** Network */
+  network: Network;
+}
+

package/src/utils/transactionBuilder.ts

@@ -41,12 +41,32 @@ export function buildTransferTransaction(
   amount: number | string,
   validUntil?: number
 ): SendTransactionRequest {
+  // Validate address
+  if (!to || typeof to !== 'string') {
+    throw new Error('Recipient address is required');
+  }
+  if (!isValidTonAddress(to)) {
+    throw new Error(`Invalid TON address format: ${to}`);
+  }
+
+  // Validate amount
+  const nanoAmount = tonToNano(amount);
+  if (BigInt(nanoAmount) <= 0n) {
+    throw new Error('Transaction amount must be greater than 0');
+  }
+
+  // Validate validUntil
+  const expiration = validUntil || Date.now() + 5 * 60 * 1000; // 5 minutes default
+  if (expiration <= Date.now()) {
+    throw new Error('Transaction expiration must be in the future');
+  }
+
   return {
-    validUntil: validUntil || Date.now() + 5 * 60 * 1000, // 5 minutes default
+    validUntil: expiration,
     messages: [
       {
         address: to,
-        amount: tonToNano(amount),
+        amount: nanoAmount,
       },
     ],
   };
@@ -62,12 +82,41 @@ export function buildMultiTransferTransaction(
   transfers: Array<{ to: string; amount: number | string }>,
   validUntil?: number
 ): SendTransactionRequest {
-  return {
-    validUntil: validUntil || Date.now() + 5 * 60 * 1000,
-    messages: transfers.map((transfer) => ({
+  // Validate transfers array
+  if (!transfers || !Array.isArray(transfers) || transfers.length === 0) {
+    throw new Error('Transfers array is required and cannot be empty');
+  }
+  if (transfers.length > 255) {
+    throw new Error('Maximum 255 transfers allowed per transaction');
+  }
+
+  // Validate each transfer
+  const messages = transfers.map((transfer, index) => {
+    if (!transfer.to || typeof transfer.to !== 'string') {
+      throw new Error(`Transfer ${index + 1}: Recipient address is required`);
+    }
+    if (!isValidTonAddress(transfer.to)) {
+      throw new Error(`Transfer ${index + 1}: Invalid TON address format: ${transfer.to}`);
+    }
+    const nanoAmount = tonToNano(transfer.amount);
+    if (BigInt(nanoAmount) <= 0n) {
+      throw new Error(`Transfer ${index + 1}: Amount must be greater than 0`);
+    }
+    return {
       address: transfer.to,
-      amount: tonToNano(transfer.amount),
-    })),
+      amount: nanoAmount,
+    };
+  });
+
+  // Validate validUntil
+  const expiration = validUntil || Date.now() + 5 * 60 * 1000;
+  if (expiration <= Date.now()) {
+    throw new Error('Transaction expiration must be in the future');
+  }
+
+  return {
+    validUntil: expiration,
+    messages,
   };
 }