# Reishi Hunt · 灵子狩猎场

> 《死神》主题的军衔 NFT 狩猎场，三条合约跑在 BSC 上。没有按钮流程 —— 人复制一句提示词交给 AI，AI 读链、算账、报价、发交易、复核。
>
> 这份文件是给 AI 的索引。完整规则见 https://reishi-hunt.pages.dev/llms-full.txt，Agent 操作契约见 https://reishi-hunt.pages.dev/AGENTS.md。

## 一句话说清玩法

铸造 NFT（每势力首枚免费）→ 升阶或合成提高「当量」→ 质押进狩猎场 → 日产出 7,200 BLC 按当量分给**在线当量最高的那个势力**，另外两家这段时间为 0 → claim 领取（抽 1%）。

## 链上地址

```
链          BSC Testnet（chainId 97）
RPC         https://bsc-testnet-rpc.publicnode.com
BLC         0xC5AEade4A0Eb1C13A6e5299f1194820Dd3556F11
军衔 NFT     0x0347cce19d69847b841076c83087cFDF1412A322
狩猎场       0x61d0432ccaceDbd6B8f8b56eB05eBA65cbba10b9
单价        0.0013328 BNB（每个势力首枚免费，之后每枚这个价，单钱包每势力上限 8 枚）
```

## 必须先读的三条

**当量决定收益，军衔不决定收益。**

```
1. 每枚 NFT 的「当量」= nft.weightOf(id) = 它累计消耗的 BLC。铸造自带 5 BLC；升阶烧 10 / 50 / 280 全额累加；合成时被吞的当量原样转给新 NFT，守恒。
2. 日产出固定 7,200 BLC，按在线当量占比分配。不是按军衔，没有「效率系数」。
3. 同一枚 NFT 的当量成长：刚铸造 5 → 升一档 15 → 升两档 65 → 升三档 345。
4. 回本天数 = 全网总当量 ÷ 7,200。任何一档都一样，不存在「贵的档更划算」。
5. 只有领先势力拿产出：在线当量最高的势力独吞 7,200，另外两家这段时间为 0、pending 冻结。平局归编号小的（死神 > 虚 > 灭却师）。
```

**合成配方三势力不同。** 用 hunt.fuseRecipeOf(faction, tier) 读，不要凭印象：

```
  · 死神　 下级→中级 2 枚下级｜中级→上级 3 枚中级｜上级→顶级 4 枚上级（折合 2 / 6 / 24 枚下级）
  · 虚　　 下级→中级 3 枚下级｜中级→上级 3 枚下级 + 2 枚中级｜上级→顶级 1 枚中级 + 2 枚上级（折合 3 / 9 / 21 枚下级）
  · 灭却师 下级→中级 5 枚下级｜中级→上级 4 枚中级｜上级→顶级 2 枚上级（折合 5 / 20 / 40 枚下级）
```

**税制**：结算产出 1% ｜ 烧币升阶 0.5% ｜ 合成 0.5% ｜ BLC 买卖各 0.5%（全部 constant，部署后不可改，全部进 treasury）

## 三种接入方式

1. **网页复制提示词**（最省事）— https://reishi-hunt.pages.dev 与 https://reishi-hunt.pages.dev/hunt，每张卡都带真实地址和边界条件，复制即可执行。
2. **MCP Server**（Claude Code / Cursor 等）— 见 AGENTS.md 的「MCP 接入」，16 个工具覆盖读链、报价、下单、复盘。
3. **直接打 RPC**（任何能发 HTTP 的 agent）— 全部是标准 eth_call / eth_sendRawTransaction，ABI 在 https://reishi-hunt.pages.dev/AGENTS.md。

## 关键合约方法

```
stake(uint256[] tokenIds)
unstake(uint256[] tokenIds)
claim() → (uint256 net)
upgrade(uint256 tokenId) → (uint8 newTier)
fuse(uint256[] tokenIds) → (uint256 newTokenId)
mint(uint8 faction, uint256 count)
```

读方法：

```
tokensOfOwner(address who) → (uint256[])
tierOf(uint256) → (uint8)
factionOf(uint256) → (uint8)
weightOf(uint256 tokenId) → (uint256)
spentOf(uint256) → (uint256)
staked(uint256) → (bool)
quoteMint(address who, uint8 faction, uint256 count) → (uint256 payableWei, uint256 freeCount, uint256 remaining)
factionMinted(uint8) → (uint256)
factionCap() → (uint256)
maxSupply() → (uint256)
totalSupply() → (uint256)
price() → (uint256)
farmStats() → (uint256 _totalWeight, uint256 _rewardPerDay, uint256 _lastUpdate, bool _miningOpen, uint256 _minted, uint256 _maxSupply)
position(address user) → (uint256 weight, uint256 pending, uint256 claimed, uint256 stakedCount)
pendingOf(address user) → (uint256)
factionBoard() → (uint256[3] weights, uint256[3] mined, uint256 total, uint8 leader, uint256 since, bool open)
miningGate() → (bool unlocked, bool canOpen, uint256 leftToOpen)
miningOpen() → (bool)
totalWeight() → (uint256)
upgradeCost(uint8 tier) → (uint256)
fuseRecipeOf(uint8 faction, uint8 fromTier) → (uint256 c0, uint256 c1, uint256 c2, uint256 c3)
dailyYieldOf(uint256 tokenId) → (uint256)
stakedTokensOf(address user) → (uint256[])
factionWeightsOf(address user) → (uint256[3])
previewFuse(uint256[] tokenIds) → (uint8 faction, uint8 targetTier, uint256 fee, bool ok)
```

## 动作卡（首页）

- [铸造 2 个队士](https://reishi-hunt.pages.dev/) — 发售中 · 花 BNB
- [盘点我的持有](https://reishi-hunt.pages.dev/) — 随时 · 只读 · 零风险
- [评估升阶 #1042](https://reishi-hunt.pages.dev/) — 动钱之前 · 只读
- [升阶 #1042](https://reishi-hunt.pages.dev/) — 队士 → 席官 · 烧 10 BLC
- [合成 #1044 + #1045](https://reishi-hunt.pages.dev/) — 2 队士 → 1 席官 · 手续费 0.05 BLC
- [预算内批量升阶（100 BLC）](https://reishi-hunt.pages.dev/) — 有闲钱时 · 分批执行
- [交易失败排查](https://reishi-hunt.pages.dev/) — 报错时 · 只读诊断

## 动作卡（狩猎页）

- [战斗体检](https://reishi-hunt.pages.dev/hunt) — 随时 · 只看不写 · 零风险
- [出战 #1305](https://reishi-hunt.pages.dev/hunt) — 狩猎开放后 · 锁定 NFT
- [中止狩猎 #1043](https://reishi-hunt.pages.dev/hunt) — 出手前 · 解锁 NFT
- [结算灵子](https://reishi-hunt.pages.dev/hunt) — 待结算 > 1 BLC 时
- [出售前检查 #1107](https://reishi-hunt.pages.dev/hunt) — 挂单前 · 只读 + 可能解锁
- [全网战力变了怎么办](https://reishi-hunt.pages.dev/hunt) — 每次结算前 · 只读推演
- [每日战斗日报](https://reishi-hunt.pages.dev/hunt) — 每天固定时间 · 只读
- [交易失败排查](https://reishi-hunt.pages.dev/hunt) — 报错时 · 只读诊断

## 常见错误码

```
AlreadyOpen · AlreadyStaked · BadCount · BadFaction · BadFuseCount · EmptyBatch · InvalidTier · MiningClosed · MixedFactions · NotAuthorized · NotFarm · NotOwner · NotReady · NotStaked · NotTokenOwner · SaleClosed · SoldOut · TierMaxed · TokenInBattle · TokenLocked · WalletCapReached · WrongPrice · ZeroAddress
```

对照表见 https://reishi-hunt.pages.dev/AGENTS.md#错误码。

## Optional

- [完整手册](https://reishi-hunt.pages.dev/llms-full.txt)：全部规则、两段系统提示词、15 张动作卡全文
- [Agent 契约](https://reishi-hunt.pages.dev/AGENTS.md)：MCP 配置、方法签名、边界与禁止事项
- [白皮书](https://reishi-hunt.pages.dev/): 世界观与代币经济