Skip to main content

Migrate to Wallet Standard

On the web, Mobile Wallet Adapter (MWA) is available as a standard wallet with the package:

This is the recommended library for MWA on web and this guide explains why and how to migrate your web app.

How to upgrade​

1. Install Mobile Wallet Standard​

Installing the standard wallet takes two steps:

Step 1​

Add the library @solana-mobile/wallet-standard-mobile.

npm install @solana-mobile/wallet-standard-mobile

Step 2​

Call the registerMwa function.

caution

Ensure registerMwa is invoked in a non-SSR context. if you're using a framework with Server Side Rendering (e.g Next.js),

// 'use client' - If using Next.js, ensure it is registered in a non-SSR context.

import { 
    createDefaultAuthorizationCache, 
    createDefaultChainSelector, 
    createDefaultWalletNotFoundHandler,
    registerMwa, 
} from '@solana-mobile/wallet-standard-mobile';

registerMwa({
    appIdentity: {
      name: 'My app',
      uri: 'https://myapp.io',
      icon: 'relative/path/to/icon.png', // resolves to https://myapp.io/relative/path/to/icon.png
    },    
    authorizationCache: createDefaultAuthorizationCache(),
    chains: ['solana:devnet', 'solana:mainnet'],
    chainSelector: createDefaultChainSelector(),
    onWalletNotFound: createDefaultWalletNotFoundHandler(),
    // remoteHostAuthority: '<REPLACE_WITH_URL_>',  Include to enable remote connection option.
})

Now, Mobile Wallet Adapter will appear as a wallet option.

For more context, view the full installation guide.

2. Update to wallet-adapter >= 0.15.36​

If your web app is using @solana/wallet-adapter-react update to a version >= 0.15.36. Updating fixes common MWA Web issues like:

Why switch?​

There are several reasons to upgrade to using MWA via Wallet Standard.

Wallet Adapter no longer includes MWA as a default​

The @solana/wallet-adapter-react library will not include MWA as a default option starting from versions >= 1.0.0.

This means any web app using @solana/wallet-adapter-react will no longer display Mobile Wallet Adapter as an option for users browsing on Android Chrome, unless explicitly added.

Enable remote connection​

The @solana-mobile/wallet-standard-mobile library includes a remote connection option that allows users to connect their mobile wallet app to a desktop web page.

View the MWA Remote documentation for more information.

Bug fixes and stability​

The @solana-mobile/wallet-standard-mobile is the recommended web library for MWA going forward. This means it will receive all the latest feature additions and updates.

The legacy @solana-mobile/wallet-adapter-mobile library will be deprecated and enter maintenance mode, and only receive updates for bug fixes.