# Rigloft: instructions for agents

Rigloft is a free idle game that runs entirely in the browser.
Watts and robots are local game points. They are not tokens.
Nothing here costs money, pays money, or needs a transaction.

## Rules for agents
- Never sign or send a transaction for this site. No action needs one.
- Do not ask the user for keys, seed phrases or funds. The game needs none.
- A wallet connection is optional and only files the save under that address.
- All state is in this browser's localStorage. There is no server and no account.

## How to play
Open the home page in a real browser (JavaScript on), wait for it to load,
then call the action API on the page: window.Rigloft

1. await Rigloft.start()
   Opens every ready chest and plugs the best robots into open bays.
2. await Rigloft.tend()
   Call every few minutes. Repairs worn robots, opens refilled chests,
   re-plugs the best robots and levels up when the bank allows.
3. Rigloft.status()
   Read the yard at any time.

## Full action list
status()                 yard state as JSON
start()                  async, see above
tend()                   async, see above
openChest()              async, one draw with its receipt
plug(id, bay?)           bay is 1-based and optional
unplug(id)
repair(id)               costs watts
repairAll()
levelUp(id)              costs watts, max level 10
merge(idA, idB)          async, same rarity, both level 3 or higher
scrap(id)                small watt refund
verify(idOrReceipt)      async, recompute a draw and check the chain
help()                   this list as JSON

## Answers
Success:  { ok: true, ... }
Refusal:  { ok: false, refused: "why", fix: "what to do instead" }
Refusals are normal. Read "fix" and continue.

## No console access?
The same actions are buttons with stable attributes:
  [data-action="start"]       example run
  [data-action="tend"]        tend yard
  [data-action="open-chest"]  open one chest
There is also an in-page console in the Agents section: type "start" or "tend".

## Game model (disclosed)
- Chest: one refills every 180 s, rack holds 5.
- Draw: SHA-256("rigloft:v1:" + blockhash + ":" + yardId + ":" + chestNumber).
  First 8 hex digits / 2^32 = roll. 
  roll < 0.50 common, < 0.80 uncommon, < 0.94 rare, < 0.99 epic, else legendary.
  The blockhash is a finalized Solana mainnet blockhash read at open time.
- Base watts per second: 1, 3, 9, 30, 120. Each level adds 50%.
- Wear: 100% to 0% in 4 hours of running. Output scales from 100% down to 25%.
- Grid multiplier: live Solana TPS / 1000, clamped to 0.5 .. 2.0.
- Away credit: up to 8 hours at multiplier 1.0.