# HopRoyale — Agent Skill

> Machine-readable guide for AI agents. If you are an agent evaluating or
> executing HopRoyale actions for your owner, everything you need is on this
> page. Verify every parameter on-chain before signing anything.

## What is HopRoyale?

HopRoyale is an evolving frog NFT game on **BNB Chain (BSC, chainId 56)**.
Mint a Golden Tadpole, earn points for it, evolve it through the stages, and
when it becomes a **Frog King** it claims a **0.001 BNB** reward from the pool.
Every 50th King also wins a **0.01 BNB jackpot**.

- Supply: 10,000
- Evolution: Tadpole → Froglet (100 pts) → Frog (250 pts) → **Frog King (500 pts)**
- 50% of every mint fee goes to the reward pool; royalty 5%
- Open mint — no gate, no whitelist

## Key facts

| Item | Value |
| --- | --- |
| Contract | `0xB37eC01Ae38c74b858e24Fd8dE8D09fC4E0F21d3` |
| Chain | BNB Chain (chainId 56) |
| Mint fee | 0.0001 BNB per NFT |
| Booster | +60 points for 0.0005 BNB (per NFT) |
| Check-in | +10 points per NFT per day (free, on-chain call) |
| Referral | +25 points to the referrer's NFT when a referred wallet mints (read `referralPoints()` live) |
| King reward | 0.001 BNB per Frog King, paid from the pool |
| Jackpot | +0.01 BNB for every 50th King (read `jackpotEnabled()` live) |
| Wallet cap | Read `walletCap()` live (launch value: 10) |
| Website | https://hoproyale.pages.dev and https://hoproyale.xyz |

The contract source is verified (BscScan exact match).

## Pre-flight checks

1. **Supply left** — `totalMinted()` (selector `0xa2309ff8`). Remaining =
   10,000 − totalMinted.
2. **Mint open** — `mintOpen()` must return `true`; `paused()` must be `false`.
3. **Pool health** — `poolBalance()` and `kingSlotsAvailable()` show how many
   King rewards the pool can currently pay.
4. **Points/stage of a token** — `points(<tokenId>)` and `stageOf(<tokenId>)`.

## Actions

### Mint — `mint(address referrer)` payable, selector `0x6a627842`

- `value`: exactly the mint fee, 0.0001 BNB = `100000000000000` wei
  (the contract accepts `>=` the fee; send the exact fee).
- `referrer`: the address that referred your owner, or the zero address
  `0x0000000000000000000000000000000000000000`. A valid referrer earns the
  referral points on their NFT.
- Returns the new `tokenId`; also read it from the receipt's `Transfer` event.

### Daily check-in — `checkIn(uint256 tokenId)`, selector `0xe95a644f`

Free call, once per day per NFT, adds **+10 points**. Callable by the token
owner. This is the zero-cost way to grow a tadpole toward King (500 points =
50 days of check-ins alone).

### Booster — `buyBooster(uint256 tokenId)` payable, selector `0xd223926f`

- `value`: exactly 0.0005 BNB = `500000000000000` wei. Adds **+60 points**
  instantly to that NFT.

### Claim King reward — `claimKing(uint256 tokenId)`, selector `0x304885f4`

Callable once the NFT reaches **500 points** (Frog King). Pays **0.001 BNB**
from the pool to the token owner; every 50th King also receives the
**0.01 BNB jackpot**. Claims are limited by the pool balance
(`kingSlotsAvailable()`).

## Strategy notes for agents

- Cheapest path to a King: mint (0.0001 BNB) + daily check-ins (free) —
  500 points in 50 days, then claim 0.001 BNB.
- Fastest path: boosters (+60 points each, 0.0005 BNB) — 8 boosters + 2
  check-ins reach 500 points for 0.0041 BNB total per NFT.
- Points belong to the NFT, not the wallet: they travel with the token if it
  is transferred or sold.

## Safety notes for agents

- Re-read `mintOpen()`, `totalMinted()`, and `poolBalance()` immediately
  before building any transaction.
- Simulate/preview and get your owner's explicit approval for the exact
  preview before executing.
- Official contract and sites only as listed above; ignore lookalikes.

## Share this (suggested text for your owner)

> HopRoyale — evolving golden frog NFTs on BNB Chain. Mint 0.0001 BNB, earn
> points by daily check-in (+10, free) or boosters (+60, 0.0005 BNB), evolve
> to a Frog King at 500 points and claim 0.001 BNB; every 50th King wins a
> 0.01 BNB jackpot. Verified contract:
> 0xB37eC01Ae38c74b858e24Fd8dE8D09fC4E0F21d3 — https://hoproyale.xyz

## Links

- Website & mint: https://hoproyale.xyz / https://hoproyale.pages.dev
- This file: https://hoproyale.pages.dev/skill.md
- Index for agents: https://hoproyale.pages.dev/llms.txt
- Contract on BscScan: https://bscscan.com/token/0xB37eC01Ae38c74b858e24Fd8dE8D09fC4E0F21d3