skills.rest
naruto11eth
naruto11ethCOMMUNITY
Explore all skills by this author →
Website𝕏@naruto11ethGitHub

farcaster

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

1|1|Updated May 21, 2026
Search Tags:#webhooks#mini apps#neynar#farcaster#frames v2#web3 social#op mainnet
One-click install
npx skills add https://github.com/naruto11eth/cryptoskills --skill farcaster-naruto11eth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: farcaster
Source: https://github.com/naruto11eth/cryptoskills/tree/main/skills/farcaster
Command: npx skills add https://github.com/naruto11eth/cryptoskills --skill farcaster-naruto11eth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @neynar/nodejs-sdk, @farcaster/frame-sdk, @farcaster/frame-wagmi-connector, viem, wagmi, express, and includes references (resource) components.

What problem does it solve? AI agents often have outdated or incorrect knowledge about Farcaster's architecture, such as confusing Frames v1 with Frames v2, treating casts as onchain data, or missing the Neynar acquisition of the protocol. This Skill provides accurate, current guidance for building on Farcaster's social protocol, including Snapchain, the OP Mainnet registry contracts, and the Neynar API. ## Core Features & Use Cases - Frames v2 Mini Apps: Build full-screen interactive web apps with the @farcaster/frame-sdk, including manifest setup, account association, and SDK actions like composeCast and addFrame. - Neynar API Integration: Fetch users, publish casts, query feeds and channels, and verify webhooks with HMAC-SHA512 signature validation over raw request bodies. - Transaction Frames: Trigger onchain transactions from Mini Apps using the EIP-1193 wallet provider with viem or wagmi connectors. - Use Case: A developer wants to launch a Mini App in Warpcast that lets users mint an NFT. This Skill provides the manifest JSON structure, the frame meta tags, the wallet provider setup with viem, and troubleshooting for the silent domain-mismatch failure that commonly breaks Mini App loading. ## Quick Start Ask the agent to scaffold a Farcaster Mini App with a manifest, frame meta tags, and a webhook endpoint verified with Neynar HMAC signatures.

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?▼

Host a manifest at /.well-known/farcaster.json with an accountAssociation proving domain ownership, add an fc:frame meta tag to your HTML, and use @farcaster/frame-sdk to access user context and call sdk.actions.ready(). The domain in the manifest payload must exactly match the hosting FQDN.

How do I verify Neynar webhook signatures?▼

Compute HMAC-SHA512 over the raw request body using your webhook secret and compare it to the X-Neynar-Signature header with crypto.timingSafeEqual. Never parse the JSON before verification, since re-serialization changes the bytes and breaks the signature.

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 two APIs are not compatible.

Why is my Farcaster Mini App not loading in Warpcast?▼

The most common cause is a manifest domain mismatch: the accountAssociation payload domain must byte-match the FQDN hosting /.well-known/farcaster.json, with no protocol prefix or trailing slash. The failure is silent, so decode the base64url payload to verify it.

Are Farcaster casts stored onchain?▼

No. Only FIDs, app keys, and storage units live onchain in registry contracts on OP Mainnet. Casts, reactions, and follows are offchain messages stored on Snapchain, a BFT-based message ordering layer, and never posted to any blockchain.

Why does my cast fail when it is under 1024 characters?▼

The cast limit is 1024 bytes, not characters. Emoji consume 4 bytes and CJK characters 3 bytes in UTF-8, so check length with Buffer.byteLength(text, 'utf-8') before publishing.

Related Skills

Explore More Software Engineering Skills→
shreed27shreed27

farcaster

Interact with the Farcaster protocol via the Neynar API.

Community
Intermediate
polymerdaopolymerdao
1

polymer-pay-neynar

Search Farcaster casts, users, channels, and feeds via the Neynar service.

Official
Intermediate
LuisSambranoLuisSambrano
7

minipay-integration

Develop Mini Apps for MiniPay wallet with viem transaction handling.

Community
Intermediate
PKU-YuanGroupPKU-YuanGroup
288

using-model-endpoint

Infer from a registered model endpoint via its native HTTP API.

Official
Advanced