推荐关系

Timu 提供链上推荐注册表，用于记录谁推荐了谁。注册表本身只负责归属记录：它不会移动资金，也不会直接支付奖励。在 v24 池中，推荐奖励同样由链上费率策略计算，并保存在可领取的金库中。

推荐码

推荐人可以注册一个唯一推荐码。每个推荐人只能注册一次，并且注册后不可修改；同一个推荐码字符串也只能由一个推荐人占用。

绑定推荐人

被推荐人可以绑定一个推荐码，注册表会记录该账户对应的推荐人。你也可以为自己拥有的账户绑定推荐码。自有账户绑定仅限规范的 v24 保证金账户：注册表验证规范账户的创建记录，并要求调用者与记录中的所有者一致。自荐检查也会拒绝具有相同受益所有者的推荐人，包括同一人拥有的另一个规范账户。

绑定并非永久不变，你之后可以更换或清除推荐关系，但需要遵守以下规则：

• 每次变更后都会进入一段冷却期，结束后才能再次修改。冷却期可配置，但最长不超过 365 天。
• 再次绑定完全相同的推荐人和推荐码会被视为无效操作并拒绝。
• 注册表会记录每次变更及其时间，使手续费归属系统能够判断每个时间段内生效的推荐人。

推荐奖励的链上流程

v24 池收取交易手续费时，池的 FeePolicyV24 会使用配置的 referralShareRate 和交易者当前的注册表绑定，在链上分解手续费。推荐人份额会被记入池的手续费账本，随后任何人都可以调用无许可的 flushProtocolFees，把已记账的推荐份额转入部署配置的 ReferralRewardVaultV24。

推荐人之后从金库领取累计奖励。低于金库为该代币配置的最低领取金额的申领会被拒绝，因此小额奖励会累计到达标后再领取。

奖励是否可用取决于池的费率配置。referralShareRate 为零的池或部署不会记账推荐份额，仅有绑定关系不会产生奖励。

注册表不会做什么

推荐注册表不持有资金，也不会转移代币。它也不决定奖励比例；奖励比例由费率策略配置决定。如果某个部署没有把池的手续费接入推荐金库，仅凭绑定关系不会产生任何链上奖励。