Skip to content


Poll for the current status of a Farcaster Auth request.

When the status changes to 'complete' this action resolves with the final channel value, including the Sign In With Farcaster message, signature, and user profile information.

const status = await appClient.watchStatus({
  channelToken: '210f1718-427e-46a4-99e3-2207f21f83ec',
  timeout: 60_000,
  interval: 1_000,
  onResponse: ({ response, data }) => {
    console.log('Response code:', response.status);
    console.log('Status data:', data);


channelTokenstringFarcaster Auth channel token.Yes8d0494d9-e0cf-402b-ab0a-394ac7fe07a0
timeoutnumberPolling timeout, in milliseconds. If the connect request is not completed before the timeout, watchStatus returns an error.No300_000
intervalnumberPolling interval, in milliseconds. The client will check for updates at this frequency.No1_000
onResponsefunctionCallback function invoked each time the client polls for an update and receives a response from the relay server. Receives the return value of the latest status request.No({ data }) => console.log(data.fid)


    response: Response
    data: {
        state: 'pending' | 'completed'
        nonce: string
        message?: string
        signature?: Hex
        fid?: number
        username?: string
        bio?: string
        displayName?: string
        pfpUrl?: string
        custody?: Hex;
        verifications?: Hex[];
    isError: boolean
    error: Error
responseHTTP response from the Connect relay server.
data.stateStatus of the sign in request, either "pending" or "complete"
data.nonceRandom nonce used in the SIWE message. If you don't provide a custom nonce as an argument to the hook, you should read this value.
data.messageThe generated SIWE message.
data.signatureHex signature produced by the user's Warpcast wallet.
data.fidUser's Farcaster ID.
data.usernameUser's Farcaster username.
data.bioUser's Farcaster bio.
data.displayNameUser's Farcaster display name.
data.pfpUrlUser's Farcaster profile picture URL.
data.custodyUser's FID custody address.
data.verificationsList of user's verified addresses.
isErrorTrue when an error has occurred.
errorError instance.