TWF · World Turtle Farm doc: overview, rev.7 · status: in development

An engine that mints turtles out of mathematics

Every TWF turtle starts as a magic-square seed. The squares guarantee no two turtles can be identical; the genetics make them breedable; live market data keeps the images changing after mint. Rendering is distributed over Dask on Smelt GPU clusters.

Pitch deck

1.Magic-square seeds

A magic square is a grid of distinct numbers whose every row, column, and diagonal sums to the same constant. Each chain in TWF is assigned one historical square construction, from the 3×3 Lo Shu up to the 12×12 Dudeney, and each turtle is seeded by a unique square of that order. Uniqueness is a property of the math, not a promise in the metadata, and it can be verified on-chain.

816
357
492
3×3 Lo Shu — Pearl / Polygon
163213
510118
96712
415141
4×4 Dürer — Ruby / Tron
17241815
23571416
46132022
101219213
11182529
5×5 Agrippa — Diamond / Ethereum

2.Anatomy of a turtle

FieldValue
canvas969 × 969 px, with a frame of 36 chromosome units around the image
chromosomes4 — HEAD, SHAPE, SKIN, SHELL
base assets288 files per turtle, composited at render time
color scales4 per turtle, genetically inherited
elements8 possible (Fire, Water, Earth, Air, Lightning, Nature, Cosmic, Metal), emerging from 13 genetic factors
dynamicsTime turtles shift with day/night, seasons, and market hours; count turtles respond to transaction counts, block numbers, and volume

3.Nine chains, nine species

chain registry — one species and one standard per chain
Chain / jewelSpecies · squareStandardMechanic
Polygon · PearlSoftshell River Turtle · 3×3 Lo ShuPIP-1Fractal originals, no breeding, lowest fees
Tron · RubyFlatback · 4×4 DürerRIP-1Mass breeding events, shell museum, batch ops
Ethereum · DiamondGreen Sea Turtle · 5×5 AgrippaDIP-1Proposition breeding, family vaulting, premium genetics
Orange · TopazHawksbill · 6×6 FrenicleTIP-1Daily growth, coral reef habitat, resource gathering
Base · SapphireKemp's Ridley · 7×7 PascalSIP-1Territory claims, nesting grounds, migration routes
BSC · CitrineLoggerhead · 8×8 BachetCIP-1Egg incubation, temperature-dependent traits
Solana · EmeraldOlive Ridley · 9×9 EulerEIP-1Arribada mass-nesting community events
NooSphere · DeltoidLeatherback · 10×10 Ramanujan+NIP-1Smelting from all 7 jewel chains; Physics NFTs; Bronze/Silver/Gold up to 12×12
SUI · WaterSea Turtle · 11×11 LoubereWIP-1Water NFTs that feed turtles on other chains

4.Breeding notes

inheritance
Chromosomes combine from both parents. Color scales, designs, rotations, and elements pass down through genetic algorithms with mutation rates.
elements
The same genetics can express different elements; affinity emerges from 13 factors rather than a single gene.
skills
Roughly 5–10% of turtles carry the trait that allows skill inheritance. Three grades: Rare (1 slot), Epic (2), Legendary (3).
training
Four formats, Group, Small Group, Private, and Elite 1v1, trading stat gains against chances to learn skills.

5.Rendering pipeline

Compositing 288 assets into a 969px canvas for thousands of turtles isn't a single-machine job. Render tasks fan out over Dask onto Smelt's GPU clusters; Streamz pipes live market data into the compositor for the dynamic layers. Aether serves the finished images and metadata, handles IPFS pinning, and re-composites in real time when a dynamic layer changes. AckwardRoots supplies the market data; 5th Element Ink draws the base artwork; the House of Journeys contracts own minting, breeding, and staking on-chain; Delt is where you'll actually hold and trade them.

6.Access

Breeding fees, marketplace fees, and token economics live on-chain. Software access runs through your Colossal Capital tier: create an account or read the tier details. If you just want to know when minting opens, .

mint notifications

One email when the first clutch goes live. No newsletter, no drip campaign.