Every token your wallet holds with more than a dollar of value is a crop on a plot. The crop's growth stage is a function of two things: how long you've held, and your unrealised P&L on that position. In the current build the P&L term is the token's 24-hour move; the buy-history indexer replaces it with your real entry.

• Seed. Just bought. A mound of soil.
• Sprout. Held a day, or up 20%.
• Leafy. Held three days, or up 50%.
• Tall. Held a week, or up 100%.
• Ripe. Up 200% or more. Gold head. Harvest it or the storm will.

Balances are read from the chain with a public RPC and the explorer. Nothing is written.

A crop wilts when the position is down 50% from your entry. It turns to weeds when the token is rugged: liquidity pulled, or price to zero. Pests appear on a 60% single-day dump.

Weeds and pests spread to adjacent plots after 48 hours if you don't clear them, cutting those crops' growth rate in half. Clearing a plot is free; it just means acknowledging the loss. The farm keeps a count of rugs you planted anyway after the scarecrow warned you.

The indices are computed from the top 200 tokens by volume on the chain the farm is on. They update hourly. The exact formulas are in the docs.

Yield is the multiplier on what a harvest is worth in farm points, the score that decides tiers and the seasonal leaderboard. It never changes your actual P&L.

• Distinct crops. Every distinct token in the ground adds 0.1x, up to 1.5x at six or more.
• Monoculture. More than 70% of your field's value in one token: 0.6x.
• Tired soil. Replanting the same token you harvested last season on the same plot: 0.8x on that plot.

Stake a position and it leaves the field and walks into the pen as an animal. Chickens for small positions, cows for large ones. Animals produce farm points every day they stay, and the daily amount rises the longer they've been there: day 30 pays three times day 1.

Unstake and the animal walks off. Unstake before day 7 and it takes its points with it. In a drought, livestock yield doubles: the farm pays you to be patient exactly when it's hardest.

A barn raising is a community pool. Anyone can propose one: a token, a target size, a deadline. Holders throw in. When the target is hit the pool buys, the barn appears on every contributor's farm, and gains are split by contribution when the pool closes. Miss the target and everyone is refunded.

Pools are non-custodial: the buy is executed by a program, not a person, and each contributor's share is a token they can leave with at any time.

Before any seed goes in the ground the scarecrow scans the contract. Five checks, each pass or fail:

1. Ownership renounced, or no owner function at all.
2. Source code verified on the explorer.
3. Liquidity in the deepest pool, and how much.
4. Top 10 holders under 30% of supply, excluding the pool.
5. Pair age over 7 days.

Two or more fails is a warning. You can still plant. The farm just remembers you did.

Harvesting is selling. In the read-only build the farm detects the sell from your wallet and harvests the crop for you. Once trading from inside the farm is live, harvesting a crop opens a swap you sign in your own wallet, and the protocol takes a fee of 0.5% on the harvest. Fertilizer from holding $FARM cuts that fee by up to half.

Harvested value goes in your barn, which is the running total of realised gains this season. Seasons are 30 days.

Tiers are read from your balance at planting and harvest time. Drop below a threshold and you drop a tier on your next action. Thresholds are proposed starting values.

1. Harvest fee. 0.5% on swaps executed from inside the farm, after fertilizer discounts.
2. Creator fee. 100% of $FARM's launchpad creator-fee allocation is routed to the protocol.
3. Split. 60% funds the seasonal leaderboard prizes, paid to the top farms. 20% buys $FARM and burns it. 20% runs the data feeds and the scarecrow.

Links and the contract address go live at launch, here and nowhere else. Anyone sharing a "$FARM" address before then is not us. Run it through the scarecrow.

• The farm is a picture. A ripe crop is your P&L drawn as a plant. It doesn't know what happens next.
• Price risk. $FARM can go to zero like anything else, and your tier goes with it.
• Data lag. Weather and crops update on a delay. Never trade off the farm faster than the feed.
• Pools. A barn raising can lose money for everyone in it. Contribution is not a claim on anything but a share of what's left.

Farmville is a viewer for memecoin activity styled as a farming sim, with a rug scanner and, later, in-app trading. It is read-only by default. Connecting a wallet grants the app permission to read public data it could read anyway; watching a wallet needs no permission at all.

Chains at launch: Robinhood Chain (chain id 4663, ETH for gas) and Ethereum mainnet. Everything runs in the browser against public endpoints; there is no Farmville server.

Today: the explorer lists the ERC-20s the wallet holds (falling back to a scan of Transfer logs to the address over the last ~70 days on Robinhood Chain), balanceOf and decimals come from the RPC, and DexScreener prices each token and gives its 24h move. Next: an indexer that walks the transfer history to build cost basis, so stages use your real entry instead of the 24h move.

position = {
  token, first_buy, cost_basis_usd, qty, price_usd,
  pnl_pct = (price * qty - cost_basis) / cost_basis,
  held_days = now - first_buy
}

Dust under $1 is ignored, and so are tokens DexScreener has no pool for; the farm tells you how many it skipped.

stage = max(stage_by_time(held_days * weather.growth),
            stage_by_pnl(pnl_pct))
time:  1d sprout, 3d leafy, 7d tall
pnl:   +20% sprout, +50% leafy, +100% tall, +200% ripe
wilt:  pnl_pct <= -50%
weeds: liquidity < $500 or pnl_pct <= -90%
pests: single-day drawdown >= 60%

Weather multiplies the time term only. A ripe crop left unharvested through 12 hours of storm is "blown down": it stays harvestable but drops to tall.

Two indices, computed hourly from the top 200 tokens by 24h volume on the chain.

• Volatility index. Median absolute hourly return over the last 24 hours. Storm when above the 30-day 80th percentile; clears when it falls below the 60th.
• Trend index. Median 7-day return. Drought when below the 30-day 20th percentile for 72 consecutive hours; clears after 24 hours above it.

Storm takes precedence over drought if both fire. The current values and the thresholds are published on the farm page.

Points are the score. They don't convert to anything and can't be traded. They decide the seasonal leaderboard, which pays prizes from the fee pool, and they are the only thing yield multipliers change.

harvest_points = realised_gain_usd * rotation_mult * weather_mult
livestock_points_per_day = staked_usd * 0.001 * min(3, 1 + days_staked / 15) * (drought ? 2 : 1)

A barn raising is a program-owned escrow with a target, a deadline and a token. Contributions are held until the target is met, then swapped in one transaction. Contributors receive a share token. Anyone can redeem their share for the underlying at any time. If the deadline passes under target, contributions are refundable by the contributor.

The five checks and their thresholds are listed on the scarecrow page. Results are cached for 10 minutes. Strict mode in droughts tightens holders to 20% and deployer age to 30 days. Scan results are public and linkable so people can share them.

• Balances: the chain's public RPC (rpc.mainnet.chain.robinhood.com, ethereum-rpc.publicnode.com), eth_getBalance and balanceOf.
• Token discovery: Blockscout (robinhoodchain.blockscout.com, eth.blockscout.com), with an eth_getLogs scan as the fallback.
• Prices, 24h moves, liquidity, pair age: DexScreener's public API.
• Contract checks: owner() and totalSupply() from the contract, holders and verification from Blockscout.

Prices refresh every 60 seconds while the farm is open. Nothing is cached on a server because there is no server.

• v0.2 Farm app preview: walkable field, plant, harvest, stake, barn raising. Scarecrow demo. Weather system.
• v0.1 Concept, mechanics, token utility.