Wallet Connection & Network-Switch Guard with Persistent Session

[meshackyaro]

Description

This issue aims to address the implementation of Wallet Connection & Network-Switch Guard with Persistent Session.

The core objective is to: Implement a resilient wallet connection layer that detects wrong networks, prompts guided switching, and restores the authenticated session across reloads.

By completing this feature, we will ensure that the GuildWorkman protocol maintains its high standards for security, usability, and decentralized logic. This issue requires careful attention to the Frontend architecture and adherence to the existing project conventions.

When picking up this issue, please ensure you document any new dependencies or architectural decisions made during development.

Component

Frontend

Difficulty

🔴 Hard

Tasks

• Review Next.js App Router structure
• Implement the UI components for: Wallet Connection & Network-Switch Guard with Persistent Session
• Ensure responsive design using Tailwind CSS or standard modules
• Add caching for npm dependencies in CI
• Run npm run lint and npm run typecheck
• Run npm run build to verify production bundling

Acceptance Criteria

• Feature accurately implements the objective: Implement a resilient wallet connection layer that detects wrong networks, prompts guided switching, and restores the authenticated session across reloads.
• Any PR that introduces TypeScript errors is automatically blocked
• CI pipeline runs in under 3 minutes per PR
• Code is properly reviewed and approved by codeowners

Estimated Time

1-3 days

[Endowed992]

Hello, can i be assigned to this issue?

[Q-ARAYA]

Hi! I'd like to work on this issue. I have experience with React, Next.js, TypeScript, and Web3 frontend development. I'd be happy to implement the wallet connection flow, network-switch guard, and persistent session while following the project's architecture and ensuring all lint, typecheck, and build requirements pass.

[wadexybiodun]

Hi admin, please could you kindly assign this to me.
Thank you

[grantfox-oss]

🦊 GrantFox — @Q-ARAYA has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #25)
2. Your PR will be reviewed by the workman-labs maintainers

Good luck! Track your progress on GrantFox.