Skip to content

Stellar chain listener and on-chain reconciliation #561

Closed
Closed
Stellar chain listener and on-chain reconciliation#561
Assignees
josephchimebuka
Labels
Stellar WaveIssues in the Stellar wave programbackendblockchaindocumentationImprovements or additions to documentation

Description

@codebestia
codebestia
opened on Aug 27, 2026

Write apps/backend/docs/concepts-stellar-listener.md for services/stellarListener.ts: which contract events it watches, how it maps them onto the token_transfers and treasury_proposals tables, how it tracks its position in the ledger, and what happens after downtime.

Acceptance criteria:

  • Documents the watched events and the resulting database writes
  • Explains cursor/position tracking and the catch-up path after the listener has been down
  • Documents idempotency — a replayed ledger event must not double-write
  • States the failure mode when the RPC endpoint is unreachable, and whether on-chain state can drift from the mirrored rows

Activity

  1. codebestia
    added
    documentationImprovements or additions to documentation
    backend
    blockchain
    on Aug 27, 2026
  2. drips-wave
    added
    Stellar WaveIssues in the Stellar wave program
    on Aug 27, 2026

  3. Timmmytunner commented on Aug 31, 2026

    @Timmmytunner
    Timmmytunner
    on Aug 31, 2026 – with Drips Wave

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

    Hello, after reviewing the issue thoroughly, I believe I can provide a solution that addresses the reported problem while preserving the overall quality and stability of the project. I’ll pay close attention to the acceptance criteria and existing implementation patterns to ensure the changes integrate properly. I’d appreciate the opportunity to take this issue and work on it through completion.

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

  4. Yodomite commented on Aug 31, 2026

    @Yodomite
    Yodomite
    on Aug 31, 2026 – with Drips Wave

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

    can i work on this issue

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

  5. Baytizz commented on Aug 31, 2026

    @Baytizz
    Baytizz
    on Aug 31, 2026 – with Drips Wave

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

    I have reviewed the issue and i would like to work on it. I am confident that I can get it fixed perfectly to meet the acceptance criteria if I get assigned to work on it

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

  6. Ikechukwu-Patrick commented on Aug 31, 2026

    @Ikechukwu-Patrick
    Ikechukwu-Patrick
    on Aug 31, 2026 – with Drips Wave

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

    I'd love to take this on! I will write concepts-stellar-listener.md to thoroughly document the Stellar chain listener, detailing the contract event mappings, ledger position (cursor) tracking, and the idempotency guarantees that prevent double-writes. Having architected backend integrations for Stellar Soroban smart contracts, I am highly familiar with Horizon RPC failure modes and the nuances of on-chain state reconciliation. Let me know if I can get assigned!

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

  7. codebestia
    assigned
    Ikechukwu-Patrick
    on Aug 31, 2026

  8. drips-wave commented on Aug 31, 2026

    @drips-wave
    drips-waveBot
    on Aug 31, 2026 – with Drips Wave

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

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

  9. codebestia
    unassigned
    Ikechukwu-Patrick
    on Aug 31, 2026

  10. loladeyisau8-hub commented on Sep 23, 2026

    @loladeyisau8-hub
    loladeyisau8-hub
    on Sep 23, 2026 – with Drips Wave

    @loladeyisau8-hub has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

    Hello, I’ve gone through the issue details and I believe I can handle the task effectively. I’d be happy to take it up and work toward a well-tested solution. Thank you for considering my application.

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

  11. josephchimebuka commented on Sep 28, 2026

    @josephchimebuka
    josephchimebuka
    on Sep 28, 2026 – with Drips Wave
    Contributor

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

    Hi GM, I have reviewed this issue and taken the time to understand the requirements, current implementation, and the expected outcome. Based on my analysis, I believe this is something I can successfully handle and contribute to... Kindly assign

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

  12. Damola09 commented on Sep 28, 2026

    @Damola09
    Damola09
    on Sep 28, 2026 – with Drips Wave
    Contributor

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

    Can i work on this?

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

  13. codebestia
    assigned
    josephchimebuka
    on Sep 28, 2026

  14. drips-wave commented on Sep 28, 2026

    @drips-wave
    drips-waveBot
    on Sep 28, 2026 – with Drips Wave

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

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

  15. josephchimebuka
    added a commit that references this issue on Sep 29, 2026

    docs: add backend concept pages and ADR index for codebestia#550 code…

    a1b86b1

  16. josephchimebuka commented on Sep 29, 2026

    @josephchimebuka
    josephchimebuka
    on Sep 29, 2026
    Contributor

    Addressed in #610 (retargeted to dev after #609 was auto-closed for targeting main).

  17. github-actions commented on Sep 29, 2026

    @github-actions
    github-actionsBot
    on Sep 29, 2026 – with GitHub Actions

    Closed by #610, merged into dev.

  18. github-actions
    closed this as completedon Sep 29, 2026

  19. drips-wave commented on Sep 29, 2026

    @drips-wave
    drips-waveBot
    on Sep 29, 2026 – with Drips Wave

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

    😎 @josephchimebuka: You earned 200 Points for completing this issue! After the current Wave ends, 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 programbackendblockchaindocumentationImprovements or additions to documentation

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions