// PROTOCOL NOTES / FLAP DATA
Flap 分红如何查询和领取
Dividend Claim 是一个独立工具，直接使用 Flap 的 claimable API 获取 BNB Chain 分红记录，并复用 Flap TaxHelper 构造领取交易。
当前支持范围
当前版本专注 BNB Chain 主网和 Flap API 已收录的可领取记录。
| 范围 | 当前能力 | 处理方式 |
|---|---|---|
| 网络 | BNB Chain 主网 | 链 ID 56；所有写操作要求连接钱包位于该网络。 |
| 数据 | Flap claimable API | 列表、金额、Dividend 地址、奖励资产和 USD 估值均以 Flap 返回为准。 |
| 领取 | Flap TaxHelper | 单项和批量统一调用 batchDistributeDividend，并由服务端自动规划交易。 |
| 多钱包 | 最多 100 个地址 | 查询允许部分钱包失败；成功钱包的记录仍会返回。 |
数据和交易流程
项目不再使用 Moralis 发现历史代币，也不再执行 Portal、VaultPortal 或 Dividend 前置绑定扫描。
- 01
查询 Flap
分页读取每个目标钱包的 claimable 数据，校验字段格式并去重。
- 02
展示记录
使用 Flap 的可领取金额和 real_value 排序展示；缺少精度时显示奖励地址和原始整数。
- 03
准备交易
服务端重新匹配 Flap 数据，将 Dividend 和钱包分组后编码 TaxHelper 调用，并附带服务费。
- 04
验证结果
等待交易确认，再通过 Dividend 事件和强制刷新的 Flap 数据判断每项是否成功。
费用、安全与依赖
Dividend Claim 不导入或保存私钥，也不请求 ERC-20 授权。每项领取收取固定 0.00001 BNB 服务费，网络 Gas 另计。Flap API 不可用时会明确失败，不回退到历史扫描。
本工具为独立第三方产品，与 Flap 没有官方隶属关系。签名前请核对钱包显示的目标合约、金额和交易数据。
常见问题
以下答案描述当前版本的实际能力和限制。
01可以同时查询多个钱包吗？
可以。地址列表模式最多接受 100 个去重后的有效 BNB Chain 地址，查询允许部分钱包失败。
02连接的钱包可以替其他地址领取吗？
可以。TaxHelper 按 API 返回的 Dividend 和目标钱包执行分发，奖励发送给目标钱包；连接钱包负责签名、Gas 和服务费。
03为什么不再扫描历史代币和合约绑定？
当前版本明确选择信任 Flap 的索引结果，以显著缩短查询时间并与 Flap 页面保持一致。Flap 未收录的记录不会由其他数据源补齐。
04全部领取会分成几笔交易？
服务端根据领取数量、calldata 大小、Gas 估算和完整模拟自动分批，不会按固定数量静默截断。
05Flap API 不可用时怎么办？
页面会明确提示失败并要求稍后重试，不会回退到 Moralis 或全链扫描。
06如何确认领取成功？
页面会等待 BNB Chain 确认，并检查 Dividend 分发事件或刷新后可领取金额是否下降。