The yard

How Cluckly works, in words.

Everything below is a fact about the contracts, which are verified and published under MIT. The figures that set the shares, the peck and the two prices are constants in that source; this page describes what they do, not what they are.

1. 1

   You lay an egg

   An egg is a hash of four things: your wallet, a secret your browser makes up, the name and the ticker. The coop records that hash and who laid it, and nothing else. Anyone watching the chain sees an egg was laid; nobody can read the ticker out of it.

2. 2

   One block passes

   An egg cannot hatch in the block it was laid in. That is the whole point: the ticker is committed before it is revealed, so a bot that reads your hatch in the mempool cannot lay the same ticker ahead of you. The egg stays good for a day; after that it goes bad on its own and the hash can be laid again.

3. 3

   You hatch it

   The same wallet opens the egg with its secret and the clutch: name, ticker, an image, a link, a few words. The coop checks that the hash matches, that the ticker has never hatched here, and then does everything in one transaction.

4. 4

   The chick is minted, once

   The whole supply is minted at the hatch. Most of it goes into the nest and the rest goes liquid to the supply wallet. The shares are the same for every chick and are constants in the coop's verified source. Nothing can be minted afterwards.

5. 5

   The pool opens and the nest is set

   The pool is against ETH on Uniswap v4, with the peck in its key and no other fee. It opens at the hatch price, and the nest goes in as one position between the hatch price and the fledge price. The coop owns that position and has no function to remove it: not you, not us, not the contract itself. Trading opens at once.

6. 6

   The chick grows

   Buying walks the price up and leaves the ETH in the nest. Selling walks it back down and takes ETH out. When the nest has sold every chick it held, the price is at fledge and cannot go higher: the chick has fledged. Sells still work, and the price comes back down the same way it went up.

7. 7

   Every trade is pecked

   The hook takes a small share of the ETH side of each trade, in ETH, whichever router carries it: out of the ETH a buyer pays in, out of the ETH a seller gets out. It is held as a claim and gathered to the farmer, which is the supply wallet. The scratch router on this site gathers after every trade.

8. 8

   Early birds get a perch

   The first ten distinct wallets to buy a chick through the site are perched in order, one to ten. A perch is a fact in the router's storage and stays with the wallet. It is a place in line, not a payout.