YUE — Your In-Game Bank
One-line pitch: Your YUE is a personal bank vault that collects your rewards and lets you swap tokens at built-in rates.
What this is
Section titled “What this is”Every player has exactly one YUE. It is created by SEI.Start() before YUE-dependent gameplay. Your YUE:
- Holds every asset you earn (H2O, VITUS, venue tokens, etc.) until you pull them out.
- Has built-in buy/sell functions (
Hong/Hung) for venue tokens at their internal market rate. - Tracks your activity per-venue as two running counters: Hypobar (value flowing in) and Epibar (value flowing out).
- Uses CHAN as its gatekeeper — no contract can pull from your YUE unless you’ve explicitly opted them in.
Your LAU is you. Your YUE is your account.
If you’ve played a web3 game before
Section titled “If you’ve played a web3 game before”- Closest analogy: a multi-asset escrow wallet / smart-contract wallet scoped to one player.
- Or: a managed game vault whose controller contracts enforce player-selected opt-ins.
- Or: the “Rewards” tab in a DeFi protocol, except it can hold arbitrary tokens and has its own swap function.
| Dysnomia term | What it maps to |
|---|---|
| Hong | Buy (e.g. “I want in on this QING”) |
| Hung | Sell (e.g. “I want out of this QING”) |
| Hypobar | Running total of value that flowed INTO the YUE for a given asset |
| Epibar | Running total of value that flowed OUT of the YUE for a given asset |
| Origin | The wallet CHAN associates with the YUE; distinct from MultiOwnable ownership |
What you actually do with it
Section titled “What you actually do with it”- Deposit / accumulate — most rewards arrive here automatically (CHEON mints into your YUE).
- Withdraw supported rewards — use the reward token’s public withdrawal entry point, such as
VITUS.Withdraw, after its CHAN opt-in. DirectYUE.Withdrawis restricted to CHAN-owned stock calls. - Hong (buy) — trade DYSNOMIA-family tokens for a venue’s QING tokens at the contract’s market rate.
- Hung (sell) — reverse the above — trade QING tokens back for the venue’s underlying asset.
- Check your activity counters — call
Bar(qingAddress)to see your trading footprint.
Use these calls here. Simulations preview the current state; each confirmed call is a separate transaction.
YUE.Bar(address Qing)Read
Open this function to load its call form.
YUE.GetAssetRate(address GwatAsset, address Integrative)Read
Open this function to load its call form.
YUE.IsValidAsset(address GwatAsset, address Integrative)Read
Open this function to load its call form.
YUE.Hong(address SpendAsset, address QingAsset, uint256 PurchaseAmount)Simulate / call
Open this function to load its call form.
YUE.Hung(address QingAsset, address ReceiveAsset, uint256 RedeemAmount)Simulate / call
Open this function to load its call form.
VITUS.Withdraw(uint256 Amount)Simulate / call
A callable deployment has not been resolved for this reference.
Rewards / costs
Section titled “Rewards / costs”- Holding: free. Your YUE doesn’t charge a storage fee.
- Hong / Hung: use the contract’s internal market rate; no external DEX slippage, no external fees beyond gas.
- Withdraw: just gas.
Requirements & gating
Section titled “Requirements & gating”- You need to have called SEI.Start — that creates and registers the YUE.
- Contracts wanting to move funds out of your YUE need to be opted-in via CHAN. Otherwise they revert with
OnlyChan. - Hong and Hung only work with game tokens — you can’t use YUE as a general-purpose swap router. If the asset isn’t a recognized QING, it reverts with
OnlyGameTokens.
Where it connects
Section titled “Where it connects”- Created by SEI when you call
Start(). - Guarded by CHAN — every spender contract goes through there.
- Paid into by CHEON — your rewards pipeline mints directly to your YUE.
- Interacts with any QING you Hong/Hung into.
Quick FAQ
Section titled “Quick FAQ”Q: Can I transfer my YUE to a new wallet?
A: Yes, through CHAN.TransferYue. The current Origin signs and selects a wallet with no existing YUE. Origin controls that routing check but is not itself a MultiOwnable owner role.
Q: Can someone drain my YUE?
A: Stock withdrawal routes require both CHAN-controlled authority and the relevant opt-in. You can revoke the opt-in, but direct YUE ownership and the Origin field are separate permissions.
Q: Why do I have a LAU AND a YUE? A: Separation of concerns. LAU = identity and actions (chat, location). YUE = value and bookkeeping (balances, trades, opt-ins). Corrupt one doesn’t corrupt the other.
Q: What are Hypobar and Epibar really for? A: They’re cumulative flow counters used by the power chain (specifically XIE and downstream) to tell how active you’ve been with a given asset. More activity = higher Charge.
Q: Does the YUE ever mint new tokens on its own? A: It accepts mints from CHEON (your rewards) and participates in market swaps. It doesn’t inflate arbitrarily.
Want the Solidity? The contract reference lives at
technical/docs/domain/YUE.md.