Remy Froissart, CNRS

img width: 750px; iframe.movie width: 750px; height: 450px; Liquality wallet setup guide usage tips troubleshooting

Liquality Wallet Setup Guide Usage Tips and Troubleshooting Steps

Before initializing the application, verify the official browser extension source. Download only from the project's primary GitHub repository or the official Chrome Web Store page to avoid counterfeit software.

Your secret recovery phrase is the master key. Write these 12 words on physical paper, store them offline, and never digitize them. This sequence is the only method to restore access if your device fails.

Configure custom RPC endpoints for networks like Ethereum or Bitcoin to enhance privacy and reliability. Using your own node or a trusted provider's endpoint prevents dependency on default public services, which can be slow or censored.

For atomic swaps, always check the proposed exchange rate against market aggregators before confirming. The interface displays the expected receive amount; a significant deviation indicates unfavorable network congestion or liquidity conditions.

If a transaction appears stuck, first confirm its status on a block explorer using the transaction ID. Nonces can conflict; resetting the connection within the extension's advanced settings often clears pending actions.

Persistent interface errors may require clearing the extension's local data. Re-import your account with the recovery phrase afterward–this resolves most display and synchronization issues without affecting on-chain assets.

Liquality Wallet Setup Guide, Usage Tips & Troubleshooting

Install the browser extension directly from the official Chrome Web Store or Firefox Add-ons page to avoid malicious clones.

Your 12-word secret recovery phrase is the master key. Write it on paper, store it physically, and never share it digitally. Losing this phrase means permanent loss of all assets.

After restoring a portfolio, manually re-add each network (like Bitcoin, Ethereum, Arbitrum) and specific tokens through the interface; balances often don't auto-populate.

For a stuck transaction, check the blockchain explorer using your address. If it's pending with a low gas price, you might need to wait for network clearance or use a nonce management tool to override it.

Atomic swaps require precise counterparty matching. Verify the recipient's address, the exact amount, and the agreed-upon exchange rate on the negotiation screen before locking your funds. A single-digit error is irreversible.

Clear your browser cache and restart the application if the interface fails to load balances or connect to nodes. Ensure you're not using a VPN or firewall that blocks RPC communications on ports 8545 or 8332.

Installing the Extension and Creating Your First Vault

Navigate directly to the Chrome Web Store, Firefox Add-ons, or the official project repository to acquire the browser add-on. Confirm you are downloading the legitimate software by verifying the publisher's name and the number of active users. After clicking 'Add to Browser,' the icon will appear in your toolbar; pin it for immediate future access.

Click the toolbar icon and select 'Create New Vault.' You will be presented with a 12-word secret recovery phrase. This sequence is the absolute master key to your assets and identity on-chain. Write these words down in the exact order on durable, offline material–never store them digitally. The software will then require you to re-enter a random selection of those words to confirm accuracy. Choose a strong, unique password that encrypts the local data on this device.

Your initial deposit address is now active. Before transferring significant value, conduct a test with a minimal amount. Use the 'Receive' function to copy your address, double-checking the first and last four characters against the one shown in the interface. This verification step prevents clipboard malware from hijacking transactions. Once the test transaction confirms on the network, your self-custody vault is operational and ready for managing holdings or connecting to decentralized applications.

FAQ: I installed Liquality but my balance shows zero, even though I know my wallet has funds. What's wrong?

The most common reason for this is being connected to the wrong network. Liquality supports multiple networks (like Mainnet, Testnets) for each blockchain. Check the network selector in the top corner of the wallet interface. If you're on a testnet like Ropsten for Ethereum, you won't see your Mainnet funds. Switch it to the correct main network (e.g., “Ethereum Mainnet”). Also, ensure you've imported the correct account and that the wallet is fully synced. If the issue persists, try re-adding the asset using the 'Add Asset' button.

Can I use Liquality to swap between Bitcoin and Ethereum directly?

Yes, that's a core feature. Liquality has a built-in atomic swap function. Go to the 'Swap' tab. Select Bitcoin as the source asset and Ethereum (or an ERC-20 token) as the destination. You'll need to have the Bitcoin in your Liquality wallet to initiate. The process is peer-to-peer and non-custodial, meaning you don't send funds to a central exchange. It requires a counterparty, so liquidity depends on other users being online to take the other side of the trade. Swaps can take between 10 to 60 minutes to complete.

Is it safe to enter my seed phrase into Liquality during setup?

Your seed phrase is only ever processed locally on your computer. It is never sent over the internet or to Liquality's servers. The wallet generates your private keys directly in your browser. For maximum security, perform the initial setup on a clean, malware-free device. Consider writing the phrase on paper and storing it physically. Never share these words with anyone. If you're restoring an existing wallet, double-check you're on the official Liquality website to avoid phishing scams.

A swap failed and my funds are stuck. What should I do?

First, don't panic. Funds in a failed atomic swap are typically locked in a time-bound contract. Go to the 'Swap History' section and find the failed transaction. There should be an option to 'Refund'. This action allows you to reclaim your source coins after the lock-time expires (this period is shown in the swap details). You'll need to pay a network fee to execute the refund. If the refund button is inactive, the lock-time may not have passed yet. Wait and check back later. Contacting support with your swap ID can help if you encounter errors during the refund process.

What are the main differences between creating a new wallet and restoring an old one in Liquality?

Choosing “Create a new wallet” will generate a brand new 12-word seed phrase. This is for users starting fresh. Selecting “I already have a wallet” (Restore) is for importing an existing wallet using its seed phrase. This will give you access to all the accounts and funds associated with that original phrase. A key point: when restoring, you must select the same derivation path that was used originally to find your specific accounts. Liquality suggests a default path, but if your old wallet used a different one, you might need to adjust it to see your balances.

I installed Liquality but my balance shows zero, even though I can see the transaction on the blockchain. What's wrong and how do I fix it?

This is a common issue and usually means the wallet isn't displaying assets for a network you've used before. Liquality wallet extension tutorial is a multi-chain wallet, so you need to add the specific network and asset. First, check which network your transaction was on (e.g., Polygon, Arbitrum, Rootstock). Then, in your Liquality wallet, click “Manage Assets.” Find and enable the network if it's not already active. Once the network is enabled, you'll see a list of assets on that chain; make sure the token you're looking for (like ETH, MATIC, or a specific token) is toggled on. Your balance should appear immediately. If the token is custom, you may need to add its contract address manually using the “Add Custom Token” feature.

Is my recovery phrase stored somewhere if I use the Liquality browser extension? How do I move my wallet to a new computer?

No, Liquality does not store your recovery phrase. It is generated and encrypted locally on your device. Only you have access to it. To move your wallet to a new computer, you must have your original 12-word recovery phrase. First, install the Liquality extension on the new computer. During setup, choose “Restore Wallet” instead of creating a new one. Enter your recovery phrase exactly as you saved it. After restoration, your wallet will show all your accounts and balances. You should also re-add any custom networks or tokens you were using. Before deleting the extension from the old machine, ensure everything works on the new one. Never enter your recovery phrase on a website—only directly into the trusted extension.