Cookie-based authentication

Configure the React SDK to use cookie-based authentication with a custom API base URL.

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

For what cookie-based authentication is, how it works, and full dashboard setup steps, see Cookie-based authentication.

SDK configuration

Once your cookie domain is configured and DNS is validated, update the apiBaseUrl prop in DynamicContextProvider settings to point to your custom hostname:

<DynamicContextProvider
  settings={{
    apiBaseUrl: 'https://auth.example.io/api/v0',
    environmentId: DYNAMIC_ENVIRONMENT_ID,
    walletConnectors: [EthereumWalletConnectors],
  }}
>
  ...
</DynamicContextProvider>

Replace auth.example.io with the custom hostname you configured in the dashboard.