推荐系统概述 (Referral System)
AXBlade 推荐系统支持推荐码注册、绑定、返佣查询和链上领取功能。通过推荐系统，用户可以邀请新用户并获得交易返佣奖励。
功能特性
- 推荐码创建: 用户可创建专属推荐码
- 推荐绑定: 新用户可绑定推荐人的推荐码
- 返佣计算: 根据被推荐人的交易量自动计算返佣
- 链上领取: 通过智能合约安全领取返佣
合约地址 (Arbitrum Sepolia Testnet)
| 合约 | 地址 | 说明 |
|---|---|---|
| USDT | 0x572E474C3Cf364D085760784F938A1Aa397a8B9b | 测试 USDT (6 decimals) |
| AXBladeVault | 0xFDe43f8e6e082975d246844DEF4fE8E704403d43 | 充值/提现合约 |
| ReferralStorage | 0x984BC1C4Aa3995F9B78BA54372a10d3088C249D5 | 推荐码存储合约 |
| ReferralRebate | 0xaF486e11c824389E4Ab3ced7608ac3Bd43c176B8 | 返佣分发合约 |
Chain ID: 421614
RPC URL: https://sepolia-rollup.arbitrum.io/rpc
Explorer: https://sepolia.arbiscan.io
层级系统
| 层级 | 名称 | 总返佣 | 交易者折扣 | 推广者奖励 |
|---|---|---|---|---|
| 0 | Bronze | 10% | 5% | 5% |
| 1 | Silver | 12% | 5% | 7% |
| 2 | Gold | 15% | 5% | 10% |
| 3 | Platinum | 18% | 6% | 12% |
| 4 | Diamond | 20% | 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 │
└──────────┘ └──────────┘ └──────────┘
安全注意事项
- 签名有效期: 所有 EIP-712 签名的 timestamp 必须在 5 分钟内
- Nonce 管理: 每次领取返佣后 nonce 自动递增，防止重放攻击
- 金额验证: 后端会验证领取金额与待领取金额是否匹配
- 推荐码唯一性: 每个推荐码只能被一个地址注册
- 单次绑定: 用户只能绑定一次推荐码，绑定后不可更改