@deserialize/multi-vm-wallet 1.4.2 → 1.5.0

package/dist/savings/smart-savings.d.ts

@@ -1,74 +1,11 @@
-/**
- * Smart Savings Manager
- *
- * Handles upgrading savings accounts to EIP-7702 smart accounts.
- * Enables advanced features like locked savings, spend & save, and periodic savings.
- *
- * Architecture:
- * 1. Take a basic SavingsAccount (BIP-44 derived)
- * 2. Create an EVMSmartWallet instance from its private key
- * 3. Initialize with EIP-7702 delegation
- * 4. Return a SmartSavingsAccount with full AA capabilities
- */
 import { SmartWalletOptions } from "../evm/aa-service";
 import { ChainWalletConfig } from "../types";
 import { SavingsAccount, SmartSavingsAccount } from "./types";
-/**
- * Manages EIP-7702 smart savings accounts
- *
- * This class provides:
- * 1. Upgrade from basic savings account to smart account
- * 2. Full Account Abstraction capabilities
- * 3. Access to Kernel modules (lock, hooks, session keys)
- * 4. Sponsored transactions via paymaster
- */
 export declare class SmartSavingsManager {
     private chainConfig;
     constructor(chainConfig: ChainWalletConfig);
-    /**
-     * Upgrade a savings account to a smart account with EIP-7702 delegation
-     *
-     * This enables advanced features:
-     * - Lock modules for time-locked savings
-     * - Hooks for spend & save
-     * - Session keys for periodic savings
-     * - Sponsored transactions via paymaster
-     *
-     * @param savingsAccount - The basic savings account to upgrade
-     * @param options - Optional smart wallet configuration
-     * @returns SmartSavingsAccount with EVMSmartWallet instance
-     *
-     * @example
-     * const basicSavings = wallet.deriveSavingsAccount(1);
-     * const smartSavings = await smartSavingsManager.upgradeSavingsToSmartAccount(basicSavings);
-     * await smartSavings.smartWallet.installModule({ ... });
-     */
     upgradeSavingsToSmartAccount(savingsAccount: SavingsAccount, options?: SmartWalletOptions): Promise<SmartSavingsAccount>;
-    /**
-     * Upgrade and initialize a savings account in one step
-     *
-     * This is a convenience method that both upgrades and initializes.
-     *
-     * @param savingsAccount - The basic savings account to upgrade
-     * @param options - Optional smart wallet configuration
-     * @returns Initialized SmartSavingsAccount ready for transactions
-     *
-     * @example
-     * const basicSavings = wallet.deriveSavingsAccount(1);
-     * const smartSavings = await smartSavingsManager.upgradeSavingsAndInitialize(basicSavings);
-     * // smartSavings is now ready for smart transactions
-     */
     upgradeSavingsAndInitialize(savingsAccount: SavingsAccount, options?: SmartWalletOptions): Promise<SmartSavingsAccount>;
-    /**
-     * Check if a savings account can be upgraded to smart account
-     *
-     * @returns true if chain supports AA and has required configuration
-     */
     canUpgradeToSmartAccount(): boolean;
-    /**
-     * Get the chain configuration
-     *
-     * @returns ChainWalletConfig
-     */
     getChainConfig(): ChainWalletConfig;
 }

package/dist/savings/smart-savings.js

@@ -1,36 +1,11 @@
 "use strict";
-/**
- * Smart Savings Manager
- *
- * Handles upgrading savings accounts to EIP-7702 smart accounts.
- * Enables advanced features like locked savings, spend & save, and periodic savings.
- *
- * Architecture:
- * 1. Take a basic SavingsAccount (BIP-44 derived)
- * 2. Create an EVMSmartWallet instance from its private key
- * 3. Initialize with EIP-7702 delegation
- * 4. Return a SmartSavingsAccount with full AA capabilities
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SmartSavingsManager = void 0;
 const smartWallet_1 = require("../evm/smartWallet");
-// ============================================
-// SmartSavingsManager Class
-// ============================================
-/**
- * Manages EIP-7702 smart savings accounts
- *
- * This class provides:
- * 1. Upgrade from basic savings account to smart account
- * 2. Full Account Abstraction capabilities
- * 3. Access to Kernel modules (lock, hooks, session keys)
- * 4. Sponsored transactions via paymaster
- */
 class SmartSavingsManager {
     chainConfig;
     constructor(chainConfig) {
         this.chainConfig = chainConfig;
-        // Validate AA support
         if (!chainConfig.aaSupport?.enabled) {
             throw new Error("Smart savings requires Account Abstraction (AA) support.\n" +
                 "Your chain config must include aaSupport configuration with:\n" +
@@ -39,26 +14,7 @@ class SmartSavingsManager {
                 "- kernelImplementations");
         }
     }
-    /**
-     * Upgrade a savings account to a smart account with EIP-7702 delegation
-     *
-     * This enables advanced features:
-     * - Lock modules for time-locked savings
-     * - Hooks for spend & save
-     * - Session keys for periodic savings
-     * - Sponsored transactions via paymaster
-     *
-     * @param savingsAccount - The basic savings account to upgrade
-     * @param options - Optional smart wallet configuration
-     * @returns SmartSavingsAccount with EVMSmartWallet instance
-     *
-     * @example
-     * const basicSavings = wallet.deriveSavingsAccount(1);
-     * const smartSavings = await smartSavingsManager.upgradeSavingsToSmartAccount(basicSavings);
-     * await smartSavings.smartWallet.installModule({ ... });
-     */
     async upgradeSavingsToSmartAccount(savingsAccount, options) {
-        // Merge options with chain config
         const mergedOptions = {
             ...options,
             aaConfig: this.chainConfig.aaSupport,
@@ -66,12 +22,10 @@ class SmartSavingsManager {
             paymasterUrl: options?.paymasterUrl || this.chainConfig.aaSupport?.paymasterUrl,
             entryPointVersion: options?.entryPointVersion || this.chainConfig.aaSupport?.entryPoints?.[0]?.version
         };
-        // Validate bundlerUrl
         if (!mergedOptions.bundlerUrl) {
             throw new Error("bundlerUrl is required for smart savings.\n" +
                 "Provide it via upgradeSavingsToSmartAccount options or chain config.");
         }
-        // Create viem chain object
         const chain = {
             id: this.chainConfig.chainId,
             name: this.chainConfig.name,
@@ -93,11 +47,7 @@ class SmartSavingsManager {
             },
             testnet: this.chainConfig.testnet || false
         };
-        // Create EVMSmartWallet instance from savings account private key
         const smartWallet = new smartWallet_1.EVMSmartWallet(savingsAccount.privateKey, chain, mergedOptions);
-        // Note: Initialization (createAuthorization) is optional
-        // User can call smartWallet.initialize() separately if needed
-        // For now, we return uninitialized smart wallet
         const isInitialized = false;
         return {
             ...savingsAccount,
@@ -105,48 +55,20 @@ class SmartSavingsManager {
             isInitialized
         };
     }
-    /**
-     * Upgrade and initialize a savings account in one step
-     *
-     * This is a convenience method that both upgrades and initializes.
-     *
-     * @param savingsAccount - The basic savings account to upgrade
-     * @param options - Optional smart wallet configuration
-     * @returns Initialized SmartSavingsAccount ready for transactions
-     *
-     * @example
-     * const basicSavings = wallet.deriveSavingsAccount(1);
-     * const smartSavings = await smartSavingsManager.upgradeSavingsAndInitialize(basicSavings);
-     * // smartSavings is now ready for smart transactions
-     */
     async upgradeSavingsAndInitialize(savingsAccount, options) {
-        // First upgrade
         const smartSavings = await this.upgradeSavingsToSmartAccount(savingsAccount, options);
-        // Then initialize
         await smartSavings.smartWallet.initialize();
-        // Update initialization status
         smartSavings.isInitialized = true;
         return smartSavings;
     }
-    /**
-     * Check if a savings account can be upgraded to smart account
-     *
-     * @returns true if chain supports AA and has required configuration
-     */
     canUpgradeToSmartAccount() {
         return !!(this.chainConfig.aaSupport?.enabled &&
             this.chainConfig.aaSupport?.bundlerUrl &&
             this.chainConfig.aaSupport?.entryPoints &&
             this.chainConfig.aaSupport?.entryPoints.length > 0);
     }
-    /**
-     * Get the chain configuration
-     *
-     * @returns ChainWalletConfig
-     */
     getChainConfig() {
         return this.chainConfig;
     }
 }
 exports.SmartSavingsManager = SmartSavingsManager;
-//# sourceMappingURL=smart-savings.js.map

package/dist/savings/types.d.ts

@@ -1,125 +1,56 @@
-/**
- * Savings Pocket Types
- *
- * Type definitions for the savings pocket feature that allows users to create
- * multiple savings accounts derived from their seed phrase using BIP-44 account indices.
- */
 import { Hex } from "viem";
 import { EVMSmartWallet } from "../evm/smartWallet";
-/**
- * Savings account derived from BIP-44 account index
- */
 export interface SavingsAccount {
-    /** Account index used for derivation (m/44'/60'/accountIndex'/0/0) */
     accountIndex: number;
-    /** Derived private key for this savings account */
     privateKey: Hex;
-    /** Derived address for this savings account */
     address: Hex;
-    /** Full BIP-44 derivation path */
     derivationPath: string;
 }
-/**
- * Savings account upgraded to EIP-7702 smart account
- */
 export interface SmartSavingsAccount extends SavingsAccount {
-    /** Smart wallet instance for advanced features */
     smartWallet: EVMSmartWallet;
-    /** Whether the account has been initialized on-chain */
     isInitialized: boolean;
 }
-/**
- * Options for transferring to savings
- */
 export interface TransferToSavingsOptions {
-    /** Expected address for verification (prevents tampering) */
     expectedAddress?: Hex;
-    /** Transaction priority for gas estimation */
     priority?: 'low' | 'medium' | 'high';
-    /** Whether to use smart account features (requires 7702 upgrade) */
     useSmartAccount?: boolean;
 }
-/**
- * Options for withdrawing from savings
- */
 export interface WithdrawFromSavingsOptions {
-    /** Expected source address for verification */
     expectedAddress?: Hex;
-    /** Transaction priority */
     priority?: 'low' | 'medium' | 'high';
-    /** Whether to use smart account features */
     useSmartAccount?: boolean;
 }
-/**
- * Result of address verification
- */
 export interface AddressVerificationResult {
-    /** Account index that was verified */
     accountIndex: number;
-    /** Stored address that was checked */
     storedAddress: Hex;
-    /** Derived address from account index */
     derivedAddress: Hex;
-    /** Whether addresses match */
     isValid: boolean;
-    /** Error message if invalid */
     error?: string;
 }
-/**
- * Result of batch address audit
- */
 export interface SavingsAuditResult {
-    /** Total number of addresses audited */
     total: number;
-    /** Number of valid addresses */
     valid: number;
-    /** Number of invalid addresses */
     invalid: number;
-    /** Whether all addresses are valid */
     allValid: boolean;
-    /** Detailed results per address */
     results: AddressVerificationResult[];
-    /** Timestamp of audit */
     timestamp: Date;
 }
-/**
- * Lock module configuration for locked savings
- */
 export interface LockModuleConfig {
-    /** Lock duration in seconds */
     lockDuration: number;
-    /** Lock end timestamp (computed) */
     lockedUntil: number;
-    /** Whether early withdrawal is allowed with penalty */
     allowEarlyWithdrawal?: boolean;
-    /** Penalty percentage for early withdrawal (0-100) */
     earlyWithdrawalPenalty?: number;
 }
-/**
- * Periodic savings session configuration
- */
 export interface PeriodicSavingsConfig {
-    /** Amount to save each period */
     amount: number;
-    /** Savings frequency */
     frequency: 'daily' | 'weekly' | 'monthly';
-    /** Destination account index */
     savingsAccountIndex: number;
-    /** Optional end date for recurring savings */
     endDate?: Date;
-    /** Maximum number of executions */
     maxExecutions?: number;
 }
-/**
- * Spend and save hook configuration
- */
 export interface SpendAndSaveConfig {
-    /** Percentage of spending to save (0-100) */
     savePercentage: number;
-    /** Destination savings account index */
     savingsAccountIndex: number;
-    /** Minimum transaction amount to trigger saving */
     minTransactionAmount?: number;
-    /** Maximum amount to save per transaction */
     maxSaveAmount?: number;
 }

package/dist/savings/types.js

@@ -1,9 +1,2 @@
 "use strict";
-/**
- * Savings Pocket Types
- *
- * Type definitions for the savings pocket feature that allows users to create
- * multiple savings accounts derived from their seed phrase using BIP-44 account indices.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/savings/validation.d.ts

@@ -0,0 +1,9 @@
+export declare class SavingsValidation {
+    static validateAccountIndex(index: number): void;
+    static validateWalletIndex(index: number): void;
+    static validateAmount(amount: bigint, label?: string): void;
+    static validateAddress(address: string, label?: string): void;
+    static validateMnemonic(mnemonic: string): void;
+    static validateChainId(chainId: number): void;
+    static validateAmountString(amount: string, label?: string): void;
+}

package/dist/savings/validation.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SavingsValidation = void 0;
+class SavingsValidation {
+    static validateAccountIndex(index) {
+        if (!Number.isInteger(index)) {
+            throw new Error(`Account index must be an integer, got: ${index}`);
+        }
+        if (index < 0) {
+            throw new Error(`Account index must be non-negative, got: ${index}`);
+        }
+        if (index > 0x7FFFFFFF) {
+            throw new Error(`Account index exceeds BIP-44 maximum (2147483647), got: ${index}`);
+        }
+    }
+    static validateWalletIndex(index) {
+        if (!Number.isInteger(index)) {
+            throw new Error(`Wallet index must be an integer, got: ${index}`);
+        }
+        if (index < 0) {
+            throw new Error(`Wallet index must be non-negative, got: ${index}`);
+        }
+        if (index > 0x7FFFFFFF) {
+            throw new Error(`Wallet index exceeds maximum (2147483647), got: ${index}`);
+        }
+    }
+    static validateAmount(amount, label = 'Amount') {
+        if (typeof amount !== 'bigint') {
+            throw new Error(`${label} must be a bigint, got: ${typeof amount}`);
+        }
+        if (amount <= 0n) {
+            throw new Error(`${label} must be positive, got: ${amount}`);
+        }
+    }
+    static validateAddress(address, label = 'Address') {
+        if (typeof address !== 'string') {
+            throw new Error(`${label} must be a string, got: ${typeof address}`);
+        }
+        if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
+            throw new Error(`${label} has invalid format. Expected 0x followed by 40 hex characters, got: ${address}`);
+        }
+    }
+    static validateMnemonic(mnemonic) {
+        if (typeof mnemonic !== 'string') {
+            throw new Error(`Mnemonic must be a string, got: ${typeof mnemonic}`);
+        }
+        const trimmed = mnemonic.trim();
+        if (trimmed.length === 0) {
+            throw new Error('Mnemonic cannot be empty');
+        }
+        const words = trimmed.split(/\s+/);
+        const validWordCounts = [12, 15, 18, 21, 24];
+        if (!validWordCounts.includes(words.length)) {
+            throw new Error(`Mnemonic must have 12, 15, 18, 21, or 24 words (BIP-39 standard), got: ${words.length} words`);
+        }
+    }
+    static validateChainId(chainId) {
+        if (!Number.isInteger(chainId)) {
+            throw new Error(`Chain ID must be an integer, got: ${chainId}`);
+        }
+        if (chainId <= 0) {
+            throw new Error(`Chain ID must be positive, got: ${chainId}`);
+        }
+    }
+    static validateAmountString(amount, label = 'Amount') {
+        if (typeof amount !== 'string') {
+            throw new Error(`${label} must be a string, got: ${typeof amount}`);
+        }
+        const trimmed = amount.trim();
+        if (trimmed.length === 0) {
+            throw new Error(`${label} cannot be empty`);
+        }
+        if (!/^-?\d+(\.\d+)?$/.test(trimmed)) {
+            throw new Error(`${label} has invalid format, got: ${amount}`);
+        }
+        const parsed = parseFloat(trimmed);
+        if (isNaN(parsed)) {
+            throw new Error(`${label} cannot be parsed as number, got: ${amount}`);
+        }
+        if (parsed <= 0) {
+            throw new Error(`${label} must be positive, got: ${amount}`);
+        }
+    }
+}
+exports.SavingsValidation = SavingsValidation;

package/dist/svm/constant.js

@@ -22,4 +22,3 @@ exports.SVM_CHAIN_CONFIG = {
         rpcUrl: "https://mainnetbeta-rpc.eclipse.xyz"
     }
 };
-//# sourceMappingURL=constant.js.map

package/dist/svm/index.js

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./svm"), exports);
-//# sourceMappingURL=index.js.map

package/dist/svm/svm.d.ts

@@ -1,7 +1,7 @@
 import { Connection, Keypair, PublicKey, Transaction, VersionedTransaction } from "@solana/web3.js";
 import { VM } from "../vm";
 import { ChainWallet } from "../IChainWallet";
-import { Balance, ChainWalletConfig, UserTokenBalance, TokenInfo, TransactionResult, NFT } from "../types";
+import { Balance, ChainWalletConfig, UserTokenBalance, TokenInfo, TransactionResult, NFT, WalletDiscoveryOptions, WalletDiscoveryResult, PocketDiscoveryOptions } from "../types";
 import { JupiterQuoteResponse } from "./utils";
 import { PriceResponse } from "../price.types";
 import { SVMTransactionHistoryItem } from "./transactionParsing";
@@ -25,6 +25,16 @@ export declare class SVMVM extends VM<PublicKey, Keypair, Connection> {
         index: number;
     };
     static fromMnemonic(mnemonic: string): VM<PublicKey, Keypair, Connection>;
+    deriveSavingsAccount(accountIndex: number): {
+        privateKey: Keypair;
+        address: PublicKey;
+        derivationPath: string;
+    };
+    discoverWallets(connection: Connection, options?: WalletDiscoveryOptions): Promise<WalletDiscoveryResult>;
+    private checkWalletBalance;
+    private sleep;
+    discoverPockets(connection: Connection, options?: PocketDiscoveryOptions): Promise<WalletDiscoveryResult>;
+    private checkPocketBalance;
 }
 export declare class SVMChainWallet extends ChainWallet<PublicKey, Keypair, Connection> {
     constructor(config: ChainWalletConfig, privateKey: Keypair, index: number);