[PERF] Build Assembly Multi-Token Balance Query Loop

[mijinummi]

Labels: medium-difficulty, yul, tokens, gasguard
Difficulty: Medium
Module: contracts/utils/

---

🧠 Concept

Develop a view helper that queries balance states for multiple ERC-20 tokens across multiple accounts within a single static assembly call loop.

⚠️ Problem

Querying token balances individually over standard high-level interfaces incurs substantial call setup and return data decoding overhead per token.

📁 Implementation Scope

• contracts/utils/BatchBalanceChecker.sol
• test/utils/BatchBalanceChecker.test.ts

🛠️ Requirements

1. Construct balanceOf(address) selector in memory once.
2. Iterate through target tokens and accounts using low-level staticcall.
3. Pack balance outputs directly into an assembly-allocated memory buffer.

🎯 Acceptance Criteria

• Queries batch token balances with minimal gas overhead.
• Handles reverts or non-contract target addresses without halting the loop.

[Halimatyemisi]

@Halimatyemisi has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi Maintainer! I’m interested in contributing to this task and can ensure timely delivery with clean implementation. I’ve thoroughly read the issue description and understand the expected outcome. I’d love to work on it. Thank You!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Halimatyemisi to this issue.

[khanavi272-spec]

@khanavi272-spec has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @khanavi272-spec to this issue.

[Fabulouz34]

@Fabulouz34 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer please I will appreciate it if I'm given this issue to work on. Please assign me I'm ready to get started
Thank you

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Fabulouz34 to this issue.

[zoffunjunior381-jpg]

@zoffunjunior381-jpg has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

What can I do for you to assign me this issue sir? I assure you completion of the issue on time with expected output.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @zoffunjunior381-jpg to this issue.

[drips-wave]

Congratulations, @zoffunjunior381-jpg! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @zoffunjunior381-jpg: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊