白名单根节点
推荐树从白名单地址开始,这些地址是被批准的 root。
永久绑定
用户只能绑定一次。绑定后,parent 和 initial inviter 会固定。
1% 交易奖励
用户已绑定时,买入和卖出的推荐奖励给该用户的 initial inviter。
2% 借贷奖励
用户已绑定时,borrow 和 borrowMore 奖励给该用户的 direct parent。
核心逻辑
推荐系统有两条不同的奖励路径:
这个区别非常重要。initial inviter 和 parent 在直接邀请时可以是同一个地址,但在多层推荐树中经常不是同一个地址。
手续费拆分总结
交易手续费
V5 每次买入和卖出都有总计 1.25% 的交易手续费。
当交易者已绑定时,1.00% 的邀请奖励进入交易者的 initial inviter。当交易者未绑定时,没有可奖励的邀请人,因此完整 1.25% 进入平台侧。
借贷手续费
V5 每次借款和继续借款都有总计 3.00% 的借贷手续费,按借款价值计算。
2.00% 的 parent 奖励是总 3.00% 借贷手续费的一部分。它是借款价值的 2.00%,不是 3.00% 手续费中的 2.00%。
推荐角色
白名单地址
白名单地址非常重要,因为它们创建推荐树的根节点。 当平台 owner 把一个地址加入白名单时:1
该地址成为被批准的推荐根节点
白名单地址是可以启动有效推荐树的根节点。
2
该地址被视为已经绑定
推荐系统会把白名单地址视为合格地址,不需要 parent。
3
该地址成为自己的 initial inviter
这个 root 会作为其下方用户继承的 initial inviter。
4
用户可以直接绑定到 root
普通用户可以绑定到白名单 root 地址。
5
下级用户继承同一个 initial inviter
该 root 下方的非白名单用户都会继承该 root 作为 initial inviter。
绑定规则
应用通常让用户使用推荐码,而不是直接粘贴钱包地址。前端会把推荐码解析为邀请人钱包,检查该邀请人是否有效,然后调用链上的
bind(inviter) 函数。
推荐链如何确定
当用户A 绑定到邀请人 B 时:
直接邀请示例
设置:
如果 Alice 买入 1 BNB 的代币:
如果 Alice 借出 1 BNB 价值:
在直接邀请中,parent 和 initial inviter 是同一个地址,所以同一个钱包会接收两种奖励。
两层推荐示例
设置:
如果 Bob 买入或卖出,1.00% 的交易奖励进入 W1,因为 W1 是 Bob 的 initial inviter。
如果 Bob 借款或继续借款,2.00% 的借贷奖励进入 Alice,因为 Alice 是 Bob 的 direct parent。
这是 V5 的关键规则:交易奖励跟随 initial inviter,借贷奖励跟随 direct parent。
多层推荐示例
设置:
Diana 的借贷活动:
多个白名单根节点
不同白名单地址会形成彼此独立的推荐树。
如果 Charlie 交易,1.00% 的交易奖励进入
W1。如果 Diana 交易,1.00% 的交易奖励进入 W2。
推荐树不会合并。用户一旦绑定到某个白名单根节点下面,该用户的分支就会永久属于这个根节点。
未绑定用户示例
如果 Eve 从未绑定邀请人,她就是未绑定用户。 如果 Eve 买入 1 BNB 的代币:
如果 Eve 借出 1 BNB 价值:
用户仍然可以正常使用协议。区别只是手续费路由:没有有效推荐绑定时,就没有 initial inviter 或 parent 可以接收奖励。
奖励路由表
合约函数
推荐合约暴露了应用、集成和协议手续费路由需要使用的推荐状态:前端推荐码流程
网站使用推荐码和推荐链接提升用户体验,但链上的绑定仍然是钱包地址之间的绑定。1
用户打开推荐链接或粘贴推荐码
前端从 URL 或输入框接收推荐码。
2
前端提取推荐码
App 解析推荐码并准备绑定流程。
3
API 解析邀请人钱包
推荐码会解析为链上绑定使用的邀请人地址。
4
前端检查邀请人资格
邀请人必须是白名单地址,或已经完成绑定。
5
用户确认绑定
绑定是一次性且永久的,因此用户必须明确确认。
6
前端调用 referral.bind(inviterAddress)
链上推荐合约记录绑定关系。
7
后端镜像记录交易
后端镜像用于仪表盘、个人页面和推荐索引视图。
重要集成说明
- 显示“应用推荐码”之前,必须检查用户是否已经绑定。
- 绑定之前,必须检查邀请人是否已经绑定或是否是白名单地址。
- 用户绑定后,不要提供更换邀请人的操作。
- 不要只依靠前端假设计算推荐奖励。应读取推荐合约和协议手续费数据。
- 不要混淆 1.00% 的交易奖励和 2.00% 的借贷奖励。它们使用不同的接收方。

