Implement Frontend Wallet Session Management

[Iwueseiter]

Description

Implement a frontend session system that treats a connected Stellar wallet as the authenticated user and persists the session across page reloads.

Since the backend is not ready, the wallet public key will temporarily serve as the user session. The structure must be modular to allow easy integration with backend authentication later.

Tasks

Session Service

Create:/services/auth/session.service.ts

Implement:

• createSession(publicKey)

• getSession()

• clearSession()

• isAuthenticated()

• Store session in localStorage.

• Auth Context

Create:/context/auth.context.tsx

Add:

• publicKey

• isAuthenticated

• login(publicKey)

• logout()

• Restore session on app load

Integration

• Create session when wallet connects

• Restore session on refresh

• Clear session on logout

Acceptance Criteria

• User remains logged in after refresh

• Session stored and restored correctly

• Logout clears session

• Auth state available globally

• No backend required

Dependency

Requires:

• Wallet Connection Logic Implement Wallet Connection Logic (Freighter) #3

• Wallet Context Create Wallet Context for global wallet state management #4

[drips-wave]

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

[Turawa2]

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

I’d really like to work on this issue because wallet session management is one of the most important parts of any Web3 frontend. If the wallet experience isn’t smooth — like losing connection after refresh or not handling account changes properly — it can frustrate users quickly. I enjoy working on things that directly improve user experience while still involving solid technical structure.

I’ve built Web3 applications where I handled wallet connections, managed account and network changes, implemented auto-reconnect logic, and maintained session persistence across page reloads. I’m comfortable working with MetaMask integrations and managing wallet state cleanly so the UI stays in sync with the blockchain layer.

I also understand the importance of structuring wallet logic in a scalable way separating concerns, keeping state predictable, and making sure edge cases like disconnects or chain switches are handled properly.

I’m confident I can implement a reliable and clean session management solution that strengthens the frontend architecture and improves the overall user experience.

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

[edehvictor]

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

Can I get assigned to this issue. I'm familiar with the codebase because I have worked on it previously, please can i be assigned?

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

[rahimatonize]

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

hello,can i get assigned to this issues, i will deliver perfect implementation

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

[drips-wave]

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

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

[Iwueseiter]

@rahimatonize Please what's the update here?

[rahimatonize]

i have raised a pr. please review.