Implement mint cap and configurable supply ceiling with dynamic adjustment

[p3ris0n]

Summary

Add a maximum supply cap that prevents minting beyond a configured ceiling, with admin ability to adjust the cap within governance constraints.

Requirements

• Add MaxSupply to DataKey enum
• Modify initialize() to accept optional max_supply
• Modify mint() to check current_supply + amount <= max_supply
• Implement set_max_supply(new_cap)
• Implement get_max_supply() and remaining_mintable()
• Emit max_supply_set events
• Add SDK methods getMaxSupply(), getRemainingMintable()

[yunus-dev-codecrafter]

@yunus-dev-codecrafter has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hello, I’ve read and fully understand the requirements. I can handle this issue with proper implementation and testing. Please grant me access so I can start.

ETA: As soon as possible.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @yunus-dev-codecrafter to this issue.

[drips-wave]

Congratulations, @yunus-dev-codecrafter! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @yunus-dev-codecrafter: 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 🌊