Farcaster Hub

WHAT IT DOES

Farcaster Hub gives Farcaster users, developers, and community managers comprehensive tools for managing Farcaster social interactions on-chain. It reads live on-chain data including Farcaster user profiles, cast messages, reaction records, user verification data, channel registrations, and social graph data. You can register profiles, post casts, submit reactions (likes, recasts, replies), verify users, and export profile data. The tool shows you in real time the username, cast count, follower count, verification status, and profile registration status—so you can manage your Farcaster social identity effectively.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the Farcaster contract address, username, cast content, reaction type, and target cast ID. Use "Check profile" to see your username, cast count, follower count, and verification status. Click "Register profile" to create a new Farcaster profile with your chosen username. Use "Post cast" to publish a new cast message. "Post reaction" lets you like, recast, or reply to a cast by specifying the target cast ID. "Verify user" updates your verification status. "Export profile" downloads your profile data as JSON. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool interacts with Farcaster smart contracts using ethers v5.7.2. It calls registerProfile(), postCast(), postReaction(), verifyUser(), getProfile(), getCast(), and getCastCount() on the Farcaster contract to manage and query social data. Profiles are registered with a username, casts are stored with content, and reactions are recorded with type and target cast ID. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a transaction reverts. Transaction costing uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend.

WHAT IT CANNOT SEE

This tool cannot verify off-chain social data or guarantee that social graph data is complete or up-to-date. It cannot detect if a user's profile is authentic or if casts are genuine. It cannot see off-chain social interactions not stored on-chain. It cannot guarantee that reactions are accurately recorded or that the social graph is complete. The tool provides Farcaster social management based on on-chain data, but it does not guarantee that the data is complete or that the social interactions are accurate.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read‑write tool that requires signing transactions—always verify the Farcaster contract address, username, and cast content before approving. No contract addresses are hardcoded; you paste the contracts you are managing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.