FarFISH LogoDocs

Frequently Asked Questions

Quick answers to common questions about the FarFISH ecosystem.

General

What is FarFISH?

FarFISH is a Web3 reward ecosystem on Base featuring NFTs, staking, referrals, and daily chests.

For comprehensive details, see Introduction.

Is FarFISH safe to use?

Yes. FarFISH uses non-custodial architecture - you control assets via your wallet. All smart contracts are verified on Basescan.

For complete security details, see Security Model.

Do I need to create an account?

No. FarFISH uses wallet-based identity - your wallet address is your account. No usernames, passwords, or emails required. Connect your wallet and start using the platform immediately.

Which FarFISH app should I use?

  • Web App (app.farfish.xyz) - Full-featured web app with Android support and Steam integration
  • Base App (baseapp.farfish.xyz) - Optimized for Coinbase Wallet users
  • Farcaster Mini App (miniapp.farfish.xyz) - Integrated into Farcaster with social verification features

All apps share the same blockchain contracts and reward system. Choose based on your preferred wallet and platform.

Wallet & Security

What wallets are supported?

Web App & Base App:

  • MetaMask
  • Coinbase Wallet (Smart Wallet & EOA)
  • WalletConnect (any compatible wallet)
  • Injected wallets (Rainbow, Trust Wallet, etc.)

Farcaster Mini App:

  • Farcaster embedded wallet only

Is my wallet address public?

Yes. Wallet addresses are public blockchain data visible on Base blockchain explorer (Basescan). Leaderboards display wallet addresses. Never share your private key or seed phrase - those must remain secret.

Why doesn't FarFISH ask for my private key?

FarFISH never needs your private key. Private keys stay in your wallet (MetaMask, Coinbase Wallet, etc.). When you perform actions like minting or staking, your wallet signs transactions locally using your private key - FarFISH only receives the signed transaction, never the key itself.

Never share your private key or seed phrase with anyone, including FarFISH support. Legitimate operations never require this information.

What happens if I lose my wallet?

If you lose access to your wallet (lost seed phrase, forgotten password), you permanently lose access to your NFTs and tokens. FarFISH cannot recover lost wallets. Always:

  • ✅ Back up your seed phrase securely
  • ✅ Store it offline (never digital screenshots)
  • ✅ Consider hardware wallets for large holdings

NFTs & Tokens

How many NFTs can I mint?

Total Supply: 9,999 NFTs maximum across the entire ecosystem.

Per-User Limit: No per-wallet limit - you can mint as many as you want (up to total supply remaining).

Checking Supply:

text
Visit app.farfish.xyz and view "X / 9,999 minted" on homepage

What are the NFT rarity tiers?

FarFISH NFTs have 4 rarity tiers with different drop rates and staking rewards:

FarFISH has 4 rarity tiers across 16 token IDs. Rarer NFTs provide higher staking rewards.

For complete rarity breakdown and reward calculations, see NFT System Guide.

What is FRH token?

FRH (FarFISH Token) is an ERC-20 token on Base blockchain used for:

  • Referral rewards (20 FRH per referral for both parties)
  • Staking rewards (varies by NFT rarity and lock duration)
  • Daily chest claims (3 FRH bronze, 6 FRH silver)
  • Leaderboard rewards (based on total score)

Contract Address: See Contract Addresses

How do I get FRH?

Four ways to earn FRH:

  1. Referrals - Refer friends (+20 FRH per referral, both parties)
  2. Staking - Stake NFTs for 30-360 days (rewards vary by rarity)
  3. Daily Chests - Claim bronze chest (3 FRH) and silver chest (6 FRH) daily
  4. Leaderboard - Top performers earn bonus FRH

How do I stake my NFT?

Staking Flow:

  1. Mint at least one FarFISH NFT
  2. Go to /stake page
  3. Approve staking contract (one-time, enables NFT transfers)
  4. Select NFT rarity and lock duration (30/90/180/360 days)
  5. Confirm transaction
  6. NFT is locked in staking contract until unlock time
  7. Claim rewards anytime via "Claim" button
  8. Unstake after lock period expires

See Staking Guide for detailed walkthrough.

Rewards

How does the referral system work?

Dual-Reward Model: Both referrer AND referee get +20 FRH each (40 FRH total per referral).

How to Refer:

  1. Connect wallet → get your referral link (app.farfish.xyz?ref=XXXXXXXX)
  2. Share link on social media, Discord, Telegram, etc.
  3. New user clicks your link and connects wallet
  4. Both of you instantly receive +20 FRH!

Rules:

  • ✅ No limit on referrals
  • ✅ Rewards instant (no waiting period)
  • ❌ Cannot refer yourself
  • ❌ Each user can only be referred once

See Referral System Guide for details.

How are leaderboard scores calculated?

Formula: Score × 20 = Total FRH Earned

How Score Increases:

  • +1 score per referral made (referrer)
  • +1 score per being referred (referee)
  • Future: Staking milestones, special events

Example:

  • 10 referrals made = 10 score = 200 FRH
  • 50 referrals made = 50 score = 1,000 FRH

Leaderboard displays top 100 users by total rewards earned.

What are daily chests?

Two chest types:

Bronze Chest:

  • Reward: 3 FRH
  • Requirement: None (anyone can claim)
  • Cooldown: 24 hours

Silver Chest:

  • Reward: 6 FRH
  • Requirement: Must have at least one active stake
  • Cooldown: 24 hours

Claiming:

  1. Go to /chest page
  2. Click "Claim Bronze Chest" or "Claim Silver Chest"
  3. Wait 24 hours before next claim

How long do I have to wait between chest claims?

Cooldown: Exactly 24 hours from last claim time.

Example:

  • Claim bronze chest at 10:00 AM Monday
  • Next claim available at 10:00 AM Tuesday

Cooldown tracked on-chain (smart contract), cannot be bypassed.

Cross-App Usage

Can I use my NFTs across different FarFISH apps?

Yes! All FarFISH apps (Main, Base, Farcaster) use the same smart contracts on Base blockchain. Your NFTs, staked assets, and FRH tokens work across all apps.

Same wallet = same assets everywhere.

Referral limitation: Referral links are domain-specific. A user who clicks a Web App link (app.farfish.xyz?ref=...) and connects wallet there cannot be referred via Base App (baseapp.farfish.xyz) link later.

Why? Referral code caching uses localStorage, which is isolated per domain.

Best Practice: Use links from the same app variant for all your referrals.

Do I need separate wallets for each app?

No. Use the same wallet address across all FarFISH apps. Your data (NFTs, stakes, referrals, leaderboard score) is automatically synchronized.

Technical

Why isn't my transaction confirming?

Common causes:

  1. Insufficient gas fees - Increase gas price or wait for lower network congestion
  2. Pending transaction - Previous transaction still pending (must clear first)
  3. Network congestion - Base blockchain experiencing high traffic
  4. Wrong network - Ensure wallet is on Base Mainnet (Chain ID 8453)

How to check:

  • View transaction on Basescan
  • Check wallet for pending transactions
  • Ensure sufficient ETH balance for gas

What gas fees should I expect on Base?

Base blockchain is very cheap compared to Ethereum mainnet:

ActionTypical Gas Cost
NFT Mint$0.10 - $0.50
Staking$0.05 - $0.20
Unstake$0.05 - $0.20
Claim Rewards$0.02 - $0.10
Chest Claim$0.02 - $0.10

Actual costs vary based on network congestion. Base uses ETH for gas fees.

How do I add Base network to my wallet?

Network Details:

  • Network Name: Base Mainnet
  • RPC URL: https://mainnet.base.org
  • Chain ID: 8453
  • Currency Symbol: ETH
  • Block Explorer: https://basescan.org

MetaMask:

  1. Open MetaMask
  2. Click network dropdown (top left)
  3. Click "Add Network"
  4. Select "Base Mainnet" (or enter details above)
  5. Click "Save"

Coinbase Wallet: Base is pre-configured. Select "Base" from network list.

Troubleshooting

"Connect Wallet" button not working

Try these steps:

  1. Refresh page
  2. Ensure wallet extension is installed and unlocked
  3. Try different browser (Chrome, Firefox, Edge)
  4. Clear browser cache
  5. Disable other wallet extensions (conflicts possible)

Transaction failed after confirmation

Check Basescan for error message:

  1. Copy transaction hash from wallet
  2. Visit https://basescan.org/tx/{hash}
  3. View error message

Common errors:

  • "Insufficient funds" - Need more ETH for gas
  • "Claim condition not active" - NFT minting paused
  • "Already staked" - NFT already in staking contract

Referral not working ("Cannot refer yourself")

Cause: Your wallet address ends with the same 8 characters as the refCode you're trying to use.

Example:

  • Your wallet: 0x1234567890abcdef1234567890abcdef12345678
  • RefCode: 12345678
  • Result: Self-referral detected ❌

Solution: Use a different referral link.

Can't unstake NFT ("Lock not expired")

Cause: Staking lock period hasn't finished yet.

Check unlock time:

  1. Go to /stake page
  2. View "Unlock Date" for your stake
  3. Wait until unlock date passes
  4. Then click "Unstake"

Lock durations: 30, 90, 180, or 360 days (chosen at stake time).

Android App

Where can I download the Android app?

Download:

  • Direct APK - Download from https://farfish.xyz/app-release.apk

Minimum Requirements:

  • Android 9.0 Pie (API 28) or higher
  • Internet connection

Android app not loading / blank screen

Troubleshooting:

  1. Clear app cache: Settings → Apps → FarFISH → Clear Cache
  2. Check internet connection
  3. Update to latest version
  4. Uninstall and reinstall
  5. Ensure Android 9.0+ (check Settings → About Phone)

WalletConnect not working in Android app

Steps:

  1. Install WalletConnect-compatible wallet (MetaMask, Trust Wallet, etc.)
  2. In FarFISH app, click "Connect Wallet" → "WalletConnect"
  3. Scan QR code with your wallet app
  4. Approve connection in wallet app

If still failing:

  • Ensure both apps updated to latest versions
  • Try reinstalling wallet app
  • Use "Injected" connection if wallet supports browser extensions

Support

How do I report a bug?

Security Issues: Email security team (see Security Model)

General Bugs:

  1. Visit FarFISH Discord or Telegram
  2. Post in #support channel
  3. Include: wallet address, transaction hash (if applicable), screenshot, browser/device info

Where can I get help?