@talismn/balances 3.0.6 → 3.1.1

package/dist/index.js

@@ -45,10 +45,10 @@ let _metaplex_foundation_umi = require("@metaplex-foundation/umi");
 let _solana_program_token_2022 = require("@solana-program/token-2022");
 let _polkadot_api_substrate_bindings = require("@polkadot-api/substrate-bindings");
 let _polkadot_api_utils = require("@polkadot-api/utils");
+let _talismn_sapi = require("@talismn/sapi");
 let lodash_es_upperFirst = require("lodash-es/upperFirst");
 lodash_es_upperFirst = __toESM(lodash_es_upperFirst);
 let scale_ts = require("scale-ts");
-let _talismn_sapi = require("@talismn/sapi");
 //#region src/configureBigNumber.ts
 bignumber_js.default.set({ STRICT: false });
 var configureBigNumber_default = bignumber_js.default;
@@ -443,7 +443,7 @@ var Balance = class {
 	}
 	/** The frozen balance of this token. Is included in the free amount. */
 	get locked() {
-		if (this.#cachedLocked === void 0) this.#cachedLocked = this.#format(this.locks.map(({ amount }) => amount.planck).reduce((a, b) => _talismn_util.BigMath.max(a, b), 0n));
+		if (this.#cachedLocked === void 0) this.#cachedLocked = this.#format(excludeFromTransferableAmount(this.locks));
 		return this.#cachedLocked;
 	}
 	get locks() {
@@ -512,7 +512,8 @@ var Balance = class {
 		const newCalculation = () => _talismn_util.BigMath.max(this.locked.planck, this.reserved.planck);
 		const baseUnavailable = this.#storage.useLegacyTransferableCalculation ? oldCalculation() : newCalculation();
 		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(baseUnavailable + nomPoolStakedPlancks);
+		const extra = this.getValue("extra");
+		return this.#format(baseUnavailable + nomPoolStakedPlancks + includeInTotalExtraAmount(extra));
 	};
 	/** The feePayable balance of this token. Is generally the free amount - the feeFrozen amount. */
 	get feePayable() {
@@ -1693,18 +1694,31 @@ const fetchRpcQueryPack = async (connector, networkId, queries, at) => {
 	return decodeRpcQueryPackChunked(queries, new Map(result.changes), { label: `rpcQueryPack decode ${networkId}` });
 };
 /**
+* The connector reports a chain that has been unreachable for a while with a StaleRpcError,
+* but keeps the subscription registered and re-issues it when a socket reconnects (the
+* first notification after that is a full snapshot again). Matched by its `type` rather
+* than `instanceof`, so a second copy of @talismn/chain-connectors still matches.
+*/
+const isStaleRpcError = (error) => typeof error === "object" && error !== null && error.type === "STALE_RPC_ERROR";
+/**
 * Wraps the raw state_subscribeStorage subscription and emits, for every storage change
 * callback, a SNAPSHOT of the accumulated changes keyed by state key.
 *
 * A snapshot (shallow copy of string refs, cheap) is required because decoding is chunked
 * and asynchronous: a later websocket callback must not mutate the map that an in-flight
 * decode is reading.
+*
+* A StaleRpcError does not end the stream. Erroring would unsubscribe, and with no
+* subscription holding the chain's socket, every later request (eg the dtao poll) would
+* open and close a socket of its own, starting from the network's first RPC each time.
 */
 const getRawStorageUpdates$ = (connector, networkId, allStateKeys, timeout) => new rxjs.Observable((subscriber) => {
 	const changesCache = /* @__PURE__ */ new Map();
 	const promUnsub = connector.subscribe(networkId, "state_subscribeStorage", "state_storage", [allStateKeys], (error, result) => {
-		if (error) subscriber.error(error);
-		else if (result) {
+		if (error) {
+			if (isStaleRpcError(error)) log_default.warn(`Storage subscription stale on ${networkId}`);
+			else subscriber.error(error);
+		} else if (result) {
 			for (const [stateKey, encodedResult] of result.changes) changesCache.set(stateKey, encodedResult);
 			subscriber.next(new Map(changesCache));
 		}
@@ -2590,15 +2604,16 @@ const hasRuntimeApi = (metadata, apiName, method) => {
 	if (!api?.methods) return false;
 	return api.methods.some((m) => m.name === method);
 };
-const getConstantValue = (metadataRpc, pallet, constant) => {
-	const { unifiedMetadata, builder } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+const toParsedMetadata = (metadata) => typeof metadata === "string" ? (0, _talismn_scale.parseMetadataRpc)(metadata) : metadata;
+const getConstantValue = (metadata, pallet, constant) => {
+	const { unifiedMetadata, builder } = toParsedMetadata(metadata);
 	const codec = builder.buildConstant(pallet, constant);
 	const encodedValue = unifiedMetadata.pallets.find(({ name }) => name === pallet)?.constants.find(({ name }) => name === constant)?.value;
 	if (!encodedValue) throw new Error(`Constant ${pallet}.${constant} not found`);
 	return codec.dec(encodedValue);
 };
-const tryGetConstantValue = (metadataRpc, pallet, constant) => {
-	const { unifiedMetadata, builder } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+const tryGetConstantValue = (metadata, pallet, constant) => {
+	const { unifiedMetadata, builder } = toParsedMetadata(metadata);
 	const encodedValue = unifiedMetadata.pallets.find(({ name }) => name === pallet)?.constants.find(({ name }) => name === constant)?.value;
 	if (!encodedValue) return null;
 	return builder.buildConstant(pallet, constant).dec(encodedValue);
@@ -2732,7 +2747,7 @@ const fetchOnChainTokenData$1 = async (connector, tokenId) => {
 //#region src/modules/sol-spl/fetchBalances.ts
 const SPL_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
 const dynamicTokenMetadataCache$1 = new _talismn_util.LruMap(1024);
-const associatedTokenAccountCache = new _talismn_util.LruMap(1024);
+const associatedTokenAccountCache$1 = new _talismn_util.LruMap(1024);
 const fetchBalances$8 = async ({ networkId, tokensWithAddresses, connector }) => {
 	if (!tokensWithAddresses.length) return {
 		success: [],
@@ -2752,7 +2767,7 @@ const fetchBalances$8 = async ({ networkId, tokensWithAddresses, connector }) =>
 				return {
 					mintAddress,
 					value,
-					isSpendable: value !== 0n && state !== "frozen" && d.pubkey === await getAssociatedTokenAccount(address, mintAddress)
+					isSpendable: value !== 0n && state !== "frozen" && d.pubkey === await getAssociatedTokenAccount$1(address, mintAddress)
 				};
 			} catch {
 				log_default.warn("Failed to parse token amount", {
@@ -2845,16 +2860,16 @@ const fetchBalances$8 = async ({ networkId, tokensWithAddresses, connector }) =>
 	};
 };
 const getBalanceKey$1 = (tokenId, address) => `${tokenId}:${address}`;
-const getAssociatedTokenAccount = async (owner, mint) => {
+const getAssociatedTokenAccount$1 = async (owner, mint) => {
 	const key = `${owner}:${mint}`;
-	const cached = associatedTokenAccountCache.get(key);
+	const cached = associatedTokenAccountCache$1.get(key);
 	if (cached) return cached;
 	const [associatedTokenAccount] = await (0, _solana_program_token.findAssociatedTokenPda)({
 		mint: (0, _solana_kit.address)(mint),
 		owner: (0, _solana_kit.address)(owner),
 		tokenProgram: _solana_program_token.TOKEN_PROGRAM_ADDRESS
 	});
-	associatedTokenAccountCache.set(key, associatedTokenAccount);
+	associatedTokenAccountCache$1.set(key, associatedTokenAccount);
 	return associatedTokenAccount;
 };
 //#endregion
@@ -3304,6 +3319,7 @@ const fetchOnChainTokenData = async (connector, tokenId) => {
 //#region src/modules/sol-token2022/fetchBalances.ts
 const TOKEN_2022_PROGRAM_ID = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
 const dynamicTokenMetadataCache = /* @__PURE__ */ new Map();
+const associatedTokenAccountCache = new _talismn_util.LruMap(1024);
 const fetchBalances$7 = async ({ networkId, tokensWithAddresses, connector }) => {
 	if (!tokensWithAddresses.length) return {
 		success: [],
@@ -3315,19 +3331,15 @@ const fetchBalances$7 = async ({ networkId, tokensWithAddresses, connector }) =>
 	const knownTokenIds = new Set(tokensWithAddresses.map(([token]) => token.id));
 	const unknownMints = /* @__PURE__ */ new Set();
 	const balancesPerAddress = await Promise.all(accountAddresses.map(async (address) => {
-		const balances = (await rpc.getTokenAccountsByOwner((0, _solana_kit.address)(address), { programId: (0, _solana_kit.address)(TOKEN_2022_PROGRAM_ID) }, { encoding: "jsonParsed" }).send()).value.map((d) => {
+		const tokenAccounts = await rpc.getTokenAccountsByOwner((0, _solana_kit.address)(address), { programId: (0, _solana_kit.address)(TOKEN_2022_PROGRAM_ID) }, { encoding: "jsonParsed" }).send();
+		const tokenAccountHoldings = await Promise.all(tokenAccounts.value.map(async (d) => {
 			try {
-				const mintAddress = d.account.data.parsed.info.mint;
-				const value = d.account.data.parsed.info.tokenAmount.amount ?? "0";
-				const tokenId = (0, _talismn_chaindata_provider.solToken2022TokenId)(networkId, mintAddress);
-				if (!knownTokenIds.has(tokenId) && value !== "0") unknownMints.add(mintAddress);
+				const { mint: mintAddress, state, tokenAmount } = d.account.data.parsed.info;
+				const value = BigInt(tokenAmount.amount ?? "0");
 				return {
-					tokenId,
-					networkId,
-					address,
-					source: MODULE_TYPE$7,
-					status: "live",
-					value
+					mintAddress,
+					value,
+					isSpendable: value !== 0n && state !== "frozen" && d.pubkey === await getAssociatedTokenAccount(address, mintAddress)
 				};
 			} catch {
 				log_default.warn("Failed to parse token amount", {
@@ -3336,7 +3348,36 @@ const fetchBalances$7 = async ({ networkId, tokensWithAddresses, connector }) =>
 				});
 				return null;
 			}
-		}).filter(_talismn_util.isNotNil);
+		}));
+		const holdingsPerTokenId = /* @__PURE__ */ new Map();
+		for (const { mintAddress, value, isSpendable } of tokenAccountHoldings.filter(_talismn_util.isNotNil)) {
+			const tokenId = (0, _talismn_chaindata_provider.solToken2022TokenId)(networkId, mintAddress);
+			if (!knownTokenIds.has(tokenId) && value !== 0n) unknownMints.add(mintAddress);
+			const { total, spendable } = holdingsPerTokenId.get(tokenId) ?? {
+				total: 0n,
+				spendable: 0n
+			};
+			holdingsPerTokenId.set(tokenId, {
+				total: total + value,
+				spendable: spendable + (isSpendable ? value : 0n)
+			});
+		}
+		const balances = [...holdingsPerTokenId].map(([tokenId, { total, spendable }]) => ({
+			tokenId,
+			networkId,
+			address,
+			source: MODULE_TYPE$7,
+			status: "live",
+			...spendable === total ? { value: total.toString() } : { values: [{
+				type: "free",
+				label: "free",
+				amount: total.toString()
+			}, {
+				type: "locked",
+				label: "locked",
+				amount: (total - spendable).toString()
+			}] }
+		}));
 		setDetectedTokenIds(address, MODULE_TYPE$7, balances.map((b) => b.tokenId));
 		return [address, balances];
 	}));
@@ -3391,6 +3432,18 @@ const fetchBalances$7 = async ({ networkId, tokensWithAddresses, connector }) =>
 	};
 };
 const getBalanceKey = (tokenId, address) => `${tokenId}:${address}`;
+const getAssociatedTokenAccount = async (owner, mint) => {
+	const key = `${owner}:${mint}`;
+	const cached = associatedTokenAccountCache.get(key);
+	if (cached) return cached;
+	const [associatedTokenAccount] = await (0, _solana_program_token.findAssociatedTokenPda)({
+		mint: (0, _solana_kit.address)(mint),
+		owner: (0, _solana_kit.address)(owner),
+		tokenProgram: _solana_program_token_2022.TOKEN_2022_PROGRAM_ADDRESS
+	});
+	associatedTokenAccountCache.set(key, associatedTokenAccount);
+	return associatedTokenAccount;
+};
 //#endregion
 //#region src/modules/sol-token2022/fetchTokens.ts
 const fetchTokens$7 = async ({ networkId, tokens, connector, cache }) => {
@@ -3648,14 +3701,15 @@ const deriveMiniMetadataId = ({ source, chainId, specVersion }) => (0, _talismn_
 const getMiniMetadata$6 = ({ networkId, specVersion, metadataRpc }) => {
 	const source = MODULE_TYPE$6;
 	const chainId = networkId;
-	const systemVersion = getConstantValue(metadataRpc, "System", "Version");
+	const parsed = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+	const { unifiedMetadata } = parsed;
+	const systemVersion = getConstantValue(parsed, "System", "Version");
 	if (specVersion !== systemVersion.spec_version) throw new Error(`specVersion mismatch: expected ${specVersion}, metadata got ${systemVersion.spec_version}`);
 	const id = deriveMiniMetadataId({
 		source,
 		chainId,
 		specVersion
 	});
-	const { unifiedMetadata } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
 	if (unifiedMetadata.version < 14) throw new Error(`Unsupported metadata version: ${unifiedMetadata.version}. Minimum required is 14.`);
 	return {
 		id,
@@ -3663,12 +3717,11 @@ const getMiniMetadata$6 = ({ networkId, specVersion, metadataRpc }) => {
 		chainId,
 		specVersion,
 		version: _talismn_chaindata_provider.MINIMETADATA_VERSION,
-		data: getData$4(metadataRpc),
+		data: getData$4(parsed),
 		extra: null
 	};
 };
-const getData$4 = (metadataRpc) => {
-	const { metadata, unifiedMetadata } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+const getData$4 = ({ metadata, unifiedMetadata }) => {
 	if (!hasStorageItems(unifiedMetadata, "Assets", [
 		"Account",
 		"Asset",
@@ -3846,27 +3899,6 @@ const fetchBasketClaims = async (connector, networkId, metadataRpc, addresses, a
 	}
 };
 //#endregion
-//#region src/modules/substrate-dtao/fetchStorageKeysPaged.ts
-const PAGE_SIZE = 1e3;
-/**
-* Prefix scan via state_getKeysPaged. The unpaged state_getKeys is classified as heavy storage
-* work and rejected by some public nodes (eg the bittensor testnet one: "Storage work rate limit
-* exceeded"), while the paged variant is universally allowed.
-*/
-const fetchStorageKeysPaged = async (connector, networkId, keyPrefix, at) => {
-	const keys = [];
-	let startKey;
-	do {
-		const params = [keyPrefix, PAGE_SIZE];
-		if (startKey || at) params.push(startKey ?? null);
-		if (at) params.push(at);
-		const page = await connector.send(networkId, "state_getKeysPaged", params);
-		keys.push(...page);
-		startKey = page.length === PAGE_SIZE ? page[page.length - 1] : void 0;
-	} while (startKey);
-	return keys;
-};
-//#endregion
 //#region src/modules/substrate-dtao/convictionLocks.ts
 const convictionLockKey = (address, netuid) => `${address}:${netuid}`;
 const getConvictionLockLabel = (lockType) => lockType === "perpetual" ? "Perpetual Conviction Lock" : "Decaying Conviction Lock";
@@ -3963,7 +3995,7 @@ const fetchConvictionLockStorageKeys = async (connector, networkId, addresses, s
 		}
 		let stateKeys;
 		try {
-			stateKeys = await fetchStorageKeysPaged(connector, networkId, keyPrefix, at);
+			stateKeys = await (0, _talismn_sapi.fetchStorageKeysPaged)((method, params) => connector.send(networkId, method, params), keyPrefix, { at });
 		} catch (cause) {
 			log_default.warn(`Failed to fetch conviction Lock keys (address=${address}) on ${networkId}`, { cause });
 			throw cause;
@@ -4387,7 +4419,7 @@ const fetchTokens$5 = async ({ networkId, connector, tokens, miniMetadata }) =>
 const fetchTransferableTokensMap = async (connector, metadata, networkId) => {
 	const { builder } = parseMetadataRpcCached(metadata);
 	const transferToggleCodec = builder.buildStorage("SubtensorModule", "TransferToggle");
-	const transferToggleKeys = await fetchStorageKeysPaged(connector, networkId, (0, _talismn_scale.getStorageKeyPrefix)("SubtensorModule", "TransferToggle"));
+	const transferToggleKeys = await (0, _talismn_sapi.fetchStorageKeysPaged)((method, params) => connector.send(networkId, method, params), (0, _talismn_scale.getStorageKeyPrefix)("SubtensorModule", "TransferToggle"));
 	const transferToggleResults = await connector.send(networkId, "state_queryStorageAt", [transferToggleKeys]);
 	const transferToggleEntries = transferToggleResults.length ? transferToggleResults[0].changes : [];
 	return (0, lodash_es.fromPairs)(transferToggleEntries.map(([key, value]) => {
@@ -4835,14 +4867,15 @@ const fetchTokens$4 = async ({ networkId, tokens, connector, miniMetadata }) =>
 const getMiniMetadata$4 = ({ networkId, specVersion, metadataRpc }) => {
 	const source = MODULE_TYPE$4;
 	const chainId = networkId;
-	const systemVersion = getConstantValue(metadataRpc, "System", "Version");
+	const parsed = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+	const { unifiedMetadata } = parsed;
+	const systemVersion = getConstantValue(parsed, "System", "Version");
 	if (specVersion !== systemVersion.spec_version) throw new Error(`specVersion mismatch: expected ${specVersion}, metadata got ${systemVersion.spec_version}`);
 	const id = deriveMiniMetadataId({
 		source,
 		chainId,
 		specVersion
 	});
-	const { unifiedMetadata } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
 	if (unifiedMetadata.version < 14) throw new Error(`Unsupported metadata version: ${unifiedMetadata.version}. Minimum required is 14.`);
 	return {
 		id,
@@ -4850,12 +4883,11 @@ const getMiniMetadata$4 = ({ networkId, specVersion, metadataRpc }) => {
 		chainId,
 		specVersion,
 		version: _talismn_chaindata_provider.MINIMETADATA_VERSION,
-		data: getData$2(metadataRpc),
+		data: getData$2(parsed),
 		extra: null
 	};
 };
-const getData$2 = (metadataRpc) => {
-	const { metadata, unifiedMetadata } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+const getData$2 = ({ metadata, unifiedMetadata }) => {
 	if (!hasStorageItems(unifiedMetadata, "ForeignAssets", [
 		"Account",
 		"Asset",
@@ -5172,6 +5204,17 @@ const SubHydrationTokenConfigSchema = zod_v4.default.strictObject({
 	...TokenConfigBaseSchema.shape
 });
 //#endregion
+//#region src/modules/substrate-native/evmMirror.ts
+const EVM_MIRROR_LOCK_LABEL = "evm-mirror";
+const isEvmMirrorWithdrawableLock = (lock) => lock.meta?.type === "evm-mirror-withdrawable";
+const findEvmMirrorWithdrawable = (locks) => {
+	const lock = locks?.find(isEvmMirrorWithdrawableLock);
+	return lock ? {
+		...lock.meta,
+		amount: lock.amount.planck
+	} : null;
+};
+//#endregion
 //#region src/modules/substrate-native/config.ts
 const MODULE_TYPE$2 = _talismn_chaindata_provider.SubNativeTokenSchema.shape.type.value;
 const PLATFORM$2 = _talismn_chaindata_provider.SubNativeTokenSchema.shape.platform.value;
@@ -5217,7 +5260,7 @@ const baseLockLabels = ["fees", "misc"];
 const isBaseLock = (lock) => baseLockLabels.includes(lock.label);
 const isNonBaseLock = (lock) => !isBaseLock(lock);
 const filterBaseLocks = (locks) => {
-	if (!locks.some(isNonBaseLock)) return locks;
+	if (!locks.some((lock) => isNonBaseLock(lock) && !lock.includeInTransferable)) return locks;
 	return locks.filter(isNonBaseLock);
 };
 const getLockTitle = (lock, { balance } = {}) => {
@@ -5228,6 +5271,7 @@ const getLockTitle = (lock, { balance } = {}) => {
 	if (lock.label === "nompools-unbonding") return "Pooled Staking";
 	if (lock.label === "subtensor-staking") return "Root Staking";
 	if (lock.label === "dapp-staking") return "DApp Staking";
+	if (lock.label === "evm-mirror") return "EVM Balance";
 	if (lock.label === "fees") return "Locked (Fees)";
 	if (lock.label === "misc") return "Locked";
 	if (lock.label.startsWith("other")) return "Locked";
@@ -5235,7 +5279,7 @@ const getLockTitle = (lock, { balance } = {}) => {
 };
 //#endregion
 //#region src/modules/substrate-native/queries/buildBaseQueries.ts
-const buildBaseQueries = (networkId, balanceDefs, miniMetadata) => {
+const buildBaseQueries = (networkId, balanceDefs, miniMetadata, hasFrontierMirrorWithdraw = false) => {
 	const networkStorageCoders = buildNetworkStorageCoders(networkId, miniMetadata, {
 		account: ["System", "Account"],
 		stakingLedger: ["Staking", "Ledger"],
@@ -5247,6 +5291,7 @@ const buildBaseQueries = (networkId, balanceDefs, miniMetadata) => {
 	});
 	if (!networkStorageCoders) throw new Error(`No network storage coders found for networkId: ${networkId}`);
 	return balanceDefs.map(({ token, address }) => {
+		const evmMirror = hasFrontierMirrorWithdraw ? getEvmMirror(address) : null;
 		const getStateKeys = () => {
 			try {
 				return [
@@ -5255,7 +5300,8 @@ const buildBaseQueries = (networkId, balanceDefs, miniMetadata) => {
 					networkStorageCoders.freezes ? networkStorageCoders.freezes.keys.enc(address) : null,
 					networkStorageCoders.holds ? networkStorageCoders.holds.keys.enc(address) : null,
 					networkStorageCoders.stakingLedger ? networkStorageCoders.stakingLedger.keys.enc(address) : null,
-					networkStorageCoders.poolMembers ? networkStorageCoders.poolMembers.keys.enc(address) : null
+					networkStorageCoders.poolMembers ? networkStorageCoders.poolMembers.keys.enc(address) : null,
+					networkStorageCoders.account && evmMirror ? networkStorageCoders.account.keys.enc((0, _talismn_crypto.frontierH160ToSs58Mirror)(evmMirror.h160)) : null
 				];
 			} catch {
 				return [];
@@ -5274,7 +5320,7 @@ const buildBaseQueries = (networkId, balanceDefs, miniMetadata) => {
 					useLegacyTransferableCalculation: miniMetadata.extra.useLegacyTransferableCalculation
 				};
 				let nomPoolMemberInfo = null;
-				const [accountChange, lockChange, freezesChange, holdsChange, stakingLedgerChange, nomPoolMemberChange] = changes;
+				const [accountChange, lockChange, freezesChange, holdsChange, stakingLedgerChange, nomPoolMemberChange, evmMirrorAccountChange] = changes;
 				if (networkStorageCoders.account) {
 					const baseValues = decodeBaseResult(networkStorageCoders.account, accountChange, networkId);
 					balance.values.push(...baseValues);
@@ -5299,6 +5345,10 @@ const buildBaseQueries = (networkId, balanceDefs, miniMetadata) => {
 					const nomPoolMemberValue = decodePoolMemberResult(networkStorageCoders.poolMembers, nomPoolMemberChange, networkId);
 					if (nomPoolMemberValue) nomPoolMemberInfo = nomPoolMemberValue;
 				}
+				if (networkStorageCoders.account && evmMirror && evmMirrorAccountChange) {
+					const evmMirrorValues = decodeEvmMirrorResult(networkStorageCoders.account, evmMirrorAccountChange, evmMirror, networkId);
+					balance.values.push(...evmMirrorValues);
+				}
 				return {
 					balance,
 					nomPoolMemberInfo
@@ -5336,6 +5386,35 @@ const decodeBaseResult = (coder, value, networkId) => {
 		}
 	];
 };
+const getEvmMirror = (address) => {
+	try {
+		return {
+			type: "evm-mirror-withdrawable",
+			h160: (0, _talismn_crypto.frontierSs58ToTruncatedH160)(address)
+		};
+	} catch {
+		return null;
+	}
+};
+const decodeEvmMirrorResult = (coder, value, meta, networkId) => {
+	const free = (0, _talismn_scale.decodeScale)(coder, value, `Failed to decode EVM mirror balance on chain ${networkId}`)?.data?.free ?? 0n;
+	if (free <= 0n) return [];
+	const withdrawable = {
+		source: "substrate-native-evm-mirror",
+		label: EVM_MIRROR_LOCK_LABEL,
+		amount: free.toString(),
+		meta
+	};
+	return [{
+		...withdrawable,
+		type: "locked",
+		includeInTransferable: true
+	}, {
+		...withdrawable,
+		type: "extra",
+		includeInTotal: true
+	}];
+};
 const decodeLocksResult = (coder, value, networkId) => {
 	return (0, _talismn_scale.decodeScale)(coder, value, `Failed to decode lock on chain ${networkId}`)?.map?.((lock) => {
 		const id = lock?.id ? _polkadot_api_substrate_bindings.Binary.toText(_polkadot_api_substrate_bindings.Binary.fromHex(lock.id)) : void 0;
@@ -5503,7 +5582,7 @@ const getNomPoolStateKeys = (coders, nomPoolMemberInfo, extra) => {
 };
 //#endregion
 //#region src/modules/substrate-native/fetchBalances.ts
-const fetchBalances$2 = async ({ networkId, tokensWithAddresses, connector, miniMetadata }) => {
+const fetchBalances$2 = async ({ networkId, tokensWithAddresses, connector, miniMetadata, hasFrontierMirrorWithdraw }) => {
 	if (!tokensWithAddresses.length) return {
 		success: [],
 		errors: []
@@ -5542,7 +5621,7 @@ const fetchBalances$2 = async ({ networkId, tokensWithAddresses, connector, mini
 			}))
 		};
 	}
-	const baseQueries = buildBaseQueries(networkId, balanceDefs, miniMetadata);
+	const baseQueries = buildBaseQueries(networkId, balanceDefs, miniMetadata, hasFrontierMirrorWithdraw);
 	const partialBalances = await fetchRpcQueryPack(connector, networkId, baseQueries);
 	const nomPoolQueries = buildNomPoolQueries(networkId, partialBalances, miniMetadata);
 	return {
@@ -5594,14 +5673,15 @@ const getChainProperties = async (connector, networkId) => {
 const getMiniMetadata$2 = ({ networkId, specVersion, metadataRpc, config }) => {
 	const source = MODULE_TYPE$2;
 	const chainId = networkId;
-	const systemVersion = getConstantValue(metadataRpc, "System", "Version");
+	const parsed = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
+	const { metadata, unifiedMetadata } = parsed;
+	const systemVersion = getConstantValue(parsed, "System", "Version");
 	if (specVersion !== systemVersion.spec_version) throw new Error(`specVersion mismatch: expected ${specVersion}, metadata got ${systemVersion.spec_version}`);
 	const id = deriveMiniMetadataId({
 		source,
 		chainId,
 		specVersion
 	});
-	const { metadata, unifiedMetadata } = (0, _talismn_scale.parseMetadataRpc)(metadataRpc);
 	if (unifiedMetadata.version < 14) throw new Error(`Unsupported metadata version: ${unifiedMetadata.version}. Minimum required is 14.`);
 	if (config?.disable) return {
 		id,
@@ -5612,8 +5692,8 @@ const getMiniMetadata$2 = ({ networkId, specVersion, metadataRpc, config }) => {
 		data: null,
 		extra: { disable: true }
 	};
-	const existentialDeposit = tryGetConstantValue(metadataRpc, "Balances", "ExistentialDeposit")?.toString();
-	const nominationPoolsPalletIdHex = tryGetConstantValue(metadataRpc, "NominationPools", "PalletId");
+	const existentialDeposit = tryGetConstantValue(parsed, "Balances", "ExistentialDeposit")?.toString();
+	const nominationPoolsPalletIdHex = tryGetConstantValue(parsed, "NominationPools", "PalletId");
 	const nominationPoolsPalletId = nominationPoolsPalletIdHex ? _polkadot_api_substrate_bindings.Binary.toText(_polkadot_api_substrate_bindings.Binary.fromHex(nominationPoolsPalletIdHex)) : void 0;
 	const useLegacyTransferableCalculation = !Boolean(unifiedMetadata.pallets.find(({ name }) => name === "Balances")?.storage?.items.find(({ name }) => name === "Freezes"));
 	(0, _talismn_scale.compactMetadata)(metadata, [
@@ -5724,7 +5804,7 @@ const getTransferAllEncodedArgs = (to, codec) => {
 };
 //#endregion
 //#region src/modules/substrate-native/subscribeBalances.ts
-const subscribeBalances$2 = ({ networkId, tokensWithAddresses, connector, miniMetadata }) => {
+const subscribeBalances$2 = ({ networkId, tokensWithAddresses, connector, miniMetadata, hasFrontierMirrorWithdraw }) => {
 	if (!tokensWithAddresses.length) return (0, rxjs.of)({
 		success: [],
 		errors: []
@@ -5732,7 +5812,7 @@ const subscribeBalances$2 = ({ networkId, tokensWithAddresses, connector, miniMe
 	const balanceDefs = getBalanceDefs(tokensWithAddresses);
 	return (0, rxjs.defer)(async () => {
 		await (0, _talismn_util.yieldToEventLoop)();
-		return buildBaseQueries(networkId, balanceDefs, miniMetadata);
+		return buildBaseQueries(networkId, balanceDefs, miniMetadata, hasFrontierMirrorWithdraw);
 	}).pipe((0, rxjs.switchMap)((baseQueries) => getRpcQueryPack$(connector, networkId, baseQueries)), (0, rxjs.switchMap)((partialBalances) => {
 		const nomPoolQueries = buildNomPoolQueries(networkId, partialBalances, miniMetadata);
 		return getRpcQueryPack$(connector, networkId, nomPoolQueries);
@@ -6778,6 +6858,8 @@ const fetchMiniMetadatas = async (chainConnector, chaindataProvider, chainId, sp
 * Kept tight — a real incoming transfer above 0.1% of the position emits immediately.
 */
 const GENERIC_DRIFT_TOLERANCE_BPS = 10n;
+/** Delay before resubscribing a substrate module stream that errored: 2s, doubling, capped at 1min */
+const substrateModuleRetryDelay = (retryCount) => (0, rxjs.timer)(Math.min(6e4, 2e3 * 2 ** (retryCount - 1)));
 const DEFAULT_STORAGE = {
 	balances: [],
 	miniMetadatas: []
@@ -6859,7 +6941,7 @@ var BalancesProvider = class {
 				switch (mod.platform) {
 					case "ethereum": return this.getEthereumNetworkModuleBalances$(networkId, tokensWithAddresses, mod);
 					case "solana": return this.getSolanaNetworkModuleBalances$(networkId, tokensWithAddresses, mod);
-					case "polkadot": return this.getPolkadotNetworkModuleBalances$(networkId, tokensWithAddresses, mod);
+					case "polkadot": return this.getPolkadotNetworkModuleBalances$(networkId, tokensWithAddresses, mod, (0, _talismn_chaindata_provider.isNetworkDot)(network) && !!network.hasFrontierMirrorWithdraw);
 					default:
 						log_default.warn("[balances] Unsupported network platform for module", {
 							networkId,
@@ -6884,11 +6966,12 @@ var BalancesProvider = class {
 			};
 		}, { label: `network balances ${networkId}` }), (0, rxjs.distinctUntilChanged)(isEqualBalancesResult));
 	}
-	getPolkadotNetworkModuleBalances$(networkId, tokensWithAddresses, mod) {
+	getPolkadotNetworkModuleBalances$(networkId, tokensWithAddresses, mod, hasFrontierMirrorWithdraw) {
 		return (0, _talismn_util.getSharedObservable)(`BalancesProvider.getPolkadotNetworkModuleBalances$`, {
 			networkId,
 			mod,
-			tokensWithAddresses
+			tokensWithAddresses,
+			hasFrontierMirrorWithdraw
 		}, () => {
 			if (!tokensWithAddresses.length) return (0, rxjs.of)({
 				status: "live",
@@ -6912,8 +6995,12 @@ var BalancesProvider = class {
 				networkId,
 				tokensWithAddresses,
 				connector: this.#chainConnectors.substrate,
-				miniMetadata
-			})), stabilizeModuleResults(mod.type === "substrate-dtao" ? void 0 : classifySmallAmountDrift(GENERIC_DRIFT_TOLERANCE_BPS)), (0, rxjs.catchError)(() => rxjs.EMPTY), (0, rxjs.tap)((results) => {
+				miniMetadata,
+				hasFrontierMirrorWithdraw
+			})), stabilizeModuleResults(mod.type === "substrate-dtao" ? void 0 : classifySmallAmountDrift(GENERIC_DRIFT_TOLERANCE_BPS)), (0, rxjs.retry)({
+				delay: (_error, retryCount) => substrateModuleRetryDelay(retryCount),
+				resetOnSuccess: true
+			}), (0, rxjs.tap)((results) => {
 				(0, _talismn_util.reportJsActivity)(`module ${mod.type} ${networkId} (${results.success.length})`);
 				if (results.dynamicTokens?.length) this.#chaindataProvider.registerDynamicTokens(results.dynamicTokens);
 			}), (0, rxjs.map)((results) => ({
@@ -7268,6 +7355,7 @@ exports.BalanceValueGetter = BalanceValueGetter;
 exports.Balances = Balances;
 exports.BalancesProvider = BalancesProvider;
 exports.Change24hCurrencyFormatter = Change24hCurrencyFormatter;
+exports.EVM_MIRROR_LOCK_LABEL = EVM_MIRROR_LOCK_LABEL;
 exports.EvmErc20BalanceModule = EvmErc20BalanceModule;
 exports.EvmErc20TokenConfigSchema = EvmErc20TokenConfigSchema;
 exports.EvmNativeBalanceModule = EvmNativeBalanceModule;
@@ -7320,6 +7408,7 @@ exports.filterMirrorTokens = filterMirrorTokens;
 exports.findDTaoClaimablePlancks = findDTaoClaimablePlancks;
 exports.findDTaoConvictionLock = findDTaoConvictionLock;
 exports.findDTaoRootStakeHold = findDTaoRootStakeHold;
+exports.findEvmMirrorWithdrawable = findEvmMirrorWithdrawable;
 exports.getBalanceFingerprint = getBalanceFingerprint;
 exports.getBalanceId = getBalanceId;
 exports.getBalanceStorageFingerprint = getBalanceStorageFingerprint;
@@ -7343,6 +7432,7 @@ exports.isEqualBalanceArrays = isEqualBalanceArrays;
 exports.isEqualBalancesResult = isEqualBalancesResult;
 exports.isEqualMiniMetadatas = isEqualMiniMetadatas;
 exports.isEqualModuleResults = isEqualModuleResults;
+exports.isEvmMirrorWithdrawableLock = isEvmMirrorWithdrawableLock;
 exports.isNonTransferable = isNonTransferable;
 exports.taoToAlpha = taoToAlpha;
 exports.taoToAlphaCeil = taoToAlphaCeil;