Docs

Coinbase Wallet

You will learn the following:

  • Use Coinbase Wallet to authenticate users with Web3

Enabling Coinbase Wallet as a Web3 provider allows your users to sign in and up to your Clerk application with their Coinbase Wallet. Both Smart Wallet and the Coinbase Wallet browser extension are supported.

Warning

This guide is for using Coinbase Wallet for authentication. If you're looking to connect users using Coinbase.com as a social provider, see the dedicated guide.

Enable Coinbase Wallet as a Web3 provider

  1. In the Clerk Dashboard, navigate to the Web3 page.
  2. From the list of web3 providers, enable Coinbase Wallet.

Test authentication

The simplest way to test authentication is to visit your Clerk application's Account Portal, which is available for all Clerk applications out-of-the-box.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to the Sign-in URL, select Visit. The URL should resemble:
    • For developmenthttps://your-domain.accounts.dev/sign-in
    • For productionhttps://accounts.your-domain.com/sign-in
  3. On the sign-in page, you should see Coinbase Wallet as an option. Use it to sign in.

Collect additional user information during sign-up (optional)

Web3 applications typically use a hexadecimal wallet address to identify users, which offers a high level of privacy. However, when bridging the gap between Web3 and Web2, it's often necessary to gather human-readable information about the user, such as their email address, phone number, or a username.

To collect additional information about your user during sign-up:

  1. In the Clerk Dashboard, navigate to the Email, phone, username page.
  2. On this page, enable the attributes you want to collect from your user during sign-up.
  3. To set an attribute as required, select the settings icon next to the enabled attribute. Clerk will automatically prompt the user for this information after authenticating with Coinbase Wallet.

Connect Coinbase Wallet to existing account

Users can connect their Coinbase Wallet to their account at any time through their user profile page. You can configure your application to use the Account Portal user profile page or the prebuilt <UserProfile /> component.

Feedback

What did you think of this content?

Last updated on