Skip to content

CHEON — Payroll

One-line pitch: CHEON is the paymaster. It figures out what you earned, and mints the rewards into your YUE.

What this is

CHEON is the reward computation and disbursement contract. When your activity triggers a payout — chatting at a QING, claiming WORLD territory, surviving a WAR — CHEON's Su() function runs. It:

  1. Reads your Charge (combat/power value) and your Hypobar/Epibar activity counters.
  2. Computes how much of the venue's reward is yours.
  3. Mints that reward directly into your YUE.

You never call CHEON yourself. It gets called by upstream gameplay contracts on your behalf. But understanding it helps you understand why rewards show up the way they do.

If you've played a web3 game before

  • Closest analogy: a rewards distributor contract in DeFi (think Merkle-based airdrop distributor, except it runs live per-action).
  • Or: MMO XP/gold calculator — same activity → same reward, formula-based, no human payroll.
  • Or: block rewards in a PoW/PoS chain — your share depends on your stake/work.
Dysnomia term What it maps to
Su() The "compute and pay" function
Charge Your battle / power score
Hypobar Value-in flow, per asset
Epibar Value-out flow, per asset

What you actually do with it

  • You don't call CHEON directly. Gameplay contracts call it for you.
  • You observe it — rewards appearing in your YUE are the visible output.

Advanced players might care about optimizing the inputs:

  • Higher Charge → bigger reward slice.
  • Hypobar/Epibar ratios influence how the slice is calculated for some actions.
  • Hold more of a venue's token → different MAI payout on chat.

Rewards / costs

  • Cost: nothing extra beyond the triggering action's gas.
  • Reward: that's what this whole contract IS. CHEON's mint calls are how H2O, VITUS, and MAI reach you.

Requirements & gating

  • Caller contract must be trusted infrastructure (it mints real value).
  • Your YUE must exist and be opt-in for the calling contract via CHAN.
  • Your Charge is calculated upstream in the soeng power chain; garbage in → garbage out.

Where it connects

CHEON reads state from SEI to find your YUE, from CHAN for opt-in status, and from the power chain for your Charge. It mints into your YUE. Triggered by CHOA (Play/Chat rewards), WORLD (territory rewards), WAR (battle rewards).

Quick FAQ

Q: Can I predict exactly what I'll earn? A: Approximately — the math is deterministic given your Charge and activity state. But because your Charge depends on the soeng chain and the chain depends on global entropy, small inputs can ripple.

Q: Why did my reward differ between two seemingly identical actions? A: Your Hypobar/Epibar counters move with every action. Reward math reads them live, so identical inputs at different moments produce different outputs.

Q: Are rewards taxed / fee'd? A: No protocol fee. You pay gas, that's it.

Q: What if my YUE isn't opt-in for the calling contract? A: The call reverts. You'd lose the triggering action's effect. Always opt-in your gameplay contracts via CHAN.

Want the Solidity? The contract reference lives at technical/docs/domain/tang/CHEON.md.