PyQuest

PyQuest — Decentralized Quest Marketplace on Farcaster

PyQuest is a decentralized quest marketplace built as a Farcaster Mini App on Arbitrum, where anyone can post tasks and hunters earn PYUSD stablecoin rewards for completing them. Unlike traditional freelance platforms that charge 10–20% fees and delay payments for weeks, PyQuest uses smart contract escrow for instant, trustless payments with near-zero fees.

💜 The Farcaster Advantage

By building PyQuest as a Farcaster Mini App, we tap directly into a crypto-native audience of 300k+ daily active users who already understand wallets, tokens, and on-chain transactions. There’s no need to onboard or educate users—they’re already here.

Our bot @zcastsbot posts every new quest directly to Farcaster feeds, turning quest discovery into a native social experience.

⚠️ The Problem

Existing bounty and gig platforms are:

Centralized

High-fee (10–20%)

Slow to pay (weeks of waiting)

Opaque and untrustworthy

They also struggle to find crypto-savvy users who already have wallets and understand tokens.

💡 Our Solution

PyQuest eliminates the middleman by locking rewards in Arbitrum smart contract escrow.

When a creator posts a quest inside the Farcaster Frame, PYUSD funds are escrowed instantly. The quest is then auto-posted by our bot to thousands of Farcaster users.

Once a hunter completes the task and the creator verifies it, ➡️ the smart contract releases payment instantly — no delays, no chargebacks, no 20% cuts.

⚙️ How It Works

1. Quest Creation (Farcaster Frame)

Post a quest for any task—coding, design, research, content, anything. Set a PYUSD reward, and funds are locked in escrow. Our bot @zcastsbot automatically publishes the quest on Farcaster.

1. Discovery (Zero Friction)

Hunters discover new quests directly in their Farcaster feed. No website. No app download. Click → View Quest → Submit Work — all inside Farcaster.

1. Submission

Hunters submit deliverables (GitHub repo, design files, etc.) directly in the PyQuest Frame. Submissions are timestamped and stored for verification.

1. Verification & Payment

Creator reviews → selects winner → Smart contract releases PYUSD instantly to the hunter’s wallet.

1. Social Proof

Bot auto-tags winners in a public Farcaster cast for transparency and social cred. Every transaction is verifiable on Blockscout Explorer.

💎 What Makes PyQuest Unique 🚀 Farcaster Mini App Integration

Built natively inside Farcaster. Users can discover, submit, and get paid — all without leaving their social feed. That’s instant access to 300k+ on-chain users.

📈 Revenue Through Engagement

Every quest = social content. Creators get visibility, hunters get rewards, and PyQuest grows organically — no ads needed.

💵 PYUSD Stablecoin Payments

Rewards are paid in PayPal’s PYUSD (1 PYUSD = $1) — No volatility. No guessing. Just clean, stable earnings.

⚡ Real-Time Leaderboard (Envio HyperSync)

Using Envio HyperSync, PyQuest displays live quest stats — Top hunters, total PYUSD earned, and recent completions — updated in under 1 second with Farcaster profiles attached.

🔍 Instant Transaction Verification (Blockscout SDK)

Blockscout SDK lets users verify transactions inside the Frame — Gas costs, confirmations, contract interactions — all transparent.

📣 Automated Social Distribution

@zcastsbot posts every quest and winner announcement automatically to Farcaster’s 300k+ audience. Users can subscribe for instant quest alerts — no extra app install needed.

🌍 For Everyone, Not Just Devs

Not just a dev playground — Designers, content creators, researchers, translators, community managers — everyone can earn. Farcaster’s audience is broad and creative, not just technical.

🧠 Technical Architecture

PyQuest combines three core sponsor technologies with Farcaster’s native SDKs:

Envio HyperSync: Indexes all on-chain quest events (BountyCreated, BountyCompleted, etc.) with sub-second latency for live leaderboard + analytics.

PYUSD Stablecoin: Ensures price stability and eliminates crypto volatility risk.

Blockscout SDK: Enables instant on-chain verification directly inside the Frame UI.

Stack Summary:

Smart Contracts: Arbitrum L2 (low gas, fast finality)

Database: MongoDB for quest metadata + submissions

Frontend: Farcaster Frame SDK

Bot Layer: Neynar API + @zcastsbot for automation & social reach

🔥 Why Farcaster Mini App?

Built-in Crypto Audience: No onboarding friction — users already have wallets.

Zero-Friction Discovery: Quests appear right in users’ feeds.

Social Trust: Winners are tagged publicly = transparent reputation.

Viral Growth: Quests are inherently social content — creators share, hunters share, winners flex.

Wallet Integration: Seamless payments with connected Farcaster wallets.

🌐 Summary

PyQuest turns task discovery and crypto payments into a social, instant, and transparent experience. By combining Farcaster’s social layer with PYUSD, Arbitrum, and HyperSync, we’re building the Web3 Upwork that actually pays instantly 💸.

yQuest is built as a Farcaster Mini App with a full-stack blockchain architecture combining React frontend, Solidity smart contracts, and serverless APIs—all integrated with sponsor technologies for maximum performance.

Core Architecture

1. Farcaster Mini App (Frame SDK)

The entire PyQuest experience lives inside Farcaster. We built it using the Farcaster Frame SDK which allows users to interact with quests directly in their social feed without leaving the app.

1. Frame Manifest: Defined in farcaster.json with metadata for iconUrl, homeUrl, and webhookUrl Account Association: Used Farcaster's authentication to link wallet addresses with FIDs (Farcaster IDs) Native Notifications: Integrated sdk.actions.addFrame() to let users subscribe to quest alerts In-App Transactions: Users can create quests, submit work, and receive PYUSD all within the Frame interface Why This Matters: Traditional web apps require users to visit external sites. By building as a Frame, we tap into Farcaster's 300k+ crypto-native users who already have wallets connected. Zero friction.

2. Real-Time Indexing (Envio HyperSync) 🏆

This is where things get interesting. Traditional blockchain indexing is SLOW. Fetching quest events via standard RPC calls takes 10-15 seconds because you have to query each block sequentially. HyperSync Benefit: Aggregates all quest events across the entire Arbitrum chain, calculates stats (total quests, volume, unique hunters), and enriches data with Farcaster profiles—all in under 1 second. Our leaderboard updates in real-time because HyperSync is that fast.

1. Without HyperSync, the leaderboard would lag behind by minutes. Users complete quests and want to see their stats immediately. HyperSync makes that possible.

2. Transaction Verification (Blockscout SDK) 🏆

Integrated Blockscout Explorer SDK to provide instant transaction verification without users leaving the Frame.

1. Automated Social Distribution (Neynar API + Bot)

Built @zcastsbot using Neynar API to automatically post quests and tag winners.

Tech Stack:

React 18 with TypeScript for type safety Vite for lightning-fast dev server and builds TailwindCSS for utility-first styling React Router for client-side navigation Key Components:

CreateBounty.tsx - Quest creation form with PYUSD amount input Leaderboard.tsx - Real-time stats powered by HyperSync API MyBounties.tsx - User's created quests + submissions NotificationButton.tsx - Frame SDK integration for push notifications State Management: Used React's built-in useState and useEffect—no need for Redux given the app's size.

1. Backend (Node.js Serverless + MongoDB)

Deployed on Vercel as serverless functions.

API Routes:

/api/hypersync-stats - Fetches leaderboard from HyperSync /api/bounties - CRUD operations for quest metadata /api/post-bounty-cast - Posts quest to Farcaster via Neynar /api/announce-winner - Tags winner on Farcaster Parallel HyperSync Queries: Fetch all event types simultaneously instead of sequentially—3x speedup.

MongoDB Connection Pooling: Global connection caching in serverless environment prevents connection exhaustion.

Neynar Webhook Automation: Used webhook pattern instead of manual notification token management—eliminates custom server code.

Farcaster Profile Enrichment: After fetching hunter addresses from HyperSync, we enrich with Farcaster data (username, avatar, FID) via Neynar API in parallel.

Dynamic API Config: Frontend uses import.meta.env.VITE_API_URL in production, window.location.origin as fallback—works in dev and production without config changes.

Deployment Frontend + Backend: Vercel serverless (static build + API functions) Smart Contracts: Arbitrum Sepolia mainnet Database: MongoDB Domain: pyquest.vercel.app fully decentralized quest marketplace built as a Farcaster Mini App, powered by cutting-edge blockchain indexing (HyperSync), stable crypto payments (PYUSD), and instant transaction verification (Blockscout SDK). Users discover quests in their social feed, complete tasks, and get paid instantly—all without leaving Farcaster. 🎯