@talismn/balances 0.0.0-pr2075-20250707160526 → 0.0.0-pr2075-20250708125508

package/dist/talismn-balances.cjs.prod.js

@@ -288,11 +288,10 @@ class Balances {
 }
 const getBalanceId = balance => {
   const {
-    source,
     address,
     tokenId
   } = balance;
-  return [source, address, tokenId].join("::");
+  return [address, tokenId].join("::");
 };
 
 /**
@@ -1551,16 +1550,16 @@ const getBalanceDefs = addressesByToken => {
 
 const fetchBalances$c = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
   const client = await connector.getPublicClientForEvmNetwork(networkId);
   if (!client) throw new Error(`Could not get rpc provider for evm network ${networkId}`);
-  for (const [token, addresses] of addressesByToken) {
+  for (const [token, addresses] of tokensWithAddresses) {
     if (token.type !== MODULE_TYPE$8 || token.networkId !== networkId) throw new Error(`Invalid token type or networkId for EVM ERC20 balance module: ${token.type} on ${token.networkId}`);
     for (const address of addresses) if (!util.isEthereumAddress(address)) throw new Error(`Invalid ethereum address for EVM ERC20 balance module: ${address} for token ${token.id}`);
   }
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (client.chain?.contracts?.erc20Aggregator && balanceDefs.length > 1) {
     const erc20Aggregator = client.chain.contracts.erc20Aggregator;
     return fetchWithAggregator$1(client, balanceDefs, erc20Aggregator.address);
@@ -1780,10 +1779,10 @@ const getTransferCallData$8 = ({
   };
 };
 
-const SUBSCRIPTION_INTERVAL$8 = 6_000;
+const SUBSCRIPTION_INTERVAL$7 = 6_000;
 const subscribeBalances$8 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
   return new rxjs.Observable(subscriber => {
@@ -1793,17 +1792,17 @@ const subscribeBalances$8 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$c({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector
         });
         if (abortController.signal.aborted) return;
         subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$8);
+        setTimeout(poll, SUBSCRIPTION_INTERVAL$7);
       } catch (error) {
         log.error("Error", {
           module: MODULE_TYPE$8,
           networkId,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -1841,16 +1840,16 @@ const PLATFORM$7 = chaindataProvider.EvmNativeTokenSchema.shape.platform.value;
 
 const fetchBalances$b = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
   const client = await connector.getPublicClientForEvmNetwork(networkId);
   if (!client) throw new Error(`Could not get rpc provider for evm network ${networkId}`);
-  for (const [token, addresses] of addressesByToken) {
+  for (const [token, addresses] of tokensWithAddresses) {
     if (token.type !== MODULE_TYPE$7 || token.networkId !== networkId) throw new Error(`Invalid token type or networkId for EVM ERC20 balance module: ${token.type} on ${token.networkId}`);
     for (const address of addresses) if (!util.isEthereumAddress(address)) throw new Error(`Invalid ethereum address for EVM ERC20 balance module: ${address} for token ${token.id}`);
   }
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (client.chain?.contracts?.multicall3 && balanceDefs.length > 1) {
     const multicall3 = client.chain.contracts.multicall3;
     return fetchWithMulticall(client, balanceDefs, multicall3.address);
@@ -1994,10 +1993,10 @@ const getTransferCallData$7 = ({
   };
 };
 
-const SUBSCRIPTION_INTERVAL$7 = 6_000;
+const SUBSCRIPTION_INTERVAL$6 = 6_000;
 const subscribeBalances$7 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
   return new rxjs.Observable(subscriber => {
@@ -2007,17 +2006,17 @@ const subscribeBalances$7 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$b({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector
         });
         if (abortController.signal.aborted) return;
         subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$7);
+        setTimeout(poll, SUBSCRIPTION_INTERVAL$6);
       } catch (error) {
         log.error("Error", {
           module: MODULE_TYPE$7,
           networkId,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -2050,16 +2049,16 @@ const PLATFORM$6 = chaindataProvider.EvmUniswapV2TokenSchema.shape.platform.valu
 
 const fetchBalances$a = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
   const client = await connector.getPublicClientForEvmNetwork(networkId);
   if (!client) throw new Error(`Could not get rpc provider for evm network ${networkId}`);
-  for (const [token, addresses] of addressesByToken) {
+  for (const [token, addresses] of tokensWithAddresses) {
     if (token.type !== MODULE_TYPE$6 || token.networkId !== networkId) throw new Error(`Invalid token type or networkId for EVM ERC20 balance module: ${token.type} on ${token.networkId}`);
     for (const address of addresses) if (!util.isEthereumAddress(address)) throw new Error(`Invalid ethereum address for EVM ERC20 balance module: ${address} for token ${token.id}`);
   }
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (client.chain?.contracts?.erc20Aggregator && balanceDefs.length > 1) {
     const erc20Aggregator = client.chain.contracts.erc20Aggregator;
     return fetchWithAggregator(client, balanceDefs, erc20Aggregator.address);
@@ -2327,10 +2326,10 @@ const getTransferCallData$6 = ({
   };
 };
 
-const SUBSCRIPTION_INTERVAL$6 = 6_000;
+const SUBSCRIPTION_INTERVAL$5 = 6_000;
 const subscribeBalances$6 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
   return new rxjs.Observable(subscriber => {
@@ -2340,17 +2339,17 @@ const subscribeBalances$6 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$a({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector
         });
         if (abortController.signal.aborted) return;
         subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$6);
+        setTimeout(poll, SUBSCRIPTION_INTERVAL$5);
       } catch (error) {
         log.error("Error", {
           module: MODULE_TYPE$6,
           networkId,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -3472,13 +3471,13 @@ const decompress = data => {
 
 const fetchBalances$6 = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (!miniMetadata?.data) {
-    log.warn("MiniMetadata is required for fetching balances");
+    log.warn(`MiniMetadata is required for fetching ${MODULE_TYPE$5} balances on ${networkId}.`);
     return {
       success: [],
       errors: balanceDefs.map(def => ({
@@ -3848,10 +3847,10 @@ const getTransferAllEncodedArgs$2 = (assetId, to, codec) => {
   })]);
 };
 
-const SUBSCRIPTION_INTERVAL$5 = 6_000;
+const SUBSCRIPTION_INTERVAL$4 = 6_000;
 const subscribeBalances$5 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
@@ -3865,19 +3864,19 @@ const subscribeBalances$5 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$6({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector,
           miniMetadata
         });
         if (abortController.signal.aborted) return;
         subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$5);
+        setTimeout(poll, SUBSCRIPTION_INTERVAL$4);
       } catch (error) {
         log.error("Error", {
           module: MODULE_TYPE$5,
           networkId,
           miniMetadata,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -3911,13 +3910,13 @@ const PLATFORM$4 = chaindataProvider.SubForeignAssetsTokenSchema.shape.platform.
 
 const fetchBalances$5 = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (!miniMetadata?.data) {
-    log.warn("MiniMetadata is required for fetching balances");
+    log.warn(`MiniMetadata is required for fetching ${MODULE_TYPE$4} balances on ${networkId}.`);
     return {
       success: [],
       errors: balanceDefs.map(def => ({
@@ -4246,10 +4245,10 @@ const getTransferAllEncodedArgs$1 = (onChainId, to, codec) => {
   })]);
 };
 
-const SUBSCRIPTION_INTERVAL$4 = 6_000;
+const SUBSCRIPTION_INTERVAL$3 = 6_000;
 const subscribeBalances$4 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
@@ -4263,19 +4262,19 @@ const subscribeBalances$4 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$5({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector,
           miniMetadata
         });
         if (abortController.signal.aborted) return;
         subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$4);
+        setTimeout(poll, SUBSCRIPTION_INTERVAL$3);
       } catch (error) {
         log.error("Error", {
           module: MODULE_TYPE$4,
           networkId,
           miniMetadata,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -4339,13 +4338,13 @@ const tryGetConstantValue = (metadataRpc, pallet, constant) => {
 
 const fetchBalances$4 = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (!miniMetadata?.data) {
-    log.warn("MiniMetadata is required for fetching balances");
+    log.warn(`MiniMetadata is required for fetching ${MODULE_TYPE$3} balances on ${networkId}.`);
     return {
       success: [],
       errors: balanceDefs.map(def => ({
@@ -4390,7 +4389,7 @@ const fetchBalances$4 = async ({
       })).filter(b => b.onChainId !== undefined);
     });
     const balancesByKey = lodash.keyBy(fetchedBalances, b => `${b.address}:${b.onChainId}`);
-    const success = addressesByToken.reduce((acc, [token, addresses]) => {
+    const success = tokensWithAddresses.reduce((acc, [token, addresses]) => {
       if (token.type === MODULE_TYPE$3) for (const address of addresses) {
         const rawBalance = balancesByKey[`${address}:${token.onChainId}`];
 
@@ -4592,10 +4591,10 @@ const getTransferCallData$3 = ({
   };
 };
 
-const SUBSCRIPTION_INTERVAL$3 = 6_000;
+const SUBSCRIPTION_INTERVAL$2 = 6_000;
 const subscribeBalances$3 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
@@ -4609,19 +4608,19 @@ const subscribeBalances$3 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$4({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector,
           miniMetadata
         });
         if (abortController.signal.aborted) return;
         subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$3);
+        setTimeout(poll, SUBSCRIPTION_INTERVAL$2);
       } catch (error) {
         log.error("Error", {
           module: MODULE_TYPE$3,
           networkId,
           miniMetadata,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -4647,140 +4646,54 @@ const SubHydrationBalanceModule = {
 const MODULE_TYPE$2 = chaindataProvider.SubNativeTokenSchema.shape.type.value;
 const PLATFORM$2 = chaindataProvider.SubNativeTokenSchema.shape.platform.value;
 
-/**
- * Pass some these into an `RpcStateQueryHelper` in order to easily batch multiple state queries into the one rpc call.
- */
-
-const fetchQueriesPack = async (connector, networkId, queries) => {
+const fetchRpcQueryPack = async (connector, networkId, queries) => {
   const allStateKeys = queries.flatMap(({
     stateKeys
   }) => stateKeys).filter(util.isNotNil);
 
-  // doing a query with only null keys would throw an error => return early
+  // doing a query without keys would throw an error => return early
   if (!allStateKeys.length) return queries.map(({
     stateKeys,
     decodeResult
   }) => decodeResult(stateKeys.map(() => null)));
-  const response = await connector.send(networkId, "state_queryStorageAt", [allStateKeys]);
-  const results = queries.reduce((acc, {
+  const [result] = await connector.send(networkId, "state_queryStorageAt", [allStateKeys]);
+  return decodeRpcQueryPack(queries, result);
+};
+const getRpcQueryPack$ = (connector, networkId, queries, timeout = false) => {
+  const allStateKeys = queries.flatMap(({
+    stateKeys
+  }) => stateKeys).filter(util.isNotNil);
+
+  // doing a query without keys would throw an error => return early
+  if (!allStateKeys.length) return rxjs.of(queries.map(({
+    stateKeys,
+    decodeResult
+  }) => decodeResult(stateKeys.map(() => null))));
+  return new rxjs.Observable(subscriber => {
+    const promUnsub = connector.subscribe(networkId, "state_subscribeStorage", "state_storage", [allStateKeys], (error, result) => {
+      if (error) subscriber.error(error);else subscriber.next(decodeRpcQueryPack(queries, result));
+    }, timeout);
+    return () => {
+      promUnsub.then(unsub => unsub("state_unsubscribeStorage"));
+    };
+  });
+};
+const decodeRpcQueryPack = (queries, result) => {
+  return queries.reduce((acc, {
     stateKeys,
     decodeResult
   }) => {
     const changes = stateKeys.map(stateKey => {
       if (!stateKey) return null;
-      const change = response[0].changes.find(([key]) => key === stateKey);
+      const change = result.changes.find(([key]) => key === stateKey);
       if (!change) return null;
       return change[1];
     });
     acc.push(decodeResult(changes));
     return acc;
   }, []);
-  return results;
 };
 
-/**
- * Used by a variety of balance modules to help batch multiple state queries into the one rpc call.
- */
-// export class RpcStateQueriesHelper<T> {
-//   #connector: ChainConnector
-//   #queries: Array<RpcStateQueries<T>>
-
-//   constructor(connector: ChainConnector, queries: Array<RpcStateQueries<T>>) {
-//     this.#connector = connector
-//     this.#queries = queries
-//   }
-
-//   async subscribe(
-//     networkId: DotNetworkId,
-//     callback: SubscriptionCallback<T[]>,
-//     timeout: number | false = false,
-//     subscribeMethod = "state_subscribeStorage",
-//     responseMethod = "state_storage",
-//     unsubscribeMethod = "state_unsubscribeStorage",
-//   ): Promise<UnsubscribeFn> {
-//     const params = [this.#queries.flatMap(({ stateKeys }) => stateKeys)]
-
-//     const unsub = this.#connector.subscribe(
-//       networkId,
-//       subscribeMethod,
-//       responseMethod,
-//       params,
-//       (error, result) => {
-//         error
-//           ? callback(error)
-//           : callback(null, this.#distributeChangesToQueryDecoders.call(this, chainId, result))
-//       },
-//       timeout,
-//     )
-
-//     const subscriptions = queries.map(([chainId, queries]) => {
-//       const params = [queries.map(({ stateKey }) => stateKey)]
-
-//       const unsub = this.#connector.subscribe(
-//         networkId,
-//         subscribeMethod,
-//         responseMethod,
-//         params,
-//         (error, result) => {
-//           error
-//             ? callback(error)
-//             : callback(null, this.#distributeChangesToQueryDecoders.call(this, chainId, result))
-//         },
-//         timeout,
-//       )
-
-//       return () => unsub.then((unsubscribe) => unsubscribe(unsubscribeMethod))
-//     })
-
-//     return () => subscriptions.forEach((unsubscribe) => unsubscribe())
-//   }
-
-//   async fetch(method = "state_queryStorageAt"): Promise<T[]> {
-//     const queriesByChain = groupBy(this.#queries, "chainId")
-
-//     const resultsByChain = await Promise.all(
-//       Object.entries(queriesByChain).map(async ([chainId, queries]) => {
-//         const params = [queries.map(({ stateKey }) => stateKey)]
-
-//         const result = (await this.#connector.send(chainId, method, params))[0]
-//         return this.#distributeChangesToQueryDecoders.call(this, chainId, result)
-//       }),
-//     )
-
-//     return resultsByChain.flatMap((result) => result)
-//   }
-
-//   #distributeChangesToQueryDecoders(chainId: DotNetworkId, result: unknown): T[] {
-//     if (typeof result !== "object" || result === null) return []
-//     if (!hasOwnProperty(result, "changes") || typeof result.changes !== "object") return []
-//     if (!Array.isArray(result.changes)) return []
-
-//     return result.changes.flatMap(([reference, change]: [unknown, unknown]): [T] | [] => {
-//       if (typeof reference !== "string") {
-//         log.warn(`Received non-string reference in RPC result: ${reference}`)
-//         return []
-//       }
-
-//       if (typeof change !== "string" && change !== null) {
-//         log.warn(`Received non-string and non-null change in RPC result: ${reference} | ${change}`)
-//         return []
-//       }
-
-//       const query = this.#queries.find(
-//         ({ chainId: cId, stateKey }) => cId === chainId && stateKey === reference,
-//       )
-//       if (!query) {
-//         log.warn(
-//           `Failed to find query:\n${reference} in\n${this.#queries.map(({ stateKey }) => stateKey)}`,
-//         )
-//         return []
-//       }
-
-//       return [query.decodeResult(change)]
-//     })
-//   }
-// }
-
 const SUBTENSOR_ROOT_NETUID$1 = 0;
 const SUBTENSOR_MIN_STAKE_AMOUNT_PLANK$1 = 1000000n;
 const TAO_DECIMALS$1 = 9n;
@@ -5494,13 +5407,13 @@ const getNomPoolStateKeys = (coders, nomPoolMemberInfo, extra) => {
 
 const fetchBalances$3 = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (!miniMetadata?.data) {
-    log.warn("MiniMetadata is required for fetching balances");
+    log.warn(`MiniMetadata is required for fetching ${MODULE_TYPE$2} balances on ${networkId}.`);
     return {
       success: [],
       errors: balanceDefs.map(def => ({
@@ -5532,12 +5445,12 @@ const fetchBalances$3 = async ({
       }))
     };
   }
-  const queries = buildBaseQueries(networkId, balanceDefs, miniMetadata);
-  const partialBalances = await fetchQueriesPack(connector, networkId, queries);
+  const baseQueries = buildBaseQueries(networkId, balanceDefs, miniMetadata);
+  const partialBalances = await fetchRpcQueryPack(connector, networkId, baseQueries);
 
   // now for each balance that includes nomPoolStaking, we need to fetch the metadata for the pool
   const nomPoolQueries = buildNomPoolQueries(networkId, partialBalances, miniMetadata);
-  const balances = await fetchQueriesPack(connector, networkId, nomPoolQueries);
+  const balances = await fetchRpcQueryPack(connector, networkId, nomPoolQueries);
 
   // TODO ⚠️ dedupe locks
 
@@ -5773,46 +5686,32 @@ const getTransferAllEncodedArgs = (to, codec) => {
   })]);
 };
 
-const SUBSCRIPTION_INTERVAL$2 = 6_000;
 const subscribeBalances$2 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
-  return new rxjs.Observable(subscriber => {
-    const abortController = new AbortController();
-
-    // on hydration balances are fetched using a runtimeApi, which can't be subscribed to.
-    // => poll values for each block
-    const poll = async () => {
-      try {
-        if (abortController.signal.aborted) return;
-        const balances = await fetchBalances$3({
-          networkId,
-          addressesByToken,
-          connector,
-          miniMetadata
-        });
-        if (abortController.signal.aborted) return;
-        subscriber.next(balances);
-        setTimeout(poll, SUBSCRIPTION_INTERVAL$2);
-      } catch (error) {
-        log.error("Error", {
-          module: MODULE_TYPE$2,
-          networkId,
-          miniMetadata,
-          addressesByToken,
-          error
-        });
-        subscriber.error(error);
-      }
-    };
-    poll();
-    return () => {
-      abortController.abort();
+  // could be use as shared observable key if we decide to cache the sub
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
+  const baseQueries = buildBaseQueries(networkId, balanceDefs, miniMetadata);
+  const baseBalances$ = getRpcQueryPack$(connector, networkId, baseQueries).pipe(rxjs.switchMap(partialBalances => {
+    // now for each balance that includes nomPoolStaking, we need to fetch the metadata for the pool
+    const nomPoolQueries = buildNomPoolQueries(networkId, partialBalances, miniMetadata);
+    return getRpcQueryPack$(connector, networkId, nomPoolQueries);
+  }));
+  const subtensorBalancesByAddress$ = getSubtensorStakingBalances$(connector, networkId, balanceDefs, miniMetadata);
+  return rxjs.combineLatest([baseBalances$, subtensorBalancesByAddress$]).pipe(rxjs.map(([baseBalances, subtensorBalancesByAddress]) => {
+    // add subtensor balances to base balances
+    for (const [address, subtensorBalances] of lodash.toPairs(subtensorBalancesByAddress)) {
+      const balance = baseBalances.find(b => b.address === address);
+      if (balance?.values) balance.values.push(...subtensorBalances);
+    }
+    return {
+      success: baseBalances,
+      errors: []
     };
-  }).pipe(rxjs.distinctUntilChanged(lodash.isEqual));
+  }));
 };
 
 const SubNativeBalanceModule = {
@@ -6993,10 +6892,10 @@ var psp22Abi = {
 
 const fetchBalances$2 = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector
 }) => {
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (!balanceDefs.length) return {
     success: [],
     errors: []
@@ -7186,7 +7085,7 @@ const getTransferCallData$1 = async ({
 const SUBSCRIPTION_INTERVAL$1 = 6_000;
 const subscribeBalances$1 = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
@@ -7200,7 +7099,7 @@ const subscribeBalances$1 = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$2({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector,
           miniMetadata
         });
@@ -7212,7 +7111,7 @@ const subscribeBalances$1 = ({
           module: MODULE_TYPE$1,
           networkId,
           miniMetadata,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -7246,13 +7145,13 @@ const PLATFORM = chaindataProvider.SubTokensTokenSchema.shape.platform.value;
 
 const fetchBalances$1 = async ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
-  const balanceDefs = getBalanceDefs(addressesByToken);
+  const balanceDefs = getBalanceDefs(tokensWithAddresses);
   if (!miniMetadata?.data) {
-    log.warn("MiniMetadata is required for fetching balances");
+    log.warn(`MiniMetadata is required for fetching ${MODULE_TYPE} balances on ${networkId}.`);
     return {
       success: [],
       errors: balanceDefs.map(def => ({
@@ -7576,7 +7475,7 @@ const getCallDataOptions = (to, token, value, type, config) => {
 const SUBSCRIPTION_INTERVAL = 6_000;
 const subscribeBalances = ({
   networkId,
-  addressesByToken,
+  tokensWithAddresses,
   connector,
   miniMetadata
 }) => {
@@ -7590,7 +7489,7 @@ const subscribeBalances = ({
         if (abortController.signal.aborted) return;
         const balances = await fetchBalances$1({
           networkId,
-          addressesByToken,
+          tokensWithAddresses: tokensWithAddresses,
           connector,
           miniMetadata
         });
@@ -7602,7 +7501,7 @@ const subscribeBalances = ({
           module: MODULE_TYPE,
           networkId,
           miniMetadata,
-          addressesByToken,
+          addressesByToken: tokensWithAddresses,
           error
         });
         subscriber.error(error);
@@ -7706,6 +7605,7 @@ const getMiniMetadatas = async (chainConnector, chaindataProvider, networkId, sp
   if (CACHE.has(networkId)) return CACHE.get(networkId);
   if (!signal) log.warn("[miniMetadata] getMiniMetadatas called without signal, this may hang the updates", new Error("No signal provided") // this will show the stack trace
   );
+  if (specVersion === undefined) specVersion = await getSpecVersion(chainConnector, networkId);
   const pResult = POOL.add(() => fetchMiniMetadatas(chainConnector, chaindataProvider, networkId, specVersion), {
     signal
   });
@@ -7721,42 +7621,21 @@ const getMiniMetadatas = async (chainConnector, chaindataProvider, networkId, sp
     CACHE.delete(networkId);
   }
 };
-const DotBalanceModuleTypeSchema = z__default.default.keyof(chaindataProvider.DotNetworkBalancesConfigSchema);
-const fetchMiniMetadatas = async (chainConnector, chaindataProvider$1, chainId, specVersion, signal) => {
+const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, specVersion, signal) => {
   const start = performance.now();
   log.info("[miniMetadata] fetching minimetadatas for %s", chainId);
   try {
+    const network = await chaindataProvider.getNetworkById(chainId, "polkadot");
+    if (!network) throw new Error(`Network ${chainId} not found in chaindataProvider`);
+    signal?.throwIfAborted();
     const metadataRpc = await getMetadataRpc(chainConnector, chainId);
     signal?.throwIfAborted();
-    const chainConnectors = {
-      substrate: chainConnector,
-      evm: {} // wont be used but workarounds error for module creation
-    };
-    const modules = defaultBalanceModules.map(mod => mod({
-      chainConnectors,
-      chaindataProvider: chaindataProvider$1
-    })).filter(mod => DotBalanceModuleTypeSchema.safeParse(mod.type).success);
-    return Promise.all(modules.map(async mod => {
-      const source = mod.type;
-      const chain = await chaindataProvider$1.getNetworkById(chainId, "polkadot");
-      const balancesConfig = chain?.balancesConfig?.[mod.type];
-      const chainMeta = await mod.fetchSubstrateChainMeta(chainId, balancesConfig,
-      // TODO better typing
-      metadataRpc);
-      return {
-        id: deriveMiniMetadataId({
-          source,
-          chainId,
-          specVersion
-        }),
-        source,
-        chainId,
-        specVersion,
-        version: chaindataProvider.MINIMETADATA_VERSION,
-        data: chainMeta?.miniMetadata ?? null,
-        extra: chainMeta?.extra ?? null
-      };
-    }));
+    return Promise.all(BALANCE_MODULES.filter(m => m.platform === "polkadot").map(mod => mod.getMiniMetadata({
+      networkId: chainId,
+      metadataRpc,
+      specVersion,
+      config: network.balancesConfig?.[mod.type]
+    })));
   } finally {
     log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, (performance.now() - start).toFixed(2));
   }
@@ -10467,6 +10346,134 @@ async function buildQueries(chainConnector, chaindataProvider$1, addressesByToke
 const defaultBalanceModules = [EvmErc20Module, EvmNativeModule, EvmUniswapV2Module, SubAssetsModule, SubForeignAssetsModule, SubNativeModule, SubPsp22Module, SubTokensModule];
 const BALANCE_MODULES = [SubNativeBalanceModule, SubAssetsBalanceModule, SubHydrationBalanceModule, SubForeignAssetsBalanceModule, SubPsp22BalanceModule, SubTokensBalanceModule, EvmErc20BalanceModule, EvmUniswapV2BalanceModule, EvmNativeBalanceModule];
 
+const DEFAULT_STORAGE = {
+  balances: [],
+  miniMetadatas: []
+};
+class BalancesProvider {
+  #chaindataProvider;
+  #chainConnectors;
+  #storage;
+  constructor(chaindataProvider, chainConnectors, storage = DEFAULT_STORAGE) {
+    this.#chaindataProvider = chaindataProvider;
+    this.#chainConnectors = chainConnectors;
+    this.#storage = new rxjs.BehaviorSubject({
+      balances: lodash.keyBy(storage.balances.filter(util.isNotNil), b => getBalanceId(b)),
+      miniMetadatas: lodash.keyBy(storage.miniMetadatas.filter(util.isNotNil), m => m.id)
+    });
+  }
+  get storage$() {
+    return this.#storage.pipe(rxjs.map(({
+      balances,
+      miniMetadatas
+    }) => ({
+      balances: lodash.values(balances).filter(util.isNotNil),
+      miniMetadatas: lodash.values(miniMetadatas).filter(util.isNotNil)
+    })));
+  }
+  getBalances$(addressesByToken) {
+    const networkIds = lodash.uniq(lodash.keys(addressesByToken).map(tokenId => chaindataProvider.parseTokenId(tokenId).networkId));
+    return rxjs.combineLatest(networkIds.map(networkId => this.getNetworkBalances$(networkId, addressesByToken))).pipe(rxjs.map(results => {
+      return {
+        status: results.some(({
+          status
+        }) => status === "initialising") ? "initialising" : "live",
+        balances: results.flatMap(result => result.balances)
+      };
+    }), rxjs.startWith({
+      status: "initialising",
+      balances: this.getStoredBalances(addressesByToken)
+    }), rxjs.distinctUntilChanged(lodash.isEqual));
+  }
+  getNetworkBalances$(networkId, addressesByTokenId) {
+    const network$ = this.#chaindataProvider.getNetworkById$(networkId);
+    const tokensMapById$ = this.#chaindataProvider.getTokensMapById$();
+    const miniMetadatas$ = this.getNetworkMiniMetadatas$(networkId);
+    return rxjs.combineLatest([network$, miniMetadatas$, tokensMapById$]).pipe(rxjs.switchMap(([network, miniMetadatas, tokensMapById]) => {
+      const tokensAndAddresses = lodash.toPairs(addressesByTokenId).map(([tokenId, addresses]) => [tokensMapById[tokenId], addresses]);
+      return rxjs.combineLatest(BALANCE_MODULES.filter(mod => mod.platform === network?.platform).map(mod => {
+        const tokensWithAddresses = tokensAndAddresses.filter(([token]) => token.type === mod.type);
+        const moduleAddressesByTokenId = lodash.fromPairs(tokensWithAddresses.map(([token, addresses]) => [token.id, addresses]));
+        const miniMetadata = miniMetadatas.find(m => m.source === mod.type);
+
+        // all balance ids expected in result set
+        const balanceIds = lodash.toPairs(moduleAddressesByTokenId).flatMap(([tokenId, addresses]) => addresses.map(address => getBalanceId({
+          tokenId,
+          address
+        })));
+        const initValue = {
+          status: "initialising",
+          balances: this.getStoredBalances(moduleAddressesByTokenId)
+        };
+        const updateStorage = results => {
+          if (results.status !== "live") return;
+          const storage = this.#storage.getValue();
+          const balances = lodash.assign({}, storage.balances,
+          // delete all balances expected in the result set. because if they are not present it means they are empty.
+          lodash.fromPairs(balanceIds.map(balanceId => [balanceId, undefined])), lodash.keyBy(results.balances, b => getBalanceId(b)));
+          this.#storage.next(lodash.assign({}, storage, {
+            balances
+          }));
+        };
+        switch (mod.platform) {
+          case "ethereum":
+            {
+              if (!this.#chainConnectors.evm) return rxjs.of(initValue);
+              return mod.subscribeBalances({
+                networkId,
+                tokensWithAddresses,
+                connector: this.#chainConnectors.evm
+              }).pipe(rxjs.map(results => ({
+                status: "live",
+                // exclude zero balances
+                balances: results.success.filter(b => new Balance(b).total.planck > 0n)
+              })), rxjs.tap(updateStorage), rxjs.startWith(initValue));
+            }
+          case "polkadot":
+            if (!this.#chainConnectors.substrate || !miniMetadata) {
+              log.debug("[balances] no substrate connector or miniMetadata for polkadot", mod.type);
+              return rxjs.of(initValue);
+            }
+            return mod.subscribeBalances({
+              networkId,
+              tokensWithAddresses,
+              connector: this.#chainConnectors.substrate,
+              miniMetadata: miniMetadata
+            }).pipe(rxjs.map(results => ({
+              status: "live",
+              // exclude zero balances
+              balances: results.success.filter(b => new Balance(b).total.planck > 0n)
+            })), rxjs.tap(updateStorage), rxjs.startWith(initValue));
+        }
+      }));
+    }), rxjs.map(results => {
+      return {
+        status: results.some(({
+          status
+        }) => status === "initialising") ? "initialising" : "live",
+        balances: results.flatMap(result => result.balances)
+      };
+    }));
+  }
+  getNetworkMiniMetadatas$(networkId) {
+    return this.#chaindataProvider.getNetworkById$(networkId).pipe(rxjs.switchMap(network => chaindataProvider.isNetworkDot(network) && this.#chainConnectors.substrate ? rxjs.from(getMiniMetadatas(this.#chainConnectors.substrate, this.#chaindataProvider, networkId)) : rxjs.of([])));
+  }
+  getStoredBalances(addressesByToken) {
+    const balanceDefs = lodash.toPairs(addressesByToken).flatMap(([tokenId, addresses]) => addresses.map(address => [tokenId, address]));
+    return balanceDefs.map(([tokenId, address]) => this.#storage.value.balances[getBalanceId({
+      address,
+      tokenId
+    })]).filter(util.isNotNil);
+  }
+}
+
+// const getStoredBalances = (
+//   storedBalances: Record<string, IBalance>,
+//   addressesByToken: Record<TokenId, Address[]>,
+// ): IBalance[] => {
+
+// }
+
 Object.defineProperty(exports, "MINIMETADATA_VERSION", {
   enumerable: true,
   get: function () { return chaindataProvider.MINIMETADATA_VERSION; }
@@ -10476,6 +10483,7 @@ exports.Balance = Balance;
 exports.BalanceFormatter = BalanceFormatter;
 exports.BalanceValueGetter = BalanceValueGetter;
 exports.Balances = Balances;
+exports.BalancesProvider = BalancesProvider;
 exports.Change24hCurrencyFormatter = Change24hCurrencyFormatter;
 exports.DefaultBalanceModule = DefaultBalanceModule;
 exports.EvmErc20BalanceModule = EvmErc20BalanceModule;