Add secure local storage for wallet and session state

[Lakes41]

Difficulty: Advanced

Type: Feature

Summary

Persist wallet and session state securely so users do not need to reconnect on every app restart while avoiding unsafe storage of sensitive values.

Current Behaviour

Wallet state is held in a plain Zustand store without persistence. On app restart, the user is redirected to onboarding because isConnected resets to false.

Expected Behaviour

The app should restore non-sensitive wallet state on launch and support secure storage for any future session tokens or wallet integration metadata.

Suggested Implementation

Add a storage adapter using an Expo-compatible secure storage option for sensitive fields and async storage for non-sensitive preferences where appropriate. Rehydrate wallet state during app startup and expose a loading state before redirecting.

Files or Areas Likely Affected

• src/features/wallet/wallet.store.ts
• src/features/wallet/useWallet.ts
• app/index.tsx
• app/_layout.tsx
• app/settings.tsx
• src/lib/storage/
• tests/

Acceptance Criteria

• Wallet address can be restored after app restart
• App startup waits for wallet rehydration before redirecting
• Reset app state clears persisted wallet data
• Sensitive future session fields are stored only in secure storage
• Storage errors are handled gracefully
• Tests cover rehydration, reset, and failed storage access

Additional Notes

Do not store private keys. This issue is about wallet address/session metadata only.

[Emoji-dot]

I would like to work on this issue

[shadrach68]

I would like to work on this issue because I am a full-stack developer with 5+ years experience. I focus on identifying root causes and delivering clean, efficient, and maintainable solutions, with thorough testing to ensure reliable results.

[gloskull]

Hello, I have 4 years of experience delivering solutions for projects like this, covering backend, frontend, and smart contract development. After carefully reviewing your requirements, I have a clear understanding of the task and am confident in my ability to deliver a clean, efficient, and thoroughly tested solution on time. I prioritize code quality, maintainability, and industry best practices throughout the development process.
My PR will be submitted in under 10hours.