@deserialize/multi-vm-wallet 1.5.22 → 1.5.32

package/utils/evm/evm.ts

@@ -5,7 +5,7 @@
  */
 
 import { EntropyToMnemonic, EVMDeriveChildPrivateKey } from "../walletBip32";
-import { ChainWallet } from "../IChainWallet";
+import { ChainAddress, ChainWallet } from "../IChainWallet";
 import { Balance, ChainWalletConfig, NFTInfo, UserTokenBalance, TokenInfo, TransactionResult, NFT, DiscoveredWallet, WalletDiscoveryOptions, WalletDiscoveryResult, PocketDiscoveryOptions } from "../types";
 import { VM } from "../vm";
 import { VMValidation, sanitizeError, logSafeError } from "../vm-validation";
@@ -50,6 +50,133 @@ import { Account, generatePrivateKey, privateKeyToAccount } from "viem/accounts"
 // import { extendWalletClientWithSavings } from "../savings";
 // import { SavingsManager } from "../savings/saving-actions";
 
+/**
+ * Create a viem public client for the given EVM chain configuration.
+ *
+ * @param config - Chain configuration with RPC endpoint and chain metadata.
+ * @returns Configured viem `PublicClient`.
+ */
+export const createEvmPublicClient = (config: ChainWalletConfig): PublicClient =>
+    createPublicClient({
+        chain: fromChainToViemChain(config),
+        transport: http(config.rpcUrl),
+    });
+
+/**
+ * Create a viem wallet client bound to a specific account.
+ *
+ * @param config - Chain configuration with RPC endpoint and chain metadata.
+ * @param account - Account used for signing transactions and messages.
+ * @returns Configured viem `WalletClient`.
+ */
+export const createEvmWalletClient = (config: ChainWalletConfig, account: Account): WalletClient =>
+    createWalletClient({
+        account,
+        chain: fromChainToViemChain(config),
+        transport: http(config.rpcUrl),
+    });
+
+/**
+ * Fetch transaction history and return an empty array on failure.
+ *
+ * @param connection - viem public client used to query chain data.
+ * @param address - Wallet address to inspect.
+ * @returns Parsed EVM transaction history items.
+ */
+export const getEvmTransactionHistorySafe = async (
+    connection: PublicClient,
+    address: string
+): Promise<EVMTransactionHistoryItem[]> => {
+    try {
+        return await getEVMTransactionHistory(connection, address as Hex);
+    } catch {
+        return [];
+    }
+};
+
+/**
+ * Fetch token prices for EVM tokens on the configured chain.
+ *
+ * @param config - Chain configuration used for chain ID resolution.
+ * @param tokenAddresses - Token contract addresses to query.
+ * @returns Price data keyed by token address.
+ * @throws Error when the pricing service returns an error payload.
+ */
+export const getSvmPricesForTokens = async (
+    config: ChainWalletConfig,
+    tokenAddresses: string[]
+): Promise<PriceResponse> => {
+    const result = await fetchPrices({
+        vm: 'EVM',
+        chainId: config.chainId,
+        tokenAddresses,
+    });
+
+    if (result.error) {
+        throw new Error(result.error.message);
+    }
+
+    return result.data as PriceResponse;
+};
+
+/**
+ * Get native token balance for an address.
+ *
+ * @param address - Wallet address to query.
+ * @param connection - viem public client.
+ * @returns Native balance details.
+ */
+export const getEvmNativeBalance = async (
+    address: string,
+    connection: PublicClient
+): Promise<Balance> => {
+    return await EVMVM.getNativeBalance(address, connection);
+};
+
+/**
+ * Get ERC-20 token balance for an address.
+ *
+ * @param address - Wallet address to query.
+ * @param tokenAddress - ERC-20 contract address.
+ * @param connection - viem public client.
+ * @returns Token balance details.
+ */
+export const getEvmTokenBalance = async (
+    address: string,
+    tokenAddress: string,
+    connection: PublicClient
+): Promise<Balance> => {
+    return await EVMVM.getTokenBalance(address, tokenAddress, connection);
+};
+
+/**
+ * Discover token balances held by an address.
+ *
+ * @param address - Wallet address to scan.
+ * @param config - Chain configuration.
+ * @returns Discovered token balances.
+ */
+export const discoverEvmTokens = async (
+    address: string,
+    config: ChainWalletConfig
+): Promise<UserTokenBalance<string>[]> => {
+    return await discoverTokens(address, config);
+};
+
+/**
+ * Discover NFTs held by an address.
+ *
+ * @param address - Wallet address to scan.
+ * @param config - Chain configuration.
+ * @returns Discovered NFT items.
+ */
+export const discoverEvmNFTs = async (
+    address: string,
+    config: ChainWalletConfig
+): Promise<NFT[]> => {
+    return await discoverNFTs(address, config);
+};
+
 
 interface DebonkQuoteResponse {
     tokenA: string;
@@ -98,6 +225,15 @@ export class EVMVM extends VM<string, string, PublicClient> {
 
     getTokenInfo = getTokenInfo
     static getTokenInfo = getTokenInfo
+    /**
+     * Derive an EVM private key for a wallet index.
+     *
+     * @param index - Wallet index in the derivation path.
+     * @param seed - Optional explicit seed (takes priority over mnemonic).
+     * @param mnemonic - Optional mnemonic used when seed is not provided.
+     * @param derivationPath - Base derivation path prefix.
+     * @returns Derived private key and index.
+     */
     generatePrivateKey(index: number, seed?: string, mnemonic?: string, derivationPath = this.derivationPath) {
         // Validate inputs
         VMValidation.validateIndex(index, 'Wallet index');
@@ -121,10 +257,22 @@ export class EVMVM extends VM<string, string, PublicClient> {
         return { privateKey, index };
     }
 
+    /**
+     * Convert raw private key entropy into a mnemonic phrase.
+     *
+     * @param privateKey - Private key entropy input.
+     * @returns Generated mnemonic phrase.
+     */
     static generateMnemonicFromPrivateKey(privateKey: string): string {
 
         return EntropyToMnemonic(privateKey)
     }
+    /**
+     * Create an `EVMVM` instance from a mnemonic phrase.
+     *
+     * @param mnemonic - BIP-39 mnemonic phrase.
+     * @returns Initialized EVM VM instance.
+     */
     static fromMnemonic(mnemonic: string): VM<string, string, PublicClient> {
         const seed = VM.mnemonicToSeed(mnemonic)
         return new EVMVM(seed)
@@ -191,16 +339,37 @@ export class EVMVM extends VM<string, string, PublicClient> {
         return ethers.getAddress(address);
     }
 
+    /**
+     * Read the native token balance for an address.
+     *
+     * @param address - Wallet address to query.
+     * @param connection - viem public client.
+     * @returns Native balance details.
+     */
     static async getNativeBalance(address: string, connection: PublicClient): Promise<Balance> {
         // Implement native balance retrieval logic here
         return await getNativeBalance(address as Hex, connection)
     }
 
+    /**
+     * Read an ERC-20 token balance for an address.
+     *
+     * @param address - Wallet address that owns the token.
+     * @param tokenAddress - ERC-20 contract address.
+     * @param connection - viem public client.
+     * @returns Token balance details.
+     */
     static async getTokenBalance(address: string, tokenAddress: string, connection: PublicClient): Promise<Balance> {
         // Implement token balance retrieval logic here
         return await getTokenBalance(tokenAddress as Hex, address as Hex, connection)
     }
 
+    /**
+     * Convert arbitrary entropy text into a deterministic private-key-like hash.
+     *
+     * @param entropy - Input entropy string.
+     * @returns `keccak256` hash of the input.
+     */
     static convertFromEntropyToPrivateKey = (entropy: string): string => {
         const p = ethers.id(entropy)
         return p
@@ -688,29 +857,106 @@ export class EVMVM extends VM<string, string, PublicClient> {
 
 }
 
+export class EVMChainAddress extends ChainAddress<string, PublicClient> {
+    /**
+     * Create an EVM chain address wrapper with an attached public client.
+     *
+     * @param config - Chain configuration.
+     * @param address - Wallet address.
+     * @param index - Optional derivation index.
+     */
+    constructor(config: ChainWalletConfig, address: string, index?: number) {
+        const connection = createEvmPublicClient(config);
+        super(config, address, index);
+        this.connection = connection;
+    }
+
+    /**
+     * Get native balance for this address.
+     *
+     * @returns Native balance details.
+     */
+    async getNativeBalance(): Promise<Balance> {
+        return await getEvmNativeBalance(this.address, this.connection!);
+    }
+
+    /**
+     * Get ERC-20 token balance for this address.
+     *
+     * @param tokenAddress - ERC-20 contract address.
+     * @returns Token balance details.
+     */
+    async getTokenBalance(tokenAddress: string): Promise<Balance> {
+        return await getEvmTokenBalance(this.address, tokenAddress, this.connection!);
+    }
+
+    /**
+     * Discover fungible tokens held by this address.
+     *
+     * @returns Discovered token balances.
+     */
+    async discoverToken(): Promise<UserTokenBalance<string>[]> {
+        return await discoverEvmTokens(this.address, this.config);
+    }
+
+    /**
+     * Discover NFTs held by this address.
+     *
+     * @returns Discovered NFTs.
+     */
+    async discoverNFT(): Promise<NFT[]> {
+        return await discoverEvmNFTs(this.address, this.config);
+    }
+
+    /**
+     * Retrieve transaction history for this address.
+     *
+     * @returns Parsed transaction history entries.
+     */
+    async getTransactionHistory(): Promise<EVMTransactionHistoryItem[]> {
+        return await getEvmTransactionHistorySafe(this.connection!, this.address);
+    }
+
+    /**
+     * Fetch price data for the provided token addresses.
+     *
+     * @param tokenAddresses - Token contract addresses.
+     * @returns Price response.
+     */
+    async getPrices(tokenAddresses: string[]): Promise<PriceResponse> {
+        return await getSvmPricesForTokens(this.config, tokenAddresses);
+    }
+
+
+}
+
+
 export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
     wallet: WalletClient
     private smartWallet?: EVMSmartWallet
     // private savingsManager?: SavingsManager
     // private smartSavingsManager?: SmartSavingsManager
 
+    /**
+     * Create an EVM wallet bound to a chain configuration and private key.
+     *
+     * @param config - Chain configuration.
+     * @param privateKey - Hex private key (with or without `0x` prefix).
+     * @param index - Wallet index.
+     */
     constructor(config: ChainWalletConfig, privateKey: string, index: number) {
         privateKey = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`
-        super(config, privateKey, index);
-        this.connection = createPublicClient(
-            {
-                chain: fromChainToViemChain(config),
-                transport: http(config.rpcUrl)
-            },
-        )
+        const connection = createEvmPublicClient(config);
         const account = privateKeyToAccount(privateKey as Hex)
-        this.wallet = createWalletClient({
-            account,
-            chain: fromChainToViemChain(config),
-            transport: http(config.rpcUrl)
-        })
-        this.address = account.address
+        const wallet = createEvmWalletClient(config, account);
+        const address = account.address
+        super(config, address, privateKey, index);
+
+
         this.privateKey = privateKey;
+        this.wallet = wallet;
+        this.connection = connection;
+        this.address = address
     }
 
     // ============================================
@@ -725,6 +971,12 @@ export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
         return this.config.aaSupport?.enabled === true;
     }
 
+    /**
+     * Convert entropy text into a hex string.
+     *
+     * @param entropy - Entropy string.
+     * @returns Hex-encoded string.
+     */
     convertFromEntropyToPrivateKey = (entropy: string): string => {
         return toHex(entropy)
     }
@@ -878,73 +1130,132 @@ export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
     // Existing Wallet Methods
     // ============================================
 
+    /**
+     * Get the underlying viem wallet client.
+     *
+     * @returns Wallet client instance.
+     */
     getWallet(): WalletClient {
         return this.wallet
     }
 
+    /**
+     * Get this wallet's address.
+     *
+     * @returns Wallet address.
+     */
     generateAddress(): string {
         return this.address;
     }
 
+    /**
+     * Get native token balance for this wallet.
+     *
+     * @returns Native balance details.
+     */
     async getNativeBalance(): Promise<Balance> {
         // Implement native balance retrieval logic here
-        return await EVMVM.getNativeBalance(this.address, this.connection!)
+        return await getEvmNativeBalance(this.address, this.connection!);
     }
 
+    /**
+     * Get ERC-20 token balance for this wallet.
+     *
+     * @param tokenAddress - ERC-20 contract address.
+     * @returns Token balance details.
+     */
     async getTokenBalance(tokenAddress: string): Promise<Balance> {
         // Implement token balance retrieval logic here
-        return await EVMVM.getTokenBalance(this.address, tokenAddress, this.connection!)
+        return await getEvmTokenBalance(this.address, tokenAddress, this.connection!);
     }
 
+    /**
+     * Get ERC-20 token metadata.
+     *
+     * @param tokenAddress - ERC-20 contract address.
+     * @returns Token metadata returned by `getTokenInfo`.
+     */
     async getTokenInfo(tokenAddress: string) {
         return await EVMVM.getTokenInfo(tokenAddress as Hex, this.connection!)
     }
 
+    /**
+     * Discover fungible tokens held by this wallet.
+     *
+     * @returns Discovered token balances.
+     */
     async discoverToken(): Promise<UserTokenBalance<string>[]> {
         // Implement token discovery logic here
-        return await discoverTokens(this.address, this.config)
+        return await discoverEvmTokens(this.address, this.config);
     }
 
+    /**
+     * Discover NFTs held by this wallet.
+     *
+     * @returns Discovered NFTs.
+     */
     async discoverNFT(): Promise<NFT[]> {
         // Implement NFT discovery logic here
-        return await discoverNFTs(this.address, this.config)
+        return await discoverEvmNFTs(this.address, this.config);
     }
 
+    /**
+     * Send native tokens to another address.
+     *
+     * @param to - Recipient address.
+     * @param amount - Amount in native token units.
+     * @returns Transaction result.
+     */
     async transferNative(to: string, amount: number): Promise<TransactionResult> {
         const wallet = this.getWallet();
         return await sendNativeToken(wallet, this.connection!, to as Hex, amount.toString(), this.config.confirmationNo || 5);
     }
 
+    /**
+     * Send ERC-20 tokens to another address.
+     *
+     * @param tokenAddress - Token info containing contract address.
+     * @param to - Recipient address.
+     * @param amount - Token amount to transfer.
+     * @returns Transaction result.
+     */
     async transferToken(tokenAddress: TokenInfo, to: string, amount: number): Promise<TransactionResult> {
         const wallet = this.getWallet();
         return await sendERC20Token(wallet, this.connection!, tokenAddress.address as Hex, to as Hex, BigInt(amount.toString()), this.config.confirmationNo || 5);
     }
 
+    /**
+     * Get transaction history for this wallet address.
+     *
+     * @returns Parsed transaction history entries.
+     */
     async getTransactionHistory(): Promise<EVMTransactionHistoryItem[]> {
         const wallet = this.getWallet();
         let res: EVMTransactionHistoryItem
-        try {
-            return await getEVMTransactionHistory(this.connection!, this.address as Hex);
-        } catch (error) {
-            return []
-        }
+        return await getEvmTransactionHistorySafe(this.connection!, this.address);
     }
 
+    /**
+     * Fetch prices for token contracts on this wallet's chain.
+     *
+     * @param tokenAddresses - Token contract addresses.
+     * @returns Price response.
+     */
     async getPrices(tokenAddresses: string[]): Promise<PriceResponse> {
-        const result = await fetchPrices({
-            vm: 'EVM',
-            chainId: this.config.chainId,
-            tokenAddresses,
-        });
-
-        if (result.error) {
-            throw new Error(result.error.message);
-        }
-
-        return result.data as PriceResponse;
+        return await getSvmPricesForTokens(this.config, tokenAddresses);
     }
 
     // Updated swap method signature to match base class so created another method to use it inside swap
+    /**
+     * Swap tokens using the chain's swap integration.
+     *
+     * @param tokenAddress - Source token info.
+     * @param to - Destination token or recipient address, depending on integration.
+     * @param amount - Amount to swap.
+     * @param slippage - Slippage tolerance in basis points.
+     * @returns Transaction result.
+     * @throws Error Always throws because this method is not implemented.
+     */
     async swap(
         tokenAddress: TokenInfo,
         to: string,
@@ -959,6 +1270,12 @@ export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
 
 
     // Helper method for EVMChainWallet class
+    /**
+     * Build a standardized failed swap result.
+     *
+     * @param message - Failure reason.
+     * @returns Failed Debonk swap result.
+     */
     private fail(message: string): DebonkSwapResult {
         return {
             success: false,
@@ -971,6 +1288,17 @@ export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
 
 
 
+    /**
+     * Approve ERC-20 token allowance for a spender.
+     *
+     * @param params - Approval parameters.
+     * @param params.tokenAddress - ERC-20 contract address.
+     * @param params.spender - Spender address to approve.
+     * @param params.amountRaw - Raw allowance amount.
+     * @param params.confirmations - Confirmation blocks to wait for.
+     * @param params.gasLimit - Optional gas limit (currently unused in this wrapper).
+     * @returns Transaction result.
+     */
     async approveToken(params: {
         tokenAddress: string
         spender: string
@@ -997,6 +1325,13 @@ export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
 
 
 
+    /**
+     * Sign an arbitrary message with this wallet account.
+     *
+     * @param message - Message to sign.
+     * @returns Hex signature string.
+     * @throws Error if wallet account is unavailable.
+     */
     async signMessage(message: string): Promise<string> {
 
         const signer = this.wallet
@@ -1007,260 +1342,4 @@ export class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
         return signer.signMessage({ message, account: signer.account?.address })
     }
 
-    // // ============================================
-    // // Savings Pocket Methods
-    // // ============================================
-
-    // /**
-    //  * Get or create the SavingsManager instance (lazy initialization)
-    //  * @private
-    //  */
-    // private getSavingsManager(): SavingsManager {
-    //     if (!this.savingsManager) {
-    //         // Create a VM instance from the current wallet's seed
-    //         // We need to get the seed from the privateKey
-    //         // For now, we'll create an EVMVM from the wallet
-    //         // Note: This requires access to the seed, which we'll need to handle
-    //         throw new Error(
-    //             "SavingsManager requires access to the seed phrase. " +
-    //             "Please initialize the wallet with a seed phrase or mnemonic to use savings features."
-    //         );
-    //     }
-    //     return this.savingsManager;
-    // }
-
-    // /**
-    //  * Initialize savings functionality with a seed phrase
-    //  *
-    //  * This must be called before using any savings methods.
-    //  * The seed is used to derive savings accounts using BIP-44.
-    //  *
-    //  * @param seed - The wallet seed (hex string)
-    //  *
-    //  * @example
-    //  * const seed = VM.mnemonicToSeed(mnemonic);
-    //  * wallet.initializeSavings(seed);
-    //  */
-    // initializeSavings(seed: string): void {
-    //     const vm = new EVMVM(seed);
-    //     this.savingsManager = new SavingsManager(vm);
-    // }
-
-    // /**
-    //  * Derive a new savings account from BIP-44 account index
-    //  *
-    //  * @param accountIndex - The BIP-44 account index (1+ for savings, 0 is main wallet)
-    //  * @returns SavingsAccount with derived address and private key
-    //  *
-    //  * @example
-    //  * const savingsAccount1 = wallet.deriveSavingsAccount(1); // m/44'/60'/1'/0/0
-    //  * const savingsAccount2 = wallet.deriveSavingsAccount(2); // m/44'/60'/2'/0/0
-    //  */
-    // deriveSavingsAccount(accountIndex: number): SavingsAccount {
-    //     return this.getSavingsManager().createSavingsAccount(accountIndex);
-    // }
-
-    // /**
-    //  * Transfer native tokens to a savings account
-    //  *
-    //  * Security: Always derives the destination address from accountIndex.
-    //  *
-    //  * @param accountIndex - Savings account index to deposit to
-    //  * @param amount - Amount in ether units (e.g., "1.5" for 1.5 ETH)
-    //  * @param options - Optional security and priority settings
-    //  * @returns Transaction result
-    //  *
-    //  * @example
-    //  * const result = await wallet.transferToSavings(1, "1.5"); // Send 1.5 ETH to savings account 1
-    //  */
-    // async transferToSavings(
-    //     accountIndex: number,
-    //     amount: string,
-    //     options?: TransferToSavingsOptions
-    // ): Promise<TransactionResult> {
-    //     const manager = this.getSavingsManager();
-
-    //     // Build transaction using derived address
-    //     const amountWei = parseEther(amount);
-    //     const txParams = manager.buildDepositTransaction(accountIndex, amountWei, options);
-
-    //     // Execute using existing transferNative method
-    //     return await this.transferNative(txParams.to, Number(amount));
-    // }
-
-    // // /**
-    // //  * Withdraw native tokens from a savings account
-    // //  *
-    // //  * Security: Uses the derived private key for signing.
-    // //  *
-    // //  * @param accountIndex - Savings account index to withdraw from
-    // //  * @param to - Destination address
-    // //  * @param amount - Amount in ether units (e.g., "0.5" for 0.5 ETH)
-    // //  * @param options - Optional security and priority settings
-    // //  * @returns Transaction result
-    // //  *
-    // //  * @example
-    // //  * const result = await wallet.withdrawFromSavings(1, destinationAddress, "0.5");
-    // //  */
-    // // async withdrawFromSavings(
-    // //     accountIndex: number,
-    // //     to: string,
-    // //     amount: string,
-    // //     options?: WithdrawFromSavingsOptions
-    // // ): Promise<TransactionResult> {
-    // //     const manager = this.getSavingsManager();
-
-    // //     // Build withdrawal transaction
-    // //     const amountWei = parseEther(amount);
-    // //     const withdrawalParams = manager.buildWithdrawalTransaction(
-    // //         accountIndex,
-    // //         to as Hex,
-    // //         amountWei,
-    // //         options
-    // //     );
-
-    // //     // Create a temporary wallet with the savings account private key
-    // //     const savingsWallet = new Wallet(withdrawalParams.privateKey, this.connection);
-
-    // //     // Send transaction using the savings wallet
-    // //     const tx = await savingsWallet.sendTransaction({
-    // //         to: withdrawalParams.to,
-    // //         value: withdrawalParams.value
-    // //     });
-
-    // //     const receipt = await tx.wait(this.config.confirmationNo || 1);
-
-    // //     return {
-    // //         success: receipt?.status === 1,
-    // //         hash: receipt?.hash || tx.hash
-    // //     };
-    // // }
-
-    // /**
-    //  * Verify a stored savings address matches the derived address
-    //  *
-    //  * Security: Prevents database tampering attacks.
-    //  *
-    //  * @param accountIndex - The account index to verify
-    //  * @param storedAddress - The address from storage/database
-    //  * @returns Verification result
-    //  *
-    //  * @example
-    //  * const result = wallet.verifySavingsAddress(1, storedAddress);
-    //  * if (!result.isValid) {
-    //  *     console.error("Security alert: Address tampering detected!");
-    //  * }
-    //  */
-    // verifySavingsAddress(accountIndex: number, storedAddress: Hex): AddressVerificationResult {
-    //     return this.getSavingsManager().verifySavingsAddress(accountIndex, storedAddress);
-    // }
-
-    // /**
-    //  * Audit multiple savings addresses at once
-    //  *
-    //  * @param addresses - Map of accountIndex to stored address
-    //  * @returns Audit result with summary and details
-    //  *
-    //  * @example
-    //  * const addresses = new Map([[1, "0xabc..."], [2, "0xdef..."]]);
-    //  * const audit = wallet.auditSavingsAddresses(addresses);
-    //  * console.log(`Valid: ${audit.valid}/${audit.total}`);
-    //  */
-    // auditSavingsAddresses(addresses: Map<number, Hex>): SavingsAuditResult {
-    //     return this.getSavingsManager().auditSavingsAddresses(addresses);
-    // }
-
-    // /**
-    //  * Get savings account information without exposing private key
-    //  *
-    //  * @param accountIndex - The account index
-    //  * @returns Public account information (address and derivation path)
-    //  *
-    //  * @example
-    //  * const info = wallet.getSavingsAccountInfo(1);
-    //  * console.log(`Address: ${info.address}`);
-    //  * console.log(`Path: ${info.derivationPath}`); // m/44'/60'/1'/0/0
-    //  */
-    // getSavingsAccountInfo(accountIndex: number): Omit<SavingsAccount, 'privateKey'> {
-    //     return this.getSavingsManager().getSavingsAccountInfo(accountIndex);
-    // }
-
-    // // ============================================
-    // // Smart Savings Methods (EIP-7702)
-    // // ============================================
-
-    // /**
-    //  * Get or create the SmartSavingsManager instance (lazy initialization)
-    //  * @private
-    //  */
-    // private getSmartSavingsManager(): SmartSavingsManager {
-    //     if (!this.smartSavingsManager) {
-    //         this.smartSavingsManager = new SmartSavingsManager(this.config);
-    //     }
-    //     return this.smartSavingsManager;
-    // }
-
-    // /**
-    //  * 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 accountIndex - The savings account index to upgrade
-    //  * @param options - Optional smart wallet configuration
-    //  * @param autoInitialize - Whether to initialize the smart wallet (default: false)
-    //  * @returns SmartSavingsAccount with EVMSmartWallet instance
-    //  *
-    //  * @example
-    //  * // Upgrade without initialization
-    //  * const smartSavings = await wallet.upgradeSavingsToSmartAccount(1);
-    //  * await smartSavings.smartWallet.initialize(); // Initialize separately
-    //  *
-    //  * @example
-    //  * // Upgrade and initialize in one step
-    //  * const smartSavings = await wallet.upgradeSavingsToSmartAccount(1, {}, true);
-    //  * // Ready to use immediately
-    //  */
-    // async upgradeSavingsToSmartAccount(
-    //     accountIndex: number,
-    //     options?: SmartWalletOptions,
-    //     autoInitialize: boolean = false
-    // ): Promise<SmartSavingsAccount> {
-    //     const manager = this.getSmartSavingsManager();
-
-    //     // First derive the basic savings account
-    //     const basicSavings = this.deriveSavingsAccount(accountIndex);
-
-    //     // Then upgrade to smart account
-    //     if (autoInitialize) {
-    //         return await manager.upgradeSavingsAndInitialize(basicSavings, options);
-    //     } else {
-    //         return await manager.upgradeSavingsToSmartAccount(basicSavings, options);
-    //     }
-    // }
-
-    // /**
-    //  * Check if smart savings is supported on this chain
-    //  *
-    //  * @returns true if chain supports Account Abstraction
-    //  *
-    //  * @example
-    //  * if (wallet.isSmartSavingsSupported()) {
-    //  *     const smartSavings = await wallet.upgradeSavingsToSmartAccount(1);
-    //  * } else {
-    //  *     console.log("This chain doesn't support smart savings");
-    //  * }
-    //  */
-    // isSmartSavingsSupported(): boolean {
-    //     try {
-    //         const manager = this.getSmartSavingsManager();
-    //         return manager.canUpgradeToSmartAccount();
-    //     } catch (error) {
-    //         return false;
-    //     }
-    // }
 }
-