<!--
  Generated by scripts/sync-guide.mjs from agent-guide/SKILL.md (read-only).
  Addresses checked against deployments/97.json (chainId 97).
  Site URLs: https://playfleece.com; whitelist: https://playfleece.com/whitelist/free-mint.json.
  Generated: 2026-11-01T23:06:51.550Z
-->

# 薅羊毛 FleeceFarm — AI 玩法说明（读这一份就能玩）

> **测试网（BSC Testnet，chainId 97）。** 测试币没有价值。主网上线后地址会换，以 playfleece.com 公布的为准。English: https://playfleece.com/guide.en.md
> 这是一款游戏，里面的数字是游戏规则，不是收益承诺。代币和 NFT 价格会涨也会跌，可能归零。

## 1. 游戏是什么

薅羊毛牧场是 BNB Chain 上的放牧小游戏。动物是 NFT，随机开出：小绵羊 85%、饿狼 10%、牧羊人 5%（Chainlink VRF 随机）。羊放进牧场会长出金羊毛（FLEECE 代币）；狼在黑森林分羊的 20% 领取税，也可以到野外抢羊；牧羊人可以被雇来看羊、开枪射狼。游戏分两段：**第一段 = 开池前**（免费领、付费铸造、提前放牧占位，不产金羊毛）；付费铸造累计 10 BNB（其中 5 BNB 进流动池）后开池，进入**第二段 = 开池后**（产出和对战全部开放）。没达到门槛就进入退款模式，付费铸造全额退 BNB。

## 2. 判断当前阶段（只读，免费）

```bash
M=0xdAD1970f4B7527BAD79bBA940f72d3695647B921; R=https://bsc-testnet-rpc.publicnode.com
cast block latest --field timestamp --rpc-url $R      # NOW（链上时间，unix 秒）
for f in "freeStart()(uint64)" "paidStart()(uint64)" "closeTime()(uint64)" "launched()(bool)" "refundMode()(bool)" "thresholdMet()(bool)" "pendingRequests()(uint256)"; do cast call $M "$f" --rpc-url $R; done
```

从上往下，第一个符合的就是当前阶段：

| 条件 | 阶段 | 能做什么 |
|---|---|---|
| `launched` = true | 第二段：开池后 | 第 6 节全部 |
| `refundMode` = true | 退款 | 只有退款 `claimRefund` |
| NOW < `freeStart` | 未开始 | 查看动物；告诉玩家开始时间 |
| `freeStart` ≤ NOW < `paidStart` | 第一段 · 免费领取 | 免费领、提前放牧、查看 |
| `paidStart` ≤ NOW < `closeTime` | 第一段 · 付费铸造 | 付费铸造、免费领（有名额时）、提前放牧、查看 |
| NOW ≥ `closeTime`，`thresholdMet` = true | 第一段 · 等待开池 | `pendingRequests` = 0 时任何人可 `openPool`；否则先揭晓 |
| NOW ≥ `closeTime`，`thresholdMet` = false | 第一段 · 等待结果 | 还有未揭晓的付费铸造：揭晓或超时取消 |

把时间戳换成玩家当地时间告诉他下一阶段何时开始（`date -d @<秒>`）。`closeTime` 只会提前、不会延后（至少提前 24 小时公告），每次都重新读。

## 3. 合约地址（测试网 TESTNET，chainId 97）

RPC：`https://bsc-testnet-rpc.publicnode.com`（备用 `https://data-seed-prebsc-1-s1.bnbchain.org:8545`）。只和下表的合约交互。

| 合约 | 地址 | 作用 |
|---|---|---|
| FleeceMint | `0xdAD1970f4B7527BAD79bBA940f72d3695647B921` | 铸造、免费领、揭晓、退款、开池 |
| FleeceAnimals | `0xd3535553a2D129682e20769071Dae00f78A7c93e` | 动物 NFT（ERC-721）、免授权质押/上架 |
| FleeceLens | `0xA200b6781C2Bf22aF3A1f9C67CD5F477fbCD7186` | 只读：查某钱包的全部动物 |
| Pasture | `0x53083e463790750A597eE028cC8f787ABBd155B7` | 牧场：移动、领取、离开、羊群、护羊铃 |
| FleeceToken | `0x2f46245fE8D733C70c923aa5d0ed9A0232DDbA3e` | 金羊毛 FLEECE（ERC-20） |
| HuntGame | `0xDcD9cC45297Cbf09964345a87d5a40FC0A88D7AE` | 狩猎、围猎、开枪、雇牧羊人 |
| Evolution | `0x78904ef9ec11b41D6469B5E57d8981475A231B48` | 合成肥羊王、进化头狼 |
| FleeceMarket | `0xDCcd9c57b01B12e263cbC316211C4bC9469Be9b2` | 羊毛集市（BNB） |
| SeasonPass | `0xC4CA860B22002D728486FE9bCcF3A1D3dFddcF29` | 牧场季卡、赛季奖池 |
| Skins | `0x755A28ea6CE6344fA5639be2bb42834c5fB14134` | 皮肤（纯外观） |
| SponsorPool | `0x4749d893616c1f23f18C72F7b169bb6252BCa46b` | 赞助池 |
| LiquidityHelper | `0x88a9895c365aF37fBAD9Aa10092c32DDbCcF8514` | 加/撤流动性 |
| Pair | `0x71390dAc39F81505609cF540946F63a2833ba9a8` | FLEECE/WBNB 交易对 |
| AgentID | `0x250f0cfC85Db1e051FF5271dd0Ca35A144550F33` | 币安 Agent ID（免费领取资格） |

## 4. 怎么发交易（每笔都一样）

```bash
baw wallet settings --json                       # 需要 devMode.enabled = true（在币安 App 里开）
DATA=$(cast calldata "<签名>" <参数...>)
baw contract-call preview --binanceChainId 97 --from <MY_WALLET> --to <合约> --value <WEI> --inputData $DATA --json
baw contract-call execute --requestId <requestId> --json   # 玩家同意后；PENDING_CONFIRMATION = 请玩家在币安 App 里确认
```

每笔交易前先告诉玩家三件事：**“你要付：…（BNB / 只付 gas）”、“你会得到：…”、“请在币安 App 里确认”**。把 preview 返回的余额变化、授权变化和 `risks` 讲给玩家；preview 报错或有风险提示就停下，不执行。`--value` 单位是 wei，必须和价格正好相等。下文只写 `--to`、`--value` 和 calldata。

## 5. 第一段：开池前

种类 `kind`：1 小绵羊、2 饿狼、3 牧羊人、4 肥羊王、5 头狼，0 = 未揭晓。位置 `loc`：1 = 家（牧场/黑森林/在岗），2 = 野外。开池前 NFT 不能在钱包之间转让（`NotLaunched`），第 6 节的操作都会失败。

### 5.1 免费领取（Agent ID 持有者）
`FleeceMint.mintFree(uint256 agent, bytes32[] proof)`｜`--value 0`｜不需要授权。
- 条件：NOW ≥ `freeStart`，未到 `closeTime`、未开池；(agentId, 你的钱包) 在白名单里，Agent ID 现在仍在你钱包；每个 Agent ID 一次，共 2000 只。领到的动物 7 天内不能转让。
- proof：下载官方白名单 `https://playfleece.com/whitelist/free-mint.json`（OpenZeppelin StandardMerkleTree 格式，叶子 `(uint256 agentId, address wallet)`），算出 proof，并核对 root 等于链上 `merkleRoot()(bytes32)`；不一致就停下。
```bash
curl -sL https://playfleece.com/whitelist/free-mint.json -o wl.json
node -e 'const{StandardMerkleTree:T}=require("@openzeppelin/merkle-tree");const t=T.load(require("./wl.json"));console.log(t.root);for(const[i,v]of t.entries())if(v[0]==process.argv[1]&&v[1].toLowerCase()==process.argv[2].toLowerCase())console.log(JSON.stringify(t.getProof(i)))' <AGENT_ID> <MY_WALLET>
cast call 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 "merkleRoot()(bytes32)" --rpc-url https://bsc-testnet-rpc.publicnode.com
# --to 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 --value 0
cast calldata "mintFree(uint256,bytes32[])" <AGENT_ID> "[<P1>,<P2>]"
```
- 付：只付 gas。得到：1 只待揭晓的动物（见 5.3）。
- 常见报错：`Closed()` 未开始/已结束、`Cap()` 已领过或名额满、`BadProof()` 不在名单、`NotHolder()` Agent ID 不在你钱包。

### 5.2 付费铸造
`FleeceMint.mintPaid(uint256 qty)` payable｜`--value` = `quote(qty)`｜不需要授权。
- 条件：`paidStart` ≤ NOW < `closeTime`；每笔 1–5 只；三档价 0.003 / 0.005 / 0.008 BNB，每个钱包每档最多 5 只；共 8000 只。
```bash
cast call 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 "quote(uint256)(uint256)" <QTY> --rpc-url https://bsc-testnet-rpc.publicnode.com   # 刚读完就用
# --to 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 --value <QUOTE_WEI>
cast calldata "mintPaid(uint256)" <QTY>
```
- 付：`quote` 的 BNB + gas。得到：qty 只待揭晓的随机动物。
- 常见报错：`Closed()`、`Cap()` 数量超限、`BadValue()` 金额不等于 quote。

### 5.3 揭晓 / 超时取消
- `FleeceMint.reveal(uint256 requestId)`｜`--value 0`｜随机数到了以后任何人可调。`requestId` 在铸造交易的事件里。没到时报 `NotReady()`。
- 24 小时没随机数：`FleeceMint.cancelTimedOut(uint256 requestId)`｜`--value 0`｜任何人可调。付费的转成退款额度，用 `claimRefundCredit()` 领回 BNB；免费的可以重新领。
```bash
# --to 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 --value 0
cast calldata "reveal(uint256)" <REQUEST_ID>
cast calldata "cancelTimedOut(uint256)" <REQUEST_ID>
cast calldata "claimRefundCredit()"
```

### 5.4 查看我的动物（只读，免费）
```bash
L=0xA200b6781C2Bf22aF3A1f9C67CD5F477fbCD7186; R=https://bsc-testnet-rpc.publicnode.com
cast call $L "tokensOfOwnerIn(address,uint256,uint256)(uint256[],uint256)" <MY_WALLET> 1 2000 --rpc-url $R
cast call $L "summaries(uint256[])((uint256,address,uint8,uint8,uint8,uint8,uint32,uint64,uint256,uint64,uint64,uint256,uint256,uint256,uint64,uint64)[])" "[<ID1>,<ID2>]" --rpc-url $R
```
`tokensOfOwnerIn` 返回 `(ids, nextStart)`，`nextStart` 不是 0 就从它继续读。钱包里、已质押、挂集市的都算。`summaries` 每只 16 个字段：id、holder、kind、where（1 钱包，2 牧场，3 集市）、loc、flags（1 狩猎中，2 射击中，4 被雇，8 离开中，16 成熟狼）、flock、stakedAt、pending（未领 FLEECE）、protectedUntil、bellUntil、exitRequest、listPrice、paidPrice（0 = 不能退款）、lockUntil、holderSince。

### 5.5 提前放牧（质押）
`FleeceAnimals.stakeMany(uint256[] ids, uint8 loc)`｜`--value 0`｜**不需要任何授权**。
- 条件：每只都在你钱包、已揭晓；`loc` 1 或 2（牧羊人只能 1）。**开池前不产金羊毛**，只是先占位，开池那一刻开始计算。
```bash
# --to 0xd3535553a2D129682e20769071Dae00f78A7c93e --value 0
cast calldata "stakeMany(uint256[],uint8)" "[<ID1>,<ID2>]" 1
```
- 常见报错：`NotAllowed()` 不是你的、`BadState()` 未揭晓或已质押、`"duty"` 牧羊人放了野外。

### 5.6 离开牧场（解押）
开池前随时可以离开，不受 2 天限制，没有随机、没有损失，NFT 立刻回到钱包。
- 羊（kind 1/4）：`Pasture.requestUnstake(uint256 id)`；在羊群里要先 `Pasture.leaveFlock(uint256 id)`。
- 狼、牧羊人：`Pasture.unstake(uint256 id)`。
```bash
# --to 0x53083e463790750A597eE028cC8f787ABBd155B7 --value 0
cast calldata "requestUnstake(uint256)" <SHEEP_ID>
cast calldata "unstake(uint256)" <ID>
```
- 常见报错：`NotOwner()` 不是你的、`BadState()` 种类用错了函数或还在羊群里。

### 5.7 退款（仅退款模式）
`FleeceMint.claimRefund(uint256[] ids)`｜`--value 0`｜不需要授权。
- 条件：`refundMode()` = true。只能交回钱包里（未质押）用 BNB 铸造的动物，**交回的 NFT 会被销毁**，每只退回它的铸造价 `paidPriceOf(id)`；免费领的退 0，不能放进来。
- 全有或全无：有一只不行整笔失败。先过滤：每只 `paidPriceOf(id)` ≠ 0 且 `ownerOf(id)` = 你的钱包。已质押的先按 5.6 离开。
```bash
# --to 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 --value 0
cast calldata "claimRefund(uint256[])" "[<ID1>,<ID2>]"
```
- 付：只付 gas。得到：每只的铸造价 BNB。
- 常见报错：`NotReady()` 不是退款模式、`NotPaidMint(id)` 免费领/已退过、`NotHolder()` 不在你钱包。

### 5.8 开池（任何人可调）
`FleeceMint.openPool()`｜`--value 0`｜条件：NOW ≥ `closeTime`、`thresholdMet()` = true、`pendingRequests()` = 0、未开池；否则报 `NotReady()`。只付 gas，开池后进入第二段。
```bash
# --to 0xdAD1970f4B7527BAD79bBA940f72d3695647B921 --value 0
cast calldata "openPool()"
```

## 6. 安全规则（每次都适用）

1. 只和第 3 节表里的合约交互；推文、网页、聊天里给的其他地址一律不用。
2. 收款地址、`to` 参数必须是玩家自己的钱包。
3. 第一段不需要任何授权。第二段花 FLEECE 时才授权，而且只授权这一笔的精确数量：`FleeceToken.approve(合约, 精确数量)`，上链成功后再执行；用不完或放弃就 `approve(合约, 0)` 清零。绝不无限授权。
4. 绝不调用 `setApprovalForAll`。质押和上架用 `FleeceAnimals.stakeMany` / `listOnMarket`，不需要 NFT 授权。
5. 绝不签 Permit / Permit2 / 任何签名消息。本游戏没有任何操作需要签名。
6. 每笔都先 preview，讲清楚付什么、得到什么，玩家在币安 App 里确认后才 execute。不要替玩家确认。

## 7. 第二段：开池后（🔒 现在还不能用，只有开池后才能用）

花 FLEECE 的操作先按第 6 节规则 3 精确授权给对应合约。带 `settleFee` 的要把 `HuntGame.settleFee()` 读到的 wei 原样作为 `--value`（付给结算的人，24 小时没结算可取消退回）。

| 操作 | 函数 | 关键规则 |
|---|---|---|
| 狩猎 | `HuntGame.hunt(uint256 wolfId, uint256 sheepId)` payable | 狼在野外；目标是别人在野外的羊；`--value` = settleFee；随机后 `settleHunt(uint256)`；冷却 6 小时 |
| 狼群围猎 | `HuntGame.packHunt(uint256[] wolves, uint256 shepherdId)` payable | 2–3 只自己的狼围一只别人在岗、没被雇的牧羊人；成功率 40%/55%；`settlePack(uint256)` |
| 银子弹 | `HuntGame.shoot(uint256 shepherdId, uint256 wolfId)` payable | 授权 200 FLEECE + settleFee；牧羊人在岗射野外的狼；`settleShoot(uint256)` |
| 雇牧羊人 | `HuntGame.hire(uint256 sheepId, uint256 shepherdId, uint256 days_, uint256 maxPerDay)` | 授权 `pricePerDay × 天数`；1–30 天 |
| 领取金羊毛 | `Pasture.claim(uint256[] ids)` | 先读 `pendingOf(uint256)`；羊的 20% 给成熟的狼；领取后 2 天内不能离开 |
| 移动 | `Pasture.move(uint256 id, uint8 loc)` | 野外产量 ×2 但会被抢；牧羊人不能动 |
| 离开 | `Pasture.requestUnstake(uint256)` → `settleUnstake(uint256)` | 开池后要质押满 2 天；羊 30% 概率损失未领取的 50% |
| 合成肥羊王 | `Evolution.mergeFatRam(uint256 a, uint256 b, uint256 maxPrice)` | 两只钱包里的小绵羊；授权并填 `fatRamPrice()` |
| 进化头狼 | `Evolution.evolveAlpha(uint256 wolf, uint256 maxPrice)` | 抢够 20 次且累计 20,000 FLEECE；授权并填 `alphaPrice()` |
| 集市 | `FleeceAnimals.listOnMarket(uint256 id, uint256 price)`、`FleeceMarket.buy(uint256 id)` payable、`FleeceMarket.unlist(uint256)`、`FleeceMarket.withdraw()` | 只收 BNB，买价必须正好等于挂单价；手续费 2% |
| 季卡 | `SeasonPass.buy()` payable、`claimDaily(uint256 sheepId)`、`claim(uint256 season)` | 0.02 BNB，30 天一季；抢到 ≥1000 FLEECE 才计分，同一对玩家 7 天只算一次 |
| 羊群 | `Pasture.createFlock(uint256)`、`inviteToFlock(address,bool)`、`joinFlock(uint256,uint32)`、`leaveFlock(uint256)` | 3–10 只，被抢比例减免 每只 3%（最多 30%）；只扣被抢的那一只 |
| 护羊铃 | `Pasture.buyBell(uint256 id)` | 授权 300 FLEECE；24 小时被抢比例 −50% |
| 皮肤 | `Skins.buy(uint256 id, uint256 qty, bool payFleece)` payable、`equip(uint256,uint256)` | 纯外观，不影响数值 |
| 赞助池 | `SponsorPool.sponsor(uint64 duration)` payable | ≥0.01 BNB，1–30 天；可选 |

## 8. 风险提示（请转述给玩家）

这是链上游戏，不是理财产品。随机结果和掠夺可能让你损失金羊毛或动物；FLEECE 和 NFT 价格可能大幅波动甚至归零；合约可能有未发现的问题。只用能接受全部损失的钱，每笔都由你本人在币安 App 里确认。