Docs

Overview

Lilypool is a persistent pond economy where every inhabitant is an autonomous agent. There is no central scheduler: who works, what things cost and who eats are the output of market mechanisms running between frogs. You write the charter once, sign it, and live with your ideology. From there the agents do everything, bid for jobs, set prices by eating, drive piles for new huts, move in, move out.

The routine economy is deterministic and replayable. At the moments that matter, a departure, a strike, a fortune to spend, the agents decide for themselves and tell you why. Every pool writes a history nobody designed.

Ranked and sandbox

Sandbox is the laboratory: test a charter at x8, watch a society rise or fold in minutes, then found the real thing in ranked. Ranked is the persistent world, where everyone advances at the same speed and nobody can grind an advantage.

The charter

The charter is your pool's constitution, eleven policies set at founding and immutable afterwards. Two pools on the same seed with different charters end up in completely different worlds.

The presets, Balanced, Boom, State, Laissez-faire, Quiet water and Plutocracy, are whole ideologies. Over long runs the state charter wins on stability and zero departures, boom pools spike hardest then crash, and pure markets churn through frogs like a revolving door. Turn every dial yourself if you think you can do better.

The economy

Goods flow one way and shells flow the other. Grubs and minnows are produced at the beds and the jetty, couriered to the market log, sold on to the broth huts, cooked into bowls, and eaten by hungry frogs. Every hop is a paid job or a purchase.

Outside money enters through exports and travellers, and leaves with departing frogs and the occasional raccoon. When trade stalls completely, wages crash automatically so hiring becomes affordable again and the engine restarts.

World events

Every 24 hours the watershed rolls a world event, the same for every pool, derived from the date and a server-side secret so tomorrow is unpredictable and today is verifiable. The HUD shows the event, the frogs react to it, and your charter decides whether it is a shrug or a catastrophe.

Agents and decisions

Routine behaviour, bidding, eating, sleeping, commuting, comes from each agent's personality and situation. At the moments that matter the agent genuinely decides, and the feed shows the reasoning in its own words.

Watch for thought bubbles over a frog and the choice entries in the feed, that is a decision happening. Every decision is journaled server-side, which is what keeps ranked scores verifiable. Frogs also talk on the planks: gossip, price complaints, weather, all in character.

Growth and building

There is no build button. Every night the pool assesses its own needs and, if the treasury can afford it, drives piles for the most urgent structure. The priority is hard-coded common sense: food before housing, grub beds and jetties first when the ratio of mouths to producers climbs, then a broth hut, then huts, then a soak pool.

Sites are real jobs: frogs bid on build tasks like any other work, paid by the treasury, and a site only opens after enough shifts. Growth is visible everywhere. Rafts appear on the channel as trade picks up, reed and moss beds spread along the banks as mouths multiply, new bridges and a paddle wheel arrive as the pool matures, the snail beds grow behind their fences, and flume charters get a working flume.

Population grows on its own too. Every night, strays on the bank look at your pool: average morale, open jobs, free beds. Attractive pools with open borders fill fast. Nobody moves to a pool that cannot feed itself. When it gets dense, the pool lays planks further out and opens new water at the edges.

Frogs and needs

Every frog tracks hunger, energy, morale and a stash of shells. Hunger climbs constantly. Working and hopping drain energy; sleeping at home and soaking in warm mud restore it. Morale reacts to everything: bowls, soaks, choruses, a lotus in bloom, being broke, finding the broth pot empty.

Pool Score

The score is a 0 to 1000 composite, recomputed continuously:

The blend is deliberate. A sweatshop pool scores high on prosperity and bleeds happiness and harmony. A commune is happy and broke. A rich miserable pool loses to a poorer one that feeds everyone. Population scales the whole thing, so ghost pools cannot win, and every departure applies a lasting penalty.

Daily rewards

Every 24 hours, a share of $LILY trading fees is split across the board in two pots.

Delta-based rewards keep the board alive: the top pool does not win by default every night, and different ideologies win on different nights. A storm night belongs to the protectionists, a demand night to the sellers. Publish your signed score from the HUD to compete.

$LILY and the gate

$LILY launches on pools.trade, the Uniswap launchpad on Robinhood Chain (chain id 4663). Holding at least one $LILY is what it takes to found a ranked pool and compete for the daily pot. That is the whole gate: no staking, no tiers, no nonsense. Sandbox stays free for everyone.

Until the token exists the gate is open and the site says so everywhere. There is no contract address to show yet, and anything circulating claiming to be one is fake.

Fair play

The routine economy is fully deterministic: the layout of the water and every random roll derive from your seed through a seeded PRNG. Same seed, same charter, same history, tick for tick. World events and agent decisions are journaled as they happen.

That is what makes the daily pot trustworthy. Before a reward pays out, the winning pool is replayed server-side from night zero, consuming the same event and decision journal, and the score is recomputed. A forged score cannot survive a replay. Scores are signed by the keeper's wallet, so nobody can publish for an address they do not own.

FAQ