SIU — The Aura Minter¶
One-line pitch: SIU is the contract that turns your wallet address into your permanent Aura — the unforgeable fingerprint that identifies you in the game. Plumbing — you don't call it directly.
What this is¶
SIU takes your wallet address, mixes it with YANG's Pole values, and derives your Aura — a 64-bit number that is uniquely yours. It's also the contract that creates the user tokens that become your LAU, and it's responsible for filling in the Saat triple (Pole, Soul, Aura) that stamps every action you take.
You can read SIU.Aura() to see the current seed (it exposes the most recent Aura computation as a view).
If you've played a web3 game before¶
- Closest analogy: a deterministic key-derivation function that turns your address into a game-specific identity.
- Or: zkPassport — binds a real identity to an on-chain ID.
- Or: a Soulbound-ID minter — one per wallet, no transfers.
| Dysnomia term | What it maps to |
|---|---|
| SIU | Aura/Saat minter |
| Aura | Your 64-bit identity fingerprint |
| Saat | The (Pole, Soul, Aura) triple stamped on your actions |
| Soul | Stable 64-bit player ID (derived separately) |
| Psi | SIU's link to parent YANG |
What you actually do with it¶
- Nothing directly. SIU is invoked during LAU creation — the LAUFactory path.
Rewards / costs¶
- Cost: none directly.
- Reward: none — infrastructure.
Requirements & gating¶
- You need a wallet address (implicit).
Where it connects¶
Depends on YANG. Used by LAUFactory during account creation. Everything that reads your Soul + Aura (chat, battles, rewards) traces back to a SIU-derived identity.
Quick FAQ¶
Q: Can two wallets have the same Aura? A: Mathematically astronomically unlikely — the derivation is collision-resistant by design.
Q: If I lose my wallet key, can my Aura be regenerated? A: Aura is derived from the wallet address itself. If you lose access to that address, you lose access to that Aura — a new wallet gets a new Aura.
Want the Solidity? The contract reference lives at
technical/docs/core/09_SIU.md.