Your Liquality Wallet Guide Setup Steps Common Issues and Solutions
Install the browser extension directly from the Chrome Web Store or Firefox Add-ons portal. After adding it, pin the extension to your toolbar for immediate access; this single click will be your primary gateway to managing digital assets across blockchains like Bitcoin, Ethereum, and Polygon.
Your first launch initiates vault creation. Securely record the generated 12-word secret recovery phrase on physical media–never digitally. This phrase is the absolute master key to your funds. Confirm backup by accurately re-entering the words in the prompted order. Choose a strong, unique password that encrypts the vault locally on your device.
Fund the vault by selecting a network and asset, then copying your deposit address. For Ethereum-based tokens, always verify sufficient ETH exists in that address to pay transaction fees for subsequent sends or swaps. Use the built-in cross-chain atomic swap function to exchange assets directly between chains without centralized intermediaries, carefully reviewing the exchange rate and time lock before confirming.
Encountering a stalled transaction? First, check the network status on a block explorer using your public address. If a transaction remains pending, you can often accelerate it by submitting a new transaction with a higher gas fee, using the same nonce. For persistent interface errors, clear the extension’s cache via its settings or try reinstalling–your funds remain secure as long as you possess your secret phrase.
Regularly verify you are interacting with the correct application URL, as phishing sites mimic interfaces. Bookmark genuine dApp websites. For unresolved connectivity problems, manually switch your RPC endpoint in the network settings. Keep the extension updated to ensure compatibility with the latest chain upgrades and security patches.
FAQ:
I installed Liquality but my balance shows zero, even though I can see my funds on the blockchain explorer. What’s wrong?
This is a common display issue, not a loss of funds. Your assets are safe on the blockchain. First, ensure you’ve added the correct asset to your wallet view. Click the “Add Asset” button and select the token (like ETH, WBTC, or USDC) you’re looking for. If the balance still doesn’t show, the likely cause is a network RPC connection problem. Go to Settings > Network. For the network you’re using (e.g., Ethereum Mainnet), try switching to a different public RPC provider from the list. This refreshes your wallet’s connection to the network and typically resolves balance display issues.
Can I use my existing MetaMask seed phrase to set up Liquality?
No, you cannot directly import a MetaMask seed phrase. Liquality generates its own unique 12-word recovery phrase during setup. However, you can import individual MetaMask accounts as watch-only addresses. In Liquality, go to “Add Account” and choose “Import an Address.” You can then paste the public address from your MetaMask. This lets you view balances and create transactions, but to sign those transactions, you’ll need to connect your MetaMask hardware device (like a Ledger) to Liquality or manually approve them in MetaMask. For full functionality, setting up a new native Liquality wallet is recommended.
How do I actually swap tokens using Liquality? The process seems different from a regular exchange.
Liquality is a wallet with integrated atomic swap functionality, not a custodial exchange. The process is peer-to-peer. Here’s a step-by-step: 1) Ensure both assets (the one you’re sending and the one you want) are in your wallet. 2) Click the “Swap” tab. 3) Select the networks and tokens for the swap. 4) You’ll see a list of available counterparties (makers) with their exchange rates. Choose one. 5) A detailed order screen shows the amounts, fees, and time limit. Review it. 6) If you agree, click “Initiate Swap.” You’ll then need to approve the token spend (if required) and confirm the transaction from your wallet. The swap will execute automatically across chains once the counterparty responds.
My swap is stuck on “Pending” for a long time. What should I do?
A stuck “Pending” state usually means the transaction is waiting for blockchain confirmations or the counterparty hasn’t acted. First, check the transaction ID on a block explorer to see its real status. If it’s confirmed but the swap hasn’t progressed, the issue may be with the counterparty. Liquality swaps have a time limit. If this expires, your funds will be refunded to the original wallet automatically. Do not close the app or restart the swap while it’s pending, as this might complicate the refund process. You can try using a higher network fee (gas price) for future swaps to avoid initial delays.
Is it safe to connect my Ledger hardware wallet to Liquality?
Yes, connecting a Ledger is a secure method to use Liquality. The process keeps your private keys isolated on the hardware device. When you connect, you are only granting the wallet interface permission to request signatures from your Ledger. For every transaction or swap, you must physically approve it on the Ledger device itself. This means your seed phrase never leaves the Ledger. Ensure you only download Liquality from the official browser store or GitHub repository to avoid phishing versions. Always verify the transaction details shown on your Ledger screen match those in the Liquality interface before approving.
I installed the Liquality browser extension but it’s not showing up in my toolbar. How can I fix this?
First, check if the extension is enabled. In Chrome, go to `chrome://extensions/`; in Firefox, go to `about:addons`. Ensure the toggle for Liquality is on. If it’s enabled but still not visible, your browser toolbar may be crowded. Look for a puzzle piece or extensions menu icon in your browser’s top bar—Liquality might be hidden there. You can usually pin it from that menu for direct access. If it’s completely missing, try a clean reinstall: remove the extension, restart your browser, and install it again from the official Chrome Web Store or Firefox Add-ons site.
