Referrals

The referral program rewards community growth. A referrer earns 5% of the points produced by each referee. The bonus is single-level (no multi-level trees) and follows the referee’s newly earned points (not transfers).

Program Overview

  • Referrer reward: 5% of referee’s points earned through accrual.

  • Scope: Single-level only; no stacking or multi-level pyramids.

  • Basis: Tracks point production (accrual) from deposits/time; does not trigger on ERC-20 points transfers or burns.

  • Binding: A referee can set a referrer once (on first interaction or explicit bind). The mapping is immutable unless reset via admin tooling for fraud remediation.

  • Self-referrals: Blocked.

  • Retroactive credit: Optional; default off (only accrual after binding is eligible).

On-Chain Model

Data structures (conceptual).

  • referrerOf[referee] -> address

  • totalReferralEarnings[referrer] -> uint256

  • referralEnabled -> bool (global switch)

Events.

  • ReferralSet(referrer, referee)

  • ReferralPayout(referrer, referee, amount)

Binding.

  • The dApp passes a ref param (address) during the first eligible action (e.g., first deposit or explicit “Bind Referrer” tx).

  • Contract enforces:

    • referrer != referee

    • referrerOf[referee] == 0x0 (not previously set)

Economics & Equations

ΔPtsF(ref)=γΔPtsRwithγ=0.05ΔPtsF(ref)​=γ⋅ΔPtsR​ with γ=0.05

Accrual function (from Points Program):

ΔPtsR=UR(t)r0mvb(d)ΔtΔPtsR​=UR​(t)⋅r0​⋅mv​⋅b(d)⋅Δt

UI/UX

  • Referral link: https://hypervault.finance?ref=0xReferrerAddress

  • Badges: show lifetime referred TVL, active referees, and total referral points earned.

  • Receipts: render ReferralPayout entries in activity.

Last updated