跳转到主要内容
LFG.RICH V5 使用链上推荐合约把钱包绑定到推荐树中。协议会根据这个推荐状态决定交易手续费和借贷手续费中的推荐奖励应该发送给谁。

白名单根节点

推荐树从白名单地址开始,这些地址是被批准的 root。

永久绑定

用户只能绑定一次。绑定后,parent 和 initial inviter 会固定。

1% 交易奖励

用户已绑定时,买入和卖出的推荐奖励给该用户的 initial inviter。

2% 借贷奖励

用户已绑定时,borrow 和 borrowMore 奖励给该用户的 direct parent。
推荐绑定对于正常使用协议是可选的。钱包不绑定推荐人也可以创建代币、买入、卖出、借款、还款和使用应用。绑定只用于让钱包加入推荐树,并让该钱包的活动进入推荐奖励路由。
推荐绑定是永久的。钱包一旦绑定到某个邀请人,就不能解绑、不能更换邀请人,也不能移动到另一棵推荐树。

核心逻辑

推荐系统有两条不同的奖励路径: 这个区别非常重要。initial inviterparent 在直接邀请时可以是同一个地址,但在多层推荐树中经常不是同一个地址。

手续费拆分总结

交易手续费

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 时:
然后 initial inviter 按以下规则确定:
这意味着即使推荐树有很多层,initial inviter 也始终是该分支最顶部的白名单根地址。

直接邀请示例

设置:
推荐树:
Alice 的推荐状态: 如果 Alice 买入 1 BNB 的代币: 如果 Alice 借出 1 BNB 价值: 在直接邀请中,parent 和 initial inviter 是同一个地址,所以同一个钱包会接收两种奖励。

两层推荐示例

设置:
推荐树:
Bob 的推荐状态: 如果 Bob 买入或卖出,1.00% 的交易奖励进入 W1,因为 W1 是 Bob 的 initial inviter。 如果 Bob 借款或继续借款,2.00% 的借贷奖励进入 Alice,因为 Alice 是 Bob 的 direct parent。
这是 V5 的关键规则:交易奖励跟随 initial inviter,借贷奖励跟随 direct parent。

多层推荐示例

设置:
推荐树:
Diana 的交易活动: 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% 的借贷奖励。它们使用不同的接收方。