Player's Guide
SHIOFactory — The Locksmith
One-line pitch: SHIOFactory takes two SHA tokens and welds them into a player-owned SHIO pair.
What this is
Section titled “What this is”Single-function factory: New(Rod, Cone, MathLib) returns a new SHIO with both SHAs already owning-permission wired. Called by YI during account creation.
If you’ve played a web3 game before
Section titled “If you’ve played a web3 game before”- Closest analogy: a pool factory — but for crypto-paired identity tokens instead of LP pools.
- Or: a Safe factory variant — packages existing pieces into a coherent unit.
| Dysnomia term | What it maps to |
|---|---|
| SHIOFactory | Deployer contract for SHIO pairs |
| New(Rod, Cone, MathLib) | Returns a new SHIO bound to those two SHAs |
What you actually do with it
Section titled “What you actually do with it”- Normal play: let YI invoke it during account setup.
- Advanced: call
New(Rod, Cone, stockMath)with two SHA instances you own.
Use these calls here. Simulations preview the current state; each confirmed call is a separate transaction.
SHIOFactory
0x5063D2A97960DDE8dc5E3e5A69aAa379C6301F1CSHIOFactory.New(address Rod, address Cone, address MathLib)Simulate / call
Open this function to load its call form.
Rewards / costs
Section titled “Rewards / costs”- Cost: the direct caller pays SHIO deployment and ownership-wiring gas.
- Reward: none.
Requirements & gating
Section titled “Requirements & gating”- The transaction origin must own both SHA inputs so the factory can add the new SHIO to their owner mappings.
- Use the stock math contract for stock-compatible identity components.
Where it connects
Section titled “Where it connects”Produces SHIO instances from two SHA tokens. Used by YI.
Quick FAQ
Section titled “Quick FAQ”Q: Why have a separate factory for SHIO? A: It handles the specific wiring (ownership, pair linking) that differs from a naked SHA deployment.
Want the Solidity? The contract reference lives at
technical/core/03c_SHIOFACTORY.