CONTRACT GUIDE
FaucetVault 合约部署说明
当前项目不再依赖本地数据库和后台接口。你只需要部署 cBTC 水龙头合约，再让前端直连 BSC 钱包和合约即可。
部署顺序
- 确认 cBTC 合约地址：0x18d0e455b3491e09210292d3953157a4bf104444
- 确认 FAIR 公开入口：买入路由 `0x3f8e213e5aecd400c868765f1559968db2c4f741`，公开 Vault `0x0375f966b518713fc4ab89c3abc6ba063376bc4a`，FAIR 代币 `0xcac6d8ec6d05fbcb7065edcfb7897a1633993876`。
- 部署 `contracts/FaucetVault.sol`，部署后得到新的资金池地址。
- 把前端里的 `faucetVaultAddress` 替换成新部署地址。
- 生产模式建议拆成三条链路：`5U 买入 -> FAIR Router`，`质押 -> FAIR Vault`，`免费 1 cBTC -> FaucetVault`；推荐关系与 FAIR 共用同一套链上绑定。
合约职责
- 接收 cBTC 授权和注资，成为新的资金池地址。
- 记录推荐人名称、累计注资、累计被领取和可用余额。
- 执行 5U 首单自动到账 `8.88 cBTC` 奖励。
- 执行新的质押资格记录，以及手动领取 `6.66 FAIR` 等值 `cBTC`。
- 只统计合约生效后的有效 FAIR 行为：`5U` 整数 `USDT` 买入、从零地址累计挖出的 `50 FAIR`、以及大于 `50 FAIR` 的有效质押。
- 解除质押后重新质押，必须再次消耗新的 `50 FAIR` 挖矿额度，不能重复使用旧额度。
- 向前端暴露推荐人列表，前端自己排序生成前 20 排行榜。
前端配置项
tokenContractAddress = 0x18d0e455b3491e09210292d3953157a4bf104444
faucetVaultAddress = 部署后的 FaucetVault 合约地址
fairEntryRouterAddress = 0x3f8e213e5aecd400c868765f1559968db2c4f741
fairPublicVaultAddress = 0x0375f966b518713fc4ab89c3abc6ba063376bc4a
fairTokenAddress = 0xcac6d8ec6d05fbcb7065edcfb7897a1633993876
chainId = 56
rpcUrl = https://bsc-dataseed.binance.org/
当前状态
现在本地页面已经切成前端直连合约模式。如果 `FaucetVault` 还没真正部署，首页会自动进入演示读取模式，但按钮结构和交互流已经按链上方式准备好了。