FarFISH LogoDocs

Wallet Setup

FarFISH supports multiple wallet options across different applications. Your wallet is your identity in the FarFISH ecosystem-no separate account or email required.

Supported Wallets by Application

Web App (app.farfish.xyz)

The Web App supports the widest range of wallet options:

  • MetaMask - Browser extension and mobile app
  • Coinbase Wallet - Smart Wallet and EOA (Externally Owned Account)
  • WalletConnect - Connect any WalletConnect-compatible wallet including:
    • Rainbow Wallet
    • Trust Wallet
    • Zerion
    • And 300+ other wallets

Recommended for Desktop: MetaMask or Coinbase Wallet browser extension
Recommended for Mobile: WalletConnect with your preferred mobile wallet

Base App (baseapp.farfish.xyz)

The Base App prioritizes Coinbase integration:

  • Coinbase Wallet (Priority)
    • Smart Wallet support (recommended)
    • EOA support (traditional wallet)
  • MetaMask - Browser extension
  • Injected Wallets - Any browser-based Web3 wallet

Farcaster Mini App (miniapp.farfish.xyz)

The Farcaster Mini App uses FID-based identity:

  • Automatic Connection - Uses Farcaster's embedded wallet
  • Single Wallet - No wallet selection needed
  • Identity - Your Farcaster ID (FID) is your primary identity

The Mini App automatically connects to the wallet associated with your Farcaster account.

Android App

The Android app uses a native mobile wrapper and supports:

  • WalletConnect - Primary connection method via deep links
    • Deep link schemes: wc://, farfish://
    • Opens wallet apps directly from FarFISH
  • Supported Wallets:
    • MetaMask
    • Trust Wallet
    • Coinbase Wallet
    • Rainbow
    • Any WalletConnect v2 compatible wallet

Note: The Android app provides native deep link handling for seamless wallet connections.

How to Connect Your Wallet

First-Time Connection

  1. Open FarFISH in your preferred application
  2. Click "Connect Wallet" button on the home screen
  3. Choose your wallet from the available options
  4. Approve the connection in your wallet app
  5. Start using FarFISH - Your wallet is now connected!

When you connect for the first time, FarFISH automatically:

  • Creates your referral code (last 8 characters of your wallet address)
  • Initializes your leaderboard entry
  • Sets up your user profile

Desktop Connection (Browser Extension)

If you have MetaMask or Coinbase Wallet installed:

  1. Click Connect Wallet
  2. Select your browser wallet
  3. A popup will appear from your wallet extension
  4. Click Connect to approve
  5. Sign any messages if requested

Mobile Connection (WalletConnect)

On mobile or without a browser extension:

  1. Click Connect Wallet
  2. Select WalletConnect
  3. A QR code will appear
  4. Open your mobile wallet app
  5. Scan the QR code
  6. Approve the connection in your wallet

Android App Connection

In the FarFISH Android app:

  1. Tap Connect Wallet
  2. Select WalletConnect (recommended)
  3. The app will open your wallet via deep link
  4. Approve the connection
  5. Return to FarFISH automatically

Network Requirements

All FarFISH applications operate on Base Mainnet (Chain ID: 8453).

When you connect, your wallet should automatically switch to Base. If not:

  1. Your wallet will prompt you to switch networks
  2. Click Switch Network or Add Network
  3. Approve the network change
  4. Connection will complete automatically

RPC Endpoints (for manual configuration):

  • Primary: https://mainnet.base.org
  • Fallback: https://base-rpc.publicnode.com

Disconnecting Your Wallet

Disconnect from FarFISH

Most wallets show a "Disconnect" or account menu in the header. Click your wallet address and select disconnect.

Disconnect from Your Wallet

For complete disconnection:

  1. Open your wallet app/extension
  2. Navigate to Connected Sites or Permissions
  3. Find FarFISH (app.farfish.xyz, baseapp.farfish.xyz, or miniapp.farfish.xyz)
  4. Click Disconnect or Revoke

Reconnection

You can reconnect anytime by clicking "Connect Wallet" again. Your data is stored on-chain and in our database, so:

  • Your NFTs are always yours
  • Your referrals and rewards are preserved
  • Your leaderboard rank remains
  • Your staked NFTs stay locked

Cross-App Wallet Usage

Your wallet works across all FarFISH applications:

  • NFTs minted in the Web App are visible in Base App
  • Staking in Base App works with NFTs from any app
  • Referrals from Mini App count in Web App leaderboard
  • Your identity is your wallet address-consistent everywhere

Shared Infrastructure:

  • Same NFT contracts
  • Same staking contracts
  • Same FRH token
  • Same leaderboard database

Security Best Practices

Protect Your Wallet:

  • Never share your seed phrase or private keys
  • FarFISH never asks for your seed phrase
  • All connections use standard Web3 protocols
  • We cannot access your wallet without approval

Transaction Safety:

  • Always verify transaction details in your wallet
  • Check the contract address before approving
  • Only connect to official FarFISH domains
  • Beware of phishing sites

Official Domains:

  • ✅ app.farfish.xyz
  • ✅ baseapp.farfish.xyz
  • ✅ miniapp.farfish.xyz
  • ✅ farfish.xyz

What FarFISH Can and Cannot Do:

  • ✅ Request transactions you must approve
  • ✅ Read your public wallet address
  • ✅ Read your NFT balances
  • ❌ Access your private keys
  • ❌ Move funds without your approval
  • ❌ Make transactions while disconnected

Troubleshooting

Connection Failed

Try these steps:

  1. Refresh the page
  2. Disconnect and reconnect
  3. Clear browser cache
  4. Try a different wallet
  5. Check your internet connection

Wrong Network

If your wallet is on the wrong network:

  1. Manually switch to Base Mainnet in your wallet
  2. Or wait for FarFISH to prompt you to switch
  3. Approve the network change

Wallet Not Detected

Browser Extension Not Found:

  • Ensure your wallet extension is installed
  • Refresh the page after installation
  • Try using WalletConnect instead

Mobile Wallet Issues:

  • Ensure your wallet app is updated
  • Use WalletConnect QR code
  • Check that your wallet supports Base network

If wallet apps don't open:

  1. Ensure the wallet app is installed
  2. Grant FarFISH permission to open external apps
  3. Try manually opening your wallet and using WalletConnect QR

Need Help?

If you're experiencing connection issues: