📋 How Referral Works
CTRLZ does not have a native on-chain referral field. Mapping (who invited whom) is stored by the
dashboard in referrals.json.
Success is still proven on-chain: the background holder scanner reads Base Transfer logs and
only counts purchases that look like real swaps. Anyone can verify the same transactions on Basescan.
📌 Published parameters
👤 Who can be referred (wallet B)
Referral is for new holders only. If B already has CTRLZ balance or any prior CTRLZ receive
history before clicking the link, the code will not bind. Self-referral is blocked.
One wallet can only have one referrer forever.
🛒 What counts as a valid buy (accrual window)
For 7 days after the link click, every verified swap-buy by B of at least
$7 (matched USDC/WETH/ETH spend in the same transaction as CTRLZ received) adds
1% to A’s staged reward. Multiple buys in the window each earn their own 1%.
Wallet-to-wallet transfers without a matching spend do not count. Swaps under $7 are ignored.
Buys after day 7 are outside the window and do not accrue.
⏳ Hold & retention (wallet B)
Staged rewards stay locked until B holds continuously for 7 days with retention
≥ 50% (current balance ÷ total CTRLZ ever received). Only then does staged amount move to
A’s claimable balance. If B dumps below retention before that, staged rewards are
not paid (forfeited when the window ends). Dumping right after a swap blocks A.
💰 How referrer reward is calculated (wallet A)
For each eligible swap in the 7-day window:
reward_USD = swap_spend_USD × 1%
reward_CTRLZ = reward_USD ÷ CTRLZ_price_USDC
(price at the scanner pass that first sees the tx)
Amounts are staged per B until hold/retention passes, then added to A’s
pending_claim. Paid from the project reward wallet,
not from B’s tokens.
📐 Worked examples
Example 1 — one min buy
Day 1: B swap-buys $7 → stage $0.07 for A.
B holds 7 days + 50% → A claimable ≈ $0.07 in CTRLZ.
Example 2 — several buys in the window
Day 1: $7 → +$0.07 · Day 3: $50 → +$0.50 · Day 6: $20 → +$0.20
Staged total = $0.77. After B’s hold/retention OK → A claimable $0.77 equivalent.
Example 3 — buy then dump
B swaps $100 (stages $1.00) then sells below 50% retention before day 7 →
staged amount is not flushed to A (forfeited).
Example 4 — transfer only
Someone sends CTRLZ to B with no USDC/WETH/ETH spend in that tx → $0, not a referral buy.
✅ When A can claim
A may create a referral code with zero CTRLZ. To claim accrued rewards, A must:
hold at least 1,000,000 CTRLZ, continuous hold ≥ 7 days, and retention ≥ 50%.
Claim requires a wallet signature message
ctrlz-referral-claim:<unix_ts>
(max age 5 minutes). Buying the minimum only to claim and sell the same day is blocked by the hold check.
⚠️ Openness note: parameters above are enforced in server code and visible here so the community can
audit the rules. Matching logic can be cross-checked on Basescan (Transfer + spend in the same tx).
Rules may be tightened later if abuse appears; material changes should be announced the same way —
in this panel and in the dashboard code.
$CTRLZ Dashboard