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

package/dist/cjs/src/ethereum_init.js

@@ -0,0 +1,359 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ethers_1 = require("ethers");
+const client_1 = require("./client");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+// Helper function to wrap promises around provider tests
+const wrapPromise = (promise) => promise.then((result) => result, (error) => error);
+class EthereumInitializationService {
+    constructor(integrations, logDebug) {
+        this.integrations = integrations;
+        this.logDebug = logDebug;
+        this.initialized = false;
+        // Helper function to extract clean error messages from API key tests
+        this.getCleanErrorMessage = (error) => {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Extract just the essential error information
+            if (errorMessage.includes('401')) {
+                return 'Authentication failed - invalid API key';
+            }
+            else if (errorMessage.includes('403')) {
+                return 'Access forbidden - check API key permissions';
+            }
+            else if (errorMessage.includes('429') || errorMessage.includes('rate limit')) {
+                return 'Rate limit exceeded - try again later';
+            }
+            else if (errorMessage.includes('network') || errorMessage.includes('connection')) {
+                return 'Network connection error';
+            }
+            else if (errorMessage.includes('timeout')) {
+                return 'Request timed out';
+            }
+            else {
+                // For other errors, take just the first meaningful part
+                const firstLine = errorMessage.split('\n')[0];
+                // Remove verbose details and keep just the core message
+                if (firstLine.includes('server response')) {
+                    const match = firstLine.match(/server response (\d+)/);
+                    if (match) {
+                        return `Server error ${match[1]}`;
+                    }
+                }
+                return firstLine;
+            }
+        };
+        // Define handlers to validate response from Wallet API requests
+        // Use arrow functions to bind 'this' to the class instance
+        this.handleMoralisResponse = (response) => __awaiter(this, void 0, void 0, function* () {
+            if (!response.ok) {
+                throw new Error(`Moralis API error: ${response.status} ${response.statusText}`);
+            }
+            this.logDebug('Moralis API key test: SUCCESS');
+            return { type: 'API Provider', name: 'Moralis', status: 'SUCCESS', apiKey: process.env.MORALIS_API_KEY };
+        });
+        this.handleEtherscanResponse = (response) => __awaiter(this, void 0, void 0, function* () {
+            const data = yield response.json();
+            if (data.status === '0' && data.message === 'NOTOK') {
+                throw new Error(`Etherscan API error: ${data.result}`);
+            }
+            console.log('[DEBUG_ETHEREUM] Etherscan API key test: SUCCESS');
+            return {
+                type: 'API Provider',
+                name: 'Etherscan',
+                status: 'SUCCESS',
+                apiKey: process.env.ETHERSCAN_API_KEY,
+            };
+        });
+        this.logDebug = logDebug.bind(this);
+        this.handleError = this.handleError.bind(this);
+        // TODO: this could us a little more error handling
+        integrations.ethereum.initialized = false;
+        this.ethereumIntegration = integrations.ethereum;
+    }
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.initialized) {
+                return this.ethereumIntegration;
+            }
+            try {
+                yield this.validateAPIKeys();
+                if (this.ethereumIntegration.serviceProviderInfo.length > 0) {
+                    // Yay, we got a valid Service Provider Key!
+                    this.ethereumIntegration.walletClient = (0, client_1.createEthereumWalletClient)(this.ethereumIntegration.serviceProviderInfo, this.ethereumIntegration.walletProviderInfo);
+                    this.logDebug('Ethereum initialized with supplied provider(s)');
+                }
+                else {
+                    this.ethereumIntegration.walletClient = (0, client_1.createEthereumWalletClient)();
+                    this.logDebug('Ethereum initialized with public provider(s)');
+                }
+                this.initialized = true;
+                this.ethereumIntegration.initialized = true;
+            }
+            catch (error) {
+                const errorMessage = this.getErrorMessage(error);
+                console.error(`Unexpected error in Ethereum initialization: ${errorMessage}`);
+                throw new Error(errorMessage);
+            }
+            return this.ethereumIntegration;
+        });
+    }
+    validateAPIKeys() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                this.warnAboutLegacyKeys();
+                this.logDebug('Starting background testing of private providers and API keys');
+                // This is a well known test Ethereum wallet address
+                const testAddress = '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2';
+                const missingKeyResults = [];
+                let wrappedProviderPromises = [];
+                // Prepare private provider tests
+                const privateProviders = this.getPrivateProviders();
+                if (privateProviders.length === 0) {
+                    this.logDebug('No Ethereum service provider keys (ALCHEMY_API_KEY or INFURA_API_KEY) are set.');
+                    missingKeyResults.push({
+                        type: 'Service Provider',
+                        name: 'Ethereum Service Providers',
+                        status: 'FAILED',
+                        error: 'Missing required Ethereum service provider keys (ALCHEMY_API_KEY or INFURA_API_KEY)',
+                    });
+                }
+                else {
+                    wrappedProviderPromises = privateProviders.map((provider) => wrapPromise(this.testProvider(provider, testAddress)));
+                }
+                //Prepare API Key Tests
+                let wrappedApiKeyPromises = [];
+                const apiKeys = this.getWalletTokenApiKeyTestInfo(testAddress);
+                if (apiKeys.length === 0) {
+                    missingKeyResults.push({
+                        type: 'API Provider',
+                        name: 'API Keys',
+                        status: 'FAILED',
+                        error: 'Missing required wallet token API keys (ETHERSCAN_API_KEY or MORALIS_API_KEY)',
+                    });
+                }
+                else {
+                    wrappedApiKeyPromises = apiKeys.map((apiKeyTestInfo) => wrapPromise(this.testApiKey(apiKeyTestInfo)));
+                }
+                // Wrap any existing results in a promise
+                const missingKeyResultsPromise = Promise.resolve(missingKeyResults);
+                // Run all tests in parallel, including the results
+                const allResults = yield Promise.all([
+                    ...(yield missingKeyResultsPromise),
+                    ...wrappedProviderPromises,
+                    ...wrappedApiKeyPromises,
+                ]);
+                this.processResults(allResults);
+            }
+            catch (error) {
+                const errorMessage = this.getErrorMessage(error);
+                console.error(`Unexpected error in Ethereum initialization: ${errorMessage}`);
+                throw new Error(errorMessage);
+            }
+        });
+    }
+    processResults(allResults) {
+        // Process Provider results
+        const successfulProviders = allResults.filter((result) => result.status === 'SUCCESS' && result.type === 'Service Provider');
+        const failedProviders = allResults.filter((result) => result.status === 'FAILED');
+        if (successfulProviders.length > 0) {
+            this.ethereumIntegration.serviceProviderInfo = successfulProviders;
+            if (failedProviders.length > 0) {
+                this.logDebug(`Secondary provider validation failed: ${failedProviders.map((p) => `${p.name}: ${p.error}`).join(', ')}`);
+                if (process.env.DEBUG_ETHEREUM_FAIL_ON_ERROR === 'true') {
+                    this.logDebug('DEBUG_ETHEREUM_FAIL_ON_ERROR is set to true. Exiting...');
+                    process.exit(1);
+                }
+                else {
+                    const primaryProvider = this.integrations.ethereum.serviceProviderInfo[0];
+                    this.logDebug(`Continuing with ${primaryProvider.name} as primary provider and no secondary provider.`);
+                }
+            }
+            // }
+        }
+        else {
+            if (failedProviders.length > 0) {
+                this.logDebug(`Provider validation failed: ${failedProviders.map((p) => `${p.name}: ${p.error}`).join(', ')}`);
+                if (process.env.DEBUG_ETHEREUM_FAIL_ON_ERROR === 'true') {
+                    this.logDebug('DEBUG_ETHEREUM_FAIL_ON_ERROR is set to true. Exiting...');
+                    process.exit(1);
+                }
+                else {
+                    console.log('[DEBUG_ETHEREUM] Will continue with the public provider. THIS IS NOT RECOMMENDED!');
+                }
+            }
+            // Return here since we won't bother with API key tests if the provider tests failed
+            return;
+        }
+        // Process API Key test results
+        const successfulApiKeys = allResults.filter((result) => result.status === 'SUCCESS' && result.type === 'API Provider');
+        const failedApiKeys = allResults.filter((result) => result.status === 'FAILED' && result.type === 'API Provider');
+        if (successfulApiKeys.length === 0) {
+            if (failedApiKeys.length === 0) {
+                this.logDebug('No ETHERSCAN or MORALIS wallet API keys were provided, or all API keys failed.');
+            }
+            else {
+                this.logDebug(`API key validation failed: ${failedApiKeys.map((p) => `${p.name}: ${p.error}`).join(', ')}`);
+            }
+            if (process.env.DEBUG_ETHEREUM_FAIL_ON_ERROR === 'true') {
+                this.logDebug('DEBUG_ETHEREUM_FAIL_ON_ERROR is set to true. Exiting...');
+                process.exit(1);
+            }
+            else {
+                this.logDebug('[DEBUG_ETHEREUM] Will continue without wallet API keys. THIS MAY LEAD TO ETHEREUM SERVICE PROVIDER RATE LIMITING!');
+            }
+        }
+        else {
+            this.ethereumIntegration.walletProviderInfo = successfulApiKeys;
+            if (failedApiKeys.length > 0) {
+                this.logDebug(`API key validation failed: ${failedApiKeys.map((p) => `${p.name}: ${p.error}`).join(', ')}`);
+                if (process.env.DEBUG_ETHEREUM_FAIL_ON_ERROR === 'true') {
+                    console.error('DEBUG_ETHEREUM_FAIL_ON_ERROR is set to true. Exiting...');
+                    process.exit(1);
+                }
+                else {
+                    this.logDebug(`Will continue using the single ${successfulApiKeys[0].name} API key with no secondary API key.`);
+                }
+            }
+        }
+    }
+    // Add a utility function for error handling
+    handleError(providerName, error, type) {
+        const errorMessage = this.getCleanErrorMessage(error);
+        this.logDebug(`${providerName} test: FAILED - ${errorMessage}`);
+        return {
+            type,
+            name: providerName,
+            status: 'FAILED',
+            error: errorMessage,
+        };
+    }
+    // Check if the provider is valid and create a wallet client if it is
+    testProvider(providerInfo, testAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const balance = yield providerInfo.provider.getBalance(testAddress);
+                const network = yield providerInfo.provider.getNetwork();
+                this.logDebug(`${providerInfo.name} API key test: SUCCESS - Network: ${network.name}, Test Balance returned.`);
+                return {
+                    type: 'Service Provider',
+                    provider: providerInfo.provider,
+                    name: providerInfo.name,
+                    status: 'SUCCESS',
+                    network: network.name,
+                    balance: balance.toString(),
+                    apiKey: providerInfo.apiKey,
+                };
+            }
+            catch (error) {
+                return this.handleError(providerInfo.name, error, 'Service Provider');
+            }
+        });
+    }
+    // Check if a wallet token API key is valid
+    testApiKey(apiKeyTestInfo) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let response;
+                if (apiKeyTestInfo.headers) {
+                    response = yield (0, node_fetch_1.default)(apiKeyTestInfo.url, {
+                        headers: apiKeyTestInfo.headers,
+                    });
+                }
+                else {
+                    response = yield (0, node_fetch_1.default)(apiKeyTestInfo.url);
+                }
+                return yield apiKeyTestInfo.responseHandler(response);
+            }
+            catch (error) {
+                return this.handleError(apiKeyTestInfo.provider, error, 'API Provider');
+            }
+        });
+    }
+    // Helper to display masked API Keys in debug messages
+    maskKey(key) {
+        if (!key)
+            return 'undefined';
+        if (key.length <= 8)
+            return '*'.repeat(key.length);
+        return key.substring(0, 4) + '*'.repeat(key.length - 8) + key.substring(key.length - 4);
+    }
+    warnAboutLegacyKeys() {
+        if (process.env.DEBUG_ETHEREUM) {
+            if (process.env.INFURA_PROJECT_ID || process.env.INFURA_PROJECT_SECRET) {
+                this.logDebug('[DEBUG_ETHEREUM] Found an Infura API Project ID and/or Secret. Replace this with INFURA_API_KEY.');
+                if (process.env.DEBUG_ETHEREUM_FAIL_ON_ERROR === 'true') {
+                    this.logDebug('Remove unused INFURA_PROJECT_ID and INFURA_PROJECT_SECRET from your environment variables.');
+                    this.logDebug('DEBUG_ETHEREUM_FAIL_ON_ERROR is set to true. Exiting...');
+                    process.exit(1);
+                }
+            }
+            if (process.env.POCKET_API_KEY) {
+                this.logDebug('[DEBUG_ETHEREUM] Found a Pocket API key. Pocket is no longer recommended as a service node.');
+                if (process.env.DEBUG_ETHEREUM_FAIL_ON_ERROR === 'true') {
+                    this.logDebug('Remove unused POCKET_API_KEY from your environment variables.');
+                    this.logDebug('DEBUG_ETHEREUM_FAIL_ON_ERROR is set to true. Exiting...');
+                    process.exit(1);
+                }
+            }
+        }
+    }
+    // Helper to get the private providers from the environment variables
+    getPrivateProviders() {
+        const providers = [];
+        if (process.env.ALCHEMY_API_KEY) {
+            const alchemyProvider = new ethers_1.ethers.AlchemyProvider('mainnet', process.env.ALCHEMY_API_KEY);
+            providers.push({ name: 'Alchemy', provider: alchemyProvider, apiKey: process.env.ALCHEMY_API_KEY });
+            this.logDebug(`Found an Alchemy key (masked): ${this.maskKey(process.env.ALCHEMY_API_KEY)}`);
+        }
+        if (process.env.INFURA_API_KEY) {
+            const infuraProvider = new ethers_1.ethers.InfuraProvider('mainnet', process.env.INFURA_API_KEY);
+            providers.push({ name: 'Infura', provider: infuraProvider, apiKey: process.env.INFURA_API_KEY });
+            this.logDebug(`Found an Infura key (masked): ${this.maskKey(process.env.INFURA_API_KEY)}`);
+        }
+        return providers;
+    }
+    // Helper to get the array of wallet token API key tests
+    getWalletTokenApiKeyTestInfo(testAddress) {
+        const apiKeyTestInfo = [];
+        if (process.env.ETHERSCAN_API_KEY || process.env.MORALIS_API_KEY) {
+            if (process.env.MORALIS_API_KEY && process.env.DEBUG_ETHEREUM) {
+                this.logDebug(`Found a Moralis key (masked): ${this.maskKey(process.env.MORALIS_API_KEY)}`);
+                apiKeyTestInfo.push({
+                    provider: 'Moralis',
+                    url: `https://deep-index.moralis.io/api/v2/${testAddress}/balance`,
+                    headers: { 'X-API-Key': process.env.MORALIS_API_KEY },
+                    responseHandler: this.handleMoralisResponse,
+                });
+            }
+            if (process.env.ETHERSCAN_API_KEY && process.env.DEBUG_ETHEREUM) {
+                this.logDebug(`Found an Etherscan key (masked): ${this.maskKey(process.env.ETHERSCAN_API_KEY)}`);
+                apiKeyTestInfo.push({
+                    provider: 'Etherscan',
+                    url: `https://api.etherscan.io/api?module=account&action=balance&address=${testAddress}&tag=latest&apikey=${process.env.ETHERSCAN_API_KEY}`,
+                    responseHandler: this.handleEtherscanResponse,
+                });
+            }
+        }
+        return apiKeyTestInfo;
+    }
+    getErrorMessage(error) {
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return String(error);
+    }
+}
+exports.default = EthereumInitializationService;
+//# sourceMappingURL=ethereum_init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ethereum_init.js","sourceRoot":"","sources":["../../../src/ethereum_init.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,8 @@
 import type { LunchMoneyCryptoConnection, LunchMoneyCryptoConnectionContext, LunchMoneyCryptoConnectionConfig } from './types.js';
 import { EthereumWalletClient } from './client.js';
+import EthereumInitializationService, { EthereumIntegrationType } from './ethereum_init.js';
 export { createEthereumWalletClient } from './client.js';
+export { EthereumInitializationService, EthereumIntegrationType };
 interface LunchMoneyEthereumWalletConnectionConfig extends LunchMoneyCryptoConnectionConfig {
     /** The unique ID of the user's wallet address on the blockchain. */
     walletAddress: string;

package/dist/cjs/src/main.js

@@ -1,27 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -31,24 +8,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LunchMoneyEthereumWalletConnection = exports.createEthereumWalletClient = void 0;
-const client_js_1 = require("./client.js");
-const ethers = __importStar(require("ethers"));
-var client_js_2 = require("./client.js");
-Object.defineProperty(exports, "createEthereumWalletClient", { enumerable: true, get: function () { return client_js_2.createEthereumWalletClient; } });
+exports.LunchMoneyEthereumWalletConnection = exports.EthereumInitializationService = exports.createEthereumWalletClient = void 0;
+const ethereum_init_js_1 = __importDefault(require("./ethereum_init.js"));
+exports.EthereumInitializationService = ethereum_init_js_1.default;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "createEthereumWalletClient", { enumerable: true, get: function () { return client_js_1.createEthereumWalletClient; } });
 /** The minimum balance (in wei) that a token should have in order to be
  * considered for returning as a balance. */
 const NEGLIGIBLE_BALANCE_THRESHOLD = 1000;
-/**
- * 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.LunchMoneyEthereumWalletConnection = {
     initiate(config, context) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -57,63 +28,7 @@ exports.LunchMoneyEthereumWalletConnection = {
     },
     getBalances({ walletAddress, negligibleBalanceThreshold = NEGLIGIBLE_BALANCE_THRESHOLD }, { client }) {
         return __awaiter(this, void 0, void 0, function* () {
-            const obscuredWalletAddress = `0x..${walletAddress.slice(-6)}`;
-            debug('getBalances called for wallet address:', obscuredWalletAddress);
-            // Create a timeout so we fail instead of generating a CORS errors
-            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);
-            });
-            // Wrap all ethers calls in a single timeout
-            const result = yield Promise.race([
-                (() => __awaiter(this, void 0, void 0, function* () {
-                    try {
-                        const weiBalance = yield client.getWeiBalance(walletAddress);
-                        // Filter out tokens that are not on mainnet
-                        const chainId = yield client.getChainId();
-                        const chainFilteredTokensList = (yield (0, client_js_1.loadTokenList)()).filter((t) => BigInt(t.chainId) === BigInt(chainId));
-                        const map = yield client.getTokensBalance(walletAddress, chainFilteredTokensList.map((t) => t.address));
-                        return { weiBalance, chainId, map, chainFilteredTokensList };
-                    }
-                    finally {
-                        // Clear the timeout when the operation completes (success or failure)
-                        if (timeoutId) {
-                            clearTimeout(timeoutId);
-                        }
-                    }
-                }))(),
-                timeout,
-            ]);
-            const { weiBalance, chainId, map, chainFilteredTokensList } = result;
-            debug('ethers.getTokensBalance returned for wallet address:', obscuredWalletAddress);
-            const balances = Object.entries(map)
-                .map(([address, balance]) => {
-                const token = chainFilteredTokensList.find((t) => t.address === address);
-                if (!token) {
-                    throw new Error(`Token ${address} not found in filtered 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.formatUnits(undivisedAmount, decimals) }))
-                // Normalize the amount to 18 decimal places (for the wei per eth standard) for filtering out negligible balances
-                .filter((b) => ethers.parseUnits(b.amount, 18) > negligibleBalanceThreshold)
-                .map((b) => ({ asset: b.asset, amount: String(b.amount) }))
-                .sort((a, b) => a.asset.localeCompare(b.asset));
-            debug(`Returning from getBalances for ${obscuredWalletAddress}:`, balances);
-            return {
-                providerName: 'wallet_ethereum',
-                balances,
-            };
+            return client.getBalances(walletAddress, negligibleBalanceThreshold);
         });
     },
 };

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

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/main.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,2CAAkE;AAClE,+CAAiC;AAEjC,yCAAyD;AAAhD,uHAAA,0BAA0B,OAAA;AAEnC;4CAC4C;AAC5C,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,KAAK,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,qBAAqB,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;KACzD;AACH,CAAC,CAAC;AAYW,QAAA,kCAAkC,GAG3C;IACI,QAAQ,CAAC,MAAM,EAAE,OAAO;;YAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;KAAA;IAEK,WAAW,CAAC,EAAE,aAAa,EAAE,0BAA0B,GAAG,4BAA4B,EAAE,EAAE,EAAE,MAAM,EAAE;;YACxG,MAAM,qBAAqB,GAAG,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,wCAAwC,EAAE,qBAAqB,CAAC,CAAC;YAEvE,kEAAkE;YAClE,IAAI,SAAqC,CAAC;YAC1C,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B;gBAChE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;gBACtD,CAAC,CAAC,KAAK,CAAC;YACV,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC/C,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,eAAe,gBAAgB,CAAC,CAAC,CAAC;gBACvG,CAAC,EAAE,eAAe,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YAEH,4CAA4C;YAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,CAAC,GAAS,EAAE;oBACV,IAAI;wBACF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;wBAE7D,4CAA4C;wBAC5C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;wBAE1C,MAAM,uBAAuB,GAAG,CAAC,MAAM,IAAA,yBAAa,GAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;wBAE7G,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CACvC,aAAa,EACb,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAC9C,CAAC;wBAEF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,uBAAuB,EAAE,CAAC;qBAC9D;4BAAS;wBACR,sEAAsE;wBACtE,IAAI,SAAS,EAAE;4BACb,YAAY,CAAC,SAAS,CAAC,CAAC;yBACzB;qBACF;gBACH,CAAC,CAAA,CAAC,EAAE;gBACJ,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,uBAAuB,EAAE,GAAG,MAAM,CAAC;YACrE,KAAK,CAAC,sDAAsD,EAAE,qBAAqB,CAAC,CAAC;YAErF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;iBACjC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC1B,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;gBAEzE,IAAI,CAAC,KAAK,EAAE;oBACV,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,iDAAiD,OAAO,EAAE,CAAC,CAAC;iBAC7F;gBAED,OAAO;oBACL,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,eAAe,EAAE,OAAO;oBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC;YACJ,CAAC,CAAC;iBACD,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;iBACnE,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAClH,iHAAiH;iBAChH,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,0BAA0B,CAAC;iBAC3E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;iBAC1D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAElD,KAAK,CAAC,kCAAkC,qBAAqB,GAAG,EAAE,QAAQ,CAAC,CAAC;YAE5E,OAAO;gBACL,YAAY,EAAE,iBAAiB;gBAC/B,QAAQ;aACT,CAAC;QACJ,CAAC;KAAA;CACF,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/main.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAOA,0EAA4F;AAGnF,wCAHF,0BAA6B,CAGE;AADtC,yCAAyD;AAAhD,uHAAA,0BAA0B,OAAA;AAGnC;4CAC4C;AAC5C,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAY7B,QAAA,kCAAkC,GAG3C;IACI,QAAQ,CAAC,MAAM,EAAE,OAAO;;YAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;KAAA;IAEK,WAAW,CAAC,EAAE,aAAa,EAAE,0BAA0B,GAAG,4BAA4B,EAAE,EAAE,EAAE,MAAM,EAAE;;YACxG,OAAO,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;QACvE,CAAC;KAAA;CACF,CAAC"}

package/dist/mjs/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;