Switching over from Legacy to HyperApp

This page is only relevant for users who signed up for BASED before July 2025.

BASED accounts created before July 2025 are by considered as "Legacy" account. If you have an account then, you would most likely have logged in from app.based.one or have the PWA added to your phone. This is the wallet that was connected to a Safe wallet.

Moving forward, we are transiting to a simpler architecture and there may be some action required on your end.

What are the technical differences?

When we launched in 2023, we introduced a smart contract wallet (powered by Safe) that is connected to a Visa Debit Card. We pioneered the first non-custodial Visa Debit card back in 2023. Users could login to BASED either by connecting through Web3 Wallets or by using Magic.link, an authentication provider.

But since July 2025, we are introduce a shift to a simpler architecture by completely removing the smart contract wallet layer. Users could still use the simple Web3 wallet to connect or to use social logins. We also took the opportunity to switch from Magic to Privy for the authentication. On the new HyperApp, you could log in with Google or Email. This service is provided by Privy (now part of Stripe). We no longer support phone number logins.

This change however has some implications as many of our Visa card services was tied to the Safe smart contract layer. To continue using BASED Visa Card on the new apps, you will have to go through a one-time setup process.

Migration

To facilitate the change, our engineers work on a smooth migration flow which automatically creates a linkage from the legacy account (Safe wallet) to the new HyperApp wallet.

If you have logged in to BASED with an email or Google, you could simply log in with the same account and the linkage will be done automatically.

Link Card Manually

Note: Linking card accounts require logging in via email on the app.

You will have to link card manually if you Logged in to legacy BASED with:

• Web3 Wallet such as Metamask or Rabby

• Phone number

• An email address that you no longer wish to use anymore

Go to the "Cash" tab and click on "Link Existing Card"

It will route you to a browser where you have to connect to the legacy BASED. Click on "Link Card"

Your card is successfully linked!