Skip to content

jdille/vouch

Repository files navigation

Farcaster Daily Attestation Mini App

A Farcaster mini app that prompts users daily to attest whether they've met someone in their network IRL. Creates EAS attestations on Base to build a verified relationship graph.

Setup Instructions

1. Install Dependencies

npm install

2. Set Up Supabase Database

  1. Create a new Supabase project at supabase.com
  2. Go to the SQL Editor in your Supabase dashboard
  3. Copy the contents of supabase/schema.sql and run it in the SQL Editor
  4. Get your Supabase credentials:
    • Project URL: Settings > API > Project URL
    • Anon Key: Settings > API > Project API keys > anon/public
    • Service Role Key: Settings > API > Project API keys > service_role

3. Configure Environment Variables

  1. Copy .env.example to .env.local:

    cp .env.example .env.local
  2. Fill in your environment variables:

    • Supabase: Add your Supabase URL and keys from step 2
    • Neynar: Get an API key from neynar.com
    • Privy: Create an app at privy.io and enable Farcaster login
    • EAS: After creating your schema on Base, add the Schema UID
    • Base RPC: Use https://mainnet.base.org or your preferred RPC

4. Run Development Server

npm run dev

Open http://localhost:3000 to see the app.

Project Structure

├── app/                    # Next.js app directory
│   ├── api/               # API routes
│   └── page.tsx           # Main page
├── components/            # React components
├── lib/                   # Utility libraries
│   ├── db.ts             # Supabase client and database helpers
│   ├── neynar.ts         # Neynar API wrapper
│   ├── eas.ts            # EAS SDK wrapper
│   └── utils.ts          # Helper functions
├── types/                 # TypeScript type definitions
├── supabase/             # Database schema and migrations
└── public/               # Static assets

Next Steps

After completing Step 1 (Database Setup), continue with:

  1. Add Privy auth with Farcaster login
  2. Integrate Neynar API for getting following lists
  3. Implement person selection algorithm
  4. Add EAS attestation creation
  5. Build UI components
  6. Add notification system

See PRD.md for complete product requirements.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •