Abstract

In order to fully decentralize ShapeShift’s product offerings and retain as many users as possible, Product and Engineering workstream have aligned on a strategy to migrate users from ShapeShift’s legacy apps (aka Axiom, beta.shapeshift.com, or the current ShapeShift mobile app) to the new open source v2 (app.shapeshift.com).

App.shapeshift.com has been built as a progressive web app and already works great in mobile browsers. However, in order to retain as many current ShapeShift mobile users as possible, the plan is to wrap app.shapeshift.com into native iOS and Android apps and submit an app update to the store which replaces the legacy app code with the wrapped version of app.shapeshift.com. This also supports the broader efforts to sunset ShapeShift’s legacy, centralized infrastructure that the current Mobile app depends on.

Prior to replacing the existing mobile app with the wrapped progressive web app, we will release the ability for legacy ShapeShift native wallet users to import their wallet to app.shapeshift.com by logging in to their ShapeShift account with email & password. Once we are confident in this path and have sufficient feature parity (ie. THORChain trading support), we will submit the app store update to replace the legacy centralized app with the wrapped progressive web app, and effectively “redirect” existing mobile users to the new version.

Following this “redirect,” when an existing user opens the v2 mobile app, if they were already logged in to the legacy mobile app on their device, their keys should be automatically imported into the new version of the app and they should see a special welcome screen announcing the update.

When an existing user opens the v2 mobile app or app.shapeshift.com and isn’t logged in, they should see 2 options: Create Wallet & Import Wallet. If the user selects Import Wallet, they will see an option to Sign in via ShapeShift, and if they select that and input their email and password, their encrypted seed is retrieved from ShapeShift’s legacy servers, decrypted, and saved to the device’s secure storage.

The ‘Log in with ShapeShift’ option will continue being displayed until all legacy ShapeShift infrastructure is sunset, and separate efforts are underway to remind users to back up their wallet before then as well as give any user who does not back up their wallet before then an evergreen path to decrypt their encrypted seed phrase locally on their device with their email + password.

Resources

Current mobile app listings:

iOS

[Android](https://play.google.com/store/apps/details?id=com.shapeshift.droid_shapeshift&hl=en_US&gl=US](https://play.google.com/store/apps/details?id=com.shapeshift.droid_shapeshift&hl=en_US&gl=US))

Progressive Web Apps Explained