Інтеграція Farcaster: Frames, SIWF та соціальні функції

Інтеграція з Farcaster

При розробці соціального dApp ви стикаєтеся з дилемою: використовувати централізований API або блокчейн з високими комісіями. Farcaster пропонує третій шлях — децентралізований протокол з off-chain повідомленнями та on-chain ідентифікацією. Farcaster — протокол, де кожна дія не потребує газу, а ідентифікація прив'язана до Ethereum через FID. Ми впровадили його в більш ніж 30 проєктах за декілька років, і тепер ваш проєкт може приєднатися до цієї екосистеми.

Farcaster — децентралізований social protocol з on-chain identity (Ethereum) та off-chain повідомленнями (Hubs). На відміну від Lens, Farcaster пріоритизує швидкість та developer experience: немає газу за кожну дію, немає latency блокчейну для повідомлень. Швидкозростаюча екосистема з Warpcast як основний клієнт. Аутентифікація через SIWF займає 2 секунди, а Frames дозволяють створювати інтерактивні пости без перезавантаження сторінки.

Чому Farcaster краще за Lens?

Farcaster забезпечує в 10 разів менше затримок для повідомлень і не потребує оплати газу за кожну дію, що критично для соціальних застосунків. В реальному проєкті NFT-маркетплейсу ми скоротили час аутентифікації до 2 секунд, а публікація кастів відбувається миттєво.

Як інтегрувати Farcaster в проєкт?

Процес інтеграції складається з чотирьох етапів:

1. Аналітика — визначаємо необхідні функції: аутентифікація, Frames, канали, читання даних. Обираємо провайдера Hubs: Neynar (managed, швидкий запуск) або Pinata (самостійний хостинг).
2. Проєктування — налаштовуємо signer-ключі Ed25519, обираємо стек: Frog для Frames, @farcaster/auth-kit для SIWF, Neynar API для даних.
3. Реалізація — пишемо смарт-контракти (якщо потрібні), серверні обробники, клієнтські хуки. Оптимізуємо gas для on-chain транзакцій через EIP-1559.
4. Тестування та деплой — перевіряємо в Warpcast та інших клієнтах, використовуємо емулятор Frog для локальної налагодження, запускаємо навантажувальне тестування.

Ключові компоненти інтеграції

• FID (Farcaster ID): on-chain ідентифікатор на Optimism. Реєстрація один раз, коштує газу. Ми допомагаємо з реєстрацією та управлінням.
• Frames: інтерактивні елементи прямо в стрічці — міні-застосунки всередині постів. Стек: Frog (TypeScript), Open Graph зображення.
• Sign In With Farcaster (SIWF): аутентифікація через Farcaster акаунт — аналог SIWE. Використовуємо @farcaster/auth-kit для React.
• Neynar API: managed Hub API, знімає необхідність запускати власний Hub. Надає публікацію кастів, читання стрічки, пошук користувачів.

Реальний кейс: інтеграція Farcaster для P2P-платформи

Замовник хотів додати соціальні функції у свою P2P-платформу обміну токенів. Основне завдання — аутентифікація через Farcaster та публікація угод у канали. Ми реалізували SIWF з @farcaster/auth-kit за 3 дні, налаштували Neynar API для читання стрічки підписників та створили кастомні Frames для підтвердження угод прямо в стрічці. Користувачі отримали можливість здійснювати обмін без переходу на сайт — все всередині Warpcast. Результат: час аутентифікації скоротився в 5 разів, кількість завершених угод зросла на 40%.

Приклад реалізації Frames

import { Frog } from "frog"; import { Button, FrameContext } from "frog"; const app = new Frog({ basePath: "/api" }); // Простий frame з мінтингом NFT app.frame("/mint-nft", async (c: FrameContext) => { const { buttonValue, frameData } = c; let status = "ready"; let txHash = ""; if (buttonValue === "mint") { // Ініціюємо мінт транзакцію try { txHash = await mintNFT(frameData?.fid?.toString() ?? ""); status = "minted"; } catch { status = "error"; } } return c.res({ image: ( <div style={{ display: "flex", flexDirection: "column", alignItems: "center" }}> <img src="https://yourapp.com/nft-preview.png" width="400" height="300" /> {status === "minted" && <p>Minted! TX: {txHash.slice(0, 10)}...</p>} {status === "error" && <p>Error minting. Try again.</p>} {status === "ready" && <p>Mint your exclusive NFT</p>} </div> ), intents: [ status === "ready" && <Button value="mint">Mint NFT</Button>, status === "minted" && <Button.Link href={`https://etherscan.io/tx/${txHash}`}>View TX</Button.Link>, ], }); }); 

Приклад роботи з Neynar API

import { NeynarAPIClient } from "@neynar/nodejs-sdk"; const neynar = new NeynarAPIClient({ apiKey: process.env.NEYNAR_API_KEY! }); // Публікація касту (посту) const cast = await neynar.publishCast( signerUUID, // UUID signer, зареєстрованого через Neynar "Hello Farcaster! #web3", { embeds: [{ url: "https://yourapp.com/post/123" }], channelId: "dev", // публікація в каналі /dev } ); // Отримання стрічки за FID const feed = await neynar.fetchFeed("following", { fid: 12345, limit: 25, cursor: nextCursor, }); // Отримання followers const followers = await neynar.fetchUserFollowers({ fid: 12345 }); // Пошук користувачів const users = await neynar.searchUser("alice", { viewerFid: myFid }); 

Аутентифікація через SIWF

import { createAppClient, viemConnector } from "@farcaster/auth-client"; const appClient = createAppClient({ ethereum: viemConnector(), }); // Створюємо channel для auth const { channelToken, url, nonce } = await appClient.createChannel({ siweUri: "https://yourapp.com/login", domain: "yourapp.com", }); // Користувач сканує QR код або переходить за посиланням у Warpcast // Після підтвердження — отримуємо статус const status = await appClient.watchStatus({ channelToken }); if (status.data.state === "completed") { const { fid, displayName, pfpUrl, username } = status.data; // Користувач аутентифікований await createUserSession(fid, username); } 

React хуки для Farcaster

import { AuthKitProvider, useSignIn } from "@farcaster/auth-kit"; function LoginButton() { const { signIn, isLoading, isSuccess, profile } = useSignIn({ onSuccess: (res) => { console.log(`Logged in as ${res.username} (FID: ${res.fid})`); }, }); return ( <button onClick={signIn} disabled={isLoading}> {isLoading ? "Connecting..." : "Sign In with Farcaster"} </button> ); } function App() { return ( <AuthKitProvider config={{ rpcUrl: "https://mainnet.optimism.io", domain: "yourapp.com", siweUri: "https://yourapp.com/login", }} > <LoginButton /> </AuthKitProvider> ); } 

Які проблеми виникають при інтеграції Farcaster?

• Закінчення строку дії signer-ключів: ключі Ed25519 мають термін дії. Використовуємо TTL-логіку з автоматичним продовженням через Neynar.
• Помилка при публікації касту: часто через невірний signerUUID. Перевіряємо реєстрацію signer через Neynar Dashboard.
• Gas для Frames з транзакціями: оптимізуємо виклики смарт-контрактів, використовуємо EIP-1559 для прогнозованої вартості.
• Несумісність Frames в різних клієнтах: тестуємо в Warpcast, Supercast та через емулятор Frog.

Що входить в роботу?

• Розробка смарт-контрактів (якщо потрібна кастомна логіка)
• Налаштування Neynar API та signer-ключів
• Реалізація SIWF з @farcaster/auth-kit
• Створення Frames з використанням Frog
• Інтеграція каналів та читання стрічки
• Документація коду та інструкція з розгортання
• Технічна підтримка 2 тижні після деплою
• Передача доступів та навчання вашої команди

Замовте інтеграцію Farcaster вже сьогодні, щоб ваше dApp стало частиною швидкозростаючої екосистеми.

Терміни та вартість

Вартість розраховується індивідуально після оцінки проєкту. Отримайте консультацію нашого інженера — зв'яжіться з нами, і ми дамо приблизну оцінку протягом дня.

Ми гарантуємо якість коду та дотримання стандартів безпеки. Довірте інтеграцію професіоналам з досвідом 30+ проєктів.