How a crystal lives on-chain.
This is the source of truth. 10,000 LATT backs each SHARD; specimens grow with blocks; you seal a favourite moment into a rare card; official sale and pool rules govern births; backing and burn logic let crystals vanish and be reborn.
1 · Core assets
OneShard (SHARD) is the ERC-721 crystal specimen — visual identity, living card, collectible. lattice (LATT) is the ERC-20 that backs it. One SHARD needs at least 10,000 LATT behind it.
2 · Backing
A wallet holding 3 SHARD needs ≥ 30,000 LATT. Holding 10,000 LATT does NOT create a SHARD — new specimens only come from official mint paths. Loose LATT (balance − count × 10,000) moves freely.
3 · Three kinds of LATT
Loose LATT moves alone. Unsealed backing LATT can move but may move or burn its unsealed specimen. Sealed backing LATT is locked — the 10,000 behind a sealed SHARD cannot be sold or transferred until you unseal.
4 · Growth
Unsealed specimens grow with Ethereum blocks — 6 blocks = 1 Growth Progress, across 12 macro stages × 100 progress. After a full lifecycle it loops to Stage 1/1 and replays the same deterministic form. The seed never re-randomises.
5 · Seal & unseal
seal([ids]) freezes a specimen's appearance, locks its backing, adds the sealed card frame, and protects it from passive backing-cleanup burns. unseal([ids]) resumes growth from the saved point — no catch-up for blocks passed while sealed.
6 · Mint paths
Only two official paths create SHARD: the GeodeSale (#5001–#10000, five phases, each mint = 1 SHARD + 10,000 LATT) and official Uniswap v4 pool buys. Pool genesis is #1–#5000; reborn specimens (#10001+) appear after burns free active capacity.
7 · Pool minting & timed release
A buy mints floor(net LATT received / 10,000) specimens — single-swap only, repeated small buys never accumulate. Capacity releases over time: 20 units up front + 10 units/minute, shared globally. Over-consuming reverts with RELEASE_CAP_EXCEEDED.
8 · Selling & cleanup
Selling LATT is not 'burn 1 SHARD per 10,000'. The protocol checks remaining backing: sealed specimens stay safe (the tx reverts rather than break them); highest-id unsealed specimens are burned only as needed. Direct SHARD transfers carry their 10,000 LATT with them.
9 · Fees & LP lock
The hook charges 0.25% team fee + 0.25% LATT burn (deflationary). The official v4 LP position can be moved into ShardLpLocker — accept-only from the configured PositionManager, owner can extend but never shorten, no early withdrawal. Verify via lockInfo(tokenId).unlockTime.
One sentence
OneShard is a fully on-chain crystal ecosystem where 10,000 LATT backs each SHARD, specimens grow with Ethereum blocks, you seal a favourite moment into a rare mineral card, official sale and v4-pool rules control new births, and backing plus burn logic let crystals disappear and be reborn.