@talismn/balances 0.0.0-pr2075-20250711045153 → 0.0.0-pr2075-20250711073805

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

@@ -20,6 +20,7 @@ export declare class BalancesProvider {
     fetchBalances(addressesByTokenId: Record<TokenId, Address[]>): Promise<IBalance[]>;
     private getNetworkBalances$;
     private getNetworkMiniMetadatas$;
+    private getNetworkSpecVersion$;
     private getMiniMetadatas$;
     private getStoredMiniMetadatas$;
     private getDefaultMiniMetadatas$;

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

@@ -5,3 +5,8 @@ export type BalanceDef<T extends TokenType = TokenType> = {
     address: TokenPlatform<T> extends "ethereum" ? `0x${string}` : string;
 };
 export declare const getBalanceDefs: <T extends TokenType = TokenType>(addressesByToken: TokensWithAddresses) => BalanceDef<T>[];
+export type QueryStorageChange = [stateKey: `0x${string}`, value: `0x${string}`];
+export type QueryStorageResult = [{
+    block: `0x${string}`;
+    changes: QueryStorageChange[];
+}] | [];

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

@@ -621,6 +621,10 @@ const getBalanceDefs = addressesByToken => {
   })));
 };
 
+// esponse of getStorageAt queries:
+// if there is at least one storage entry, the results will be an array with a single object
+// if the storage has no entries in it (ex: Assets on ewx or moonbeam), the response will be an empty array
+
 const fetchBalances$8 = async ({
   networkId,
   tokensWithAddresses,
@@ -1502,7 +1506,7 @@ const decodeRpcQueryPack = (queries, result) => {
     decodeResult
   }) => {
     const changes = stateKeys.map(stateKey => {
-      if (!stateKey) return null;
+      if (!stateKey || !result) return null;
       const change = result.changes.find(([key]) => key === stateKey);
       if (!change) return null;
       return change[1];
@@ -1750,8 +1754,8 @@ const fetchTokens$5 = async ({
   const metadataCodec = builder.buildStorage("Assets", "Metadata");
   const [allAssetStorageKeys, allMetadataStorageKeys] = await Promise.all([connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("Assets", "Asset")]), connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("Assets", "Metadata")])]);
   const [assetStorageResults, metadataStorageResults] = await Promise.all([connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]), connector.send(networkId, "state_queryStorageAt", [allMetadataStorageKeys])]);
-  const assetStorageEntries = assetStorageResults[0].changes;
-  const metadataStorageEntries = metadataStorageResults[0].changes;
+  const assetStorageEntries = assetStorageResults.length ? assetStorageResults[0].changes : [];
+  const metadataStorageEntries = metadataStorageResults.length ? metadataStorageResults[0].changes : [];
   const assetByAssetId = lodashEs.keyBy(assetStorageEntries.map(([key, value]) => {
     const [assetId] = assetCodec.keys.dec(key);
     const asset = assetCodec.value.dec(value);
@@ -2899,8 +2903,11 @@ const fetchTokens$4 = async ({
   const metadataCodec = builder.buildStorage("ForeignAssets", "Metadata");
   const [allAssetStorageKeys, allMetadataStorageKeys] = await Promise.all([connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("ForeignAssets", "Asset")]), connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("ForeignAssets", "Metadata")])]);
   const [assetStorageResults, metadataStorageResults] = await Promise.all([connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]), connector.send(networkId, "state_queryStorageAt", [allMetadataStorageKeys])]);
-  const assetStorageEntries = assetStorageResults[0].changes;
-  const metadataStorageEntries = metadataStorageResults[0].changes;
+
+  // if there is at least one storage entry, the results will be an array with a single object
+  // some networks avec the pallet with no tokens in it, in which case the response will be an empty array
+  const assetStorageEntries = assetStorageResults[0]?.changes ?? [];
+  const metadataStorageEntries = metadataStorageResults[0]?.changes ?? [];
   const assetByOnChainId = lodashEs.keyBy(assetStorageEntries.map(([key, value]) => {
     const [decodedKey] = assetCodec.keys.dec(key);
     const onChainId = scale.papiStringify(decodedKey);
@@ -3241,7 +3248,7 @@ const fetchTokens$3 = async ({
   const assetsCodec = builder.buildStorage("AssetRegistry", "Assets");
   const allAssetStorageKeys = await connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("AssetRegistry", "Assets")]);
   const assetStorageResults = await connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]);
-  const assetStorageEntries = assetStorageResults[0].changes;
+  const assetStorageEntries = assetStorageResults.length ? assetStorageResults[0].changes : [];
   const configTokenByAssetId = lodashEs.keyBy(tokens, t => t.onChainId);
   return assetStorageEntries.map(([key, value]) => {
     // parse results
@@ -6328,7 +6335,9 @@ class BalancesProvider {
                   networkId,
                   tokensWithAddresses,
                   connector: this.#chainConnectors.evm
-                }).pipe(rxjs.map(results => ({
+                }).pipe(rxjs.catchError(() => rxjs.EMPTY),
+                // don't emit, let provider mark balances stale
+                rxjs.map(results => ({
                   status: "live",
                   // exclude zero balances
                   balances: results.success.filter(b => new Balance(b).total.planck > 0n)
@@ -6344,7 +6353,9 @@ class BalancesProvider {
                 tokensWithAddresses,
                 connector: this.#chainConnectors.substrate,
                 miniMetadata: miniMetadata
-              }).pipe(rxjs.map(results => ({
+              }).pipe(rxjs.catchError(() => rxjs.EMPTY),
+              // don't emit, let provider mark balances stale
+              rxjs.map(results => ({
                 status: "live",
                 // exclude zero balances
                 balances: results.success.filter(b => new Balance(b).total.planck > 0n)
@@ -6371,7 +6382,20 @@ class BalancesProvider {
     });
   }
   getNetworkMiniMetadatas$(networkId) {
-    return this.#chaindataProvider.getNetworkById$(networkId).pipe(rxjs.switchMap(network => chaindataProvider.isNetworkDot(network) && this.#chainConnectors.substrate ? rxjs.from(getSpecVersion(this.#chainConnectors.substrate, networkId)).pipe(rxjs.switchMap(specVersion => this.getMiniMetadatas$(networkId, specVersion))) : rxjs.of([])));
+    return this.#chaindataProvider.getNetworkById$(networkId).pipe(rxjs.switchMap(network => chaindataProvider.isNetworkDot(network) ? this.getNetworkSpecVersion$(networkId).pipe(rxjs.switchMap(specVersion => specVersion === null ? rxjs.of([]) : this.getMiniMetadatas$(networkId, specVersion))) : rxjs.of([])));
+  }
+  getNetworkSpecVersion$(networkId) {
+    return rxjs.from(viem.withRetry(async () => {
+      if (!this.#chainConnectors.substrate) return null;
+      return await getSpecVersion(this.#chainConnectors.substrate, networkId);
+    }, {
+      delay: 2_000
+    })).pipe(rxjs.catchError(() => {
+      log.warn("Failed to fetch spec version for network", {
+        networkId
+      });
+      return rxjs.of(null);
+    }));
   }
   getMiniMetadatas$(networkId, specVersion) {
     const miniMetadataIds = BALANCE_MODULES.filter(mod => mod.platform === "polkadot").map(mod => deriveMiniMetadataId({

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

@@ -621,6 +621,10 @@ const getBalanceDefs = addressesByToken => {
   })));
 };
 
+// esponse of getStorageAt queries:
+// if there is at least one storage entry, the results will be an array with a single object
+// if the storage has no entries in it (ex: Assets on ewx or moonbeam), the response will be an empty array
+
 const fetchBalances$8 = async ({
   networkId,
   tokensWithAddresses,
@@ -1502,7 +1506,7 @@ const decodeRpcQueryPack = (queries, result) => {
     decodeResult
   }) => {
     const changes = stateKeys.map(stateKey => {
-      if (!stateKey) return null;
+      if (!stateKey || !result) return null;
       const change = result.changes.find(([key]) => key === stateKey);
       if (!change) return null;
       return change[1];
@@ -1750,8 +1754,8 @@ const fetchTokens$5 = async ({
   const metadataCodec = builder.buildStorage("Assets", "Metadata");
   const [allAssetStorageKeys, allMetadataStorageKeys] = await Promise.all([connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("Assets", "Asset")]), connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("Assets", "Metadata")])]);
   const [assetStorageResults, metadataStorageResults] = await Promise.all([connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]), connector.send(networkId, "state_queryStorageAt", [allMetadataStorageKeys])]);
-  const assetStorageEntries = assetStorageResults[0].changes;
-  const metadataStorageEntries = metadataStorageResults[0].changes;
+  const assetStorageEntries = assetStorageResults.length ? assetStorageResults[0].changes : [];
+  const metadataStorageEntries = metadataStorageResults.length ? metadataStorageResults[0].changes : [];
   const assetByAssetId = lodashEs.keyBy(assetStorageEntries.map(([key, value]) => {
     const [assetId] = assetCodec.keys.dec(key);
     const asset = assetCodec.value.dec(value);
@@ -2899,8 +2903,11 @@ const fetchTokens$4 = async ({
   const metadataCodec = builder.buildStorage("ForeignAssets", "Metadata");
   const [allAssetStorageKeys, allMetadataStorageKeys] = await Promise.all([connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("ForeignAssets", "Asset")]), connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("ForeignAssets", "Metadata")])]);
   const [assetStorageResults, metadataStorageResults] = await Promise.all([connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]), connector.send(networkId, "state_queryStorageAt", [allMetadataStorageKeys])]);
-  const assetStorageEntries = assetStorageResults[0].changes;
-  const metadataStorageEntries = metadataStorageResults[0].changes;
+
+  // if there is at least one storage entry, the results will be an array with a single object
+  // some networks avec the pallet with no tokens in it, in which case the response will be an empty array
+  const assetStorageEntries = assetStorageResults[0]?.changes ?? [];
+  const metadataStorageEntries = metadataStorageResults[0]?.changes ?? [];
   const assetByOnChainId = lodashEs.keyBy(assetStorageEntries.map(([key, value]) => {
     const [decodedKey] = assetCodec.keys.dec(key);
     const onChainId = scale.papiStringify(decodedKey);
@@ -3241,7 +3248,7 @@ const fetchTokens$3 = async ({
   const assetsCodec = builder.buildStorage("AssetRegistry", "Assets");
   const allAssetStorageKeys = await connector.send(networkId, "state_getKeys", [scale.getStorageKeyPrefix("AssetRegistry", "Assets")]);
   const assetStorageResults = await connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]);
-  const assetStorageEntries = assetStorageResults[0].changes;
+  const assetStorageEntries = assetStorageResults.length ? assetStorageResults[0].changes : [];
   const configTokenByAssetId = lodashEs.keyBy(tokens, t => t.onChainId);
   return assetStorageEntries.map(([key, value]) => {
     // parse results
@@ -6328,7 +6335,9 @@ class BalancesProvider {
                   networkId,
                   tokensWithAddresses,
                   connector: this.#chainConnectors.evm
-                }).pipe(rxjs.map(results => ({
+                }).pipe(rxjs.catchError(() => rxjs.EMPTY),
+                // don't emit, let provider mark balances stale
+                rxjs.map(results => ({
                   status: "live",
                   // exclude zero balances
                   balances: results.success.filter(b => new Balance(b).total.planck > 0n)
@@ -6344,7 +6353,9 @@ class BalancesProvider {
                 tokensWithAddresses,
                 connector: this.#chainConnectors.substrate,
                 miniMetadata: miniMetadata
-              }).pipe(rxjs.map(results => ({
+              }).pipe(rxjs.catchError(() => rxjs.EMPTY),
+              // don't emit, let provider mark balances stale
+              rxjs.map(results => ({
                 status: "live",
                 // exclude zero balances
                 balances: results.success.filter(b => new Balance(b).total.planck > 0n)
@@ -6371,7 +6382,20 @@ class BalancesProvider {
     });
   }
   getNetworkMiniMetadatas$(networkId) {
-    return this.#chaindataProvider.getNetworkById$(networkId).pipe(rxjs.switchMap(network => chaindataProvider.isNetworkDot(network) && this.#chainConnectors.substrate ? rxjs.from(getSpecVersion(this.#chainConnectors.substrate, networkId)).pipe(rxjs.switchMap(specVersion => this.getMiniMetadatas$(networkId, specVersion))) : rxjs.of([])));
+    return this.#chaindataProvider.getNetworkById$(networkId).pipe(rxjs.switchMap(network => chaindataProvider.isNetworkDot(network) ? this.getNetworkSpecVersion$(networkId).pipe(rxjs.switchMap(specVersion => specVersion === null ? rxjs.of([]) : this.getMiniMetadatas$(networkId, specVersion))) : rxjs.of([])));
+  }
+  getNetworkSpecVersion$(networkId) {
+    return rxjs.from(viem.withRetry(async () => {
+      if (!this.#chainConnectors.substrate) return null;
+      return await getSpecVersion(this.#chainConnectors.substrate, networkId);
+    }, {
+      delay: 2_000
+    })).pipe(rxjs.catchError(() => {
+      log.warn("Failed to fetch spec version for network", {
+        networkId
+      });
+      return rxjs.of(null);
+    }));
   }
   getMiniMetadatas$(networkId, specVersion) {
     const miniMetadataIds = BALANCE_MODULES.filter(mod => mod.platform === "polkadot").map(mod => deriveMiniMetadataId({

package/dist/talismn-balances.esm.js

@@ -5,7 +5,7 @@ import { parseAbi, erc20Abi, getContract, ContractFunctionExecutionError, hexToS
 import { assign, omit, isEqual, keyBy, keys, uniq, fromPairs, values, toPairs } from 'lodash-es';
 import z from 'zod/v4';
 import anylogger from 'anylogger';
-import { of, Observable, distinctUntilChanged, map, timer, switchMap, from, firstValueFrom, combineLatest, BehaviorSubject, shareReplay, startWith, filter, tap } from 'rxjs';
+import { of, Observable, distinctUntilChanged, map, timer, switchMap, from, firstValueFrom, combineLatest, BehaviorSubject, shareReplay, startWith, filter, catchError, EMPTY, tap } from 'rxjs';
 import { parseMetadataRpc, toHex, unifyMetadata, decAnyMetadata, getDynamicBuilder, getLookupFn, decodeScale, getStorageKeyPrefix, Twox128, compactMetadata, encodeMetadata, papiParse, papiStringify } from '@talismn/scale';
 import { newTokenRates } from '@talismn/token-rates';
 import BigNumber from 'bignumber.js';
@@ -612,6 +612,10 @@ const getBalanceDefs = addressesByToken => {
   })));
 };
 
+// esponse of getStorageAt queries:
+// if there is at least one storage entry, the results will be an array with a single object
+// if the storage has no entries in it (ex: Assets on ewx or moonbeam), the response will be an empty array
+
 const fetchBalances$8 = async ({
   networkId,
   tokensWithAddresses,
@@ -1493,7 +1497,7 @@ const decodeRpcQueryPack = (queries, result) => {
     decodeResult
   }) => {
     const changes = stateKeys.map(stateKey => {
-      if (!stateKey) return null;
+      if (!stateKey || !result) return null;
       const change = result.changes.find(([key]) => key === stateKey);
       if (!change) return null;
       return change[1];
@@ -1741,8 +1745,8 @@ const fetchTokens$5 = async ({
   const metadataCodec = builder.buildStorage("Assets", "Metadata");
   const [allAssetStorageKeys, allMetadataStorageKeys] = await Promise.all([connector.send(networkId, "state_getKeys", [getStorageKeyPrefix("Assets", "Asset")]), connector.send(networkId, "state_getKeys", [getStorageKeyPrefix("Assets", "Metadata")])]);
   const [assetStorageResults, metadataStorageResults] = await Promise.all([connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]), connector.send(networkId, "state_queryStorageAt", [allMetadataStorageKeys])]);
-  const assetStorageEntries = assetStorageResults[0].changes;
-  const metadataStorageEntries = metadataStorageResults[0].changes;
+  const assetStorageEntries = assetStorageResults.length ? assetStorageResults[0].changes : [];
+  const metadataStorageEntries = metadataStorageResults.length ? metadataStorageResults[0].changes : [];
   const assetByAssetId = keyBy(assetStorageEntries.map(([key, value]) => {
     const [assetId] = assetCodec.keys.dec(key);
     const asset = assetCodec.value.dec(value);
@@ -2890,8 +2894,11 @@ const fetchTokens$4 = async ({
   const metadataCodec = builder.buildStorage("ForeignAssets", "Metadata");
   const [allAssetStorageKeys, allMetadataStorageKeys] = await Promise.all([connector.send(networkId, "state_getKeys", [getStorageKeyPrefix("ForeignAssets", "Asset")]), connector.send(networkId, "state_getKeys", [getStorageKeyPrefix("ForeignAssets", "Metadata")])]);
   const [assetStorageResults, metadataStorageResults] = await Promise.all([connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]), connector.send(networkId, "state_queryStorageAt", [allMetadataStorageKeys])]);
-  const assetStorageEntries = assetStorageResults[0].changes;
-  const metadataStorageEntries = metadataStorageResults[0].changes;
+
+  // if there is at least one storage entry, the results will be an array with a single object
+  // some networks avec the pallet with no tokens in it, in which case the response will be an empty array
+  const assetStorageEntries = assetStorageResults[0]?.changes ?? [];
+  const metadataStorageEntries = metadataStorageResults[0]?.changes ?? [];
   const assetByOnChainId = keyBy(assetStorageEntries.map(([key, value]) => {
     const [decodedKey] = assetCodec.keys.dec(key);
     const onChainId = papiStringify(decodedKey);
@@ -3232,7 +3239,7 @@ const fetchTokens$3 = async ({
   const assetsCodec = builder.buildStorage("AssetRegistry", "Assets");
   const allAssetStorageKeys = await connector.send(networkId, "state_getKeys", [getStorageKeyPrefix("AssetRegistry", "Assets")]);
   const assetStorageResults = await connector.send(networkId, "state_queryStorageAt", [allAssetStorageKeys]);
-  const assetStorageEntries = assetStorageResults[0].changes;
+  const assetStorageEntries = assetStorageResults.length ? assetStorageResults[0].changes : [];
   const configTokenByAssetId = keyBy(tokens, t => t.onChainId);
   return assetStorageEntries.map(([key, value]) => {
     // parse results
@@ -6319,7 +6326,9 @@ class BalancesProvider {
                   networkId,
                   tokensWithAddresses,
                   connector: this.#chainConnectors.evm
-                }).pipe(map(results => ({
+                }).pipe(catchError(() => EMPTY),
+                // don't emit, let provider mark balances stale
+                map(results => ({
                   status: "live",
                   // exclude zero balances
                   balances: results.success.filter(b => new Balance(b).total.planck > 0n)
@@ -6335,7 +6344,9 @@ class BalancesProvider {
                 tokensWithAddresses,
                 connector: this.#chainConnectors.substrate,
                 miniMetadata: miniMetadata
-              }).pipe(map(results => ({
+              }).pipe(catchError(() => EMPTY),
+              // don't emit, let provider mark balances stale
+              map(results => ({
                 status: "live",
                 // exclude zero balances
                 balances: results.success.filter(b => new Balance(b).total.planck > 0n)
@@ -6362,7 +6373,20 @@ class BalancesProvider {
     });
   }
   getNetworkMiniMetadatas$(networkId) {
-    return this.#chaindataProvider.getNetworkById$(networkId).pipe(switchMap(network => isNetworkDot(network) && this.#chainConnectors.substrate ? from(getSpecVersion(this.#chainConnectors.substrate, networkId)).pipe(switchMap(specVersion => this.getMiniMetadatas$(networkId, specVersion))) : of([])));
+    return this.#chaindataProvider.getNetworkById$(networkId).pipe(switchMap(network => isNetworkDot(network) ? this.getNetworkSpecVersion$(networkId).pipe(switchMap(specVersion => specVersion === null ? of([]) : this.getMiniMetadatas$(networkId, specVersion))) : of([])));
+  }
+  getNetworkSpecVersion$(networkId) {
+    return from(withRetry(async () => {
+      if (!this.#chainConnectors.substrate) return null;
+      return await getSpecVersion(this.#chainConnectors.substrate, networkId);
+    }, {
+      delay: 2_000
+    })).pipe(catchError(() => {
+      log.warn("Failed to fetch spec version for network", {
+        networkId
+      });
+      return of(null);
+    }));
   }
   getMiniMetadatas$(networkId, specVersion) {
     const miniMetadataIds = BALANCE_MODULES.filter(mod => mod.platform === "polkadot").map(mod => deriveMiniMetadataId({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talismn/balances",
-  "version": "0.0.0-pr2075-20250711045153",
+  "version": "0.0.0-pr2075-20250711073805",
   "author": "Talisman",
   "homepage": "https://talisman.xyz",
   "license": "GPL-3.0-or-later",
@@ -34,13 +34,13 @@
     "scale-ts": "^1.6.1",
     "viem": "^2.27.3",
     "zod": "^3.25.62",
-    "@talismn/chain-connector": "0.0.0-pr2075-20250711045153",
-    "@talismn/chain-connector-evm": "0.0.0-pr2075-20250711045153",
-    "@talismn/chaindata-provider": "0.0.0-pr2075-20250711045153",
-    "@talismn/sapi": "0.0.0-pr2075-20250711045153",
-    "@talismn/scale": "0.0.0-pr2075-20250711045153",
-    "@talismn/token-rates": "0.0.0-pr2075-20250711045153",
-    "@talismn/util": "0.0.0-pr2075-20250711045153"
+    "@talismn/chain-connector": "0.0.0-pr2075-20250711073805",
+    "@talismn/chain-connector-evm": "0.0.0-pr2075-20250711073805",
+    "@talismn/scale": "0.0.0-pr2075-20250711073805",
+    "@talismn/sapi": "0.0.0-pr2075-20250711073805",
+    "@talismn/chaindata-provider": "0.0.0-pr2075-20250711073805",
+    "@talismn/token-rates": "0.0.0-pr2075-20250711073805",
+    "@talismn/util": "0.0.0-pr2075-20250711073805"
   },
   "devDependencies": {
     "@polkadot/api-contract": "16.1.2",
@@ -55,8 +55,8 @@
     "jest": "^29.7.0",
     "ts-jest": "^29.2.5",
     "typescript": "^5.6.3",
-    "@talismn/tsconfig": "0.0.2",
-    "@talismn/eslint-config": "0.0.3"
+    "@talismn/eslint-config": "0.0.3",
+    "@talismn/tsconfig": "0.0.2"
   },
   "peerDependencies": {
     "@polkadot/api-contract": "*",