[Hardware Wallet] Add guided connection, permission, and recovery states for Ledger users

[ayomideadeniran]

🚀 Feature Overview

Turn hardware-wallet failures into understandable steps rather than raw browser or transport errors.

🛠️ Implementation Requirements

• Design for real student workflows and preserve existing behavior where safe.
• Use accessible semantics, clear recovery states, and privacy-aware defaults.
• Keep client and backend authorization boundaries explicit when data is shared.
• Add focused component, integration, or end-to-end tests.

🔧 Technical Specifications

Next.js, React, TypeScript, WebSocket, browser APIs, and existing frontend test tooling.

✅ Acceptance Criteria

• Unsupported browsers are explained; permissions are requested clearly; disconnect recovery works; no device data is logged; tests use mocks.
• User-facing errors are actionable and do not expose internal details.
• The affected flow remains usable on supported desktop and mobile layouts.

🎓 Difficulty Level

Intermediate to Advanced.

⏱️ Timeline

ETA: 2 days

[jaymoneymanxl]

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

I would love to work on this, Please assign it to me

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

[Kappa16]

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

Please maintainer..I can handle this professionally and make sure this issue is closed ASAP WITHOUT ERRORS.

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

[ryal-net01]

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

Hi, I'd like to work on this issue

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

[damiedee96]

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

Hello Maintainer, I'd love to work on this issue.

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

[drips-wave]

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

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