Improve Session Key Automation UX

[0x1NotMe]

Problem

The current session key automation (replenishment) feature needs better UX to encourage players to use it. Currently, users have to wait for a warning modal before they can automate, which creates friction.

Current Behavior

• ShortfallWarningCard appears when balance is low with two buttons:
  • "Manual" replenishment
  • "Automate (ShMON)" option
• Limited configuration in the current modal
• No proactive way to set up automation before hitting low balance
• UI space is constrained in the warning card

Challenges

The auto-topUp feature requires complex configuration:

• Duration cycle: How often to check/replenish
• Daily spending limits: Maximum allowed per day
• Threshold: When to trigger auto-topUp

Current modal is too simple and space-constrained for these settings.

Proposed Solutions

1. Add dedicated automation settings page/modal

   • Accessible from wallet section or game settings
   • Allow players to configure automation proactively
   • Include all necessary settings with clear explanations

2. Improve onboarding flow

   • Prompt players to set up automation during initial gameplay
   • Educate about benefits of automation
   • Make it part of the recommended setup process

3. Visual improvements to current warning

   • Make the "Automate" button more prominent
   • Add benefits/advantages text
   • Consider making it the primary recommended action

4. Quick automation option

   • One-click setup with sensible defaults
   • Advanced settings available for power users

Files Involved

• src/components/wallet/ShortfallWarningCard.tsx - Current warning UI
• src/components/game/screens/SessionKeyPrompt.tsx - Session key update screen
• src/hooks/wallet/useReplenishment.ts - Replenishment logic
• New files needed for settings UI

Acceptance Criteria

• Players can set up automation before hitting low balance
• Clear configuration options for all automation parameters
• Improved visual prominence of automation benefits
• Reduced friction in the automation setup process
• Better education about why automation improves gameplay

Context

Feedback from Alex FastLane: The 'automate' button should be something that everyone clicks or goes through for a much smoother UX experience.

Labels: by-claude, enhancement, ui/ux, wallet