@deserialize/multi-vm-wallet 1.5.35 → 1.6.1

package/dist/constant.js

@@ -16,7 +16,21 @@ exports.DefaultChains = [{
         logoUrl: "https://solana.com/src/img/branding/solanaLogoMark.svg",
         vmType: "SVM",
         savings: {
-            tokens: []
+            supported: true,
+            tokens: [
+                {
+                    name: "USDC",
+                    symbol: "USDC",
+                    decimals: 6,
+                    address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+                },
+                {
+                    name: "USDT",
+                    symbol: "USDT",
+                    decimals: 6,
+                    address: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"
+                }
+            ]
         }
     },
     {
@@ -33,6 +47,7 @@ exports.DefaultChains = [{
         logoUrl: "https://push.org/assets/website/favicons/favicon.svg",
         vmType: "EVM",
         savings: {
+            supported: false,
             tokens: []
         }
     },
@@ -48,7 +63,23 @@ exports.DefaultChains = [{
         },
         testnet: false,
         logoUrl: "https://etherscan.io/images/svg/brands/ethereum-original-light.svg",
-        vmType: "EVM"
+        vmType: "EVM",
+        savings: {
+            supported: true,
+            tokens: [{
+                    name: "USDC",
+                    symbol: "USDC",
+                    decimals: 6,
+                    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+                },
+                {
+                    name: "USDT",
+                    symbol: "USDT",
+                    decimals: 6,
+                    address: "0xdac17f958d2ee523a2206206994597c13d831ec7"
+                }
+            ]
+        }
     }, {
         chainId: 56,
         name: "BSC",
@@ -63,7 +94,15 @@ exports.DefaultChains = [{
         logoUrl: "https://bscscan.com/assets/bsc/images/svg/logos/token-light.svg?v=25.10.5.0",
         vmType: "EVM",
         savings: {
-            tokens: []
+            supported: true,
+            tokens: [
+                {
+                    name: "BUSD",
+                    symbol: "BUSD",
+                    decimals: 6,
+                    address: "0x55d398326f99059fF775485246999027B3197955"
+                }
+            ]
         }
     },
     {
@@ -80,7 +119,15 @@ exports.DefaultChains = [{
         logoUrl: "https://avatars.githubusercontent.com/u/108554348?s=200&v=4",
         vmType: "EVM",
         savings: {
-            tokens: []
+            supported: true,
+            tokens: [
+                {
+                    name: "USDC",
+                    symbol: "USDC",
+                    decimals: 6,
+                    address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+                }
+            ]
         }
     },
     {
@@ -97,6 +144,7 @@ exports.DefaultChains = [{
         logoUrl: "https://avatars.githubusercontent.com/u/119917794?s=280&v=4",
         vmType: "EVM",
         savings: {
+            supported: false,
             tokens: []
         }
     },
@@ -114,6 +162,7 @@ exports.DefaultChains = [{
         logoUrl: "https://avatars.githubusercontent.com/u/58791460?s=280&v=4",
         vmType: "EVM",
         savings: {
+            supported: false,
             tokens: []
         }
     },
@@ -131,6 +180,7 @@ exports.DefaultChains = [{
         logoUrl: "https://polygonscan.com/images/svg/brands/polygon-light.svg?v=0.0.36",
         vmType: "EVM",
         savings: {
+            supported: false,
             tokens: []
         }
     }

package/dist/evm/evm.js

@@ -397,7 +397,7 @@ class EVMVM extends vm_1.VM {
         for (let attempt = 0; attempt < maxRetries; attempt++) {
             try {
                 const pocketIndex = accountIndex + 1;
-                const derivationPath = `m/44'/60'/${pocketIndex}'/0/${walletIndex}'`;
+                const derivationPath = `m/44'/60'/${pocketIndex}'/0/${walletIndex}`;
                 const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(this.seed, walletIndex, `m/44'/60'/${pocketIndex}'/0/`);
                 const wallet = new ethers_1.ethers.Wallet(privateKey);
                 const address = wallet.address;

package/dist/savings/evm-savings.js

@@ -42,9 +42,10 @@ class EVMSavingsManager extends savings_manager_1.SavingsManager {
         this.checkNotDisposed();
         validation_1.SavingsValidation.validateAccountIndex(accountIndex);
         const pocketIndex = accountIndex + 1;
-        const derivationPath = `${this.derivationPathBase}${pocketIndex}'/0/${this.walletIndex}`;
+        const derivationPathBase = `${this.derivationPathBase}${pocketIndex}'/0/`;
+        const derivationPath = `${derivationPathBase}${this.walletIndex}'`;
         const seed = (0, walletBip32_1.mnemonicToSeed)(this.mnemonic);
-        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPath);
+        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPathBase);
         const wallet = new ethers_1.ethers.Wallet(privateKey);
         const pocket = {
             privateKey,
@@ -57,9 +58,10 @@ class EVMSavingsManager extends savings_manager_1.SavingsManager {
     }
     getMainWallet() {
         this.checkNotDisposed();
-        const derivationPath = `${this.derivationPathBase}0'/0/${this.walletIndex}`;
+        const derivationPathBase = `${this.derivationPathBase}0'/0/`;
+        const derivationPath = `${derivationPathBase}${this.walletIndex}'`;
         const seed = (0, walletBip32_1.mnemonicToSeed)(this.mnemonic);
-        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPath);
+        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPathBase);
         const wallet = new ethers_1.ethers.Wallet(privateKey);
         return {
             privateKey,

package/dist/savings/multi-chain-savings.d.ts

@@ -17,6 +17,7 @@ export interface PocketBalance {
     balances: {
         token: string;
         balance: Balance;
+        balanceInUsd: number;
     }[];
 }
 export declare class MultiChainSavingsManager {
@@ -25,6 +26,9 @@ export declare class MultiChainSavingsManager {
     private evmManagers;
     private svmManagers;
     private chainConfigs;
+    private getTokenKey;
+    private normalizePriceMap;
+    private getPriceMap;
     constructor(mnemonic: string, chains: ChainConfig[], walletIndex?: number);
     addChain(chain: ChainConfig): void;
     removeChain(chainId: string): void;

package/dist/savings/multi-chain-savings.js

@@ -3,12 +3,41 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MultiChainSavingsManager = void 0;
 const evm_savings_1 = require("./evm-savings");
 const svm_savings_1 = require("./svm-savings");
+const price_1 = require("../price");
 class MultiChainSavingsManager {
     mnemonic;
     walletIndex;
     evmManagers = new Map();
     svmManagers = new Map();
     chainConfigs = new Map();
+    getTokenKey(tokenAddress, chainType) {
+        if (chainType === 'EVM') {
+            return tokenAddress.toLowerCase();
+        }
+        return tokenAddress;
+    }
+    normalizePriceMap(prices, chainType) {
+        const priceMap = new Map();
+        for (const item of prices) {
+            if (!item?.tokenAddress || typeof item.price !== 'number')
+                continue;
+            priceMap.set(this.getTokenKey(item.tokenAddress, chainType), item.price);
+        }
+        return priceMap;
+    }
+    async getPriceMap(chain, tokenAddresses) {
+        const chainWithId = chain.config;
+        if (typeof chainWithId.chainId !== 'number') {
+            return new Map();
+        }
+        const uniqueTokenAddresses = Array.from(new Set(tokenAddresses));
+        const priceResult = await (0, price_1.fetchPrices)({
+            vm: chain.type,
+            chainId: chainWithId.chainId,
+            tokenAddresses: uniqueTokenAddresses
+        });
+        return this.normalizePriceMap(priceResult.data?.prices ?? [], chain.type);
+    }
     constructor(mnemonic, chains, walletIndex = 0) {
         if (!mnemonic || typeof mnemonic !== 'string') {
             throw new Error('Mnemonic must be a non-empty string');
@@ -29,9 +58,9 @@ class MultiChainSavingsManager {
         if (this.chainConfigs.has(chain.id)) {
             throw new Error(`Chain with id '${chain.id}' already exists`);
         }
-        this.chainConfigs.set(chain.id, chain);
         if (chain.type === 'EVM') {
             const manager = new evm_savings_1.EVMSavingsManager(this.mnemonic, chain.config, this.walletIndex);
+            this.chainConfigs.set(chain.id, chain);
             this.evmManagers.set(chain.id, manager);
         }
         else if (chain.type === 'SVM') {
@@ -40,6 +69,7 @@ class MultiChainSavingsManager {
                 throw new Error(`SVM chain '${chain.id}' must have rpcUrl in config`);
             }
             const manager = new svm_savings_1.SVMSavingsManager(this.mnemonic, config.rpcUrl, this.walletIndex);
+            this.chainConfigs.set(chain.id, chain);
             this.svmManagers.set(chain.id, manager);
         }
         else {
@@ -95,14 +125,21 @@ class MultiChainSavingsManager {
             const manager = this.evmManagers.get(chainId);
             const balances = await manager.getPocketBalance(pocketIndex, tokens);
             const pocket = manager.getPocket(pocketIndex);
+            const balanceRows = balances.map(b => ({
+                token: b.address === 'native' ? 'native' : b.address,
+                balance: b.balance
+            }));
+            const priceMap = await this.getPriceMap(chain, balanceRows.map(row => row.token));
             return {
                 chainId,
                 chainType: 'EVM',
                 pocketIndex,
                 address: pocket.address,
-                balances: balances.map(b => ({
-                    token: b.address === 'native' ? 'native' : b.address,
-                    balance: b.balance
+                balances: balanceRows.map(row => ({
+                    token: row.token,
+                    balance: row.balance,
+                    balanceInUsd: row.balance.formatted *
+                        (priceMap.get(this.getTokenKey(row.token, 'EVM')) ?? 0)
                 }))
             };
         }
@@ -110,14 +147,21 @@ class MultiChainSavingsManager {
             const manager = this.svmManagers.get(chainId);
             const balances = await manager.getPocketBalance(pocketIndex, tokens);
             const pocket = manager.getPocket(pocketIndex);
+            const balanceRows = balances.map(b => ({
+                token: b.address === 'native' ? 'native' : b.address.toBase58(),
+                balance: b.balance
+            }));
+            const priceMap = await this.getPriceMap(chain, balanceRows.map(row => row.token));
             return {
                 chainId,
                 chainType: 'SVM',
                 pocketIndex,
                 address: pocket.address.toBase58(),
-                balances: balances.map(b => ({
-                    token: b.address === 'native' ? 'native' : b.address.toBase58(),
-                    balance: b.balance
+                balances: balanceRows.map(row => ({
+                    token: row.token,
+                    balance: row.balance,
+                    balanceInUsd: row.balance.formatted *
+                        (priceMap.get(this.getTokenKey(row.token, 'SVM')) ?? 0)
                 }))
             };
         }

package/dist/savings/saving-manager.d.ts

@@ -42,5 +42,5 @@ export declare class SavingsManager extends BaseSavingsManager {
         address: Hex | 'native';
         balance: Balance;
     }[]>;
-    sendToMainWallet(pocketIndex: number, amountInEther: number, token: Hex | "native"): Promise<TransactionResult>;
+    sendToMainWallet(pocketIndex: number, amount: bigint, token: Hex | "native"): Promise<TransactionResult>;
 }

package/dist/savings/saving-manager.js

@@ -43,24 +43,25 @@ class BaseSavingsManager {
     derivePocket(accountIndex) {
         validation_1.SavingsValidation.validateAccountIndex(accountIndex);
         const pocketIndex = accountIndex + 1;
-        const derivationPath = `m/44'/60'/${pocketIndex}'/0/${this.walletIndex}`;
-        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)((0, walletBip32_1.mnemonicToSeed)(this.mnemonic), this.walletIndex, derivationPath);
+        const derivationPathBase = `m/44'/60'/${pocketIndex}'/0/`;
+        const derivationPath = `${derivationPathBase}${this.walletIndex}'`;
+        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)((0, walletBip32_1.mnemonicToSeed)(this.mnemonic), this.walletIndex, derivationPathBase);
         const wallet = new ethers_1.ethers.Wallet(privateKey);
         const pocket = { privateKey, address: wallet.address, derivationPath, index: pocketIndex };
-        this.pockets.set(pocketIndex, pocket);
+        this.pockets.set(accountIndex, pocket);
         return pocket;
     }
     getMainWallet() {
-        const mainWalletDerivationPath = `m/44'/60'/0'/0/${this.walletIndex}`;
-        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(this.mnemonic, this.walletIndex, mainWalletDerivationPath);
+        const mainWalletDerivationPathBase = `m/44'/60'/0'/0/`;
+        const mainWalletDerivationPath = `${mainWalletDerivationPathBase}${this.walletIndex}'`;
+        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)((0, walletBip32_1.mnemonicToSeed)(this.mnemonic), this.walletIndex, mainWalletDerivationPathBase);
         const wallet = new ethers_1.ethers.Wallet(privateKey);
         return { privateKey, address: wallet.address, derivationPath: mainWalletDerivationPath };
     }
     getMainWalletAddress() {
         if (this.masterAddress)
             return this.masterAddress;
-        const { privateKey } = this.getMainWallet();
-        return new ethers_1.ethers.Wallet(privateKey).address;
+        return this.getMainWallet().address;
     }
     getPocket(accountIndex) {
         if (!this.pockets.has(accountIndex)) {
@@ -88,7 +89,7 @@ class BaseSavingsManager {
         return pocket.address.toLowerCase() === storedAddress.toLowerCase();
     }
     accountFromPocketId(p) {
-        return (0, accounts_1.privateKeyToAccount)(`0x${this.derivePocket(p).privateKey}`);
+        return (0, accounts_1.privateKeyToAccount)(`0x${this.getPocket(p).privateKey}`);
     }
     clearPocket(accountIndex) {
         validation_1.SavingsValidation.validateAccountIndex(accountIndex);
@@ -151,11 +152,9 @@ class SavingsManager extends BaseSavingsManager {
         }));
         return balancesList;
     }
-    async sendToMainWallet(pocketIndex, amountInEther, token) {
+    async sendToMainWallet(pocketIndex, amount, token) {
         validation_1.SavingsValidation.validateAccountIndex(pocketIndex);
-        if (typeof amountInEther !== 'number' || amountInEther <= 0) {
-            throw new Error(`Amount must be a positive number, got: ${amountInEther}`);
-        }
+        validation_1.SavingsValidation.validateAmount(amount, 'Transfer amount');
         if (token !== 'native') {
             validation_1.SavingsValidation.validateAddress(token, 'Token address');
         }
@@ -167,9 +166,9 @@ class SavingsManager extends BaseSavingsManager {
             chain: this.client.chain
         });
         if (token === "native") {
-            return await (0, evm_1.sendNativeToken)(walletClient, this.client, mainWalletAddress, BigInt(amountInEther));
+            return await (0, evm_1.sendNativeToken)(walletClient, this.client, mainWalletAddress, amount);
         }
-        const res = await (0, evm_1.sendERC20Token)(walletClient, this.client, token, mainWalletAddress, BigInt(amountInEther));
+        const res = await (0, evm_1.sendERC20Token)(walletClient, this.client, token, mainWalletAddress, amount);
         return res;
     }
 }

package/dist/savings/savings-operations.js

@@ -9,8 +9,9 @@ class SavingsOperations {
         validation_1.SavingsValidation.validateMnemonic(mnemonic);
         validation_1.SavingsValidation.validateAccountIndex(accountIndex);
         validation_1.SavingsValidation.validateWalletIndex(walletIndex);
+        const pocketIndex = accountIndex + 1;
         const seed = (0, walletBip32_1.mnemonicToSeed)(mnemonic);
-        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, walletIndex, `m/44'/60'/${accountIndex}'/`);
+        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, walletIndex, `m/44'/60'/${pocketIndex}'/0/`);
         const wallet = new ethers_1.Wallet(privateKey, provider);
         const address = wallet.address;
         const cleanup = () => {
@@ -131,8 +132,9 @@ class SavingsOperations {
         validation_1.SavingsValidation.validateMnemonic(mnemonic);
         validation_1.SavingsValidation.validateAccountIndex(accountIndex);
         validation_1.SavingsValidation.validateWalletIndex(walletIndex);
+        const pocketIndex = accountIndex + 1;
         const seed = (0, walletBip32_1.mnemonicToSeed)(mnemonic);
-        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, walletIndex, `m/44'/60'/${accountIndex}'/`);
+        const { privateKey } = (0, walletBip32_1.EVMDeriveChildPrivateKey)(seed, walletIndex, `m/44'/60'/${pocketIndex}'/0/`);
         const wallet = new ethers_1.Wallet(privateKey);
         const address = wallet.address;
         return address;

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

@@ -10,6 +10,7 @@ export declare class SVMSavingsManager extends SavingsManager<PublicKey, Connect
     get client(): Connection;
     createClient(rpcUrl: string): Connection;
     clearClient(): void;
+    private toSafeNumberAmount;
     derivePocket(accountIndex: number): Pocket<PublicKey>;
     getMainWallet(): {
         privateKey: Keypair;

package/dist/savings/svm-savings.js

@@ -34,13 +34,20 @@ class SVMSavingsManager extends savings_manager_1.SavingsManager {
     clearClient() {
         this._client = undefined;
     }
+    toSafeNumberAmount(amount, label) {
+        if (amount > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new Error(`${label} exceeds Number.MAX_SAFE_INTEGER and cannot be represented safely: ${amount}`);
+        }
+        return Number(amount);
+    }
     derivePocket(accountIndex) {
         this.checkNotDisposed();
         validation_1.SavingsValidation.validateAccountIndex(accountIndex);
         const pocketIndex = accountIndex + 1;
-        const derivationPath = `${this.derivationPathBase}${pocketIndex}'/0/${this.walletIndex}`;
+        const derivationPathBase = `${this.derivationPathBase}${pocketIndex}'/0/`;
+        const derivationPath = `${derivationPathBase}${this.walletIndex}'`;
         const seed = (0, walletBip32_1.mnemonicToSeed)(this.mnemonic);
-        const keypair = (0, walletBip32_1.SVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPath);
+        const keypair = (0, walletBip32_1.SVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPathBase);
         const pocket = {
             privateKey: keypair,
             address: keypair.publicKey,
@@ -52,9 +59,10 @@ class SVMSavingsManager extends savings_manager_1.SavingsManager {
     }
     getMainWallet() {
         this.checkNotDisposed();
-        const derivationPath = `${this.derivationPathBase}0'/0/${this.walletIndex}`;
+        const derivationPathBase = `${this.derivationPathBase}0'/0/`;
+        const derivationPath = `${derivationPathBase}${this.walletIndex}'`;
         const seed = (0, walletBip32_1.mnemonicToSeed)(this.mnemonic);
-        const keypair = (0, walletBip32_1.SVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPath);
+        const keypair = (0, walletBip32_1.SVMDeriveChildPrivateKey)(seed, this.walletIndex, derivationPathBase);
         return {
             privateKey: keypair,
             address: keypair.publicKey,
@@ -120,7 +128,7 @@ class SVMSavingsManager extends savings_manager_1.SavingsManager {
             throw new Error(`Amount must be a positive bigint, got: ${amount}`);
         }
         const pocket = this.getPocket(pocketIndex);
-        const tx = await (0, svm_1.getTransferNativeTransaction)(mainWallet, pocket.address, Number(amount), this.client);
+        const tx = await (0, svm_1.getTransferNativeTransaction)(mainWallet, pocket.address, this.toSafeNumberAmount(amount, 'Native transfer amount'), this.client);
         const hash = await (0, svm_1.signAndSendTransaction)(tx, this.client, mainWallet);
         return { success: true, hash };
     }
@@ -130,7 +138,7 @@ class SVMSavingsManager extends savings_manager_1.SavingsManager {
             throw new Error(`Amount must be a positive bigint, got: ${amount}`);
         }
         const pocket = this.getPocket(pocketIndex);
-        const tx = await (0, svm_1.getTransferTokenTransaction)(mainWallet, pocket.address, tokenInfo, Number(amount), this.client);
+        const tx = await (0, svm_1.getTransferTokenTransaction)(mainWallet, pocket.address, tokenInfo, this.toSafeNumberAmount(amount, 'Token transfer amount'), this.client);
         const hash = await (0, svm_1.signAndSendTransaction)(tx, this.client, mainWallet);
         return { success: true, hash };
     }
@@ -160,11 +168,11 @@ class SVMSavingsManager extends savings_manager_1.SavingsManager {
         const pocket = this.getPocket(pocketIndex);
         const mainWalletAddress = this.getMainWalletAddress();
         if (token === "native") {
-            const tx = await (0, svm_1.getTransferNativeTransaction)(pocket.privateKey, mainWalletAddress, Number(amount), this.client);
+            const tx = await (0, svm_1.getTransferNativeTransaction)(pocket.privateKey, mainWalletAddress, this.toSafeNumberAmount(amount, 'Native withdrawal amount'), this.client);
             const hash = await (0, svm_1.signAndSendTransaction)(tx, this.client, pocket.privateKey);
             return { success: true, hash };
         }
-        const tx = await (0, svm_1.getTransferTokenTransaction)(pocket.privateKey, mainWalletAddress, token, Number(amount), this.client);
+        const tx = await (0, svm_1.getTransferTokenTransaction)(pocket.privateKey, mainWalletAddress, token, this.toSafeNumberAmount(amount, 'Token withdrawal amount'), this.client);
         const hash = await (0, svm_1.signAndSendTransaction)(tx, this.client, pocket.privateKey);
         return { success: true, hash };
     }

package/dist/test.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const web3_js_1 = require("@solana/web3.js");
+const svm_1 = require("./svm");
 const evm_1 = require("./evm");
 const viem_1 = require("viem");
 const chains_1 = require("viem/chains");
@@ -243,6 +244,7 @@ const testAddressClass = async () => {
     const evmAddressClass = new evm_1.EVMChainAddress(evmChainConfig, "0xC9C1D854b82BA9b4FB6f6D58E9EF3d1fAEd601AA", 0);
     const res = await evmAddressClass.getNativeBalance();
     console.log('res: ', res);
+    svm_1.SVMVM.generateMnemonicFromPrivateKey;
 };
 testAddressClass();
 const RPC_URL = chainConfig.rpcUrl;

package/dist/types.d.ts

@@ -20,7 +20,8 @@ export interface ChainWalletConfig {
     aaSupport?: AA_SupportConfig;
 }
 export interface ChainSavingConfig {
-    tokens: string[];
+    supported: boolean;
+    tokens: TokenInfo[];
 }
 export interface AA_SupportConfig {
     enabled: boolean;

package/dist/utils.d.ts

@@ -1,2 +1,31 @@
-import { vmTypes } from "./types";
+import { ChainWalletConfig, vmTypes } from "./types";
 export declare const getPrivateKeyFromAnother: (privateKey: any, fromVm: vmTypes, toVm: vmTypes) => string | import("@solana/web3.js").Keypair | undefined;
+export interface AddressPortfolioItem {
+    tokenAddress: string | "native";
+    symbol: string;
+    decimals: number;
+    balanceRaw: string;
+    balanceFormatted: number;
+    priceUsd: number | null;
+    valueUsd: number | null;
+}
+export interface AddressPortfolioResult {
+    address: string;
+    vmType: vmTypes;
+    chainId: number;
+    items: AddressPortfolioItem[];
+    totals: {
+        valueUsd: number;
+        pricedItems: number;
+        unpricedItems: number;
+    };
+}
+export interface AddressPortfolioParams {
+    chain: ChainWalletConfig;
+    address: string;
+    vmType?: vmTypes;
+    includeNative?: boolean;
+    tokenAddresses?: string[];
+}
+export declare const detectVmTypeFromAddress: (address: string) => vmTypes;
+export declare const getAddressPortfolioValue: (params: AddressPortfolioParams) => Promise<AddressPortfolioResult>;