[BE-63] Implement Stellar dividends and on-chain voting API

[yusuftomilola]

Overview

Token holders in a tokenized asset can receive dividend payments proportional to their holdings, and participate in governance votes on asset decisions. This issue exposes the dividends and voting contract modules as API endpoints. Enables FE-46 (Dividend UI) and FE-45 (Voting UI).

Context

• Depends on BE-62 (tokenization must be active for an asset)
• Contract sources: contracts/assetsup/src/dividends.rs and contracts/assetsup/src/voting.rs
• Dividend distribution requires the caller to have sufficient XLM or token balance to distribute

Acceptance Criteria

• POST /stellar/assets/:id/dividends/distribute body: { totalAmount: number, token: 'XLM'|string } — calls contract distribute_dividends(), returns the transaction hash and per-holder amounts
• GET /stellar/assets/:id/dividends/history — list of past distributions with amounts and dates (read from on-chain events)
• GET /stellar/assets/:id/dividends/my — dividends owed to the current user's Stellar address
• POST /stellar/assets/:id/votes body: { title, description, options: string[], closesAt } — creates an on-chain governance proposal
• POST /stellar/assets/:id/votes/:proposalId/cast body: { option: number } — casts a vote (weighted by token holdings)
• GET /stellar/assets/:id/votes — list active and closed proposals with current vote counts

[divysam]

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

Hello
I would love to work on this issue please

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

[Abdulrasaq1515]

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

I want to implement Stellar dividends and on-chain voting API because token holders need to receive dividend payments proportional to their holdings and participate in governance votes. The API exposes dividends and voting contract modules as endpoints: dividends distribution, history, owed dividends, proposal creation, vote casting, and listing proposals.

Relevant experience:

Dividends API — built dividend distribution APIs for 2 token platforms; contract calls, event reading

On-chain voting — implemented governance voting APIs; weighted voting by token holdings

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

[Nimatstar]

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

Hi can i work on this task?

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

[drips-wave]

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

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