CHAN¶

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)¶

Immediate Parents¶

DYSNOMIA

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¶

Variable	Type	Visibility	Mutability	Initial Value
`Type`	`string`	public	constant	`CHAN`
`Xie`	`XIE`	public	mutable	``
`Yan`	`mapping(address => address)`	public	mutable	``
`_optInList`	`mapping(address => mapping(address => bool))`	private	mutable	``

Events¶

Event	Parameters	Anonymous	NatSpec
`NewSpenderContractOptIn`	address Origin, address Yue, address Contract, bool Allow	no

Errors¶

Error	Parameters	NatSpec
`AlreadyAdded`	address Origin, address Yue, address New
`NotOrigin`	address YueOrigin, address Requestor
`PlayerMustOptIn`	address Player, address Yue, address Contract

Constructor¶

constructor¶

constructor(address XieAddress) DYSNOMIA("Dysnomia Chan", "CHAN", address(DYSNOMIA(XieAddress).Xiao()))

Modifiers: DYSNOMIA("Dysnomia Chan", "CHAN", address(DYSNOMIA(XieAddress).Xiao()))
Parameters: address XieAddress

Functions¶

External & Public¶

AddYue¶

function AddYue(address Origin, address Yue) public onlyOwners

Visibility: public
Modifiers: onlyOwners
Parameters: address Origin, address Yue

TransferYue¶

function TransferYue(address Yue, address NewOrigin) public

Visibility: public
Parameters: address Yue, address NewOrigin

ReactYue¶

function ReactYue(YUEINTERFACE Yue, address Qing) public onlyOwners returns (uint256 Charge)

Visibility: public
Modifiers: onlyOwners
Parameters: YUEINTERFACE Yue, address Qing
Returns: uint256 Charge

OptIn¶

function OptIn(address Contract, bool Allow) public

Visibility: public
Parameters: address Contract, bool Allow

OptedIn¶

function OptedIn(YUEINTERFACE Yue, address Contract) public view returns (bool)

Visibility: public
State Mutability: view
Parameters: YUEINTERFACE Yue, address Contract
Returns: bool

YueWithdraw¶

function YueWithdraw(YUEINTERFACE Yue, address Asset, address To, uint256 Amount) public onlyOwners

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

YueMintToOrigin¶

function YueMintToOrigin(YUEINTERFACE Yue) public onlyOwners

Visibility: public
Modifiers: onlyOwners
Parameters: YUEINTERFACE Yue

YueForceTransfer¶

function YueForceTransfer(YUEINTERFACE Yue, address From, address To, uint256 Amount) public onlyOwners

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

Inherited Members¶

This contract inherits the members below from its parents. See each parent's dedicated MD for full signatures, NatSpec, and semantics.

From DYSNOMIA¶

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

From MultiOwnable¶

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¶

Depends On¶

DYSNOMIA V2 - Base functionality
XIE - Power calculations

Depended On By¶

SEI - Player onboarding
CHOA - Game operations
YUE - Controlled by CHAN

Special Mechanisms¶

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¶

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;
}

Contract Verification¶

Property	Value
Keccak256 Hash	`0xb5795a39986847f3f24ca4cf07279bfcf4a723f9b255e73f5a37673990261da0`
Source URL	https://raw.githubusercontent.com/busytoby/atropa_pulsechain/main/solidity/dysnomia/domain/sky/01_chan.sol
Hash Generated	2026-04-17T20:48:12Z