Referral System

FarFISH's referral system rewards both you and your friends when they join using your referral link. It's a win-win: you earn 20 FRH for each successful referral, and your referred friend gets a 20 FRH welcome bonus.

How Referrals Work

Dual-Reward Model

When someone joins FarFISH using your referral link:

You (Referrer) Receive:

• 🎁 20 FRH - Instantly credited to your account
• 📈 +1 Referral Count - Tracked in your profile
• 🏆 Leaderboard Boost - Higher rank from increased rewards

Your Friend (Referee) Receives:

• 🎁 20 FRH Welcome Bonus - Instantly credited
• 🔗 Permanent Referral Bond - You're their referrer forever
• ✨ Full Platform Access - Same features as any user

Both parties rewarded immediately - no waiting period.

Referral Code Format

Your referral code is the last 8 characters of your wallet address (lowercase).

Example:

• Wallet: 0x742d35cc6634c0532925a3b844bc9e7595f0beb0
• Referral Code: 5f0beb0 (last 8 characters)

Properties:

• ✅ Deterministic - Always the same for your wallet
• ✅ Unique - Extremely low collision probability
• ✅ Simple - Easy to share and remember
• ✅ Automatic - Generated when you first connect your wallet

Getting Your Referral Link

Finding Your Link

Method 1: Profile Page

1. Navigate to /profile in any FarFISH app
2. Scroll to the referral section
3. Your referral link displays automatically
4. Click Copy button to copy link

Method 2: Share Page

1. Go to /share page
2. Your referral link and code are displayed
3. Social sharing options available

Referral Link Format

Your referral link follows this format:

https://app.farfish.xyz?ref=XXXXXXXX

Components:

• Domain: FarFISH app domain
• Parameter: ?ref=
• Your Code: Last 8 chars of your wallet

Alternative Domains:

• Web App: app.farfish.xyz?ref=...
• Base App: baseapp.farfish.xyz?ref=...
• Mini App: miniapp.farfish.xyz?ref=...

How Referral Links Work

When a new user clicks your referral link:

Step 1: Page Load

• User lands on FarFISH with your referral code in the URL
• The app saves the code temporarily

Step 2: Exploration

• User can explore FarFISH features
• Referral code remains saved

Step 3: Wallet Connection

• User connects their wallet
• Referral attribution happens automatically

Step 4: Rewards

• You receive 20 FRH instantly
• They receive 20 FRH welcome bonus
• Relationship is permanent

Cross-App Referral Considerations

Same-Domain Recommendation

Why it matters:

• Referral codes are saved per-browser session
• Switching between Web App, Base App, and Mini App may lose the saved code
• Staying on the same app ensures proper attribution

Best Practices:

1. Share Domain-Specific Links

   • For general users: Use Web App link
   • For Coinbase Wallet users: Use Base App link
   • For Farcaster users: Use Mini App link

2. Provide Code as Backup

   • Share your 8-character code separately
   • Example: "Use code 5f0beb0 if the link doesn't work"

3. Educate New Users

   • Tell them to complete signup on the app where they land
   • If they switch apps, they may need to manually enter your code

Referral Validation

Security Checks

FarFISH prevents abuse through automatic validation:

Self-Referral Prevention:

• You cannot use your own referral code
• System compares codes and blocks matching attempts

One Referrer Per User:

• Each user can only be referred once
• First valid referral is permanent
• Cannot change referrer later

Code Validation:

• Referral code must exist in the system
• Wallet format must be valid
• All checks happen automatically

Leaderboard and Rewards

How Scoring Works

Your leaderboard score reflects total FRH earned:

Score includes:

• Referral rewards: 20 FRH per successful referral
• Welcome bonus: 20 FRH when you joined (if you used a referral)
• Daily chest rewards: 3-9 FRH per day
• Staking rewards: Variable based on NFT rarity and duration

Your rank is determined by your total FRH earned compared to all other users.

Tracking Your Referrals

Where to Check:

Profile Page:

• Total referrals count
• Your referral link
• Your overall rank

Leaderboard Page:

• Your position in rankings
• Comparison to other users
• Total rewards earned

Stats Displayed:

• Referrals: How many users you've referred
• Rewards: Total FRH earned (from all sources)
• Rank: Your position in the community

Referral Strategies

Maximizing Success

1. Share Authentically

• Share your genuine experience with FarFISH
• Explain why you think it's valuable
• Be helpful, not spammy

2. Target the Right Audience

• Web3 enthusiasts
• NFT collectors
• Gaming community members
• People interested in earning rewards

3. Use Multiple Channels

• Social media (Twitter/X, Farcaster)
• Messaging apps (Telegram, Discord)
• Direct messages to interested friends
• Content platforms (blogs, YouTube)

4. Provide Value

• Create helpful guides
• Answer questions
• Share your strategies
• Help newcomers get started

5. Be Patient

• Build trust in communities first
• Don't spam links
• Focus on quality over quantity

Setting Goals

Short-term (First Month):

• 5-10 successful referrals
• Learn what messaging works best
• Test different channels

Medium-term (3-6 Months):

• 25-50 successful referrals
• Establish presence in communities
• Consistent referral flow

Long-term (6+ Months):

• 100+ successful referrals
• Top 50 on leaderboard
• Recognition in FarFISH community

Frequently Asked Questions

Do I need an NFT to refer people?
No, anyone with a connected wallet can refer others. NFTs are not required.

Is there a limit to how many I can refer?
No limit. Refer as many people as you want, earning 20 FRH for each successful referral.

What if my friend forgets to use my link?
They may be able to manually enter your referral code in their profile if they haven't been referred yet.

Can I change my referrer after joining?
No, referral relationships are permanent. Your first referrer is final.

Do rewards expire?
No, leaderboard scores and FRH rewards are permanent.

Can I see who I referred?
Currently, the system only tracks counts, not individual referee details.

What if someone already has an account?
Referrals only work for new users connecting for the first time. Existing users cannot be referred.

Do I earn from my referrals' activity?
Not currently. You earn 20 FRH when they join, but not from their ongoing activity.

Can I use multiple referral links?
You only have one referral code tied to your wallet address. It's the same across all FarFISH apps.

Next Steps

• Review the Applications guide for cross-app behavior
• Check Leaderboard & Rankings
• Understand FRH Token Economics

Start sharing your referral link and grow the FarFISH community! 🌊