@heyanon/sdk 2.3.4 → 2.3.6

package/dist/index.js

@@ -580,20 +580,20 @@ function isAddress(value) {
   try {
     result.valid = viem.isAddress(value);
     if (result.valid) {
-      result.walletType = "evm" /* EVM */;
+      result.type = "evm" /* EVM */;
     }
   } catch (_error) {
   }
   try {
     solana_exports.utils.toPublicKey(value);
     result.valid = true;
-    result.walletType = "solana" /* SOLANA */;
+    result.type = "solana" /* SOLANA */;
   } catch (_error) {
   }
   try {
     ton.Address.parse(value);
     result.valid = true;
-    result.walletType = "ton" /* TON */;
+    result.type = "ton" /* TON */;
   } catch (_error) {
   }
   return result;

package/dist/index.mjs

@@ -578,20 +578,20 @@ function isAddress(value) {
   try {
     result.valid = isAddress$1(value);
     if (result.valid) {
-      result.walletType = "evm" /* EVM */;
+      result.type = "evm" /* EVM */;
     }
   } catch (_error) {
   }
   try {
     solana_exports.utils.toPublicKey(value);
     result.valid = true;
-    result.walletType = "solana" /* SOLANA */;
+    result.type = "solana" /* SOLANA */;
   } catch (_error) {
   }
   try {
     Address.parse(value);
     result.valid = true;
-    result.walletType = "ton" /* TON */;
+    result.type = "ton" /* TON */;
   } catch (_error) {
   }
   return result;

package/dist/utils/is-address.d.ts

@@ -1,7 +1,79 @@
 import { WalletType } from '../blockchain';
+/**
+ * Result object returned by the isAddress function
+ * @interface IsAddressResult
+ */
 interface IsAddressResult {
+    /** Whether the address is valid for any supported blockchain */
     valid: boolean;
-    walletType?: WalletType;
+    /** The type of wallet/blockchain the address belongs to (EVM, Solana, or TON) */
+    type?: WalletType;
 }
+/**
+ * Validates a blockchain address and determines its type across multiple blockchain networks
+ *
+ * This function checks if a given string is a valid blockchain address for any of the
+ * supported networks: EVM-compatible chains (Ethereum, Polygon, BSC, etc.), Solana, or TON.
+ * It returns both the validation result and the detected wallet type.
+ *
+ * @param value - The address string to validate
+ * @returns Object containing validation result and wallet type
+ *
+ * @example
+ * ```typescript
+ * // EVM address validation
+ * const evmResult = isAddress('0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0');
+ * // Returns: { valid: true, type: WalletType.EVM }
+ *
+ * // Solana address validation
+ * const solanaResult = isAddress('DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK');
+ * // Returns: { valid: true, type: WalletType.SOLANA }
+ *
+ * // TON address validation
+ * const tonResult = isAddress('EQD4FPq-PRDieyQKkizFTRtSDyucUIqrj0v_zXJmqaDp6_0t');
+ * // Returns: { valid: true, type: WalletType.TON }
+ *
+ * // Invalid address
+ * const invalidResult = isAddress('invalid-address');
+ * // Returns: { valid: false }
+ *
+ * // Routing transactions based on address type
+ * async function sendTokens(recipientAddress: string, amount: bigint) {
+ *   const { valid, type } = isAddress(recipientAddress);
+ *
+ *   if (!valid) {
+ *     throw new Error('Invalid recipient address');
+ *   }
+ *
+ *   switch (type) {
+ *     case type.EVM:
+ *       return await options.evm.sendTransactions({
+ *         transactions: [{ to: recipientAddress, value: amount }]
+ *       });
+ *
+ *     case type.SOLANA:
+ *       return await options.solana.sendTransactions({
+ *         transactions: [{ instructions: [...] }]
+ *       });
+ *
+ *     case type.TON:
+ *       return await options.ton.sendTransactions({
+ *         transactions: [{ to: recipientAddress, value: amount }]
+ *       });
+ *   }
+ * }
+ *
+ * // User input validation
+ * function validateUserInput(userAddress: string) {
+ *   const { valid, type } = isAddress(userAddress);
+ *
+ *   if (!valid) {
+ *     return { success: false, error: 'Invalid address format' };
+ *   }
+ *
+ *   return { success: true, type, address: userAddress };
+ * }
+ * ```
+ */
 export declare function isAddress(value: string): IsAddressResult;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyanon/sdk",
-  "version": "2.3.4",
+  "version": "2.3.6",
   "license": "MIT",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",