Repository navigation
Add a holder registry endpoint returning each holder's balance split into liquid and staked quantities #846
Description
Summary
The updated holders table needs a stakedQuantity field per holder. The existing holders endpoint should be extended to include stakedQuantity and liquidQuantity derived from the staking_positions contract state.
Scope
- Extend GET /keys/:keyId/holders to include stakedQuantity and liquidQuantity per holder
- Fetch staking positions from the staking_positions persistent map for each holder via the Soroban RPC
- Compute liquidQuantity as totalQuantity minus stakedQuantity
- Cache individual holder staking positions in Redis for 30 seconds
- Maintain backward compatibility by adding the new fields without removing existing ones
Acceptance Criteria
- stakedQuantity and liquidQuantity present on every holder record
- liquidQuantity correctly computed as total minus staked
- Holders with no stake show stakedQuantity of 0
- Redis cache used for staking position reads
- Existing fields unchanged for backward compatibility
ETA: 12 hours
Coordinate on Telegram
Activity
devzakari-sketch commentedon Aug 27, 2026
Hi maintainer can i work on this task
Akinloluwa20 commentedon Aug 29, 2026
@Akinloluwa20 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Akinloluwa20 to this issue.
Bobai100 commentedon Aug 29, 2026
@Bobai100 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Bobai100 to this issue.
devJaja commentedon Aug 29, 2026
@devJaja has applied to work on this issue as part of the Stellar Wave Program's 8th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @devJaja to this issue.
drips-wave commentedon Aug 29, 2026
Congratulations, @devJaja! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.
🧑💻 @devJaja: 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 🌊
feat(keys): add auction, metadata, and staking endpoints; extend hold…
devJaja commentedon Aug 31, 2026
Closed by PR #859 — holder registry with staked/liquid balance implemented.
devJaja commentedon Aug 31, 2026
Closed by PR #859