1. Referrer creates referral code (e.g., "MYCODE")
2. Referee uses code when signing up
3. Every trade by referee generates:
   - Fee discount for referee
   - Rebate reward for referrer
4. Rebates accumulate on-chain
5. Referrer claims rebates anytime

Starting: Tier 1 (5% rebate)

Progress:
- Refer 5 traders → Tier 2 possible
- Those traders do $10M volume → Tier 2 unlocked (10% rebate)
- Refer 10 traders → Tier 3 possible
- Volume reaches $50M → Tier 3 unlocked (15% rebate)
...continue to Tier 6

Example: Tier 3 Referee with VIP 5

Base Taker Fee: 0.27% (VIP 5)
Referee Discount: 10% (Tier 3 referral)
Final Fee: 0.27% × (1 - 10%) = 0.243%

Savings: 0.257% per trade vs VIP 0 base

import { DEX } from '@luxfi/trading'

const dex = await DEX({ rpcUrl: 'https://api.lux.network/rpc' })

// Create referral code
const code = await dex.referral.createCode({
  code: 'MYCODE123',    // Alphanumeric, 3-20 chars
  customRebate: null    // Optional: override tier rebate
})

console.log(`Code: ${code.code}`)
console.log(`Owner: ${code.owner}`)
console.log(`Created: ${code.createdAt}`)
console.log(`Share Link: https://lx.exchange/r/${code.code}`)

// Set custom 20% rebate (if at Tier 4+)
const code = await dex.referral.createCode({
  code: 'SPECIAL20',
  customRebate: 2000    // 20% in basis points
})

// Update existing code rebate
await dex.referral.setCustomRebate({
  code: 'SPECIAL20',
  rebate: 2500          // Increase to 25% (if Tier 5+)
})

// New user applies referral code
await dex.referral.useCode('MYCODE123')

// Check referral status
const status = await dex.referral.getReferralStatus()

console.log(`Referred By: ${status.referrerId}`)
console.log(`Code Used: ${status.code}`)
console.log(`Fee Discount: ${status.discount}%`)
console.log(`Referrer Tier: ${status.referrerTier}`)

// Get current fee discount
const discount = await dex.referral.getFeeDiscount()

console.log(`Discount: ${discount}%`)
console.log(`Effective Taker: ${0.50 * (1 - discount/100)}%`)
console.log(`Effective Maker: ${0.10 * (1 - discount/100)}%`)

Trade Flow:
1. Referee places trade with $50 fee
2. Fee discount applied: $50 × 10% = $5 discount
3. Referee pays: $45
4. Referrer rebate: $45 × 15% = $6.75
5. Protocol receives: $45 - $6.75 = $38.25

Referee saves: $5 (10% discount)
Referrer earns: $6.75 (15% of post-discount fee)

// Get referrer stats
const referrer = await dex.referral.getReferrerStats()

console.log(`Referral Tier: ${referrer.tier}`)
console.log(`Total Referrals: ${referrer.totalReferrals}`)
console.log(`Active Referrals: ${referrer.activeReferrals}`)
console.log(`Total Volume: $${referrer.totalVolume}`)
console.log(`Pending Rebates: $${referrer.pendingRebates}`)
console.log(`Total Claimed: $${referrer.totalClaimed}`)

// Check pending rebates
const pending = await dex.referral.getPendingRebates()
console.log(`Pending: $${pending}`)

// Claim all pending rebates
const claimed = await dex.referral.claimRebates()

console.log(`Claimed: $${claimed.amount}`)
console.log(`Tx Hash: ${claimed.txHash}`)

// Enable auto-claim when balance reaches threshold
await dex.referral.setAutoClaimThreshold({
  enabled: true,
  threshold: '100'      // Claim when $100 accumulated
})

const codes = await dex.referral.getCodes()

codes.forEach(code => {
  console.log(`Code: ${code.code}`)
  console.log(`  Active: ${code.isActive}`)
  console.log(`  Uses: ${code.totalUses}`)
  console.log(`  Volume: $${code.totalVolume}`)
  console.log(`  Rebates: $${code.totalRebates}`)
})

// Deactivate a code (existing referrals continue)
await dex.referral.deactivateCode('OLDCODE')

// Note: Cannot reactivate or reuse deactivated codes

// Transfer code to another address (Tier 5+ only)
await dex.referral.transferCode({
  code: 'MYCODE123',
  newOwner: '0x...'
})

const history = await dex.referral.getRebateHistory({
  limit: 100,
  offset: 0
})

history.forEach(payment => {
  console.log(`${payment.timestamp}:`)
  console.log(`  Referee: ${payment.refereeId}`)
  console.log(`  Trade: ${payment.tradeId}`)
  console.log(`  Market: ${payment.market}`)
  console.log(`  Trade Volume: $${payment.volume}`)
  console.log(`  Trade Fee: $${payment.fee}`)
  console.log(`  Discount Given: $${payment.discount}`)
  console.log(`  Rebate Earned: $${payment.rebate}`)
})

// Export to CSV
const csv = await dex.referral.exportHistory({
  format: 'csv',
  startDate: '2024-01-01',
  endDate: '2024-12-31'
})

const stats = await dex.referral.getStats()

console.log(`Total Referrers: ${stats.totalReferrers}`)
console.log(`Total Referees: ${stats.totalReferees}`)
console.log(`Total Rebates Paid: $${stats.totalRebatesPaid}`)
console.log(`Total Discounts Given: $${stats.totalDiscountsGiven}`)
console.log(`Active Codes: ${stats.activeCodes}`)

const leaderboard = await dex.referral.getLeaderboard({
  period: '30d',
  limit: 100
})

leaderboard.forEach((referrer, rank) => {
  console.log(`#${rank + 1}: ${referrer.address}`)
  console.log(`  Tier: ${referrer.tier}`)
  console.log(`  Referrals: ${referrer.referrals}`)
  console.log(`  Volume: $${referrer.volume}`)
  console.log(`  Rebates: $${referrer.rebates}`)
})

// Verify referral code on-chain
const onChainCode = await dex.referral.verifyCode('MYCODE123')

console.log(`Owner: ${onChainCode.owner}`)
console.log(`Created Block: ${onChainCode.createdBlock}`)
console.log(`Total Uses: ${onChainCode.uses}`)
console.log(`Total Volume: ${onChainCode.volume}`)

// Verify rebate payment
const payment = await dex.referral.verifyPayment(txHash)
console.log(`Valid: ${payment.verified}`)