🔮 Internal Planning Document

Banger → X

Expanding social betting from Farcaster to Twitter, with unified identity and cross-platform wagering.

🟣
Farcaster ✓ Live
Twitter / X Expanding

Why Expand to X?

Farcaster is our home, but X is where the volume lives. Here's the case for expansion.

📊

100x User Base

X has ~500M monthly active users vs Farcaster's ~500K. Even a small percentage means massive growth potential.

🔥

Viral Content Hub

CT (Crypto Twitter) is where narratives form and spread. Betting on tweets = betting on culture.

💰

Deeper Pockets

More whales, more degens, more action. Higher volume = more fees = sustainable growth.

🌉

Cross-Platform Network Effects

Users on both platforms can link accounts. One vault, two betting arenas.

Identity System

The core challenge: linking users across platforms while maintaining a single vault per person.

Farcaster User

FID: 12345

↓ OAuth in WebApp ↓

Identity Registry

On-chain mapping

↓ Resolves to ↓

Single Vault

0x1234...abcd

🔐

OAuth Verification

Users log into the webapp with Twitter. This is the source of truth for identity verification.

👛

Wallet Connection

Users input their wallet address in the app. We store the link between social identity and address.

⛓️

On-Chain Registry

An on-chain mapping enables cross-platform resolution. FC user betting on Twitter user? Registry resolves it.

Technical Architecture

How the pieces fit together across platforms.

Component Farcaster Twitter Notes
Bot Interface ✓ Neynar + Twitter API Separate bots, shared backend
User Vaults ✓ Existing ✓ Same vaults One vault per user, cross-platform
Identity Resolution ✓ FID + Twitter ID Registry maps both to wallet
Bet Targets ✓ Casts + Tweets New content type for tweets
Settlement ✓ Likes/RTs + Engagement Oracle for Twitter metrics
WebApp ✓ FC Auth + Twitter OAuth Both auth methods supported

Key Architectural Decisions

Betting Scenarios

How different user combinations are handled.

Simple

Same Platform Betting

FC User bets on FC Cast

Works exactly as today. Social identity routing handles everything.

Simple

Twitter Native

Twitter User bets on Tweet

New flow, same logic. Twitter bot handles it like FC bot does.

Cross-Platform

FC → Twitter (Linked)

FC User linked account uses Twitter bot

User linked both accounts in webapp. Same vault accessible from either platform.

Edge Case

FC User → Twitter Target (Unlinked)

FC User bets on Twitter user (no link)

Uses raw address functions. Both parties need wallets connected. Falls back to address-based resolution.

Accepted Edge

Unlinked User Creates Two Vaults

FC Identity + Twitter Identity 2 separate vaults

Possible but unlikely. User would have to intentionally fund two different wallets. Accept this edge case.

Implementation Roadmap

Phased approach to minimize risk and enable incremental rollout.

Phase 1: Foundation

Identity Registry & WebApp Auth

• Deploy on-chain identity registry contract
• Add Twitter OAuth to webapp
• Build wallet connection flow
• Create identity linking UI

Phase 2: Twitter Bot

Bot Development & Testing

• Build Twitter bot using same architecture as FC bot
• Implement tweet parsing and bet detection
• Connect to shared executor backend
• Internal testing with team accounts

Phase 3: Settlement

Twitter Metrics Oracle

• Build/integrate Twitter engagement oracle
• Handle likes, retweets, reply counts
• Test settlement accuracy
• Handle edge cases (deleted tweets, protected accounts)

Phase 4: Launch

Rollout & Cross-Platform

• Beta launch with trusted users
• Enable cross-platform betting
• Marketing push on CT
• Monitor and iterate

Risks & Mitigations

What could go wrong and how we handle it.

🚫

Twitter API Access

Twitter API is expensive and they can revoke access. Mitigation: Keep FC as primary, treat X as growth channel.

🤖

Bot Accounts Getting Banned

Twitter actively bans bot accounts. Mitigation: Rate limiting, human-like behavior, multiple backup accounts.

🔗

Identity Linking Friction

Users might not bother linking accounts. Mitigation: Clear incentives, seamless UX, works without linking.

📉

Oracle Reliability

Twitter metrics can be gamed or delayed. Mitigation: Multiple data sources, dispute period, conservative settlement.

TL;DR

The Plan

Questions? Let's discuss.