Build "Squeek Pet": a browser virtual-pet game where your own pixel hamster lives in sync with Squeektoshi, the real hamster whose wheel powers Squeekchain (a proof-of-work toychain on Ethereum Sepolia). Static site, no backend, no wallet, mobile-first, saves in localStorage.

CORE IDEA

Your pet mirrors the real wheel. When Squeektoshi runs, your pet can run beside him and earn Seeds. When he sleeps, your pet naps and recovers faster. Real wheel milestones become in-game events. Care for the pet with Seeds. The pet never dies; neglect only makes it grumpy and slow.

DATA (public, read-only, CORS open, no key)

Base: https://api.squeekchain.com/v1. Big numbers are decimal strings: parse with BigInt or Number carefully. If a response has "status":"unavailable", treat values as unknown, never as zero.

• GET /status (poll every 15 s while the tab is visible): measurement.coreStatus ("ACTIVE" running, "IDLE" resting, "COUNTER_FAULT"), measurement.freshness ("online"/"stale"), measurement.rpmMilli (rpm x1000), measurement.speedMmPerSecond, measurement.distanceMm (distance in the current Squeek day), measurement.cumulativeWorkUnits (total magnet passes; 1 pass = 1 work unit), builder.anchor.blockHeight (Squeek blocks), builder.anchor.blockProgress (0..1e9 = progress to next block).
• GET /measurement/stats?range=7d (poll every 5 min): activity.days[] each {date, observedWorkUnits, distanceMm, buckets[48] {startMinuteUtc, workUnits}}; a Squeek day runs 12:00 to 12:00 UTC and is named by its starting noon, so buckets with startMinuteUtc >= 720 are on "date", others on the next calendar day. Also records{} (peakObservedSpeedMmPerSecond, maximumDailyDistanceMm, ...).
• GET /events?category=measurement&limit=20 (poll every 2 min): events[] {id, type, occurredAt, payload}; types include measurement.speed_record, measurement.distance_milestone, measurement.daily_distance_milestone, measurement.speed_milestone, measurement.distance_streak. Handle 429 (wait Retry-After), timeouts and offline with a calm "Can't reach the wheel right now" state; the game stays playable from saved state. Never call the API more often than listed.

GAME RULES

Stats 0-100: Hunger (rises), Happiness, Energy, Cleanliness (fall). Decay continues while the page is closed, computed from saved timestamps, capped at 12 hours of decay.

• Sync run: when coreStatus is ACTIVE and pet Energy >= 20, the pet runs on its wheel. Each new real magnet pass (difference in cumulativeWorkUnits between polls) gives 1 Seed, max 600 Seeds per real hour. Running costs Energy and adds Hunger.
• Away earnings: on return, sum workUnits from the 7-day buckets that fall inside the time away (max 12 h) and credit 50% as Seeds, shown as a "While you were away, Squeektoshi ran X passes; your pet earned Y Seeds" card.
• Nap together: when the real wheel is IDLE, Energy recovers 2x faster.
• Care actions: Feed (sunflower seed, carrot, mealworm: different costs and effects), Play (toy), Clean, Pet (free, small Happiness, 10/day cap).
• Growth: XP from care and sync runs. Stages: Pup, Junior, Adult, Wheel Legend.
• Shop for Seeds: foods, toys (tunnel, chew stick, ball), cosmetics (3 hats, 3 wheel skins, cage backgrounds). Cosmetics are visible on the pet.
• Daily quests (3 per Squeek day, reset at 12:00 UTC), some tied to real data, e.g. "Squeektoshi runs 2 km this Squeek day" (status distanceMm), "Be here when a new Squeek block lands" (blockHeight increases while open), "Pet your hamster 5 times". Show progress bars.
• Festivals: a new measurement.speed_record or distance milestone event (newer than last seen, dedupe by id) starts a 1-hour 2x Seeds festival with a banner.
• Never encourage or pressure the real hamster to run. Copy is kind: naps are good too.

SCREENS

1. Home: cage scene with the pet (idle, eat, run, sleep, happy, grumpy animations), stat bars, Seeds balance, buttons for actions. A "Squeektoshi live" strip: running/resting pill, rpm, km/h, km today, progress to next Squeek block, and a link to the official stream page https://sepolia.squeekchain.com.
2. Shop. 3. Quests. 4. Wardrobe (equip cosmetics). 5. About: how the sync works, data source, "unofficial fan game, testnet values have no monetary value". First visit: adopt flow (name the pet, pick fur color from 4).

ART AND FEEL

Original pixel art drawn in code on canvas (no copyrighted assets, no external images). Warm, cute, readable. Light and dark themes via prefers-color-scheme. Large tap targets, works at 360 px wide, keyboard accessible, prefers-reduced-motion respected. Optional Web Audio blips with a mute toggle, off by default.

TECH

Plain HTML, CSS and JavaScript or a small Vite build; output a static export that works from IPFS under any path (relative asset URLs, hash routing, no server). No trackers, no analytics, no wallet connection. Save: one versioned localStorage key, with export/import of the save as a text code. Keep game logic in pure functions (decay, earnings, quest progress) with unit tests, and document the API mapping in README.md.

ACCEPTANCE

• Loads with live data from api.squeekchain.com; shows correct running/resting state and numbers.
• With the API blocked, the game still loads and is playable.
• Sync run only earns while coreStatus is ACTIVE; earnings respect the hourly cap.
• Closing the page for 2 hours then returning applies capped decay and the away-earnings card.
• Quests reset at 12:00 UTC; festival starts once per new milestone event.
• No horizontal scroll at 360 px; no console errors.
• README explains setup, the rules above and the data fields used.