@deserialize/multi-vm-wallet 1.3.3 → 1.4.0

package/dist/IChainWallet.d.ts

@@ -1,4 +1,5 @@
 import { EVMTransactionHistoryItem } from "./evm/transactionParsing";
+import { PriceResponse } from "./price.types";
 import { SVMTransactionHistoryItem } from "./svm/transactionParsing";
 import { Balance, ChainWalletConfig, TokenInfo, TransactionResult, UserTokenBalance, NFT } from "./types";
 export declare abstract class ChainWallet<AddressType, PrivateKeyType, ConnectionType> {
@@ -17,6 +18,7 @@ export declare abstract class ChainWallet<AddressType, PrivateKeyType, Connectio
     abstract discoverToken(): Promise<UserTokenBalance<AddressType>[]>;
     abstract discoverNFT(): Promise<NFT[]>;
     abstract getTransactionHistory(): Promise<(SVMTransactionHistoryItem | EVMTransactionHistoryItem)[]>;
+    abstract getPrices(tokenAddresses: string[]): Promise<PriceResponse>;
     getAddress(): AddressType;
     getChainWalletConfig(): ChainWalletConfig;
 }

package/dist/IChainWallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"IChainWallet.js","sourceRoot":"","sources":["../utils/IChainWallet.ts"],"names":[],"mappings":";;;AAIA,MAAsB,WAAW;IACnB,UAAU,CAAiB;IACrC,MAAM,CAAoB;IAC1B,OAAO,CAAc;IACrB,KAAK,CAAoB;IACzB,UAAU,CAA4B;IAEtC,YAAY,MAAyB,EAAE,UAA0B,EAAE,KAAc;QAC7E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAEvB,CAAC;IAWD,+GAA+G;IAC/G,mEAAmE;IACnE,mFAAmF;IACnF,oDAAoD;IAEpD,UAAU;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,oBAAoB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CAEJ;AApCD,kCAoCC"}
+{"version":3,"file":"IChainWallet.js","sourceRoot":"","sources":["../utils/IChainWallet.ts"],"names":[],"mappings":";;;AAKA,MAAsB,WAAW;IACnB,UAAU,CAAiB;IACrC,MAAM,CAAoB;IAC1B,OAAO,CAAc;IACrB,KAAK,CAAoB;IACzB,UAAU,CAA4B;IAEtC,YAAY,MAAyB,EAAE,UAA0B,EAAE,KAAc;QAC7E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAEvB,CAAC;IAYD,+GAA+G;IAC/G,mEAAmE;IACnE,mFAAmF;IACnF,oDAAoD;IAEpD,UAAU;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,oBAAoB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CAEJ;AArCD,kCAqCC"}

package/dist/evm/evm.d.ts

@@ -6,17 +6,17 @@
 import { ChainWallet } from "../IChainWallet";
 import { Balance, ChainWalletConfig, UserTokenBalance, TokenInfo, TransactionResult, NFT } from "../types";
 import { VM } from "../vm";
-import { JsonRpcProvider, Wallet } from "ethers";
 import { EVMTransactionHistoryItem } from "./transactionParsing";
-import { Hex, PublicClient } from "viem";
+import { Hex, WalletClient, PublicClient, ChainConfig } 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> {
+import { PriceResponse } from "../price.types";
+import { SavingsManager } from "../savings/saving-actions";
+export declare class EVMVM extends VM<string, string, PublicClient> {
     derivationPath: string;
     constructor(seed: string);
-    getTokenInfo: (tokenAddress: string, provider: JsonRpcProvider) => Promise<TokenInfo>;
-    static getTokenInfo: (tokenAddress: string, provider: JsonRpcProvider) => Promise<TokenInfo>;
+    getTokenInfo: (tokenAddress: Hex, client: PublicClient) => Promise<TokenInfo>;
+    static getTokenInfo: (tokenAddress: Hex, client: PublicClient) => Promise<TokenInfo>;
     generatePrivateKey(index: number, seed?: string, mnemonic?: string, derivationPath?: string): {
         privateKey: string;
         index: number;
@@ -37,14 +37,13 @@ export declare class EVMVM extends VM<string, string, JsonRpcProvider> {
         address: string;
         derivationPath: string;
     };
-    static fromMnemonic(mnemonic: string): VM<string, string, JsonRpcProvider>;
+    static fromMnemonic(mnemonic: string): VM<string, string, PublicClient>;
     static validateAddress(address: string): boolean;
-    static getNativeBalance(address: string, connection: JsonRpcProvider): Promise<Balance>;
-    static getTokenBalance(address: string, tokenAddress: string, connection: JsonRpcProvider): Promise<Balance>;
+    static getNativeBalance(address: string, connection: PublicClient): Promise<Balance>;
+    static getTokenBalance(address: string, tokenAddress: string, connection: PublicClient): Promise<Balance>;
 }
-export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcProvider> {
-    client: PublicClient;
-    wallet: Wallet;
+export declare class EVMChainWallet extends ChainWallet<string, string, PublicClient> {
+    wallet: WalletClient;
     private smartWallet?;
     private savingsManager?;
     private smartSavingsManager?;
@@ -59,6 +58,7 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
      * @returns true if extend() has been called and smart wallet exists
      */
     private isSmartWalletInitialized;
+    createSavingsManager(mnemonic: string, index: number | undefined, chain: ChainConfig): SavingsManager;
     /**
      * Validate that AA is available for sponsored transactions
      * @throws Error with helpful message if AA is not available
@@ -100,7 +100,7 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
      * @returns Smart wallet address or undefined
      */
     getSmartWalletAddress(): string | undefined;
-    getWallet(): Wallet;
+    getWallet(): WalletClient;
     generateAddress(): string;
     getNativeBalance(): Promise<Balance>;
     getTokenBalance(tokenAddress: string): Promise<Balance>;
@@ -110,17 +110,9 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
     transferNative(to: string, amount: number): Promise<TransactionResult>;
     transferToken(tokenAddress: TokenInfo, to: string, amount: number): Promise<TransactionResult>;
     getTransactionHistory(): Promise<EVMTransactionHistoryItem[]>;
+    getPrices(tokenAddresses: string[]): Promise<PriceResponse>;
     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>;
-    private performDebonkSwap;
     private fail;
-    private performKyberSwap;
-    getSwapQuote(tokenIn: TokenInfo, tokenOut: TokenInfo, amount: number): Promise<{
-        amountOut: string;
-        priceImpact: string;
-        gasEstimate: string;
-        route: string[];
-    }>;
     approveToken(params: {
         tokenAddress: string;
         spender: string;
@@ -128,155 +120,5 @@ export declare class EVMChainWallet extends ChainWallet<string, string, JsonRpcP
         confirmations?: number;
         gasLimit?: string | bigint;
     }): Promise<TransactionResult>;
-    executeContractMethod(params: {
-        contractAddress: string;
-        abi: any[];
-        methodName: string;
-        methodParams?: any[];
-        value?: string | bigint;
-        gasLimit?: string | bigint;
-        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;
 }