Neynar Documentation

Create a Farcaster Auth Relay Channel

Creates a Farcaster Auth relay channel. Returns a secret token identifying the channel, and a URI to display to the end user as a link or QR code.

const channel = await appClient.createChannel({
  siweUri: 'https://example.com/login',
  domain: 'example.com',
});

Parameter	Type	Description	Required	Example
`siweUri`	`string`	Login URL for your application.	Yes	`https://example.com/login`
`domain`	`string`	Domain of your application.	Yes	`example.com`
`nonce`	`string`	A custom nonce. Must be at least 8 alphanumeric characters.	No	`ESsxs6MaFio7OvqWb`
`notBefore`	`string`	Start time at which the signature becomes valid. ISO 8601 datetime.	No	`2023-12-20T23:21:24.917Z`
`expirationTime`	`string`	Expiration time at which the signature is no longer valid. ISO 8601 datetime.	No	`2023-12-20T23:21:24.917Z`
`requestId`	`string`	A system specific ID your app can use to refer to the sign in request.	No	`8d0494d9-e0cf-402b-ab0a-394ac7fe07a0`
`acceptAuthAddress`	`boolean`	Whether your application accepts signatures from an auth address.	No	`true`

{
  response: Response;
  data: {
    channelToken: string;
    url: string;
    nonce: string;
  }
  isError: boolean;
  error: Error;
}

Parameter	Description
`response`	HTTP response from the Connect relay server.
`data.channelToken`	Connect relay channel token.
`data.url`	Sign in With Farcaster URL to present to the user. Links to the Farcaster client in v1.
`data.nonce`	Random nonce included in the Sign in With Farcaster message.
`isError`	True when an error has occurred.
`error`	`Error` instance.