Add integration test for key holders list endpoint returning holders sorted by quantity descending

[Chucks1093]

Summary

The key holders list endpoint should return holders sorted by their key quantity from highest to lowest. An integration test should seed holders with different quantities and confirm the response order matches the expected sort.

Scope

• Seed four holders with quantities 5, 1, 10, and 3 for the same creator
• Call the holders list endpoint
• Assert the response order is 10, 5, 3, 1
• Assert all four holders are present with correct quantities

Acceptance Criteria

• Holders returned in descending quantity order
• All seeded holders present in response
• Each holder entry has correct quantity field
• Endpoint handles a creator with a single holder correctly

ETA: 12 hours

---

Coordinate on Telegram

[MoscowDev]

I’d love to take this issue on. I’ve worked on production-ready applications and collaborated extensively through GitHub workflows. I’ll dig into the current setup, implement a solid and reliable fix, and deliver a well-tested PR. My focus is on clean, maintainable code and fast, dependable delivery.

[Doo-yum]

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

I can get this work done in less than 24hours

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

[Kappa16]

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

Please maintainer..I can handle this professionally and make sure this issue is closed ASAP WITHOUT ERRORS.

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

[Komelove]

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

Hi, I'd like to take on this issue. I have experience across smart contracts, backend services, and frontend development.
I've reviewed the requirements and will analyze the current implementation, deliver the requested changes, add relevant tests, and submit a clean, well-documented PR. I'm available to start immediately and will provide consistent progress updates throughout the implementation.
Thanks for your consideration.

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

[Meemlahsabi]

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

Hello! This issue aligns perfectly with my skills and previous experience. I’m confident I can deliver a reliable implementation that satisfies every acceptance criterion while keeping the solution clean, optimized, and easy to maintain. I’d be excited to contribute if assigned.

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

[Chuksbrownj]

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

I will like to work on this issue because I am building some projects. I have experience in Git, GoLang, JavaScript, and writing automated tests, and I am good at reading existing codebases and adding test cases.

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

[The-Big-Danny]

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

Hey there👋, can I work on this issue
I have experience and have reviewed the code; I can submit a PR within 2 days.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @The-Big-Danny to this issue.

[Kaybee973]

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

I'm interested in working on this issue and have experience fixing similar problems. I'd be happy to contribute.

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

[Myart352]

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

Hello AccessLayer team,

I'd like to apply for this issue.

After reviewing the requirements, I understand that the objective is to verify that the key holders list endpoint consistently returns holders ordered by key quantity in descending order. This integration test will help ensure the API provides a predictable ranking of holders and prevents regressions in the endpoint's default sorting behavior.

My implementation approach would be to create deterministic integration tests that seed a creator with four holders owning 10, 5, 3, and 1 keys (using distinct wallets and appropriate test data). I'll call the holders list endpoint and verify that all seeded holders are present, each holder's quantity field matches the expected value, and the response is ordered exactly by descending quantity. I'll also include the required edge-case test for a creator with a single holder to confirm the endpoint behaves correctly when only one record exists.

The tests will be isolated, repeatable, and consistent with the project's existing integration testing patterns, ensuring they run reliably in both local development and CI without relying on external services.

Finally, I'll verify that the implementation satisfies all acceptance criteria and provides reliable regression coverage for the endpoint's default ordering behavior.

Thank you for considering my application.

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

[abimbolaalabi]

@abimbolaalabi 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 @abimbolaalabi to this issue.

[circleboyslimited]

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

I can work on this

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

[heymariam]

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

Hello Maintainer, I’d to work on this issue. assign it to me so i can start working on it

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

[drips-wave]

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

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