Add a holder registry map that tracks all wallet addresses that have ever held a creator key

[Chucks1093]

Summary

The snapshot and airdrop functions need to iterate over all holders but there is no on-chain registry of holder addresses. A holder_registry persistent map keyed by key_id storing a vec of all addresses that have ever held the key would provide this foundation.

Scope

• Maintain a holder_registry Vec in persistent storage keyed by key_id
• Append a wallet address to the registry on their first ever buy or transfer-in for a given key
• Never remove addresses from the registry even when their balance reaches zero (for historical accuracy)
• Provide a get_holder_registry(key_id: BytesN<32>) view function returning the full address vec
• Bump the TTL of the registry entry on every read and write

Acceptance Criteria

• New buyer's address appended to registry on first purchase
• Address not duplicated on subsequent buys by the same wallet
• Transfer recipient address appended to registry if not already present
• get_holder_registry returns the full address list correctly
• TTL bumped on every registry read and write

ETA: 24 hours

---

Coordinate on Telegram

[Zymogen45]

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

Hi Ser! I'd love to work on this. I've gone through the description and I already know exactly what needs to be done. I'll deliver a clean, well-tested PR that meets every acceptance criterion. Can I get it assigned?

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

[meem08]

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

kindly assign

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

[DanbabaJr]

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

Hi, i would love to work on this

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

[extolkom]

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

Please assign me

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

[drips-wave]

Congratulations, @meem08! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

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