@sudobility/types 1.8.21

package/dist/utils/auth/auth.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Authentication utilities for wallet-based authentication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAuthMessage = generateAuthMessage;
+exports.isAuthExpired = isAuthExpired;
+exports.getAuthStatusText = getAuthStatusText;
+exports.canAccessProtectedFeatures = canAccessProtectedFeatures;
+exports.isAuthStatusConnected = isAuthStatusConnected;
+exports.generateNonce = generateNonce;
+exports.extractNonceFromMessage = extractNonceFromMessage;
+exports.isValidNonce = isValidNonce;
+const enums_1 = require("../../types/business/enums");
+/**
+ * Generate an authentication message with a nonce
+ */
+function generateAuthMessage(nonce) {
+    const actualNonce = nonce || `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    return `Authenticate with 0xMail\nNonce: ${actualNonce}`;
+}
+/**
+ * Check if authentication is expired
+ * @param createdAt - The date when authentication was created
+ * @param expirationHours - Number of hours until expiration (default: 24)
+ */
+function isAuthExpired(createdAt, expirationHours = 24) {
+    const expirationTime = new Date(createdAt.getTime() + expirationHours * 60 * 60 * 1000);
+    return new Date() > expirationTime;
+}
+/**
+ * Get human-readable text for authentication status
+ */
+function getAuthStatusText(status) {
+    switch (status) {
+        case enums_1.AuthStatus.DISCONNECTED:
+            return 'Not connected';
+        case enums_1.AuthStatus.CONNECTED:
+            return 'Connected - Please verify';
+        case enums_1.AuthStatus.VERIFIED:
+            return 'Authenticated';
+        default:
+            return 'Unknown status';
+    }
+}
+/**
+ * Check if user can access protected features
+ */
+function canAccessProtectedFeatures(status) {
+    return status === enums_1.AuthStatus.VERIFIED;
+}
+/**
+ * Check if auth status indicates wallet is connected (either connected or verified)
+ */
+function isAuthStatusConnected(status) {
+    return status === enums_1.AuthStatus.CONNECTED || status === enums_1.AuthStatus.VERIFIED;
+}
+/**
+ * Generate a random nonce for authentication
+ */
+function generateNonce() {
+    return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Extract nonce from an authentication message
+ */
+function extractNonceFromMessage(message) {
+    const match = message.match(/Nonce:\s*(.+)$/m);
+    return match ? match[1].trim() : undefined;
+}
+/**
+ * Validate that a nonce meets basic requirements
+ */
+function isValidNonce(nonce) {
+    if (!nonce || typeof nonce !== 'string') {
+        return false;
+    }
+    // Nonce should be at least 10 characters
+    if (nonce.length < 10) {
+        return false;
+    }
+    // Nonce should not be too old (check if it starts with a timestamp)
+    const parts = nonce.split('-');
+    if (parts.length >= 2) {
+        const timestamp = parseInt(parts[0], 10);
+        if (!isNaN(timestamp)) {
+            // Check if timestamp is within last 24 hours
+            const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
+            if (timestamp < oneDayAgo) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=auth.js.map

package/dist/utils/auth/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/utils/auth/auth.ts"],"names":[],"mappings":"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"}

package/dist/utils/auth/index.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidNonce = exports.isAuthStatusConnected = exports.isAuthExpired = exports.getAuthStatusText = exports.generateNonce = exports.generateAuthMessage = exports.extractNonceFromMessage = exports.canAccessProtectedFeatures = void 0;
+// Authentication utilities
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "canAccessProtectedFeatures", { enumerable: true, get: function () { return auth_1.canAccessProtectedFeatures; } });
+Object.defineProperty(exports, "extractNonceFromMessage", { enumerable: true, get: function () { return auth_1.extractNonceFromMessage; } });
+Object.defineProperty(exports, "generateAuthMessage", { enumerable: true, get: function () { return auth_1.generateAuthMessage; } });
+Object.defineProperty(exports, "generateNonce", { enumerable: true, get: function () { return auth_1.generateNonce; } });
+Object.defineProperty(exports, "getAuthStatusText", { enumerable: true, get: function () { return auth_1.getAuthStatusText; } });
+Object.defineProperty(exports, "isAuthExpired", { enumerable: true, get: function () { return auth_1.isAuthExpired; } });
+Object.defineProperty(exports, "isAuthStatusConnected", { enumerable: true, get: function () { return auth_1.isAuthStatusConnected; } });
+Object.defineProperty(exports, "isValidNonce", { enumerable: true, get: function () { return auth_1.isValidNonce; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/auth/index.d.ts

@@ -0,0 +1,2 @@
+export { canAccessProtectedFeatures, extractNonceFromMessage, generateAuthMessage, generateNonce, getAuthStatusText, isAuthExpired, isAuthStatusConnected, isValidNonce, } from './auth';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,YAAY,GACb,MAAM,QAAQ,CAAC"}

package/dist/utils/auth/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidNonce = exports.isAuthStatusConnected = exports.isAuthExpired = exports.getAuthStatusText = exports.generateNonce = exports.generateAuthMessage = exports.extractNonceFromMessage = exports.canAccessProtectedFeatures = void 0;
+// Authentication utilities
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "canAccessProtectedFeatures", { enumerable: true, get: function () { return auth_1.canAccessProtectedFeatures; } });
+Object.defineProperty(exports, "extractNonceFromMessage", { enumerable: true, get: function () { return auth_1.extractNonceFromMessage; } });
+Object.defineProperty(exports, "generateAuthMessage", { enumerable: true, get: function () { return auth_1.generateAuthMessage; } });
+Object.defineProperty(exports, "generateNonce", { enumerable: true, get: function () { return auth_1.generateNonce; } });
+Object.defineProperty(exports, "getAuthStatusText", { enumerable: true, get: function () { return auth_1.getAuthStatusText; } });
+Object.defineProperty(exports, "isAuthExpired", { enumerable: true, get: function () { return auth_1.isAuthExpired; } });
+Object.defineProperty(exports, "isAuthStatusConnected", { enumerable: true, get: function () { return auth_1.isAuthStatusConnected; } });
+Object.defineProperty(exports, "isValidNonce", { enumerable: true, get: function () { return auth_1.isValidNonce; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/auth/index.ts"],"names":[],"mappings":";;;AAAA,2BAA2B;AAC3B,+BASgB;AARd,kHAAA,0BAA0B,OAAA;AAC1B,+GAAA,uBAAuB,OAAA;AACvB,2GAAA,mBAAmB,OAAA;AACnB,qGAAA,aAAa,OAAA;AACb,yGAAA,iBAAiB,OAAA;AACjB,qGAAA,aAAa,OAAA;AACb,6GAAA,qBAAqB,OAAA;AACrB,oGAAA,YAAY,OAAA"}

package/dist/utils/blockchain/address.cjs

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Blockchain address utilities for multi-chain support
+ *
+ * Provides validation and detection for various blockchain address formats
+ * including EVM addresses, Solana addresses, ENS names, and SNS names.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressType = void 0;
+exports.isENSName = isENSName;
+exports.isSNSName = isSNSName;
+exports.getAddressType = getAddressType;
+exports.isValidWalletAddress = isValidWalletAddress;
+exports.isValidSignature = isValidSignature;
+exports.parseEmailAddress = parseEmailAddress;
+exports.formatWalletAddress = formatWalletAddress;
+exports.getChainDisplayName = getChainDisplayName;
+const enums_1 = require("../../types/business/enums");
+// Import base validation functions from common types
+const common_1 = require("../../types/blockchain/common");
+/**
+ * Address type enumeration
+ */
+var AddressType;
+(function (AddressType) {
+    AddressType["EVMAddress"] = "EVMAddress";
+    AddressType["SolanaAddress"] = "SolanaAddress";
+    AddressType["ENSName"] = "ENSName";
+    AddressType["SNSName"] = "SNSName";
+    AddressType["Unknown"] = "Unknown";
+})(AddressType || (exports.AddressType = AddressType = {}));
+// Address validation functions are now imported directly from common.ts
+// Use isEvmAddress and isSolanaAddress from '../../types/blockchain/common'
+/**
+ * Check if address is an ENS name (.eth or .box)
+ */
+function isENSName(address) {
+    const lowerAddress = address.toLowerCase();
+    // ENS names end with .eth or .box
+    if (!lowerAddress.endsWith('.eth') && !lowerAddress.endsWith('.box')) {
+        return false;
+    }
+    // Extract the name part (without .eth or .box)
+    const nameWithoutTLD = lowerAddress.endsWith('.eth')
+        ? lowerAddress.slice(0, -4)
+        : lowerAddress.slice(0, -4);
+    if (nameWithoutTLD.length === 0) {
+        return false;
+    }
+    // ENS names can have multiple labels separated by dots
+    const labels = nameWithoutTLD.split('.');
+    // Each label must be valid
+    const validLabelRegex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+    for (const label of labels) {
+        if (label.length === 0 || !validLabelRegex.test(label)) {
+            return false;
+        }
+        // No consecutive hyphens allowed
+        if (label.includes('--')) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Check if address is an SNS name (Solana name service)
+ * Supports: .sol, .abc, .bonk, .poor, .gm, .dao, .defi, .web3
+ */
+function isSNSName(address) {
+    const lowerAddress = address.toLowerCase();
+    // List of supported Solana name extensions
+    const snsExtensions = [
+        '.sol',
+        '.abc',
+        '.bonk',
+        '.poor',
+        '.gm',
+        '.dao',
+        '.defi',
+        '.web3',
+    ];
+    // Check if address ends with any supported extension
+    const matchingExtension = snsExtensions.find((ext) => lowerAddress.endsWith(ext));
+    if (!matchingExtension) {
+        return false;
+    }
+    // Extract the name part (without the extension)
+    const nameWithoutTLD = lowerAddress.slice(0, -matchingExtension.length);
+    if (nameWithoutTLD.length === 0) {
+        return false;
+    }
+    // SNS names can have multiple labels separated by dots
+    const labels = nameWithoutTLD.split('.');
+    // Each label must be valid
+    const validLabelRegex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+    for (const label of labels) {
+        if (label.length === 0 || !validLabelRegex.test(label)) {
+            return false;
+        }
+        // No consecutive hyphens allowed
+        if (label.includes('--')) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Determine the address type from a string
+ * Case insensitive as addresses/names are often case insensitive
+ */
+function getAddressType(address) {
+    if (!address || typeof address !== 'string') {
+        return AddressType.Unknown;
+    }
+    // Convert to lowercase for case-insensitive comparison
+    const trimmedAddress = address.trim();
+    const lowerAddress = trimmedAddress.toLowerCase();
+    // Check for ENS names (.eth or .box domains)
+    if (isENSName(lowerAddress)) {
+        return AddressType.ENSName;
+    }
+    // Check for SNS names (.sol domain)
+    if (isSNSName(lowerAddress)) {
+        return AddressType.SNSName;
+    }
+    // Check for EVM address (0x followed by 40 hex characters)
+    if ((0, common_1.isEvmAddress)(trimmedAddress)) {
+        return AddressType.EVMAddress;
+    }
+    // Check for Solana address (base58 encoded, 32-44 characters)
+    if ((0, common_1.isSolanaAddress)(trimmedAddress)) {
+        return AddressType.SolanaAddress;
+    }
+    return AddressType.Unknown;
+}
+/**
+ * Validate a wallet address for a specific chain type
+ */
+function isValidWalletAddress(address, chainType) {
+    if (!address || typeof address !== 'string') {
+        return false;
+    }
+    const addressType = getAddressType(address);
+    switch (chainType) {
+        case enums_1.ChainType.EVM:
+            return (addressType === AddressType.EVMAddress ||
+                addressType === AddressType.ENSName);
+        case enums_1.ChainType.SOLANA:
+            return (addressType === AddressType.SolanaAddress ||
+                addressType === AddressType.SNSName);
+        default:
+            // Unknown chain type, accept any known address format
+            return addressType !== AddressType.Unknown;
+    }
+}
+/**
+ * Check if a signature is valid for a specific chain type
+ */
+function isValidSignature(signature, chainType) {
+    if (!signature || typeof signature !== 'string') {
+        return false;
+    }
+    switch (chainType) {
+        case enums_1.ChainType.EVM:
+            // EVM signature validation (0x followed by 130 hex characters)
+            return /^0x[a-fA-F0-9]{130}$/.test(signature);
+        case enums_1.ChainType.SOLANA:
+            // Solana signature validation (base58 encoded, typically 87-88 characters)
+            return /^[1-9A-HJ-NP-Za-km-z]{87,88}$/.test(signature);
+        default:
+            // Basic validation for unknown chain types
+            return signature.length > 50;
+    }
+}
+/**
+ * Parse an email address into its components
+ */
+function parseEmailAddress(email) {
+    if (!email || typeof email !== 'string') {
+        return undefined;
+    }
+    const parts = email.split('@');
+    if (parts.length !== 2) {
+        return undefined;
+    }
+    const [address, domain] = parts;
+    if (!address || !domain) {
+        return undefined;
+    }
+    const type = getAddressType(address);
+    return {
+        address,
+        domain,
+        type,
+    };
+}
+/**
+ * Format a wallet address for display
+ * Shows first 6 and last 4 characters with ellipsis
+ */
+function formatWalletAddress(address) {
+    if (!address || address.length < 10) {
+        return address;
+    }
+    // For ENS/SNS names, show them in full if they're short enough
+    const addressType = getAddressType(address);
+    if ((addressType === AddressType.ENSName ||
+        addressType === AddressType.SNSName) &&
+        address.length <= 20) {
+        return address;
+    }
+    // Show first 6 and last 4 characters with ellipsis
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+/**
+ * Get display name for a chain type
+ */
+function getChainDisplayName(chainType) {
+    if (!chainType) {
+        return 'Unknown Chain';
+    }
+    switch (chainType) {
+        case enums_1.ChainType.EVM:
+            return 'EVM Chain';
+        case enums_1.ChainType.SOLANA:
+            return 'Solana';
+        default:
+            return 'Blockchain';
+    }
+}
+//# sourceMappingURL=address.js.map

package/dist/utils/blockchain/address.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Blockchain address utilities for multi-chain support
+ *
+ * Provides validation and detection for various blockchain address formats
+ * including EVM addresses, Solana addresses, ENS names, and SNS names.
+ */
+import { ChainType } from '../../types/business/enums';
+import { Optional } from '../../types/common';
+/**
+ * Address type enumeration
+ */
+export declare enum AddressType {
+    EVMAddress = "EVMAddress",
+    SolanaAddress = "SolanaAddress",
+    ENSName = "ENSName",
+    SNSName = "SNSName",
+    Unknown = "Unknown"
+}
+/**
+ * Parsed email address structure
+ */
+export type ParsedEmailAddress = {
+    /** The address part (before @) */
+    address: string;
+    /** The domain part (after @) */
+    domain: string;
+    /** The detected type of the address */
+    type: AddressType;
+};
+/**
+ * Check if address is an ENS name (.eth or .box)
+ */
+export declare function isENSName(address: string): boolean;
+/**
+ * Check if address is an SNS name (Solana name service)
+ * Supports: .sol, .abc, .bonk, .poor, .gm, .dao, .defi, .web3
+ */
+export declare function isSNSName(address: string): boolean;
+/**
+ * Determine the address type from a string
+ * Case insensitive as addresses/names are often case insensitive
+ */
+export declare function getAddressType(address: string): AddressType;
+/**
+ * Validate a wallet address for a specific chain type
+ */
+export declare function isValidWalletAddress(address: string, chainType: ChainType): boolean;
+/**
+ * Check if a signature is valid for a specific chain type
+ */
+export declare function isValidSignature(signature: string, chainType: ChainType): boolean;
+/**
+ * Parse an email address into its components
+ */
+export declare function parseEmailAddress(email: string): Optional<ParsedEmailAddress>;
+/**
+ * Format a wallet address for display
+ * Shows first 6 and last 4 characters with ellipsis
+ */
+export declare function formatWalletAddress(address: string): string;
+/**
+ * Get display name for a chain type
+ */
+export declare function getChainDisplayName(chainType?: Optional<ChainType>): string;
+//# sourceMappingURL=address.d.ts.map

package/dist/utils/blockchain/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../src/utils/blockchain/address.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C;;GAEG;AACH,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAKF;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAiClD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA8ClD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CA8B3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,OAAO,CAwBT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GACnB,OAAO,CAkBT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAsB7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiB3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,CAa3E"}

package/dist/utils/blockchain/address.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Blockchain address utilities for multi-chain support
+ *
+ * Provides validation and detection for various blockchain address formats
+ * including EVM addresses, Solana addresses, ENS names, and SNS names.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressType = void 0;
+exports.isENSName = isENSName;
+exports.isSNSName = isSNSName;
+exports.getAddressType = getAddressType;
+exports.isValidWalletAddress = isValidWalletAddress;
+exports.isValidSignature = isValidSignature;
+exports.parseEmailAddress = parseEmailAddress;
+exports.formatWalletAddress = formatWalletAddress;
+exports.getChainDisplayName = getChainDisplayName;
+const enums_1 = require("../../types/business/enums");
+// Import base validation functions from common types
+const common_1 = require("../../types/blockchain/common");
+/**
+ * Address type enumeration
+ */
+var AddressType;
+(function (AddressType) {
+    AddressType["EVMAddress"] = "EVMAddress";
+    AddressType["SolanaAddress"] = "SolanaAddress";
+    AddressType["ENSName"] = "ENSName";
+    AddressType["SNSName"] = "SNSName";
+    AddressType["Unknown"] = "Unknown";
+})(AddressType || (exports.AddressType = AddressType = {}));
+// Address validation functions are now imported directly from common.ts
+// Use isEvmAddress and isSolanaAddress from '../../types/blockchain/common'
+/**
+ * Check if address is an ENS name (.eth or .box)
+ */
+function isENSName(address) {
+    const lowerAddress = address.toLowerCase();
+    // ENS names end with .eth or .box
+    if (!lowerAddress.endsWith('.eth') && !lowerAddress.endsWith('.box')) {
+        return false;
+    }
+    // Extract the name part (without .eth or .box)
+    const nameWithoutTLD = lowerAddress.endsWith('.eth')
+        ? lowerAddress.slice(0, -4)
+        : lowerAddress.slice(0, -4);
+    if (nameWithoutTLD.length === 0) {
+        return false;
+    }
+    // ENS names can have multiple labels separated by dots
+    const labels = nameWithoutTLD.split('.');
+    // Each label must be valid
+    const validLabelRegex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+    for (const label of labels) {
+        if (label.length === 0 || !validLabelRegex.test(label)) {
+            return false;
+        }
+        // No consecutive hyphens allowed
+        if (label.includes('--')) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Check if address is an SNS name (Solana name service)
+ * Supports: .sol, .abc, .bonk, .poor, .gm, .dao, .defi, .web3
+ */
+function isSNSName(address) {
+    const lowerAddress = address.toLowerCase();
+    // List of supported Solana name extensions
+    const snsExtensions = [
+        '.sol',
+        '.abc',
+        '.bonk',
+        '.poor',
+        '.gm',
+        '.dao',
+        '.defi',
+        '.web3',
+    ];
+    // Check if address ends with any supported extension
+    const matchingExtension = snsExtensions.find((ext) => lowerAddress.endsWith(ext));
+    if (!matchingExtension) {
+        return false;
+    }
+    // Extract the name part (without the extension)
+    const nameWithoutTLD = lowerAddress.slice(0, -matchingExtension.length);
+    if (nameWithoutTLD.length === 0) {
+        return false;
+    }
+    // SNS names can have multiple labels separated by dots
+    const labels = nameWithoutTLD.split('.');
+    // Each label must be valid
+    const validLabelRegex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+    for (const label of labels) {
+        if (label.length === 0 || !validLabelRegex.test(label)) {
+            return false;
+        }
+        // No consecutive hyphens allowed
+        if (label.includes('--')) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Determine the address type from a string
+ * Case insensitive as addresses/names are often case insensitive
+ */
+function getAddressType(address) {
+    if (!address || typeof address !== 'string') {
+        return AddressType.Unknown;
+    }
+    // Convert to lowercase for case-insensitive comparison
+    const trimmedAddress = address.trim();
+    const lowerAddress = trimmedAddress.toLowerCase();
+    // Check for ENS names (.eth or .box domains)
+    if (isENSName(lowerAddress)) {
+        return AddressType.ENSName;
+    }
+    // Check for SNS names (.sol domain)
+    if (isSNSName(lowerAddress)) {
+        return AddressType.SNSName;
+    }
+    // Check for EVM address (0x followed by 40 hex characters)
+    if ((0, common_1.isEvmAddress)(trimmedAddress)) {
+        return AddressType.EVMAddress;
+    }
+    // Check for Solana address (base58 encoded, 32-44 characters)
+    if ((0, common_1.isSolanaAddress)(trimmedAddress)) {
+        return AddressType.SolanaAddress;
+    }
+    return AddressType.Unknown;
+}
+/**
+ * Validate a wallet address for a specific chain type
+ */
+function isValidWalletAddress(address, chainType) {
+    if (!address || typeof address !== 'string') {
+        return false;
+    }
+    const addressType = getAddressType(address);
+    switch (chainType) {
+        case enums_1.ChainType.EVM:
+            return (addressType === AddressType.EVMAddress ||
+                addressType === AddressType.ENSName);
+        case enums_1.ChainType.SOLANA:
+            return (addressType === AddressType.SolanaAddress ||
+                addressType === AddressType.SNSName);
+        default:
+            // Unknown chain type, accept any known address format
+            return addressType !== AddressType.Unknown;
+    }
+}
+/**
+ * Check if a signature is valid for a specific chain type
+ */
+function isValidSignature(signature, chainType) {
+    if (!signature || typeof signature !== 'string') {
+        return false;
+    }
+    switch (chainType) {
+        case enums_1.ChainType.EVM:
+            // EVM signature validation (0x followed by 130 hex characters)
+            return /^0x[a-fA-F0-9]{130}$/.test(signature);
+        case enums_1.ChainType.SOLANA:
+            // Solana signature validation (base58 encoded, typically 87-88 characters)
+            return /^[1-9A-HJ-NP-Za-km-z]{87,88}$/.test(signature);
+        default:
+            // Basic validation for unknown chain types
+            return signature.length > 50;
+    }
+}
+/**
+ * Parse an email address into its components
+ */
+function parseEmailAddress(email) {
+    if (!email || typeof email !== 'string') {
+        return undefined;
+    }
+    const parts = email.split('@');
+    if (parts.length !== 2) {
+        return undefined;
+    }
+    const [address, domain] = parts;
+    if (!address || !domain) {
+        return undefined;
+    }
+    const type = getAddressType(address);
+    return {
+        address,
+        domain,
+        type,
+    };
+}
+/**
+ * Format a wallet address for display
+ * Shows first 6 and last 4 characters with ellipsis
+ */
+function formatWalletAddress(address) {
+    if (!address || address.length < 10) {
+        return address;
+    }
+    // For ENS/SNS names, show them in full if they're short enough
+    const addressType = getAddressType(address);
+    if ((addressType === AddressType.ENSName ||
+        addressType === AddressType.SNSName) &&
+        address.length <= 20) {
+        return address;
+    }
+    // Show first 6 and last 4 characters with ellipsis
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+/**
+ * Get display name for a chain type
+ */
+function getChainDisplayName(chainType) {
+    if (!chainType) {
+        return 'Unknown Chain';
+    }
+    switch (chainType) {
+        case enums_1.ChainType.EVM:
+            return 'EVM Chain';
+        case enums_1.ChainType.SOLANA:
+            return 'Solana';
+        default:
+            return 'Blockchain';
+    }
+}
+//# sourceMappingURL=address.js.map