Project: https://playblackout.xyz

Gameplay UX update for the live BLACKOUT site (repo identity-md-launches/launch-1263-build-pre-launch-website-blackout, current live version). Keep everything else as is. Read all rules from the deployed contracts (FarmCore, FarmEngine, FarmItems, FarmRewards, Params); never hardcode numbers that a view or Params key provides.

1. OPTIMIZE FARM + COMBO HINTS (top priority)

• "Optimize farm" button on Farm. It computes the best legal placement of the player's items across unlocked rooms and slots for maximum hashrate, including all combos (Compute Duo, Triple Core, Airflow, Full Stack, Cold Power, Off-grid, Clean Power, Locked Rack, rarity sets) and their Params bonuses.
  • Respect every rule: one item per kind per room, rarity level gates (Epic 3, Legendary 5, Mythic 10 vs the farm's current level), room unlocks, inventory capacity for anything it removes.
  • Score candidates with the contract's own math: mirror FarmEngine allocationHash/roomStats exactly and verify the final result with an eth_call before sending.
• Before applying, show a diff: "+X H/s (+Y%), ≈ +Z tokens/epoch", with the list of moves. Apply as the minimal sequence of unplace/place transactions with a progress bar; stop cleanly on any revert and show the decoded reason.
• Combo hints on every room:
  • active combos with their bonus;
  • near-misses, e.g. "Add a Fan to unlock Airflow: +X% hash, you own one" or "Need a Fan: get one from packs";
  • locked items: "Legendary Fan unlocks at level 5 (you are 2)".
• Inventory cards show "+X H/s if placed best".

2. REFERRALS

• Every connected player gets a personal link: https://playblackout.xyz/?ref=. Copy button, plus share buttons for X and Telegram with a ready text.
• The ref param is stored locally when a visitor lands.
• On the visitor's first farm action, the site offers "Join with your inviter's bonus" and calls FarmCore.setReferrer(inviter).
  • Explain plainly: the inviter earns +5% on top of your mining, and you lose nothing.
  • Rules from the contract: it can be set only once, only before the farm's first settlement (after that it is closed forever), and only to an older farm. Check eligibility with views and eth_call first; hide the prompt when not eligible.
• "Invite" panel: referees list (from ReferrerSet events), their hashrate, and total earned from referrals.
• Show "Invited by 0x…" on the player's own farm.

3. TODAY (daily ritual block at the top of Farm and in the Mining HUD)

• Claimable rewards with a Claim button; withdraw tax shown before the click.
• Worn items: health bars and a "Repair all" button with total cost (repair, repairCable).
• Epoch countdown, plus this epoch's swarm letter and event for the player's district.
• New packs to open, with a count and "Open all".
• Remove any overclock UI: overclock is disabled on chain.
• Opt-in browser notifications (Notification API) while the site is open: "Epoch ends in 10 min", "Rewards ready to claim", "Item below 30% health". Never spam; one per event.

4. SMALL FIXES

• Leaderboard item preview: show the items actually installed in the farm's rooms (the ones mining), not inventory. If inventory is shown at all, label it "Best pulls" and dim it.
• Number formatting: always use a dot as the decimal separator ("2.25 days", not "2,25").
• Reduce failed RPC requests (HTTP 400/403): drop failing endpoints, chunk eth_getLogs to provider limits, back off on errors.

ACCEPTANCE: tests for the optimizer (it never proposes an illegal placement, and its hash matches the contract), referral eligibility logic, and Today actions. Screenshots at 375px and 1440px in the PR.