feat(wallet): add multi-wallet connection hub (Freighter, Albedo, xBull, LOBSTR) #805

[AgilityB]

Overview

This PR adds a Multi-Wallet Connection Hub supporting Freighter, Albedo, xBull, and LOBSTR wallets for SoroTask. Users can now select from multiple Stellar wallets instead of being limited to Freighter only.

Related Issue

Closes #805

Changes

Wallet Provider Implementations

• [ADD] frontend/app/lib/wallet-providers-albedo.ts

  • Albedo wallet provider with popup-based auth (no extension required)
  • Checks for window.albedo injection
  • Returns Futurenet connection details

• [ADD] frontend/app/lib/wallet-providers-xbull.ts

  • xBull browser extension wallet provider
  • Supports both window.xBull and window.xBullSDK detection
  • Futurenet network configuration

• [ADD] frontend/app/lib/wallet-providers-lobstr.ts

  • LOBSTR mobile/web wallet provider
  • Supports window.LobstrSigner and window.lobstr detection
  • Futurenet network configuration

UI Components

• [ADD] frontend/app/components/WalletHub.tsx

  • Multi-wallet selection grid component
  • Compact and full display modes
  • Real-time wallet availability detection
  • Install links for unavailable wallets

• [MODIFY] frontend/app/components/WalletConnectionModal.tsx

  • Updated to support multiple wallet providers
  • Added wallet selection grid before connection
  • Improved error handling for different wallet types

Type Updates

• [MODIFY] frontend/app/lib/wallet-provider.ts

  • Extended WalletProviderType to include albedo, xbull, lobstr

• [MODIFY] frontend/app/lib/wallet-providers.ts

  • Added re-exports for all wallet providers

Verification Results

• TypeScript: No new type errors (pre-existing errors in next.config.ts excluded)
• File Structure: All 7 files properly created/modified
• Wallet Detection: Each provider checks for appropriate window injections
• Network: All providers configured for Futurenet (Test SDF Future Network ; October 2022)

Acceptance Criteria

Criteria	Status
Freighter wallet still works	✅ Existing implementation preserved
Albedo wallet integration	✅ Provider added with web-based auth
xBull wallet integration	✅ Provider added with extension detection
LOBSTR wallet integration	✅ Provider added with mobile/web support
Wallet selection UI	✅ Grid-based selection in WalletHub component
Modal updated for multi-wallet	✅ WalletConnectionModal supports selection
Futurenet network support	✅ All providers configured for Futurenet
Install links for unavailable wallets	✅ Directs users to wallet install pages

Commit Message

feat(wallet): add multi-wallet connection hub for Albedo, xBull, and LOBSTR

Integrate Stellar Wallet Kit supporting Freighter, Albedo, xBull, and
LOBSTR wallets. Provides modal UI for selecting wallet and handles
network switching for Futurenet.

Closes #805

[drips-wave]

@AgilityB Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[vercel]

@AgilityB is attempting to deploy a commit to the Ayomide Adeniran's projects Team on Vercel.

A member of the Team first needs to authorize it.