WalletConnect: How to log in and use your Stellar wallet from LOBSTR with other services

What is WalletConnect?

WalletConnect is a powerful protocol that enables phone applications like LOBSTR to connect with other platforms using QR code scanning or deep linking. This protocol provides new ways for you to interact with your Stellar wallet, enabling you to use multiple platforms whilst keeping the signing of your wallet all in one single safe place.

WalletConnect’s newest version, 2.0, brings compatibility to more blockchains including Stellar.
With WalletConnect 2.0 support, you can now connect your LOBSTR app’s wallet to any desktop platform with WalletConnect 2.0 support, including StellarTerm and StellarX.

All the sensitive information, including your private keys, stays directly on your mobile device within LOBSTR mobile app you use to connect. Every time you make an action in your connected service, like making a payment or creating an offer, you will be asked to sign the transaction inside your LOBSTR mobile app.

Learn more about WalletConnect.
See Medium post announcing WalletConnect integration.

How to Log In with WalletConnect?

We will now take you through the steps to use the WalletConnect Log In option in the LOBSTR app.

1. Open the LOBSTR app on your mobile device.

If you do not yet use LOBSTR you can get the app from either the Apple or Google Play stores:

Download on the App Store
Grab it on Google Play

Once you have the LOBSTR app, you will need to either sign up or log in to your LOBSTR account. If you’re a new user to LOBSTR you can create a new Stellar Wallet or connecting one you already use to your account.

2. Use the Universal QR Code Scanner to scan the QR code displayed by the service you’re using

If a Stellar-based platform has a WalletConnect login option, you can use LOBSTR to log in to this service. To do this select the Universal QR Code Scanner in the top right corner of the home screen. Then scan the QR code given to you by the service you’re using. In this example we used StellarTerm.

Alternatively, navigate to the menu ≡ icon in the top left corner, and choose WalletConnect from the menu. Choose 'New connection' to scan the QR code and establish the connection with the service of your choice.

3. Confirm or Reject a connection in LOBSTR app

You will now see a Reject/Connect alert on the LOBSTR app. If you press Reject the connection will be canceled. If you press Connect then the service you’re using will log in with your Stellar Wallet from LOBSTR.

4. You are now logged in to the service with your Stellar Wallet from the LOBSTR app.

From here you can now use the connected platform the same way as any other log in option. Every time you make an action in your wallet, like making a payment or creating an offer, you will now be asked to sign the transaction from the LOBSTR app. This means your private key stays safely in your LOBSTR app, without the need for it to be put directly into StellarTerm or another service.
Learn more about signing transactions with WalletConnect.

Note: At the moment, you should have the 'WalletConnect' screen open to receive signature requests from services you are connected to.  

If you exit the Active Connections screen and need to get back to it, navigate to the ≡ icon in the top left corner, and choose WalletConnect from the menu.

Multiple connections support

WalletConnect allows you to manage multiple connections to various services at the same time, there is no need to disconnect your existing connections.

Once a connection is established, LOBSTR app keeps the connection running in the background in order to have a more streamlined experience. You should be able to view and interact with your active connections the next time you visit WalletConnect.

Perform steps 2-4 If you wish to connect to another service and receive transactions for both in a single interface.

For example, you can connect to both StellarX and StellarTerm from the same device and use both platforms simultaneously without compromising the security of your LOBSTR account.