Referrals & Promo Codes

Referral System

• Code format: ACE-{FIRST5}-{LAST3} from wallet address
• Rebates: $4 / $40 / $68 (Starter / Standard / Pro) — permanent once credited
• Eligibility: Referrer needs active Standard/Pro/Sponsored; referee must be first-time subscriber
• Flow: pending → eligible → paid

Architecture

• PromoCodeRegistry DO (1 global) — Ensures code uniqueness, atomic validateAndRecordUsage() prevents race conditions
• ReferralManager — Per-user referral tracking within UserPaperTradePortfolio

Promo Codes

PromoCodeRegistry supports both campaign codes and referral codes (ACE-XXXXX-XXX format).