pwc-sdk-wallet 0.6.3

package/dist/config/constants.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Configuration constants for PWC Wallet SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALIDATION_CONFIG = exports.CACHE_CONFIG = exports.NETWORK_CONFIG = exports.SECURITY_CONFIG = exports.VANITY_WALLET_CONFIG = void 0;
+exports.getPBKDF2Iterations = getPBKDF2Iterations;
+/**
+ * Configuration object for vanity wallet generation.
+ * Contains default settings and limits for generating wallets with specific address prefixes.
+ */
+exports.VANITY_WALLET_CONFIG = {
+    /** Default prefix for vanity addresses (without '0x' for EVM chains) */
+    DEFAULT_PREFIX: 'aaa',
+    /** Maximum attempts for generating vanity wallet before giving up */
+    DEFAULT_MAX_ATTEMPTS: 1000000,
+    /** Whether prefix matching should be case sensitive (false = ignore case) */
+    DEFAULT_CASE_SENSITIVE: false,
+    /** Progress update interval in number of attempts (for progress callbacks) */
+    PROGRESS_UPDATE_INTERVAL: 1000,
+    /** Non-blocking interval to allow event loop to breathe (prevents UI freezing) */
+    NON_BLOCKING_INTERVAL: 10000,
+    /** Maximum prefix length allowed (for performance and security reasons) */
+    MAX_PREFIX_LENGTH: 10,
+    /** Maximum attempts limit as a safety cap to prevent infinite loops */
+    MAX_ATTEMPTS_LIMIT: 10000000,
+    // Mobile-optimized settings
+    /** Mobile-optimized prefix (much easier to find) */
+    MOBILE_DEFAULT_PREFIX: 'a',
+    /** Mobile-optimized max attempts (faster completion) */
+    MOBILE_DEFAULT_MAX_ATTEMPTS: 50000,
+    /** Mobile-optimized progress update interval (more frequent updates) */
+    MOBILE_PROGRESS_UPDATE_INTERVAL: 500,
+    /** Mobile-optimized non-blocking interval (more frequent yields) */
+    MOBILE_NON_BLOCKING_INTERVAL: 1000,
+    /** Batch size for mobile processing (process multiple attempts in batches) */
+    MOBILE_BATCH_SIZE: 100,
+    /** Mobile timeout in milliseconds (prevent infinite running) */
+    MOBILE_TIMEOUT_MS: 30000, // 30 seconds
+};
+/**
+ * Security configuration constants
+ */
+exports.SECURITY_CONFIG = {
+    /** AES key size in bits */
+    AES_KEY_SIZE: 256,
+    /** Salt length in bytes */
+    SALT_LENGTH: 16,
+    /** IV length in bytes */
+    IV_LENGTH: 12,
+    /** Minimum password length */
+    MIN_PASSWORD_LENGTH: 8,
+    /** Maximum vault unlock attempts before lockout */
+    MAX_UNLOCK_ATTEMPTS: 5,
+    /** Lockout duration in milliseconds */
+    LOCKOUT_DURATION: 300000, // 5 minutes
+};
+/**
+ * Get PBKDF2 iterations based on environment
+ * @returns Number of iterations (5000 for development, 10000 for production)
+ */
+function getPBKDF2Iterations() {
+    return process.env.NODE_ENV === 'production' ? 3000 : 2500;
+}
+/**
+ * Network configuration constants
+ */
+exports.NETWORK_CONFIG = {
+    /** Default timeout for RPC calls in milliseconds */
+    RPC_TIMEOUT: 30000,
+    /** Retry attempts for failed RPC calls */
+    RPC_RETRY_ATTEMPTS: 3,
+    /** Delay between retry attempts in milliseconds */
+    RPC_RETRY_DELAY: 1000,
+    /** Maximum batch size for multi-transfer operations */
+    MAX_BATCH_SIZE: 50,
+    /** Delay between batches in milliseconds */
+    BATCH_DELAY: 500,
+};
+/**
+ * Cache configuration constants
+ */
+exports.CACHE_CONFIG = {
+    /** Default cache TTL in milliseconds */
+    DEFAULT_TTL: 30000, // 30 seconds
+    /** Balance cache TTL in milliseconds */
+    BALANCE_TTL: 60000, // 1 minute
+    /** Token info cache TTL in milliseconds */
+    TOKEN_INFO_TTL: 300000, // 5 minutes
+    /** Transaction cache TTL in milliseconds */
+    TRANSACTION_TTL: 600000, // 10 minutes
+    /** Maximum cache size in number of entries */
+    MAX_CACHE_SIZE: 1000,
+};
+/**
+ * Validation configuration constants
+ */
+exports.VALIDATION_CONFIG = {
+    /** Minimum address length */
+    MIN_ADDRESS_LENGTH: 26,
+    /** Maximum address length */
+    MAX_ADDRESS_LENGTH: 44,
+    /** Minimum amount for transfers */
+    MIN_TRANSFER_AMOUNT: '0.000001',
+    /** Maximum amount for transfers (safety limit) */
+    MAX_TRANSFER_AMOUNT: '1000000',
+    /** Maximum decimal places for amounts */
+    MAX_DECIMAL_PLACES: 18,
+};

package/dist/config/environment.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Environment configuration for PWC Wallet SDK
+ * Centralizes all environment variables and provides type-safe access
+ */
+export interface EnvironmentConfig {
+    /** RPC URLs for different chains */
+    rpcUrls: {
+        [chainId: string]: string;
+    };
+    /** Explorer URLs for different chains */
+    explorerUrls: {
+        [chainId: string]: string;
+    };
+    /** Gas configuration overrides */
+    gas: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        gasLimit?: number;
+    };
+    /** Network configuration */
+    network: {
+        defaultChainId: string;
+        supportedChains: string[];
+    };
+    /** Feature flags */
+    features: {
+        enableEIP1559: boolean;
+        enableBatchProcessing: boolean;
+        enableGasEstimation: boolean;
+    };
+}
+/**
+ * Get environment configuration with defaults
+ */
+export declare function getEnvironmentConfig(): EnvironmentConfig;
+/**
+ * Validate environment configuration
+ */
+export declare function validateEnvironmentConfig(config: EnvironmentConfig): string[];
+/**
+ * Get environment variable with type conversion
+ */
+export declare function getEnvVar(key: string, defaultValue?: string): string | undefined;
+export declare function getEnvVarNumber(key: string, defaultValue?: number): number | undefined;
+export declare function getEnvVarBigInt(key: string, defaultValue?: bigint): bigint | undefined;
+export declare function getEnvVarBoolean(key: string, defaultValue?: boolean): boolean | undefined;

package/dist/config/environment.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Environment configuration for PWC Wallet SDK
+ * Centralizes all environment variables and provides type-safe access
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvironmentConfig = getEnvironmentConfig;
+exports.validateEnvironmentConfig = validateEnvironmentConfig;
+exports.getEnvVar = getEnvVar;
+exports.getEnvVarNumber = getEnvVarNumber;
+exports.getEnvVarBigInt = getEnvVarBigInt;
+exports.getEnvVarBoolean = getEnvVarBoolean;
+/**
+ * Get environment configuration with defaults
+ */
+function getEnvironmentConfig() {
+    return {
+        rpcUrls: {
+            '1': process.env.RPC_URL_1 || 'https://eth.llamarpc.com',
+            '56': process.env.RPC_URL_56 || 'https://bsc-dataseed.binance.org/',
+            '137': process.env.RPC_URL_137 || 'https://polygon-rpc.com/',
+            '42161': process.env.RPC_URL_42161 || 'https://arb1.arbitrum.io/rpc',
+            '10': process.env.RPC_URL_10 || 'https://mainnet.optimism.io',
+            '8453': process.env.RPC_URL_8453 || 'https://mainnet.base.org',
+            'solana': process.env.RPC_URL_SOLANA || 'https://api.mainnet-beta.solana.com',
+            'solana-devnet': process.env.RPC_URL_SOLANA_DEVNET || 'https://api.devnet.solana.com',
+            '97': process.env.RPC_URL_97 || 'https://bsc-testnet-dataseed.bnbchain.org',
+        },
+        explorerUrls: {
+            '1': process.env.EXPLORER_URL_1 || 'https://etherscan.io',
+            '56': process.env.EXPLORER_URL_56 || 'https://bscscan.com',
+            '137': process.env.EXPLORER_URL_137 || 'https://polygonscan.com',
+            '42161': process.env.EXPLORER_URL_42161 || 'https://arbiscan.io',
+            '10': process.env.EXPLORER_URL_10 || 'https://optimistic.etherscan.io',
+            '8453': process.env.EXPLORER_URL_8453 || 'https://basescan.org',
+            'solana': process.env.EXPLORER_URL_SOLANA || 'https://solscan.io',
+            'solana-devnet': process.env.EXPLORER_URL_SOLANA_DEVNET || 'https://solscan.io?cluster=devnet',
+            '97': process.env.EXPLORER_URL_97 || 'https://testnet.bscscan.com',
+        },
+        gas: {
+            maxFeePerGas: process.env.MAX_FEE_PER_GAS ? BigInt(process.env.MAX_FEE_PER_GAS) : undefined,
+            maxPriorityFeePerGas: process.env.MAX_PRIORITY_FEE_PER_GAS ? BigInt(process.env.MAX_PRIORITY_FEE_PER_GAS) : undefined,
+            gasLimit: process.env.DEFAULT_GAS_LIMIT ? parseInt(process.env.DEFAULT_GAS_LIMIT) : undefined,
+        },
+        network: {
+            defaultChainId: process.env.DEFAULT_CHAIN_ID || '1',
+            supportedChains: process.env.SUPPORTED_CHAINS ? process.env.SUPPORTED_CHAINS.split(',') : ['1', '56', '137', '42161', '10', '8453', 'solana'],
+        },
+        features: {
+            enableEIP1559: process.env.ENABLE_EIP1559 !== 'false',
+            enableBatchProcessing: process.env.ENABLE_BATCH_PROCESSING !== 'false',
+            enableGasEstimation: process.env.ENABLE_GAS_ESTIMATION !== 'false',
+        },
+    };
+}
+/**
+ * Validate environment configuration
+ */
+function validateEnvironmentConfig(config) {
+    const errors = [];
+    // Validate RPC URLs
+    Object.entries(config.rpcUrls).forEach(([chainId, url]) => {
+        if (!url.startsWith('http')) {
+            errors.push(`Invalid RPC URL for chain ${chainId}: ${url}`);
+        }
+    });
+    // Validate explorer URLs
+    Object.entries(config.explorerUrls).forEach(([chainId, url]) => {
+        if (!url.startsWith('http')) {
+            errors.push(`Invalid explorer URL for chain ${chainId}: ${url}`);
+        }
+    });
+    // Validate gas configuration
+    if (config.gas.maxFeePerGas && config.gas.maxFeePerGas <= 0n) {
+        errors.push('MAX_FEE_PER_GAS must be greater than 0');
+    }
+    if (config.gas.maxPriorityFeePerGas && config.gas.maxPriorityFeePerGas <= 0n) {
+        errors.push('MAX_PRIORITY_FEE_PER_GAS must be greater than 0');
+    }
+    if (config.gas.gasLimit && (config.gas.gasLimit < 21000 || config.gas.gasLimit > 500000)) {
+        errors.push('DEFAULT_GAS_LIMIT must be between 21000 and 500000');
+    }
+    return errors;
+}
+/**
+ * Get environment variable with type conversion
+ */
+function getEnvVar(key, defaultValue) {
+    return process.env[key] || defaultValue;
+}
+function getEnvVarNumber(key, defaultValue) {
+    const value = process.env[key];
+    if (!value)
+        return defaultValue;
+    const num = parseInt(value);
+    return isNaN(num) ? defaultValue : num;
+}
+function getEnvVarBigInt(key, defaultValue) {
+    const value = process.env[key];
+    if (!value)
+        return defaultValue;
+    try {
+        return BigInt(value);
+    }
+    catch {
+        return defaultValue;
+    }
+}
+function getEnvVarBoolean(key, defaultValue) {
+    const value = process.env[key];
+    if (!value)
+        return defaultValue;
+    return value.toLowerCase() === 'true';
+}

package/dist/config/gas.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Gas configuration constants to avoid hardcoded values
+ */
+export declare const GAS_CONFIG: {
+    /** Default gas limit for ERC-20 token transfers */
+    readonly ERC20_TRANSFER: 65000;
+    /** Default gas limit for native token transfers */
+    readonly NATIVE_TRANSFER: 21000;
+    /** Default gas limit for token approvals */
+    readonly TOKEN_APPROVAL: 46000;
+    /** Default gas limit for contract interactions */
+    readonly CONTRACT_INTERACTION: 100000;
+    /** Maximum gas limit for safety */
+    readonly MAX_GAS_LIMIT: 500000;
+    /** Gas multiplier for batch operations */
+    readonly BATCH_MULTIPLIER: 1.1;
+    /** Priority fee (tip) in wei for EIP-1559 transactions */
+    readonly DEFAULT_PRIORITY_FEE: 1500000000n;
+    /** Base fee buffer for EIP-1559 transactions */
+    readonly BASE_FEE_BUFFER: 1.2;
+};
+/**
+ * Set global gas configuration from mobile app (highest priority)
+ */
+export declare function setGlobalGasConfig(config: Partial<typeof GAS_CONFIG>): void;
+/**
+ * Set global network gas configuration from mobile app (highest priority)
+ */
+export declare function setGlobalNetworkGasConfig(config: Record<string, Partial<{
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}>>): void;
+/**
+ * Clear all global gas configurations (reset to defaults)
+ */
+export declare function clearGlobalGasConfigs(): void;
+/**
+ * Get merged gas config (Mobile App > Env > SDK Defaults)
+ */
+export declare function getGasConfig(): {
+    ERC20_TRANSFER: number;
+    NATIVE_TRANSFER: number;
+    TOKEN_APPROVAL: number;
+    CONTRACT_INTERACTION: number;
+    MAX_GAS_LIMIT: number;
+    BATCH_MULTIPLIER: number;
+    DEFAULT_PRIORITY_FEE: bigint;
+    BASE_FEE_BUFFER: number;
+};
+/**
+ * Network-specific gas configurations
+ */
+export declare const NETWORK_GAS_CONFIG: {
+    readonly '1': {
+        readonly maxFeePerGas: 50000000000n;
+        readonly maxPriorityFeePerGas: 2000000000n;
+    };
+    readonly '56': {
+        readonly maxFeePerGas: 5000000000n;
+        readonly maxPriorityFeePerGas: 1000000000n;
+    };
+    readonly '137': {
+        readonly maxFeePerGas: 30000000000n;
+        readonly maxPriorityFeePerGas: 1000000000n;
+    };
+    readonly '42161': {
+        readonly maxFeePerGas: 100000000n;
+        readonly maxPriorityFeePerGas: 100000000n;
+    };
+    readonly '10': {
+        readonly maxFeePerGas: 1000000000n;
+        readonly maxPriorityFeePerGas: 100000000n;
+    };
+    readonly '8453': {
+        readonly maxFeePerGas: 1000000000n;
+        readonly maxPriorityFeePerGas: 100000000n;
+    };
+};
+/**
+ * Get gas configuration for a specific network with priority: Mobile App > Env > SDK Defaults
+ */
+export declare function getNetworkGasConfig(chainId: string): {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+} | {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+} | {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+} | {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+} | {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+} | {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+/**
+ * Calculate optimal gas price for EIP-1559 transactions using dynamic config
+ */
+export declare function calculateOptimalGasPrice(baseFee: bigint, chainId: string): {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};

package/dist/config/gas.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_GAS_CONFIG = exports.GAS_CONFIG = void 0;
+exports.setGlobalGasConfig = setGlobalGasConfig;
+exports.setGlobalNetworkGasConfig = setGlobalNetworkGasConfig;
+exports.clearGlobalGasConfigs = clearGlobalGasConfigs;
+exports.getGasConfig = getGasConfig;
+exports.getNetworkGasConfig = getNetworkGasConfig;
+exports.calculateOptimalGasPrice = calculateOptimalGasPrice;
+/**
+ * Gas configuration constants to avoid hardcoded values
+ */
+exports.GAS_CONFIG = {
+    /** Default gas limit for ERC-20 token transfers */
+    ERC20_TRANSFER: 65000,
+    /** Default gas limit for native token transfers */
+    NATIVE_TRANSFER: 21000,
+    /** Default gas limit for token approvals */
+    TOKEN_APPROVAL: 46000,
+    /** Default gas limit for contract interactions */
+    CONTRACT_INTERACTION: 100000,
+    /** Maximum gas limit for safety */
+    MAX_GAS_LIMIT: 500000,
+    /** Gas multiplier for batch operations */
+    BATCH_MULTIPLIER: 1.1,
+    /** Priority fee (tip) in wei for EIP-1559 transactions */
+    DEFAULT_PRIORITY_FEE: 1500000000n, // 1.5 gwei
+    /** Base fee buffer for EIP-1559 transactions */
+    BASE_FEE_BUFFER: 1.2,
+};
+// Global gas config registry for mobile app overrides
+let GLOBAL_GAS_CONFIG = {};
+let GLOBAL_NETWORK_GAS_CONFIG = {};
+/**
+ * Set global gas configuration from mobile app (highest priority)
+ */
+function setGlobalGasConfig(config) {
+    GLOBAL_GAS_CONFIG = { ...GLOBAL_GAS_CONFIG, ...config };
+}
+/**
+ * Set global network gas configuration from mobile app (highest priority)
+ */
+function setGlobalNetworkGasConfig(config) {
+    GLOBAL_NETWORK_GAS_CONFIG = { ...GLOBAL_NETWORK_GAS_CONFIG, ...config };
+}
+/**
+ * Clear all global gas configurations (reset to defaults)
+ */
+function clearGlobalGasConfigs() {
+    GLOBAL_GAS_CONFIG = {};
+    GLOBAL_NETWORK_GAS_CONFIG = {};
+}
+/**
+ * Get merged gas config (Mobile App > Env > SDK Defaults)
+ */
+function getGasConfig() {
+    return {
+        ...exports.GAS_CONFIG,
+        ...GLOBAL_GAS_CONFIG,
+        // Environment variables override
+        ERC20_TRANSFER: parseInt(process.env.GAS_ERC20_TRANSFER || GLOBAL_GAS_CONFIG.ERC20_TRANSFER?.toString() || exports.GAS_CONFIG.ERC20_TRANSFER.toString()),
+        NATIVE_TRANSFER: parseInt(process.env.GAS_NATIVE_TRANSFER || GLOBAL_GAS_CONFIG.NATIVE_TRANSFER?.toString() || exports.GAS_CONFIG.NATIVE_TRANSFER.toString()),
+        TOKEN_APPROVAL: parseInt(process.env.GAS_TOKEN_APPROVAL || GLOBAL_GAS_CONFIG.TOKEN_APPROVAL?.toString() || exports.GAS_CONFIG.TOKEN_APPROVAL.toString()),
+        CONTRACT_INTERACTION: parseInt(process.env.GAS_CONTRACT_INTERACTION || GLOBAL_GAS_CONFIG.CONTRACT_INTERACTION?.toString() || exports.GAS_CONFIG.CONTRACT_INTERACTION.toString()),
+        MAX_GAS_LIMIT: parseInt(process.env.GAS_MAX_LIMIT || GLOBAL_GAS_CONFIG.MAX_GAS_LIMIT?.toString() || exports.GAS_CONFIG.MAX_GAS_LIMIT.toString()),
+        BATCH_MULTIPLIER: parseFloat(process.env.GAS_BATCH_MULTIPLIER || GLOBAL_GAS_CONFIG.BATCH_MULTIPLIER?.toString() || exports.GAS_CONFIG.BATCH_MULTIPLIER.toString()),
+        DEFAULT_PRIORITY_FEE: BigInt(process.env.GAS_DEFAULT_PRIORITY_FEE || GLOBAL_GAS_CONFIG.DEFAULT_PRIORITY_FEE?.toString() || exports.GAS_CONFIG.DEFAULT_PRIORITY_FEE.toString()),
+        BASE_FEE_BUFFER: parseFloat(process.env.GAS_BASE_FEE_BUFFER || GLOBAL_GAS_CONFIG.BASE_FEE_BUFFER?.toString() || exports.GAS_CONFIG.BASE_FEE_BUFFER.toString()),
+    };
+}
+/**
+ * Network-specific gas configurations
+ */
+exports.NETWORK_GAS_CONFIG = {
+    '1': {
+        maxFeePerGas: 50000000000n, // 50 gwei
+        maxPriorityFeePerGas: 2000000000n, // 2 gwei
+    },
+    '56': {
+        maxFeePerGas: 5000000000n, // 5 gwei
+        maxPriorityFeePerGas: 1000000000n, // 1 gwei
+    },
+    '137': {
+        maxFeePerGas: 30000000000n, // 30 gwei
+        maxPriorityFeePerGas: 1000000000n, // 1 gwei
+    },
+    '42161': {
+        maxFeePerGas: 100000000n, // 0.1 gwei
+        maxPriorityFeePerGas: 100000000n, // 0.1 gwei
+    },
+    '10': {
+        maxFeePerGas: 1000000000n, // 1 gwei
+        maxPriorityFeePerGas: 100000000n, // 0.1 gwei
+    },
+    '8453': {
+        maxFeePerGas: 1000000000n, // 1 gwei
+        maxPriorityFeePerGas: 100000000n, // 0.1 gwei
+    },
+};
+/**
+ * Get gas configuration for a specific network with priority: Mobile App > Env > SDK Defaults
+ */
+function getNetworkGasConfig(chainId) {
+    const defaultConfig = exports.NETWORK_GAS_CONFIG[chainId] || {
+        maxFeePerGas: 20000000000n, // 20 gwei default
+        maxPriorityFeePerGas: 1000000000n, // 1 gwei default
+    };
+    const override = GLOBAL_NETWORK_GAS_CONFIG[chainId] || {};
+    return { ...defaultConfig, ...override };
+}
+/**
+ * Calculate optimal gas price for EIP-1559 transactions using dynamic config
+ */
+function calculateOptimalGasPrice(baseFee, chainId) {
+    const networkConfig = getNetworkGasConfig(chainId);
+    const gasConfig = getGasConfig();
+    const priorityFee = networkConfig.maxPriorityFeePerGas;
+    const maxFeePerGas = baseFee * BigInt(Math.ceil(gasConfig.BASE_FEE_BUFFER * 100)) / BigInt(100) + priorityFee;
+    return {
+        maxFeePerGas: maxFeePerGas > networkConfig.maxFeePerGas ? networkConfig.maxFeePerGas : maxFeePerGas,
+        maxPriorityFeePerGas: priorityFee,
+    };
+}

package/dist/crypto/EncryptionService.d.ts

@@ -0,0 +1,74 @@
+import { Buffer } from 'buffer';
+/**
+ * Interface representing encrypted data structure.
+ * Contains the encrypted data, initialization vector, and salt used for encryption.
+ */
+export interface EncryptedData {
+    /** The encrypted data as a base64 string */
+    encryptedData: string;
+    /** The initialization vector used for encryption as a base64 string */
+    iv: string;
+    /** The salt used for key derivation as a base64 string */
+    salt: string;
+}
+/**
+ * Service providing cryptographic operations including mnemonic generation,
+ * encryption/decryption, and key derivation for the wallet SDK.
+ */
+export declare class EncryptionService {
+    /**
+     * Generates a cryptographically secure mnemonic phrase.
+     * @returns A 24-word mnemonic phrase following BIP-39 standard
+     */
+    static generateMnemonic(): string;
+    /**
+     * Validates a mnemonic phrase to ensure it's properly formatted and contains valid words.
+     * @param mnemonic - The mnemonic phrase to validate (12, 15, 18, 21, or 24 words)
+     * @returns True if the mnemonic is valid, false otherwise
+     */
+    static validateMnemonic(mnemonic: string): boolean;
+    /**
+     * Encrypts data using AES-256-CBC with PBKDF2 key derivation.
+     * @param data - The plaintext data to encrypt
+     * @param password - The password to use for key derivation
+     * @returns Promise resolving to the encrypted data structure
+     * @throws Error if encryption fails
+     */
+    static encrypt(data: string, password: string): Promise<EncryptedData>;
+    /**
+     * Decrypts data that was encrypted using the encrypt method.
+     * @param encryptedData - The encrypted data structure containing data, iv, and salt
+     * @param password - The password used for the original encryption
+     * @returns Promise resolving to the decrypted plaintext data
+     * @throws Error if decryption fails due to incorrect password or corrupted data
+     */
+    static decrypt(encryptedData: EncryptedData, password: string): Promise<string>;
+    /**
+     * Converts a mnemonic phrase to a seed buffer using PBKDF2.
+     * @param mnemonic - The mnemonic phrase to convert
+     * @returns Promise resolving to the seed buffer
+     */
+    static mnemonicToSeed(mnemonic: string): Promise<Buffer>;
+    /**
+     * Derives a private key from a seed using BIP-32 derivation.
+     * @param seed - The seed buffer to derive from
+     * @param path - The derivation path to use (defaults to EVM path)
+     * @returns Promise resolving to the derived private key buffer
+     * @throws Error if private key derivation fails
+     */
+    static derivePrivateKey(seed: Buffer, path?: string): Promise<Buffer>;
+    /**
+     * Attempts to clear sensitive data from memory.
+     * Note: JavaScript doesn't guarantee memory clearing, but this helps reduce exposure.
+     * @param data - The sensitive data to clear (string or buffer)
+     */
+    static clearSensitiveData(data: string | Buffer): void;
+    /**
+     * Creates a temporary copy of sensitive data that gets cleared after use.
+     * This is a security measure to minimize the time sensitive data stays in memory.
+     * @param data - The sensitive data to use temporarily
+     * @param callback - Function to execute with the temporary data
+     * @returns The result of the callback function
+     */
+    static withTemporaryData<T>(data: string | Buffer, callback: (tempData: string | Buffer) => T): T;
+}