farcaster

Build Farcaster Mini Apps, Neynar API integrations, and transaction frames on OP Mainnet.

6|20|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/andresdefi/cryptoskills --skill farcaster-andresdefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: farcaster
Source: https://github.com/andresdefi/cryptoskills/tree/main/skills/farcaster
Command: npx skills add https://github.com/andresdefi/cryptoskills --skill farcaster-andresdefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents frequently produce outdated or incorrect Farcaster code — mixing up Frames v1 and v2 APIs, using Unix instead of Farcaster epoch timestamps, hallucinating registry contract addresses, or mishandling webhook signature verification — leading to silent failures and broken Mini Apps. ## Core Features & Use Cases - Frames v2 Mini Apps: Build full-screen interactive apps with the @farcaster/frame-sdk, including manifest setup, meta tags, SDK actions, and wallet-based transaction frames via viem or wagmi. - Neynar API Integration: Fetch users, casts, feeds, and channels, publish casts, and manage signers using the @neynar/nodejs-sdk v3 client with correct Configuration-based setup. - Webhook Handling: Implement HMAC-SHA512 verified Neynar webhook listeners using raw request bodies and timing-safe comparison. - Onchain Registry Access: Interact with IdRegistry, KeyRegistry, and StorageRegistry contracts on OP Mainnet using verified contract addresses and cast commands. - Use Case: A developer asks the agent to build a Farcaster Mini App that lets users mint an NFT — the skill provides the manifest structure, SDK initialization, wallet provider setup, and transaction code, while avoiding the domain-mismatch silent failure. ## Quick Start Use the farcaster skill to create a Mini App with a manifest, frame meta tags, and SDK initialization that displays the current user's profile.

Frequently Asked Questions about farcaster

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Farcaster Mini App with Frames v2?

Create a manifest at /.well-known/farcaster.json with accountAssociation and frame metadata, add an fc:frame meta tag to your HTML, then initialize @farcaster/frame-sdk and call sdk.actions.ready() after loading the user context.

How do I verify Neynar webhook signatures in Node.js?

Compute HMAC-SHA512 over the raw request body using your webhook secret and compare it to the X-Neynar-Signature header with crypto.timingSafeEqual. Use express.raw() on the webhook route so the body is never parsed before verification.

What is the difference between Frames v1 and Frames v2?

Frames v1 used static OG images with action buttons and server-side rendering. Frames v2 (Mini Apps) are full-screen interactive web applications loaded in an iframe with SDK access to wallet, user context, and notifications — the APIs are not interchangeable.

Why does my Farcaster Mini App fail to load in Warpcast silently?

The domain in the accountAssociation payload must exactly match the FQDN hosting /.well-known/farcaster.json — no protocol prefix, trailing slash, or port. A mismatch causes silent failure with no error surfaced to the developer.

Why are my Farcaster timestamps showing dates in the 1970s?

Farcaster uses a custom epoch of January 1, 2021 00:00:00 UTC, not Unix epoch. Convert by adding 1609459200 to the Farcaster timestamp before creating a JavaScript Date.

What is the cast text length limit on Farcaster?

Casts are limited to 1024 bytes, not characters. UTF-8 multibyte characters like emoji (4 bytes) and CJK (3 bytes) consume more space, so check Buffer.byteLength(text, 'utf-8') before publishing.