ZI — Spin (Step 5 of 6)¶
One-line pitch: ZI applies rotational modifiers to your XIE power based on your overall token holdings (Yuan) and your CHO balance.
What this is¶
ZI is step 5 of the power chain:
QI → MAI → XIA → XIE → ZI → PANG
It takes XIE's triad and spins it up. Physically, XIE is like a force vector; ZI adds angular momentum. The practical effect is four output values:
- Iota
- Omicron (modified)
- Omega (modified)
- Eta
These four are what PANG (step 6) combines for the final scoreboard.
Two inputs shape ZI:
- Yuan — your overall weighted holdings, read via CHOA.Yuan.
- CHO balance — how much of the CHO token you hold.
If you've played a web3 game before¶
- Closest analogy: buffs and debuffs applied on top of your base power.
- Or: a multiplier stage in a pricing curve — base × modifier = final.
- Or: a delegation boost — your votes worth more because of some extra qualification.
| Dysnomia term | What it maps to |
|---|---|
| ZI | The spin stage |
| Iota / Eta / Omicron / Omega | Four spin outputs consumed by PANG |
| Yuan | Your overall weighted token holdings (wallet + LAU + YUE) |
| CHO balance | How much of the CHO token you hold |
What you actually do with it¶
- Hold more of the ecosystem's tokens — increases Yuan, which pushes ZI up.
- Hold CHO specifically — CHO holdings are a separate factor.
- Observe outputs — ZI doesn't accept inputs from players; it's read during PANG's Push call.
Rewards / costs¶
- Cost: none.
- Reward: stronger spin → better PANG outputs → better territory and rewards.
Requirements & gating¶
- XIE must compute (i.e., you need active power chain state).
- Yuan must be non-zero (you need some holdings to get spin).
Where it connects¶
Reads XIE (step 4). Reads CHOA.Yuan for your weighted holdings. Feeds into PANG (step 6).
Quick FAQ¶
Q: Four outputs? Do I need to track all of them? A: As a player, no. They feed into PANG, which produces the values you actually care about.
Q: Can ZI make me weaker? A: In principle yes — if your Yuan or CHO balance drops, ZI drops. But it generally amplifies, not inverts, XIE's output.
Q: What's "spin" physically? A: In the game's metaphor, XIE gives you a straight-line force and ZI rotates it. In contract reality, ZI applies multiplicative and hash-based transforms on XIE's three numbers.
Want the Solidity? The contract reference lives at
technical/docs/domain/soeng/ZI.md.