Add a vote casting endpoint that submits the cast_vote contract call and records the vote in the database

[Chucks1093]

Summary

There is no server endpoint for holders to cast governance votes through the client. A POST /keys/:keyId/proposals/:proposalId/vote endpoint that validates the holder's eligibility, submits the contract call, and persists the vote should be added.

Scope

• Add POST /keys/:keyId/proposals/:proposalId/vote requiring a valid JWT
• Accept optionIndex in the request body and validate it is within the proposal's option range
• Check that the caller has not already voted on the proposal and return 409 if they have
• Submit the cast_vote contract call and write the vote record to proposal_votes
• Return 404 if the proposal does not exist or is already closed

Acceptance Criteria

• Valid vote submitted to contract and persisted
• Duplicate vote returns 409
• optionIndex out of range returns 422
• Vote on a closed proposal returns 404
• Non-holder JWT with zero balance returns 403

ETA: 12 hours

---

Coordinate on Telegram

[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.

Hi Maintainer, please assign

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

[bashir347]

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

Hey maintainer I would like to work on this issue

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

[Mona-i]

@Mona-i 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.

Please assign.

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

[jajafwangshak86-ops]

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

can I work on this please

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

[drips-wave]

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

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