wallet-recharge-flow

What problem does it solve?

This Skill centralizes and automates wallet balance management by handling gold coins and bonus coins directly in the user data, enforcing atomic updates and consistent transaction logging.

Core Features & Use Cases

• Balance tracking in user records (gold coins, bonus coins, total recharged, optimistic lock version)
• Deterministic deduction rules (only Gold is deducted for draws, with explicit recharge prompts when insufficient)
• WalletTransaction logging for every balance change, with types and context
• End-to-end Recharge flow (validate user, validate plan, transactional update, log transaction, produce result)
• Admin adjustments via API with guardrails

Quick Start

Set up a test user and run a sample RechargePlan to verify gold and bonus balances, as well as wallet transaction logs update atomically.