Skip to content

DApps integration

Jump to bottom
Ana edited this page Feb 13, 2024 · 8 revisions

DApps integration

You can connect various decentralized applications (dApps) to your Umami wallet.

This allows you to access decentralized services and applications directly from within your wallet app without switching between multiple platforms.

Caution! Umami cannot verify dApps you're using!

  • use only the trustworthy dApps
  • always check what you are signing
  • make sure you check the request payload
Example of request payload Screenshot 2024-01-31 at 13 39 44

How can I connect my wallet to a dApp?

Umami uses Beacon to communicate with other dApps.

There are two ways to sync through it. We'll use objkt.com for the demo.

Connect using a deeplink

That's the simplest way

1. Open dApp web page and click on the login icon Screenshot 2024-01-31 at 13 17 51
2. It will open the beacon connect modal window. If it does not have Umami listed yet, click on "Show more" for more options Screenshot 2024-01-31 at 13 17 55
3. Click on the Umami icon Screenshot 2024-01-31 at 13 18 05 2
4. Now click the "Open desktop icon" button Screenshot 2024-01-31 at 13 32 43
5. It will open a separate tab in your browser asking whether it can open the app. Click the "Open Umami" button Screenshot 2024-01-31 at 13 32 51
6. After that, you'll see the permission request modal, fill the form in with all the required data and click the "Grant" button Screenshot 2024-01-31 at 13 20 39
7. Sign a payload to verify you're the account holder Screenshot 2024-01-31 at 13 40 57

Connect with QR Code

1. Open dApp web page and click on the login icon Screenshot 2024-01-31 at 13 17 51
2. It will open the beacon connect modal window. Click on "Show more" for more options Screenshot 2024-01-31 at 13 17 55
3. Click the "Show QR" button Screenshot 2024-01-31 at 13 18 05
4. Click the "Beacon" button Screenshot 2024-01-31 at 13 20 26
  1. Click on the QR to copy it
6. Open Umami app, go to the "Settings page", click on the "dApps" menu item, and then click the "Paste a peer request code" button Screenshot 2024-01-31 at 13 20 05
7. After that, you'll see the permission request modal, fill the form with all the required data and click the "Grant" button Screenshot 2024-01-31 at 13 20 39
8. Sign a payload to verify you're the account holder Screenshot 2024-01-31 at 13 40 57

Troubleshooting

If something goes wrong during the connection, there is no need to worry.

To start the process again you can:

  • remove dApp connection
  • restart the app
  • refresh the dApp web page

For instance, if you accidentally closed the permission request modal, but the dApp is listed in the dApps drawer, simply click the "Trash" button next to the dApp connection and start the process again

Clone this wiki locally