wallet-recharge-flow

Automate wallet recharge and coin accounting with transactional logging.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/smile95137a/kuji-client --skill wallet-recharge-flow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wallet-recharge-flow
Source: https://github.com/smile95137a/kuji-client/tree/main/.github/skills/wallet-recharge-flow
Command: npx skills add https://github.com/smile95137a/kuji-client --skill wallet-recharge-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about wallet-recharge-flow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate wallet recharge and coin accounting atomically?

Automate wallet recharge by centralizing gold and bonus coin management within a transactional service, validating user existence and recharge plans before applying atomic updates and logging WalletTransaction records.

What's the best way to log wallet transactions and prevent balance inconsistencies?

Log wallet transactions by recording every balance change with type and context within a transactional service, enforcing atomic updates and validation rules to prevent data inconsistencies and ensure auditability.

How do wallet recharge plans handle gold and bonus coin distribution?

Wallet recharge plans distribute gold and bonus coins by updating user records with total recharged amounts and an optimistic lock version, ensuring deterministic deduction rules where only gold coins are deducted for draws.

Can I make admin wallet adjustments via API with guardrails?

Admin wallet adjustments via API include guardrails to enforce validation and transactional updates, ensuring all balance modifications are logged consistently and auditable within the transactional service.

Why do I need transactional updates for user wallet operations?

Transactional updates for user wallet operations are required to prevent inconsistencies between coin balance updates and transaction logs, ensuring atomic execution and maintaining a reliable audit trail.

When should I prompt users for insufficient gold coins during a draw?

Prompt users for insufficient gold coins during a draw when the deterministic deduction rules detect the balance is too low, triggering an explicit recharge request before the transactional operation can proceed.