Skip to content

Lifecycle ​

From launch to ongoing trading, each twin follows a predictable flow on Twin.fun.

Stages ​

  1. Create or Claim a Twin
    • Use a bytes16 twin ID.
    • Pre-map ownership if applicable and set the metadata URL via createDigitalTwin or setDigitalTwinUrl.
  2. Buy Keys
    • Price is computed from current supply using the quadratic bonding curve.
    • Buying increases supply and price; protocol and subject fees are taken on every trade.
  3. Use Access
    • The app checks your key balance for that twin and unlocks chat, tools, and other utilities.
  4. Sell Keys
    • Receive ETH based on the lower supply after selling, minus protocol and subject fees.

Sequence Diagram ​

UML sequence diagram showing creators and users interacting with the DigitalTwinSharesV1 contract and app surfaces
The sequence diagram highlights creation, trading, fee distribution, and key-gated access checks.