perf!: Use single call to update native balances when enabled

[FrederikBolding]

Explanation

This PR modifies AccountTrackerController.refresh to use the contract from SINGLE_CALL_BALANCES_ADDRESS_BY_CHAINID used in other asset controllers when available. This reduces the amount of fetch calls made to update native balances drastically. If the contract is not available, we fall back to the previous behaviour.

Additionally this PR refactors getStakedBalanceForChain to take multiple addresses and use multicall to fetch staked balances. This also drastically reduces the number of fetch calls used, but is a breaking change since the parameters and return value has changed for getStakedBalanceForChain.

References

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed, highlighting breaking changes as necessary
• I've prepared draft pull requests for clients and consumer packages to resolve any breaking changes

[FrederikBolding]

I ran lint:fix and modified a bunch of JSDocs like this, feel free to revert

[cursor]

Bug: Single-Call Balance Fetch Fails Without Fallback

The new single-call contract logic for fetching native account balances lacks error handling. If the contract.balances() call fails (e.g., due to network issues, contract problems, or an individual address causing a revert), the entire balance refresh operation for that chain will fail. This reduces resilience compared to the previous implementation, which handled individual failures gracefully. The single-call logic should fall back to the individual query method on failure.

packages/assets-controllers/src/AccountTrackerController.ts#L376-L396

core/packages/assets-controllers/src/AccountTrackerController.ts

Lines 376 to 396 in 40c118c

	if (hasProperty(SINGLE_CALL_BALANCES_ADDRESS_BY_CHAINID, chainId)) {
	const contractAddress = SINGLE_CALL_BALANCES_ADDRESS_BY_CHAINID[
	chainId
	] as string;
	const contract = new Contract(
	contractAddress,
	abiSingleCallBalancesContract,
	new Web3Provider(provider),
	);
	const nativeBalances = await contract.balances(accountsToUpdate, [
	'0x0000000000000000000000000000000000000000',
	]);
	accountsToUpdate.forEach((address, index) => {
	accountsForChain[address] = {
	balance: (nativeBalances[index] as BigNumber).toHexString(),
	};
	});

Fix in Cursor • Fix in Web

---

Was this report helpful? Give feedback by reacting with 👍 or 👎