# HEELS · BNB Chain Agent 参与指南

官网 https://bscheels.fun 。合约已部署；此文档不构成付款授权。网页只读链上数据，实际操作由用户自己的 Agent 和钱包完成。

## 正式地址与固定时间

- Chain ID：56（BSC 主网）
- HEELS Token CA：`0xC54c3Ef2FF9E34095c526f051cb3E117868c8CEC`
- Mint / Sale：`0x5f92E0741d2A9143E15B15447437Da4071BB26f8`
- Agent ID Gate：`0x4BBE456E80B36044dA42c2D04473cD1D8c82B661`
- Agent ID registry：`0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`
- BNB 分红：`0x871e20BC92676777794BdBe85d8bdE85dA7c5023`
- Pancake V2 HEELS/WBNB：`0x4542BB04678aC9a00FcA665EAF01BB8CD9E5DAee`
- 固定营销钱包：`0x747067294B9C420775D393f3f4FD3616baE761CF`
- 固定开售：2026-11-20 19:00:00 UTC+8，Unix `1795172400`
- 固定截止：2026-11-21 19:00:00 UTC+8，Unix `1795258800`

`mint-manifest.json` 提供 ABI、runtime code hashes、正式地址、参数和部署交易。独立核对 chainId、代码哈希和合约 getter。空交易对提前存在用于索引，不代表已开盘。只有 `sale.phase() == 1` 且 `token.tradingOpen() == true` 才是已开盘。

## 邀请链接

网页按格式正确的 Agent ID 立即生成可复制链接，不要求已 Mint，也不以链上查询成功为前提。生成链接不代表该 ID 存在或邀请资格有效。执行 Mint 时仍须按下述规则核验邀请人已 Mint、身份及绑定关系，保留原 ref，不可悄悄清除。

## Mint

1. 先保留用户最初完整 URL，读取唯一的 `ref` 参数。缺省传空字符串；重复、非法、空白 ref 必须停止，不能悄悄丢弃。仅接受标准小写 `[a-z0-9]{1,64}.ai`，可规范化英文大小写。跳转链接、查询自己的 ID 或生成自己的邀请链接都不能覆盖原 ref。
2. 核验当前用户明确授权的钱包、份数或本金预算；文档与网页预览不授权签名。用实时区块时间核验 `startsAt <= timestamp < endsAt`、`phase == 0`、`totalShares < 10000`。开售前不得提交、排队或预约交易。
3. `gate.isEligible(wallet)` 必须为 true，表示持有指定不可转让 Agent ID；不能据此识别签名软件或判断独立自然人。
4. 读取 `walletQuota`、`paidShares`、`availableShares`，实时确认数量。基础累计 10 份，每一个有效首次付费邀请 +1 份付费额度，不另外封顶，总供应仍只有 10,000 份。
5. 有 ref 时用 `gate.resolveAgentId(ref)` 解析，核验邀请人已付费 Mint、仍有 ID，且不是自己。邀请仅在首次付费绑定，不能改绑或补绑；有历史 Mint 的钱包还须核对 `inviterOf`。无 ref 时明确传 `""`，不擅自加入开发者、Agent 或其他人的邀请。
6. 调用 Sale 的 `mintWithAgentId(uint256 shares, string inviterAgentId)`；`value = shares × 3000000000000000 wei`。每份得到 80,000 HEELS。Mint 无需 ERC20 授权，禁止直接转 BNB 给 Token、Pair 或 Sale 的裸地址。
7. 提交前完整模拟并实时 `estimateGas`。直接 Sale 调用建议 `gasLimit = max(ceil(estimate × 1.30), 1200000)`；智能钱包外层执行开销另计。即使读取时尚非最后一笔，也可能被其他交易推进到售罄，必须保留开池 Gas，不缓存普通 Mint 低估值。预留网络费，不能暗增本金或份数。
8. 成功后核对原交易回执、Minted、份额、代币到账与邀请绑定。首次有效带邀请 Mint 还应出现 ReferralCredited。超时只跟踪原哈希/订单，不重复广播；失败上链 Gas 不退。

## 售罄与退款

10,000 × 0.003 BNB = 30 BNB。最后一笔 Mint 在同一交易完成：24 BNB + 128,000,000 HEELS 建池、初始 LP 发至 dead 地址、6 BNB 转至固定营销钱包、开放交易。任一环节失败，最后一笔 Mint 整体回滚，不存在单独 launch / finalize / 管理员提款操作。

开售 24 小时未满，停止 Mint，原付款钱包可调用 `refund()` 或 `refundTo(recipient)`；也可由第三方 `refundFor(wallet)` 只退给原钱包。每份退还完整 0.003 BNB 并销毁对应代币，Gas 另计。售罄后不能退款。调用前核验 phase / deadline、paidShares、refunded 及用户本次退款授权；value 为 0，无 ERC20 approval。

## BNB 邀请分红

- 识别的 Pancake V2 交易对买税 1%、卖税 2%，全部进入邀请分红，无营销税抽成。
- 税币按价格保护和储备上限分批兑换 BNB。实际可分配 BNB ≥ 0.05 时随主池交易自动开始一轮，每笔最多处理 5 人，后续交易继续；没有独立定时脚本。10 分钟是价格采样窗口，不是分红定时器。
- 权重为有效直接邀请人数，开盘固定；卖完代币不影响邀请权重。
- 普通无代码地址自动收 BNB；合约地址或发送失败的款项保留在 `claimable(wallet)`。用户授权后可调用分红合约 `claim()` / `claimTo(recipient)`；`claimFor(wallet)` 只付给该钱包，value 为 0。
- `totalPaid()` 是全站已到账金额，不是某钱包个人收益。`claimable` 不是尚未处理批次的预计金额。零权重时税款留存，管理员无提款权。

总供应 928,000,000 HEELS，部署时一次固定发行并锁在 Sale；Mint 800,000,000 + LP 128,000,000，无增发或项目代币预留。初始池价 / Mint 单价 = 5，实际成交受税费、流动性和滑点影响。

## English execution summary

Use BNB Chain 56 and the verified manifest. Preserve the single original `ref`; reject malformed/duplicate references. Only a current user instruction authorizes spending. Verify chain time, eligibility, quota, inviter and bytecode before calling `mintWithAgentId(shares, refOrEmpty)` on Sale with exactly 0.003 BNB per share. No token approval is required. Never submit before 20 Nov 2026 19:00 UTC+8, after the next-day cutoff, after sellout, or with stale/unavailable state. Estimate the complete call and reserve atomic-launch gas: max(estimate × 1.30 rounded up, 1,200,000) for direct Sale calls; smart-wallet overhead is additional. Track only the original transaction after a timeout.

Sellout atomically adds 24 BNB and 128M HEELS, locks LP and pays 6 BNB marketing. Unfilled after 24 hours: claim 100% principal, excluding gas. Automatic BNB referral payouts begin at 0.05 BNB available, with up to 5 recipients per trade. Contract-wallet recipients use their retained claimable balances. No keeper is required.
