跳到主要内容

推荐系统概述 (Referral System)

AXBlade 推荐系统支持推荐码注册、绑定、返佣查询和链上领取功能。通过推荐系统,用户可以邀请新用户并获得交易返佣奖励。

功能特性

  • 推荐码创建: 用户可创建专属推荐码
  • 推荐绑定: 新用户可绑定推荐人的推荐码
  • 返佣计算: 根据被推荐人的交易量自动计算返佣
  • 链上领取: 通过智能合约安全领取返佣

合约地址 (Arbitrum Sepolia Testnet)

合约地址说明
USDT0x572E474C3Cf364D085760784F938A1Aa397a8B9b测试 USDT (6 decimals)
AXBladeVault0xFDe43f8e6e082975d246844DEF4fE8E704403d43充值/提现合约
ReferralStorage0x984BC1C4Aa3995F9B78BA54372a10d3088C249D5推荐码存储合约
ReferralRebate0xaF486e11c824389E4Ab3ced7608ac3Bd43c176B8返佣分发合约

Chain ID: 421614 RPC URL: https://sepolia-rollup.arbitrum.io/rpc Explorer: https://sepolia.arbiscan.io

层级系统

层级名称总返佣交易者折扣推广者奖励
0Bronze10%5%5%
1Silver12%5%7%
2Gold15%5%10%
3Platinum18%6%12%
4Diamond20%6%14%

API 接口概览

功能方法路径认证
获取用户返佣信息GET/referral/on-chain/user-rebate/:address
获取推荐关系GET/referral/on-chain/referral-info/:address
获取已领取金额GET/referral/on-chain/claimed/:address
创建推荐码POST/referral/codes
绑定推荐码POST/referral/bind
推荐仪表板GET/referral/dashboard
获取领取签名POST/referral/on-chain/claim-signature

流程图

推荐绑定流程

┌──────────┐     ┌──────────┐     ┌──────────┐
│ 推荐人 │────▶│ 创建推荐码 │────▶│ 分享链接 │
│ │ │ API │ │ │
└──────────┘ └──────────┘ └──────────┘


┌──────────┐ ┌──────────┐ ┌──────────┐
│ 被推荐人 │────▶│ 绑定推荐码 │────▶│ 开始交易 │
│ │ │ API │ │ │
└──────────┘ └──────────┘ └──────────┘

返佣领取流程

┌──────────┐     ┌──────────┐     ┌──────────┐
│ 查询返佣 │────▶│ 获取签名 │────▶│ 链上领取 │
│ 余额 │ │ API │ │ claimRebate │
└──────────┘ └──────────┘ └──────────┘

安全注意事项

  1. 签名有效期: 所有 EIP-712 签名的 timestamp 必须在 5 分钟内
  2. Nonce 管理: 每次领取返佣后 nonce 自动递增,防止重放攻击
  3. 金额验证: 后端会验证领取金额与待领取金额是否匹配
  4. 推荐码唯一性: 每个推荐码只能被一个地址注册
  5. 单次绑定: 用户只能绑定一次推荐码,绑定后不可更改