@lunch-money/ethereum-to-lunch-money 1.4.0 → 2.0.1

package/README.md

@@ -15,31 +15,49 @@ yarn
 yarn test
 ```
 
+## Ethereum Network Service Provider and aggregator usage and configuration
+The connector provides an interface to create an Ethereum walletClient which provides an interface to check the wallet's balances. Ethereum supports multiple networks (or "chains"), but each walletClient is created for a single network. It is suggested to use the ethereum mainnet when creating the clients. A future optimization may be to support other networks.
+
+Once created the walletClient uses the ethers library to query balances in an ethereum wallet.  By default this returns only the wallet's ethereum balance unless it is given a list of other tokens to look for.  Each token lookup uses gas which counts against rate limits by the Ethereum service providers.
+
+To minimize gas usage, but to support other tokens, the Moralis and Etherscan APIs are used to query the wallet for a list of tokens they maintain.  While these API requests also cost some gas, reducing the list of tokens to just those required generally optimizes the cost of the balance lookup. Moralis provides better results but has a less generous free tier. Etherscan (if set) is used as a secondary service when the Moralis API request fails. In order to leverage these APIs the following environment variables must be set:
+
+- **MORALIS_API_KEY**: [set up a key here](https://moralis.io/). Used for token discovery as the primary method. Moralis provides comprehensive ERC20 token discovery.
+- **ETHERSCAN_API_KEY**: [set up a key here](https://etherscan.io/apis). Used as a fallback for token discovery if Moralis fails. Etherscan provides token transfer event discovery.
+
+These lookups will return a list of all tokens the wallets have ever encountered, including test tokens and possibly tokens associated with scams. To further reduce the cost of balance lookups the list of discovered tokens is filtered against the list provided by 1inch, a decentralized exchange aggregator, that maintains a list of tokens with good reputations and liquidity. Filtering the list of all tokens ever used by the wallet against 1inch further reduces cost by eliminating tokens not on the provisioned network, or those that don't meet reputation standards.
+
+We use a static list of tokens from 1inch, generated at the time the library is released, as the filter.
+
+Once the list of tokens contained in a wallet is obtained, the ethers library is used to obtain the balances for these tokens.  Ethers uses one or more Ethereum Service Providers.  It is recommended to provision API Key for both of the following service providers which are used in a primary/secondary fashion:
+- **ALCHEMY_API_KEY**: [set up a key here](https://dashboard.alchemy.com/). This is the recommended service to use.
+- **INFURA_API_KEY**: [set up a key here](https://developer.metamask.io/). If set with Alchemy, it will be used as a secondary.
+
+While it is possible to perform initialization and balance lookups without setting any of these API keys it is strongly recommended to set all of them.x
+
+Net/Net when properly provisioned, this service will provide Lunch Money users with ethereum wallet balances for tokens on the network specified by Lunch Money (the default mainnet) and that have a well established reputation with 1inch.
+
 ## Debugging
 
-The following environment variables can be run with the test script or when using the plugin with Lunch Money
+The following optional environment variables can be run with the test script or when using the plugin with Lunch Money
 
 - DEBUG_ETHEREUM - set to enable detailed debug messages and enable API Key validation
+  
 - ETHEREUM_BALANCE_TIMEOUT_MSECS - the number of msecs to wait for a response before timing out
-
 The timeout was added to avoid a false CORS message when the API never returns.
 
 Tweaking this to about 1000-2000, and watching the debug messages can be useful for validating that failover is working as expected.
 
-## Live Testing
-
-There is a script, `get-balances.ts`, that can be invoked to invoke the client against a real or test wallet.  This mimics the behavior of the Lunch Money server when a user attempts to connect an Ethereum wallet.
+- DEBUG_ETHEREUM_FAIL_ON_ERROR - set to true to have the test script (or lunch money server) fail if any of the ethereum service provider keys are invalid.
 
-Copy [env.example](./env.example) to .env and set some or all of the environment variables that the script and connector use.
+Whenever the values of the Ethereum Service Provider keys are updated in an environment it is suggested to temporarily set DEBUG_ETHEREUM_FAIL_ON_ERROR to true and to watch the console messages on startup. If the app reports that all keys are valid and does not exit, then remove the environment variable prior to a final deploy.
 
-### Ethereum Service Provider API Keys
+## Live Testing
 
-If no keys are set, the script will use the public APIs which may or may not work. One or both of the following are recommended:
+There is a script, `get-balances.ts`, that can be invoked to invoke the client against a real or test wallet. This mimics the behavior of the Lunch Money server when a user attempts to connect an Ethereum wallet. 
 
-- ALCHEMY_API_KEY - [set up a key here](https://dashboard.alchemy.com/). This is the recommended service to use
-- INFURA_API_KEY - [set up a key here](https://developer.metamask.io/). If set with Alchemy will be used as a secondary
+Copy [env.example](./env.example) to .env and set some or all of the environment variables that the script and connector use.
 
-While the connector can run with other service node keys, such as Etherscan, the test script will not support it.
 
 ###  Wallet Configuration
 - LM_ETHEREUM_WALLET_ADDRESS
@@ -52,7 +70,7 @@ To run the script
 ```
 yarn test-live
 ```
-A .vscode/launch.json configuration is include to facilitate running the script in the debugger with VSCode.
+A .vscode/launch.json configuration is included to facilitate running the script in the debugger with VSCode.
 
 ## Refreshing the Token List
 
@@ -60,3 +78,35 @@ This package uses a fixed token list fetched as the token list that the 1inch
 exchange uses. Run the included script
 `./bin/refresh-token-list.sh` to refresh the token list. Refreshing the token
 list will require a new version of this package to be released.
+
+## Automated Testing of Ethereum Provider and API Key Scenarios
+
+This project includes an automated test script to validate a variety of API Key configuration scenarios. The script tests various scenarios to ensure that the keys are correctly validated and that the system behaves as expected under different conditions.
+
+### Purpose
+
+The automated test script is designed to:
+- Validate the presence and correctness of Ethereum service provider keys (e.g., Alchemy, Infura, Etherscan, Moralis).
+- Check for deprecated or unsupported keys and generate warnings.
+- Ensure that the system can fall back to appropriate methods when keys are missing or invalid.
+- Ensure that meaningful warning messages are generated when supplied keys are missing or invalid.
+- Ensure that the process ends when DEBUG_ETHEREUM_FAIL_ON_ERROR
+
+### How to Run the Tests
+
+1. **Ensure environment is built** - `yarn build`
+1. **Set Environment Variables**: Configure the necessary environment variables for the test scenarios. You can set these directly in your terminal or use a `.env` file.
+2. **Run the Scenario Script**:
+   ```
+   npm run scenarios
+   ```
+   This command will execute the test script, which will run through the predefined scenarios and log the results to the console.
+
+### Scenarios Tested
+
+- **Valid and Invalid Alchemy and Infura Keys**: Tests with valid keys to ensure successful validation.
+- **Valid and Invalid Etherscan and Moralis Keys**: Tests with valid keys to ensure successful validation.
+- **Old Pocket API Key**: Tests with deprecated keys to generate warnings.
+
+The results of each test scenario will be displayed in the console, indicating success or failure and any relevant warnings or errors.
+

package/dist/cjs/src/client.d.ts

@@ -1,11 +1,42 @@
 import * as ethscan from '@mycrypto/eth-scan';
-import * as ethers from 'ethers';
+import { type Provider, type AbstractProvider } from 'ethers';
+import { EthersProviderLike } from '@mycrypto/eth-scan/typings/src/providers/ethers.js';
+import type { LunchMoneyCryptoConnectionBalances } from './types.js';
+export type ProviderInfo = {
+    type: 'Service Provider' | 'API Provider';
+    name: string;
+    status: 'SUCCESS' | 'FAILED';
+    apiKey?: string;
+    provider?: Provider | AbstractProvider;
+    customProvider?: EthersProviderLike;
+    error?: string;
+    network?: string;
+    balance?: string;
+};
+/**
+ * Debug function that logs to console.log if DEBUG_ETHEREUM environment variable is set
+ */
+export declare const debug: (...args: unknown[]) => void;
 export interface EthereumWalletClient {
-    getChainId(): Promise<bigint>;
-    getWeiBalance(walletAddress: string): Promise<bigint>;
-    getTokensBalance(walletAddress: string, tokenContractAddresses: string[]): Promise<ethscan.BalanceMap<bigint>>;
+    getBalances(walletAddress: string, negligibleBalanceThreshold: number): Promise<LunchMoneyCryptoConnectionBalances>;
+    getWeiBalance(walletAddress: string, provider: AbstractProvider): Promise<bigint>;
+    getChainId(provider: AbstractProvider): Promise<bigint>;
+    getTokensBalance(walletAddress: string, tokenContractAddresses: string[], providerInfo: ProviderInfo): Promise<ethscan.BalanceMap<bigint>>;
+    discoverTokensHybrid(walletAddress: string, chainId: bigint): Promise<string[]>;
+}
+export declare class EtherscanProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string);
+    discoverTokensForWallet(address: string, chainId?: bigint): Promise<string[]>;
+}
+export declare class MoralisProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string);
+    discoverTokensForWallet(address: string, chainId?: bigint): Promise<string[]>;
 }
-export declare const createEthereumWalletClient: (provider: ethers.AbstractProvider) => EthereumWalletClient;
+export declare const createEthereumWalletClient: (serviceProviderInfo?: ProviderInfo[], walletAPIProviderInfo?: ProviderInfo[]) => EthereumWalletClient;
 interface Token {
     address: string;
     chainId: number;

package/dist/cjs/src/client.js

@@ -35,33 +35,369 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadTokenList = exports.createEthereumWalletClient = void 0;
+exports.loadTokenList = exports.createEthereumWalletClient = exports.MoralisProvider = exports.EtherscanProvider = exports.debug = void 0;
 const ethscan = __importStar(require("@mycrypto/eth-scan"));
+const ethers_1 = require("ethers");
 const _1inch_json_1 = __importDefault(require("../fixtures/1inch.json"));
-const createEthereumWalletClient = (provider) => {
-    // A custom ethscan provider implementation is needed to map `call` to `send` for ethscan to use the ethers client correctly.
-    // This is a temporary solution until the ethscan library is updated to support ethers v6.
-    const customProvider = {
-        send(method, params) {
-            // Type pulled from: https://github.com/MyCryptoHQ/eth-scan/blob/master/src/providers/provider.ts#L32
-            const typedParams = params;
-            return provider.call({ to: typedParams[0].to, data: typedParams[0].data });
-        },
-    };
+// Use node-fetch for Node.js compatibility
+const node_fetch_1 = __importDefault(require("node-fetch"));
+/**
+ * Debug function that logs to console.log if DEBUG_ETHEREUM environment variable is set
+ */
+const debug = (...args) => {
+    if (process.env.DEBUG_ETHEREUM) {
+        const timestamp = new Date().toISOString();
+        console.log(`[DEBUG_ETHEREUM] [${timestamp}]`, ...args);
+    }
+};
+exports.debug = debug;
+class EtherscanProvider {
+    constructor(apiKey) {
+        this.baseUrl = 'https://api.etherscan.io/v2/api';
+        this.apiKey = apiKey;
+    }
+    discoverTokensForWallet(address, chainId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Use chainId from provider, default to Ethereum mainnet (1)
+            const targetChainId = chainId ? Number(chainId) : 1;
+            const response = yield (0, node_fetch_1.default)(`${this.baseUrl}?chainid=${targetChainId}&module=account&action=tokentx&address=${address}&startblock=0&endblock=99999999&sort=desc&apikey=${this.apiKey}`);
+            const data = yield response.json();
+            // Handle valid "no transactions" response
+            if (data.status === '0' && data.message === 'No transactions found') {
+                return [];
+            }
+            // Handle API errors
+            if (data.status === '0' && data.message === 'NOTOK') {
+                throw new Error(`Etherscan V2 API error: ${data.result}`);
+            }
+            if (data.status !== '1') {
+                throw new Error(`Etherscan V2 API error: ${data.message}`);
+            }
+            // Extract unique token contract addresses from transfer events
+            const uniqueTokens = new Set();
+            for (const tx of data.result) {
+                uniqueTokens.add(tx.contractAddress);
+            }
+            return Array.from(uniqueTokens);
+        });
+    }
+}
+exports.EtherscanProvider = EtherscanProvider;
+class MoralisProvider {
+    constructor(apiKey) {
+        this.baseUrl = 'https://deep-index.moralis.io/api/v2';
+        this.apiKey = apiKey;
+    }
+    discoverTokensForWallet(address, chainId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Map chainId to Moralis chain format (only supports specific enum values)
+            let chainFormat;
+            if (chainId) {
+                switch (Number(chainId)) {
+                    case 1:
+                        chainFormat = 'eth';
+                        break; // Ethereum mainnet
+                    case 137:
+                        chainFormat = 'polygon';
+                        break; // Polygon
+                    case 56:
+                        chainFormat = 'bsc';
+                        break; // BSC
+                    case 42161:
+                        chainFormat = 'arbitrum';
+                        break; // Arbitrum
+                    case 10:
+                        chainFormat = 'optimism';
+                        break; // Optimism
+                    case 43114:
+                        chainFormat = 'avalanche';
+                        break; // Avalanche
+                    case 250:
+                        chainFormat = 'fantom';
+                        break; // Fantom
+                    default:
+                        chainFormat = 'eth';
+                        break; // Default to Ethereum
+                }
+            }
+            else {
+                chainFormat = 'eth'; // Default to Ethereum mainnet
+            }
+            const response = yield (0, node_fetch_1.default)(`${this.baseUrl}/${address}/erc20?chain=${chainFormat}`, {
+                headers: {
+                    'X-API-Key': this.apiKey,
+                },
+            });
+            if (!response.ok) {
+                const errorData = yield response.json().catch(() => ({}));
+                if (errorData.message && errorData.message.includes('over 2000 tokens')) {
+                    throw new Error(`Moralis API error: Wallet has too many tokens (>2000) - ${errorData.message}`);
+                }
+                throw new Error(`Moralis API error: ${response.status} ${response.statusText}`);
+            }
+            const data = yield response.json();
+            // Extract unique token contract addresses from balance data
+            const uniqueTokens = new Set();
+            for (const item of data) {
+                if (item.token_address && item.balance !== '0') {
+                    uniqueTokens.add(item.token_address);
+                }
+            }
+            return Array.from(uniqueTokens);
+        });
+    }
+}
+exports.MoralisProvider = MoralisProvider;
+const createEthereumWalletClient = (serviceProviderInfo = [], walletAPIProviderInfo = []) => {
+    let providers = [];
+    let etherscanProvider = null;
+    let moralisProvider = null;
+    try {
+        // Initialize the custom provider(s) for ethscan to use the ethers client correctly.
+        // A custom ethscan provider implementation is needed to map `call` to `send` for ethscan to use the ethers client correctly.
+        // This is a temporary solution until the ethscan library is updated to support ethers v6.
+        if (serviceProviderInfo.length) {
+            providers = Object.freeze(serviceProviderInfo.map((providerInfo) => {
+                if (providerInfo.type === 'Service Provider' && providerInfo.provider) {
+                    return Object.assign(Object.assign({}, providerInfo), { customProvider: {
+                            send(method, params) {
+                                var _a;
+                                // Type pulled from: https://github.com/MyCryptoHQ/eth-scan/blob/master/src/providers/provider.ts#L32
+                                const typedParams = params;
+                                return (_a = providerInfo.provider) === null || _a === void 0 ? void 0 : _a.call({
+                                    to: typedParams[0].to,
+                                    data: typedParams[0].data,
+                                });
+                            },
+                        } });
+                }
+                else {
+                    throw new Error(`Invalid service provider: ${providerInfo.name} passed to createEthereumWalletClient`);
+                }
+            }));
+            // Initialize any wallet API providers
+            for (const walletKeyInfo of walletAPIProviderInfo) {
+                if (walletKeyInfo.type === 'API Provider') {
+                    if (walletKeyInfo.name === 'Etherscan' && walletKeyInfo.apiKey) {
+                        etherscanProvider = new EtherscanProvider(walletKeyInfo.apiKey);
+                    }
+                    else if (walletKeyInfo.name === 'Moralis' && walletKeyInfo.apiKey) {
+                        moralisProvider = new MoralisProvider(walletKeyInfo.apiKey);
+                    }
+                }
+                else {
+                    throw new Error(`Invalid wallet API provider: ${walletKeyInfo.name} passed to createEthereumWalletClient`);
+                }
+            }
+        }
+        else {
+            // Create a wallet using the quorum of free service providers
+            const publicProvider = ethers_1.ethers.getDefaultProvider();
+            providers = Object.freeze([
+                ...providers,
+                {
+                    type: 'Service Provider',
+                    name: 'Public Provider',
+                    provider: publicProvider,
+                    status: 'SUCCESS',
+                    customProvider: {
+                        send(method, params) {
+                            const typedParams = params;
+                            return publicProvider === null || publicProvider === void 0 ? void 0 : publicProvider.call({ to: typedParams[0].to, data: typedParams[0].data });
+                        },
+                    },
+                },
+            ]);
+        }
+    }
+    catch (error) {
+        throw new Error(`Error creating Ethereum wallet client: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const internalGetBalances = (client, walletAddress, negligibleBalanceThreshold, provider, customProvider, obscuredWalletAddress) => __awaiter(void 0, void 0, void 0, function* () {
+        let timeoutId;
+        const timeoutDuration = process.env.ETHEREUM_BALANCE_TIMEOUT_MSECS
+            ? parseInt(process.env.ETHEREUM_BALANCE_TIMEOUT_MSECS)
+            : 60000;
+        const timeout = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                reject(new Error(`Ethereum connector getBalances timed out after ${timeoutDuration} milliseconds.`));
+            }, timeoutDuration);
+        });
+        const result = yield Promise.race([
+            (() => __awaiter(void 0, void 0, void 0, function* () {
+                try {
+                    const weiBalance = yield client.getWeiBalance(walletAddress, provider);
+                    const chainId = yield client.getChainId(provider);
+                    let filteredTokens = [];
+                    try {
+                        let discoveredTokens = [];
+                        if (moralisProvider || etherscanProvider) {
+                            discoveredTokens = yield client.discoverTokensHybrid(walletAddress, chainId);
+                            if (discoveredTokens.length > 0) {
+                                filteredTokens = yield (0, exports.loadTokenList)().then((tokens) => tokens.filter((t) => discoveredTokens.includes(t.address) && BigInt(t.chainId) === BigInt(chainId)));
+                                (0, exports.debug)(`Wallet ${obscuredWalletAddress}: Filtered to ${filteredTokens.length} tokens on chain ${chainId}`);
+                            }
+                            else {
+                                (0, exports.debug)(`Wallet ${obscuredWalletAddress}: No tokens discovered, using empty token list`);
+                            }
+                        }
+                        else {
+                            (0, exports.debug)(`Wallet ${obscuredWalletAddress}: No discovery APIs available, using full token list`);
+                            filteredTokens = (yield (0, exports.loadTokenList)()).filter((t) => BigInt(t.chainId) === BigInt(chainId));
+                        }
+                    }
+                    catch (error) {
+                        (0, exports.debug)(`Wallet ${obscuredWalletAddress}: Token discovery failed, falling back to full token list:`, error);
+                        filteredTokens = (yield (0, exports.loadTokenList)()).filter((t) => BigInt(t.chainId) === BigInt(chainId));
+                    }
+                    (0, exports.debug)(`Wallet ${obscuredWalletAddress}: Checking balances for ETH and ${filteredTokens.length} other tokens`);
+                    const map = yield ethscan.getTokensBalance(customProvider, walletAddress, filteredTokens.map((t) => t.address));
+                    return { weiBalance, chainId, map, filteredTokens };
+                }
+                finally {
+                    if (timeoutId) {
+                        clearTimeout(timeoutId);
+                    }
+                }
+            }))(),
+            timeout,
+        ]);
+        const { weiBalance, chainId, map, filteredTokens } = result;
+        (0, exports.debug)('ethers.getTokensBalance returned for wallet address:', obscuredWalletAddress);
+        const balances = Object.entries(map)
+            .map(([address, balance]) => {
+            const token = filteredTokens.find((t) => t.address === address);
+            if (!token) {
+                throw new Error(`Token ${address} not found in discovered token list for chainId ${chainId}`);
+            }
+            return {
+                asset: token.symbol,
+                undivisedAmount: balance,
+                decimals: token.decimals,
+            };
+        })
+            .concat({ asset: 'ETH', undivisedAmount: weiBalance, decimals: 18 })
+            .map(({ asset, undivisedAmount, decimals }) => ({ asset, amount: ethers_1.ethers.formatUnits(undivisedAmount, decimals) }))
+            .filter((b) => ethers_1.ethers.parseUnits(b.amount, 18) > negligibleBalanceThreshold)
+            .map((b) => ({ asset: b.asset, amount: String(b.amount) }))
+            .sort((a, b) => a.asset.localeCompare(b.asset));
+        (0, exports.debug)(`Returning from getBalances for ${obscuredWalletAddress}:`, balances);
+        const balanceResult = {
+            providerName: 'wallet_ethereum',
+            balances,
+        };
+        return balanceResult;
+    });
     return {
-        getChainId() {
+        getChainId(provider) {
             return __awaiter(this, void 0, void 0, function* () {
                 return (yield provider.getNetwork()).chainId;
             });
         },
-        getWeiBalance(walletAddress) {
+        getWeiBalance(walletAddress, provider) {
             return __awaiter(this, void 0, void 0, function* () {
                 return yield provider.getBalance(walletAddress);
             });
         },
-        getTokensBalance(walletAddress, tokenContractAddresses) {
+        getBalances(walletAddress, negligibleBalanceThreshold) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const obscuredWalletAddress = `0x..${walletAddress.slice(-6)}`;
+                (0, exports.debug)('getBalances called for wallet address:', obscuredWalletAddress);
+                let result = {
+                    providerName: 'wallet_ethereum',
+                    balances: [],
+                };
+                if (providers.length === 0) {
+                    throw new Error('No Ethereum providers available');
+                }
+                let providerIndex = 0;
+                let provider = providers[0].provider;
+                let customProvider = providers[0].customProvider;
+                let providerName = providers[0].name;
+                (0, exports.debug)(`Attempting lookup using primary provider: ${providerName}`);
+                let balanceFound = false;
+                while (!balanceFound) {
+                    try {
+                        result = yield internalGetBalances(this, walletAddress, negligibleBalanceThreshold, provider, customProvider, obscuredWalletAddress);
+                        balanceFound = true;
+                    }
+                    catch (error) {
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        (0, exports.debug)(`Error getting balances using provider ${providerName}: ${errorMessage}`);
+                        if (errorMessage.includes('unconfigured name') || errorMessage.includes('bad address checksum')) {
+                            balanceFound = true; // Should not be needed, but just in case
+                            throw new Error(`Invalid wallet address. Account needs to be relinked.`);
+                        }
+                        else if (providerIndex === providers.length - 1) {
+                            balanceFound = true; // Should not be needed, but just in case
+                            throw error;
+                        }
+                        providerIndex = providerIndex + 1;
+                        providerName = providers[providerIndex].name;
+                        provider = providers[providerIndex].provider;
+                        customProvider = providers[providerIndex].customProvider;
+                        (0, exports.debug)(`Retrying lookup using provider: ${providerName}`);
+                    }
+                }
+                return result;
+            });
+        },
+        getTokensBalance(walletAddress, tokenContractAddresses, providerInfo) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (providerInfo.customProvider) {
+                    return ethscan.getTokensBalance(providerInfo.customProvider, walletAddress, tokenContractAddresses);
+                }
+                else {
+                    throw new Error(`No ethscan compatible provider found for ${providerInfo.name}`);
+                }
+            });
+        },
+        discoverTokensHybrid(walletAddress, chainId) {
             return __awaiter(this, void 0, void 0, function* () {
-                return ethscan.getTokensBalance(customProvider, walletAddress, tokenContractAddresses);
+                const allTokens = new Set();
+                // 1. Moralis Discovery (PRIMARY)
+                if (moralisProvider) {
+                    try {
+                        const moralisTokens = yield moralisProvider.discoverTokensForWallet(walletAddress, chainId);
+                        (0, exports.debug)(`Moralis: Discovered ${moralisTokens.length} tokens`);
+                        moralisTokens.forEach((t) => allTokens.add(t));
+                    }
+                    catch (error) {
+                        (0, exports.debug)(`Moralis: Failed - ${error instanceof Error ? error.message : String(error)}`);
+                        // 2. Etherscan Discovery (FALLBACK ONLY)
+                        if (etherscanProvider) {
+                            try {
+                                const etherscanTokens = yield etherscanProvider.discoverTokensForWallet(walletAddress, chainId);
+                                (0, exports.debug)(`Etherscan (fallback): Discovered ${etherscanTokens.length} tokens`);
+                                etherscanTokens.forEach((t) => allTokens.add(t));
+                            }
+                            catch (fallbackError) {
+                                (0, exports.debug)(`Etherscan (fallback): Failed - ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}`);
+                            }
+                        }
+                        else {
+                            (0, exports.debug)('Etherscan: No API key provided for fallback');
+                        }
+                    }
+                }
+                else {
+                    (0, exports.debug)('Moralis: No API key provided');
+                    // 3. Etherscan Discovery (PRIMARY if no Moralis)
+                    if (etherscanProvider) {
+                        try {
+                            const etherscanTokens = yield etherscanProvider.discoverTokensForWallet(walletAddress, chainId);
+                            (0, exports.debug)(`Etherscan: Discovered ${etherscanTokens.length} tokens`);
+                            etherscanTokens.forEach((t) => allTokens.add(t));
+                        }
+                        catch (error) {
+                            (0, exports.debug)(`Etherscan: Failed - ${error instanceof Error ? error.message : String(error)}`);
+                        }
+                    }
+                    else {
+                        (0, exports.debug)('Etherscan: No API key provided');
+                    }
+                }
+                return Array.from(allTokens);
             });
         },
     };

package/dist/cjs/src/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4DAA8C;AAG9C,yEAAoD;AAS7C,MAAM,0BAA0B,GAAG,CAAC,QAAiC,EAAwB,EAAE;IACpG,6HAA6H;IAC7H,0FAA0F;IAC1F,MAAM,cAAc,GAAuB;QACzC,IAAI,CAAS,MAAc,EAAE,MAA2B;YACtD,qGAAqG;YACrG,MAAM,WAAW,GAAG,MAAgD,CAAC;YAErE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAoB,CAAC;QAChG,CAAC;KACF,CAAC;IAEF,OAAO;QACC,UAAU;;gBACd,OAAO,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;YAC/C,CAAC;SAAA;QACK,aAAa,CAAC,aAAa;;gBAC/B,OAAO,MAAM,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAClD,CAAC;SAAA;QACK,gBAAgB,CAAC,aAAa,EAAE,sBAAsB;;gBAC1D,OAAO,OAAO,CAAC,gBAAgB,CAAC,cAAc,EAAE,aAAa,EAAE,sBAAsB,CAAC,CAAC;YACzF,CAAC;SAAA;KACF,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,0BAA0B,8BAuBrC;AAWK,MAAM,aAAa,GAAG,GAA2B,EAAE;IACxD,OAAO,qBAAc,CAAC,MAAM,CAAC;AAC/B,CAAC,CAAA,CAAC;AAFW,QAAA,aAAa,iBAExB"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/ethereum_init.d.ts

@@ -0,0 +1,34 @@
+import type { ProviderInfo, EthereumWalletClient } from './client.js';
+export interface EthereumIntegrationType {
+    initialized: boolean;
+    walletClient: EthereumWalletClient;
+    serviceProviderInfo: ProviderInfo[];
+    walletProviderInfo: ProviderInfo[];
+    [key: string]: unknown;
+}
+export interface INTEGRATIONS {
+    ethereum: EthereumIntegrationType;
+    [key: string]: unknown;
+}
+declare class EthereumInitializationService {
+    private integrations;
+    private logDebug;
+    private initialized;
+    private ethereumIntegration;
+    constructor(integrations: INTEGRATIONS, logDebug: (message: string) => void);
+    initialize(): Promise<EthereumIntegrationType>;
+    private validateAPIKeys;
+    private processResults;
+    private handleError;
+    private testProvider;
+    private testApiKey;
+    private getCleanErrorMessage;
+    private maskKey;
+    private warnAboutLegacyKeys;
+    private getPrivateProviders;
+    private getWalletTokenApiKeyTestInfo;
+    private handleMoralisResponse;
+    private handleEtherscanResponse;
+    private getErrorMessage;
+}
+export default EthereumInitializationService;