v1 state

minIncubation

minIncubation is the minimum number of blocks an egg must sit before it can hatch.

waitCap

waitCap is the incubation-time bonus cap (in blocks) used by rarityTier, so waiting forever doesn't guarantee a legendary — it just improves odds.

speciesNames

rarityNames

rarityEmoji

egg

egg is the persisted record for one planted egg, hatched or not.

eggs

// id string -> \*egg

nextID

totalPlanted

totalHatched

rarityCounts

get

hashSeed

hashSeed hashes the given parts (joined with ":") to a deterministic hex digest. Used to derive an egg's species and rarity roll from facts already fixed at plant time, so nobody — not even the owner — can game the outcome after the fact.

seedBytes

seedBytes pulls the first two bytes out of a hex digest for use as two independent 0-255 rolls (species pick, rarity roll).

rarityTier

rarityTier turns a 0-255 roll plus the blocks waited into a tier index 0..3 (common..legendary). Waiting longer raises the effective score, so patience improves your odds, but a bad roll can still land common even after a long wait, and a lucky roll can hatch rare almost immediately.

plant

plant is the non-crossing core of PlantEgg.

PlantEgg

PlantEgg starts incubating a new egg for the caller. Returns its ID.

hatch

hatch is the non-crossing core of Hatch.

Hatch

Hatch hatches an incubated egg the caller owns.

train

train is the non-crossing core of Train.

Train

Train gives a hatched creature the caller owns some experience, leveling it up every 50 XP.

rename

rename is the non-crossing core of Rename.

Rename

Rename gives a hatched creature the caller owns a custom name.

byIDNumeric

byIDNumeric orders eggs by their numeric ID, ascending.

allEggs

renderHome

renderEgg

renderOwner

Render

Render shows the full egg list at "", a single egg's detail when path is a numeric ID, or one owner's eggs when path is a bech32 address.