Skip to content

Add dividend distribution contract for creator revenue sharing with key holders #1073

Closed

Description

@Chucks1093

Summary

Build a dividend contract that allows creators to distribute revenue to their key holders pro-rata to holdings, with a snapshot-based distribution mechanism to prevent gaming through flash purchases.

Scope

  • snapshot_holders(key_id) — creator-only, records holder balances at distribution block
  • fund_dividend(key_id, amount) — creator funds the distribution pool
  • claim_dividend(snapshot_id) — holder claims their pro-rata share from snapshot
  • get_unclaimed_dividend(wallet, snapshot_id) — returns claimable amount
  • DividendSnapshotCreated and DividendClaimed events emitted

Acceptance Criteria

  • Snapshot records correct holder balances at time of call
  • Pro-rata claim computed correctly from snapshot balances
  • Post-snapshot purchases do not affect snapshot entitlements
  • claim_dividend reverts on double-claim with AlreadyClaimed error
  • Both events emitted with correct snapshot and amount data

ETA

24 hours

Activity

  1. laxjovial commented on Oct 17, 2026

    @laxjovial

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

    Hello maintainer, i would like to work on this issue

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

  2. Muyideen-js commented on Oct 17, 2026

    @Muyideen-js

    @Muyideen-js has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

    Hi, I can fix this

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

  3. Zymogen45 commented on Oct 17, 2026

    @Zymogen45

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

    I've reviewed the issue thoroughly and can start working on it right away. Looking forward to contributing

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

  4. johnson7104 commented on Oct 17, 2026

    @johnson7104

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

    I would love to fix this

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

  5. timiturn3r commented on Oct 17, 2026

    @timiturn3r
    Contributor

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

    Hello @maintainer, I’d like to work on this issue. I have experience handling similar tasks and can start immediately. And I will deliver at the shortest possible time.

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

  6. innocentharuna commented on Oct 17, 2026

    @innocentharuna

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

    hey maintainer, please kindly assign this to me, i can surely fix it

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

  7. therealjhay commented on Oct 17, 2026

    @therealjhay

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

    hello maintainer, i would love to work on this

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

  8. Anorakthegr8 commented on Oct 17, 2026

    @Anorakthegr8
    Contributor

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

    Hi maintaine
    Please can I work on this issue please ?

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

  9. rajiabdulrahmon2020-ui commented on Oct 17, 2026

    @rajiabdulrahmon2020-ui
    Contributor

    @rajiabdulrahmon2020-ui has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

    I’ve reviewed the issue from both the requirements and implementation perspective. I’d like to take ownership of it and deliver a solution that is robust, testable, and appropriately scoped to the problem.

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

  10. Deenahss commented on Oct 17, 2026

    @Deenahss

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

    I would love to fix this issue

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

  11. Atim-01 commented on Oct 17, 2026

    @Atim-01

    @Atim-01 has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

    I would like to work on this, please can I be assigned to this issue?

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

  12. Omokolapo0813 commented on Oct 17, 2026

    @Omokolapo0813

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

    Hello, I'd like to work on this. I have experience with Rust/Soroban and I've worked on similar tests before. I can start now and open PR within 2 days. Here is my GitHub: [your link]"

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

  13. Imjolayemi commented on Oct 17, 2026

    @Imjolayemi

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

    Hello Maintainer, I have carefully reviewed the issue and understand what is expected. I am confident I can work toward a solution that meets the requirements. I would appreciate the opportunity to take it on.

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

  14. Dewhiz01 commented on Oct 17, 2026

    @Dewhiz01

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

    Please assign

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

  15. Ajibose commented on Oct 17, 2026

    @Ajibose
    Contributor

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

    can iw work

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

  16. AzahasTech commented on Oct 17, 2026

    @AzahasTech

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

    Hi maintainers!
    I’d love to help out with this issue. I’ve checked the current codebase/documentation and know exactly what needs to be updated to make this clearer. I will ensure everything aligns perfectly with your existing contribution guidelines.

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

  17. Azintar commented on Oct 17, 2026

    @Azintar

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

    I'm interested in taking on this issue and contributing meaningfully to the project. I'm eager to learn, put in the work, and deliver a clean, reliable solution that meets the project's requirements. I'm committed to communicating throughout the process and ensuring the work is properly tested before submission.

    I'd appreciate the opportunity to contribute. Ready to get started!

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

  18. official-rex commented on Oct 17, 2026

    @official-rex

    @official-rex has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

    Allow me to fix this

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

  19. drips-wave commented on Oct 17, 2026

    @drips-wave

    Congratulations, @Ajibose! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on October 22, 2026.

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

  20. grantfox-oss commented on Oct 26, 2026

    @grantfox-oss

    🎉 This issue has been marked as completed on GrantFox!

    @Ajibose's PR #1159 was approved and merged by @Chucks1093.

    🏆 @Ajibose: You earned 40 FoxPoints for this contribution! Your current tier: Builder (2,222 total points). Track your full progress on GrantFox.

    👏 Great work, @Ajibose! Keep contributing to accesslayerorg.

  21. added 2 commits that reference this issue on Oct 26, 2026
  22. drips-wave commented on Oct 26, 2026

    @drips-wave

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

    😎 @Ajibose: You earned 200 Points for completing this issue! Once the Wave's rewards are finalized, 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Stellar WaveIssues in the Stellar wave program

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions