Integrated Farcaster into Five Star across four areas: Social, Identity, Discovery, and Trust. This enables Farcaster-only accounts, social feeds from Farcaster follows, trust signals, and discovery features.

Social Feed Integration

• Added "Following" filter to the main feed page

• Feed shows reviews from Farcaster follows

• Falls back to Five Star follows if Farcaster data is unavailable

• Empty state with "Invite Friends via Cast" button that opens Farcaster compose with pre-filled text

Farcaster Profile Display

• Review cards show Farcaster username, avatar, and badge

• Profiles display Farcaster identity when linked

• Asynchronous profile loading to avoid blocking UI

Backend Endpoints

• GET /api/farcaster/follows/:fid - Get user's Farcaster follows (with caching)

• GET /api/farcaster/social-feed/:fid - Get reviews from follows

• POST /api/farcaster/link - Link Farcaster account to wallet

• GET /api/farcaster/user/:fid - Get Farcaster user profile

Database Changes

• Added reviewer_fid column to reviews table

• Created user_farcaster_links table for FID-to-wallet mapping

• Caches follows data to reduce API calls

Profile Page Integration

• Farcaster username, avatar, and bio display on profiles

• Farcaster verification badge ( Farcaster)

• Uses Farcaster avatar when available, falls back to gradient

• Shows mutual Farcaster follows count

Account Linking Flow

• Link/unlink buttons on profile pages (own profile)

• Link/unlink in profile edit modal

• Backend endpoints for linking and unlinking

• Wallet verification before unlinking

Farcaster-Only Accounts

• Reviews work with FID only (no wallet required)

• Updated review flows:

  • NFT detail page

  • Starter pack page

  • Collection detail page

• Backend accepts reviews with either reviewerAddress or reviewerFid

Profile Enrichment

• Auto-pulls Farcaster profile data (username, avatar, bio, display name)

• Syncs when:

  • Account is linked

  • Review is submitted with FID

  • Profile is fetched (if stale)

• Background updates don't block UI

Backend Endpoints

• GET /api/farcaster/user-by-wallet/:address - Get Farcaster profile by wallet

• DELETE /api/farcaster/link/:fid - Unlink Farcaster account

Farcaster Users Discovery

• "Active Farcaster Users" section on discovery page

• Shows Farcaster users with reviews, sorted by activity

• Displays username, avatar, review count, and average rating

Social Discovery

• "People You Follow on Farcaster Also Reviewed" section

• Shows reviews from Farcaster follows

• Only appears if you have Farcaster follows

Farcaster Trending

• "Trending from Farcaster" section

• Shows recent reviews from Farcaster users (last 7 days)

• Highlights trending content from the Farcaster community

Follow Recommendations

• "Farcaster Users to Follow" section

• Recommends active Farcaster users based on review activity

• Excludes users you already follow

• Includes "View on Farcaster" button

Popular Collections

• "Collections Popular with Farcaster Users" section

• Shows collections with most reviews from Farcaster users

• Displays average rating, review count, and reviewer count

Backend Endpoints

• GET /api/farcaster/discovery/active-users - Active Farcaster users

• GET /api/farcaster/discovery/trending-reviews - Trending reviews from Farcaster users

• GET /api/farcaster/discovery/follow-recommendations/:fid - User follow recommendations

• GET /api/farcaster/discovery/social-reviews/:fid - Reviews from Farcaster follows

• GET /api/farcaster/discovery/popular-collections - Collections popular with Farcaster users

Farcaster Verification Badges

• Farcaster badge () on profiles and reviews

• Displays when user has linked Farcaster account

• Integrated with existing profile display

Social Proof Display

• Mutual follows count on profiles

• Shared reviews count between users

• Shared collections count

• Trust level indicators (High/Medium/Low/None)

• Only shows when viewing other users' profiles

Farcaster Reputation Integration

• Trust score calculation using multiple signals:

  • Account age (older accounts = more trusted)

  • Profile completeness (username, display name, bio, pfp)

  • Review activity on Five Star

  • Wallet linkage status

• Score ranges from 0-100

Trust Scores

• Combined Five Star + Farcaster trust signals

• Weighted scoring system:

  • Established account: 10 points (365+ days) or 5 points (180+ days)

  • Complete profile: 5 points (75%+ complete)

  • Active reviewer: 15 points (10+ reviews) or 10 points (5+ reviews)

  • Linked wallet: 10 points

• Displayed on profiles with color coding:

  • Green (70+): High trust

  • Yellow (40-69): Medium trust

  • Gray (<40): Low trust

Trust Indicators

• Profile pages: Trust score, signals, and social proof

• Social proof: Mutual connections and shared activity

• Trust level badges: High/Medium/Low based on combined signals

Backend Endpoints

• GET /api/farcaster/trust/score/:fid - Calculate trust score for a Farcaster user

• GET /api/farcaster/trust/social-proof/:fid1/:fid2 - Get social proof between two users

Migration 005: Farcaster Support

-- Added reviewer_fid column to reviews table
ALTER TABLE reviews ADD COLUMN IF NOT EXISTS reviewer_fid INTEGER;

-- Created user_farcaster_links table
CREATE TABLE user_farcaster_links (
    id VARCHAR(255) PRIMARY KEY,
    fid INTEGER UNIQUE NOT NULL,
    wallet_address VARCHAR(255),
    username VARCHAR(255),
    display_name VARCHAR(255),
    pfp_url TEXT,
    bio TEXT,
    follows_cache JSONB,
    follows_cache_updated_at BIGINT,
    created_at BIGINT NOT NULL,
    updated_at BIGINT NOT NULL
);

• Neynar API: Used for fetching Farcaster social graph data (follows, user profiles, mutual follows)

• Caching: Follows data cached for 1 hour to reduce API calls

• Error Handling: Graceful fallbacks when Farcaster data unavailable

• Increased backend rate limit from 500 to 1000 GET requests per 15 minutes

• Staggered component loading (500ms - 4s delays)

• Reduced concurrent requests to 1

• Increased request delay to 500ms

• Extended cache TTL to 2 minutes

• Disabled trust score calls in review cards (shown on profiles instead)

Problem: Too many API calls on page load causing 429 errors

Solution:

• Staggered component loading with delays

• Increased backend rate limits

• Better request throttling and caching

• Disabled non-critical API calls in review cards

Problem: Need to support reviews without wallet addresses

Solution:

• Modified review submission to accept either reviewerAddress or reviewerFid

• Updated all review flows (NFT detail, collection, starter pack)

• Backend handles both wallet and FID-based reviews

Problem: Need to keep Farcaster profile data fresh without blocking UI

Solution:

• Background profile updates when reviews submitted

• Stale data detection (updates if profile older than threshold)

• Async loading with fallbacks

Social feed from Farcaster follows
Farcaster profile display on reviews and profiles
Account linking/unlinking flow
Farcaster-only reviews (no wallet required)
Discovery of Farcaster users and trending content
Trust scores combining Five Star + Farcaster signals
Social proof indicators (mutual follows, shared activity)
Works for both wallet-linked and Farcaster-only accounts

• Monitor rate limit usage and adjust as needed

• Add more trust signals (e.g., Farcaster follower count when available)

• Optimize discovery algorithms based on usage

• Consider adding Farcaster notifications/activity feed

• Explore Farcaster channel integration for discovery

Backend:

• server/api.js - Added Farcaster endpoints

• server/migrations/005_add_farcaster_support.sql - Database schema

Frontend:

• backend-api.js - Added Farcaster API methods

• profile.js - Farcaster identity display

• feed-page.js - Social feed integration

• discovery-page.js - Farcaster discovery features

• components/review-card.js - Farcaster profile display

• components/profile-edit.js - Account linking UI

• nft-detail.js, collection-detail.js, starterpack-page.js - Farcaster-only reviews

New Features:

• Full Farcaster social graph integration

• Trust scoring system

• Discovery features

• Account linking flow

This integration makes Five Star a more social platform while maintaining support for wallet-only users. The trust system helps users identify credible reviewers, and discovery features help find interesting content and users in the Farcaster community.

Integrated Farcaster into Five Star across four areas: Social, Identity, Discovery, and Trust. This enables Farcaster-only accounts, social feeds from Farcaster follows, trust signals, and discovery features.

Social Feed Integration

• Added "Following" filter to the main feed page

• Feed shows reviews from Farcaster follows

• Falls back to Five Star follows if Farcaster data is unavailable

• Empty state with "Invite Friends via Cast" button that opens Farcaster compose with pre-filled text

Farcaster Profile Display

• Review cards show Farcaster username, avatar, and badge

• Profiles display Farcaster identity when linked

• Asynchronous profile loading to avoid blocking UI

Backend Endpoints

• GET /api/farcaster/follows/:fid - Get user's Farcaster follows (with caching)

• GET /api/farcaster/social-feed/:fid - Get reviews from follows

• POST /api/farcaster/link - Link Farcaster account to wallet

• GET /api/farcaster/user/:fid - Get Farcaster user profile

Database Changes

• Added reviewer_fid column to reviews table

• Created user_farcaster_links table for FID-to-wallet mapping

• Caches follows data to reduce API calls

Profile Page Integration

• Farcaster username, avatar, and bio display on profiles

• Farcaster verification badge ( Farcaster)

• Uses Farcaster avatar when available, falls back to gradient

• Shows mutual Farcaster follows count

Account Linking Flow

• Link/unlink buttons on profile pages (own profile)

• Link/unlink in profile edit modal

• Backend endpoints for linking and unlinking

• Wallet verification before unlinking

Farcaster-Only Accounts

• Reviews work with FID only (no wallet required)

• Updated review flows:

  • NFT detail page

  • Starter pack page

  • Collection detail page

• Backend accepts reviews with either reviewerAddress or reviewerFid

Profile Enrichment

• Auto-pulls Farcaster profile data (username, avatar, bio, display name)

• Syncs when:

  • Account is linked

  • Review is submitted with FID

  • Profile is fetched (if stale)

• Background updates don't block UI

Backend Endpoints

• GET /api/farcaster/user-by-wallet/:address - Get Farcaster profile by wallet

• DELETE /api/farcaster/link/:fid - Unlink Farcaster account

Farcaster Users Discovery

• "Active Farcaster Users" section on discovery page

• Shows Farcaster users with reviews, sorted by activity

• Displays username, avatar, review count, and average rating

Social Discovery

• "People You Follow on Farcaster Also Reviewed" section

• Shows reviews from Farcaster follows

• Only appears if you have Farcaster follows

Farcaster Trending

• "Trending from Farcaster" section

• Shows recent reviews from Farcaster users (last 7 days)

• Highlights trending content from the Farcaster community

Follow Recommendations

• "Farcaster Users to Follow" section

• Recommends active Farcaster users based on review activity

• Excludes users you already follow

• Includes "View on Farcaster" button

Popular Collections

• "Collections Popular with Farcaster Users" section

• Shows collections with most reviews from Farcaster users

• Displays average rating, review count, and reviewer count

Backend Endpoints

• GET /api/farcaster/discovery/active-users - Active Farcaster users

• GET /api/farcaster/discovery/trending-reviews - Trending reviews from Farcaster users

• GET /api/farcaster/discovery/follow-recommendations/:fid - User follow recommendations

• GET /api/farcaster/discovery/social-reviews/:fid - Reviews from Farcaster follows

• GET /api/farcaster/discovery/popular-collections - Collections popular with Farcaster users

Farcaster Verification Badges

• Farcaster badge () on profiles and reviews

• Displays when user has linked Farcaster account

• Integrated with existing profile display

Social Proof Display

• Mutual follows count on profiles

• Shared reviews count between users

• Shared collections count

• Trust level indicators (High/Medium/Low/None)

• Only shows when viewing other users' profiles

Farcaster Reputation Integration

• Trust score calculation using multiple signals:

  • Account age (older accounts = more trusted)

  • Profile completeness (username, display name, bio, pfp)

  • Review activity on Five Star

  • Wallet linkage status

• Score ranges from 0-100

Trust Scores

• Combined Five Star + Farcaster trust signals

• Weighted scoring system:

  • Established account: 10 points (365+ days) or 5 points (180+ days)

  • Complete profile: 5 points (75%+ complete)

  • Active reviewer: 15 points (10+ reviews) or 10 points (5+ reviews)

  • Linked wallet: 10 points

• Displayed on profiles with color coding:

  • Green (70+): High trust

  • Yellow (40-69): Medium trust

  • Gray (<40): Low trust

Trust Indicators

• Profile pages: Trust score, signals, and social proof

• Social proof: Mutual connections and shared activity

• Trust level badges: High/Medium/Low based on combined signals

Backend Endpoints

• GET /api/farcaster/trust/score/:fid - Calculate trust score for a Farcaster user

• GET /api/farcaster/trust/social-proof/:fid1/:fid2 - Get social proof between two users

Migration 005: Farcaster Support

-- Added reviewer_fid column to reviews table
ALTER TABLE reviews ADD COLUMN IF NOT EXISTS reviewer_fid INTEGER;

-- Created user_farcaster_links table
CREATE TABLE user_farcaster_links (
    id VARCHAR(255) PRIMARY KEY,
    fid INTEGER UNIQUE NOT NULL,
    wallet_address VARCHAR(255),
    username VARCHAR(255),
    display_name VARCHAR(255),
    pfp_url TEXT,
    bio TEXT,
    follows_cache JSONB,
    follows_cache_updated_at BIGINT,
    created_at BIGINT NOT NULL,
    updated_at BIGINT NOT NULL
);

• Neynar API: Used for fetching Farcaster social graph data (follows, user profiles, mutual follows)

• Caching: Follows data cached for 1 hour to reduce API calls

• Error Handling: Graceful fallbacks when Farcaster data unavailable

• Increased backend rate limit from 500 to 1000 GET requests per 15 minutes

• Staggered component loading (500ms - 4s delays)

• Reduced concurrent requests to 1

• Increased request delay to 500ms

• Extended cache TTL to 2 minutes

• Disabled trust score calls in review cards (shown on profiles instead)

Problem: Too many API calls on page load causing 429 errors

Solution:

• Staggered component loading with delays

• Increased backend rate limits

• Better request throttling and caching

• Disabled non-critical API calls in review cards

Problem: Need to support reviews without wallet addresses

Solution:

• Modified review submission to accept either reviewerAddress or reviewerFid

• Updated all review flows (NFT detail, collection, starter pack)

• Backend handles both wallet and FID-based reviews

Problem: Need to keep Farcaster profile data fresh without blocking UI

Solution:

• Background profile updates when reviews submitted

• Stale data detection (updates if profile older than threshold)

• Async loading with fallbacks

Social feed from Farcaster follows
Farcaster profile display on reviews and profiles
Account linking/unlinking flow
Farcaster-only reviews (no wallet required)
Discovery of Farcaster users and trending content
Trust scores combining Five Star + Farcaster signals
Social proof indicators (mutual follows, shared activity)
Works for both wallet-linked and Farcaster-only accounts

• Monitor rate limit usage and adjust as needed

• Add more trust signals (e.g., Farcaster follower count when available)

• Optimize discovery algorithms based on usage

• Consider adding Farcaster notifications/activity feed

• Explore Farcaster channel integration for discovery

Backend:

• server/api.js - Added Farcaster endpoints

• server/migrations/005_add_farcaster_support.sql - Database schema

Frontend:

• backend-api.js - Added Farcaster API methods

• profile.js - Farcaster identity display

• feed-page.js - Social feed integration

• discovery-page.js - Farcaster discovery features

• components/review-card.js - Farcaster profile display

• components/profile-edit.js - Account linking UI

• nft-detail.js, collection-detail.js, starterpack-page.js - Farcaster-only reviews

New Features:

• Full Farcaster social graph integration

• Trust scoring system

• Discovery features

• Account linking flow

This integration makes Five Star a more social platform while maintaining support for wallet-only users. The trust system helps users identify credible reviewers, and discovery features help find interesting content and users in the Farcaster community.