👛 Wallet-Auth | Implement Freighter Wallet Connect & Re-authentication Hook

[Sadeequ]

Impact Severity: High

Module: stellarflow-frontend/src/hooks/useWallet.ts

Description:

Seamlessly handle Freighter browser extension connection, account switching, and automatic session persistence across page reloads.

Technical Requirements:

• Integrate @stellar/freighter-api connection state listener

• Persist connected public key in local storage/React Context

• Trigger graceful re-authentication upon session expiration

[Peolite001]

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

Hi, I would love to work on this issue

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

[vincentchimene]

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

Hi! I’d like to contribute to #519 – Wallet-Auth | Implement Freighter Wallet Connect & Re-authentication Hook. I’m interested in building a secure and seamless wallet authentication experience that provides reliable session management for Stellar applications.

I can implement a reusable useWallet hook that integrates with @stellar/freighter-api, listens for wallet connection and account-switch events, synchronizes wallet state through React Context, and persists the connected public key across page reloads. I’ll also implement graceful re-authentication for expired sessions while ensuring the application remains responsive to changes in wallet state.

I’ll follow Web3 security best practices by persisting only public wallet information, avoiding exposure of sensitive data, and adding tests covering connection, account switching, session restoration, and re-authentication flows.

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

[drips-wave]

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

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