Stellar Wallet Balance Synchronization

[Mkalbani]

Location: Backend API - Blockchain Integration
Labels: backend, stellar, sync, good first issue
Estimated Time: 6 hours
Difficulty: Medium

Description

Create a system to sync and cache player wallet balances (XLM and custom tokens) from Stellar blockchain.

Tasks

• Implement Stellar account balance fetching
• Create balance caching with Redis
• Add periodic balance refresh (cron job)
• Implement on-demand balance updates
• Create balance change webhooks
• Add multi-token balance tracking
• Implement balance history tracking
• Write balance sync tests
• Add balance display endpoints
• Create low balance notifications

Acceptance Criteria

• Balances fetched from Stellar correctly
• Cache reduces API calls
• Periodic refresh works
• On-demand updates functional
• Multi-token support working
• Tests verify sync accuracy

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 150 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

[Godsmiracle001]

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

I’d love to work on this issue because it aligns with my experience in backend development and blockchain integrations. I’m comfortable implementing Stellar balance fetching, Redis caching, cron-based refresh, and on-demand updates. I’ll ensure accurate multi-token tracking, balance history, notifications, and proper testing for reliable synchronization.

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

[beebozy]

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

Hi, I am a backend and smart contract developer I have gone through the issue and I understand what is required. Can you kindly assign me this?

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

[codewithzubair07]

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

Hi 👋

I’d like to take this issue.

I’m Zubair — a backend-focused fullstack developer with experience working on API systems, caching strategies, and blockchain-integrated services. I’ve worked with state synchronization patterns and cache-layer optimization, so implementing a balance sync + Redis caching layer aligns well with my background.

GitHub: https://github.com/codwithzubair07

Proposed Implementation Plan

I’ll structure the solution for reliability and efficiency:

• Implement Stellar account balance fetching (XLM + custom assets)
• Add Redis-based caching layer to reduce external API calls
• Create periodic refresh via cron job (configurable interval)
• Support on-demand balance refresh endpoint
• Implement webhook mechanism for balance change notifications
• Add multi-token balance tracking with structured storage
• Implement balance history tracking for analytics and audit
• Add low-balance notification logic
• Write comprehensive tests for sync correctness and cache validation

Focus areas:

• Preventing unnecessary blockchain calls
• Ensuring cache consistency
• Clean abstraction between blockchain layer and service layer
• Strong test coverage for accuracy

ETA: 6 hours from assignment.

I’ll structure commits clearly and ensure all acceptance criteria are met.

Looking forward to contributing 🚀

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

[Eniola3321]

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

Hello,
I’m interested in contributing to this issue. I have experience in backend development and Web3 (smart contracts, blockchain integrations).
I’d be happy to work on this and follow the project’s contribution guidelines.
Please let me know if I can proceed. Thanks!

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

[olawale880]

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

Hi Maintainers,
I’m interested in working on this issue. I’m a backend developer with experience in Node.js, APIs, and Web3/blockchain concepts.
I’ve reviewed the issue and I’m confident I can contribute a clean solution.
Kindly assign it to me if it’s open. Thanks!

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

[drips-wave]

Congratulations, @codewithzubair07! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

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