Login with Farcaster

Farcaster is a sufficiently decentralized social network whose core social graph is stored on-chain. Users can choose how content they create is stored and it enables unique, composable experiences by enabling users to link their accounts with a wallet of their choosing. Privy enables your users to easily log in to your app using their Farcaster account. This means you can easily integrate Privy with Farcaster to compose experiences with a user’s existing social graph or network. Here’s how!

Log in with Farcaster enables log in and read access to a user’s Farcaster account but does not provide write access to the account today.

Go to your app in your developer dashboard and navigate to User management > Authentication > Socials. From here, enable Farcaster as a social option. This will enable you to configure Farcaster as a login and account linking option in your app.

2. Configure your app’s Farcaster integration

The following assumes you have set up Privy with your app. If you haven’t, start by following the instructions in the Privy Quickstart to get your app set up with Privy. From there, if you’d like users to be able to login to your app with their Farcaster account, you can configure 'farcaster' as an upfront login method in your PrivyProvider, like so:

<PrivyProvider
  appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID}
  config={{
    // This configures email, farcaster and wallet login for your app.
    appearance: {
        loginMethods: ['farcaster', ...insertTheRestOfYourLoginMethods]
    },
    ...insertTheRestOfYourPrivyProviderConfig
  }}
>

You can also prompt existing users to link their Farcaster account to their existing account.

import {usePrivy} from '@privy-io/react-auth';

function Page() {
  const {linkFarcaster} = usePrivy();
  // You may replace this hook with any of the other `link-` hooks to
  // link a different account type.
  return <button onClick={linkFarcaster}>Link your Farcaster</button>;
}

3. Use your Farcaster link to power custom logic

Once a user has logged in with or linked their Farcaster account, you can find their Farcaster object, including their fid, username, pfp and more, in the user object returned by the usePrivy hook. That’s it! Once you’ve linked a Farcaster account to a user object, you can use this to power composable experiences in your app. You should also consider using toolkits like Farcaster’s APIs or Neynar to query and interact with protocol data.

4. (Optional) Refresh Farcaster info

Sometimes, a user may update their Farcaster profile information (username, pfp) - while this is publicly available using a public hub endpoint, Privy caches a version whenever the user logs in for convenience. To refresh the Privy cache, you can use our REST API (server-auth coming soon) and hitting the /api/v1/users/farcaster/refresh endpoint.

const response = await fetch('https://auth.privy.io/api/v1/users/farcaster/refresh', {
  method: 'POST',
  body: JSON.stringify({
    fid: 1
  }),
  headers: {
    Authorization: `Basic ${btoa(`${'your-privy-app-id'}:${'your-privy-app-secret'}`)}`,
    'privy-app-id': 'your-privy-app-id',
    'content-type': 'application/json'
  }
});

If you’re simply looking for the current Privy user object, we recommend using getUserByFarcasterId. To be considerate of public hubs, we only allow refreshing of user data once every 24 hours. If you need more frequent than daily freshness, we recommend that you query public hub data using the user’s fid.

​1. Enable Farcaster login in your dashboard

​2. Configure your app’s Farcaster integration

​3. Use your Farcaster link to power custom logic

​4. (Optional) Refresh Farcaster info

1. Enable Farcaster login in your dashboard

2. Configure your app’s Farcaster integration

3. Use your Farcaster link to power custom logic

4. (Optional) Refresh Farcaster info