YUE
Source Revision 0xb3172df3…e494d2
| Property | Value |
|---|---|
| Source Revision | 0xb3172df3e8180d1cf21f0746a6d7a4e34ab245e5f02ff07dfef2a74184e494d2 |
| Source URL | https://raw.githubusercontent.com/busytoby/atropa_pulsechain/56aa1ff756b5dd335870dce727f48d91371ed9e3/solidity/dysnomia/domain/yue.sol |
| Source commit | 56aa1ff756b5dd335870dce727f48d91371ed9e3 |
| Source Status | Source snapshot; source hashes do not establish deployed bytecode equivalence. |
| 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 | 0xe349a3a76ebf7de51cbf67adad12e4a18a6acee8e8118262284901db2db6ff32 |
| Compilation Closure Files | 33 |
| Hash Generated | 2026-04-20T02:38:23Z |
Overview
Section titled “Overview”YUE is the player’s personal bank contract. Each player has a YUE that holds their assets, manages exchange rates, and provides withdrawals. It integrates with the CHAN for opt-in game mechanics.
- Kind: Contract
- License: Sharia
- Solidity: ^0.8.21
- Source:
domain/yue.sol
Inheritance Chain (C3 Linearized)
Section titled “Inheritance Chain (C3 Linearized)”- self — YUE
- DYSNOMIA
- MultiOwnable
Immediate Parents
Section titled “Immediate Parents”What This Means For Players
Section titled “What This Means For Players”YUE.Hong/Hung are public caller-funded trades against YUE inventory. CHAN opt-in protects specific withdrawal routes, not every outflow. Hypobar and Epibar accumulate XIE Omega and Omicron during React; they are not deposit/withdrawal totals and are not cleared by Hong, Hung or Withdraw.
Origin, MultiOwnable ownership and CHAN registry/opt-in state are separate. Direct Withdraw is restricted to CHAN and a token capability probe. IsValidAsset/GetAssetRate establish pair handling, not generic swap support.
State Variables
Section titled “State Variables”| Variable | Type | Visibility | Mutability | Initial Value | NatSpec |
|---|---|---|---|---|---|
Type |
string |
public | constant | YUE |
|
Chan |
CHAN |
public | mutable | `` | |
Origin |
address |
public | mutable | `` | |
Hypobar |
mapping(address => uint256) |
private | mutable | `` | |
Epibar |
mapping(address => uint256) |
private | mutable | `` |
Errors
Section titled “Errors”| Error | Parameters | NatSpec |
|---|---|---|
InvalidPair |
address SpendAsset, address ReceiveAsset | |
ExchangeRateNotFound |
address SpendAsset, address ReceiveAsset | |
OnlyGameTokens |
address what | |
OnlyChan |
address Sender, address Chan | |
ZeroHoldings |
address Who |
Constructor
Section titled “Constructor”constructor
Section titled “constructor”constructorconstructor
constructor(string memory name, string memory symbol, address ChanAddress) DYSNOMIA(name, symbol, address(DYSNOMIA(ChanAddress).Xiao()))- Modifiers:
DYSNOMIA(name, symbol, address(DYSNOMIA(ChanAddress).Xiao())) - Parameters: string memory name, string memory symbol, address ChanAddress
Functions
Section titled “Functions”External & Public
Section titled “External & Public”hasMint
Section titled “hasMint”hasMintfunction
function hasMint(address _contract) public view returns (bool does)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Parameters: address _contract
- Returns: bool does
ChangeOrigin
Section titled “ChangeOrigin”ChangeOriginfunction
function ChangeOrigin(address NewOrigin) public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: address NewOrigin
IsValidAsset
Section titled “IsValidAsset”IsValidAssetfunction
function IsValidAsset(address GwatAsset, address Integrative) public view returns (bool)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Parameters: address GwatAsset, address Integrative
- Returns: bool
Hongfunction
function Hong(address SpendAsset, address QingAsset, uint256 PurchaseAmount) publicOpen this function to load its call form.
- Visibility: public
- Parameters: address SpendAsset, address QingAsset, uint256 PurchaseAmount
Hungfunction
function Hung(address QingAsset, address ReceiveAsset, uint256 RedeemAmount) publicOpen this function to load its call form.
- Visibility: public
- Parameters: address QingAsset, address ReceiveAsset, uint256 RedeemAmount
GetAssetRate
Section titled “GetAssetRate”GetAssetRatefunction
function GetAssetRate(address GwatAsset, address Integrative) public view returns (uint256 Rate)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Parameters: address GwatAsset, address Integrative
- Returns: uint256 Rate
Withdraw
Section titled “Withdraw”Withdrawfunction
function Withdraw(address what, address To, uint256 amount) public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: address what, address To, uint256 amount
MintToOrigin
Section titled “MintToOrigin”MintToOriginfunction
function MintToOrigin() public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners
Barfunction
function Bar(address Qing) public view returns (uint256 Hypogram, uint256 Epigram)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Parameters: address Qing
- Returns: uint256 Hypogram, uint256 Epigram
Reactfunction
function React(address Qing) public onlyOwners returns (uint256 Charge)Open this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: address Qing
- Returns: uint256 Charge
Inherited Members
Section titled “Inherited Members”Public and external functions below are callable through this contract’s address. Parent links identify where each member is defined.
External & Public Functions
Rename
Section titled “Rename”Renamefunction
function Rename(string memory newName, string memory newSymbol) public virtual onlyOwnersOpen this function to load its call form.
- Visibility: public
- Virtual: yes
- Modifiers:
onlyOwners - Parameters: string memory newName, string memory newSymbol
mintToCap
Section titled “mintToCap”mintToCapfunction
function mintToCap() public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners
GetMarketRate
Section titled “GetMarketRate”GetMarketRatefunction
function GetMarketRate(address _a) public view returns (uint256)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Parameters: address _a
- Returns: uint256
Purchase
Section titled “Purchase”Purchasefunction
function Purchase(address _t, uint256 _a) publicOpen this function to load its call form.
- Visibility: public
- Parameters: address _t, uint256 _a
Redeem
Section titled “Redeem”Redeemfunction
function Redeem(address _t, uint256 _a) publicOpen this function to load its call form.
- Visibility: public
- Parameters: address _t, uint256 _a
namefunction
function name() public view virtual returns (string memory)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Returns: string memory
symbol
Section titled “symbol”symbolfunction
function symbol() public view virtual returns (string memory)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Returns: string memory
decimals
Section titled “decimals”decimalsfunction
function decimals() public view virtual returns (uint8)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Returns: uint8
totalSupply
Section titled “totalSupply”totalSupplyfunction
function totalSupply() public view virtual returns (uint256)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Returns: uint256
balanceOf
Section titled “balanceOf”balanceOffunction
function balanceOf(address account) public view virtual returns (uint256)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Parameters: address account
- Returns: uint256
transfer
Section titled “transfer”transferfunction
function transfer(address to, uint256 value) public virtual returns (bool)Open this function to load its call form.
- Visibility: public
- Virtual: yes
- Parameters: address to, uint256 value
- Returns: bool
allowance
Section titled “allowance”allowancefunction
function allowance(address owner, address spender) public view virtual returns (uint256)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Parameters: address owner, address spender
- Returns: uint256
approve
Section titled “approve”approvefunction
function approve(address spender, uint256 value) public virtual returns (bool)Open this function to load its call form.
- Visibility: public
- Virtual: yes
- Parameters: address spender, uint256 value
- Returns: bool
transferFrom
Section titled “transferFrom”transferFromfunction
function transferFrom(address from, address to, uint256 value) public virtual returns (bool)Open this function to load its call form.
- Visibility: public
- Virtual: yes
- Parameters: address from, address to, uint256 value
- Returns: bool
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 |
_approve |
function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual |
_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
ownerfunction
function owner() external view virtual returns (address)Open this function to load its call form.
- Visibility: external
- State Mutability: view
- Virtual: yes
- Returns: address
ownerfunction
function owner(address cOwner) public view virtual returns (bool)Open this function to load its call form.
- Visibility: public
- State Mutability: view
- Virtual: yes
- Parameters: address cOwner
- Returns: bool
renounceOwnership
Section titled “renounceOwnership”renounceOwnershipfunction
function renounceOwnership(address toRemove) public virtual onlyOwnersOpen this function to load its call form.
- Visibility: public
- Virtual: yes
- Modifiers:
onlyOwners - Parameters: address toRemove
addOwner
Section titled “addOwner”addOwnerfunction
function addOwner(address newOwner) public virtual onlyOwnersOpen this function to load its call form.
- Visibility: public
- Virtual: yes
- Modifiers:
onlyOwners - Parameters: address newOwner
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
- CHAN - Player management
Created By
Section titled “Created By”- SEI - Player onboarding
Special Mechanisms
Section titled “Special Mechanisms”Hong/Hung move tokens between msg.sender and YUE inventory. React increments Hypobar by Omega and Epibar by Omicron. These counters have no withdrawal/reset branch in this source. Direct withdrawal is CHAN-gated and separate from the public swap methods. See YUE behavior.
Inherited functions and getters (6)
YUE.Chan()Read
Open this function to load its call form.
YUE.MotzkinPrime()Read
Open this function to load its call form.
YUE.Origin()Read
Open this function to load its call form.
YUE.Type()Read
Open this function to load its call form.
YUE.Xiao()Read
Open this function to load its call form.
YUE.maxSupply()Read
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": "string", "name": "name", "type": "string" }, { "internalType": "string", "name": "symbol", "type": "string" }, { "internalType": "address", "name": "ChanAddress", "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": "SpendAsset", "type": "address" }, { "internalType": "address", "name": "ReceiveAsset", "type": "address" } ], "name": "ExchangeRateNotFound", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "SpendAsset", "type": "address" }, { "internalType": "address", "name": "ReceiveAsset", "type": "address" } ], "name": "InvalidPair", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "asset", "type": "address" } ], "name": "MarketRateNotFound", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "Sender", "type": "address" }, { "internalType": "address", "name": "Chan", "type": "address" } ], "name": "OnlyChan", "type": "error" }, { "inputs": [ { "internalType": "address", "name": "what", "type": "address" } ], "name": "OnlyGameTokens", "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" }, { "inputs": [ { "internalType": "address", "name": "Who", "type": "address" } ], "name": "ZeroHoldings", "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": [ { "internalType": "address", "name": "Qing", "type": "address" } ], "name": "Bar", "outputs": [ { "internalType": "uint256", "name": "Hypogram", "type": "uint256" }, { "internalType": "uint256", "name": "Epigram", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "Chan", "outputs": [ { "internalType": "contract CHAN", "name": "", "type": "address" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "NewOrigin", "type": "address" } ], "name": "ChangeOrigin", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "GwatAsset", "type": "address" }, { "internalType": "address", "name": "Integrative", "type": "address" } ], "name": "GetAssetRate", "outputs": [ { "internalType": "uint256", "name": "Rate", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "_a", "type": "address" } ], "name": "GetMarketRate", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "SpendAsset", "type": "address" }, { "internalType": "address", "name": "QingAsset", "type": "address" }, { "internalType": "uint256", "name": "PurchaseAmount", "type": "uint256" } ], "name": "Hong", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "QingAsset", "type": "address" }, { "internalType": "address", "name": "ReceiveAsset", "type": "address" }, { "internalType": "uint256", "name": "RedeemAmount", "type": "uint256" } ], "name": "Hung", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "GwatAsset", "type": "address" }, { "internalType": "address", "name": "Integrative", "type": "address" } ], "name": "IsValidAsset", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "MintToOrigin", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "MotzkinPrime", "outputs": [ { "internalType": "uint64", "name": "", "type": "uint64" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "Origin", "outputs": [ { "internalType": "address", "name": "", "type": "address" } ], "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": "Qing", "type": "address" } ], "name": "React", "outputs": [ { "internalType": "uint256", "name": "Charge", "type": "uint256" } ], "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": [], "name": "Type", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "what", "type": "address" }, { "internalType": "address", "name": "To", "type": "address" }, { "internalType": "uint256", "name": "amount", "type": "uint256" } ], "name": "Withdraw", "outputs": [], "stateMutability": "nonpayable", "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": [ { "internalType": "address", "name": "_contract", "type": "address" } ], "name": "hasMint", "outputs": [ { "internalType": "bool", "name": "does", "type": "bool" } ], "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" }]