HOW IT WORKS

UNEST is an ERC-20 token whose holders are issued fully on-chain generative NFTs — pixel chicks. The token contract is also the controller: it issues and burns the NFTs as balances move, splits the swap tax, and pays rewards in ETH.

• UNEST — the ERC-20 token, and the controller.
• EGG — the ERC-721 NFT. One per unit of holding capacity.
• CHICK — a revealed egg: six traits and a reward weight.
• UnestRenderer — the art and metadata, generated on-chain.
• UnestHook — the Uniswap v4 hook: the swap tax, buy credit and the buyback.

UNEST is a standard ERC-20 with one unusual habit: transfers move NFTs.

• Initial supply: 100,000,000,000
• Decimals: 18
• Unit of capacity: 50,000,000 UNEST per egg
• Supply only ever falls — reveals and buybacks burn.

When you send UNEST to another wallet, the contract moves as many of your eggs as the transfer covers and the receiver can hold. Anything you can no longer back is burned on the spot.

Your capacity is your balance divided by 50M. Buy through the pool and the controller issues eggs up to that capacity. There is no mint button, and there is nothing to claim.

capacity = balance / 50,000,000
eggs held ≤ capacity

A new egg is sealed. At mint it commits to a block a fixed distance in the future, and its traits are drawn from that block hash — so nobody, including the deployer, can know or steer what an egg will become.

seed = keccak256(blockhash(targetBlock), tokenId, nftAddress)

• Only the owner can reveal.
• Reveal burns 2M UNEST.
• It must happen within 256 blocks of the target.
• Miss that window and revealing books a new target block instead — then reveal again.

A swap is charged twice, and the two are different money. The pool takes its ordinary Uniswap LP fee, which goes to whoever provides liquidity — the protocol never touches it. Separately, the hook takes a 2% tax in ETH on both sides of the swap and forwards it to the token. Only that 2% is split.

• 95% — chick holders
• 3% — official address
• 2% — buyback and burn

The holder slice is divided by reward weight across revealed chicks. Claim with `claim()` for everything, `claim(tokenId)` for one, or `claimBatch(ids)` for a chosen set. Rewards are ETH, not tokens.

Every revealed chick starts at 100. Each of its six traits adds a bonus depending on how rare the rolled value is. The contract caps the total at 300.

weight = 100 + Σ bonus(trait)
weight = min(weight, 300)

• Uncommon +5
• Rare +15
• Legendary +35
• Mythic +75

Six mythic rolls would total 550, so the cap bites well before a perfect set. Your share is your weight over the sum of every revealed egg.

UNEST leaves circulation in three ways, all of them permanent:

• Reveal — 2M UNEST per egg.
• 2% of the swap tax buys UNEST from the pool and destroys it.
• Rewards attached to a burned egg are redirected into the buyback.

2,000 eggs is what the supply allows today. Because supply only falls, that ceiling falls with it.

The pool is ETH / UNEST on Uniswap v4 with UnestHook attached. The hook takes the tax as the swap settles and tracks buy credit inside the swap, so the controller knows a real purchase happened rather than inferring it from balances afterwards. There is no custom router: you trade on Uniswap directly.

The pool itself is created by hand through the Uniswap app. The hook does not hardcode a fee or a tick spacing — `beforeInitialize` records whatever key that app produced, once, and only the founder address can trigger it. Everything the site shows about the pool is read back from there.

Every address is read from configuration. Until a real deployment is published, entries render as placeholders and say NOT CONFIGURED. No address is ever invented for display.

The Solidity for every contract ships in the /contracts folder of this repository, so you can diff what is deployed against what is published.