Skip to content
Technical Reference

YUE

Contract addressInstance-specific
Hash-verified 0xb3172df3…e494d2
Source details
Property Value
Keccak256 Hash 0xb3172df3e8180d1cf21f0746a6d7a4e34ab245e5f02ff07dfef2a74184e494d2
Source URL https://raw.githubusercontent.com/busytoby/atropa_pulsechain/58607494f7741b80525953e4a85bc99e66fd20fc/solidity/dysnomia/domain/yue.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 0xe349a3a76ebf7de51cbf67adad12e4a18a6acee8e8118262284901db2db6ff32
Compilation Closure Files 33
Hash Generated 2026-09-14T19:33:47Z

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
  1. selfYUE
  2. DYSNOMIA
  3. MultiOwnable

Plain English Summary: YUE is your personal bank - it holds your winnings and handles exchanges. Every player has their own YUE that stores game tokens, tracks activity, and lets you trade between different currencies. It’s like having a private bank account in the game.

Real-World Analogy: Think of YUE as your bank account plus a currency exchange booth. You can deposit earnings, withdraw to your wallet, and exchange one type of game token for another. Your YUE remembers your transaction history and calculates rates for exchanges.

How It Affects Your Gameplay:

  • Hold assets - Game rewards and earnings accumulate in your YUE
  • Exchange tokens - Use Hong to buy and Hung to sell QING tokens
  • Withdraw - Move tokens from your YUE to your actual wallet
  • Track activity - Your bar values (Hypobar/Epibar) record your QING interactions
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 ``
Error Parameters NatSpec
InvalidPair address SpendAsset, address ReceiveAsset
ExchangeRateNotFound address SpendAsset, address ReceiveAsset
OnlyGameTokens address what
OnlyChan address Sender, address Chan
ZeroHoldings address Who
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
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
ChangeOriginfunction
function ChangeOrigin(address NewOrigin) public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: address NewOrigin
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) public

Open 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) public

Open this function to load its call form.

  • Visibility: public
  • Parameters: address QingAsset, address ReceiveAsset, uint256 RedeemAmount
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
Withdrawfunction
function Withdraw(address what, address To, uint256 amount) public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: address what, address To, uint256 amount
MintToOriginfunction
function MintToOrigin() public onlyOwners

Open 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

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)
  • SEI - Player onboarding
function IsValidAsset(address GwatAsset, address Integrative) {
QINGINTERFACE Gwat = QINGINTERFACE(GwatAsset);
while (Type != "QING") {
if(Gwat.Asset() == Integrative) return true;
Gwat = QINGINTERFACE(Gwat.Asset());
}
return Gwat.Asset() == Integrative;
}

Rates are computed by traversing the QING chain and multiplying rates with a discount modifier:

Mod = (AssetRate / (10 ** (decimals - 2)));
if(Mod < 777) Rate = Rate/((777 - Mod) * 10 ** (decimals - 5));

Sensitive operations require the caller to be CHAN:

if(msg.sender != address(Chan)) revert OnlyChan(msg.sender, address(Chan));

React() accumulates values for later use:

Hypobar[Qing] += Omega;
Epibar[Qing] += Omicron;





Inherited functions and getters (24)
YUE.Chan()Read

Open this function to load its call form.

YUE.GetMarketRate(address _a)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.Purchase(address _t, uint256 _a)Simulate / call

Open this function to load its call form.

YUE.Redeem(address _t, uint256 _a)Simulate / call

Open this function to load its call form.

YUE.Rename(string newName, string newSymbol)Simulate / call

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.addOwner(address newOwner)Simulate / call

Open this function to load its call form.

YUE.allowance(address owner, address spender)Read

Open this function to load its call form.

YUE.approve(address spender, uint256 value)Simulate / call

Open this function to load its call form.

YUE.balanceOf(address account)Read

Open this function to load its call form.

YUE.decimals()Read

Open this function to load its call form.

YUE.maxSupply()Read

Open this function to load its call form.

YUE.mintToCap()Simulate / call

Open this function to load its call form.

YUE.name()Read

Open this function to load its call form.

YUE.owner(address cOwner)Read

Open this function to load its call form.

YUE.owner()Read

Open this function to load its call form.

YUE.renounceOwnership(address toRemove)Simulate / call

Open this function to load its call form.

YUE.symbol()Read

Open this function to load its call form.

YUE.totalSupply()Read

Open this function to load its call form.

YUE.transfer(address to, uint256 value)Simulate / call

Open this function to load its call form.

YUE.transferFrom(address from, address to, uint256 value)Simulate / call

Open this function to load its call form.

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"
}
]