Early Access: Mobile Wallet Adapter & Wallet Standard #604

steveluscher · 2022-10-17T18:40:57Z

Early Access: Mobile Wallet Adapter & Wallet Standard

Solana Labs is about to release a new version of the React Wallet Adapter that comes with support for the Solana Mobile Stack’s Mobile Wallet Adapter and the new Solana Wallet Standard built in.

Upgrading comes with some benefits that we think you will like:

Your app will automatically work with all mobile wallet apps – the first of which will be released before Breakpoint this year.
Your app will automatically work with all present and future wallets that support the Wallet Standard.
Once the majority of wallets you wish to support have shipped Wallet Standard support, you will be able to reduce code bloat and supply chain attack surface in your app by deleting their legacy wallet adapter plugins.

For much more detail about how the Mobile Wallet Adapter and the Wallet Standard work, refer to this podcast.

Why you might like to participate

Apps that successfully upgrade for Mobile Wallet Adapter and Wallet Standard compatiblity will be demoable with the upcoming Solana Mobile Saga phone on the showroom floor of Breakpoint (Nov 4–7). The Solana Mobile team wants to showcase great user experiences with as many apps as possible, and we want you to be a part of that.

Goal of the early access program

Before we release this to the public and encourage the entire world to upgrade, we want to gather feedback from you. Please help us to find bugs and rough edges in the user experience before we announce this to the world.

Eligibility

If you use any of these packages connect to wallets from your app, you are eligible to upgrade.

@solana/wallet-adapter-react
@solana/wallet-adapter-react-ui
@solana/wallet-adapter-ant-design
@solana/wallet-adapter-material-ui

How to upgrade

From the directory where your package.json file is located, run the following commands:

Instructions for `yarn`

yarn

# If your app uses wallet-adapter-react
yarn upgrade @solana/wallet-adapter-react@latest

# If your app uses wallet-adapter-react-ui
yarn upgrade @solana/wallet-adapter-react-ui@latest

# If your app uses wallet-adapter-ant-design
yarn upgrade @solana/wallet-adapter-ant-design@latest

# If your app uses wallet-adapter-material-ui
yarn upgrade @solana/wallet-adapter-material-ui@latest

Instructions for `npm`

# If your app uses wallet-adapter-react
npm i --save @solana/wallet-adapter-react@latest

# If your app uses wallet-adapter-react-ui
npm i --save @solana/wallet-adapter-react-ui@latest

# If your app uses wallet-adapter-ant-design
npm i --save @solana/wallet-adapter-ant-design@latest

# If your app uses wallet-adapter-material-ui
npm i --save @solana/wallet-adapter-material-ui@latest

Alternatively, you can manually edit your package.json file to update to those versions, then re-run your package manager's install command.

If your site is locked to a version of @solana/web3.js older than 1.58.0, you may need to upgrade that too.

How to test

Testing Mobile Wallet Adapter

You will need a Solana Mobile Stack Mobile Wallet Adapter compatible wallet app installed in order to test your integration. As of this writing, there are no commercially available wallets. In the meantime, you can download the fakewallet app from the Solana Mobile Stack SDK (click on this link from your phone).

Without a compatible mobile wallet installed

Open your app on Android in a mobile web browser
Expect: Your connect button should be armed and read ‘connect’
Click ‘connect’
Expect: Since you have no mobile wallet installed, you should be redirected to https://solanamobile.com/wallets

With a compatible mobile wallet installed

Open your app on Android in a mobile web browser
Expect: Your connect button should be armed and read ‘connect’
Click ‘connect’
Expect: Your mobile wallet app should open and ask you to authorize your web app for use
Accept the authorization
Expect: You should be redirected back to your web app and the wallet should be connected

Inside a wallet's in-app browser

Open your app on Android in a wallet's in-app browser (eg. the browser inside the Phantom app)
Expect: Your connect button should read ‘select wallet’
Click ‘select wallet’
Expect: Your regular wallet set should be displayed. Mobile Wallet Adapter should not be an option.

Testing the Wallet Standard

Any wallet extension that supports the new Solana Wallet Standard will automatically attach to your list of selectable wallets, without you having to configure it. Install a Wallet Standard compliant wallet like Backpack's latest release to see this in action.

Open your app on desktop web
Expect: Your connect button should read ‘select wallet’
Click ‘select wallet’
Expect: Installed wallets that support the Wallet Standard should appear as choices in the dialog, alongside your regularly configured wallet set. If you don't have any installed wallets that support the Wallet Standard yet, you will just see the wallet adapters you are using.
If you have the Backpack wallet adapter in your code, remove it and rebuild
Expect: Backpack is still detected by your app and works. (Make sure you're using Backpack's latest release from Github and have the right RPC connection network selected in Backpack.)

How to give feedback

If you encounter issues with the integration or with the use of a Standard or Mobile wallet please file an issue.

If your app happens to be open source, feel free to reference this GitHub issue in the commit message or the pull request of the change where you do the upgrade.

Products that have upgraded

Search https://cs.github.com/?scopeName=All+repos&scope=&q=path%3Apackage.json+%5C%22%40solana%2Fwallet-adapter-react%5C%22%3A and send PRs to open source libraries. Track them here.

Open Source PRs

Open Source Repos

Closed Source Projects

The text was updated successfully, but these errors were encountered:

gabRiel-bit20 · 2022-10-26T03:56:39Z

Port Finance (https://port.finance/) would love to use the latest wallet adaptor.

jordaaash · 2022-10-26T04:10:14Z

@gabRiel-bit20 can you try to follow the steps in this issue? Let us know if you run into issues!

platocoreteam · 2022-10-26T13:45:58Z

@jordansexton - we are already using @solana/wallet-adapter-react and @solana/wallet-adapter-react-ui in one of our web app for our eat and earn users. How do we submit PR if our project is closed source? do we add you into our team?

jordaaash · 2022-10-26T15:42:25Z

@platocoreteam yes, you can add me to the repo you want to update.

platocoreteam · 2022-10-27T13:32:47Z

@jordansexton - we just added you to our repo. can you check?

olaf-snf · 2022-11-01T11:26:19Z

@steveluscher @jordansexton Snowflake (https://snowflake.so) is now compatible with Mobile Wallet Adapter. You guys made this so easy. If you could add Snowflake to the compatible product list as well. thanks.

steveluscher · 2022-11-01T20:08:07Z

Done!

skywalletadmin · 2022-11-02T09:16:36Z

@steveluscher @jordansexton SKY Wallets' dApps (https://www.getsky.app/) are also now compatible with the Mobile Wallet Adapter and Wallet Standard. Please add SKY Wallet to the compatible products list as well! Thanks.

adminbizfirst · 2022-11-02T09:26:19Z

Hi @steveluscher @jordansexton Our product (https://www.bizfirst.xyz/) is now compatible with the Wallet Standard and Mobile Wallet Adapter. Please add us to the compatible list as well. Thank you!

zfaizal2 · 2022-11-02T16:41:46Z

Hey @steveluscher @jordansexton

We've got https://app.dispatch.forum/ up to date with the new wallet standard and MWA, please add us to the list -- thanks!

steveluscher · 2022-11-02T22:20:46Z

Hey @adminbizfirst, DM me on Twitter! I have some questions.

steveluscher · 2022-11-02T22:26:38Z

Hey @skywalletadmin, I have some questions for you too. DM me on Twitter!

adminbizfirst · 2022-11-03T05:46:30Z

@steveluscher Done, please check. DM'd you from our twitter handle (https://twitter.com/MyBizFirst)

skywalletadmin · 2022-11-03T05:49:55Z

Hey @steveluscher just DM'd you via our twitter handle (https://twitter.com/GetSkyApp)

diegofigs · 2022-11-03T17:28:56Z

Hey @steveluscher @jordansexton, Dual Finance updated to RC a couple days back and will be updating latest version soon. Please add to list, thanks!

josip-volarevic · 2022-11-04T23:36:04Z

Hey there @steveluscher 👋

Dropping off a few of my dApps in case it's not too late:

Gorecats Comic [LINK] [SOURCE CODE]
Art of Niko Comic [LINK] [SOURCE CODE]
Saga TV [LINK] [SOURCE CODE]

Proof video for all 3 apps is located here: Google drive video

I might've missed something crucial and also applied too late so worries if you miss adding these dApps to your list!

flodef · 2022-11-07T16:36:56Z

Hey @steveluscher 👋
Just wanted to THANK YOU for this fantastic job you are doing.
I did the integration and it was very easy. You did all the hard work !!!
It is definitively life changing for mobile adoption.

anoushk1234 · 2022-11-10T08:05:25Z

@steveluscher correct me if im wrong, does this mean that we can connect mobile web apps to mobile wallets like phantom? I'm a bit confused since I tried to use the compatible dapps on mobile browser and they didn't connect.

arihantbansal · 2022-11-10T08:10:50Z

@steveluscher correct me if im wrong, does this mean that we can connect mobile web apps to mobile wallets like phantom? I'm a bit confused since I tried to use the compatible dapps on mobile browser and they didn't connect.

It's working with the updated dApps. Eg: #604 (comment)

josip-volarevic · 2022-11-10T09:46:12Z

@steveluscher correct me if im wrong, does this mean that we can connect mobile web apps to mobile wallets like phantom? I'm a bit confused since I tried to use the compatible dapps on mobile browser and they didn't connect.

@anoushk1234 you should be able to connect mobile web apps to mobile wallets. Currently working mobile wallets are Phantom, Solflare and "fakewallet".

There is most likely an error on your end. Are you on iOS? I'm not sure if there is any support for Solana mobile there.
Did you update your packages to correct dependencies? Do you use the correct cluster on your mobile wallet? e.g. if your local web dapp is on devnet, make sure to switch Phantom to devnet as well

anoushk1234 · 2022-11-10T18:32:08Z

@steveluscher correct me if im wrong, does this mean that we can connect mobile web apps to mobile wallets like phantom? I'm a bit confused since I tried to use the compatible dapps on mobile browser and they didn't connect.

@anoushk1234 you should be able to connect mobile web apps to mobile wallets. Currently working mobile wallets are Phantom, Solflare and "fakewallet".

There is most likely an error on your end. Are you on iOS? I'm not sure if there is any support for Solana mobile there. Did you update your packages to correct dependencies? Do you use the correct cluster on your mobile wallet? e.g. if your local web dapp is on devnet, make sure to switch Phantom to devnet as well

I'm on safari yes

anoushk1234 · 2022-11-11T09:09:52Z

@steveluscher just checked this works flawlessly on android, can we get this on ios as well?

josip-volarevic · 2022-11-11T09:14:26Z

@anoushk1234 copy pasting this from Solana mobile stack discord channel:

Hello Solana friends,

I'm - I lead the engineering team at FastAF (an iOS application that recently launched an integrated Solana wallet to power token-gated experiences, NFT Rewards and soon to be... crypto payments). ⭐

As a fun follow-up to Steven's news, my team will be working on the iOS spec for the Mobile Wallet Adapter. 🎉

Here's a brief overview on the ups / downs we faced embarking on this fun journey in the iOS world..

We have performed a technical feasibility study for using a variety of transport methods for MWA communication.
Findings: The existing Android specification for MWA calls for two-way app communication over a websocket server.
This is significantly limited by background processing limitations on iOS. (approx. 30 second limit)
However, opening a Websocket or HTTP server via NSURLConnection on iOS does not appear to be a problem.

We are moving forward with two communication schemas:

Websocket communication for when the dapp and wallet are not on the same physical device

Deep link-based communication (or Safari App Extensions) for when the dapp and wallet are on the same physical device

Will post more updates in this channel as we dive further into the implementation stage.

I don't think iOS integration is expected in the short term roadmap

anoushk1234 · 2022-11-14T05:55:21Z

@anoushk1234 copy pasting this from Solana mobile stack discord channel:

Hello Solana friends,

I'm - I lead the engineering team at FastAF (an iOS application that recently launched an integrated Solana wallet to power token-gated experiences, NFT Rewards and soon to be... crypto payments). ⭐

As a fun follow-up to Steven's news, my team will be working on the iOS spec for the Mobile Wallet Adapter. 🎉

Here's a brief overview on the ups / downs we faced embarking on this fun journey in the iOS world..

We have performed a technical feasibility study for using a variety of transport methods for MWA communication.
Findings: The existing Android specification for MWA calls for two-way app communication over a websocket server.
This is significantly limited by background processing limitations on iOS. (approx. 30 second limit)
However, opening a Websocket or HTTP server via NSURLConnection on iOS does not appear to be a problem.

We are moving forward with two communication schemas:

Websocket communication for when the dapp and wallet are not on the same physical device

Deep link-based communication (or Safari App Extensions) for when the dapp and wallet are on the same physical device

Will post more updates in this channel as we dive further into the implementation stage.

I don't think iOS integration is expected in the short term roadmap

yep works on android for me, hope ios is also sorted soon

flodef · 2022-11-15T10:55:52Z

It works for me on Android, with Solflare, but Phantom don't display the "accept" button. Seems like a phantom wallet problem...

josip-volarevic · 2022-11-15T11:39:33Z

It works for me on Android, with Solflare, but Phantom don't display the "accept" button. Seems like a phantom wallet problem...

This is an issue with Phantom not detecting your selected cluster automatically which fakewallet and solflare do out of the box.
e.g. if your app is using devnet but phantom has mainnet-beta selected, you will experience such an issue

It's asked and answered on solana stackexchange here

steveluscher · 2022-11-15T19:02:29Z

@steveluscher just checked this works flawlessly on android, can we get this on ios as well?

Check out the iOS effort announcement here and cheer them on! https://discord.com/channels/988649555283308564/988902872773181491/1030613038350475264

Bewinxed · 2023-02-01T10:29:12Z

I would love to participate but I'm using svelte at the moment, and the mobile wallet adapter for them is not maintained often :(

steveluscher · 2023-05-17T15:27:54Z

Thanks for all of your help everyone! We made incredible progress; MWA and Wallet Standard are supported in most places now.

steveluscher changed the title ~~[wip][do not act upon yet] Upgrade whole world to Mobile Wallet Adapter & Wallet Standard compatible Solana Wallet Adapter~~ [wip][do not act upon yet] Early Access: Mobile Wallet Adapter & Wallet Standard Oct 17, 2022

steveluscher changed the title ~~[wip][do not act upon yet] Early Access: Mobile Wallet Adapter & Wallet Standard~~ Early Access: Mobile Wallet Adapter & Wallet Standard Oct 18, 2022

steveluscher mentioned this issue Oct 18, 2022

MWA Wallet Ecosystem page too aggressive #611

Closed

jordaaash mentioned this issue Oct 19, 2022

Demo on Mobile chrome won't launch phantom app #464

Closed

jordaaash added the documentation Improvements or additions to documentation label Oct 20, 2022

jordaaash mentioned this issue Oct 21, 2022

Update Wallet Adapter GooseFX1/gfx-web-app#532

Merged

7 tasks

jordaaash mentioned this issue Oct 23, 2022

Use @solana/wallet-adapter-react for compatibility with Mobile Wallet Adapter and the Wallet Standard blockworks-foundation/mango-ui-v3#423

Open

steveluscher mentioned this issue Oct 25, 2022

Realms is now compatible with mobile wallet apps solana-labs/governance-ui#1116

Closed

jordaaash mentioned this issue Oct 26, 2022

MWA and Standard RC #598

Merged

This was referenced Oct 27, 2022

Upgrade for compatibility with Mobile wallet adapter jnwng/sign-in-with-solana#1

Merged

GooseFX is now compatible with the Solana Mobile Wallet Adapter protocol GooseFX1/gfx-web-app#536

Merged

This was referenced Oct 28, 2022

Mobile Wallet Adapter and Wallet Standard support in @solana/wallet-adapter-react #635

Merged

Version Packages thanhtamv2t/wallet-adapter#1

Open

bbondy mentioned this issue Dec 13, 2022

Implement Solana support for "The Wallet Standard" brave/brave-browser#27340

Closed

steveluscher closed this as completed May 17, 2023

LFerronato mentioned this issue Mar 26, 2024

auto redirection after Solana Wallet Integration - to https://solanamobile.com/wallets #936

Closed

anza-xyz deleted a comment from LFerronato Apr 1, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Early Access: Mobile Wallet Adapter & Wallet Standard #604

Early Access: Mobile Wallet Adapter & Wallet Standard #604

steveluscher commented Oct 17, 2022 •

edited

Loading

gabRiel-bit20 commented Oct 26, 2022

jordaaash commented Oct 26, 2022

platocoreteam commented Oct 26, 2022

jordaaash commented Oct 26, 2022

platocoreteam commented Oct 27, 2022

olaf-snf commented Nov 1, 2022 •

edited

Loading

steveluscher commented Nov 1, 2022

skywalletadmin commented Nov 2, 2022

adminbizfirst commented Nov 2, 2022

zfaizal2 commented Nov 2, 2022

steveluscher commented Nov 2, 2022

steveluscher commented Nov 2, 2022

adminbizfirst commented Nov 3, 2022 •

edited

Loading

skywalletadmin commented Nov 3, 2022

diegofigs commented Nov 3, 2022

josip-volarevic commented Nov 4, 2022 •

edited

Loading

flodef commented Nov 7, 2022

anoushk1234 commented Nov 10, 2022

arihantbansal commented Nov 10, 2022

josip-volarevic commented Nov 10, 2022

anoushk1234 commented Nov 10, 2022

anoushk1234 commented Nov 11, 2022

josip-volarevic commented Nov 11, 2022

anoushk1234 commented Nov 14, 2022

flodef commented Nov 15, 2022

josip-volarevic commented Nov 15, 2022

steveluscher commented Nov 15, 2022

Bewinxed commented Feb 1, 2023

steveluscher commented May 17, 2023

Early Access: Mobile Wallet Adapter & Wallet Standard #604

Early Access: Mobile Wallet Adapter & Wallet Standard #604

Comments

steveluscher commented Oct 17, 2022 • edited Loading

Early Access: Mobile Wallet Adapter & Wallet Standard

Why you might like to participate

Goal of the early access program

Eligibility

How to upgrade

Instructions for yarn

Instructions for npm

How to test

Testing Mobile Wallet Adapter

Without a compatible mobile wallet installed

With a compatible mobile wallet installed

Inside a wallet's in-app browser

Testing the Wallet Standard

How to give feedback

Products that have upgraded

Open Source PRs

Open Source Repos

Closed Source Projects

gabRiel-bit20 commented Oct 26, 2022

jordaaash commented Oct 26, 2022

platocoreteam commented Oct 26, 2022

jordaaash commented Oct 26, 2022

platocoreteam commented Oct 27, 2022

olaf-snf commented Nov 1, 2022 • edited Loading

steveluscher commented Nov 1, 2022

skywalletadmin commented Nov 2, 2022

adminbizfirst commented Nov 2, 2022

zfaizal2 commented Nov 2, 2022

steveluscher commented Nov 2, 2022

steveluscher commented Nov 2, 2022

adminbizfirst commented Nov 3, 2022 • edited Loading

skywalletadmin commented Nov 3, 2022

diegofigs commented Nov 3, 2022

josip-volarevic commented Nov 4, 2022 • edited Loading

flodef commented Nov 7, 2022

anoushk1234 commented Nov 10, 2022

arihantbansal commented Nov 10, 2022

josip-volarevic commented Nov 10, 2022

anoushk1234 commented Nov 10, 2022

anoushk1234 commented Nov 11, 2022

josip-volarevic commented Nov 11, 2022

anoushk1234 commented Nov 14, 2022

flodef commented Nov 15, 2022

josip-volarevic commented Nov 15, 2022

steveluscher commented Nov 15, 2022

Bewinxed commented Feb 1, 2023

steveluscher commented May 17, 2023

steveluscher commented Oct 17, 2022 •

edited

Loading

Instructions for `yarn`

Instructions for `npm`

olaf-snf commented Nov 1, 2022 •

edited

Loading

adminbizfirst commented Nov 3, 2022 •

edited

Loading

josip-volarevic commented Nov 4, 2022 •

edited

Loading