SEI¶

Overview¶

SEI is the player onboarding contract that creates YUE (player bank) instances and manages the Start function for new players.

Kind: Contract
License: Sharia
Solidity: ^0.8.21
Source: domain/tang/01_sei.sol

Inheritance Chain (C3 Linearized)¶

Immediate Parents¶

DYSNOMIA

What This Means For Players¶

Plain English Summary: SEI is the new player onboarding system. When you first start playing, SEI creates your YUE (personal bank) and connects it to your LAU (player account). It's the "Start" button that officially registers you as a player in the game.

Real-World Analogy: SEI is like the welcome desk at a new gym. When you first join, they set up your membership card (LAU), open your account (YUE), and give you access to all the facilities. After that, you can use Chi() to quickly access your account info.

How It Affects Your Gameplay: - First-time setup - Call Start() to create your YUE bank when you first play - Quick access - Use Chi() to get your YUE and LAU addresses - Rename option - Existing players can use Start() to rename their YUE

State Variables¶

Variable	Type	Visibility	Mutability	Initial Value	NatSpec
`Type`	`string`	public	constant	`SEI`
`Chan`	`CHAN`	public	mutable	``

Errors¶

Error	Parameters	NatSpec
`NotStarted`	address

Constructor¶

constructor¶

constructor(address ChanAddress) DYSNOMIA("Dysnomia Sei", "SEI", address(DYSNOMIA(ChanAddress).Xiao()))

Modifiers: DYSNOMIA("Dysnomia Sei", "SEI", address(DYSNOMIA(ChanAddress).Xiao()))
Parameters: address ChanAddress

Functions¶

External & Public¶

Chi¶

function Chi() public view returns (YUE Yue, LAU UserToken)

Visibility: public
State Mutability: view
Returns: YUE Yue, LAU UserToken

Start¶

function Start(address LauToken, string calldata YueName, string calldata YueSymbol) public returns (YUE Yue, LAU UserToken)

Visibility: public
Parameters: address LauToken, string calldata YueName, string calldata YueSymbol
Returns: YUE Yue, LAU UserToken

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
CHAN - YUE management

Creates¶

YUE - Player bank instances

Depended On By¶

CHEON - Uses SEI for player access
CHOA - Uses SEI.Chi()

Special Mechanisms¶

Chi Lookup¶

function Chi() public view returns (YUE Yue, LAU UserToken) {
    if(Chan.Yan(tx.origin) == address(0x0)) revert NotStarted(tx.origin);
    Yue = YUE(Chan.Yan(tx.origin));
    UserToken = LAU(Chan.Xie().Xia().Mai().Qi().Zuo().Cho().GetUserTokenAddress(tx.origin));
}

Start Function¶

function Start(address LauToken, string calldata YueName, string calldata YueSymbol) public returns (YUE Yue, LAU UserToken) {
    if(Chan.Yan(tx.origin) == address(0x0)) {
        // New player
        Chan.Xie().Xia().Mai().Qi().Zuo().Cho().Enter(LauToken);
        UserToken = LAU(LauToken);
        Yue = new YUE(YueName, YueSymbol, address(Chan));
        Yue.addOwner(address(Chan));
        Chan.AddYue(tx.origin, address(Yue));
        return (Yue, UserToken);
    }

    // Existing player - just rename
    (Yue, UserToken) = Chi();
    Yue.Rename(YueName, YueSymbol);
}

Contract Verification¶

Property	Value
Keccak256 Hash	`0x127529396b666fafea4654364c65dad4700cfab1e69b5c204881a4688ca1c1c3`
Source URL	https://raw.githubusercontent.com/busytoby/atropa_pulsechain/main/solidity/dysnomia/domain/tang/01_sei.sol
Hash Generated	2026-04-17T20:48:16Z