Proximity Rewards

const fenineSystem = new ethers.Contract(
  "0x0000000000000000000000000000000000001000",
  FENINE_SYSTEM_ABI,
  signer
);

// Get your referral code
const myCode = await fenineSystem.getReferralCode(myAddress);
console.log("Your code:", myCode);

// If no code exists (not staked yet), will return empty string

// Delegate with referral
const tx = await fenineSystem.delegateWithReferral(
  validatorAddress,
  amount,
  "ABC123"  // Referrer's code
);

await tx.wait();

My Referral Network
──────────────────────────────────────
Total Referrals:        47 people
Active Stakers:         39 people
Total Staked:           234,567 FEN
My Proximity Rewards:   1,234 FEN (lifetime)

Breakdown by Level:
Level 1:  12 people  →  94.5 FEN earned
Level 2:  18 people  →  67.2 FEN earned
Level 3:  10 people  →  38.4 FEN earned
Level 4:   4 people  →  15.6 FEN earned
Level 5:   2 people  →   8.3 FEN earned
Level 6:   1 person  →   2.1 FEN earned
Level 7:   0 people  →   0.0 FEN earned
Level 8:   0 people  →   0.0 FEN earned

// Get referral tree
const tree = await fenineSystem.getReferralTree(myAddress);

console.log("Level 1:", tree.level1.length, "people");
console.log("Level 2:", tree.level2.length, "people");
// ... up to level 8

// Get proximity rewards earned
const rewards = await fenineSystem.getProximityRewards(myAddress);
console.log("Lifetime proximity:", ethers.formatEther(rewards));

Level 1 rewards:
  5 × 1,000 × 0.10/12 × 0.07 = 2.92 FEN/month

Level 2 rewards:
  3 × 800 × 0.10/12 × 0.05 = 1.00 FEN/month

──────────────────────────────────────
Total proximity: 3.92 FEN/month

If your stake is 1,000 FEN:
  Base: 8.33 FEN/month (10% APY)
  Proximity: 3.92 FEN/month
  Total: 12.25 FEN/month

Effective APY: 14.7%

L1: 20 × 2,000 × 0.10/12 × 0.07 =  23.33 FEN
L2: 40 × 1,500 × 0.10/12 × 0.05 =  25.00 FEN
L3: 30 × 1,000 × 0.10/12 × 0.03 =   7.50 FEN
L4: 15 × 800  × 0.10/12 × 0.02 =   2.00 FEN
──────────────────────────────────────
Total proximity: 57.83 FEN/month

With 5,000 FEN stake:
  Base: 41.67 FEN/month
  Proximity: 57.83 FEN/month
  Total: 99.50 FEN/month

Effective APY: 23.9%

Estimated proximity rewards: 400+ FEN/month

With 10,000 FEN stake:
  Base: 83.33 FEN/month
  Proximity: 400 FEN/month
  Total: 483.33 FEN/month

Effective APY: 58%!

You stake 10,000 FEN
│
├─ Level 1 (10 people): Teach them to share
│  │
│  ├─ Level 2 (30 people): Each L1 refers 3 people
│     │
│     ├─ Level 3 (90 people): Each L2 refers 3 people
│        │
│        └─ And so on...

"Unlike typical referral programs:
• Earn from 8 levels (not just 1-2)
• Passive income forever
• Your network compounds
• Built into blockchain protocol
• Transparent on-chain tracking"

Awareness Stage:
└─ Twitter threads about DeFi APY

Interest Stage:
└─ "Fenine vs Other Staking" blog post

Consideration Stage:
└─ YouTube tutorial with earnings proof

Conversion Stage:
└─ Email list with referral code
   └─ Drip campaign teaching how to stake

Retention Stage:
└─ Monthly earnings newsletter
   └─ Encourage them to refer

🎁 My Referral Bonus Program

Use code XYZ123 and stake 1,000+ FEN:

• 1st month: I'll send you 50 FEN bonus
• 3rd month: Another 50 FEN if still staked
• 6th month: 100 FEN bonus

+ Exclusive Discord access
+ Weekly market analysis
+ 1-on-1 onboarding call

You
├─ 100 Level 1 referrals
└─ 0 Level 2+ referrals

Earnings: Only 7% of their rewards

You
├─ 20 Level 1
│  ├─ 40 Level 2
│     ├─ 60 Level 3
│        ├─ 40 Level 4
│           └─ ... levels 5-8

Earnings: 20.25% across all levels

// Check who referred you
const myReferrer = await fenineSystem.getReferrer(myAddress);
console.log("Referred by:", myReferrer);

// Check if someone used your code
const theirReferrer = await fenineSystem.getReferrer(theirAddress);
if (theirReferrer === myAddress) {
  console.log("They're in your Level 1!");
}

// Get proximity rewards breakdown
const breakdown = await fenineSystem.getProximityBreakdown(myAddress);

console.log("Level 1 rewards:", ethers.formatEther(breakdown.level1));
console.log("Level 2 rewards:", ethers.formatEther(breakdown.level2));
// ... up to level 8

// Total proximity rewards
const total = await fenineSystem.getProximityRewards(myAddress);
console.log("Total earned:", ethers.formatEther(total));

// Get referral count by level
const counts = await fenineSystem.getReferralCounts(myAddress);

console.log("My Network:");
for (let i = 1; i <= 8; i++) {
  console.log(`  Level ${i}: ${counts[i-1]} people`);
}

// Get total staked in your network
const networkStake = await fenineSystem.getNetworkStake(myAddress);
console.log("Total network stake:", ethers.formatEther(networkStake));

// Example API call
const response = await fetch('https://api.fene.app/referrals/XYZ123');
const data = await response.json();

console.log("Network stats:", data);
// {
//   code: "XYZ123",
//   totalReferrals: 47,
//   activeStakers: 39,
//   totalStaked: "234567000000000000000000",
//   lifetimeRewards: "1234000000000000000000",
//   levelBreakdown: [...]
// }