Issue 170: optimization: Pack multiple state booleans into a single u64 bitmask

[AlAfiz]

Description

Storing multiple boolean flags (like is_paused, is_deprecated, flash_loans_active) as separate entries in Soroban's instance storage is highly inefficient.
Every individual storage key costs network rent. We can drastically reduce our storage footprint by packing all protocol configuration flags into a single u64 bitmask.
This means we only pay rent for one variable, but we can track up to 64 different true/false states.
It demonstrates an elite level of smart contract optimization to the hackathon judges.

Requirements

• Replace the individual boolean state variables with a single protocol_flags: u64 variable.
• Define bitwise constants (e.g., PAUSED_FLAG = 1 << 0, DEPRECATED_FLAG = 1 << 1).
• Create an internal helper set_flag(flag, value) that uses bitwise OR/AND to flip the specific bit without altering the others.
• Create a has_flag(flag) read-only helper to check states during the swap execution flow.

[Awointa]

@Awointa has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hi 👋

I’d like to take this on. I’ll refactor the boolean state variables into a single u64 bitmask, define flag constants, and implement helpers for setting and checking flags safely.

I’ll ensure the logic is efficient, well-tested, and integrates cleanly with existing contract flows.

Thanks!

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

[drips-wave]

Congratulations, @Awointa! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @Awointa: 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 🌊