CHAN
0xe250bf9729076B14A8399794B61C72d0F4AeFcd80xb5795a39…261da0Source details
| Property | Value |
|---|---|
| Keccak256 Hash | 0xb5795a39986847f3f24ca4cf07279bfcf4a723f9b255e73f5a37673990261da0 |
| Source URL | https://raw.githubusercontent.com/busytoby/atropa_pulsechain/58607494f7741b80525953e4a85bc99e66fd20fc/solidity/dysnomia/domain/sky/01_chan.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 | 0xe2ab4058f48bb6c42b3af61edbf50b43d69d50f1aaa083d13f2a27254349d8e2 |
| Compilation Closure Files | 32 |
| Hash Generated | 2026-09-14T19:34:01Z |
Overview
Section titled “Overview”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
Inheritance Chain (C3 Linearized)
Section titled “Inheritance Chain (C3 Linearized)”- self — CHAN
- DYSNOMIA
- MultiOwnable
Immediate Parents
Section titled “Immediate Parents”What This Means For Players
Section titled “What This Means For Players”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
State Variables
Section titled “State Variables”| 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 | `` |
Events
Section titled “Events”| Event | Parameters | Anonymous | NatSpec |
|---|---|---|---|
NewSpenderContractOptIn |
address Origin, address Yue, address Contract, bool Allow | no |
Errors
Section titled “Errors”| Error | Parameters | NatSpec |
|---|---|---|
AlreadyAdded |
address Origin, address Yue, address New | |
NotOrigin |
address YueOrigin, address Requestor | |
PlayerMustOptIn |
address Player, address Yue, address Contract |
Constructor
Section titled “Constructor”constructor
Section titled “constructor”constructorconstructor
constructor(address XieAddress) DYSNOMIA("Dysnomia Chan", "CHAN", address(DYSNOMIA(XieAddress).Xiao()))- Modifiers:
DYSNOMIA("Dysnomia Chan", "CHAN", address(DYSNOMIA(XieAddress).Xiao())) - Parameters: address XieAddress
Functions
Section titled “Functions”External & Public
Section titled “External & Public”AddYue
Section titled “AddYue”AddYuefunction
function AddYue(address Origin, address Yue) public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: address Origin, address Yue
TransferYue
Section titled “TransferYue”TransferYuefunction
function TransferYue(address Yue, address NewOrigin) publicOpen this function to load its call form.
- Visibility: public
- Parameters: address Yue, address NewOrigin
ReactYue
Section titled “ReactYue”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) publicOpen this function to load its call form.
- Visibility: public
- Parameters: address Contract, bool Allow
OptedIn
Section titled “OptedIn”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
YueWithdraw
Section titled “YueWithdraw”YueWithdrawfunction
function YueWithdraw(YUEINTERFACE Yue, address Asset, address To, uint256 Amount) public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: YUEINTERFACE Yue, address Asset, address To, uint256 Amount
YueMintToOrigin
Section titled “YueMintToOrigin”YueMintToOriginfunction
function YueMintToOrigin(YUEINTERFACE Yue) public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: YUEINTERFACE Yue
YueForceTransfer
Section titled “YueForceTransfer”YueForceTransferfunction
function YueForceTransfer(YUEINTERFACE Yue, address From, address To, uint256 Amount) public onlyOwnersOpen this function to load its call form.
- Visibility: public
- Modifiers:
onlyOwners - Parameters: YUEINTERFACE Yue, address From, address To, uint256 Amount
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
- XIE - Power calculations
Depended On By
Section titled “Depended On By”Special Mechanisms
Section titled “Special Mechanisms”Opt-In Security
Section titled “Opt-In Security”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);}YUE Transfer
Section titled “YUE Transfer”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 (24)
CHAN.GetMarketRate(address _a)Read
Open this function to load its call form.
CHAN.MotzkinPrime()Read
Open this function to load its call form.
CHAN.Purchase(address _t, uint256 _a)Simulate / call
Open this function to load its call form.
CHAN.Redeem(address _t, uint256 _a)Simulate / call
Open this function to load its call form.
CHAN.Rename(string newName, string newSymbol)Simulate / call
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.addOwner(address newOwner)Simulate / call
Open this function to load its call form.
CHAN.allowance(address owner, address spender)Read
Open this function to load its call form.
CHAN.approve(address spender, uint256 value)Simulate / call
Open this function to load its call form.
CHAN.balanceOf(address account)Read
Open this function to load its call form.
CHAN.decimals()Read
Open this function to load its call form.
CHAN.maxSupply()Read
Open this function to load its call form.
CHAN.mintToCap()Simulate / call
Open this function to load its call form.
CHAN.name()Read
Open this function to load its call form.
CHAN.owner(address cOwner)Read
Open this function to load its call form.
CHAN.owner()Read
Open this function to load its call form.
CHAN.renounceOwnership(address toRemove)Simulate / call
Open this function to load its call form.
CHAN.symbol()Read
Open this function to load its call form.
CHAN.totalSupply()Read
Open this function to load its call form.
CHAN.transfer(address to, uint256 value)Simulate / call
Open this function to load its call form.
CHAN.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": "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" }]