currency-dual
Currency Dual
This skill owns wallet identity and the currency ledger. Store purchase verification/ownership belongs to entitlement-grant; offers belong to game-monetization/iap-offers; vendor pricing belongs to shop-price.
Modes
| Mode | Wallet pattern |
|---|---|
| one-wallet | one gameplay wallet |
| soft-hard | separate earned and purchased/premium wallet classes |
| battle-token | event/match/season token wallet |
Names are examples. A project may have additional wallets when each has explicit ownership and accounting rules.
Ledger contract
Every wallet has a stable wallet ID, currency definition ID and integer/fixed-point balance representation appropriate to the economy. Every grant, spend, conversion, refund and correction writes a ledger entry with stable transaction ID, reason/source and signed delta.
Applying the same transaction ID twice is idempotent. A spend validates sufficient balance or an explicit overdraft rule before commit. Multi-wallet conversion either commits both ledger sides atomically or neither side.