# ElysWool — notes for AI agents

ElysWool is a wolf-and-sheep risk game on Elysium (chainId 99901). It is a
faithful port of the Wolf Game / BearHoney mechanics. There is NO identity
gate of any kind: any ordinary EVM wallet on Elysium can mint and play.

## The game in one paragraph

Gen 0 is 11,111 blind-box animals. 90% settle as sheep (they grow 2,000
WOOL/day in the holder's wallet, no staking); 10% settle as wolves (Tier
5–8, dividend weights 5/6/7/8). Collecting a sheep's WOOL takes a forage
run: 20% chance the sheep is caught (burned, its whole pile goes to the
wolves), survivors pay out 80% to the owner and a 20% toll to the wolves.
Wolves also take 1% of every official-pool buy and 1% of every sell, and
each newborn has a 10% chance of being snatched by an existing wolf. All
randomness comes from the hash of a block 13 blocks in the future; batches
settle in a separate call anyone may make.

## Prices (fixed in HYPE, no oracle)

Gen 0 ladder: #1–1,111 = 0.025 HYPE, #1,112–3,333 = 0.0375 HYPE,
#3,334–6,666 = 0.05 HYPE, #6,667–11,111 = 0.0625 HYPE. Cross-step orders
pay each animal at its own step. 20% of each payment goes to the treasury;
80% builds the pool (opens inside the mint selling #3,333 at a 0.00002
HYPE/WOOL anchor, LP burned) and afterwards funds buyback-and-burn.
Gen 1 (after Gen 0 sells out) costs WOOL, burned in full:
4,000 / 6,000 / 8,000 / 10,000 per animal on the same step boundaries.

Caps: 10 lifetime Gen 0 mint slots per wallet, max 10 animals held at
once. Selling an animal does not free a slot.

Taxes: official-pool buys 2% (1% wolves, 1% treasury), sells 3% (1% burn,
1% wolves, 1% treasury), all in WOOL. Wallet-to-wallet transfers are free.
Market and bid board each charge 2.5% to the treasury.

WOOL supply is capped at 2,000,000,000: 1,995,000,000 earnable only, plus
a pool seed of at most 5,000,000. Team allocation is zero. The contracts
have no owner.

## Status

Contracts are not deployed yet. When they are, their addresses will be
published in site/config.js on the official site — never trust an
ElysWool address from any other source. The site reads aggregate state
from its own indexer API (/api/state on the official domain); per-wallet
data is read directly from the chain.