Technical Reference

CHAN

Source updated:
Last updated:
Source Revision 0xb5795a39…261da0
Property Value
Source Revision 0xb5795a39986847f3f24ca4cf07279bfcf4a723f9b255e73f5a37673990261da0
Source URL https://raw.githubusercontent.com/busytoby/atropa_pulsechain/e7cc343be3dea9e3d3792ea4389c16530e649e0f/solidity/dysnomia/domain/sky/01_chan.sol
Source commit e7cc343be3dea9e3d3792ea4389c16530e649e0f
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 0xe2ab4058f48bb6c42b3af61edbf50b43d69d50f1aaa083d13f2a27254349d8e2
Compilation Closure Files 32
Hash Generated 2026-04-20T02:38:25Z

CHAN is the player channel manager that coordinates YUE (player banks) and handles opt-in mechanics for game contracts. It provides controlled access to player funds through the whitelist system.

  • Kind: Contract
  • License: Sharia
  • Solidity: ^0.8.21
  • Source: domain/sky/01_chan.sol
Contract address:
0xe250bf9729076B14A8399794B61C72d0F4AeFcd8
  1. self — CHAN
  2. DYSNOMIA
  3. MultiOwnable

Plain English Summary: CHAN is the player manager - it controls access to your bank (YUE). Before any game contract can touch your funds, you must explicitly opt-in through CHAN. This gives you granular control over which game features can access your tokens.

Real-World Analogy: Think of CHAN like the security settings on your bank account. You can authorize specific apps to access your account (opt-in) and revoke that access anytime (opt-out). No one can move your money without your explicit permission.

How It Affects Your Gameplay:

  • Opt-in control - You decide which contracts can access your YUE
  • YUE management - CHAN links your wallet address to your YUE bank
  • Transfer safety - Withdrawals and transfers only work with opted-in contracts
  • Account portability - You can transfer your YUE to a new wallet through CHAN
Variable Type Visibility Mutability Initial Value NatSpec
Type string public constant CHAN
Xie XIE public mutable ``
Yan mapping(address => address) public mutable ``
_optInList mapping(address => mapping(address => bool)) private mutable ``
Event Parameters Anonymous NatSpec
NewSpenderContractOptIn address Origin, address Yue, address Contract, bool Allow no
Error Parameters NatSpec
AlreadyAdded address Origin, address Yue, address New
NotOrigin address YueOrigin, address Requestor
PlayerMustOptIn address Player, address Yue, address Contract
constructorconstructor
constructor(address XieAddress) DYSNOMIA("Dysnomia Chan", "CHAN", address(DYSNOMIA(XieAddress).Xiao()))
  • Modifiers: DYSNOMIA("Dysnomia Chan", "CHAN", address(DYSNOMIA(XieAddress).Xiao()))
  • Parameters: address XieAddress
AddYuefunction
function AddYue(address Origin, address Yue) public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: address Origin, address Yue
TransferYuefunction
function TransferYue(address Yue, address NewOrigin) public

Open this function to load its call form.

  • Visibility: public
  • Parameters: address Yue, address NewOrigin
ReactYuefunction
function ReactYue(YUEINTERFACE Yue, address Qing) public onlyOwners returns (uint256 Charge)

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: YUEINTERFACE Yue, address Qing
  • Returns: uint256 Charge
OptInfunction
function OptIn(address Contract, bool Allow) public

Open this function to load its call form.

  • Visibility: public
  • Parameters: address Contract, bool Allow
OptedInfunction
function OptedIn(YUEINTERFACE Yue, address Contract) public view returns (bool)

Open this function to load its call form.

  • Visibility: public
  • State Mutability: view
  • Parameters: YUEINTERFACE Yue, address Contract
  • Returns: bool
YueWithdrawfunction
function YueWithdraw(YUEINTERFACE Yue, address Asset, address To, uint256 Amount) public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: YUEINTERFACE Yue, address Asset, address To, uint256 Amount
YueMintToOriginfunction
function YueMintToOrigin(YUEINTERFACE Yue) public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: YUEINTERFACE Yue
YueForceTransferfunction
function YueForceTransfer(YUEINTERFACE Yue, address From, address To, uint256 Amount) public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
  • Parameters: YUEINTERFACE Yue, address From, address To, uint256 Amount

Public and external functions below are callable through this contract’s address. Parent links identify where each member is defined.

External & Public Functions

Renamefunction
function Rename(string memory newName, string memory newSymbol) public virtual onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Virtual: yes
  • Modifiers: onlyOwners
  • Parameters: string memory newName, string memory newSymbol
mintToCapfunction
function mintToCap() public onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Modifiers: onlyOwners
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
Purchasefunction
function Purchase(address _t, uint256 _a) public

Open this function to load its call form.

  • Visibility: public
  • Parameters: address _t, uint256 _a
Redeemfunction
function Redeem(address _t, uint256 _a) public

Open 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
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
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
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
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
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
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
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
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
renounceOwnershipfunction
function renounceOwnership(address toRemove) public virtual onlyOwners

Open this function to load its call form.

  • Visibility: public
  • Virtual: yes
  • Modifiers: onlyOwners
  • Parameters: address toRemove
addOwnerfunction
function addOwner(address newOwner) public virtual onlyOwners

Open 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)
  • SEI - Player onboarding
  • CHOA - Game operations
  • YUE - Controlled by CHAN
function YueWithdraw(YUEINTERFACE Yue, address Asset, address To, uint256 Amount) public onlyOwners {
if(!_optInList[address(Yue)][msg.sender])
revert PlayerMustOptIn(Yue.Origin(), address(Yue), msg.sender);
Yue.Withdraw(Asset, To, Amount);
}
function TransferYue(address Yue, address NewOrigin) public {
// Check no conflict
if(Yan[NewOrigin] != address(0x0)) revert AlreadyAdded(...);
// Verify caller is origin
YUEINTERFACE _chi = YUEINTERFACE(Yue);
if(_chi.Origin() != tx.origin) revert NotOrigin(...);
// Update mappings
Yan[_chi.Origin()] = address(0x0);
_chi.ChangeOrigin(NewOrigin);
Yan[NewOrigin] = Yue;
}
Inherited functions and getters (6)
CHAN.MotzkinPrime()Read

Open this function to load its call form.

CHAN.Type()Read

Open this function to load its call form.

CHAN.Xiao()Read

Open this function to load its call form.

CHAN.Xie()Read

Open this function to load its call form.

CHAN.Yan(address)Read

Open this function to load its call form.

CHAN.maxSupply()Read

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": "address",
"name": "XieAddress",
"type": "address"
}
],
"stateMutability": "nonpayable",
"type": "constructor"
},
{
"inputs": [
{
"internalType": "address",
"name": "Origin",
"type": "address"
},
{
"internalType": "address",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "New",
"type": "address"
}
],
"name": "AlreadyAdded",
"type": "error"
},
{
"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": "YueOrigin",
"type": "address"
},
{
"internalType": "address",
"name": "Requestor",
"type": "address"
}
],
"name": "NotOrigin",
"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": "Player",
"type": "address"
},
{
"internalType": "address",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "Contract",
"type": "address"
}
],
"name": "PlayerMustOptIn",
"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": false,
"internalType": "address",
"name": "Origin",
"type": "address"
},
{
"indexed": false,
"internalType": "address",
"name": "Yue",
"type": "address"
},
{
"indexed": false,
"internalType": "address",
"name": "Contract",
"type": "address"
},
{
"indexed": false,
"internalType": "bool",
"name": "Allow",
"type": "bool"
}
],
"name": "NewSpenderContractOptIn",
"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": "Origin",
"type": "address"
},
{
"internalType": "address",
"name": "Yue",
"type": "address"
}
],
"name": "AddYue",
"outputs": [],
"stateMutability": "nonpayable",
"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": "Contract",
"type": "address"
},
{
"internalType": "bool",
"name": "Allow",
"type": "bool"
}
],
"name": "OptIn",
"outputs": [],
"stateMutability": "nonpayable",
"type": "function"
},
{
"inputs": [
{
"internalType": "contract YUEINTERFACE",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "Contract",
"type": "address"
}
],
"name": "OptedIn",
"outputs": [
{
"internalType": "bool",
"name": "",
"type": "bool"
}
],
"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": "contract YUEINTERFACE",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "Qing",
"type": "address"
}
],
"name": "ReactYue",
"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": [
{
"internalType": "address",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "NewOrigin",
"type": "address"
}
],
"name": "TransferYue",
"outputs": [],
"stateMutability": "nonpayable",
"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": [],
"name": "Xie",
"outputs": [
{
"internalType": "contract XIE",
"name": "",
"type": "address"
}
],
"stateMutability": "view",
"type": "function"
},
{
"inputs": [
{
"internalType": "address",
"name": "",
"type": "address"
}
],
"name": "Yan",
"outputs": [
{
"internalType": "address",
"name": "Yue",
"type": "address"
}
],
"stateMutability": "view",
"type": "function"
},
{
"inputs": [
{
"internalType": "contract YUEINTERFACE",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "From",
"type": "address"
},
{
"internalType": "address",
"name": "To",
"type": "address"
},
{
"internalType": "uint256",
"name": "Amount",
"type": "uint256"
}
],
"name": "YueForceTransfer",
"outputs": [],
"stateMutability": "nonpayable",
"type": "function"
},
{
"inputs": [
{
"internalType": "contract YUEINTERFACE",
"name": "Yue",
"type": "address"
}
],
"name": "YueMintToOrigin",
"outputs": [],
"stateMutability": "nonpayable",
"type": "function"
},
{
"inputs": [
{
"internalType": "contract YUEINTERFACE",
"name": "Yue",
"type": "address"
},
{
"internalType": "address",
"name": "Asset",
"type": "address"
},
{
"internalType": "address",
"name": "To",
"type": "address"
},
{
"internalType": "uint256",
"name": "Amount",
"type": "uint256"
}
],
"name": "YueWithdraw",
"outputs": [],
"stateMutability": "nonpayable",
"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"
}
]