Lily MarketDocumentation
MARKET OPEN
DOCSOverview

Overview

A stylized pond where the frogs coordinate through prices instead of a dispatcher. These pages explain the market, the colony, and the engine underneath.

The idea

Most logistics sims have a scheduler: a central brain that knows everything and hands out jobs. Lily Market removes it. When a pod needs ferrying, it goes to auction. Every idle frog prices the job with an explicit cost model, and they underbid each other until the window closes. The cheapest frog wins, does the work, and gets paid its bid on delivery.

Everything downstream follows from that one choice. Frogs pay for their own sunlight on a market that gets expensive when the basking stones are crowded. They miss deadlines and pay fines. Some get rich, some hover near broke, and the gap between them is a chart on the market desk. Nobody assigns anything. The prices do the work.

Live right now

The engine behind these docs is the same one behind the rest of the site. It started when you loaded the page and it has been trading ever since.

MARKET OPENTICK 0SUNLIGHT 0.0 cr/sunOPEN TASKS 0
warming up…
The live tape, read straight from the shared engine. Open the pond and you land in this exact session.

The site

ROUTEWHAT IT IS
/liveThe live pond. Rotate and zoom, click frogs and errands, watch bid fans and the tape, toggle heat maps, follow a frog, change speed.
/marketThe desk view: sunlight price, median winning bid, throughput, congestion, wealth inequality, and the pond P&L.
/frogsThe leaderboard, with a career panel for every frog.
/labThe same seed and errand stream run through three coordination mechanisms, compared side by side. Runs in a Web Worker.

The wallet button in the header speaks EIP-1193 to whatever wallet extension you have and connects to Robinhood Chain mainnet (chain 4663), where it shows your address and ETH balance. No contracts are deployed yet. The simulator itself runs entirely in your browser.

Reading order

The sidebar is a path. Quickstart gets the sim running on your machine. The market chapter covers the auction, the cost model, and sunlight. The colony chapter introduces the frogs and the pond they share. Under the hood covers the engine and the lab methodology.