Farcaster Hub Manager

WHAT IT DOES

This tool provides a read-only interface to Farcaster's on-chain identity layer. Given a Farcaster ID (FID) or an Ethereum wallet address, it queries the Farcaster ID Registry and Key Registry to retrieve the user's FID, custody address, owner address, expiry date, and all registered keys with their key types (Signer, Recover, etc.). All data is pulled directly from the Farcaster contracts on the connected chain—no off-chain databases or third-party APIs are used. This is useful for developers, auditors, and users who want to verify on-chain Farcaster identity without relying on off-chain services.

HOW TO USE

Connect your wallet (MetaMask or any Web3 wallet) to the desired EVM network (Optimism is the primary chain for Farcaster contracts). Enter the Farcaster ID Registry and Key Registry addresses (mainnet addresses are pre-filled), then enter either an FID or a wallet address to look up. Click "look up" or press Enter. The tool will query the contracts and display the user's FID, custody address, owner address, expiry date, and a list of registered keys. The interface is intentionally minimal—it shows what the contract knows, nothing more and nothing less.

TECHNICAL MECHANISM

The tool uses the Farcaster ID Registry ABI to call idOf (to get FID from an address), custodyOf (to get the custody address for an FID), ownerOf (to get the owner address), and expiresAt (to get the expiry timestamp). It uses the Key Registry ABI to call keysOf (to get all keys for an FID) and keyTypeOf (to get the key type for each key). The results are parsed and displayed in a readable format, with key types mapped to their human-readable names. All reads are performed via the connected provider; no state is written.

WHAT IT CANNOT SEE

This tool cannot read off-chain Farcaster data (casts, reactions, follows) that is not stored on-chain. It cannot verify off-chain credentials or metadata not on the contract. It cannot detect pending or unconfirmed transactions. It may not support all Farcaster contract versions or chain deployments. It cannot manage or recover keys without an on-chain transaction. The data shown is exactly what is stored on-chain—nothing more.

PLEASE NOTE

This tool works on any EVM-compatible network where Farcaster contracts are deployed, but is primarily designed for Optimism. It is intended for informational and monitoring purposes only. Always cross-reference with official sources and multiple explorers before making any decisions based on this data.