Add a holder cap update endpoint for creators to change the maximum keys a single wallet can hold

[Chucks1093]

Summary

The on-chain holder cap can be set by the creator but there is no server endpoint for this. A POST /creator/:keyId/holder-cap endpoint that submits the set_holder_cap contract call and records the new cap in the database should be added.

Scope

• Add POST /creator/:keyId/holder-cap with { capBps: number } body requiring a JWT matching the key creator
• Validate capBps is between 100 and 2500 (1%–25%)
• Submit the set_holder_cap contract call
• Update the holderCapBps field on the key record in the database
• Return the updated holderCapBps and the equivalent percentage in the response

Acceptance Criteria

• Cap updated in contract and database for valid input
• capBps below 100 returns 422
• capBps above 2500 returns 422
• Non-creator JWT returns 403
• Response includes holderCapBps and percentage equivalent

ETA: 12 hours

---

Coordinate on Telegram

[Olowodarey]

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

Hello, I’m Darey Olowo, a frontend and smart contract developer with experience building and shipping reliable features. I’d like to take on this issue and deliver a solid solution within 24 hours.

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

[Waffiyyi]

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

I would love to work on this issue. Please assign this to me.

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

[Mabel-003]

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

Please assign

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

[wizard-web001]

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

Hi maintainer, I would like to work on this issue

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

[bytebinders]

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

I would like to work on this

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

[EneGab]

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

[Ahbiz]

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

Hello maintainer, i would love to work on this issue.

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

[Akpamgbo]

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

Hey Chief, can i take on this issue please, I am good at this work.

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

[drips-wave]

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

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

[drips-wave]

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

😎 @Akpamgbo: 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.