[Contract] Build Dividend Distribution and Claiming Module

[yusuftomilola]

Enables asset owners to distribute revenue to token holders in proportion to their token ownership, with a claim-based payout model.

Requirements

distribute_dividends(env, asset_id, total_amount):

• Asset must have revenue sharing enabled
• Iterates over all token holders
• For each holder: computes their share as (holder_balance / total_supply) * total_amount
• Adds to that holder's unclaimed dividend balance (does not pay immediately)
• Emits a dividends event

claim_dividends(env, asset_id, holder):

• Holder must authenticate
• Returns and clears the holder's unclaimed balance
• Returns BigInt of claimed amount

get_unclaimed_dividends(env, asset_id, holder) — Read-only

Revenue sharing toggle: enable_revenue_sharing(env, asset_id), disable_revenue_sharing(env, asset_id)

Acceptance Criteria

• Dividend amounts accurately proportional to ownership
• Claiming zeroes the holder's unclaimed balance
• Distribution fails if revenue sharing disabled

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[ExcelDsigN-tech]

@ExcelDsigN-tech has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hello, I’m a smart contract developer with hands-on experience building with Rust and Soroban for smart contract development.

I focus on writing clear, maintainable code and making sure features work as expected end to end, not just in isolation. I communicate progress regularly and keep things transparent as I work. I’m confident I can complete this task within an ETA of 8 hours

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

[0xOlivanode]

@0xOlivanode has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi, I’m Olivia Immanuel, a smart contract developer with experience in Solidity, Cairo, and Rust. I’m interested in this issue and would love to be assigned to work on it.

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

[Escelit]

@Escelit has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I'm really interested in building this dividend module because it adds real economic utility to tokens. Instead of just speculation, token holders actually share in project revenue – that's the kind of feature that turns a basic asset into something people genuinely want to hold.

The claim-based design is smart too. Rather than pushing payments to everyone (which gets expensive and complicated), letting users claim their share keeps things efficient. I enjoy working through these practical engineering tradeoffs.

Relevant experience:

I've built Soroban contracts with balance tracking and authentication

I understand proportional math and testing for edge cases

I can implement toggle mechanisms with proper access control

I write tests that verify calculations aren't off by a single unit

This is meaningful functionality that benefits real token holders.

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

[KevinMB0220]

@KevinMB0220 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi, I’m Kevin a full-stack and smart contract engineer building on Stellar. I specialize in designing and shipping scalable, secure systems end-to-end, from Soroban smart contracts to production-ready backend infrastructure and user-facing applications.

I’ve worked on complex architectures involving automated agents, cross-chain logic, and data indexing, focusing on reliability, performance, and clean standards. My approach is very product-driven: I don’t just build contracts, I build complete systems that solve real user problems and can scale in production.

I’m especially interested in infrastructure, security, and automation creating tools and frameworks that make it easier for other developers to build safely and efficiently on Stellar.

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