abhisingh100392/wallet-service repository overview

Wallet Service manages user-owned balances for virtual assets such as GOLD, DIAMOND, and LOYALTY. It is built for products where users buy credits through a payment gateway, receive promotional credits, spend credits inside an application, and need a complete audit trail for every balance movement.

The core design is intentionally conservative:

wallets.balance is the fast read model for the current balance. transactions records the business event. ledger_entries records the accounting movement. Every successful wallet movement writes exactly one transactions row and exactly two ledger_entries rows. Financial mutation paths use idempotency keys, database transactions, row-level pessimistic locks, and consistent lock ordering. Payment and webhook flows both converge into the same wallet transfer engine.