FarFISH Farcaster Mini App
The FarFISH Farcaster Mini App (miniapp.farfish.xyz) provides native integration with the Farcaster decentralized social protocol, enabling social verification, FID-based identity, and enhanced referral rewards.
What is Farcaster?
Farcaster is a decentralized social protocol built on Ethereum that enables:
- Decentralized Identity: Your Farcaster ID (FID) is owned by you, not a platform
- Cross-Platform Usage: Use your FID across different Farcaster clients
- On-Chain Verification: Social actions can be verified on-chain
- Open Protocol: Anyone can build applications using Farcaster data
The FarFISH Mini App runs natively within Farcaster clients like Warpcast, providing a seamless in-app experience without leaving the social platform.
How the Mini App Works
Launch Within Farcaster
The Mini App is designed to launch directly from Farcaster clients:
- Discovery: Find FarFISH in Farcaster app directory or through shared casts
- Launch Button: Click "Launch" to open the Mini App
- In-App Experience: App opens within Farcaster client (no external browser)
- Splash Screen: Custom FarFISH splash screen appears during load
- Auto-Connect: Wallet automatically connects through Farcaster's embedded wallet
Farcaster Identity Integration
Your Farcaster identity becomes part of your FarFISH profile:
- Primary Identity: Farcaster ID (FID) used alongside wallet address
- Profile Data: Username, display name, and profile picture imported from Farcaster
- Social Graph: Following/follower relationships accessible for verification
- Unified Experience: Same Farcaster identity across all compatible apps
Core Features
The Mini App includes all standard FarFISH features:
NFT Minting
- 16 Unique Tokens: Four rarity tiers across the collection
- Weighted Random Selection: Fair distribution system
- Supply Tracking: Real-time minting progress
See NFT System Guide for rarity tiers and staking rewards.
NFT Staking
- Lock Durations: 30, 90, 180, or 360 days
- Reward Tiers: Based on rarity and lock duration
- Multiple Stakes: Stake multiple NFTs simultaneously
- Claim System: Withdraw after unlock period
Daily Reward Chests
- Bronze: 3 FRH every 24 hours (all users)
- Silver: 6 FRH every 24 hours (requires stake)
For cooldown mechanics and streak tracking, see Daily Rewards Guide.
Leaderboard
- Top 100 Display: Global rankings by rewards
- Social Integration: Farcaster usernames shown when available
- Your Rank: Highlighted position if ranked
- Real-Time Updates: Automatic refresh
Unique Social Features
Social Verification
The Mini App can verify your Farcaster social engagement:
- Follow Verification: Confirm you follow specific accounts
- Cast Engagement: Verify likes, recasts, and replies
- Comment Verification: Confirm participation in discussions
- Reward Eligibility: Social tasks may unlock additional rewards
Social verification happens server-side for security. The app never attempts to verify social actions on the client side.
Rarity-Based Referral Multipliers
The Mini App features an enhanced referral system with multipliers based on NFT rarity:
| NFT Rarity | Token IDs | Multiplier | Referral Reward |
|---|---|---|---|
| Bluefin (Common) | 0-6 | 1x | 20 FRH |
| GoldRay (Rare) | 7-11 | 2x | 40 FRH |
| RedSpike (Epic) | 12-14 | 3x | 60 FRH |
| ShadowGill (Legendary) | 15 | 5x | 100 FRH |
| Other Tokens | - | 1x | Base reward (20 FRH) |
How Multipliers Work:
- Referee signs up using your referral code
- System checks which token you own
- Applies multiplier to your referral reward
- Both parties receive rewards (referee always gets 20 FRH)
Steam Rewards Integration
The Mini App includes Steam gaming integration:
- Steam Account Linking: Connect your Steam account
- Gaming Tasks: Complete specific gaming milestones
- Task Verification: Server-side verification of achievements
- FRH Rewards: Earn tokens through verified gaming activity
- Progress Tracking: Monitor completion status for all tasks
Authentication
Farcaster-First Auth
Unlike other FarFISH apps, the Mini App uses Farcaster as primary authentication:
- App Launch: Automatically authenticated through Farcaster client
- FID Provided: Your Farcaster ID comes from the Mini App context
- Wallet Connection: Farcaster's embedded wallet connects automatically
- Profile Sync: Username and profile picture imported from Farcaster
- No Manual Login: Seamless experience without separate authentication
Security Model
The Mini App follows Farcaster's security best practices:
- ✅ FID from Context: Only uses FID provided by Farcaster client
- ✅ Server-Side Verification: Social actions verified through Farcaster API
- ✅ No Wallet-to-FID Resolution: Never attempts to derive FID from wallet address
- ✅ Secure by Design: Prevents common security vulnerabilities
The Mini App only recognizes your FID when launched from within a Farcaster client. Opening the URL directly in a browser will not provide full Farcaster integration.
Referral System
Farcaster-Optimized Referrals
Sharing referrals through Farcaster is seamless:
- Generate Link: Get your referral link from profile
- Share on Farcaster: Post as a cast or send in DMs
- Friends Click: Opens Mini App with referral attribution
- Auto-Attribution: Referral code captured when friend signs up
- Multiplied Rewards: Earn based on your token multiplier
Viral Mechanics
The Mini App's social integration encourages viral growth:
- In-App Sharing: Share directly from Mini App to Farcaster
- Social Proof: Friends see your FarFISH activity in social feed
- Competitive Leaderboard: Rankings visible to Farcaster community
- Token Incentives: Higher multipliers motivate active sharing
Who Should Use the Mini App
Choose the Farcaster Mini App if you:
- Active on Farcaster: Regularly use Warpcast or other Farcaster clients
- Want Social Features: Value social verification and engagement rewards
- Native Experience: Prefer staying within Farcaster ecosystem
- Higher Referral Rewards: Want to leverage token multipliers
- Gaming Integration: Plan to earn through Steam gaming activities
Comparison with Other Apps
Mini App vs Web App
| Feature | Farcaster Mini App | Web App |
|---|---|---|
| Platform | Embedded in Farcaster | Standalone web + Android |
| Primary Identity | Farcaster ID (FID) | Wallet address |
| Wallet Options | Farcaster embedded wallet | Multiple wallet providers |
| Social Verification | ✅ Full integration | ❌ Not available |
| Referral Multipliers | ✅ Rarity-based (1x-5x) | ❌ Flat 20 FRH |
| Steam Integration | ✅ Full support | ✅ Full support |
| In-App Games | ✅ Available | ✅ Available |
Mini App vs Base App
| Feature | Farcaster Mini App | Base App |
|---|---|---|
| Launch Method | Within Farcaster client | Standalone web |
| Authentication | Farcaster auto-auth | Manual wallet connect |
| Social Features | ✅ Full integration | ❌ Not available |
| Gaming Features | ✅ Full support | ✅ Full support |
| Coinbase Smart Wallet | Uses Farcaster wallet | ✅ Optimized |
Technical Details
Network
- Blockchain: Base Mainnet (Chain ID: 8453)
- RPC Providers: Multiple endpoints for reliability
- Transaction Fees: ~$0.01-0.20 per operation
- Confirmation Speed: ~2-5 seconds
Integration
- Mini App SDK: Official Farcaster Mini App SDK
- Wallet Connector: Farcaster embedded wallet integration
- Social API: Server-side Farcaster data access
- Profile Sync: Automatic username and avatar import
Security
- Non-Custodial: Full asset control retained
- Farcaster Security: Follows Farcaster security model
- Server-Side Verification: Social actions verified securely
- FID-Based: Primary identity from Farcaster context only
Cross-App Compatibility
Your FarFISH account works across all platforms:
Shared Account
- Same Wallet: Use same wallet address across Web App, Base App, and Mini App
- Unified NFTs: NFTs minted in any app appear everywhere
- Shared Leaderboard: Same ranking across all platforms
- Synchronized Progress: Daily streaks and stats sync automatically
Data Sync Examples
- Mint NFT in Web App → Stake in Mini App
- Claim chest in Mini App → See rewards in Base App
- Earn referral in Base App → Rank updates in Mini App
Getting Started
- Open Farcaster: Launch Warpcast or your preferred Farcaster client
- Find FarFISH: Search for FarFISH Mini App or click shared link
- Launch App: Click "Launch" button
- Auto-Connect: Wallet connects automatically through Farcaster
- Start Minting: Begin with NFT minting or daily chest claims
- Share: Use your referral code to earn multiplied rewards
Best Practices
Maximizing Rewards
- Own Multiplier Tokens: Acquire Token 1, 2, or 3 for higher referral rewards
- Share on Farcaster: Cast your referral link to reach more potential referrals
- Verify Social Tasks: Complete Farcaster social verification for bonus rewards
- Link Steam: Connect Steam account for gaming reward opportunities
- Maintain Streaks: Claim daily chests consistently to build streaks
Farcaster Etiquette
- Authentic Sharing: Share genuinely, don't spam referral links
- Helpful Content: Explain FarFISH benefits when sharing
- Community Engagement: Participate in FarFISH community discussions
- Support Others: Help newcomers learn the platform
The Mini App experience is optimized for Farcaster users. For the best experience, always launch from within a Farcaster client rather than accessing the URL directly.
Related Resources
- Web App - Full-featured standalone experience
- Base App - Optimized for Coinbase Wallet
- Farcaster Protocol - Learn about Farcaster
- Getting Started - Setup guide