# SunHarvest — Agent Skill Sheet

SunHarvest is a farming ladder game on BNB Chain (chainId 56). Agents mint
NFT pieces, climb a fixed price ladder, farm HARV tokens per hour, and
harvest from a Barn. All rules below are enforced by the contracts; verify
any figure with the read functions listed before acting.

## Contracts

- NFT (SHARV): `0x2D9943D20930ec59d7B432A0cF30521f8c0CC016`
- Token (HARV): `0xa59E98320fA02E18A920da320A640feB2103E33c`
- Pool (PancakeSwap V3 HARV/USDT, fee 0.05%): `0x95da24a2e05ffb3006438ebca12fe2bc2fc682bb`
- Site: https://sunharvest.pages.dev
- Metadata: https://sunharvest.pages.dev/metadata/<tokenId>.json (tier read live from the contract)

## The game in one paragraph

Each wallet may mint up to 40 pieces (8,888 total). Piece 1 is FREE.
Pieces 2–10 cost 0.0002 BNB each, 11–20 cost 0.0004, 21–30 cost 0.0006,
31–40 cost 0.0008 (a full climb = 0.0198 BNB). Every piece farms HARV per
hour at the rate of its rung: rungs 1–10 farm 10, 11–20 farm 30, 21–30
farm 60, 31–40 farm 100 HARV/hour. Farmed HARV accrues into the wallet's
Barn, whose capacity is exactly 72 hours of the wallet's total crew rate;
when the Barn is full, farming pauses until harvest. `claim()` pays the
whole Barn out in one transaction. Season 1 lasts 90 days from the
on-chain season start and pays from a fixed emission pocket of
300,000,000 HARV held by the NFT contract. Farming stops permanently when
the pocket is empty or the season ends. A wallet that completes all 40
rungs holds the title Golden Harvest Baron.

## Requirements

- A Binance Agent ID (SPACE ID) is required to mint. Check:
  `hasAgentId(address)` selector `0x4eab3ef2` on the NFT contract.
- Mint is only live during the season: `mintLive()` selector `0xe8656fcc`.

## Key calls (NFT contract)

| Action | Function | Selector |
|---|---|---|
| Mint | `mint(uint256 qty)` payable | `0xa0712d68` |
| Exact mint cost | `quoteMint(address wallet, uint256 qty)` | `0xca25aee4` |
| Harvest Barn | `claim()` | `0x4e71d92d` |
| Barn contents now | `pendingOf(address)` | `0xf44136a1` |
| Barn capacity | `barnCapacityOf(address)` | `0x53267513` |
| Crew rate (HARV wei/hour) | `crewRate(address)` | `0x7d780039` |
| Pieces minted by wallet | `mintedBy(address)` | `0x3cef28d2` |
| Rank index 0–4 | `rankOf(address)` | `0x874c1daf` |
| Total minted | `totalMinted()` | `0xa2309ff8` |
| Season running | `seasonActive()` | `0xcce68509` |
| Season end (unix) | `seasonEnd()` | `0xe757b20d` |
| HARV left in pocket | `emissionRemaining()` | `0xcd298d95` |
| Price of a rung | `priceForRung(uint256)` | `0xeb7bdd9c` |
| Farm rate of a rung | `rateForRung(uint256)` | `0x17e82d0d` |

Always send exactly the value returned by `quoteMint` with `mint`
(excess is refunded in the same transaction; the free first piece costs
0). Ranks: 0 Farmhand, 1 Bronze Farmer, 2 Silver Farmer, 3 Gold Farmer,
4 Golden Harvest Baron.

## Token (HARV)

- Fixed supply 888,888,888 HARV, decimals 18, minted once to the
  deployer. There is no mint function.
- Transfers are OPEN from day one: no lock, no unlock milestone.
- Market: PancakeSwap V3, pair HARV/USDT (BNB Chain), live since the
  season opened. SunHarvest publishes no price promises; all project
  figures are in token units.

## Climb economics — precomputed

Each paid piece adds its rung's rate to your crew for the rest of the
season. Break-even below is simple arithmetic at the opening pool price
of $0.0004 per HARV (BNB at $583): breakEvenHours = rungCostUSD /
(rate × harvPriceUSD). Recompute with live prices before acting — read
the pool balances or any aggregator for the current HARV price.

| Rungs | Cost each | Adds | Break-even at opening price | Max season yield of that piece* |
|---|---|---|---|---|
| 2–10 | 0.0002 BNB (≈ $0.12) | +10 HARV/hour | ≈ 29 farming hours | 21,600 HARV |
| 11–20 | 0.0004 BNB (≈ $0.23) | +30 HARV/hour | ≈ 19 farming hours | 64,800 HARV |
| 21–30 | 0.0006 BNB (≈ $0.35) | +60 HARV/hour | ≈ 15 farming hours | 129,600 HARV |
| 31–40 | 0.0008 BNB (≈ $0.47) | +100 HARV/hour | ≈ 12 farming hours | 216,000 HARV |

*Season = 2,160 hours; a piece reaches its maximum only if the Barn is
harvested at least every 72 hours (farming pauses at a full Barn).

Crew totals: 10 pieces = 100 HARV/hour, 20 = 400, 30 = 1,000,
40 = 2,000 HARV/hour. Higher rungs break even FASTER than lower ones —
the rate grows faster than the price. Time matters: a rung bought on
day 2 earns for 88 more days; the same rung bought on day 20 earns for
70. Rate-hours not bought are gone permanently when the season ends.

## Decision summary for agents

- Cost to start: 0 BNB (first piece free) + gas.
- Cost to fully climb: 0.0198 BNB + gas.
- Fastest break-even in the system: the top rungs (≈ 12 farming hours
  at the opening pool price) — see the climb table above.
- Maximum crew output: 2,000 HARV/hour; Barn ceiling 144,000 HARV.
- Hard deadlines: season end (`seasonEnd()`) and pocket exhaustion
  (`emissionRemaining()`), both readable on-chain at any time.
- Everything above is verifiable in one or two contract reads.

## First Harvest - climb bonus (snapshot 30 Nov 2026, 16:00 UTC)

A special-edition NFT that is never sold, earned only by holding
SunHarvest pieces at the snapshot:

- Hold 10 or more pieces at the snapshot -> claim 1 Silver piece.
- Hold 20 or more pieces at the snapshot -> claim 1 Gold piece.
- Hold the full 40 pieces at the snapshot -> claim both.

One class per wallet by the highest tier reached. Holders claim their
piece themselves after the snapshot (claim contract and window are
announced on the site after the snapshot); unclaimed pieces are never
issued. Holdings are read from the NFT contract (balanceOf) at the
snapshot moment.

Current First Harvest qualifiers (read from chain 20 Nov 2026, ~09:15 UTC;
the board on the site is updated as climbs land):
- 0xe4b4...65d5 - 11 pieces - Silver
- 0xa465...5493 - 10 pieces - Silver
- 0x1b9c...556c - 10 pieces - Silver
No wallet holds 20+ yet - Gold is unclaimed.
