DINO Vault — Complete Collector's Guide

CollectibleTrust · DAO LLC · Dinosaur Vault Protocol
The definitive reference for minting, evolving, battling, and thriving in the DINO ecosystem.

What Is DINO Vault?
Getting Started
Minting Your Dinosaur — The Commit-Reveal Process
The Five Biomes — Lore, History and Bonuses
All 28 Traits Explained
Rarity System — Genus Groups and Scarcity Scores
The Aging System — Your Dinosaur Evolves Over Time
Trait Mutation — Changing Your Dinosaur's Anatomy
Cybernetic Grafting — Alloy Finishes via Uniswap V4
The 2015 Collectible Coin Badges
TWAP Aura — The Living Market Indicator
PvP Battle Arena
Inter-Biome Battle Advantage
Biome Migration
Leaderboard and Volume Tracking
Achievement Badges — Soulbound Proof of Legend
Biome Loyalty Streaks
Liquidity Provider Features
Extinction Events — Survive or Be Fossilized
Conservation Pledge — The Aye-Aye Fund
Adaptive Contrast System — How the Art Stays Readable
Wrapped DINO ERC-20 — The Protocol Token
On-Chain Art — What You Are Actually Seeing
Marketplace and Rarity Tools
Frequently Asked Questions
Quick Reference — All Trait Values

1. What Is DINO Vault?

DINO Vault is a fully on-chain, upgradeable NFT collection of 24 dinosaur genera living across 5 distinct biomes, each tied to a specific Uniswap V4 liquidity pool with real historical lore. Every DINO is:

Born with fair randomness — a two-step commit-reveal scheme prevents any miner, validator, or front-runner from predicting or manipulating traits before you reveal.
Rendered entirely on-chain — the SVG art and JSON metadata live inside the blockchain itself. No IPFS, no server, no single point of failure. Your DINO looks exactly as designed forever.
Genuinely evolving — traits change visually based on how long you hold, what you do on-chain, and what happens in the wider DINO economy.
Grounded in real 2015 history — each biome corresponds to a specific 2015 Ethereum token with documented historical significance. The lore is real.

Contract system

Contract	Role
`DinosaurVault`	ERC-721 NFT vault — minting, mutation, aging, biome logic
`DinosaurArtEngine`	On-chain SVG + JSON metadata renderer
`DinoStructures`	Shared type library — all enums, structs, traits
`DinoSwapHook`	V4 hook — graft, battle, leaderboard, TWAP
`DinoLiquidityManagerHook`	V4 hook — LP gating, loyalty, conservation
`DinoPoolRegistryHook`	V4 hook — biome assignment on pool creation
`DinoBattleArena`	PvP battles settled by Chainlink VRF v2.5
`DinoAchievements`	Soulbound ERC-1155 milestone badges
`DinoExtinctionTracker`	Epoch survival tracking, Merkle-proof extinction
`DinoLeaderboard`	Swap volume accumulator
`WrappedDinero`	ERC-20 DINO token (symbol: DINO) wrapping legacy Dinero 2015

2. Getting Started

What you need

An Ethereum wallet (MetaMask, Rabby, Coinbase Wallet, or any EIP-1193 compatible wallet)
ETH for gas fees
0.005 ETH incubation fee (mint fee)
0.002 ETH per trait mutation (optional, post-mint)

The five pools

To mint a DINO you must specify which Uniswap V4 pool you are minting into. This permanently assigns your biome. The five launch pools are:

Pool	Biome	Symbol
DINO/ETH	The Primordial Forge	🌋
DINO/USDC	The Crystal Vault	💎
DINO/CC	The Frontier Ruins	🏛
DINO/WMC	The Standard Origin	⚗️
DINO/WAAC	The Nocturnal Wilds	🦎

3. Minting Your Dinosaur

DINO Vault uses a two-step commit-reveal minting process. This is not a single transaction — it is a deliberate two-block design that guarantees manipulation-resistant randomness.

Why two steps?

If minting used a single transaction, a validator could see your transaction in the mempool and delay it until a block where the randomness gives them a desirable NFT. The commit-reveal scheme prevents this entirely.

Step 1 — Commit

Choose a secret random number as your seed. Keep it private.
Compute the commit hash off-chain:
```
commitHash = keccak256(abi.encodePacked(yourSeed, yourWalletAddress))
```
Most front-ends do this automatically and store the seed in your browser.
Call commitSeed(commitHash) on DinosaurVault. Gas cost only — no ETH fee.
Note the block number. You have at most 256 blocks (~51 minutes at 12s/block) to reveal before your commit expires.

Step 2 — Reveal and Incubate

In a different block than your commit (at least 1 block later, at most 256 blocks later), call:
```
revealAndIncubate(yourSeed, poolId)
```
- yourSeed — the exact number from Step 1
- poolId — the bytes32 ID of the V4 pool whose biome you want
Attach exactly 0.005 ETH.
Your DINO is minted with traits derived from keccak256(seed, block.prevrandao, tokenId).

Biome bonuses applied at mint

Biome	Automatic bonus
Primordial Forge (DINO/ETH)	+5% on top-tier rarity roll
Crystal Vault (DINO/USDC)	2× chance of TRANSPARENT finish
Frontier Ruins (DINO/CC)	CC badge guaranteed
Standard Origin (DINO/WMC)	WMC badge guaranteed
Nocturnal Wilds (DINO/WAAC)	WAAC badge guaranteed; COMPOUND eyes minimum

hasDino badge at mint

If your wallet holds at least 1 legacy Dinero 2015 token at the moment of revealAndIncubate, your DINO automatically receives the DINO badge — no extra action required.

What if my commit expires?

Call commitSeed again with a fresh hash. The old commit is worthless once 256 blocks have passed.

4. The Five Biomes

Each biome is permanently assigned at mint based on your chosen pool. The biome determines your SVG background, certain trait probabilities, guaranteed badges, and battle advantages. It is the single most consequential permanent choice in the protocol.

🌋 The Primordial Forge — DINO/ETH

Lore: The genesis pool. ETH is not merely a token — it is the lifeblood of Ethereum itself, born when the genesis block was mined on July 30, 2015, the day the EVM first breathed. This is the origin of all blockchain. DINOs born here carry the mark of the first flame. The lava beneath them is the very code that created everything.

SVG: Near-black red background with a radial ember glow at the centre. Animated lava sparks drift upward from the base — always present, always moving.

Bonuses:

Genesis rarity uplift — the top-tier rarity roll threshold is reduced by 5 points. A Theropod normally needs roll ≥ 980 for PLASMA_GLOW; Forge DINOs need only ≥ 975. This is the best pool for chasing legendary finishes.
Epoch grace — Forge holders receive one free epoch survival per calendar year. The DAO excludes Forge wallets from the extinction Merkle root for one epoch per year automatically.
Lava spark animation — unique animated SVG layer not present in any other biome.

Adaptive rim light: Amber #ffdd88 — warm volcanic glow applied to dark body finishes.

LP gate: Must hold ≥ 0.1 ETH at time of LP deposit.

💎 The Crystal Vault — DINO/USDC

Lore: Stable, precise, unwavering. USDC represents Ethereum's maturation from an experimental network into genuine financial infrastructure. DINOs born here are carved from crystal: cold, geometric, perfectly preserved. The Vault aesthetic reflects USDC's role as Ethereum's bedrock of stability — the pool that never crashes, never moons.

SVG: Deep blue-black background with geometric crystal formations rising from the bottom and cold white light shafts descending from above. No animation — deliberate stillness.

Bonuses:

Transparent finish bonus — DINOs in the Crystal Vault have a 2× increased probability of rolling TRANSPARENT finish (the rarest ghost-like aesthetic). TRANSPARENT normally occupies approximately 5% of outcomes; Crystal Vault pushes it to ~10%.
No extinction grace — Stability demands consistent engagement. Crystal Vault holders receive no epoch grace at all.

Adaptive rim light: Ice blue #aaddff.

LP gate: Must deposit ≥ $100 USDC-equivalent.

🏛 The Frontier Ruins — DINO/CC

Lore: CurrencyCoin was deployed just 40 days after Ethereum's launch, making it a verifiable relic from the earliest "Frontier" era. The EIP-20 proposal officially cites its source repository as a direct building block to the ERC-20 standard. DINOs born here are archaeologists. They walk among ruins of the first smart contracts, where Vitalik's original currency.sol commits still echo in the bytecode.

SVG: Dark purple-black background with broken stone arches on either side. Ancient Ethereum bytecode etched into the walls in faint purple monospace text: 60806040526004361061003f..., function transfer(address to, uint256 value). A floor-level ground layer separates the ruins from the sky.

Bonuses:

CC badge guaranteed — every DINO born in the Frontier Ruins receives the CC (CurrencyCoin) badge regardless of their rarity roll. You cannot mint here without earning this badge.
Fossil acceleration — when a Frontier Ruins DINO is marked extinct, it is eligible for the Fossilized state in 90 days rather than 180. The ruins accelerate decay into permanence.

Adaptive rim light: Violet #cc88ff.

LP gate: Must hold ≥ 1 CC token at time of LP deposit.

⚗️ The Standard Origin — DINO/WMC

Lore: MistCoin was deployed on November 3, 2015 by Fabian Vogelsteller and Alex Van de Sande as a prototype to test the concept of standardised token creation. Sixteen days later, Vitalik Buterin and Fabian proposed the ERC-20 standard. Every standard token on Ethereum — USDC, UNI, LINK, and billions more — traces back to this code. WMC liquidity is locked until November 3, 2115. DINOs born here inherit the standard.

SVG: Dark blueprint-blue background covered with a precise orthogonal grid of thin lines. Schematic annotation lines point to body parts with labels: "ERC-20 origin", "balanceOf()". The aesthetic is an architectural blueprint — the schematic that built everything.

Bonuses:

WMC badge guaranteed — every DINO born here receives the WMC (Wrapped MistCoin) badge automatically.
25% mutation discount — tail and mouth mutations cost 25% less for Standard Origin DINOs. The fee is calculated as mutationFee × 75 / 100. Fabian's standard was about reducing barriers to participation.
Centennial LP prestige — LP badges in this pool display a "Centennial LP" variant in the achievement system, honouring the 100-year liquidity lock.

Adaptive rim light: Teal #44ffee.

LP gate: Must hold ≥ 1 WMC token at time of LP deposit.

🦎 The Nocturnal Wilds — DINO/WAAC

Lore: AyeAyeCoin was the first memecoin on Ethereum, deployed on August 20, 2015 — just three weeks after Ethereum's launch. Named for the aye-aye, a rare nocturnal lemur from Madagascar with enormous eyes and a long middle finger, its entire supply of 6 million coins sat dormant in a faucet for nearly nine years. On May 26, 2024, a rediscovery post ignited a rush that over three days made the faucet contract one of the biggest gas consumers on Ethereum. DINOs born here are survivors. They waited in the dark for nine years before the jungle found them.

SVG: Near-black green background with a dark canopy silhouette along the top edge. Two pairs of amber aye-aye eyes watch from the far-left and far-right shadows at low opacity — always present, always watching. Five animated bioluminescent firefly particles pulse in and out across the scene at randomised intervals.

Bonuses:

WAAC badge guaranteed — every DINO born here receives the WAAC (Wrapped AyeAyeCoin) badge automatically.
COMPOUND eyes minimum — the aye-aye is famous for its enormous eyes. All Nocturnal Wilds DINOs are born with at least COMPOUND eyes (rolls of ROUND or SLIT_PUPIL are automatically upgraded). GLOWING_RED eyes are 3× more likely.
9-Year Sleeper — Nocturnal Wilds DINOs reach CHRONO_TITAN age bracket after 9 continuous years of holding in the same wallet, not the standard 1 year. This is the only CHRONO_TITAN path that honours the aye-aye's legendary 9-year dormancy. At 9 years, the SVG gains additional visual markers matching the discovery moment.
Animated fireflies — five unique bioluminescent particle animations not present in any other biome.

Adaptive rim light: Lime #ccff88.

LP gate: Must hold ≥ 1 WAAC token at time of LP deposit.

5. All 28 Traits Explained

Every DINO has exactly 28 traits stored in a single 32-byte EVM storage slot. All 28 are exposed in the OpenSea/marketplace attributes panel and indexed for rarity filtering.

Core anatomy (assigned at mint by randomness)

Trait	Values	Mutable?
Genus	24 dinosaur species	No
Biome	5 (pool-assigned)	Via migration only
Tail Shape	5 values	Yes (traitId=0)
Mouth Type	6 values	Yes (traitId=1)
Limb State	6 values	No
Alloy Finish	12 values	Via cybernetic graft
Primary Hide Color	HSL hue 0–359	No
Underbelly Color	HSL hue 0–359	No
Rarity Score	0–100	No

Cosmetic traits (assigned at mint)

Trait	Values	Notes
Eye Type	6 values	Biome-influenced in NOCTURNAL_WILDS
Skin Texture	6 values	Visible as SVG texture overlay
Headgear	7 values	Rendered above skull in z-order
Eyewear	6 values	Rendered over eye layer
Mouth Accessory	6 values	Cigarette/pipe have animated smoke
Body Gear	6 values	Chain, armour, hoodie, etc.
Footwear	5 values	Sneakers, boots, rocket boosters
Wrist Accessory	5 values	Watch, bracelet, hologram band

Status booleans (set by protocol events)

Trait	Set by
Age Bracket	Computed dynamically from hold time — never stored
Cybernetic Unlocked	Cybernetic graft (swap hookData)
TWAP Aura	Chainlink oracle via DinoSwapHook.afterSwap
Extinct	DinoExtinctionTracker.claimExtinction
Fossilized	Reserved (future)

Coin badge booleans (set at mint or by holding legacy tokens)

Badge	Set by
hasWaac	Mint in Nocturnal Wilds, OR Theropod roll ≥ 940
hasWmc	Mint in Standard Origin, OR Sauropod roll ≥ 960
hasCc	Mint in Frontier Ruins, OR any genus roll ≥ 995
hasDino	Holding ≥ 1 legacy Dinero 2015 token at time of mint

6. Rarity System

Genus groups and rarity tables

Your genus index (0–23) determines which rarity table applies at mint:

Theropod Group (genus 0–5: T-Rex through Dilophosaurus)

Roll range	Finish	Score	Notes
975–999 (2.5% with Forge bonus)	PLASMA_GLOW	99	Forge pool lowers threshold by 5
900–974 (7.5%)	CARBON	75
0–899 (90%)	NONE	10

Sauropod Group (genus 6–11: Brachiosaurus through Camarasaurus)

Roll range	Finish	Score
995–999 (0.5%)	GOLD	100
950–994 (4.5%)	CHROME	80
0–949 (95%)	WOOD	25

Armoured/Horned Group (genus 12–23: Ankylosaurus through Protoceratops)

Roll range	Finish	Score
990–999 (1%)	MULTICOLORED	95
920–989 (7%)	BRICK	60
0–919 (92%)	NONE	15

Crystal Vault TRANSPARENT bonus

Crystal Vault DINOs whose roll falls between 600–699 (inclusive) and is an even number have TRANSPARENT finish applied instead of the table result, with a score of 88. This gives approximately a 5% additional probability of TRANSPARENT on top of natural outcomes.

Rarity post-mint

All 12 AlloyFinish values can be applied post-mint via Cybernetic Grafting, including GOLD, MULTICOLORED, and TRANSPARENT. Post-mint finishes also set cyberneticUnlocked = true, adding the cyan ring SVG overlay permanently.

The rarest natural mint

A GOLD Sauropod (0.5% roll × Sauropod genus probability) with a Rarity Score of 100 is the rarest single natural mint outcome.

The rarest achievable combination

A DINO with all four coin badges (WAAC + WMC + CC + DINO) — the "Full Set" — is statistically rarer than any single legendary finish, as it requires simultaneous roll conditions AND legacy Dinero 2015 holding at mint time. The badge panel displays a dashed gold outer ring when all four are present.

7. The Aging System

Your NFT's appearance changes automatically over time without you spending any gas. Every time tokenURI is called (which any marketplace, wallet, or block explorer does when displaying your DINO), the contract computes your current Age Bracket live from block.timestamp - lastTransferTimestamp.

Standard age thresholds

Bracket	Hold time	Visual markers
HATCHLING	0–29 days	Default appearance
JUVENILE	30–89 days	Slight maturity indicators
PREDATOR	90–179 days	Stronger colouring, battle-ready stance
ELDER	180–364 days	Weathered texture markers
CHRONO_TITAN	365+ days (standard)	Full legendary appearance

The 9-Year Sleeper (Nocturnal Wilds only)

Nocturnal Wilds DINOs require 9 continuous years in the same wallet to achieve CHRONO_TITAN — honouring the aye-aye faucet's own 9-year dormancy. At 9 years, additional SVG visual markers appear matching the discovery moment lore. Standard pools reach CHRONO_TITAN in 1 year.

Aging clock reset

lastTransferTimestamp resets whenever your DINO is transferred to a new address. This includes:

Selling on a marketplace
Transferring to any other wallet (including your own hardware wallet)

It does not reset when you:

List for sale without completing a transfer
Approve a marketplace contract
Call tokenURI or view the NFT

8. Trait Mutation

After minting, you can change your tail shape or mouth type by paying the mutation fee.

Call mutateAnatomy(tokenId, traitId, newValue):

`traitId`	Trait	Valid `newValue`
`0`	Tail Shape	0–4
`1`	Mouth Type	0–5

Standard Origin discount

If your DINO's biome is STANDARD_ORIGIN, the mutation fee is 25% less — automatically applied by the vault. The effective fee is mutationFee × 75 / 100.

Tail Shape values

Value	Name	Rarity indication
0	STRAIGHT	Common
1	CURVED	Common
2	BOBBED	Uncommon
3	SCARRED_WHIP	Rare
4	THAGOMIZER	Rare

Mouth Type values

Value	Name
0	CLOSED
1	SMILEY
2	MISSING_TOOTH
3	GOLD_GRILLS
4	LIQUIDITY_JAWS
5	CRUSHING_BEAK

9. Cybernetic Grafting

Cybernetic Grafting lets you change your DINO's Alloy Finish to any of the 12 possible values — including GOLD, MULTICOLORED, and TRANSPARENT — by including special data in a Uniswap V4 swap. It also permanently sets cyberneticUnlocked = true, adding a cyan ring overlay to the SVG.

hookData format

hookData must be exactly 128 bytes, ABI-encoded:

abi.encode(
    uint8  action,    // 0 = graft
    uint256 tokenId,  // your DINO's token ID
    uint256 alloy,    // AlloyFinish index (0–11)
    uint256 epochId   // current extinction epoch ID, or 0
)

Example (ethers.js)

const hookData = ethers.AbiCoder.defaultAbiCoder().encode(
    ['uint8', 'uint256', 'uint256', 'uint256'],
    [0, myTokenId, 11, currentEpochId]  // action=graft, alloy=MULTICOLORED
);

AlloyFinish index reference

Index	Finish	Rarity
0	NONE	Common
1	CHROME	Uncommon
2	ANODIZED	Uncommon
3	CARBON	Rare
4	PLASMA_GLOW	Very Rare
5	GOLD	Legendary
6	BRICK	Rare
7	WOOD	Uncommon
8	FLUORESCENT	Rare
9	BLUESCREEN	Rare
10	TRANSPARENT	Very Rare
11	MULTICOLORED	Legendary

10. The 2015 Collectible Coin Badges

The four coin badges are a unique collectible-within-a-collectible mechanic honouring the specific 2015 Ethereum tokens whose pools form the DINO ecosystem. Each badge is a bool stored in the NFT's anatomy and rendered in a dedicated panel below the dinosaur body on the SVG canvas — never overlapping the body art.

Badge panel layout

The badge panel occupies y=760 to y=900 on the 1050-height canvas, separated from the body by a thin biome-accent coloured dividing line. Badge positions adapt automatically to how many badges a token holds:

Count	Badge positions (cx values)
0	Dashed empty placeholder: "No badges earned"
1	Centred at cx=400
2	cx=320, cx=480
3	cx=240, cx=400, cx=560
4	cx=176, cx=336, cx=464, cx=624 with outer dashed gold ring

The four badges

WAAC — Wrapped AyeAyeCoin (gold, #bf953f)

First memecoin on Ethereum, August 20, 2015
Awarded: mint in Nocturnal Wilds (DINO/WAAC pool), OR Theropod genus with roll ≥ 940
Visual: gold foil radial gradient, "WAAC" text, sub-label "AyeAye"

WMC — Wrapped MistCoin (steel blue, #1a4a80)

Prototype for ERC-20, November 3, 2015
Awarded: mint in Standard Origin (DINO/WMC pool), OR Sauropod genus with roll ≥ 960
Visual: steel blue fill, "WMC" text, sub-label "MistCoin"

CC — CurrencyCoin (plasma purple, #2a0060 + neon glow)

Deployed 40 days after genesis, direct ERC-20 building block
Awarded: mint in Frontier Ruins (DINO/CC pool), OR any genus with roll ≥ 995
Visual: purple plasma fill with neon glow filter, "CC" text, sub-label "CurrencyCoin"

DINO — Wrapped Dinero 2015 (neon green, #002200 + #39ff14 stroke)

The protocol's own 2015 legacy token
Awarded: hold ≥ 1 legacy Dinero 2015 token at the moment of revealAndIncubate
Visual: dark green fill with neon green border and text, "DINO" text, sub-label "Dinero 2015"
This is the only badge that proves protocol participation — not pool selection or lucky randomness

Four-badge full set

When all four badges are present, a dashed gold outer ring encloses all four badges. Off-chain rarity tools flag this combination as the rarest achievable configuration in the entire collection.

11. TWAP Aura

The TWAP Aura is a collective, oracle-driven visual feature. After every swap in a DINO V4 pool, DinoSwapHook.afterSwap reads the Chainlink DINO/ETH price aggregator. If the price meets or exceeds the DAO-configured threshold and your hookData includes a tokenId, your DINO's twapAuraActive is set true — triggering a pulsing purple double-ring aura in the SVG art.

Visual effect

Two concentric purple circles with animated opacity (0.55 → 0.9 → 0.55, 2.5 second cycle) surround the body. The aura ring pulses continuously when active.

How to activate it

Include your tokenId in the second slot of swap hookData:

abi.encode(
    uint8(0),        // action = graft (or any action)
    myTokenId,       // id1 = tokenId for TWAP update
    0,               // id2 = not used for TWAP
    epochId          // epochId for extinction survival
)

When afterSwap fires, if tokenId != 0, the oracle is read and the flag is updated accordingly.

Clearing the aura

If the DINO/ETH price drops below the threshold, the next swap with your tokenId in hookData will set twapAuraActive = false and the aura disappears. This is a live market signal — not a permanent cosmetic.

12. PvP Battle Arena

The Battle Arena lets two DINO holders challenge each other to a fight settled by Chainlink VRF v2.5 randomness. Neither side can predict or manipulate the outcome.

Initiating a battle

Include battle hookData in a V4 swap:

const hookData = ethers.AbiCoder.defaultAbiCoder().encode(
    ['uint8', 'uint256', 'uint256', 'uint256'],
    [1, challengerTokenId, defenderTokenId, currentEpochId]
    // action=1 (battle), id1=your token, id2=opponent's token
);

Settlement

Settlement happens asynchronously — 3–5 blocks after challenge when Chainlink delivers the random word. Watch for the BattleSettled(vrfRequestId, winnerId, loserId, biomeAdvantageApplied) event.

Consequences

Winner: battleWins[tokenId]++ — permanent on-chain record
Loser: battleLosses[tokenId]++ — loss record. Your NFT is never taken or burned
Battle records are permanent and indexed by rarity tools

13. Inter-Biome Battle Advantage

When two DINOs from different biomes battle, the biome advantage cycle gives the winning biome +5 percentage points of VRF weight. This shifts the effective 50/50 roll toward 55/45.

The cycle

PRIMORDIAL_FORGE  → beats → CRYSTAL_VAULT    (fire melts crystal)
CRYSTAL_VAULT     → beats → FRONTIER_RUINS   (preservation defeats decay)
FRONTIER_RUINS    → beats → STANDARD_ORIGIN  (older code beats prototype)
STANDARD_ORIGIN   → beats → NOCTURNAL_WILDS  (code beats nature)
NOCTURNAL_WILDS   → beats → PRIMORDIAL_FORGE (the wild predates the forge)

Same-biome battles are pure 50/50. The advantage applies automatically in DinoBattleArena.rawFulfillRandomWords using the biomes stored in both NFTs' anatomies.

Strategic implications

If you want to challenge someone in STANDARD_ORIGIN, bring a FRONTIER_RUINS DINO for the edge
Maintain a NOCTURNAL_WILDS DINO specifically for challenging Forge holders
The cycle is symmetric — every biome has one it beats and one it loses to

14. Biome Migration

You can migrate your DINO to a new biome by paying the incubation fee (0.005 ETH) while your wallet is participating in the target pool. Migration is limited to once per epoch.

Call migratePool(tokenId, newPoolId) with 0.005 ETH attached.

What changes on migration

SVG background switches to the new biome immediately
Badge guarantees from the new biome do not retroactively apply — the badge booleans are set at mint and are permanent
Biome loyalty streak resets — migration is the antithesis of loyalty
The 9-Year Sleeper bonus (Nocturnal Wilds) applies to current hold time, not past

What does not change

All other traits — genus, finish, cosmetics, existing badges — are unchanged.

15. Leaderboard and Volume Tracking

DinoLeaderboard tracks cumulative swap volume (in absolute token units) for every address that swaps in any DINO V4 pool. Volume is recorded automatically by DinoSwapHook.afterSwap on every swap — no extra action required.

Reading your volume

Query userVolumeAccumulated(address) on DinoLeaderboard.

Epoch Alpha badges

Top-10 volume wallets per pool per epoch are eligible for pool-specific "Alpha" badge variants (e.g. "Forge Alpha", "Wilds Alpha") — awarded as soulbound ERC-1155 tokens by the DAO after each epoch closes. Alpha badges appear alongside coin badges in the 2015 COLLECTIBLES panel.

16. Achievement Badges

Badges are soulbound ERC-1155 tokens — permanently linked to the earning wallet, never transferable or sellable. All badge art is fully on-chain SVG.

Swap milestone badges (minted automatically)

Badge ID	Name	How to earn
1	First Swap	First swap in any DINO V4 pool
2	Veteran Swapper	10 swaps
3	Apex Trader	100 swaps

LP badge (minted automatically)

Badge ID	Name	How to earn
4	Liquidity Provider	First successful LP deposit in any DINO pool

Biome loyalty badges (DAO-awarded, off-chain verified)

Badge ID	Name	How to earn
6	Biome Loyal	3 epochs of continuous loyalty to one biome
7	Biome Devoted	7 epochs of continuous loyalty
8	Born of the Biome	10 epochs — the rarest badge in the collection

Loyalty streaks are computed off-chain from BiomeLoyaltyStamped events emitted by DinoLiquidityManagerHook. The DAO calls mintLoyaltyBadge(user, badgeId) when thresholds are confirmed.

Badge 5 (Battle Victor)

Reserved for a future release. Will be awarded by the battle system to holders with exceptional win records.

17. Biome Loyalty Streaks

Biome loyalty is measured in epochs. An epoch is a DAO-defined time period (typically 6 months). To maintain your loyalty streak, you must:

Hold a DINO NFT from the same biome for the entire epoch
Provide liquidity in that biome's pool at least once during the epoch
NOT migrate to a different biome during the epoch

Streak benefits

Epochs	Badge	SVG effect
3	Biome Loyal	Biome-accent glow border around the classification label
7	Biome Devoted	Biome-accent crown ornament variant in classification area
10	Born of the Biome	Permanent distinctive SVG frame unique to that biome

Migrating your DINO resets your loyalty streak to zero for the new biome.

18. Liquidity Provider Features

Access gate

You must hold at least one DINO NFT to add liquidity to any DINO V4 pool. The hook verifies your NFT balance in beforeAddLiquidity. If your balance is zero, the transaction reverts with HookEcosystemStakingGated.

Per-pool loyalty lock

After adding liquidity, you cannot remove it from that specific pool for 3 days. Each pool has its own independent lock — adding to Pool A does not affect Pool B's lock.

Re-adding liquidity to a pool resets only that pool's 3-day lock.

If you attempt early withdrawal, the transaction reverts with HookLoyaltyLockActive.

LP badge

Badge 4 (Liquidity Provider) is minted automatically on your first successful afterAddLiquidity in any DINO pool.

19. Extinction Events

Extinction Events are seasonal community challenges run by the DAO. During an active epoch, you must perform at least one swap with the active epochId in your hookData. Wallets that do not swap during the epoch may be permanently marked extinct.

How epochs work

DAO opens epoch via DinoExtinctionTracker.openEpoch(epochId)
During epoch: every swap with epochId in hookData slot 4 records your survival automatically
DAO closes epoch: sets a Merkle root of all non-surviving tokenIds via setExtinctionRoot
Claiming extinction: anyone can call claimExtinction(epochId, tokenId, proof) to mark a specific token

How to survive with one swap

const hookData = ethers.AbiCoder.defaultAbiCoder().encode(
    ['uint8', 'uint256', 'uint256', 'uint256'],
    [0, 0, 0, activeEpochId]  // epochId in slot 4 — graft/battle slots can be zero
);

A single swap with the correct epochId is sufficient to survive for all DINOs owned by that wallet.

Survival is wallet-wide

Survival is tracked per wallet, not per token. One swap covers all DINOs owned by that address.

Primordial Forge grace

Forge holders receive one free epoch survival per calendar year — the DAO excludes them from the extinction Merkle root for one epoch automatically.

Consequences of extinction

isExtinct = true is set permanently. A large red "EXTINCT" stamp with diagonal crossed lines overlays the SVG. Your DINO is NOT burned or removed from your wallet. Extinct DINOs become historically significant collectibles — each one is a timestamped record of a specific epoch.

Fossilized state

isFossilized is reserved for a future upgrade that will activate some time after extinction. Frontier Ruins DINOs fossilize at 90 days post-extinction; all others at 180 days (these timelines are DAO-governed).

20. Conservation Pledge — The Aye-Aye Fund

Honouring the AyeAyeCoin community's real-world aye-aye conservation efforts, DINO/WAAC pool participants can opt in to direct a share of LP fees to aye-aye conservation organisations.

How to pledge

Call DinoPoolRegistryHook.pledge() from any wallet.

What happens

conservationPledge[yourAddress] is set to true
On every subsequent LP deposit, the hook emits a ConservationLpStamped event
Future art engine upgrades will read this flag and render a 🌿 leaf overlay on your DINO's SVG — a permanent, visible, on-chain record of ecological contribution
Fee routing to conservation organisations is governed by the DAO

Revoking

Call DinoPoolRegistryHook.revokePledge() at any time.

21. Adaptive Contrast System

Certain DINO body finishes (NONE, CARBON, WOOD, BLUESCREEN) are very dark in colour. Without intervention, these bodies would visually blend into the near-black biome backgrounds. The art engine applies an automatic contrast system for these cases.

What is applied for dark bodies

Biome spotlight — a radial gradient ellipse behind the body zone lifts local background luminance without affecting the rest of the scene
Rim stroke — the body SVG paths receive a biome-accent coloured stroke (2.5px) instead of the default dark stroke
Directional lighting — the fePointLight lighting colour shifts to the biome accent

Verified rim-light colours (≥ 8× WCAG contrast against all dark finishes)

Biome	Rim colour	Character
Primordial Forge	`#ffdd88`	Warm amber — volcanic light
Crystal Vault	`#aaddff`	Cold ice blue
Frontier Ruins	`#cc88ff`	Ancient violet
Standard Origin	`#44ffee`	Blueprint teal
Nocturnal Wilds	`#ccff88`	Bioluminescent lime

This system operates entirely inside the view function — zero gas cost, no new contracts.

22. Wrapped Dinero DINO ERC-20

WrappedDinero (symbol: DINO, name: Wrapped Dinero) wraps legacy 2-decimal Dinero 2015 tokens into standard 18-decimal ERC-20 form.

Decimal bridge

Legacy Dinero 2015 : 2 decimal places
Wrapped DINO       : 18 decimal places
Gap                : 18 - 2 = 16 decimal places
SCALING_FACTOR     = 10^16

1 legacy unit = 10,000,000,000,000,000 DINO wei
Displayed: 1.00 legacy DINO → 1.00 DINO (human-readable values match)

Wrapping

Call wrap(legacyAmount) where legacyAmount is in legacy units (2-decimal). Pass 100 for 1.00 legacy DINO. Approve the WrappedDinero contract first.

Unwrapping

Call unwrap(wrappedAmount) where wrappedAmount must be exactly divisible by 10^16. Indivisible amounts revert with WrapperIndivisibleAmount.

Wrapping and the hasDino badge

If you wrap legacy Dinero and then mint a DINO NFT while holding the wrapped DINO tokens, you receive the DINO badge. The vault checks legacyDineroAddress.balanceOf(caller) > 0 at mint time — both wrapped and unwrapped legacy balances count if both addresses are registered.

23. On-Chain Art

Every DINO is rendered as an 800×1050 SVG divided into three vertical zones:

Zone 1: Dinosaur scene (y 0–750)

Layers in render order:

<defs> block — all gradients, patterns, filters defined here
Background — biome-specific scene with unique elements per biome
Ground shadow ellipse — dark oval beneath the body for 3D depth perception
Body geometry — genus-group-specific skeletal shape (theropod, sauropod, armoured)
Specular highlight — white semi-transparent ellipse on the lit surface for roundness
Skin texture overlay — fur strokes, feather curves, crystal spines, or scaly lines
Eye layers — sclera + iris + pupil + specular dot (4 layers for depth)
Headgear — drawn above skull in z-order
Eyewear — overlaid on eye layer
Mouth accessory — cigarette/pipe include animated smoke puffs
Body gear — hoodie, chain, armour, etc.
Footwear — at bottom of body, sneakers include white stripe detail
Wrist accessory — on arm/limb area
Cybernetic overlay — cyan circle when cyberneticUnlocked = true
TWAP aura — animated pulsing purple rings when twapAuraActive = true
Extinct overlay — red diagonal cross + EXTINCT text when isExtinct = true

Zone 2: Badge panel (y 760–903)

Separated from the dinosaur body by a biome-accent dividing line. Contains the 2015 COLLECTIBLES label and 0–4 coin badge circles. Badges never overlap the body art.

Zone 3: Classification label (y 904–1050)

Four lines of monospace text: genus and token ID, biome + finish + rarity score, age bracket + eye type + skin texture, and the CollectibleTrust protocol identifier.

Metadata format

tokenURI returns data:application/json;base64,... containing all 28 attributes.

24. Marketplace and Rarity Tools

All 28 traits are exposed as named attributes in the ERC-721 metadata. Marketplaces supporting attribute filtering (OpenSea, Blur, trait.tech, Rarity Sniper) will index and rank DINOs correctly.

Age Bracket caching

Because Age Bracket is computed live at tokenURI call time, marketplaces may cache an older bracket. Use the "Refresh Metadata" button on OpenSea to force a re-fetch. The live bracket is always visible by calling tokenURI directly.

Events to index (subgraph)

DinoIncubated(tokenId, owner, genus, biome, rarityScore) — mint
AnatomyMutated(tokenId, traitId, newValue) — mutation
CyberneticGrafted(tokenId, finish) — graft
TwapStateModified(tokenId, active) — TWAP
BiomeMigrated(tokenId, newBiome) — migration
ExtinctionMarkApplied(tokenId) — extinction
BattleSettled(vrfRequestId, winnerId, loserId, advantageApplied) — battle
BadgeMinted(recipient, badgeId) — achievement
BiomeLoyaltyStamped(provider, poolId, timestamp) — loyalty tracking
ConservationLpStamped(provider, poolId) — conservation pledge LP

25. Frequently Asked Questions

Q: Which pool should I mint in?
A: Primordial Forge for best rarity odds. Nocturnal Wilds for the WAAC badge and firefly art. Standard Origin for mutation discounts. Frontier Ruins for the CC badge. Crystal Vault for TRANSPARENT finish potential. There is no universally "best" choice — every biome has a distinct advantage.

Q: Can I get all four coin badges from one mint?
A: No. Each badge requires either a specific pool mint or a specific roll condition. WAAC requires Nocturnal Wilds OR Theropod roll ≥ 940. WMC requires Standard Origin OR Sauropod roll ≥ 960. CC requires Frontier Ruins OR any roll ≥ 995. DINO requires holding legacy Dinero at mint. The only way to guarantee all four in one DINO is to mint in a coin pool and separately achieve the other conditions — but badge guarantees are biome-specific. The full set strategy requires holding legacy Dinero, then minting in a pool that gives one badge guaranteed, and hoping roll conditions provide the others.

Q: Can I move my DINO to a hardware wallet without resetting the aging clock?
A: No. Any wallet-to-wallet transfer resets lastTransferTimestamp — including moves to your own hardware wallet. If you want to reach CHRONO_TITAN, keep your DINO in one wallet.

Q: Does migrating biomes change my coin badges?
A: No. Coin badges are booleans set at mint and are permanent. Migration changes the SVG background and battle advantage but never removes or adds badges.

Q: Can battle cause me to lose my NFT?
A: Never. Only win/loss counters change. Your DINO is always yours regardless of battle outcome.

Q: What if Chainlink VRF takes too long to settle a battle?
A: The challenge sits in inflightChallenges in a pending state. The swap that initiated it completed normally. Contact the DAO if a challenge is stuck for more than 100 blocks.

Q: How do I know if my wallet is pledged for conservation?
A: Call DinoPoolRegistryHook.conservationPledge(yourAddress) — returns true if pledged.

Q: What gas does minting cost?
A: Approximately 200,000–250,000 gas for revealAndIncubate, plus 0.005 ETH fee. commitSeed costs ~50,000 gas.

Q: Is the DINO badge the same as the DINO NFT collection ticker?
A: No. "DINO" refers to both the ERC-20 token (WrappedDinero, symbol DINO) and the coin badge. Context makes it clear: the badge panel shows the DINO coin badge; the ERC-721 collection ticker is "DINO-NFT".

26. Quick Reference — All Trait Values

GenusType (24 values, 0–23)

Theropods (0–5):  TYRANNOSAURUS, SPINOSAURUS, VELOCIRAPTOR, ALLOSAURUS, CARNOTAURUS, DILOPHOSAURUS
Sauropods (6–11): BRACHIOSAURUS, DIPLODOCUS, APATOSAURUS, TITANOSAURUS, ARGENTINOSAURUS, CAMARASAURUS
Armoured/Horned/Ornithopods (12–23):
  ANKYLOSAURUS, STEGOSAURUS, KENTROSAURUS, NODOSAURUS, SCELIDOSAURUS, MIRAGAIA,
  TRICERATOPS, PACHYCEPHALOSAURUS, PARASAUROLOPHUS, IGUANODON, MAIASAURA, PROTOCERATOPS

BiomeType (5 values)

0 PRIMORDIAL_FORGE  (DINO/ETH)   — volcanic lava
1 CRYSTAL_VAULT     (DINO/USDC)  — crystal cave
2 FRONTIER_RUINS    (DINO/CC)    — ancient bytecode walls
3 STANDARD_ORIGIN   (DINO/WMC)  — blueprint grid
4 NOCTURNAL_WILDS   (DINO/WAAC) — dark jungle + fireflies

AgeBracket (5 values — computed dynamically)

0 HATCHLING    (<30 days)
1 JUVENILE     (30–89 days)
2 PREDATOR     (90–179 days)
3 ELDER        (180–364 days)
4 CHRONO_TITAN (365+ days standard; 9 years for NOCTURNAL_WILDS)

TailShape (5 values — mutable, traitId=0)

0 STRAIGHT  1 CURVED  2 BOBBED  3 SCARRED_WHIP  4 THAGOMIZER

MouthType (6 values — mutable, traitId=1)

0 CLOSED  1 SMILEY  2 MISSING_TOOTH  3 GOLD_GRILLS  4 LIQUIDITY_JAWS  5 CRUSHING_BEAK

LimbState (6 values — assigned at mint)

0 INTACT  1 MISSING_TOES  2 ONE_ARMED  3 PEG_LEG  4 CYBERNETIC_ALLOY  5 OSTEODERM_ARMOUR

AlloyFinish (12 values — mutable via cybernetic graft)

0 NONE  1 CHROME  2 ANODIZED  3 CARBON  4 PLASMA_GLOW  5 GOLD
6 BRICK  7 WOOD  8 FLUORESCENT  9 BLUESCREEN  10 TRANSPARENT  11 MULTICOLORED

EyeType (6 values — biome-influenced at mint)

0 ROUND  1 SLIT_PUPIL  2 COMPOUND  3 GLOWING_RED  4 LASER_BEAM  5 HETEROCHROMIA

SkinTexture (6 values)

0 BALD  1 SCALY  2 FEATHERED  3 BRISTLE_FUR  4 FULL_FUR  5 CRYSTAL_SPINES

Headgear (7 values)

0 NONE  1 BACKWARDS_CAP  2 COWBOY_HAT  3 TOP_HAT  4 CROWN  5 FROG_HAT  6 FLAME_CROWN

Eyewear (6 values)

0 NONE  1 ROUND_FRAMES  2 AVIATORS  3 MONOCLE  4 VR_VISOR  5 GLASSES_3D

MouthAccessory (6 values)

0 NONE  1 CIGARETTE  2 PIPE  3 CIGAR  4 LOLLIPOP  5 TOOTHPICK

BodyGear (6 values)

0 NONE  1 HOODIE  2 CHAIN_NECKLACE  3 BATTLE_ARMOUR  4 TUXEDO_VEST  5 SPACE_SUIT

Footwear (5 values)

0 BARE_CLAWS  1 SNEAKERS  2 BOOTS  3 ROCKET_BOOSTERS  4 ROLLER_SKATES

WristAccessory (5 values)

0 NONE  1 WATCH  2 GOLD_BRACELET  3 HOLOGRAM_BAND  4 SPIKED_CUFF

hookData action field (128 bytes ABI-encoded)

0 = Cybernetic Graft  (id1=tokenId, id2=alloyIndex, epochId=epochId)
1 = PvP Battle        (id1=challengerId, id2=defenderId, epochId=epochId)

Achievement Badge IDs

1 First Swap          (1 swap)
2 Veteran Swapper     (10 swaps)
3 Apex Trader         (100 swaps)
4 Liquidity Provider  (first LP deposit)
5 Battle Victor       (reserved)
6 Biome Loyal         (3 epoch loyalty — DAO-awarded)
7 Biome Devoted       (7 epoch loyalty — DAO-awarded)
8 Born of the Biome   (10 epoch loyalty — legendary, DAO-awarded)

Battle advantage cycle

PRIMORDIAL_FORGE → CRYSTAL_VAULT → FRONTIER_RUINS → STANDARD_ORIGIN → NOCTURNAL_WILDS → PRIMORDIAL_FORGE
(each biome beats the one to its right; +5% VRF weight advantage)

DINO Vault is a CollectibleTrust DAO LLC protocol. All contract interactions are final and irreversible. Always verify contract addresses through official governance channels before transacting.

THIS CODE HAS NOT BEEN AUDITED - USE AT YOUR OWN RISK

Document version: v7 — reflects the complete updated codebase including biome gamification, coin badges, adaptive contrast, cosmetic traits, and full pool system.

rfikki/END_USER_GUIDE_2016-05-19.md

DINO Vault — Complete Collector's Guide

Table of Contents

1. What Is DINO Vault?

Contract system

2. Getting Started

What you need

The five pools

3. Minting Your Dinosaur

Why two steps?

Step 1 — Commit

Step 2 — Reveal and Incubate

Biome bonuses applied at mint

hasDino badge at mint

What if my commit expires?

4. The Five Biomes

🌋 The Primordial Forge — DINO/ETH

💎 The Crystal Vault — DINO/USDC

🏛 The Frontier Ruins — DINO/CC

⚗️ The Standard Origin — DINO/WMC

🦎 The Nocturnal Wilds — DINO/WAAC

5. All 28 Traits Explained

Core anatomy (assigned at mint by randomness)

Cosmetic traits (assigned at mint)

Status booleans (set by protocol events)

Coin badge booleans (set at mint or by holding legacy tokens)

6. Rarity System

Genus groups and rarity tables

Crystal Vault TRANSPARENT bonus

Rarity post-mint

The rarest natural mint

The rarest achievable combination

7. The Aging System

Standard age thresholds

The 9-Year Sleeper (Nocturnal Wilds only)

Aging clock reset

8. Trait Mutation

Standard Origin discount

Tail Shape values

Mouth Type values

9. Cybernetic Grafting

hookData format

Example (ethers.js)

AlloyFinish index reference

10. The 2015 Collectible Coin Badges

Badge panel layout

The four badges

Four-badge full set

11. TWAP Aura

Visual effect

How to activate it

Clearing the aura

12. PvP Battle Arena

Initiating a battle

Settlement

Consequences

13. Inter-Biome Battle Advantage

The cycle

Strategic implications

14. Biome Migration

What changes on migration

What does not change

15. Leaderboard and Volume Tracking

Reading your volume

Epoch Alpha badges

16. Achievement Badges

Swap milestone badges (minted automatically)

LP badge (minted automatically)

Biome loyalty badges (DAO-awarded, off-chain verified)

Badge 5 (Battle Victor)

17. Biome Loyalty Streaks

Streak benefits

18. Liquidity Provider Features

Access gate

Per-pool loyalty lock

LP badge

19. Extinction Events

How epochs work

How to survive with one swap

Survival is wallet-wide