@metamask-previews/assets-controller 0.0.0-preview-903db2da → 0.0.0-preview-ab102d86

package/CHANGELOG.md

@@ -10,5 +10,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Initial release ([#7587](https://github.com/MetaMask/core/pull/7587))
+- Add `MulticallClient` for batching RPC calls using Multicall3 contract ([#7677](https://github.com/MetaMask/core/pull/7677))
+- Add batch utilities (`divideIntoBatches`, `reduceInBatchesSerially`) for processing arrays in batches ([#7677](https://github.com/MetaMask/core/pull/7677))
+- Add `TokenDetector` service for detecting ERC-20 tokens with non-zero balances on a chain ([#7683](https://github.com/MetaMask/core/pull/7683))
+- Add `BalanceFetcher` service for fetching token balances for user's imported/detected tokens ([#7684](https://github.com/MetaMask/core/pull/7684))
+- Add `viem` dependency for ABI encoding/decoding in MulticallClient
+
+### Changed
+
+- Refactor `MulticallClient` to use viem for ABI encoding/decoding instead of manual implementation
 
 [Unreleased]: https://github.com/MetaMask/core/

package/dist/data-sources/rpc-datasource/clients/MulticallClient.cjs

@@ -0,0 +1,638 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _MulticallClient_instances, _MulticallClient_getProvider, _MulticallClient_config, _MulticallClient_multicallBatchBalanceOf, _MulticallClient_fallbackBatchBalanceOf, _MulticallClient_fetchSingleBalance;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MulticallClient = exports.decodeAggregate3Response = exports.encodeAggregate3 = void 0;
+const viem_1 = require("viem");
+const utils_1 = require("../utils/index.cjs");
+// =============================================================================
+// ABI DEFINITIONS
+// =============================================================================
+/**
+ * Multicall3 contract ABI (subset for aggregate3 and getEthBalance).
+ *
+ * @see https://github.com/mds1/multicall
+ */
+const MULTICALL3_ABI = [
+    {
+        name: 'aggregate3',
+        type: 'function',
+        stateMutability: 'payable',
+        inputs: [
+            {
+                name: 'calls',
+                type: 'tuple[]',
+                components: [
+                    { name: 'target', type: 'address' },
+                    { name: 'allowFailure', type: 'bool' },
+                    { name: 'callData', type: 'bytes' },
+                ],
+            },
+        ],
+        outputs: [
+            {
+                name: 'returnData',
+                type: 'tuple[]',
+                components: [
+                    { name: 'success', type: 'bool' },
+                    { name: 'returnData', type: 'bytes' },
+                ],
+            },
+        ],
+    },
+    {
+        name: 'getEthBalance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'addr', type: 'address' }],
+        outputs: [{ name: 'balance', type: 'uint256' }],
+    },
+];
+/**
+ * ERC-20 ABI (subset for balanceOf).
+ */
+const ERC20_ABI = [
+    {
+        name: 'balanceOf',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ name: 'balance', type: 'uint256' }],
+    },
+];
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * Zero address constant for native token.
+ */
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/**
+ * Multicall3 contract addresses by chain ID.
+ * Source: https://github.com/mds1/multicall/blob/main/deployments.json
+ *
+ * TODO: try to find service to use here instead of hardcoding the addresses
+ */
+const MULTICALL3_ADDRESS_BY_CHAIN = {
+    '0x1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xaa36a7': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4268': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5e9': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1b6e6': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x18fc4a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x45': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1a4': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xaa37dc': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa4b1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa4ba': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x66eed': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x66eee': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x66eeb': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15f2249': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x89': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x13881': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x13882': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x44d': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x5a2': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x98a': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x64': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x27d8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa86a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa869': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xfa2': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xfa': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xfaf0': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x38': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x61': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15eb': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xcc': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x504': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x505': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x507': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2a15c308d': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x2a15c3083': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x63564c40': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x19': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x152': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5535072': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x6c1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x7a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x13': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x10': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x72': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x120': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4e454152': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x250': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5c2359': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xec0': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x42': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x80': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x440': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x257': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe9fe': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xd3a0': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x84444': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1e': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2329': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2328': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x6c': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x12': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa516': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5afe': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa4ec': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xaef3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x116ea': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x116e9': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2019': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3e9': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x7d1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x141': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x6a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x28': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4d2': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1e14': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1e15': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1251': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x7f08': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8ae': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x138b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1389': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1388': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1f92': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x14a33': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x14a34': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2105': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x936': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xff': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x46a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x46b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x14f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xd2af': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe9ac0ce': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe705': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0xe704': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe708': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2b6f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x39': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x23a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1644': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xdea8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3af': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x171': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3e7': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x76adf1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3b9ac9ff': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2c': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x2e': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x15b3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x82751': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8274f': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x82750': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x96f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3cc5': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4571': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe99': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x7d0': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1297': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1d5e': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3a14269b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x561bf78b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x235ddd0': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3cd156dc': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5d456c62': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x79f99296': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x585eb4b1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x507aaa2a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1fc3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x32d': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8a73': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8a72': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8a71': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe9ac0d6': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x1069': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x7e5': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x53': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x52': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0xe298': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1a8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x94': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2c6': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2803': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2802': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa9': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x28c5f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x28c60': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x13a': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4cb2f': '0xdbfa261cd7d17bb40479a0493ad6c0fee435859e',
+    '0x7f93': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xb660': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xb02113d3f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xdad': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xdae': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15b38': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15b32': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x45c': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x45b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3d': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x41a6ace': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa729': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1f47b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1b59': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x1b58': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xc3': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x16fd8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xc7': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x405': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x334': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1ce': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x1cf': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0xa70e': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x868b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa0c71fd': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x13e31': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa1337': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1f2b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xf63': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x144': '0xF9cda624FBC7e059355ce98a31693d299FACd963',
+    '0x118': '0xF9cda624FBC7e059355ce98a31693d299FACd963',
+    '0x12c': '0xF9cda624FBC7e059355ce98a31693d299FACd963',
+    '0x18995f': '0xF9cda624FBC7e059355ce98a31693d299FACd963',
+    '0x2b74': '0xF9cda624FBC7e059355ce98a31693d299FACd963',
+    '0xfc': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x9da': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x137': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x13ed': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x24b1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xba9302': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x7c8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x138d5': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x6d': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x343b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x34a1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x3109': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x91b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa96': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x22c3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2be3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xbf03': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1b254': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa7b14': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2276': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1b9e': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x6a63bb8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15af3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15af1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xae3f3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x531': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x28c61': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x28c58': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x1d88': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x5b9b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4c7e1': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa53b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1a2b': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x406': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x2cef': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x18b2': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x182a9': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xc4': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xfdd': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xfde': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x99c0a0f': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x22cf': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x310c5': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x46f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x659': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x139c968f9': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xed88': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xd036': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1f3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x31bf8c3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x1cbc67bfdc': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x98967f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x4f588': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x16db': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x3a': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x59': '0xca11bde05977b3631167028862be2a173976ca11',
+    '0x1e0': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2eb': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x221': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x6f0': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa867': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2611': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xa6': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x15f900': '0x6B5eFbC0C82eBb26CA13a4F11836f36Fc6fdBC5D',
+    '0x74c': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x407b': '0x90a2377F233E3461BACa6080d4837837d8762927',
+    '0xa3c3': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xab5': '0xF9cda624FBC7e059355ce98a31693d299FACd963',
+    '0x138de': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x18c6': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8173': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x2ba': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x279f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xb67d2': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0xe8': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x18232': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x8f': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x32': '0x0B1795ccA8E4eC4df02346a082df54D437F8D9aF',
+    '0x18c7': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x10e6': '0xcA11bde05977b3631167028862bE2a173976CA11',
+    '0x10b3e': '0x99423C88EB5723A590b4C644426069042f137B9e',
+};
+// =============================================================================
+// ENCODING/DECODING UTILITIES (using viem)
+// =============================================================================
+/**
+ * Encode a balanceOf call for an ERC-20 token.
+ *
+ * @param accountAddress - The account address.
+ * @returns The encoded call data.
+ */
+function encodeBalanceOf(accountAddress) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: ERC20_ABI,
+        functionName: 'balanceOf',
+        args: [accountAddress],
+    });
+}
+/**
+ * Encode a getEthBalance call for native token via Multicall3.
+ *
+ * @param accountAddress - The account address.
+ * @returns The encoded call data.
+ */
+function encodeGetEthBalance(accountAddress) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: MULTICALL3_ABI,
+        functionName: 'getEthBalance',
+        args: [accountAddress],
+    });
+}
+/**
+ * Encode a Multicall3 aggregate3 call.
+ *
+ * @param calls - Array of calls with target, allowFailure, and callData.
+ * @returns The encoded aggregate3 call data.
+ */
+function encodeAggregate3(calls) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: MULTICALL3_ABI,
+        functionName: 'aggregate3',
+        args: [
+            calls.map((call) => ({
+                target: call.target,
+                allowFailure: call.allowFailure,
+                callData: call.callData,
+            })),
+        ],
+    });
+}
+exports.encodeAggregate3 = encodeAggregate3;
+/**
+ * Decode the response from aggregate3.
+ * Returns array of (success, returnData) tuples.
+ *
+ * @param data - The raw response data.
+ * @param callCount - Number of calls made (used for validation).
+ * @returns Array of success and return data.
+ */
+function decodeAggregate3Response(data, callCount) {
+    const decoded = (0, viem_1.decodeFunctionResult)({
+        abi: MULTICALL3_ABI,
+        functionName: 'aggregate3',
+        data,
+    });
+    // decoded is an array of { success: boolean, returnData: `0x${string}` }
+    const results = decoded;
+    if (results.length !== callCount) {
+        throw new Error(`Expected ${callCount} results, got ${results.length}`);
+    }
+    return results.map((result) => ({
+        success: result.success,
+        returnData: result.returnData,
+    }));
+}
+exports.decodeAggregate3Response = decodeAggregate3Response;
+/**
+ * Decode a uint256 balance from return data.
+ *
+ * @param data - The hex return data.
+ * @returns The decoded balance as a string.
+ */
+function decodeUint256(data) {
+    const hexData = data.slice(2);
+    if (hexData.length === 0) {
+        return '0';
+    }
+    // Take first 64 chars (32 bytes) for uint256
+    const normalizedHex = hexData.length > 64 ? hexData.slice(0, 64) : hexData;
+    return BigInt(`0x${normalizedHex}`).toString();
+}
+/**
+ * Client for batching RPC calls using Multicall3.
+ * Falls back to individual calls on chains without Multicall3 support.
+ */
+class MulticallClient {
+    constructor(getProvider, config) {
+        _MulticallClient_instances.add(this);
+        _MulticallClient_getProvider.set(this, void 0);
+        _MulticallClient_config.set(this, void 0);
+        __classPrivateFieldSet(this, _MulticallClient_getProvider, getProvider, "f");
+        // Use default values for invalid (non-positive) batch sizes to prevent
+        // infinite loops or errors in divideIntoBatches
+        const maxCallsPerBatch = config?.maxCallsPerBatch !== undefined && config.maxCallsPerBatch > 0
+            ? config.maxCallsPerBatch
+            : 300;
+        const timeoutMs = config?.timeoutMs !== undefined && config.timeoutMs > 0
+            ? config.timeoutMs
+            : 30000;
+        __classPrivateFieldSet(this, _MulticallClient_config, {
+            maxCallsPerBatch,
+            timeoutMs,
+        }, "f");
+    }
+    /**
+     * Fetch ERC-20 and native token balances using Multicall3.
+     * Falls back to individual RPC calls on unsupported chains.
+     *
+     * @param chainId - The chain ID.
+     * @param requests - Array of balance requests.
+     * @returns Array of balance responses.
+     */
+    async batchBalanceOf(chainId, requests) {
+        if (requests.length === 0) {
+            return [];
+        }
+        const multicallAddress = MULTICALL3_ADDRESS_BY_CHAIN[chainId];
+        const provider = __classPrivateFieldGet(this, _MulticallClient_getProvider, "f").call(this, chainId);
+        // If Multicall3 is not supported, fall back to individual calls
+        if (!multicallAddress) {
+            return __classPrivateFieldGet(this, _MulticallClient_instances, "m", _MulticallClient_fallbackBatchBalanceOf).call(this, provider, requests);
+        }
+        // Use Multicall3
+        return __classPrivateFieldGet(this, _MulticallClient_instances, "m", _MulticallClient_multicallBatchBalanceOf).call(this, provider, multicallAddress, requests);
+    }
+}
+exports.MulticallClient = MulticallClient;
+_MulticallClient_getProvider = new WeakMap(), _MulticallClient_config = new WeakMap(), _MulticallClient_instances = new WeakSet(), _MulticallClient_multicallBatchBalanceOf = 
+/**
+ * Fetch balances using Multicall3 aggregate3.
+ *
+ * @param provider - The RPC provider.
+ * @param multicallAddress - The Multicall3 contract address.
+ * @param requests - Array of balance requests.
+ * @returns Array of balance responses.
+ */
+async function _MulticallClient_multicallBatchBalanceOf(provider, multicallAddress, requests) {
+    const batchSize = __classPrivateFieldGet(this, _MulticallClient_config, "f").maxCallsPerBatch;
+    const responses = await (0, utils_1.reduceInBatchesSerially)({
+        values: requests,
+        batchSize,
+        initialResult: [],
+        eachBatch: async (workingResult, batch) => {
+            try {
+                // Build aggregate3 calls
+                const calls = batch.map((req) => {
+                    const isNative = req.tokenAddress === ZERO_ADDRESS;
+                    const target = isNative ? multicallAddress : req.tokenAddress;
+                    return {
+                        target,
+                        allowFailure: true,
+                        callData: isNative
+                            ? encodeGetEthBalance(req.accountAddress)
+                            : encodeBalanceOf(req.accountAddress),
+                    };
+                });
+                // Encode and send aggregate3 call
+                const callData = encodeAggregate3(calls);
+                const result = await provider.call({
+                    to: multicallAddress,
+                    data: callData,
+                });
+                // Decode response
+                const decoded = decodeAggregate3Response(result, batch.length);
+                // Map results back to responses
+                for (let i = 0; i < batch.length; i++) {
+                    const { tokenAddress, accountAddress } = batch[i];
+                    const { success, returnData } = decoded[i];
+                    if (success && returnData && returnData.length > 2) {
+                        workingResult.push({
+                            tokenAddress,
+                            accountAddress,
+                            success: true,
+                            balance: decodeUint256(returnData),
+                        });
+                    }
+                    else {
+                        workingResult.push({
+                            tokenAddress,
+                            accountAddress,
+                            success: false,
+                        });
+                    }
+                }
+            }
+            catch {
+                // On aggregate3 error, fall back to individual calls for this batch.
+                // #fetchSingleBalance never rejects - it catches all errors internally
+                // and returns a failed response, so we use Promise.all here.
+                const fallbackResults = await Promise.all(batch.map((req) => __classPrivateFieldGet(this, _MulticallClient_instances, "m", _MulticallClient_fetchSingleBalance).call(this, provider, req)));
+                for (const result of fallbackResults) {
+                    workingResult.push(result);
+                }
+            }
+            return workingResult;
+        },
+    });
+    return responses;
+}, _MulticallClient_fallbackBatchBalanceOf = 
+/**
+ * Fallback: fetch balances using individual RPC calls.
+ *
+ * @param provider - The RPC provider.
+ * @param requests - Array of balance requests.
+ * @returns Array of balance responses.
+ */
+async function _MulticallClient_fallbackBatchBalanceOf(provider, requests) {
+    // Use smaller batch size for parallel individual calls to avoid overwhelming RPC
+    const batchSize = Math.min(__classPrivateFieldGet(this, _MulticallClient_config, "f").maxCallsPerBatch, 50);
+    const responses = await (0, utils_1.reduceInBatchesSerially)({
+        values: requests,
+        batchSize,
+        initialResult: [],
+        eachBatch: async (workingResult, batch) => {
+            // #fetchSingleBalance never rejects - it catches all errors internally
+            // and returns a failed response, so we use Promise.all here.
+            const batchResults = await Promise.all(batch.map((req) => __classPrivateFieldGet(this, _MulticallClient_instances, "m", _MulticallClient_fetchSingleBalance).call(this, provider, req)));
+            for (const result of batchResults) {
+                workingResult.push(result);
+            }
+            return workingResult;
+        },
+    });
+    return responses;
+}, _MulticallClient_fetchSingleBalance = 
+/**
+ * Fetch a single token balance (fallback method).
+ *
+ * @param provider - The RPC provider.
+ * @param request - The balance request.
+ * @returns The balance response.
+ */
+async function _MulticallClient_fetchSingleBalance(provider, request) {
+    // Destructure inside try block to ensure any errors are caught
+    // and don't cause promise rejections that bypass error handling
+    try {
+        const { tokenAddress, accountAddress } = request;
+        // Native token (zero address)
+        if (tokenAddress === ZERO_ADDRESS) {
+            const balance = await provider.getBalance(accountAddress);
+            return {
+                tokenAddress,
+                accountAddress,
+                success: true,
+                balance: balance.toString(),
+            };
+        }
+        // ERC-20 token
+        const callData = encodeBalanceOf(accountAddress);
+        const result = await provider.call({
+            to: tokenAddress,
+            data: callData,
+        });
+        const balance = decodeUint256(result);
+        return {
+            tokenAddress,
+            accountAddress,
+            success: true,
+            balance,
+        };
+    }
+    catch {
+        return {
+            tokenAddress: request.tokenAddress,
+            accountAddress: request.accountAddress,
+            success: false,
+        };
+    }
+};
+//# sourceMappingURL=MulticallClient.cjs.map