Ecosystem Architecture

FarFISH operates as a unified ecosystem spanning four applications, each optimized for different user contexts while sharing the same underlying infrastructure.

The Four Applications

Overview Map

text

                    ╔═══════════════════════════════════════╗
                    ║      FarFISH Ecosystem                ║
                    ║   Unified Multi-App Platform          ║
                    ╚═══════════════════════════════════════╝
                                    │
        ┌───────────────────────────┼───────────────────────────┐
        │                           │                           │
        ▼                           ▼                           ▼
┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│   Web App       │       │   Base App      │       │ Farcaster Mini  │
│                 │       │                 │       │     App         │
│ app.farfish.xyz │       │ baseapp.        │       │ miniapp.        │
│                 │       │ farfish.xyz     │       │ farfish.xyz     │
├─────────────────┤       ├─────────────────┤       ├─────────────────┤
│ • Web Browser   │       │ • Web Only      │       │ • Farcaster     │
│ • Android APK   │       │ • Coinbase      │       │   Platform      │
│ • Full Features │       │   Wallet Focus  │       │ • Social First  │
└─────────────────┘       └─────────────────┘       └─────────────────┘
        │                           │                           │
        └───────────────────────────┼───────────────────────────┘
                                    │
                    ╔═══════════════▼═══════════════════════╗
                    ║   Shared Infrastructure               ║
                    ║                                       ║
                    ║  • Base Blockchain (Chain ID: 8453)   ║
                    ║  • Smart Contracts (NFT, Staking)     ║
                    ║  • Off-chain Backend (Leaderboard)    ║
                    ║  • Universal Identity (Wallet-based)  ║
                    ╚═══════════════════════════════════════╝

On mobile? The ecosystem diagram above may scroll horizontally. Four apps share one infrastructure layer on Base blockchain.

Application Summary Table

Application	Platform	Primary Users	Domain
Web App	Web + Android	General users, mobile-first	app.farfish.xyz
Base App	Web	Coinbase Wallet users, Base enthusiasts	baseapp.farfish.xyz
Farcaster Mini App	Farcaster platform	Farcaster social users	miniapp.farfish.xyz
Marketing Website	Web	New visitors, information seekers	farfish.xyz
iOS App	iOS (Planned)	iPhone/iPad users	N/A (future)

Shared Infrastructure

All Web3 applications share the same backend infrastructure, enabling seamless cross-app experiences.

What's Shared

Backend Data Layer (Off-Chain):

Leaderboard rankings and scores
Referral relationships and counts
Task completion and progress
User preferences and settings
Streak counters and daily claim tracking

Blockchain Layer (On-Chain):

Smart contracts for NFTs, staking, tokens, and rewards
All contracts deployed on Base Mainnet (Chain ID 8453)
Identical contract addresses across all apps
Shared blockchain state for ownership and balances

User Identity:

Wallet address is your universal identity
Same wallet = same account across all apps
Automatic data synchronization
No separate registration for each app

How Shared Infrastructure Benefits You

✅ Mint in one app, stake in another: NFTs minted in Web App are immediately stakeable in Base App
✅ Unified leaderboard: Your rank updates across all apps in real-time
✅ Cross-app referrals: Earn referral rewards regardless of which app your friend uses
✅ One wallet, everywhere: Connect the same wallet to access your complete profile

True Cross-App Sync: Your progress, NFTs, and rewards are shared automatically. You don't need to manually sync or transfer anything between applications.

Web App (app.farfish.xyz)

Overview

The complete FarFISH experience with all features available.

Platforms

Web: Access via any desktop or mobile browser
Android: Native app available via direct APK download from farfish.xyz

Key Features

✅ NFT minting (all 16 collectibles)
✅ NFT staking (all lock periods)
✅ Daily chest rewards (Bronze and Silver)
✅ Referral system with dual rewards
✅ Global leaderboard and rankings
✅ Gaming features and task system
✅ Multi-wallet support (MetaMask, WalletConnect, Coinbase Wallet)

Unique Capabilities

Android Native App: Native mobile wrapper providing app-like experience
Gaming Integration: Full task system with achievements
Maximum Wallet Compatibility: Supports all major wallet types
Most Feature-Complete: Every FarFISH capability in one place

Best For

Android users wanting a native app
Users who want access to all features
Desktop users with browser extension wallets
Those who prefer a comprehensive interface

Base App (baseapp.farfish.xyz)

Overview

Optimized variant focused on Base blockchain ecosystem and Coinbase Wallet users.

Platform

Web Only: Desktop and mobile browsers

Key Features

✅ NFT minting (all 16 collectibles)
✅ NFT staking (all lock periods)
✅ Daily chest rewards (Bronze and Silver)
✅ Referral system with dual rewards
✅ Global leaderboard and rankings

Unique Capabilities

Coinbase Wallet Priority: First option in wallet selector
Smart Wallet Support: Optimized for Coinbase Smart Wallet features
Simplified Interface: Focused on core minting and staking features
Enhanced Base Integration: Specialized blockchain features for Base network

Platform Differences (Not Feature Differences)

Authentication: WalletConnect with Coinbase Wallet prioritized
UI Focus: Streamlined interface emphasizing Base ecosystem
Wallet Optimization: ✅ Smart Wallet and traditional EOA support

Same Capabilities as All Apps: NFT minting, staking, daily chests, referrals, leaderboard, Steam integration, games

Best For

Coinbase Wallet users (especially Smart Wallet)
Users focused on minting and staking only
Base blockchain enthusiasts
Those who prefer minimalist interfaces

Farcaster Mini App (miniapp.farfish.xyz)

Overview

Native integration with Farcaster social platform, emphasizing social features and verification.

Platform

Farcaster Only: Launches from Farcaster clients (Warpcast, etc.)

Key Features

✅ NFT minting (all 16 collectibles)
✅ NFT staking (all lock periods)
✅ Daily chest rewards (Bronze and Silver)
✅ Referral system with multipliers (1x to 5x based on NFT owned)
✅ Global leaderboard and rankings
✅ Gaming features and task system

Unique Capabilities

Farcaster ID (FID) Identity: Uses your Farcaster account as primary identity
Social Verification Tasks: Earn rewards for Farcaster engagement (follows, likes, recasts, comments)
Embedded Wallet: Auto-connects using Farcaster's built-in wallet
Referral Multipliers: Up to 5x rewards based on NFT rarity
Native Launch: Opens seamlessly within Farcaster apps

Referral Multipliers (Unique Feature)

The Mini App features rarity-based referral multipliers (1x to 5x) based on your NFT holding. For complete multiplier details and mechanics, see Farcaster Mini App Referral System.

Platform Differences (Not Feature Differences)

Authentication: Farcaster FID with embedded wallet (no WalletConnect)
Social Tasks: ✅ Farcaster-specific social verification (follow, like, recast, comment)
Referral System: ✅ Rarity-based multipliers (1x to 5x)
Identity: ✅ FID-based identity system

Same Core Capabilities as All Apps: NFT minting, staking, daily chests, referrals, leaderboard, Steam integration, games

Best For

Active Farcaster users
Users who want social verification features
Those seeking higher referral rewards (multipliers)
Social-first Web3 experience preference

Farcaster-Only Authentication: This app uses Farcaster's embedded wallet exclusively. If you want to use MetaMask or other wallets, choose Web App or Base App instead.

Android App

Overview

Native Android application providing the full Web App experience in an app wrapper.

Platform

Android 9.0 (Pie) and above

Distribution

Direct APK download from farfish.xyz/app-release.apk

Architecture

The Android app uses a native mobile wrapper to load the Web App web interface, giving you 100% feature parity with the web version while adding native app conveniences.

Key Features

✅ All Web App features (NFT minting, staking, chests, referrals)
✅ Native app experience (icon, notifications, app switching)
✅ WalletConnect deep linking for mobile wallets
✅ Seamless wallet interactions
✅ Offline viewing of cached content

Unique Capabilities

Native Mobile Experience: Feels like a traditional mobile app
Deep Link Support: Opens wallet apps directly for signatures
App Updates: Automatic web content updates without reinstalling
Mobile Optimizations: Touch gestures and mobile-friendly UI

Best For

Android users who prefer apps over mobile web
Mobile wallet users (Trust Wallet, Coinbase Mobile, etc.)
Those who want FarFISH on their home screen
Users who value native app performance

Marketing Website (farfish.xyz)

Overview

Public information hub with no blockchain features-purely informational.

Platform

Web Only: All devices and browsers

Content

Project overview and value proposition
App download links (Android APK)
Documentation portal (this site)
Privacy policy and terms of service
Contact information

Key Features

ℹ️ No wallet connection required
ℹ️ No blockchain integration
ℹ️ Static content for fast loading
ℹ️ SEO-optimized for discoverability

Best For

New visitors exploring FarFISH
Users seeking documentation
Android APK download
Privacy policy and legal information

iOS App (Planned)

Overview

Native iPhone and iPad application-currently under development.

Coming Soon: The iOS application is planned for future release. It is not currently available on the App Store or TestFlight.

Planned Features

✅ All Web App features (NFT minting, staking, chests, referrals)
✅ Native iOS experience with platform-specific optimizations
✅ WalletConnect integration for mobile wallets
✅ App Store distribution
✅ iOS-specific security and permissions

Planned Architecture

Similar to the Android app, the iOS version will likely wrap the Web App web interface while adding iOS-native conveniences.

Timeline

Development is in progress. Release date to be announced.

Best For (When Released)

iPhone and iPad users
Apple ecosystem users
iOS-native mobile wallet users

Cross-App Workflows

How Data Syncs Across Apps

When you perform actions in any app, your data updates automatically across the entire ecosystem:

Example: Mint NFT in Base App → Stake in Web App

Connect wallet to Base App (baseapp.farfish.xyz)
Mint an NFT → Blockchain records ownership
Open Web App (app.farfish.xyz) with same wallet
Your minted NFT appears immediately
Stake the NFT in Web App → Works seamlessly

Example: Share Referral Anywhere → Earn Everywhere

text

1. Generate referral link in any FarFISH app
2. Share anywhere - social media, messaging, IRL
3. Friend joins through any app using your link
4. Both receive rewards - 20 FRH instantly (or more with multipliers)
5. Check progress anywhere - referral count syncs everywhere

Your referral code is the same in all apps because it's derived from your wallet address.

What Syncs Automatically

✅ Leaderboard scores and rankings
✅ Referral counts and relationships
✅ NFT ownership (blockchain-based)
✅ Staking positions (blockchain-based)
✅ Token balances (blockchain-based)
✅ Daily chest claim cooldowns
✅ Task completion status
✅ Streak counters

Entry Points for Different User Types

New to Web3

Recommended: Base App (baseapp.farfish.xyz)
Why: Coinbase Wallet's Smart Wallet reduces friction for beginners with simplified transactions.

Experienced DeFi User

Recommended: Web App (app.farfish.xyz)
Why: Full feature access, maximum wallet compatibility, all gaming features.

Farcaster Power User

Recommended: Farcaster Mini App (miniapp.farfish.xyz)
Why: Native Farcaster integration, social verification, referral multipliers.

Mobile-First User (Android)

Recommended: Android App (download from farfish.xyz)
Why: Native app experience, home screen icon, WalletConnect deep linking.

Mobile-First User (iOS)

Recommended: Web App web interface (app.farfish.xyz) until iOS app releases
Why: Mobile-optimized web interface works on all iOS browsers.

Collectors & Stakers

Recommended: Any app based on your preferred wallet
Why: All apps have full NFT minting and staking capabilities.

Choosing Your Entry Point

You can use multiple apps interchangeably:

Try different apps and see which interface you prefer
Switch anytime without losing progress
Use specific apps for specific contexts (Farcaster Mini App when on Farcaster, Android app on mobile, Base App with Coinbase Wallet, etc.)

No commitment required. All apps access the same account, so you can freely experiment and switch between them based on your needs.

Ready to get started? Choose your app and connect your wallet:

Web App - Full features, web + Android
Base App - Coinbase Wallet optimized
Farcaster Mini App - Social-first experience
Android App Download - Native mobile

Last updated: October 12, 2026