Introduction to Wallet Onboard
Easily connect hundreds of crypto wallets to your app
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.
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
- Gnosis Safe
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.
- Enable Wallet Onboard on your dashboard and configure the allowed domains for your web app.
- 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.
To get started building with Wallet Onboard, see Add Wallet Onboard to your app.