@deserialize/multi-vm-wallet 1.3.1 → 1.3.3

package/dist/evm/aa-service/services/bundler.js

@@ -11,28 +11,62 @@ exports.createBundlerManager = createBundlerManager;
 exports.createBundlerService = createBundlerService;
 const viem_1 = require("viem");
 const account_abstraction_1 = require("viem/account-abstraction");
+const pimlico_1 = require("permissionless/clients/pimlico");
 // ============================================
 // Pimlico Bundler
 // ============================================
 class PimlicoBundler {
     apiKey;
     clientCache = new Map();
-    constructor(apiKey) {
-        if (!apiKey) {
-            throw new Error('Pimlico API key is required');
-        }
+    url;
+    aaConfig;
+    constructor(apiKey, url, aaConfig) {
+        this.url = url;
         this.apiKey = apiKey;
+        this.aaConfig = aaConfig;
     }
     getBundlerUrl(chain) {
+        if (!this.apiKey) {
+            return this.url;
+        }
         return `https://api.pimlico.io/v2/${chain.id}/rpc?apikey=${this.apiKey}`;
     }
     getClient(chain) {
         if (this.clientCache.has(chain.id)) {
             return this.clientCache.get(chain.id);
         }
+        const bundlerUrl = this.getBundlerUrl(chain);
+        // Get entryPoint from aaConfig or fallback to default
+        let entryPointAddress;
+        let entryPointVersion = '0.7';
+        if (this.aaConfig && this.aaConfig.entryPoints.length > 0) {
+            // Use first entry point from config (could be enhanced to select by version)
+            const ep = this.aaConfig.entryPoints[0];
+            entryPointAddress = ep.address;
+            entryPointVersion = ep.version;
+        }
+        else {
+            // Fallback to hardcoded default
+            entryPointAddress = account_abstraction_1.entryPoint07Address;
+            entryPointVersion = '0.7';
+        }
+        // Create Pimlico client for Pimlico-specific features (gas estimation)
+        const entryPoint = {
+            address: entryPointAddress,
+            version: entryPointVersion
+        };
+        const paymasterClient = (0, pimlico_1.createPimlicoClient)({
+            transport: (0, viem_1.http)(bundlerUrl),
+            entryPoint
+        });
+        // Create bundler client with Pimlico gas estimation
         const client = (0, account_abstraction_1.createBundlerClient)({
-            transport: (0, viem_1.http)(this.getBundlerUrl(chain)),
-            chain
+            transport: (0, viem_1.http)(bundlerUrl),
+            chain,
+            userOperation: {
+                estimateFeesPerGas: async () => (await paymasterClient.getUserOperationGasPrice()).fast,
+            },
+            // paymaster: paymasterClient,
         });
         this.clientCache.set(chain.id, client);
         return client;
@@ -111,7 +145,7 @@ class BundlerManager {
     constructor(config) {
         switch (config.provider) {
             case 'pimlico':
-                this.bundlerService = new PimlicoBundler(config.apiKey);
+                this.bundlerService = new PimlicoBundler(config.apiKey ? config.apiKey : '', config.customUrl ? config.customUrl : '', config.aaConfig);
                 break;
             // case 'etherspot':
             //     this.bundlerService = new EtherspotBundler();

package/dist/evm/aa-service/services/bundler.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../../../utils/evm/aa-service/services/bundler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../../../utils/evm/aa-service/services/bundler.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuOH,oDAEC;AAED,oDAmBC;AA5PD,+BAAqF;AACrF,kEAAwH;AACxH,4DAAqE;AAuBrE,+CAA+C;AAC/C,kBAAkB;AAClB,+CAA+C;AAE/C,MAAM,cAAc;IACR,MAAM,CAAS;IACf,WAAW,GAAqB,IAAI,GAAG,EAAE,CAAC;IAC1C,GAAG,CAAS;IACZ,QAAQ,CAAoB;IAEpC,YAAY,MAAc,EAAE,GAAW,EAAE,QAA2B;QAChE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,aAAa,CAAC,KAAY;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,GAAG,CAAA;QACnB,CAAC;QACD,OAAO,6BAA6B,KAAK,CAAC,EAAE,eAAe,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7E,CAAC;IAED,SAAS,CAAC,KAAY;QAClB,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAE7C,sDAAsD;QACtD,IAAI,iBAAgC,CAAC;QACrC,IAAI,iBAAiB,GAAkB,KAAK,CAAC;QAE7C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,6EAA6E;YAC7E,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACxC,iBAAiB,GAAG,EAAE,CAAC,OAAwB,CAAC;YAChD,iBAAiB,GAAG,EAAE,CAAC,OAAO,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,gCAAgC;YAChC,iBAAiB,GAAG,yCAAmB,CAAC;YACxC,iBAAiB,GAAG,KAAK,CAAC;QAC9B,CAAC;QAED,uEAAuE;QACvE,MAAM,UAAU,GAAG;YACf,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,iBAAiB;SAC7B,CAAC;QAEF,MAAM,eAAe,GAAG,IAAA,6BAAmB,EAAC;YACxC,SAAS,EAAE,IAAA,WAAI,EAAC,UAAU,CAAC;YAC3B,UAAU;SACb,CAAC,CAAC;QAEH,oDAAoD;QACpD,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC;YAC/B,SAAS,EAAE,IAAA,WAAI,EAAC,UAAU,CAAC;YAC3B,KAAK;YACL,aAAa,EAAE;gBACX,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,eAAe,CAAC,wBAAwB,EAAE,CAAC,CAAC,IAAI;aAC1F;YACD,8BAA8B;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,WAAW;QACP,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,UAAU;QACN,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACJ;AAED,kDAAkD;AAClD,uBAAuB;AACvB,kDAAkD;AAElD,qDAAqD;AACrD,yDAAyD;AAEzD,4CAA4C;AAC5C,8CAA8C;AAC9C,QAAQ;AAER,qCAAqC;AACrC,gDAAgD;AAChD,qDAAqD;AACrD,YAAY;AAEZ,6CAA6C;AAC7C,qBAAqB;AACrB,oDAAoD;AACpD,0DAA0D;AAE1D,kDAAkD;AAClD,yBAAyB;AACzB,QAAQ;AAER,8BAA8B;AAC9B,8BAA8B;AAC9B,QAAQ;AAER,2BAA2B;AAC3B,oCAAoC;AACpC,QAAQ;AACR,IAAI;AAEJ,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C,MAAM,aAAa;IACP,UAAU,CAAS;IACnB,WAAW,GAAqB,IAAI,GAAG,EAAE,CAAC;IAElD,YAAY,UAAkB;QAC1B,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,aAAa,CAAC,KAAY;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,KAAY;QAClB,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,yBAAkB,EAAC;YAC9B,KAAK;YACL,SAAS,EAAE,IAAA,WAAI,EAAC,IAAI,CAAC,UAAU,CAAC;SACnC,CAAC,CAAC,MAAM,CAAC,oBAAa,CAAC,CAAC,MAAM,CAAC,oBAAa,CAAC,CAAC;QAE/C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,WAAW;QACP,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,UAAU;QACN,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACJ;AAED,+CAA+C;AAC/C,kBAAkB;AAClB,+CAA+C;AAE/C,MAAa,cAAc;IACf,cAAc,CAAiB;IAEvC,YAAY,MAAqB;QAC7B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,SAAS;gBACV,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CACpC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAClC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EACxC,MAAM,CAAC,QAAQ,CAClB,CAAC;gBACF,MAAM;YACV,oBAAoB;YACpB,oDAAoD;YACpD,aAAa;YACb,KAAK,QAAQ;gBACT,IAAI,CAAC,cAAc,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,SAAU,CAAC,CAAC;gBAC3D,MAAM;YACV;gBACI,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAY;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,KAAY;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAED,UAAU;QACN,IAAI,YAAY,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrC,IAAI,CAAC,cAAsB,CAAC,UAAU,EAAE,CAAC;QAC9C,CAAC;IACL,CAAC;CACJ;AAxCD,wCAwCC;AAED,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C,SAAgB,oBAAoB,CAAC,MAAqB;IACtD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,oBAAoB,CAAC,MAAqB;IACtD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO;QACH,SAAS,EAAE,CAAC,KAAa,EAAE,EAAE;YACzB,MAAM,WAAW,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;YAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;QACD,aAAa,EAAE,CAAC,KAAa,EAAE,EAAE;YAC7B,MAAM,WAAW,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;YAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;KAC3C,CAAC;AACN,CAAC"}

package/dist/evm/evm.d.ts

@@ -4,13 +4,14 @@
  * this is a class that will be responsible for creating several evm wallets code
  */
 import { ChainWallet } from "../IChainWallet";
-import { Balance, ChainWalletConfig, UserTokenBalance, TokenInfo, TransactionResult, NFT, FeePayerOptions } from "../types";
+import { Balance, ChainWalletConfig, UserTokenBalance, TokenInfo, TransactionResult, NFT } from "../types";
 import { VM } from "../vm";
 import { JsonRpcProvider, Wallet } from "ethers";
 import { EVMTransactionHistoryItem } from "./transactionParsing";
-import { PublicClient } from "viem";
+import { Hex, PublicClient } from "viem";
 import { EVMSmartWallet } from "./smartWallet";
 import { SmartWalletOptions } from "./aa-service";
+import { SavingsAccount, SmartSavingsAccount, AddressVerificationResult, SavingsAuditResult, TransferToSavingsOptions, WithdrawFromSavingsOptions } from "../savings/types";
 export declare class EVMVM extends VM<string, string, JsonRpcProvider> {
     derivationPath: string;
     constructor(seed: string);
@@ -20,6 +21,22 @@ export declare class EVMVM extends VM<string, string, JsonRpcProvider> {
         privateKey: string;
         index: number;
     };
+    /**
+     * Derive a savings account using BIP-44 account index
+     *
+     * Uses the pattern: m/44'/60'/accountIndex'/0/0
+     * - Main wallet: m/44'/60'/0'/0/0 (account index 0)
+     * - Savings 1: m/44'/60'/1'/0/0 (account index 1)
+     * - Savings 2: m/44'/60'/2'/0/0 (account index 2)
+     *
+     * @param accountIndex - The BIP-44 account index (0 for main, 1+ for savings)
+     * @returns Object containing privateKey, address, and derivation path
+     */
+    deriveSavingsAccount(accountIndex: number): {
+        privateKey: string;
+        address: string;
+        derivationPath: string;
+    };
     static fromMnemonic(mnemonic: string): VM<string, string, JsonRpcProvider>;
     static validateAddress(address: string): boolean;
     static getNativeBalance(address: string, connection: JsonRpcProvider): Promise<Balance>;
@@ -29,6 +46,8 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
     client: PublicClient;
     wallet: Wallet;
     private smartWallet?;
+    private savingsManager?;
+    private smartSavingsManager?;
     constructor(config: ChainWalletConfig, privateKey: string, index: number);
     /**
      * Check if Account Abstraction is supported on this chain
@@ -81,16 +100,6 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
      * @returns Smart wallet address or undefined
      */
     getSmartWalletAddress(): string | undefined;
-    /**
-     * Transfer native tokens with sponsored gas (internal method)
-     * Requires smart wallet to be initialized via extend()
-     */
-    private transferNativeSponsored;
-    /**
-     * Transfer tokens with sponsored gas (internal method)
-     * Requires smart wallet to be initialized via extend()
-     */
-    private transferTokenSponsored;
     getWallet(): Wallet;
     generateAddress(): string;
     getNativeBalance(): Promise<Balance>;
@@ -98,8 +107,8 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
     getTokenInfo(tokenAddress: string): Promise<TokenInfo>;
     discoverToken(): Promise<UserTokenBalance<string>[]>;
     discoverNFT(): Promise<NFT[]>;
-    transferNative(to: string, amount: number, feePayerOptions?: FeePayerOptions): Promise<TransactionResult>;
-    transferToken(tokenAddress: TokenInfo, to: string, amount: number, feePayerOptions?: FeePayerOptions): Promise<TransactionResult>;
+    transferNative(to: string, amount: number): Promise<TransactionResult>;
+    transferToken(tokenAddress: TokenInfo, to: string, amount: number): Promise<TransactionResult>;
     getTransactionHistory(): Promise<EVMTransactionHistoryItem[]>;
     swap(tokenAddress: TokenInfo, to: string, amount: number, slippage?: number): Promise<TransactionResult>;
     performCompleteSwap(tokenIn: TokenInfo, tokenOut: TokenInfo, amount: number, slippage?: number, recipient?: string, deadline?: number): Promise<TransactionResult>;
@@ -129,4 +138,145 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
         confirmations?: number;
     }): Promise<TransactionResult>;
     signMessage(message: string): Promise<string>;
+    /**
+     * Get or create the SavingsManager instance (lazy initialization)
+     * @private
+     */
+    private getSavingsManager;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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
+     */
+    transferToSavings(accountIndex: number, amount: string, options?: TransferToSavingsOptions): Promise<TransactionResult>;
+    /**
+     * 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");
+     */
+    withdrawFromSavings(accountIndex: number, to: string, amount: string, options?: WithdrawFromSavingsOptions): Promise<TransactionResult>;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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'>;
+    /**
+     * Get or create the SmartSavingsManager instance (lazy initialization)
+     * @private
+     */
+    private getSmartSavingsManager;
+    /**
+     * 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
+     */
+    upgradeSavingsToSmartAccount(accountIndex: number, options?: SmartWalletOptions, autoInitialize?: boolean): Promise<SmartSavingsAccount>;
+    /**
+     * 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;
 }