@talismn/balances 0.0.0-pr2043-20250628151732 → 0.0.0-pr2043-20250629051139

package/dist/declarations/src/getMiniMetadata/getSpecVersion.d.ts

@@ -1,6 +1,6 @@
 import { ChainConnector } from "@talismn/chain-connector";
 import { DotNetworkId } from "@talismn/chaindata-provider";
 /**
- * fetches the spec version of a network. current request is cached in case of multiple calls (all balance subs kick in at once)
+ * fetches the spec version of a network. current request is cached in case of multiple calls (all balance modules will kick in at once)
  */
 export declare const getSpecVersion: (chainConnector: ChainConnector, networkId: DotNetworkId) => Promise<number>;

package/dist/declarations/src/index.d.ts

@@ -1,5 +1,4 @@
 export * from "./BalanceModule";
-export * from "./EvmTokenFetcher";
 export * from "./TalismanBalancesDatabase";
 export * from "./modules";
 export * from "./types";

package/dist/declarations/src/modules/EvmNativeModule.d.ts

@@ -1,4 +1,4 @@
-import { CustomEvmNativeToken, EvmNativeToken } from "@talismn/chaindata-provider";
+import { EvmNativeToken } from "@talismn/chaindata-provider";
 import z from "zod/v4";
 import { DefaultChainMeta, DefaultModuleConfig, NewBalanceModule } from "../BalanceModule";
 import { NewBalanceType } from "../types";
@@ -23,5 +23,5 @@ declare module "@talismn/balances/plugins" {
         "evm-native": EvmNativeBalance;
     }
 }
-export declare const EvmNativeModule: NewBalanceModule<ModuleType, EvmNativeToken | CustomEvmNativeToken, EvmNativeChainMeta, EvmNativeModuleConfig, EvmNativeTokenConfig>;
+export declare const EvmNativeModule: NewBalanceModule<ModuleType, EvmNativeToken, EvmNativeChainMeta, EvmNativeModuleConfig, EvmNativeTokenConfig>;
 export {};

package/dist/declarations/src/modules/SubstrateNativeModule/index.d.ts

@@ -1,4 +1,4 @@
-import { CustomSubNativeToken, SubNativeToken } from "@talismn/chaindata-provider";
+import { SubNativeToken } from "@talismn/chaindata-provider";
 import z from "zod/v4";
 import { NewBalanceModule } from "../../BalanceModule";
 import { ModuleType, SubNativeChainMeta, SubNativeModuleConfig, SubNativeTransferParams } from "./types";
@@ -18,4 +18,4 @@ export declare const SubNativeTokenConfigSchema: z.ZodObject<{
     mirrorOf: z.ZodOptional<z.ZodOptional<z.ZodString>>;
 }, z.core.$strict>;
 export type SubNativeTokenConfig = z.infer<typeof SubNativeTokenConfigSchema>;
-export declare const SubNativeModule: NewBalanceModule<ModuleType, SubNativeToken | CustomSubNativeToken, SubNativeChainMeta, SubNativeModuleConfig, SubNativeTokenConfig, SubNativeTransferParams>;
+export declare const SubNativeModule: NewBalanceModule<ModuleType, SubNativeToken, SubNativeChainMeta, SubNativeModuleConfig, SubNativeTokenConfig, SubNativeTransferParams>;

package/dist/declarations/src/modules/SubstrateNativeModule/types.d.ts

@@ -11,7 +11,6 @@ export type SubNativeChainMeta = ChainMeta<{
     useLegacyTransferableCalculation?: boolean;
     existentialDeposit?: string;
     nominationPoolsPalletId?: string;
-    crowdloanPalletId?: string;
     hasSubtensorPallet?: boolean;
 } | null>;
 export type SubNativeModuleConfig = SubNativeBalancesConfig;

package/dist/declarations/src/modules/SubstrateNativeModule/util/sortChains.d.ts

@@ -1 +1 @@
-export declare const sortChainsNativeTokensByPriority: (a: string, b: string) => 0 | 1 | -1;
+export declare const sortChainsNativeTokensByPriority: (a: string, b: string) => 1 | 0 | -1;

package/dist/declarations/src/modules/SubstrateNativeModule/util/systemProperties.d.ts

@@ -1,21 +1,4 @@
 import { ChainConnector } from "@talismn/chain-connector";
-import z from "zod/v4";
-export declare const DotNetworkProperties: z.ZodPipe<z.ZodUnion<readonly [z.ZodObject<{
-    tokenDecimals: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    tokenSymbol: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>, z.ZodObject<{
-    tokenDecimals: z.ZodArray<z.ZodNumber>;
-    tokenSymbol: z.ZodArray<z.ZodString>;
-}, z.core.$strip>]>, z.ZodTransform<{
-    tokenDecimals: number;
-    tokenSymbol: string;
-}, {
-    tokenDecimals: number;
-    tokenSymbol: string;
-} | {
-    tokenDecimals: number[];
-    tokenSymbol: string[];
-}>>;
 export declare const getChainProperties: (chainConnector: ChainConnector, networkId: string) => Promise<{
     tokenDecimals: number;
     tokenSymbol: string;

package/dist/declarations/src/modules/index.d.ts

@@ -37,20 +37,6 @@ export declare const defaultBalanceModules: (import("..").NewBalanceModule<"evm-
     coingeckoId?: string | undefined;
     noDiscovery?: boolean | undefined;
     mirrorOf?: string | undefined;
-} | {
-    id: string;
-    networkId: string;
-    decimals: number;
-    symbol: string;
-    type: "evm-native";
-    platform: "ethereum";
-    isCustom: true;
-    isDefault?: boolean | undefined;
-    name?: string | undefined;
-    logo?: string | undefined;
-    coingeckoId?: string | undefined;
-    noDiscovery?: boolean | undefined;
-    mirrorOf?: string | undefined;
 }, import("..").DefaultChainMeta, undefined, {
     symbol?: string | undefined;
     networkId?: string | undefined;
@@ -171,21 +157,6 @@ export declare const defaultBalanceModules: (import("..").NewBalanceModule<"evm-
     coingeckoId?: string | undefined;
     noDiscovery?: boolean | undefined;
     mirrorOf?: string | undefined;
-} | {
-    id: string;
-    networkId: string;
-    decimals: number;
-    symbol: string;
-    type: "substrate-native";
-    platform: "polkadot";
-    existentialDeposit: string;
-    isCustom: true;
-    isDefault?: boolean | undefined;
-    name?: string | undefined;
-    logo?: string | undefined;
-    coingeckoId?: string | undefined;
-    noDiscovery?: boolean | undefined;
-    mirrorOf?: string | undefined;
 }, import("./SubstrateNativeModule").SubNativeChainMeta, {
     disable?: boolean | undefined;
 }, {

package/dist/declarations/src/modules/util/getUniqueChainIds.d.ts

@@ -1,5 +1,5 @@
-import { ChainId, TokenList } from "@talismn/chaindata-provider";
+import { NetworkId, TokenList } from "@talismn/chaindata-provider";
 import { AddressesByToken } from "../../types";
 export declare const getUniqueChainIds: (addressesByToken: AddressesByToken<{
     id: string;
-}>, tokens: TokenList) => ChainId[];
+}>, tokens: TokenList) => NetworkId[];

package/dist/declarations/src/types/balances.d.ts

@@ -380,7 +380,6 @@ export declare class Balance {
     /** The frozen balance of this token. Is included in the free amount. */
     get locked(): BalanceFormatter;
     get locks(): FormattedAmount<AmountWithLabel<string>, string>[];
-    get crowdloans(): FormattedAmount<AmountWithLabel<string>, string>[];
     get nompools(): FormattedAmount<AmountWithLabel<string>, string>[];
     get subtensor(): FormattedAmount<AmountWithLabel<string>, string>[];
     /** The extra balance of this token */

package/dist/declarations/src/types/balancetypes.d.ts

@@ -52,14 +52,14 @@ export type EvmBalance = IBalanceBase & (IBalanceSimpleValues | IBalanceComplexV
 export type SubstrateBalance = IBalanceBase & (IBalanceSimpleValues | IBalanceComplexValues);
 /** An unlabelled amount of a balance */
 export type Amount = string;
-export type BalanceStatusTypes = "free" | "reserved" | "locked" | "extra" | "crowdloan" | "nompool" | "subtensor";
+export type BalanceStatusTypes = "free" | "reserved" | "locked" | "extra" | "nompool" | "subtensor";
 /** A labelled amount of a balance */
 type BaseAmountWithLabel<TLabel extends string> = {
     type: BalanceStatusTypes;
     /**
      * For modules which fetch balances via module sources, the source is equivalent to previous 'subSource' field
      * on the parent balance object
-     * e.g. `staking` or `crowdloans`
+     * e.g. `staking`
      **/
     source?: string;
     label: TLabel;

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

@@ -40,8 +40,6 @@ var PQueue__default = /*#__PURE__*/_interopDefault(PQueue);
 var groupBy__default = /*#__PURE__*/_interopDefault(groupBy);
 var upperFirst__default = /*#__PURE__*/_interopDefault(upperFirst);
 
-// Record<string, unknown> | undefined
-
 // TODO: Document default balances module purpose/usage
 const DefaultBalanceModule = type => ({
   get type() {
@@ -75,58 +73,9 @@ const DefaultBalanceModule = type => ({
 // internal
 //
 
-// TODO yeet ?
-// there is no need to construct a lit of tokens, it's done by∏ chaindata
-
-/**
- * Fetches tokens for EVM networks.
- * @deprecated
- */
-class EvmTokenFetcher {
-  #chaindataProvider;
-  #balanceModules;
-  constructor(chaindataProvider, balanceModules) {
-    this.#chaindataProvider = chaindataProvider;
-    this.#balanceModules = balanceModules;
-  }
-  async update(_evmNetworkIds) {
-    // chaindataProvider's tokens should be in sync already
-    // await this.updateEvmNetworks(evmNetworkIds)
-  }
-
-  // private async updateEvmNetworks(evmNetworkIds: EvmNetworkId[]) {
-  //   // feels unnecessary, chaindataProvider's tokens should be in sync already
-  //   //   const evmNetworks = new Map(
-  //   //     (await this.#chaindataProvider.evmNetworks()).map((evmNetwork) => [
-  //   //       evmNetwork.id,
-  //   //       evmNetwork,
-  //   //     ]),
-  //   //   )
-  //   //   const allEvmTokens: TokenList = {}
-  //   //   const evmNetworkConcurrency = 10
-  //   //   await PromisePool.withConcurrency(evmNetworkConcurrency)
-  //   //     .for(evmNetworkIds)
-  //   //     .process(async (evmNetworkId) => {
-  //   //       const evmNetwork = evmNetworks.get(evmNetworkId)
-  //   //       if (!evmNetwork) return
-  //   //       for (const mod of this.#balanceModules.filter((m) => m.type.startsWith("evm-"))) {
-  //   //         // const balancesConfig = (evmNetwork.balancesConfig ?? []).find(
-  //   //         //   ({ moduleType }) => moduleType === mod.type,
-  //   //         // )
-  //   //         // const moduleConfig = balancesConfig?.moduleConfig ?? {}
-  //   //         // chainMeta arg only needs the isTestnet property, let's save a db roundtrip for now
-  //   //         const isTestnet = evmNetwork.isTestnet ?? false
-  //   //         const tokens = await mod.fetchEvmChainTokens(evmNetworkId, { isTestnet }, moduleConfig)
-  //   //         for (const [tokenId, token] of Object.entries(tokens)) allEvmTokens[tokenId] = token
-  //   //       }
-  //   //     })
-  //   //   await this.#chaindataProvider.updateEvmNetworkTokens(Object.values(allEvmTokens))
-  // }
-}
-
 var pkg = {
 	name: "@talismn/balances",
-	version: "0.0.0-pr2043-20250628151732"};
+	version: "0.0.0-pr2043-20250629051139"};
 
 var log = anylogger__default.default(pkg.name);
 
@@ -430,7 +379,6 @@ class Balance {
     // This means that those rates are always available for calculating the uniswapv2 rates,
     // regardless of whether or not the underlying erc20s are actually in chaindata and enabled.
     if (this.isSource("evm-uniswapv2") && this.token?.type === "evm-uniswapv2" // &&
-    //this.evmNetworkId
     ) {
       const tokenId0 = chaindataProvider.evmErc20TokenId(this.networkId, this.token.tokenAddress0);
       const tokenId1 = chaindataProvider.evmErc20TokenId(this.networkId, this.token.tokenAddress1);
@@ -512,9 +460,7 @@ class Balance {
     const nomPoolStakedPlancks = this.locks.some(lock => lock.source === "substrate-native-holds" && lock.label === "DelegatedStaking") ? 0n : this.nompools.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n);
-    return this.#format(this.free.planck + this.reserved.planck + nomPoolStakedPlancks + this.crowdloans.map(({
-      amount
-    }) => amount.planck).reduce((a, b) => a + b, 0n) + this.subtensor.map(({
+    return this.#format(this.free.planck + this.reserved.planck + nomPoolStakedPlancks + this.subtensor.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n) + includeInTotalExtraAmount(extra));
   }
@@ -550,9 +496,6 @@ class Balance {
   get locks() {
     return this.getValue("locked");
   }
-  get crowdloans() {
-    return this.getValue("crowdloan");
-  }
   get nompools() {
     return this.getValue("nompool");
   }
@@ -631,7 +574,7 @@ class Balance {
     const nomPoolStakedPlancks = this.locks.some(lock => lock.source === "substrate-native-holds" && lock.label === "DelegatedStaking") ? 0n : this.nompools.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n);
-    const otherUnavailable = nomPoolStakedPlancks + this.crowdloans.reduce((total, each) => total + each.amount.planck, 0n) + this.subtensor.reduce((total, each) => total + each.amount.planck, 0n);
+    const otherUnavailable = nomPoolStakedPlancks + this.subtensor.reduce((total, each) => total + each.amount.planck, 0n);
     return this.#format(baseUnavailable + otherUnavailable);
   }
 
@@ -886,21 +829,8 @@ const filterMirrorTokens = (balance, i, balances) => {
 
 /** A collection of `BalanceJson` objects */
 
-// type IBalanceBaseEvm = {
-//   /** WIP, use `chainId` or `evmNetworkId` for now */
-//   multiChainId: EvmChainId
-
-// }
-
-// type IBalanceBaseSubstrate = {
-//   multiChainId: SubChainId
-
-// }
-
 /** `IBalance` is a common interface which all balance types must implement. */
 
-// & (IBalanceBaseEvm | IBalanceBaseSubstrate)
-
 /** An unlabelled amount of a balance */
 
 /** A labelled amount of a balance */
@@ -909,7 +839,6 @@ const getValueId = amount => {
   const getMetaId = () => {
     const meta = amount.meta;
     if (!meta) return "";
-    if (amount.type === "crowdloan") return meta.paraId?.toString() ?? "";
     if (amount.type === "nompool") return meta.poolId?.toString() ?? "";
     if (amount.type === "subtensor") {
       const {
@@ -1315,8 +1244,6 @@ const EvmErc20Module = hydrate => {
      * In a future version of the balance libraries, we may build some kind of async scheduling system which will keep the list of tokens for each chain up to date without relying on a squid.
      */
     async fetchEvmChainTokens(chainId, _chainMeta, moduleConfig, tokens) {
-      //const { isTestnet } = chainMeta
-
       const chainTokens = {};
       for (const tokenConfig of tokens ?? []) {
         const {
@@ -1330,8 +1257,6 @@ const EvmErc20Module = hydrate => {
           log.warn("ignoring token on chain %s", chainId, tokenConfig);
           continue;
         }
-
-        // TODO zodify this
         const symbol = tokenConfig?.symbol ?? contractSymbol ?? "ETH";
         const decimals = typeof tokenConfig?.decimals === "number" ? tokenConfig.decimals : typeof contractDecimals === "number" ? contractDecimals : 18;
         if (!symbol || typeof decimals !== "number") continue;
@@ -1358,7 +1283,6 @@ const EvmErc20Module = hydrate => {
         } else {
           log.warn("Ignoring invalid token", token.id, validation.error.message, validation.error.issues);
         }
-        chainTokens[token.id] = token;
       }
       return chainTokens;
     },
@@ -1632,7 +1556,6 @@ const EvmNativeModule = hydrate => {
      */
     async fetchEvmChainTokens() {
       // token is currently generated in chaindata from the EthNetworkConfig["nativeCurrency"] field
-      // TODO normalise this
       return {};
     },
     async subscribeBalances({
@@ -2378,7 +2301,7 @@ const moduleType$5 = "evm-uniswapv2";
 const EvmUniswapV2TokenConfigSchema = z__default.default.strictObject({
   contractAddress: chaindataProvider.EvmUniswapV2TokenSchema.shape.contractAddress,
   ...TokenConfigBaseSchema.shape,
-  // the ones below are unused and prone to error, feels better to always fetch these from chain
+  // on chaindata side these are fetched by a dedicated task
   symbol0: chaindataProvider.EvmUniswapV2TokenSchema.shape.symbol0.optional(),
   symbol1: chaindataProvider.EvmUniswapV2TokenSchema.shape.symbol1.optional(),
   decimals0: chaindataProvider.EvmUniswapV2TokenSchema.shape.decimals0.optional(),
@@ -2673,7 +2596,7 @@ const fetchSpecVersion = async (chainConnector, networkId) => {
 };
 
 /**
- * fetches the spec version of a network. current request is cached in case of multiple calls (all balance subs kick in at once)
+ * fetches the spec version of a network. current request is cached in case of multiple calls (all balance modules will kick in at once)
  */
 const getSpecVersion = async (chainConnector, networkId) => {
   if (CACHE_GET_SPEC_VERSION.has(networkId)) return CACHE_GET_SPEC_VERSION.get(networkId);
@@ -2757,7 +2680,7 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
       const chain = await chaindataProvider.getNetworkById(chainId, "polkadot");
       const balancesConfig = chain?.balancesConfig?.[mod.type];
       const chainMeta = await mod.fetchSubstrateChainMeta(chainId, balancesConfig,
-      // TODO fix typings
+      // TODO better typing
       metadataRpc);
       return {
         id: deriveMiniMetadataId({
@@ -2775,7 +2698,7 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
       };
     }));
   } finally {
-    log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, performance.now() - start);
+    log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, (performance.now() - start).toFixed(2));
   }
 };
 
@@ -2840,6 +2763,7 @@ async function balances(balanceModule, addressesByToken, callback) {
   return await balanceModule.fetchBalances(addressesByToken);
 }
 
+// TODO remove this one in favor of the network specific one below
 const buildStorageCoders = ({
   chainIds,
   chains,
@@ -3184,7 +3108,6 @@ const SubAssetsModule = hydrate => {
           if (controller.signal.aborted) return () => {};
           const stateHelper = new RpcStateQueryHelper(chainConnector, queries);
           return await stateHelper.subscribe((error, result) => {
-            //  console.log("SubstrateAssetsModule.callback", { error, result })
             if (error) return callback(error);
             const balances = result?.filter(b => b !== null) ?? [];
             if (balances.length > 0) callback(null, new Balances(balances));
@@ -3297,7 +3220,7 @@ async function buildNetworkQueries$2(networkId, chainConnector, chaindataProvide
     }
     return addresses.flatMap(address => {
       const scaleCoder = networkStorageCoders?.storage;
-      const stateKey = tryEncode(scaleCoder, BigInt(token.assetId), address) ?? tryEncode(scaleCoder, Number(token.assetId), address);
+      const stateKey = tryEncode(scaleCoder, Number(token.assetId), address) ?? tryEncode(scaleCoder, BigInt(token.assetId), address);
       if (!stateKey) {
         log.warn(`Invalid assetId / address in ${networkId} storage query ${token.assetId} / ${address}`);
         return [];
@@ -4318,22 +4241,14 @@ const filterBaseLocks = locks => {
 };
 
 // TODO: Make these titles translatable
-const getLockTitle = (lock, {
+const getLockTitle = (lock,
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+{
   balance
 } = {}) => {
   if (!lock.label) return lock.label;
   if (lock.label === "democracy") return "Governance";
-  if (lock.label === "crowdloan") {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const paraId = lock.meta?.paraId;
-    if (!paraId) return "Crowdloan";
-
-    // balance?.network?.parathreads?.find(
-    //   (parathread) => parathread?.paraId === paraId,
-    // )?.name
-
-    return `${`Parachain ${paraId}`} Crowdloan`;
-  }
+  if (lock.label === "crowdloan") return "Crowdloan";
   if (lock.label === "nompools-staking") return "Pooled Staking";
   if (lock.label === "nompools-unbonding") return "Pooled Staking";
   if (lock.label === "subtensor-staking") return "Root Staking";
@@ -4346,10 +4261,6 @@ const getLockTitle = (lock, {
 
 const moduleType$2 = "substrate-native";
 
-//  {
-//   disable?: boolean
-// } & BalancesConfigTokenParams
-
 /**
  * Function to merge two 'sub sources' of the same balance together, or
  * two instances of the same balance with different values.
@@ -4724,8 +4635,6 @@ class QueryCache {
   #chainConnector;
   miniMetadatas = new Map();
   balanceQueryCache = new Map();
-  // private metadataSub: Subscription | null = null
-
   constructor(chaindataProvider, chainConnector) {
     this.chaindataProvider = chaindataProvider;
     this.#chaindataProvider = chaindataProvider;
@@ -4809,13 +4718,13 @@ const DotNetworkPropertiesArray = z__default.default.object({
   tokenDecimals: z__default.default.array(z__default.default.number()).nonempty(),
   tokenSymbol: z__default.default.array(z__default.default.string()).nonempty()
 });
-const DotNetworkProperties = z__default.default.union([DotNetworkPropertiesSimple, DotNetworkPropertiesArray]).transform(val => ({
+const DotNetworkPropertiesSchema = z__default.default.union([DotNetworkPropertiesSimple, DotNetworkPropertiesArray]).transform(val => ({
   tokenDecimals: Array.isArray(val.tokenDecimals) ? val.tokenDecimals[0] : val.tokenDecimals,
   tokenSymbol: Array.isArray(val.tokenSymbol) ? val.tokenSymbol[0] : val.tokenSymbol
 }));
 const getChainProperties = async (chainConnector, networkId) => {
   const properties = await chainConnector.send(networkId, "system_properties", [], true);
-  return DotNetworkProperties.parse(properties);
+  return DotNetworkPropertiesSchema.parse(properties);
 };
 
 const POLLING_WINDOW_SIZE = 20;
@@ -4840,6 +4749,7 @@ const SubNativeModule = hydrate => {
   // subscribeBalances was split by network to prevent all subs to wait for all minimetadatas to be ready.
   // however the multichain logic in there is so deep in the function below that i had to keep it as-is, and call it by per-network chunks
   // TODO refactor this be actually network specific
+  // Note: had to extract this function from the result object or this.subscribeBalances wouldn't be typed correctly
   const subscribeChainBalances = (chainId, opts, callback, signal) => {
     const {
       addressesByToken,
@@ -5041,7 +4951,6 @@ const SubNativeModule = hydrate => {
       };
       const existentialDeposit = getConstantValue("Balances", "ExistentialDeposit")?.toString();
       const nominationPoolsPalletId = getConstantValue("NominationPools", "PalletId")?.asText();
-      const crowdloanPalletId = getConstantValue("Crowdloan", "PalletId")?.asText(); // TODO yeet
       const hasSubtensorPallet = getConstantValue("SubtensorModule", "KeySwapCost") !== undefined;
 
       //
@@ -5061,16 +4970,7 @@ const SubNativeModule = hydrate => {
       }, {
         pallet: "Staking",
         items: ["Ledger"]
-      }, {
-        pallet: "Crowdloan",
-        items: ["Funds"]
-      },
-      // TODO yeet
-      {
-        pallet: "Paras",
-        items: ["Parachains"]
       },
-      // TODO yeet
       // TotalColdkeyStake is used until v.2.2.1, then it is replaced by StakingHotkeys+Stake
       // Need to keep TotalColdkeyStake for a while so chaindata keeps including it in miniMetadatas, so it doesnt break old versions of the wallet
       {
@@ -5096,7 +4996,6 @@ const SubNativeModule = hydrate => {
           useLegacyTransferableCalculation,
           existentialDeposit,
           nominationPoolsPalletId,
-          crowdloanPalletId,
           hasSubtensorPallet
         }
       };
@@ -5147,7 +5046,7 @@ const SubNativeModule = hydrate => {
       const unsubsribeFns = Promise.all(lodash.keys(addressesByTokenByNetwork).map(async networkId => {
         try {
           // this is what we want to be done separately for each network
-          // this will update the DB so minimetadata will be available when it's used, veeeeery far down the tree of subscribeChainBalances
+          // this will update the DB so minimetadata will be available when it's used, everywhere else down the tree of subscribeChainBalances
           await getMiniMetadata(chaindataProvider$1, chainConnector$1, networkId, moduleType$2, controller.signal);
         } catch (err) {
           if (!util.isAbortError(err)) log.warn("Failed to get native token miniMetadata for network", networkId, err);
@@ -6943,7 +6842,6 @@ exports.EvmErc20Module = EvmErc20Module;
 exports.EvmErc20TokenConfigSchema = EvmErc20TokenConfigSchema;
 exports.EvmNativeModule = EvmNativeModule;
 exports.EvmNativeTokenConfigSchema = EvmNativeTokenConfigSchema;
-exports.EvmTokenFetcher = EvmTokenFetcher;
 exports.EvmUniswapV2Module = EvmUniswapV2Module;
 exports.EvmUniswapV2TokenConfigSchema = EvmUniswapV2TokenConfigSchema;
 exports.FiatSumBalancesFormatter = FiatSumBalancesFormatter;

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

@@ -40,8 +40,6 @@ var PQueue__default = /*#__PURE__*/_interopDefault(PQueue);
 var groupBy__default = /*#__PURE__*/_interopDefault(groupBy);
 var upperFirst__default = /*#__PURE__*/_interopDefault(upperFirst);
 
-// Record<string, unknown> | undefined
-
 // TODO: Document default balances module purpose/usage
 const DefaultBalanceModule = type => ({
   get type() {
@@ -75,58 +73,9 @@ const DefaultBalanceModule = type => ({
 // internal
 //
 
-// TODO yeet ?
-// there is no need to construct a lit of tokens, it's done by∏ chaindata
-
-/**
- * Fetches tokens for EVM networks.
- * @deprecated
- */
-class EvmTokenFetcher {
-  #chaindataProvider;
-  #balanceModules;
-  constructor(chaindataProvider, balanceModules) {
-    this.#chaindataProvider = chaindataProvider;
-    this.#balanceModules = balanceModules;
-  }
-  async update(_evmNetworkIds) {
-    // chaindataProvider's tokens should be in sync already
-    // await this.updateEvmNetworks(evmNetworkIds)
-  }
-
-  // private async updateEvmNetworks(evmNetworkIds: EvmNetworkId[]) {
-  //   // feels unnecessary, chaindataProvider's tokens should be in sync already
-  //   //   const evmNetworks = new Map(
-  //   //     (await this.#chaindataProvider.evmNetworks()).map((evmNetwork) => [
-  //   //       evmNetwork.id,
-  //   //       evmNetwork,
-  //   //     ]),
-  //   //   )
-  //   //   const allEvmTokens: TokenList = {}
-  //   //   const evmNetworkConcurrency = 10
-  //   //   await PromisePool.withConcurrency(evmNetworkConcurrency)
-  //   //     .for(evmNetworkIds)
-  //   //     .process(async (evmNetworkId) => {
-  //   //       const evmNetwork = evmNetworks.get(evmNetworkId)
-  //   //       if (!evmNetwork) return
-  //   //       for (const mod of this.#balanceModules.filter((m) => m.type.startsWith("evm-"))) {
-  //   //         // const balancesConfig = (evmNetwork.balancesConfig ?? []).find(
-  //   //         //   ({ moduleType }) => moduleType === mod.type,
-  //   //         // )
-  //   //         // const moduleConfig = balancesConfig?.moduleConfig ?? {}
-  //   //         // chainMeta arg only needs the isTestnet property, let's save a db roundtrip for now
-  //   //         const isTestnet = evmNetwork.isTestnet ?? false
-  //   //         const tokens = await mod.fetchEvmChainTokens(evmNetworkId, { isTestnet }, moduleConfig)
-  //   //         for (const [tokenId, token] of Object.entries(tokens)) allEvmTokens[tokenId] = token
-  //   //       }
-  //   //     })
-  //   //   await this.#chaindataProvider.updateEvmNetworkTokens(Object.values(allEvmTokens))
-  // }
-}
-
 var pkg = {
 	name: "@talismn/balances",
-	version: "0.0.0-pr2043-20250628151732"};
+	version: "0.0.0-pr2043-20250629051139"};
 
 var log = anylogger__default.default(pkg.name);
 
@@ -430,7 +379,6 @@ class Balance {
     // This means that those rates are always available for calculating the uniswapv2 rates,
     // regardless of whether or not the underlying erc20s are actually in chaindata and enabled.
     if (this.isSource("evm-uniswapv2") && this.token?.type === "evm-uniswapv2" // &&
-    //this.evmNetworkId
     ) {
       const tokenId0 = chaindataProvider.evmErc20TokenId(this.networkId, this.token.tokenAddress0);
       const tokenId1 = chaindataProvider.evmErc20TokenId(this.networkId, this.token.tokenAddress1);
@@ -512,9 +460,7 @@ class Balance {
     const nomPoolStakedPlancks = this.locks.some(lock => lock.source === "substrate-native-holds" && lock.label === "DelegatedStaking") ? 0n : this.nompools.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n);
-    return this.#format(this.free.planck + this.reserved.planck + nomPoolStakedPlancks + this.crowdloans.map(({
-      amount
-    }) => amount.planck).reduce((a, b) => a + b, 0n) + this.subtensor.map(({
+    return this.#format(this.free.planck + this.reserved.planck + nomPoolStakedPlancks + this.subtensor.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n) + includeInTotalExtraAmount(extra));
   }
@@ -550,9 +496,6 @@ class Balance {
   get locks() {
     return this.getValue("locked");
   }
-  get crowdloans() {
-    return this.getValue("crowdloan");
-  }
   get nompools() {
     return this.getValue("nompool");
   }
@@ -631,7 +574,7 @@ class Balance {
     const nomPoolStakedPlancks = this.locks.some(lock => lock.source === "substrate-native-holds" && lock.label === "DelegatedStaking") ? 0n : this.nompools.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n);
-    const otherUnavailable = nomPoolStakedPlancks + this.crowdloans.reduce((total, each) => total + each.amount.planck, 0n) + this.subtensor.reduce((total, each) => total + each.amount.planck, 0n);
+    const otherUnavailable = nomPoolStakedPlancks + this.subtensor.reduce((total, each) => total + each.amount.planck, 0n);
     return this.#format(baseUnavailable + otherUnavailable);
   }
 
@@ -886,21 +829,8 @@ const filterMirrorTokens = (balance, i, balances) => {
 
 /** A collection of `BalanceJson` objects */
 
-// type IBalanceBaseEvm = {
-//   /** WIP, use `chainId` or `evmNetworkId` for now */
-//   multiChainId: EvmChainId
-
-// }
-
-// type IBalanceBaseSubstrate = {
-//   multiChainId: SubChainId
-
-// }
-
 /** `IBalance` is a common interface which all balance types must implement. */
 
-// & (IBalanceBaseEvm | IBalanceBaseSubstrate)
-
 /** An unlabelled amount of a balance */
 
 /** A labelled amount of a balance */
@@ -909,7 +839,6 @@ const getValueId = amount => {
   const getMetaId = () => {
     const meta = amount.meta;
     if (!meta) return "";
-    if (amount.type === "crowdloan") return meta.paraId?.toString() ?? "";
     if (amount.type === "nompool") return meta.poolId?.toString() ?? "";
     if (amount.type === "subtensor") {
       const {
@@ -1315,8 +1244,6 @@ const EvmErc20Module = hydrate => {
      * In a future version of the balance libraries, we may build some kind of async scheduling system which will keep the list of tokens for each chain up to date without relying on a squid.
      */
     async fetchEvmChainTokens(chainId, _chainMeta, moduleConfig, tokens) {
-      //const { isTestnet } = chainMeta
-
       const chainTokens = {};
       for (const tokenConfig of tokens ?? []) {
         const {
@@ -1330,8 +1257,6 @@ const EvmErc20Module = hydrate => {
           log.warn("ignoring token on chain %s", chainId, tokenConfig);
           continue;
         }
-
-        // TODO zodify this
         const symbol = tokenConfig?.symbol ?? contractSymbol ?? "ETH";
         const decimals = typeof tokenConfig?.decimals === "number" ? tokenConfig.decimals : typeof contractDecimals === "number" ? contractDecimals : 18;
         if (!symbol || typeof decimals !== "number") continue;
@@ -1358,7 +1283,6 @@ const EvmErc20Module = hydrate => {
         } else {
           log.warn("Ignoring invalid token", token.id, validation.error.message, validation.error.issues);
         }
-        chainTokens[token.id] = token;
       }
       return chainTokens;
     },
@@ -1632,7 +1556,6 @@ const EvmNativeModule = hydrate => {
      */
     async fetchEvmChainTokens() {
       // token is currently generated in chaindata from the EthNetworkConfig["nativeCurrency"] field
-      // TODO normalise this
       return {};
     },
     async subscribeBalances({
@@ -2378,7 +2301,7 @@ const moduleType$5 = "evm-uniswapv2";
 const EvmUniswapV2TokenConfigSchema = z__default.default.strictObject({
   contractAddress: chaindataProvider.EvmUniswapV2TokenSchema.shape.contractAddress,
   ...TokenConfigBaseSchema.shape,
-  // the ones below are unused and prone to error, feels better to always fetch these from chain
+  // on chaindata side these are fetched by a dedicated task
   symbol0: chaindataProvider.EvmUniswapV2TokenSchema.shape.symbol0.optional(),
   symbol1: chaindataProvider.EvmUniswapV2TokenSchema.shape.symbol1.optional(),
   decimals0: chaindataProvider.EvmUniswapV2TokenSchema.shape.decimals0.optional(),
@@ -2673,7 +2596,7 @@ const fetchSpecVersion = async (chainConnector, networkId) => {
 };
 
 /**
- * fetches the spec version of a network. current request is cached in case of multiple calls (all balance subs kick in at once)
+ * fetches the spec version of a network. current request is cached in case of multiple calls (all balance modules will kick in at once)
  */
 const getSpecVersion = async (chainConnector, networkId) => {
   if (CACHE_GET_SPEC_VERSION.has(networkId)) return CACHE_GET_SPEC_VERSION.get(networkId);
@@ -2757,7 +2680,7 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
       const chain = await chaindataProvider.getNetworkById(chainId, "polkadot");
       const balancesConfig = chain?.balancesConfig?.[mod.type];
       const chainMeta = await mod.fetchSubstrateChainMeta(chainId, balancesConfig,
-      // TODO fix typings
+      // TODO better typing
       metadataRpc);
       return {
         id: deriveMiniMetadataId({
@@ -2775,7 +2698,7 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
       };
     }));
   } finally {
-    log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, performance.now() - start);
+    log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, (performance.now() - start).toFixed(2));
   }
 };
 
@@ -2840,6 +2763,7 @@ async function balances(balanceModule, addressesByToken, callback) {
   return await balanceModule.fetchBalances(addressesByToken);
 }
 
+// TODO remove this one in favor of the network specific one below
 const buildStorageCoders = ({
   chainIds,
   chains,
@@ -3184,7 +3108,6 @@ const SubAssetsModule = hydrate => {
           if (controller.signal.aborted) return () => {};
           const stateHelper = new RpcStateQueryHelper(chainConnector, queries);
           return await stateHelper.subscribe((error, result) => {
-            //  console.log("SubstrateAssetsModule.callback", { error, result })
             if (error) return callback(error);
             const balances = result?.filter(b => b !== null) ?? [];
             if (balances.length > 0) callback(null, new Balances(balances));
@@ -3297,7 +3220,7 @@ async function buildNetworkQueries$2(networkId, chainConnector, chaindataProvide
     }
     return addresses.flatMap(address => {
       const scaleCoder = networkStorageCoders?.storage;
-      const stateKey = tryEncode(scaleCoder, BigInt(token.assetId), address) ?? tryEncode(scaleCoder, Number(token.assetId), address);
+      const stateKey = tryEncode(scaleCoder, Number(token.assetId), address) ?? tryEncode(scaleCoder, BigInt(token.assetId), address);
       if (!stateKey) {
         log.warn(`Invalid assetId / address in ${networkId} storage query ${token.assetId} / ${address}`);
         return [];
@@ -4318,22 +4241,14 @@ const filterBaseLocks = locks => {
 };
 
 // TODO: Make these titles translatable
-const getLockTitle = (lock, {
+const getLockTitle = (lock,
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+{
   balance
 } = {}) => {
   if (!lock.label) return lock.label;
   if (lock.label === "democracy") return "Governance";
-  if (lock.label === "crowdloan") {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const paraId = lock.meta?.paraId;
-    if (!paraId) return "Crowdloan";
-
-    // balance?.network?.parathreads?.find(
-    //   (parathread) => parathread?.paraId === paraId,
-    // )?.name
-
-    return `${`Parachain ${paraId}`} Crowdloan`;
-  }
+  if (lock.label === "crowdloan") return "Crowdloan";
   if (lock.label === "nompools-staking") return "Pooled Staking";
   if (lock.label === "nompools-unbonding") return "Pooled Staking";
   if (lock.label === "subtensor-staking") return "Root Staking";
@@ -4346,10 +4261,6 @@ const getLockTitle = (lock, {
 
 const moduleType$2 = "substrate-native";
 
-//  {
-//   disable?: boolean
-// } & BalancesConfigTokenParams
-
 /**
  * Function to merge two 'sub sources' of the same balance together, or
  * two instances of the same balance with different values.
@@ -4724,8 +4635,6 @@ class QueryCache {
   #chainConnector;
   miniMetadatas = new Map();
   balanceQueryCache = new Map();
-  // private metadataSub: Subscription | null = null
-
   constructor(chaindataProvider, chainConnector) {
     this.chaindataProvider = chaindataProvider;
     this.#chaindataProvider = chaindataProvider;
@@ -4809,13 +4718,13 @@ const DotNetworkPropertiesArray = z__default.default.object({
   tokenDecimals: z__default.default.array(z__default.default.number()).nonempty(),
   tokenSymbol: z__default.default.array(z__default.default.string()).nonempty()
 });
-const DotNetworkProperties = z__default.default.union([DotNetworkPropertiesSimple, DotNetworkPropertiesArray]).transform(val => ({
+const DotNetworkPropertiesSchema = z__default.default.union([DotNetworkPropertiesSimple, DotNetworkPropertiesArray]).transform(val => ({
   tokenDecimals: Array.isArray(val.tokenDecimals) ? val.tokenDecimals[0] : val.tokenDecimals,
   tokenSymbol: Array.isArray(val.tokenSymbol) ? val.tokenSymbol[0] : val.tokenSymbol
 }));
 const getChainProperties = async (chainConnector, networkId) => {
   const properties = await chainConnector.send(networkId, "system_properties", [], true);
-  return DotNetworkProperties.parse(properties);
+  return DotNetworkPropertiesSchema.parse(properties);
 };
 
 const POLLING_WINDOW_SIZE = 20;
@@ -4840,6 +4749,7 @@ const SubNativeModule = hydrate => {
   // subscribeBalances was split by network to prevent all subs to wait for all minimetadatas to be ready.
   // however the multichain logic in there is so deep in the function below that i had to keep it as-is, and call it by per-network chunks
   // TODO refactor this be actually network specific
+  // Note: had to extract this function from the result object or this.subscribeBalances wouldn't be typed correctly
   const subscribeChainBalances = (chainId, opts, callback, signal) => {
     const {
       addressesByToken,
@@ -5041,7 +4951,6 @@ const SubNativeModule = hydrate => {
       };
       const existentialDeposit = getConstantValue("Balances", "ExistentialDeposit")?.toString();
       const nominationPoolsPalletId = getConstantValue("NominationPools", "PalletId")?.asText();
-      const crowdloanPalletId = getConstantValue("Crowdloan", "PalletId")?.asText(); // TODO yeet
       const hasSubtensorPallet = getConstantValue("SubtensorModule", "KeySwapCost") !== undefined;
 
       //
@@ -5061,16 +4970,7 @@ const SubNativeModule = hydrate => {
       }, {
         pallet: "Staking",
         items: ["Ledger"]
-      }, {
-        pallet: "Crowdloan",
-        items: ["Funds"]
-      },
-      // TODO yeet
-      {
-        pallet: "Paras",
-        items: ["Parachains"]
       },
-      // TODO yeet
       // TotalColdkeyStake is used until v.2.2.1, then it is replaced by StakingHotkeys+Stake
       // Need to keep TotalColdkeyStake for a while so chaindata keeps including it in miniMetadatas, so it doesnt break old versions of the wallet
       {
@@ -5096,7 +4996,6 @@ const SubNativeModule = hydrate => {
           useLegacyTransferableCalculation,
           existentialDeposit,
           nominationPoolsPalletId,
-          crowdloanPalletId,
           hasSubtensorPallet
         }
       };
@@ -5147,7 +5046,7 @@ const SubNativeModule = hydrate => {
       const unsubsribeFns = Promise.all(lodash.keys(addressesByTokenByNetwork).map(async networkId => {
         try {
           // this is what we want to be done separately for each network
-          // this will update the DB so minimetadata will be available when it's used, veeeeery far down the tree of subscribeChainBalances
+          // this will update the DB so minimetadata will be available when it's used, everywhere else down the tree of subscribeChainBalances
           await getMiniMetadata(chaindataProvider$1, chainConnector$1, networkId, moduleType$2, controller.signal);
         } catch (err) {
           if (!util.isAbortError(err)) log.warn("Failed to get native token miniMetadata for network", networkId, err);
@@ -6943,7 +6842,6 @@ exports.EvmErc20Module = EvmErc20Module;
 exports.EvmErc20TokenConfigSchema = EvmErc20TokenConfigSchema;
 exports.EvmNativeModule = EvmNativeModule;
 exports.EvmNativeTokenConfigSchema = EvmNativeTokenConfigSchema;
-exports.EvmTokenFetcher = EvmTokenFetcher;
 exports.EvmUniswapV2Module = EvmUniswapV2Module;
 exports.EvmUniswapV2TokenConfigSchema = EvmUniswapV2TokenConfigSchema;
 exports.FiatSumBalancesFormatter = FiatSumBalancesFormatter;

package/dist/talismn-balances.esm.js

@@ -26,8 +26,6 @@ import { u32, Struct, u128 } from 'scale-ts';
 import upperFirst from 'lodash/upperFirst';
 import { Abi } from '@polkadot/api-contract';
 
-// Record<string, unknown> | undefined
-
 // TODO: Document default balances module purpose/usage
 const DefaultBalanceModule = type => ({
   get type() {
@@ -61,58 +59,9 @@ const DefaultBalanceModule = type => ({
 // internal
 //
 
-// TODO yeet ?
-// there is no need to construct a lit of tokens, it's done by∏ chaindata
-
-/**
- * Fetches tokens for EVM networks.
- * @deprecated
- */
-class EvmTokenFetcher {
-  #chaindataProvider;
-  #balanceModules;
-  constructor(chaindataProvider, balanceModules) {
-    this.#chaindataProvider = chaindataProvider;
-    this.#balanceModules = balanceModules;
-  }
-  async update(_evmNetworkIds) {
-    // chaindataProvider's tokens should be in sync already
-    // await this.updateEvmNetworks(evmNetworkIds)
-  }
-
-  // private async updateEvmNetworks(evmNetworkIds: EvmNetworkId[]) {
-  //   // feels unnecessary, chaindataProvider's tokens should be in sync already
-  //   //   const evmNetworks = new Map(
-  //   //     (await this.#chaindataProvider.evmNetworks()).map((evmNetwork) => [
-  //   //       evmNetwork.id,
-  //   //       evmNetwork,
-  //   //     ]),
-  //   //   )
-  //   //   const allEvmTokens: TokenList = {}
-  //   //   const evmNetworkConcurrency = 10
-  //   //   await PromisePool.withConcurrency(evmNetworkConcurrency)
-  //   //     .for(evmNetworkIds)
-  //   //     .process(async (evmNetworkId) => {
-  //   //       const evmNetwork = evmNetworks.get(evmNetworkId)
-  //   //       if (!evmNetwork) return
-  //   //       for (const mod of this.#balanceModules.filter((m) => m.type.startsWith("evm-"))) {
-  //   //         // const balancesConfig = (evmNetwork.balancesConfig ?? []).find(
-  //   //         //   ({ moduleType }) => moduleType === mod.type,
-  //   //         // )
-  //   //         // const moduleConfig = balancesConfig?.moduleConfig ?? {}
-  //   //         // chainMeta arg only needs the isTestnet property, let's save a db roundtrip for now
-  //   //         const isTestnet = evmNetwork.isTestnet ?? false
-  //   //         const tokens = await mod.fetchEvmChainTokens(evmNetworkId, { isTestnet }, moduleConfig)
-  //   //         for (const [tokenId, token] of Object.entries(tokens)) allEvmTokens[tokenId] = token
-  //   //       }
-  //   //     })
-  //   //   await this.#chaindataProvider.updateEvmNetworkTokens(Object.values(allEvmTokens))
-  // }
-}
-
 var pkg = {
 	name: "@talismn/balances",
-	version: "0.0.0-pr2043-20250628151732"};
+	version: "0.0.0-pr2043-20250629051139"};
 
 var log = anylogger(pkg.name);
 
@@ -416,7 +365,6 @@ class Balance {
     // This means that those rates are always available for calculating the uniswapv2 rates,
     // regardless of whether or not the underlying erc20s are actually in chaindata and enabled.
     if (this.isSource("evm-uniswapv2") && this.token?.type === "evm-uniswapv2" // &&
-    //this.evmNetworkId
     ) {
       const tokenId0 = evmErc20TokenId(this.networkId, this.token.tokenAddress0);
       const tokenId1 = evmErc20TokenId(this.networkId, this.token.tokenAddress1);
@@ -498,9 +446,7 @@ class Balance {
     const nomPoolStakedPlancks = this.locks.some(lock => lock.source === "substrate-native-holds" && lock.label === "DelegatedStaking") ? 0n : this.nompools.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n);
-    return this.#format(this.free.planck + this.reserved.planck + nomPoolStakedPlancks + this.crowdloans.map(({
-      amount
-    }) => amount.planck).reduce((a, b) => a + b, 0n) + this.subtensor.map(({
+    return this.#format(this.free.planck + this.reserved.planck + nomPoolStakedPlancks + this.subtensor.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n) + includeInTotalExtraAmount(extra));
   }
@@ -536,9 +482,6 @@ class Balance {
   get locks() {
     return this.getValue("locked");
   }
-  get crowdloans() {
-    return this.getValue("crowdloan");
-  }
   get nompools() {
     return this.getValue("nompool");
   }
@@ -617,7 +560,7 @@ class Balance {
     const nomPoolStakedPlancks = this.locks.some(lock => lock.source === "substrate-native-holds" && lock.label === "DelegatedStaking") ? 0n : this.nompools.map(({
       amount
     }) => amount.planck).reduce((a, b) => a + b, 0n);
-    const otherUnavailable = nomPoolStakedPlancks + this.crowdloans.reduce((total, each) => total + each.amount.planck, 0n) + this.subtensor.reduce((total, each) => total + each.amount.planck, 0n);
+    const otherUnavailable = nomPoolStakedPlancks + this.subtensor.reduce((total, each) => total + each.amount.planck, 0n);
     return this.#format(baseUnavailable + otherUnavailable);
   }
 
@@ -872,21 +815,8 @@ const filterMirrorTokens = (balance, i, balances) => {
 
 /** A collection of `BalanceJson` objects */
 
-// type IBalanceBaseEvm = {
-//   /** WIP, use `chainId` or `evmNetworkId` for now */
-//   multiChainId: EvmChainId
-
-// }
-
-// type IBalanceBaseSubstrate = {
-//   multiChainId: SubChainId
-
-// }
-
 /** `IBalance` is a common interface which all balance types must implement. */
 
-// & (IBalanceBaseEvm | IBalanceBaseSubstrate)
-
 /** An unlabelled amount of a balance */
 
 /** A labelled amount of a balance */
@@ -895,7 +825,6 @@ const getValueId = amount => {
   const getMetaId = () => {
     const meta = amount.meta;
     if (!meta) return "";
-    if (amount.type === "crowdloan") return meta.paraId?.toString() ?? "";
     if (amount.type === "nompool") return meta.poolId?.toString() ?? "";
     if (amount.type === "subtensor") {
       const {
@@ -1301,8 +1230,6 @@ const EvmErc20Module = hydrate => {
      * In a future version of the balance libraries, we may build some kind of async scheduling system which will keep the list of tokens for each chain up to date without relying on a squid.
      */
     async fetchEvmChainTokens(chainId, _chainMeta, moduleConfig, tokens) {
-      //const { isTestnet } = chainMeta
-
       const chainTokens = {};
       for (const tokenConfig of tokens ?? []) {
         const {
@@ -1316,8 +1243,6 @@ const EvmErc20Module = hydrate => {
           log.warn("ignoring token on chain %s", chainId, tokenConfig);
           continue;
         }
-
-        // TODO zodify this
         const symbol = tokenConfig?.symbol ?? contractSymbol ?? "ETH";
         const decimals = typeof tokenConfig?.decimals === "number" ? tokenConfig.decimals : typeof contractDecimals === "number" ? contractDecimals : 18;
         if (!symbol || typeof decimals !== "number") continue;
@@ -1344,7 +1269,6 @@ const EvmErc20Module = hydrate => {
         } else {
           log.warn("Ignoring invalid token", token.id, validation.error.message, validation.error.issues);
         }
-        chainTokens[token.id] = token;
       }
       return chainTokens;
     },
@@ -1618,7 +1542,6 @@ const EvmNativeModule = hydrate => {
      */
     async fetchEvmChainTokens() {
       // token is currently generated in chaindata from the EthNetworkConfig["nativeCurrency"] field
-      // TODO normalise this
       return {};
     },
     async subscribeBalances({
@@ -2364,7 +2287,7 @@ const moduleType$5 = "evm-uniswapv2";
 const EvmUniswapV2TokenConfigSchema = z.strictObject({
   contractAddress: EvmUniswapV2TokenSchema.shape.contractAddress,
   ...TokenConfigBaseSchema.shape,
-  // the ones below are unused and prone to error, feels better to always fetch these from chain
+  // on chaindata side these are fetched by a dedicated task
   symbol0: EvmUniswapV2TokenSchema.shape.symbol0.optional(),
   symbol1: EvmUniswapV2TokenSchema.shape.symbol1.optional(),
   decimals0: EvmUniswapV2TokenSchema.shape.decimals0.optional(),
@@ -2659,7 +2582,7 @@ const fetchSpecVersion = async (chainConnector, networkId) => {
 };
 
 /**
- * fetches the spec version of a network. current request is cached in case of multiple calls (all balance subs kick in at once)
+ * fetches the spec version of a network. current request is cached in case of multiple calls (all balance modules will kick in at once)
  */
 const getSpecVersion = async (chainConnector, networkId) => {
   if (CACHE_GET_SPEC_VERSION.has(networkId)) return CACHE_GET_SPEC_VERSION.get(networkId);
@@ -2743,7 +2666,7 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
       const chain = await chaindataProvider.getNetworkById(chainId, "polkadot");
       const balancesConfig = chain?.balancesConfig?.[mod.type];
       const chainMeta = await mod.fetchSubstrateChainMeta(chainId, balancesConfig,
-      // TODO fix typings
+      // TODO better typing
       metadataRpc);
       return {
         id: deriveMiniMetadataId({
@@ -2761,7 +2684,7 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
       };
     }));
   } finally {
-    log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, performance.now() - start);
+    log.debug("[miniMetadata] updated miniMetadatas for %s in %sms", chainId, (performance.now() - start).toFixed(2));
   }
 };
 
@@ -2826,6 +2749,7 @@ async function balances(balanceModule, addressesByToken, callback) {
   return await balanceModule.fetchBalances(addressesByToken);
 }
 
+// TODO remove this one in favor of the network specific one below
 const buildStorageCoders = ({
   chainIds,
   chains,
@@ -3170,7 +3094,6 @@ const SubAssetsModule = hydrate => {
           if (controller.signal.aborted) return () => {};
           const stateHelper = new RpcStateQueryHelper(chainConnector, queries);
           return await stateHelper.subscribe((error, result) => {
-            //  console.log("SubstrateAssetsModule.callback", { error, result })
             if (error) return callback(error);
             const balances = result?.filter(b => b !== null) ?? [];
             if (balances.length > 0) callback(null, new Balances(balances));
@@ -3283,7 +3206,7 @@ async function buildNetworkQueries$2(networkId, chainConnector, chaindataProvide
     }
     return addresses.flatMap(address => {
       const scaleCoder = networkStorageCoders?.storage;
-      const stateKey = tryEncode(scaleCoder, BigInt(token.assetId), address) ?? tryEncode(scaleCoder, Number(token.assetId), address);
+      const stateKey = tryEncode(scaleCoder, Number(token.assetId), address) ?? tryEncode(scaleCoder, BigInt(token.assetId), address);
       if (!stateKey) {
         log.warn(`Invalid assetId / address in ${networkId} storage query ${token.assetId} / ${address}`);
         return [];
@@ -4304,22 +4227,14 @@ const filterBaseLocks = locks => {
 };
 
 // TODO: Make these titles translatable
-const getLockTitle = (lock, {
+const getLockTitle = (lock,
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+{
   balance
 } = {}) => {
   if (!lock.label) return lock.label;
   if (lock.label === "democracy") return "Governance";
-  if (lock.label === "crowdloan") {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const paraId = lock.meta?.paraId;
-    if (!paraId) return "Crowdloan";
-
-    // balance?.network?.parathreads?.find(
-    //   (parathread) => parathread?.paraId === paraId,
-    // )?.name
-
-    return `${`Parachain ${paraId}`} Crowdloan`;
-  }
+  if (lock.label === "crowdloan") return "Crowdloan";
   if (lock.label === "nompools-staking") return "Pooled Staking";
   if (lock.label === "nompools-unbonding") return "Pooled Staking";
   if (lock.label === "subtensor-staking") return "Root Staking";
@@ -4332,10 +4247,6 @@ const getLockTitle = (lock, {
 
 const moduleType$2 = "substrate-native";
 
-//  {
-//   disable?: boolean
-// } & BalancesConfigTokenParams
-
 /**
  * Function to merge two 'sub sources' of the same balance together, or
  * two instances of the same balance with different values.
@@ -4710,8 +4621,6 @@ class QueryCache {
   #chainConnector;
   miniMetadatas = new Map();
   balanceQueryCache = new Map();
-  // private metadataSub: Subscription | null = null
-
   constructor(chaindataProvider, chainConnector) {
     this.chaindataProvider = chaindataProvider;
     this.#chaindataProvider = chaindataProvider;
@@ -4795,13 +4704,13 @@ const DotNetworkPropertiesArray = z.object({
   tokenDecimals: z.array(z.number()).nonempty(),
   tokenSymbol: z.array(z.string()).nonempty()
 });
-const DotNetworkProperties = z.union([DotNetworkPropertiesSimple, DotNetworkPropertiesArray]).transform(val => ({
+const DotNetworkPropertiesSchema = z.union([DotNetworkPropertiesSimple, DotNetworkPropertiesArray]).transform(val => ({
   tokenDecimals: Array.isArray(val.tokenDecimals) ? val.tokenDecimals[0] : val.tokenDecimals,
   tokenSymbol: Array.isArray(val.tokenSymbol) ? val.tokenSymbol[0] : val.tokenSymbol
 }));
 const getChainProperties = async (chainConnector, networkId) => {
   const properties = await chainConnector.send(networkId, "system_properties", [], true);
-  return DotNetworkProperties.parse(properties);
+  return DotNetworkPropertiesSchema.parse(properties);
 };
 
 const POLLING_WINDOW_SIZE = 20;
@@ -4826,6 +4735,7 @@ const SubNativeModule = hydrate => {
   // subscribeBalances was split by network to prevent all subs to wait for all minimetadatas to be ready.
   // however the multichain logic in there is so deep in the function below that i had to keep it as-is, and call it by per-network chunks
   // TODO refactor this be actually network specific
+  // Note: had to extract this function from the result object or this.subscribeBalances wouldn't be typed correctly
   const subscribeChainBalances = (chainId, opts, callback, signal) => {
     const {
       addressesByToken,
@@ -5027,7 +4937,6 @@ const SubNativeModule = hydrate => {
       };
       const existentialDeposit = getConstantValue("Balances", "ExistentialDeposit")?.toString();
       const nominationPoolsPalletId = getConstantValue("NominationPools", "PalletId")?.asText();
-      const crowdloanPalletId = getConstantValue("Crowdloan", "PalletId")?.asText(); // TODO yeet
       const hasSubtensorPallet = getConstantValue("SubtensorModule", "KeySwapCost") !== undefined;
 
       //
@@ -5047,16 +4956,7 @@ const SubNativeModule = hydrate => {
       }, {
         pallet: "Staking",
         items: ["Ledger"]
-      }, {
-        pallet: "Crowdloan",
-        items: ["Funds"]
-      },
-      // TODO yeet
-      {
-        pallet: "Paras",
-        items: ["Parachains"]
       },
-      // TODO yeet
       // TotalColdkeyStake is used until v.2.2.1, then it is replaced by StakingHotkeys+Stake
       // Need to keep TotalColdkeyStake for a while so chaindata keeps including it in miniMetadatas, so it doesnt break old versions of the wallet
       {
@@ -5082,7 +4982,6 @@ const SubNativeModule = hydrate => {
           useLegacyTransferableCalculation,
           existentialDeposit,
           nominationPoolsPalletId,
-          crowdloanPalletId,
           hasSubtensorPallet
         }
       };
@@ -5133,7 +5032,7 @@ const SubNativeModule = hydrate => {
       const unsubsribeFns = Promise.all(keys(addressesByTokenByNetwork).map(async networkId => {
         try {
           // this is what we want to be done separately for each network
-          // this will update the DB so minimetadata will be available when it's used, veeeeery far down the tree of subscribeChainBalances
+          // this will update the DB so minimetadata will be available when it's used, everywhere else down the tree of subscribeChainBalances
           await getMiniMetadata(chaindataProvider, chainConnector, networkId, moduleType$2, controller.signal);
         } catch (err) {
           if (!isAbortError(err)) log.warn("Failed to get native token miniMetadata for network", networkId, err);
@@ -6919,4 +6818,4 @@ async function buildQueries(chainConnector, chaindataProvider, addressesByToken,
 
 const defaultBalanceModules = [EvmErc20Module, EvmNativeModule, EvmUniswapV2Module, SubAssetsModule, SubForeignAssetsModule, SubNativeModule, SubPsp22Module, SubTokensModule];
 
-export { Balance, BalanceFormatter, BalanceValueGetter, Balances, Change24hCurrencyFormatter, DefaultBalanceModule, EvmErc20Module, EvmErc20TokenConfigSchema, EvmNativeModule, EvmNativeTokenConfigSchema, EvmTokenFetcher, EvmUniswapV2Module, EvmUniswapV2TokenConfigSchema, FiatSumBalancesFormatter, ONE_ALPHA_TOKEN, PlanckSumBalancesFormatter, RpcStateQueryHelper, SCALE_FACTOR, SUBTENSOR_MIN_STAKE_AMOUNT_PLANK, SUBTENSOR_ROOT_NETUID, SubAssetsModule, SubAssetsTokenConfigSchema, SubForeignAssetsModule, SubForeignAssetsTokenConfigSchema, SubNativeModule, SubNativeTokenConfigSchema, SubPsp22Module, SubPsp22TokenConfigSchema, SubTokensModule, SubTokensTokenConfigSchema, SumBalancesFormatter, TalismanBalancesDatabase, abiMulticall, balances, buildNetworkStorageCoders, buildStorageCoders, calculateAlphaPrice, calculateTaoAmountFromAlpha, calculateTaoFromDynamicInfo, compress, configureStore, db, decodeOutput, decompress, defaultBalanceModules, deriveMiniMetadataId, detectTransferMethod, erc20Abi, erc20BalancesAggregatorAbi, excludeFromFeePayableLocks, excludeFromTransferableAmount, filterBaseLocks, filterMirrorTokens, getBalanceId, getLockTitle, getUniqueChainIds, getValueId, includeInTotalExtraAmount, makeContractCaller, uniswapV2PairAbi };
+export { Balance, BalanceFormatter, BalanceValueGetter, Balances, Change24hCurrencyFormatter, DefaultBalanceModule, EvmErc20Module, EvmErc20TokenConfigSchema, EvmNativeModule, EvmNativeTokenConfigSchema, EvmUniswapV2Module, EvmUniswapV2TokenConfigSchema, FiatSumBalancesFormatter, ONE_ALPHA_TOKEN, PlanckSumBalancesFormatter, RpcStateQueryHelper, SCALE_FACTOR, SUBTENSOR_MIN_STAKE_AMOUNT_PLANK, SUBTENSOR_ROOT_NETUID, SubAssetsModule, SubAssetsTokenConfigSchema, SubForeignAssetsModule, SubForeignAssetsTokenConfigSchema, SubNativeModule, SubNativeTokenConfigSchema, SubPsp22Module, SubPsp22TokenConfigSchema, SubTokensModule, SubTokensTokenConfigSchema, SumBalancesFormatter, TalismanBalancesDatabase, abiMulticall, balances, buildNetworkStorageCoders, buildStorageCoders, calculateAlphaPrice, calculateTaoAmountFromAlpha, calculateTaoFromDynamicInfo, compress, configureStore, db, decodeOutput, decompress, defaultBalanceModules, deriveMiniMetadataId, detectTransferMethod, erc20Abi, erc20BalancesAggregatorAbi, excludeFromFeePayableLocks, excludeFromTransferableAmount, filterBaseLocks, filterMirrorTokens, getBalanceId, getLockTitle, getUniqueChainIds, getValueId, includeInTotalExtraAmount, makeContractCaller, uniswapV2PairAbi };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talismn/balances",
-  "version": "0.0.0-pr2043-20250628151732",
+  "version": "0.0.0-pr2043-20250629051139",
   "author": "Talisman",
   "homepage": "https://talisman.xyz",
   "license": "GPL-3.0-or-later",
@@ -35,13 +35,13 @@
     "scale-ts": "^1.6.1",
     "viem": "^2.27.3",
     "zod": "^3.25.62",
-    "@talismn/chain-connector": "0.0.0-pr2043-20250628151732",
-    "@talismn/chain-connector-evm": "0.0.0-pr2043-20250628151732",
-    "@talismn/chaindata-provider": "0.0.0-pr2043-20250628151732",
-    "@talismn/sapi": "0.0.0-pr2043-20250628151732",
+    "@talismn/chain-connector-evm": "0.0.0-pr2043-20250629051139",
+    "@talismn/chaindata-provider": "0.0.0-pr2043-20250629051139",
+    "@talismn/sapi": "0.0.0-pr2043-20250629051139",
     "@talismn/scale": "0.1.2",
-    "@talismn/token-rates": "0.0.0-pr2043-20250628151732",
-    "@talismn/util": "0.0.0-pr2043-20250628151732"
+    "@talismn/token-rates": "0.0.0-pr2043-20250629051139",
+    "@talismn/util": "0.0.0-pr2043-20250629051139",
+    "@talismn/chain-connector": "0.0.0-pr2043-20250629051139"
   },
   "devDependencies": {
     "@polkadot/api-contract": "16.1.2",

package/dist/declarations/src/EvmTokenFetcher.d.ts

@@ -1,11 +0,0 @@
-import { ChaindataProvider, EvmNetworkId } from "@talismn/chaindata-provider";
-import { AnyBalanceModule } from "./modules/util";
-/**
- * Fetches tokens for EVM networks.
- * @deprecated
- */
-export declare class EvmTokenFetcher {
-    #private;
-    constructor(chaindataProvider: ChaindataProvider, balanceModules: Array<AnyBalanceModule>);
-    update(_evmNetworkIds: EvmNetworkId[]): Promise<void>;
-}