Introduction to Wallet Onboard

Easily connect hundreds of crypto wallets to your app

Overview

Wallet Onboard allows your app to connect to hundreds of self-custody wallets, including browser plugin wallets, WalletConnect-compatible mobile wallets, and custom protocols or UX required by hybrid and hardware wallets.

Once a user has connected their wallet, your app can request information and signatures from their connected address.

You can try out the Wallet Onboard demo to see it in action.

image of Plaid Wallet Onboard UI

Prefer to learn by watching? A video introduction to Wallet Onboard is available.

Blockchain & wallet compatibility

Wallet Onboard currently supports Ethereum and EVM-compatible blockchains like Polygon. We plan to support additional popular blockchains in the future.

Additionally, Wallet Onboard helps users connect with the following wallets and protocols:

  • All browser extension wallets (20+ automatically detected, including MetaMask)
  • All WalletConnect wallets (200+ wallets)
  • Coinbase Wallet
  • Rainbow
  • Ledger
  • Trezor
  • Gnosis Safe
  • Argent
  • Zerion

Even within the same protocol, many wallets have API and UX differences that Wallet Onboard handles so you don't have to. To request support for additional wallets or connection flows, contact your Plaid Account Manager or file or file a Support request.

Integration process

  1. Enable Wallet Onboard on your dashboard and configure the allowed domains for your web app.
  2. Embed the Link JavaScript SDK in your web app.
  3. Open Wallet Onboard using the JavaScript API.
  4. Upon successful wallet connection, you will receive an EIP-1193 provider. You can use this provider directly, or with other libraries, to interact with the user's wallet.

See Add Wallet Onboard to your app for more details.

Testing Wallet Onboard

Wallet Onboard connects to real wallets and any network/chain you configure. When using a Sandbox Link Token from the dashboard, Wallet Onboard will only open on localhost:* domains. When you are ready to use Wallet Onboard on any domain, you can request production access.

If you want to test the functionality of your app on a non-production blockchain, consider configuring Wallet Onboard to connect to appropriate testnet chains like Ethereum Görli (0x5) or Polygon Mumbai (0x13881). Go to Chainlist.org and enable the "Testnets" option for more testnet chains.

Next Steps

To get started building with Wallet Onboard, see Add Wallet Onboard to your app.