Build real-time WebSocket notification infrastructure

[Smartdevs17]

Description

Create a scalable WebSocket server for real-time event delivery to connected clients, supporting connection pooling, automatic reconnection, and message ordering.

Acceptance Criteria

• WebSocket server with connection lifecycle management
• Automatic reconnection with exponential backoff
• Message ordering guarantees within a session
• Channel-based subscription (payment events, dispute updates)
• Heartbeat mechanism for connection health
• Horizontal scaling support via Redis pub/sub

Technical Scope

• backend/src/websocket/server.ts
• backend/src/websocket/managedConnection.ts
• frontend/lib/websocket/pool.ts
• backend/src/events/event-bus.ts
• Edge: stale connection cleanup, message buffer overflow, auth token expiry during connection

[Gpraiz01]

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

Hi

Please assign me this task. I’ll implement a scalable WebSocket infrastructure with managed connections, reconnection/backoff handling, ordered event delivery, heartbeat health checks, Redis pub/sub scaling, and subscription-based real-time channels.

ETA: 1–2 hours

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

[Shoboyan1]

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

I'd like to work on this issue because building scalable real-time infrastructure is an area I'm both passionate about and experienced in — I've implemented WebSocket servers with connection lifecycle management, connection pooling, automatic reconnection with exponential backoff, and guaranteed message ordering in production systems. I understand the reliability and concurrency challenges involved in delivering events to multiple connected clients at scale, and I'm confident I can meet all the acceptance criteria while keeping the implementation clean and maintainable.

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

[collinsadi]

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

I'd love to work on this.

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

[drips-wave]

Congratulations, @collinsadi! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

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