Skip to content

LAU — Your Player Account

One-line pitch: Your LAU is your character. It's a token you own, and it is you in Dysnomia.

What this is

Your LAU is a personal ERC-20 token that represents you in the game. When you sign up, a fresh LAU gets deployed and you become its owner. Everything you do afterwards — chatting, earning rewards, claiming territory, moving between venues — happens through your LAU.

You only ever have one active LAU per wallet. It's yours forever unless you destroy it (Void) or walk away from it (Leave).

If you've played a web3 game before

  • Think of a LAU as your player profile + wallet fused into a single on-chain object.
  • Closest analogy: Steam profile + your MetaMask address + a Discord account, bundled into one token you provably own.
  • If you're familiar with ERC-6551 token-bound accounts, LAU plays a similar role — a character object that can itself hold balances and take actions.
Dysnomia term What it maps to
LAU Your player token — the thing your friends "@" when they talk to you
Soul Your permanent 64-bit player ID (like a Steam ID)
Aura Your wallet's fingerprint (proves this LAU really belongs to you)
Saat The three-part identity signature [Pole, Soul, Aura]
CurrentArea The QING you're "standing in" right now

What you actually do with it

  • Chat — Send messages to venues using your LAU. The LAU is the thing that gets credit for the message.
  • Withdraw tokens — Move any token out of your LAU into your wallet whenever you want.
  • Set your username — How everyone sees you in chat. Stored on the LAU itself.
  • Create aliases — Give human-readable names to other wallet addresses so you don't deal with 0x… strings.
  • Track your location — CurrentArea tells you which QING you're currently inside.
  • Leave / Void — Step out of a venue (Leave) or permanently destroy the account (Void — two confirmations required so you can't do it by accident).

Rewards / costs

  • Holding your LAU: free. It's yours, sit on it as long as you like.
  • Chat: earns you up to 1 MAI per message if you hold tokens of the venue you're chatting at. Otherwise it's free (just gas).
  • Withdraw: moves tokens from your LAU to your external wallet. Costs gas; no protocol fee.
  • Void: wipes the LAU. Anything still in it is lost — empty it first.

Requirements & gating

  • You must be the owner of your LAU (enforced by onlyOwners). Both your wallet address and any contract that signed you up are marked as owners by default.
  • Every venue you Join re-checks with CHO that your LAU is legit before letting you act.
  • If you (or the LAU) ever hold a WITHOUT token, you're banned and actions will revert.

Where it connects

Your LAU sits at the center of everything. It's created by the LAU Factory at signup, its session is managed by VOID, its authentication goes through CHO, and its earnings get banked in YUE. When you walk into a QING, it's your LAU that's on the guest list. When you chat, it's your LAU that speaks.

Quick FAQ

Q: Can I transfer my LAU to a friend? A: You can transfer LAU tokens (the balance), but the ownership role is separate. Selling your LAU account is not how the game expects to be used — add your friend as an owner with addOwner instead.

Q: What happens if I lose access to my wallet? A: If no co-owner exists, the LAU is orphaned. Anyone you added via addOwner still has control. Adding a backup wallet as an owner is a reasonable safety move.

Q: Can I have two LAUs? A: Yes — nothing stops you from deploying more. But each LAU is a separate player with a separate Soul. They don't share balances or history.

Q: What's the difference between my LAU and my YUE? A: LAU = you (character, identity, chat, location). YUE = your bank (earnings, opt-ins, withdrawals). CHOA creates your YUE automatically on your first Play.

Q: Why is it called LAU? A: It's a Cantonese word (樓) roughly meaning "building" / "the structure you live in" — fitting for a contract that houses your identity.

Want the Solidity? The contract reference lives at technical/docs/core/11_LAU.md in the same repository — function signatures, state variables, inheritance chain, and the on-chain keccak256 hash.