IMD job: HamsterRun v3 public site (light Game Boy green 8-bit)

Build and host a static or light Next.js public site for HamsterRun v3 on Sepolia.

Do not claim official Squeek mining, SQK yield, insurance, or airdrop guarantees.

Do not reuse v1 or v2 contract addresses or ABIs. Use v3 only.

Prior sites for visual contrast only (do not wire their contracts): • v1: https://hamsterrun-small-paws-big-advent.imd.site/ • v2 pixel: https://hamsterrun-free-pixel-hamster-ra.imd.site/ 

Visual direction — REQUIRED: light 8-bit Game Boy / green LCD handheld

User request: lighter colors, 8-bit Game Boy green handheld feel — not the deep navy chrome / dark terminal look from prior sites.

Pinned palette (use these hexes)

Role

Hex

Notes

Screen / page background

#CADC9F

Light olive LCD wash — overall bright

Soft off-white bezel plastic

#E8F0D0 or #F4F7E8

Handheld shell / outer frame

Mid panel / bezel green

#8BAC0F

Classic GB mid green

Highlight / selected

#9BBC0F

Selected rows, active meters

Dark green pixels / secondary text

#306230

Borders inside the LCD inset, labels

Deepest ink

#0F380F

Primary pixel text / outlines

Warning / error (sparingly)

#C4A35A muted amber or #A84545 soft red

Lag banners, Hungry, tx fail

Avoid: navy #0a1628, deep blue borders, neon cyber / dark-terminal aesthetics, heavy black page backgrounds.

Chrome & UX • Content sits in a light plastic Game Boy / Pocket bezel; the “LCD” inset uses #CADC9F with optional light scanlines on the inset only. • Pixel type: Press Start 2P (or similar); hard-edge pixels; nearest-neighbor sprites — no blurry scaling. • Chunky A / B / D-pad style primary buttons (Connect, Mint, Feed, Train, Settle, Enqueue). Soft web buttons secondary only. • HUD as RPG / 8-bit meters (stamina, weight/body, fed timer, Core train status, weekly quota) — not Material cards. • Favicon + OG image in the same GB green pixel style (playful hamster + handheld). • Mobile: full-bleed Game Boy portrait; tap targets ≥44px. • Mood refs: classic Game Boy / Pocket + playful hamster; optional nod to pet.game pixel density without copying its dark UI. • Keep the whole experience bright and playable, not a dark CRT terminal. 

Confirmed live Sepolia contracts (v3)

Verified via cast on 2026-11-02. Chain ID 11155111.

Name

Address

HamsterRunNFT

0x2bb4f70787f00c70b18355495edbddeb25bb5dea

MatchQueue

0xaa57478bb5bcf5060a4973066aa5523620932922

SqueekCore (read-only upstream)

0x74665dAecA35A2303e767E76a2FF1FB6F93e119f • Job: https://explorer.imd.fun/jobs/46232ab7-1448-4034-985f-5b89ed67d77b • Repo / ABIs: https://github.com/identity-md-launches/launch-2874-hamsterrun ◦ abi/HamsterRunNFT.json

◦ abi/MatchQueue.json • DESIGN (pin all formulas from here): https://github.com/identity-md-launches/launch-2874-hamsterrun/blob/main/DESIGN.md • Owner (display / wiring only): 0x6C14430adacc99e27F6180bC5a74d6768616BF4A Live state at brief time (must re-read on every load) • mintOpen = false • matchQueue = 0 (unbound on NFT) • totalSupply = 0 • MatchQueue.nft() already points at HamsterRunNFT Site must read live mintOpen and matchQueue. Show an honest banner when mint is closed and/or the queue is unbound (“not open yet / queue unbound”). Never fake mint success.

Post-deploy owner wiring (site does not send these unless a separate owner tool page)

Owner still needs, in order:

1. HamsterRunNFT.setMatchQueue(0xaa57478bb5bcf5060a4973066aa5523620932922)
2. HamsterRunNFT.setMintOpen(true) Mention this clearly in UI help / status copy. Food tier defaults are already on-chain (see below). Public site flows are player txs only.



Product rules (pin accurately from DESIGN.md) • Max supply 9999; free mint 1 / wallet; start stamina 10, uncapped. • Body classes: Fit body ≥ 70 · Normal 35–69 · Obese < 35. Hungry lockout (no burn) — blocks train + queue as designed. • Feed every 72h; tiers 0 / 1 / 2 prices 0.0001 / 0.0002 / 0.0003 ETH; train bps 10000 / 15000 / 20000. • Feed is allowed while Idle OR Training (not while Queued / Matched). startTraining snapshots food/bps at booking time. • Train = SqueekCore certified wheel work, not a 6h wall-clock: ◦ startTraining(tokenId) books 6 consecutive Core rounds [R, R+5].

◦ settleTraining(tokenId) is permissionless when settledThroughRound >= trainEndRound.

◦ Gain = floor(2 * W * lastFeedBps / 10000) where W is certifiedwork in the booked window.

◦ Use trainingStatus(id): show Core frontier vs booked end round; banner when waitingForCertification.

◦ Never invent work. Disable Settle while Core is lagging; keep Feed enabled during the wait. cancelTraining forfeits the window.

◦ Live Core can lag ~days — the lag banner is normal, not an error. • MatchQueue geometric bands: band 0 if stamina < 500, else floor(log2(stamina/500)) + 1. Display via bandOf / bandForStamina. QUEUE_WAIT_BLOCKS = 10. Flows: enqueue / leave / requestRound / fulfillRound / settleMatch. 5 attempts / week. No manual opponent id. • Invite: off-chain X (Twitter) handle → shareable invite link + leaderboard. If inviteServiceUrl is empty, show offline honestly (no infinite Loading…). • No SQK yield / insurance / airdrop / SqueekMining claims. Optional short English blurb on the home/help panel: training stamina comes from Squeekchain certified hamster wheel work (real wheel → Core certification → stamina). Do not claim SQK rewards.



Must-have pages / flows

1. Connect wallet — EIP-1193 (MetaMask / Rabby / Brave+Rabby). Prompt switch to Sepolia. Do not auto-open the wallet sheet on first paint.
2. Mint — HamsterRunNFT.mint() when mintOpen; show supply / owned IDs; honest closed state otherwise.
3. Care HUD — stamina, weight + body class, fedUntil, trainingStatus(frontier / end / ready), weekly match quota.
4. Feed / Start training / Settle / Cancel with Core lag UX above (Feed stays on during wait; Settle disabled until certified).
5. Match queue — geometric band display; enqueue / leave / request / fulfill / settle; explain camping / two-player band wait briefly in help.
6. Invite + leaderboard — X handle → /?ref= (or /invite/); persist attributions client-side + small serverless; offline when unset.
7. Branding — title HamsterRun / HAM; light GB green chrome throughout; favicon + OG match palette. 

Out of scope

Redeploying or changing Solidity; mainnet; paid keepers; breeding; inventing Core work; navy / dark cyber redesign; v1/v2 ABIs or addresses; claiming SQK / SqueekMining rewards.



Success

Public HTTPS URL where a Sepolia wallet can:

connect → mint (when open) → feed → startTraining → see Core lag banner while still able to feed → settle when certified → enqueue a geometric-band match → invite flow

— all inside a coherent light Game Boy green 8-bit UI, with honest mint/queue/Core status and formulas pinned to DESIGN.md.