Skip to content

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

Every player has exactly one YUE. It's a token contract deployed just for you the first time you Play(). 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

  • Closest analogy: a multi-asset escrow wallet / smart-contract wallet scoped to one player.
  • Or: a Safe (Gnosis) wallet that you're the sole owner of, with a built-in per-asset allowance list.
  • 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 Your wallet — stored as the owner of record on the YUE

What you actually do with it

  • Deposit / accumulate — most rewards arrive here automatically (CHEON mints into your YUE).
  • Withdraw — pull any balance back to your external wallet with transfer / Withdraw-style 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 — query Hypobar[asset] and Epibar[asset] to see your trading footprint.

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

  • You need to have Played at least once — that's what creates the YUE in the first place.
  • 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

  • Created by SEI when you call Start() (or automatically on first Play).
  • 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

Q: Can I transfer my YUE to a new wallet? A: Yes — YUE is tied to its Origin field which can be updated by you. Your new wallet becomes the effective owner. This is how accounts are portable.

Q: Can someone drain my YUE? A: Only if a contract is opted-in via CHAN. No opt-in = no access. If something is opted in and misbehaves, you can revoke it instantly.

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.