XIE¶
Overview¶
XIE is the fourth contract in the soeng chain. It calculates power values using Fornax SHIO and provides the Power function used throughout the game.
- Inherits: DYSNOMIA V2
- License: Sharia
- Solidity: ^0.8.21
What This Means For Players¶
Plain English Summary: XIE is where your true "Power" gets calculated. It takes XIA's charge and adds SHIO-based metrics (Omicron and Omega) to produce a three-part power reading. This is the stat that actually matters for most game mechanics.
Real-World Analogy: XIE is like the final score in a triathlon - it combines your performance across multiple events (Charge, Omicron, Omega) into a comprehensive power rating that shows your overall strength relative to a venue.
How It Affects Your Gameplay: - Power output - Your Power(QING) value determines your influence at that venue - Three metrics - Charge, Omicron, and Omega each contribute differently - Used by CHAN - The CHAN player manager references XIE for power calculations
State Variables¶
| Variable | Type | Visibility | Description |
|---|---|---|---|
| Type | string | public constant | "XIE" |
| Xia | XIA | public | Reference to XIA |
| Fornax | SHIO | public | Reference to YI's SHIO (Psi) |
Write Functions¶
Power¶
- Access:public
- Parameters:
- QingWaat (uint256): Target QING's position identifier (Waat)
- Returns:
- Charge (uint256): Combined charge from XIA (sum of QI and MAI values)
- Omicron (uint256): User's Fornax balance divided by their entropy
- Omega (uint256): QING's Fornax balance divided by its entropy
- Description: Calculates comprehensive power metrics by combining XIA.Charge with Fornax SHIO balances.
- Logic Flow:
1. Look up current user: Alpha = Xia.Mai().Qi().Zuo().Cho().GetUser()
2. Look up QING: Qing = Xia.Mai().Qi().Zuo().GetQing(QingWaat)
3. Get XIA charge: Charge = Xia.Charge(QingWaat)
4. Calculate Omicron: Fornax.balanceOf(Alpha.On.Phi) / Alpha.Entropy
5. Calculate Omega: Fornax.balanceOf(address(Qing)) / Qing.Entropy()
6. Return all three values
- Computation Details:
- Charge = from XIA (which is QI + MAI)
- Omicron = User's Fornax (YI.Psi) holdings / entropy
- Omega = QING's Fornax holdings / entropy
- Fornax is YI's primary SHIO, representing core protocol participation
- Side Effects: Triggers XIA.Charge calculation; mints tokens
- In Plain English: Get your complete power profile for a venue. Charge reflects your combined energy at this venue. Omicron is your share of the protocol's core SHIO tokens. Omega is the venue's share. These three values are used by ZI for spin calculations and ultimately determine your range and rewards.
Contract Interactions¶
Depends On¶
- DYSNOMIA V2 - Base functionality
- XIA - Charge calculations
Depended On By¶
Special Mechanisms¶
Fornax Reference¶
Fornax is YI's primary SHIO:
Power Calculation¶
function Power(uint256 QingWaat) public returns (uint256 Charge, uint256 Omicron, uint256 Omega) {
User memory Alpha = Xia.Mai().Qi().Zuo().Cho().GetUser();
QINGINTERFACE Qing = Xia.Mai().Qi().Zuo().GetQing(QingWaat);
Charge = Xia.Charge(QingWaat);
Omicron = Fornax.balanceOf(Alpha.On.Phi) / Alpha.Entropy;
Omega = Fornax.balanceOf(address(Qing)) / Qing.Entropy();
}
Contract Verification¶
| Property | Value |
|---|---|
| Keccak256 Hash | 0x05bd461959c1d1bdd03877f8841348a2a723db07354bb5f32a045e2ee334877a |
| Source URL | https://raw.githubusercontent.com/busytoby/atropa_pulsechain/main/solidity/dysnomia/domain/soeng/04_xie.sol |
| Hash Generated | 2026-02-08T00:29:08Z |