FarFISH Games

FarFISH integrates gaming activities with blockchain rewards, allowing users to earn FRH tokens through gameplay and gaming achievements.

Overview

The FarFISH gaming ecosystem combines blockchain rewards with engaging gameplay across multiple platforms:

Puzzle Games: Cross-platform puzzle games where you earn game coins convertible to real FRH tokens
Multi-Platform Support: Available on Android, iOS, PC, and Mac
Dual Play Modes: Play online or offline on both Android and web versions
In-App Mini-Games: Browser-based games accessible through the /game route
Steam Integration: Connect Steam account to earn rewards for gaming milestones
Play-to-Earn: Convert in-game achievements to real blockchain rewards

FarFISH Puzzle Games represent a major expansion of the gaming ecosystem, bringing professional-quality puzzle games with real crypto rewards to mobile and desktop platforms.

FarFISH Puzzle Games

Professional puzzle games with blockchain rewards integration. No crypto wallet required - just sign in with Google and start playing!

Simple Sign-In:

✅ Login with Google account (Gmail)
✅ No crypto wallet needed
✅ No blockchain knowledge required
✅ Play immediately after sign-in
✅ Perfect for non-crypto users

Account Management:

Google account = Your gaming identity
Progress tied to your Gmail
Easy account recovery
Secure authentication
Cross-device login

Unlike other FarFISH apps that require wallet connection, Puzzle Games use simple Google login. This makes it accessible to everyone, even if you've never used crypto before!

FRH Withdrawal Options

When you're ready to withdraw your earned FRH tokens:

Option 1: Link Wallet Later:

Play and earn coins first
Link crypto wallet when ready to withdraw
Convert coins to FRH
Transfer FRH to your wallet

Option 2: Stay In-Game:

Keep coins in gaming account
Use for in-game purchases
Compete in tournaments
No wallet needed if staying in-game

You can play and earn game coins indefinitely with just Google login. Crypto wallet is only needed when you want to withdraw FRH tokens to the blockchain.

Platform Availability

Mobile:

✅ Android: Native Android app (primary launch platform)
🔜 iOS: Coming soon for iPhone and iPad

Desktop:

✅ Windows PC: Full desktop experience
✅ Mac: Native macOS support

Web:

✅ Web Browser: Play directly in your browser
✅ Progressive Web App: Install as standalone app

Play Modes

Online Mode:

Real-time leaderboard updates
Instant reward synchronization
Social features and competitions
Cross-device progress sync
Multiplayer challenges (future)

Offline Mode:

Play without internet connection
Progress saved locally
Automatic sync when reconnected
No interruption to gameplay
Perfect for commutes and travel

Both Android and Web versions support online and offline gameplay. Your progress automatically syncs across all devices when online.

Game Coins to FRH Conversion

Earn game coins through puzzle completion and convert them to real FRH tokens:

Earning Game Coins:

Complete puzzles to earn coins
Higher difficulty = more coins
Daily bonuses and streaks
Special event multipliers
Achievement rewards
No wallet needed to earn

Conversion System:

Fixed exchange rate: Game Coins → FRH
Convert anytime in-game
Link wallet to withdraw FRH
Instant conversion available
Minimum conversion threshold
Transaction history tracking

Withdrawal Options:

Keep coins in-game (no wallet needed)
Link wallet when ready to withdraw
Transfer FRH to your crypto wallet
Use FRH in other FarFISH apps

Reward Structure:

Easy Puzzles: Lower coin rewards
Medium Puzzles: Moderate coin rewards
Hard Puzzles: High coin rewards
Expert Puzzles: Maximum coin rewards
Perfect Completion Bonus: Extra coins

Puzzle Game Features

Game Mechanics:

Multiple puzzle types and difficulty levels
Progressive difficulty system
Hint system for challenging puzzles
Timer-based challenges
Daily puzzle challenges

Progression System:

Level-based unlocks
Achievement badges
Skill rating system
Completion statistics
Personal best tracking

Social Features:

Global leaderboards
Friend competitions
Share achievements
Community challenges
Weekly tournaments

Cross-Platform Experience

Your puzzle game progress syncs seamlessly:

Unified Account:

Google account links to gaming profile
Progress syncs automatically across devices
Game coins accessible everywhere
Achievements unlock cross-platform
Optional wallet linking for withdrawals

Device Switching:

Start puzzle on Android → finish on PC
Coins earned on web → spend on mobile
Seamless experience across devices
No manual sync required

Getting Started with Puzzle Games

Quick Start (No Crypto Required)

Download or Access Game:
- Android: Download APK from farfish.xyz
- Web: Visit puzzle game URL
- PC/Mac: Download desktop version
Sign In with Google:
- Click "Login with Google"
- Choose your Gmail account
- Grant basic permissions
- Start playing immediately!
Play & Earn:
- Complete puzzles to earn game coins
- Build your score and ranking
- Unlock achievements
- Compete on leaderboards
Optional: Link Wallet (For Withdrawals):
- Go to Profile settings
- Click "Link Wallet"
- Connect MetaMask or Coinbase Wallet
- Now you can withdraw FRH tokens

You can play for days, weeks, or months with just Google login. Only link a wallet when you're ready to withdraw your earned FRH to use in other FarFISH apps or trade.

Puzzle Games vs Other FarFISH Apps

Key Differences

Puzzle Games:

✅ Google login only (no wallet required)
✅ Anyone can play immediately
✅ Earn game coins through gameplay
✅ Optional wallet linking for withdrawals
✅ Beginner-friendly onboarding

Other FarFISH Apps (Web, Base, Farcaster):

🔐 Crypto wallet connection required
🔐 Base blockchain interaction
🔐 NFT minting and staking
🔐 Direct FRH token operations
🔐 Requires crypto knowledge

Puzzle Games are designed to onboard non-crypto users into the FarFISH ecosystem. Start gaming with Google, learn about crypto rewards naturally, then explore other FarFISH features when ready.

Current Games

Fishing Game

A simple daily activity game available at the /game route:

Gameplay:

Cast Line: Click button to catch fish
Score Accumulation: Earn points with each catch
Multiplier System: Score multiplied based on URL parameter
Daily Cooldown: 24-hour cooldown between fishing sessions
Visual Feedback: Fish animation on successful catch

Rewards:

Cooldown-based reward system
Contributes to overall FarFISH progress
Tracks completion status

Access:

Navigate to /game in Web App or Farcaster Mini App
Available in web browser and Android app
No NFT ownership required

The fishing game is a foundational mini-game. Additional browser-based games with more complex mechanics are planned for future updates.

Steam Integration

Connect your Steam account to unlock gaming rewards throughout the FarFISH ecosystem.

How Steam Integration Works

Setup:

Navigate to Profile page in FarFISH app
Find Steam integration section
Connect your Steam account
Authorize FarFISH to access Steam data

Verification:

Server-side verification of Steam account
Secure API integration
No sharing of sensitive Steam credentials
One-time authorization process

Gaming Tasks

Complete gaming milestones to earn rewards:

Task Types:

Achievement Verification: Specific game achievements unlocked
Playtime Tracking: Hours played in supported games
Game Ownership: Owning specific games in Steam library
Milestone Completion: Reaching specific in-game progress markers

Reward Distribution:

Tasks verified server-side for security
FRH tokens awarded on successful verification
Progress tracked in user profile
Completion status visible in task list

Task Progress Tracking

Monitor your gaming task progress:

Task Status API: Real-time completion status for all tasks
Progress Display: Visual indicators in profile
Completion History: Record of completed tasks
Reward Summary: Total FRH earned through gaming

How Gaming Rewards Work

Verification Process

User Action: Complete gaming task (in Steam or in-app game)
Task Completion: Task marked complete in FarFISH
Server Verification: Backend verifies task completion
Reward Credit: FRH tokens credited to user account
Leaderboard Update: Rewards contribute to leaderboard position

Security

All gaming rewards use secure verification:

Server-Side Only: Never client-side validation
Steam API: Official Steam API for verification
Cooldown Protection: Prevents task spamming
Immutable Records: Task completion stored permanently

Reward Integration

Gaming rewards integrate with the broader FarFISH ecosystem:

Leaderboard Impact: Gaming rewards count toward global ranking
Total FRH Balance: Added to your overall token balance
Cross-App Sync: Progress visible in all FarFISH apps
Referral Bonuses: Can be shared with referrals where applicable

Available Platforms

Puzzle Games Platforms

Android App (Primary):

✅ Native Android application
✅ Online and offline play modes
✅ Full puzzle game features
✅ Optimized touch controls
✅ Push notifications for events
✅ Background sync

Web Browser:

✅ Play in any modern browser
✅ Online and offline support (PWA)
✅ No installation required
✅ Keyboard and mouse controls
✅ Responsive design

iOS (Coming Soon):

🔜 Native iPhone and iPad app
🔜 Same features as Android
🔜 Apple App Store distribution

Desktop (PC & Mac):

✅ Windows and macOS support
✅ Full-screen gaming experience
✅ Keyboard shortcuts
✅ High-performance rendering

Other FarFISH Gaming Platforms

Web App:

✅ Full Steam integration
✅ In-app fishing game
✅ Task progress tracking
✅ Gaming achievements display

Farcaster Mini App:

✅ Full Steam integration
✅ In-app fishing game
✅ Task verification
✅ Social sharing of achievements

Base App:

✅ Full Steam integration
✅ In-app fishing game
✅ Task progress tracking
✅ Same capabilities as other apps

Community Gaming

Competitive Elements

Gaming in FarFISH includes competitive aspects:

Leaderboard Rankings: Gaming rewards affect global position
Achievement Sharing: Share completed tasks with community
Comparative Stats: See how your gaming compares to others

Connect with other gamers in the FarFISH community:

Shared Progress: Gaming milestones visible to friends
Community Challenges: Group gaming events (future)
Achievement Recognition: Badges and status for gaming accomplishments

Community gaming features are evolving. Future updates will expand social gaming interactions and competitive events.

Future Gaming Expansion

Planned Features

The gaming section is actively expanding with planned additions:

Puzzle Games Expansion:

🔜 iOS version release
New puzzle types and game modes
Tournament system with prizes
Clan/team competitions
Seasonal events and challenges
Special limited-time puzzles

Additional Mini-Games:

More browser-based games with varied mechanics
Different game genres (strategy, arcade, card games)
Progressive difficulty and achievement systems
Multiplayer gaming options

Extended Steam Integration:

More supported games for task verification
Deeper integration with Steam achievements
Steam Community features
Gaming leaderboards specific to titles

Gaming Tournaments:

Scheduled competitive events
Tournament brackets and rankings
Special rewards for tournament winners
Community voting on featured games

Cross-Platform Gaming:

Integration with other gaming platforms beyond Steam
Console gaming support where feasible
Mobile game integrations
Esports platform connections

These are planned features under consideration. Implementation timeline and specific features may change based on development priorities and community feedback.

Best Practices

Maximizing Gaming Rewards

Puzzle Games Strategy:

Play daily for streak bonuses
Focus on higher difficulty puzzles for more coins
Complete achievements for bonus rewards
Participate in weekend tournaments
Convert coins regularly to secure FRH earnings
Use offline mode during commutes to maximize play time

Other Gaming Strategy:

Complete daily fishing game for consistent rewards
Connect Steam account early to access all tasks
Focus on achievable tasks first
Monitor task progress regularly
Claim completed tasks promptly

Efficiency Tips:

Prioritize high-reward puzzles and tasks
Play offline when internet is unstable
Sync across devices to maximize playtime
Complete daily challenges before weekly reset
Track completion status to avoid duplicate efforts

Avoiding Issues

Common Mistakes:

❌ Attempting to manipulate task verification (will fail, server-side validation)
❌ Using multiple accounts (violates terms)
❌ Sharing Steam credentials (never required or requested)
❌ Forgetting to claim completed tasks

Best Approach:

✅ Honest gameplay and verification
✅ Single account per user
✅ Official Steam API authorization only
✅ Regular task completion checks

Technical Details

Gaming APIs

FarFISH gaming uses these API endpoints:

/api/steam/verify - Verify Steam account and tasks
/api/steam/task-status - Get current task completion status
/api/steam/task/complete - Mark task complete
/api/steam/progress - Retrieve overall gaming progress
/api/steam/migrate-fishing - One-time fishing data migration

Task Storage

Gaming task data is stored:

Server-Side: All task completion in backend database
Fast Access: Optimized data layer for task status queries
Immutable Records: Completed tasks cannot be reversed
Cross-App Sync: Progress synchronized across all FarFISH apps

Integration Security

Gaming integrations use secure methods:

Official APIs: Only official Steam API (never screen scraping)
OAuth: Secure authorization for Steam account access
Server Verification: No client-side trust of task completion
Cooldown Protection: Rate limiting prevents abuse

Who Should Use Gaming Features

Gaming features are ideal for:

Non-Crypto Users: Want to play games without learning about wallets first
Google Account Holders: Easy login with existing Gmail
Puzzle Enthusiasts: Love solving puzzles and brain teasers
Mobile Gamers: Enjoy gaming on Android or iOS devices
Commuters: Want offline games for travel time
Play-to-Earn Players: Want to earn crypto through gameplay (wallet optional)
Cross-Platform Gamers: Play on multiple devices
Crypto Curious: Want to learn about blockchain rewards through gaming
Steam Users: Already play games on Steam platform (requires wallet)
Achievement Hunters: Enjoy unlocking achievements and milestones
Casual Gamers: Want simple browser-based games
Reward Seekers: Looking for additional ways to earn FRH tokens
Competitive Players: Enjoy leaderboard competition

Web App - Full gaming feature access
Farcaster Mini App - Gaming with social features
Profile Guide - Track gaming progress
Rewards System - Understand reward mechanics