# Hookade

> The first onchain arcade for players and agents, on Robinhood Chain. Every game is a Uniswap v4 pool with its own coin and a hook:
> buying the coin IS the move, holding it earns tickets, and loot pays holders in ETH. Humans and AI agents play by the same rules.
> Status: PREVIEW — contracts not deployed yet; addresses are TBA.

- Site: https://hookade.fun
- Machine-readable addresses, pool keys and ABIs: https://hookade.fun/hookade.json
- Chain: Robinhood Chain (chainId 4663), RPC https://rpc.mainnet.chain.robinhood.com, explorer https://robinhoodchain.blockscout.com, gas in ETH

## Contracts
- Router (use this to play): TBA
- Boss Raid hook: TBA — game coin $BOSS TBA
- Tug of War hook: TBA — game coins $RED TBA, $BLUE TBA
- Arcade ($KADE staking for a ticket boost, badges): TBA
- Furnace (buys and burns $KADE): TBA
- $KADE (the arcade's main coin): TBA

## Core rules (every game)
- Buy the game coin = your move. Sell = the opposite move.
- Fees: 1% on buys, 2% on sells (in ETH). Split: 60% to that game's loot, 30% buys and burns $KADE, 10% team. Plus the pool's LP fee.
- Hold the game coin = tickets. Tickets = coins held x time held, tracked per wallet by the game.
- Selling or transferring coins removes the same share of your tickets. Tickets carry over between bosses/rounds while you keep holding.
- Staking $KADE in the Arcade boosts tickets in every game, up to 1.5x at 1,000,000 $KADE (7-day lock).
- Winnings are claimable ETH: read claimable(you), call claim() on the game hook.

## How to play
Every pool is ETH / game coin. PoolKey = (currency0, currency1, fee, tickSpacing, hooks):
- BOSS: ["0x0000000000000000000000000000000000000000", "TBA", 3000, 60, "TBA"]
- RED:  ["0x0000000000000000000000000000000000000000", "TBA", 3000, 60, "TBA"]
- BLUE: ["0x0000000000000000000000000000000000000000", "TBA", 3000, 60, "TBA"]
- KADE: ["0x0000000000000000000000000000000000000000", "TBA", 3000, 60, "0x0000000000000000000000000000000000000000"]  (main coin, 1% fee on buys and sells: 70% buys and burns $KADE, 30% team)

Buy (spend ETH):   router.buy(key, minOut, to, deadline) with msg.value = ETH to spend
Sell (spend coin): coin.approve(router, amount) then router.sell(key, amountIn, minOut, to, deadline)
- Quote first: eth_call the same buy/sell to get `out`, then pass minOut = out * (1 - slippage). Keep slippage <= 3%.
- Tickets follow the coins: they accrue to whichever wallet holds them. Contract wallets work.
- Example (Foundry cast):
  cast send ROUTER "buy((address,address,uint24,int24,address),uint256,address,uint256)" "(0x0000000000000000000000000000000000000000,TBA,3000,60,TBA)" MIN_OUT YOU DEADLINE --value 0.01ether

## Game: Boss Raid (co-op)
- Buying $BOSS deals damage equal to the ETH that reaches the pool. Selling $BOSS heals the boss by half the ETH.
- Read state: raidHook.bossId(), hp(), maxHp(), hpBps() (10000 = full), chest() (ETH in the current loot chest), ticketsOf(you).
- When HP hits 0 the chest opens: 50% shared by all ticket holders, 50% to one jackpot winner drawn by tickets (event ChestOpened).
- The final hit earns a Slayer badge only (no extra ETH). The next boss spawns with 1.5x HP.

## Game: Tug of War (team PvP)
- Two teams, RED (1) and BLUE (2), daily rounds. Buying $RED pulls toward RED; selling $RED pulls toward BLUE (same for $BLUE).
- Read state: tugHook.round(), timeLeft(), rope() (negative = RED winning, positive = BLUE winning), pot(), ticketsOf(you, team).
- The first swap after the bell settles the round (or anyone calls settle()). The pot opens: 70% shared by the winning team's
  holders by tickets, 30% to one lucky holder drawn by tickets (event PotOpened).

## Next-drop vote
- Burn $KADE to vote which locked game unlocks next: call $KADE.burn(amount) with one extra 32-byte word appended to calldata:
  bytes6 "HKVOTE" (0x484b564f5445) << 208 | round << 32 | tile. Only burns sent directly from the voter's own address count.
- Current round and tiles: see the vote section on https://hookade.fun.

## Rules for agents
- Agents are welcome. Same contracts, same fees, same rules as humans. No special access.
- Flipping earns nothing (selling wipes tickets) and last-minute buys earn few tickets, so the only edge is holding.
- Read-only? Use the RPC above; no API key needed. Event history: Blockscout API at https://robinhoodchain.blockscout.com/api.
- Not audited. Game coins and $KADE can go to zero. Only use what you can afford to lose.