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.
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.
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.
If you have any further questions on using WalletConnect integration, please reach out to us at firstname.lastname@example.org. We hope you enjoy this new and safer way of using Stellar.
I am trying to interact with a service but there is no connection request on WalletConnect
This is likely due to the service having an issue with your browser session. The following steps resolve the issue for most people:
- Go to LOBSTR > Side menu > WalletConnect
- Find the service that is connected and disconnect it.
- On your computer please disconnect your existing connect and connect again.
- Alternatively, open the Chrome incognito window and attempt connecting from there.
This issue may also appear if WalletConnect 2.0 service is temporarily unavailable as it is currently in beta. If your connection request does not reach your mobile app in a minute, please wait for a few minutes and try again.