Liquality is the Universal Crypto Wallet.

With the Liquality Wallet, users can manage their crypto assets and access the decentralized web across a multitude of blockchain ecosystems: Ethereum, Bitcoin, Rootstock, Polygon, Binance Smart Chain, Near, and Arbitrum.

Liquality users not only have access to cross-chain atomic swaps, but also a variety of swap providers through our new in-wallet, native dapp integrations, beginning with 1inch, Uniswap, and Sovryn’s FastBTC Bridge.

In this article, we explain how to use the basic features of the Liquality Wallet extension. This is a living document that will continue to be updated over time.

Document last updated: 2021-09-16, wallet version 0.41.0


Table of Contents

Basics

Restoring and Backing Up Seed Phrases

Using Dapps

Transacting and Swapping

Custom Tokens and Networks


Basics

Q: What is the Liquality Wallet?

The Liquality Wallet is a browser extension for managing crypto assets and accessing the decentralized web. Access Bitcoin, Ethereum Web3, Rootstock, Near, Polygon, and Arbitrum applications and move assets between them through one click, cross-chain atomic swaps.

Check out our Youtube tutorial here.

Back to: Table of Contents

Q: How can I install the Liquality Wallet browser extension?

To download and install the Liquality Wallet, go to our official chrome store listing in Chrome, Brave, or Edge and install the extension safely from the Chrome Web store.

Always double check that the extension ID matches: kpfopkelmapcoipemfendmdcghnegimn

When installing, you’ll also need to accept these permissions to use dapps in your browser:

Just like other browser-extension wallets, Web3 Injection for using dapps requires permissions to read and change all your data on the websites you visit. Liquality never actually reads any data on the websites you visit - the permission just allows us to inject the Web3 API. You can check our source code here.

Back to: Table of Contents

Q: How can I update my Liquality Wallet?

Your wallet should update automatically. If your version has already been updated, you may need to "Re-enable" the extension to enable Web3 Injection.

However, here are the steps in case your wallet hasn’t automatically updated.

Always double-check you have the correct seed phrase backed up. Then go check the current version you have installed in Settings at the button of the extension.

Once you’ve checked, go to https://chrome.google.com/webstore/detail/liquality-wallet/kpfopkelmapcoipemfendmdcghnegimn

If your version is older than the current version then you can "Remove extension" at the bottom of that page and redownload the extension. BUT BEFORE YOU DO: please know that your wallet activity will be erased after you re-install your Liquality wallet, as your activity history only lives inside the current installation. If you re-install, you will see a blank state.

Alternatively, you can also activate the Chrome Developer mode by right-clicking on top of the Liquality extension Icon, then go to ‘Manage extensions’ and activate the Developer mode. If you can find the ‘Manage extensions’ button copy this link and paste it into the search bar: chrome://extensions/?id=kpfopkelmapcoipemfendmdcghnegimn . With this feature you can manually update your Liquality wallet by clicking on the ‘Update’ button that will be available every time a new version comes up.

Back to: Table of Contents

Q: How can I create a new wallet?

To create a new Liquality wallet, you can install it in any of the supported browsers (Chrome, Brave, or Edge) from our official page, then follow the steps to create a new seed phrase. Please remember to back up the newly created seed phrase correctly.

See: Q: How can I install the Liquality Wallet browser extension?

Back to: Table of Contents

Q: I’m having an issue with my Liquality Wallet. What can I do?

If you encounter an issue please do not uninstall your Liquality wallet and contact us in the support chat on our website.  If you don’t receive a response in a timely manner, please message us in our support channel in Discord.

Back to: Table of Contents


Restoring and Backing Up Seed Phrases

Q: How can I import an existing wallet using a seed phrase?

If you just installed a fresh version of the Liquality Wallet, you can click on “Import with seed phrase”, then import your 12 or 24 word seed phrase.

Similarly, to restore an old seed phrase in your Liquality Wallet, you can (1) lock your wallet, (2) click on ‘Forgot password? Import with seed phrase’, (3) then enter your 12 or 24 word seed phrase to restore your wallet.

Note: as of 2021-06-14, multiple accounts are not yet supported. As a result, you may see a discrepancy between the balances your Liquality Wallet shows vs. your actual balance associated with your seed phrase.

Back to: Table of Contents

Q: How can I import an existing wallet using a private key json file?

You can’t yet import a private key into your Liquality Wallet as of 2021-09-16; only seed phrases. However, this feature will be in development in the coming months.

Back to: Table of Contents

Q: Where can I find and backup my seed phrase?

When you create a new wallet inside the Liquality Wallet, you will be prompted through a series of steps to backup your seed phrase.

If you are looking to access your seed phrase again, you can: Go to the top right hamburger menu in the Liquality Wallet extension > Backup Seed > Write down your 12 word seed phrase in order. The seed phrase is the only way to restore your wallet. Write it down, verify it and then store it securely. Only you have access to this seed phrase - our team cannot access it and will not be able to help you recover your funds.

Note: this single seed phrase derives the private keys to all your crypto (Bitcoin, Ethereum, etc.) - please handle with caution!

Back to: Table of Contents


Using Dapps

Q: How can I use ETH dapps with the Liquality Wallet?

Before using an ETH dapp, first go to the hamburger menu button, select Settings, then toggle on the “Default Web3 Wallet” option and select “ETH” as your Web3 Asset. Then go to the dapp (make sure you are on the correct URL) and try to connect again by selecting the “Injected” option or “MetaMask”.

Youtube Tutorial: How to Use Uniswap with the Liquality Wallet https://youtu.be/s4MiJlB_E4o  

Tip: Try having a dedicated browser for each wallet extension (eg. chrome for liquality, brave for metamask) so you minimize your chances of bugs and optimize your experience.

Back to: Table of Contents

Q: How can I use RSK dapps with the Liquality Wallet?

Before using an RSK dapp, first go to the hamburger menu button, select Settings, then toggle on the “Default Web3 Wallet” option and select “RSK” as your Web3 Asset. Then go to the dapp (make sure you are on the correct URL) and try to connect again by selecting the “Liquality”, “Injected”, or “MetaMask” option.

Youtube Tutorial: rBTC Atomic Swap + Sovryn Connection with Liquality https://youtu.be/-xlKuVcfgeA

Here are the list of RSK dapps that are available to use with the Liquality Wallet.

Tip: Try having a dedicated browser for each wallet extension (eg. chrome for liquality, brave for metamask) so you minimize your chances of bugs and optimize your experience.

Back to: Table of Contents

Q: How can I use BSC dapps with the Liquality Wallet?

Before using a BSC dapp, first go to the hamburger menu button, select Settings, then toggle on the “Default Web3 Wallet” option and select “BNB” as your Web3 Asset. Then go to the dapp (make sure you are on the correct URL) and try to connect again by selecting the “Liquality”, “Injected”, or “MetaMask” option.

Here is the list of BSC dapps that are available to use with the Liquality Wallet.

Tip: Try having a dedicated browser for each wallet extension (eg. chrome for liquality, brave for metamask) so you minimize your chances of bugs and optimize your experience.

Back to: Table of Contents


Transacting

Q:  How can I find and copy my address?

Click on the asset you’re interested in seeing the full address for. In the main area, under the balance you’ll be able to see the address of that specific asset. Click the address to copy it to your clipboard. Always double check you’ve copied the correct address before broadcasting a transaction to the network.

Back to: Table of Contents

Q: How can I receive tokens to my Liquality Wallet?

Select the asset you’d like to receive, use the “Receive” button on the right, then either scan your QR code or copy your address. Then from another wallet, send the amount to your Liquality Wallet address.

Back to: Table of Contents

Q: How can I send a transaction from my Liquality Wallet?

Select the asset you’d like to send, use the “Send” button on the left, type an amount you’d like to send (make sure you have enough for mining fees), adjust the network speed/fee accordingly, click “Review”, then confirm.

Back to: Table of Contents

Q: Which token pairs can I swap within the Liquality Wallet?

As of 2021-09-16, you can swap the following pairs through (1) cross-chain atomic swaps, (2) 1inch, (3) Uniswap, and (4) Sovryn's FastBTC Relay, all directly within the wallet:

Compatible Pairs

Coming soon (~Q4 2021)

  • BNB on Binance Smart Chain
  • LUNA on Terra
  • SOL on Solana

Have a request? Let us know.

Back to: Table of Contents

Q: What is the minimum swap size?

To use atomic swaps between the assets listed above, the minimum required is typically around $200 worth:

  • Bitcoin: 0.005 BTC
  • Ethereum: 0.1 ETH
  • Rootstock RSK: 0.005 rBTC (0.0004 RBTC if using Sovryn's FastBTC Relay)
  • Polygon MATIC: 120 MATIC
  • NEAR: 50 NEAR

However, if you'd like to swap via 1inch, Uniswap, or Sovryn's FastBTC Relay within the wallet (instead of atomic swaps), note that these swap providers require different minimums.

For example, you can swap BTC --> RBTC using Sovryn's FastBTC Relay within the Liquality Wallet, with sizes ranging from 0.0004 BTC to 1 BTC.

Back to: Table of Contents

Q: How can I start a swap within the Liquality Wallet?

See Q: How can I receive tokens to my Liquality Wallet?

After creating your wallet, you’ll need to add funds to your Liquality Wallet. Then select the pair you want to swap, enter in the amount you want to swap, adjust the network fees, read the terms, and if you agree with the quote click ‘Confirm’ so the swap process can start. You can always change the network to Testnet and try to make a swap, but remember, the funds on Testnet are for testing purposes only.

Check our video tutorial on how to make a swap on our YouTube channel.

Back to: Table of Contents

Q: How do Liquality's Atomic Swaps work?

Cross-chain atomic swaps are one of the ways to swap assets across blockchains within the Liquality Wallet. Initiating a swap requires each party to escrow their respective funds into smart contracts, known as Hash Time Locked Contracts (HTLC). This dual escrow mechanism ensures that funds are only transferred if both sides fulfill their end of the agreement, thereby removing trust in a third party. In case one or both parties can’t meet the requirement for the swap to complete, the HTLCs will expire, returning the funds to each of their rightful owners.

Back to: Table of Contents

Q: Does Liquality charge fees?

Liquality does not charge fees for transactions or swaps. However, the market rate for a pair is determined by set market makers, who usually charge a 1% spread. Additionally, users will need to pay mining fees, which are charged by the network.

Keep in mind that each atomic swap will require at least two transactions (one to initiate your swap, another to claim your new funds) on your end. Swapping an ERC20 will require three (an additional transaction to approve the ERC20 transfer). You can find more information about this at https://liquality.io/blog/liquality-solutions-to-atomic-swap-limitations/

Back to: Table of Contents

Q: How can I swap through Uniswap within the Liquality wallet?

We recently added the popular Ethereum DEX Uniswap in version 0.37.0 of the wallet, to provide more liquidity and swapping pairs to our users.

To use Uniswap as your swap provider, first select an Ethereum asset, like ETH, then click ‘Swap’. Select another Ethereum asset as your destination - in this example, we’re going from ETH to USDT.

In the wallet you’ll see a chip next to the ‘Rate’ area. You will likely see a quote here from Liquality, Uniswap, or 1inch (as of version 0.37.0 of the wallet). If you see Uniswap already, then simply select the network fees you’d like to use, click “Review”, then “Initiate Swap” accordingly.

However, if you don’t see Uniswap, you can click “See all 3 quotes” and manually select Uniswap. Then select your network fees, click “Review”, then ‘Initiate Swap’ accordingly.

You can click on “Swap Types” to learn more about the different swap providers within the Liquality Wallet.

If you have suggestions for new DEXes / dapps you’d like to see natively integrated within the Liquality Wallet, let us know through our feedback form or our Discord channel.

Of course, you always have the option to manually connect to Uniswap and swap through their interface rather than directly within the Liquality Wallet - see Q: How can I use ETH dapps with the Liquality Wallet?

Back to: Table of Contents


Custom Tokens & Networks

Q: How can I add custom tokens to my Liquality Wallet?

Go to the Menu button in the top-right corner, then select “Manage Assets”, you’ll see a screen with all assets displayed if you can’t find the token you want, you can click on the “Add Custom Token” button and fill the required information (Contract Address, Decimals, Chain, Name and Symbol).

Make sure to double-check that you’ve filled out the token information correctly. You can find a custom token’s information on block explorers like Etherscan.

Back to: Table of Contents

Q: How can I remove custom tokens from my Liquality Wallet?

As of 2021-09-16, you can’t yet remove custom tokens, though you can hide custom tokens under the Manage Assets tab by toggling off the asset. We expect to add the ability to remove tokens completely by the end of 2021.

Back to: Table of Contents

Q: How can I add a custom RPC network to my Liquality Wallet?

As of 2021-09-16, you can’t yet add a custom RPC network. We expect to add this functionality by the end of 2021.

Back to: Table of Contents