Skip to content

Build creator revenue share indexer and distribution history REST API #1133

Closed

Description

@Chucks1093

Summary

Index RevenueDistributed and RevenueShareClaimed contract events and expose REST endpoints for distribution history per key and claimable amounts per wallet.

Scope

  • Indexer processes both events into revenue_distributions table
  • GET /keys/:key_id/revenue-distributions — paginated list with date, amount, and holder count
  • GET /keys/:key_id/revenue-distributions/:wallet — per-distribution claimable and claimed amounts
  • Cache TTL 60s; invalidated on new revenue event for key
  • Claimed status updated on RevenueShareClaimed event

Acceptance Criteria

  • Both events indexed with no gaps
  • Distribution list returns accurate paginated records
  • Wallet endpoint returns correct claimable and claimed per distribution
  • Claimed status updates correctly after claim event
  • Cache invalidates correctly on new distribution event

ETA

12 hours

Activity

  1. drmfsltdoh commented on Oct 19, 2026

    @drmfsltdoh

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

    I want to work on #1133 - Build creator revenue share indexer and distribution history REST API.

    Experienced with indexers, REST API design, and revenue distribution logic. Will build a reliable indexer to track shares and expose clean history endpoints.

    Ready to start.

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

  2. babamaic commented on Oct 19, 2026

    @babamaic

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

    Hi please I would like to work on this issue

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

  3. reinaldyalt commented on Oct 19, 2026

    @reinaldyalt

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

    Hi, I'm reinaldyalt. I'd like to work on this issue: indexing RevenueDistributed and RevenueShareClaimed contract events into a revenue_distributions table and exposing the distribution history and per-wallet claimable-amount REST endpoints, following the repo's existing indexer-service pattern with ledger checkpoints. I can start right away and deliver a tested PR within a couple of days.

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

  4. kanuemmanuel commented on Oct 19, 2026

    @kanuemmanuel

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

    Hi maintainer, let me fix this issue

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

  5. idrisabdulbasit75-art commented on Oct 19, 2026

    @idrisabdulbasit75-art

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

    Hello, I have carefully reviewed the requirements for this issue and have a clear understanding of the objectives. I am confident in my ability to deliver a high-quality solution and would appreciate the opportunity to be assigned to this task.

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

  6. Stanley-Owoh commented on Oct 19, 2026

    @Stanley-Owoh
    Contributor

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

    Good day maintaner, please i would like to work on this, I have gone through the description and am sure i can handle this task
    I can work on it immediatly with clean code and positive result please assign this issue to me
    Thank you

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

  7. bright5455 commented on Oct 19, 2026

    @bright5455
    Contributor

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

    hello maintainer

    i have read and understand the issue
    im a front end engineer with five years of eperience,with my level of experience,i believe i can deliver a quality PR
    please kindly assign this task to me

    Thank you

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

  8. aabolari commented on Oct 19, 2026

    @aabolari

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

    hi maintainer, i understand the expectations and i would love to work on this issue

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

  9. victrexfx commented on Oct 20, 2026

    @victrexfx
    Contributor

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

    Please kindly assign

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

  10. Maxwell-tom commented on Oct 20, 2026

    @Maxwell-tom

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

    Hi maintainer, I would like to work on this issue.

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

  11. Ottones commented on Oct 20, 2026

    @Ottones

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

    I’ve looked over the issue and know how to handle the fix. I have successfully handled similar tasks and I am available to start working on it right away.

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

  12. bashir347 commented on Oct 20, 2026

    @bashir347

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

    Hi maintainer I would love to solve the issue

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

  13. Abiolawonders commented on Oct 20, 2026

    @Abiolawonders

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

    Hi, I'll love to help build this. Please, assign me.

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

  14. Adejoke46 commented on Oct 20, 2026

    @Adejoke46

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

    Hello Maintainer,

    I would like to express my interest in contributing to this issue. I am eager to contribute to the project by helping address the identified problem and delivering a solution that meets the project's requirements.

    I am committed to understanding the issue, following the project's contribution guidelines, testing my work where applicable, and making any necessary improvements based on feedback.

    I value collaboration, clear communication, and quality contributions. I am ready to dedicate the necessary effort to completing this task responsibly and ensuring that my contribution adds value to the project.

    Thank you for considering my application. I look forward to the opportunity to contribute to your project.

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

  15. DioChuks commented on Oct 20, 2026

    @DioChuks
    Contributor

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

    Hi, I am senior swe, and can tackle this issue for ya. I would ensure to meet your acceptance criteria that: Both events indexed with no gaps, Distribution list returns accurate paginated records, Wallet endpoint returns correct claimable and claimed per distribution, Claimed status updates correctly after claim event, Cache invalidates correctly on new distribution event.

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

  16. drips-wave commented on Oct 20, 2026

    @drips-wave

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

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

  17. grantfox-oss commented on Oct 21, 2026

    @grantfox-oss

    🎉 This issue has been marked as completed on GrantFox!

    @DioChuks's PR #1187 was approved and merged by @Chucks1093.

    🏆 @DioChuks: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (497 total points). Track your full progress on GrantFox.

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

  18. drips-wave commented on Oct 21, 2026

    @drips-wave

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

    😎 @DioChuks: 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