Technical Reference
ZI
Contract address
0xCbAdd3C3957Bd9D6C036863CB053FEccf3D53338Hash-verified
0xfc5b58a4…49faa6Source details
| Property | Value |
|---|---|
| Keccak256 Hash | 0xfc5b58a41455760782a2b87bbbd51f4990ccede26e7e3c9eb8e0e7fe7949faa6 |
| Source URL | https://raw.githubusercontent.com/busytoby/atropa_pulsechain/58607494f7741b80525953e4a85bc99e66fd20fc/solidity/dysnomia/domain/soeng/05_zi.sol |
| Source Revision | 58607494f7741b80525953e4a85bc99e66fd20fc |
| Source Status | Canonical source snapshot; deployed bytecode equivalence is only established where a deployment record says so. |
| Compiler | solc 0.8.21; optimizer enabled with 200 runs |
| Compiler Configuration | {"evmVersion":"compiler-default","optimizer":{"enabled":true,"runs":200},"version":"0.8.21+commit.d9974bed.Linux.g++"} |
| Compilation Closure Hash | 0x531814a48514a75240ff68ac65c90663ffb6bc799572ac0a20752314c8a4e095 |
| Compilation Closure Files | 35 |
| Hash Generated | 2026-09-14T19:34:12Z |
Overview
Section titled “Overview”ZI is the fifth contract in the soeng chain. It provides spin calculations using CHOA’s Yuan and CHO’s (Tethys) balance data.
- Kind: Contract
- License: Sharia
- Solidity: ^0.8.21
- Source:
domain/soeng/05_zi.sol
Inheritance Chain (C3 Linearized)
Section titled “Inheritance Chain (C3 Linearized)”- self — ZI
- DYSNOMIA
- MultiOwnable
Immediate Parents
Section titled “Immediate Parents”What This Means For Players
Section titled “What This Means For Players”Plain English Summary: ZI adds “spin” to your power calculations. It takes your XIE power values and applies rotational modifiers based on your Yuan (weighted token holdings) and CHO balance. Think of it as adding angular momentum to your linear power.
Real-World Analogy: If XIE measures how hard you can punch, ZI measures how much “spin” you can put on the punch. A spinning punch (high spin values) transfers energy differently than a straight punch, affecting the final impact.
How It Affects Your Gameplay:
- Spin values - Four outputs (Iota, Omicron, Omega, Eta) that modify game calculations
- Yuan weighting - Your overall token holdings (via CHOA.Yuan) influence spin
- Fifth in the chain - ZI prepares data for PANG’s final push calculations
State Variables
Section titled “State Variables”| Variable | Type | Visibility | Mutability | Initial Value | NatSpec |
|---|---|---|---|---|---|
Type |
string |
public | constant | ZI |
|
Choa |
CHOA |
public | mutable | `` | |
Tethys |
CHOINTERFACE |
public | mutable | `` |
Constructor
Section titled “Constructor”constructor
Section titled “constructor”constructorconstructor
constructor(address ChoaAddress) DYSNOMIA("Dysnomia Zi", "ZI", address(DYSNOMIA(ChoaAddress).Xiao()))- Modifiers:
DYSNOMIA("Dysnomia Zi", "ZI", address(DYSNOMIA(ChoaAddress).Xiao())) - Parameters: address ChoaAddress
Functions
Section titled “Functions”External & Public
Section titled “External & Public”Spinfunction
function Spin(uint256 QingWaat) public returns (uint256 Iota, uint256 Omicron, uint256 Omega, uint256 Eta)Open this function to load its call form.
- Visibility: public
- Parameters: uint256 QingWaat
- Returns: uint256 Iota, uint256 Omicron, uint256 Omega, uint256 Eta
Inherited Members
Section titled “Inherited Members”This contract inherits the members below from its parents. See each parent’s dedicated MD for full signatures, NatSpec, and semantics.
External & Public Functions
| Function | Signature | State Mutability |
|---|---|---|
Rename |
function Rename(string memory newName, string memory newSymbol) public virtual onlyOwners |
nonpayable |
mintToCap |
function mintToCap() public onlyOwners |
nonpayable |
GetMarketRate |
function GetMarketRate(address _a) public view returns (uint256) |
view |
Purchase |
function Purchase(address _t, uint256 _a) public |
nonpayable |
Redeem |
function Redeem(address _t, uint256 _a) public |
nonpayable |
name |
function name() public view virtual returns (string memory) |
view |
symbol |
function symbol() public view virtual returns (string memory) |
view |
decimals |
function decimals() public view virtual returns (uint8) |
view |
totalSupply |
function totalSupply() public view virtual returns (uint256) |
view |
balanceOf |
function balanceOf(address account) public view virtual returns (uint256) |
view |
transfer |
function transfer(address to, uint256 value) public virtual returns (bool) |
nonpayable |
allowance |
function allowance(address owner, address spender) public view virtual returns (uint256) |
view |
approve |
function approve(address spender, uint256 value) public virtual returns (bool) |
nonpayable |
transferFrom |
function transferFrom(address from, address to, uint256 value) public virtual returns (bool) |
nonpayable |
Internal Functions
| Function | Signature |
|---|---|
_addLibraryOwner |
function _addLibraryOwner(VOID Void, string memory what) internal |
_mintToCap |
function _mintToCap() internal |
_addMarketRate |
function _addMarketRate(address _a, uint256 _r) internal |
_transfer |
function _transfer(address from, address to, uint256 value) internal |
_update |
function _update(address from, address to, uint256 value) internal virtual |
_mint |
function _mint(address account, uint256 value) internal |
_approve |
function _approve(address owner, address spender, uint256 value) internal |
_spendAllowance |
function _spendAllowance(address owner, address spender, uint256 value) internal virtual |
Events
| Event | Parameters |
|---|---|
Transfer |
address indexed from, address indexed to, uint256 value |
Approval |
address indexed owner, address indexed spender, uint256 value |
Errors
| Error | Parameters |
|---|---|
MarketRateNotFound |
address asset |
DysnomiaInsufficientBalance |
address origin, address sender, address from, address to, address what, uint256 balance, uint256 needed |
DysnomiaInsufficientAllowance |
address origin, address sender, address owner, address spender, address what, uint256 allowance, uint256 needed |
State Variables (private parent storage is not reachable and is omitted)
| Variable | Type | Visibility | Mutability |
|---|---|---|---|
__name |
string |
internal | mutable |
__symbol |
string |
internal | mutable |
MotzkinPrime |
uint64 |
public | constant |
Xiao |
atropaMath |
public | mutable |
maxSupply |
uint256 |
public | mutable |
External & Public Functions
| Function | Signature | State Mutability |
|---|---|---|
owner |
function owner() external view virtual returns (address) |
view |
renounceOwnership |
function renounceOwnership(address toRemove) public virtual onlyOwners |
nonpayable |
addOwner |
function addOwner(address newOwner) public virtual onlyOwners |
nonpayable |
Internal Functions
| Function | Signature |
|---|---|
_checkOwner |
function _checkOwner() internal view virtual |
_changeOwnership |
function _changeOwnership(address cOwner, bool cState) internal virtual |
Events
| Event | Parameters |
|---|---|
OwnershipUpdate |
address indexed newOwner, bool indexed state |
Errors
| Error | Parameters |
|---|---|
OwnableUnauthorizedAccount |
address origin, address account, address what |
OwnableInvalidOwner |
address origin, address owner, address what |
Modifiers
| Modifier | Parameters |
|---|---|
onlyOwners |
(none) |
Contract Interactions
Section titled “Contract Interactions”Depends On
Section titled “Depends On”- DYSNOMIA V2 - Base functionality
- CHOA - Yuan calculations
Depended On By
Section titled “Depended On By”- PANG - Uses ZI for push calculations
Special Mechanisms
Section titled “Special Mechanisms”Tethys Reference
Section titled “Tethys Reference”Tethys is CHO accessed through the contract chain:
Tethys = Choa.Sei().Chan().Xie().Xia().Mai().Qi().Zuo().Cho();Spin Calculation
Section titled “Spin Calculation”function Spin(uint256 QingWaat) public returns (uint256 Iota, uint256 Omicron, uint256 Omega, uint256 Eta) { uint256 Charge; User memory Alpha = Choa.Sei().Chan().Xie().Xia().Mai().Qi().Zuo().Cho().GetUser(); QINGINTERFACE Qing = Choa.Sei().Chan().Xie().Xia().Mai().Qi().Zuo().GetQing(QingWaat);
(Charge, Omicron, Omega) = Choa.Sei().Chan().Xie().Power(QingWaat);
Iota = Xiao.modExp(Omicron, Charge, Choa.Yuan(address(Tethys))); Omicron = Xiao.modExp(Omega, Charge, Choa.Yuan(address(Tethys))); Omega = Tethys.balanceOf(Alpha.On.Phi) / Alpha.Entropy; Eta = Tethys.balanceOf(address(Qing)) / Qing.Entropy();}Inherited functions and getters (24)
ZI.Choa()Read
Open this function to load its call form.
ZI.GetMarketRate(address _a)Read
Open this function to load its call form.
ZI.MotzkinPrime()Read
Open this function to load its call form.
ZI.Purchase(address _t, uint256 _a)Simulate / call
Open this function to load its call form.
ZI.Redeem(address _t, uint256 _a)Simulate / call
Open this function to load its call form.
ZI.Rename(string newName, string newSymbol)Simulate / call
Open this function to load its call form.
ZI.Tethys()Read
Open this function to load its call form.
ZI.Type()Read
Open this function to load its call form.
ZI.Xiao()Read
Open this function to load its call form.
ZI.addOwner(address newOwner)Simulate / call
Open this function to load its call form.
ZI.allowance(address owner, address spender)Read
Open this function to load its call form.
ZI.approve(address spender, uint256 value)Simulate / call
Open this function to load its call form.
ZI.balanceOf(address account)Read
Open this function to load its call form.
ZI.decimals()Read
Open this function to load its call form.
ZI.maxSupply()Read
Open this function to load its call form.
ZI.mintToCap()Simulate / call
Open this function to load its call form.
ZI.name()Read
Open this function to load its call form.
ZI.owner(address cOwner)Read
Open this function to load its call form.
ZI.owner()Read
Open this function to load its call form.
ZI.renounceOwnership(address toRemove)Simulate / call
Open this function to load its call form.
ZI.symbol()Read
Open this function to load its call form.
ZI.totalSupply()Read
Open this function to load its call form.
ZI.transfer(address to, uint256 value)Simulate / call
Open this function to load its call form.
ZI.transferFrom(address from, address to, uint256 value)Simulate / call
Open this function to load its call form.
Compiled ABI
Section titled “Compiled ABI”The compiled ABI below is produced by solc 0.8.21 from the exact source bytes recorded in Source details. Consumers can paste it directly into ethers/web3/viem.
Click to expand JSON ABI
[ { "inputs": [ { "internalType": "address", "name": "ChoaAddress", "type": "address" } ], "stateMutability": "nonpayable", "type": "constructor" }, { "inputs": [ { "internalType": "address", "name": "origin", "type": "address" }, { "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "address", "name": "owner", "type": "address" }, { "internalType": "address", "name": "spender", "type": "address" }, { "internalType": "address", "name": "what", "type": "address" }, { "internalType": "uint256", "name": "allowance", "type": "uint256" }, { "internalType": "uint256", "name": "needed", "type": "uint256" } ], "name": "DysnomiaInsufficientAllowance", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "origin", "type": "address" }, { "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "address", "name": "from", "type": "address" }, { "internalType": "address", "name": "to", "type": "address" }, { "internalType": "address", "name": "what", "type": "address" }, { "internalType": "uint256", "name": "balance", "type": "uint256" }, { "internalType": "uint256", "name": "needed", "type": "uint256" } ], "name": "DysnomiaInsufficientBalance", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "asset", "type": "address" } ], "name": "MarketRateNotFound", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "origin", "type": "address" }, { "internalType": "address", "name": "owner", "type": "address" }, { "internalType": "address", "name": "what", "type": "address" } ], "name": "OwnableInvalidOwner", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "origin", "type": "address" }, { "internalType": "address", "name": "account", "type": "address" }, { "internalType": "address", "name": "what", "type": "address" } ], "name": "OwnableUnauthorizedAccount", "type": "error" }, { "anonymous": false, "inputs": [ { "indexed": true, "internalType": "address", "name": "owner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "spender", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "value", "type": "uint256" } ], "name": "Approval", "type": "event" }, { "anonymous": false, "inputs": [ { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" }, { "indexed": true, "internalType": "bool", "name": "state", "type": "bool" } ], "name": "OwnershipUpdate", "type": "event" }, { "anonymous": false, "inputs": [ { "indexed": true, "internalType": "address", "name": "from", "type": "address" }, { "indexed": true, "internalType": "address", "name": "to", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "value", "type": "uint256" } ], "name": "Transfer", "type": "event" }, { "inputs": [], "name": "Choa", "outputs": [ { "internalType": "contract CHOA", "name": "", "type": "address" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "_a", "type": "address" } ], "name": "GetMarketRate", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "MotzkinPrime", "outputs": [ { "internalType": "uint64", "name": "", "type": "uint64" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "_t", "type": "address" }, { "internalType": "uint256", "name": "_a", "type": "uint256" } ], "name": "Purchase", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "_t", "type": "address" }, { "internalType": "uint256", "name": "_a", "type": "uint256" } ], "name": "Redeem", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "string", "name": "newName", "type": "string" }, { "internalType": "string", "name": "newSymbol", "type": "string" } ], "name": "Rename", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "QingWaat", "type": "uint256" } ], "name": "Spin", "outputs": [ { "internalType": "uint256", "name": "Iota", "type": "uint256" }, { "internalType": "uint256", "name": "Omicron", "type": "uint256" }, { "internalType": "uint256", "name": "Omega", "type": "uint256" }, { "internalType": "uint256", "name": "Eta", "type": "uint256" } ], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "Tethys", "outputs": [ { "internalType": "contract CHOINTERFACE", "name": "", "type": "address" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "Type", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "Xiao", "outputs": [ { "internalType": "contract atropaMath", "name": "", "type": "address" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "newOwner", "type": "address" } ], "name": "addOwner", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "owner", "type": "address" }, { "internalType": "address", "name": "spender", "type": "address" } ], "name": "allowance", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "spender", "type": "address" }, { "internalType": "uint256", "name": "value", "type": "uint256" } ], "name": "approve", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "account", "type": "address" } ], "name": "balanceOf", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "decimals", "outputs": [ { "internalType": "uint8", "name": "", "type": "uint8" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "maxSupply", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "mintToCap", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "name", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "cOwner", "type": "address" } ], "name": "owner", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "owner", "outputs": [ { "internalType": "address", "name": "", "type": "address" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "toRemove", "type": "address" } ], "name": "renounceOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "symbol", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "totalSupply", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "to", "type": "address" }, { "internalType": "uint256", "name": "value", "type": "uint256" } ], "name": "transfer", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "from", "type": "address" }, { "internalType": "address", "name": "to", "type": "address" }, { "internalType": "uint256", "name": "value", "type": "uint256" } ], "name": "transferFrom", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "nonpayable", "type": "function" }]