Add unique trader count tracking to bonding curve contract

[Chucks1093]

Summary

Extend the bonding curve contract to track unique wallet addresses that have traded a key, exposing a count metric and a has-traded check for analytics and eligibility logic.

Scope

• Unique trader set updated on first buy or sell per wallet per key
• get_unique_trader_count(key_id) — returns total unique traders
• has_traded(key_id, wallet) — returns bool
• Trader set stored efficiently using a bitmap or sorted set pattern
• UniqueTraderAdded event emitted on first trade per wallet

Acceptance Criteria

• Unique count increments only on first trade per wallet
• Repeat trades by same wallet do not increment count
• has_traded returns correct bool for traded and untouched wallets
• UniqueTraderAdded event emitted exactly once per wallet
• get_unique_trader_count returns correct value after bulk trades

ETA

24 hours

[stephaniepez21-art]

@stephaniepez21-art has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

Hi maintainer, I'd like to work on this. pls assign

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

[innocentharuna]

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

hey maintainer, please kindly assign this to me, i can surely fix it

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

[chikawobishie-sketch]

@chikawobishie-sketch has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

Hello maintainer, I will love to work on this issues , kindly assign it to me

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

[bashco-web]

@bashco-web has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

Interested in working on this. I'll ensure the implementation is clean, tested, and aligned with project standards

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

[Temibell]

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

Hello Maintainer, I can fix this please assign.

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

[David-282]

@David-282 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

pls assign

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

[Yunusabdul38]

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

I can take this on. I've gone through the details and will provide a well-tested solution aligned with the project standards.

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

[drips-wave]

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

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

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@Yunusabdul38's PR #987 was approved and merged by @Chucks1093.

🏆 @Yunusabdul38: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (815 total points). Track your full progress on GrantFox.

👏 Great work, @Yunusabdul38! Keep contributing to accesslayerorg.

[drips-wave]

This issue has been completed by @Yunusabdul38 as part of the Stellar Wave Program's 9th Wave 🥳

😎 @Yunusabdul38: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.