Frequently Asked Questions (FAQ)



What is Liquality?

Liquality is a vision for a more open and equitable future, where anyone can access the global digital economy in a free, secure, and efficient way. Contributors enable Liquality by building the tools and solutions for accessible and efficient liquidity networks. Our first product is an interface that offers the most secure way to swap cryptocurrencies, where counterparty risk and fees are significantly reduced by using atomic swaps. This is the first step towards building a value management system that allows for shared, accessible, and efficient liquidity networks.

How is Liquality different?

  • No Middlemen: disintermediation minimizes the risk and cost associated with swapping cryptocurrencies, including unnecessary tokens, deposits, or withdrawals
  • Cross-Chain: there is no need for false representations of Bitcoin, like wBTC, as participants can swap cryptocurrencies across blockchains
  • No Counterparty Risk: atomic swaps are programmatically guaranteed to either happen securely or refund both parties
  • Key Ownership: the interface's bring-your-own-wallet (BYOW) approach empowers users to retain control and custody over their funds
  • Open Source: all code is open source and promotes freedom

What are Atomic Swaps?

Atomic swaps are a type of transaction that enables the peer-to-peer exchange of one cryptocurrency for another without intermediaries like centralized or decentralized exchanges. In order for a swap to be "atomic" - to either happen successfully or not at all - both parties of a swap must acknowledge the receipt of funds within a specified timeframe using a cryptographic hash function. If one of the parties fails to confirm the transaction within the timeframe, then the entire swap is voided and the escrowed funds are refunded to the respective parties. Note that there are no scenarios in which one party controls both coins simultaneously, minimizing counterparty risk and exchange fees. Learn more on our Atomic Swaps Explainer.

What are Hash Time Locked Contracts (HTLCs)?

Atomic swaps are based on Hash Time Locked Contracts (HTLCs), which are essentially escrows that enable conditional payments. As its name denotes, an HTLC is a time-bound smart contract between parties that involves the generation of a cryptographic hash function, which can be verified between them. HTLCs form the foundation for atomic swaps - a user and her counterparty create these HTLC escrows on their respective chains, and the funds that are deposited into the two escrows of the swap are properly locked and released. This dual escrow mechanism reduces the need to trust the counterparty for proper execution of the trade. Liquality's cross-chain atomic swaps are a modification to the Tier Nolan approach to atomic swaps and leverages HTLC standards BIP199 and ERC1630.

What are User Owned-and-Deployed, Disposable Contracts?

Whereas existing decentralized exchanges force users to swap cryptocurrencies through a centrally-owned hub contract (where the admins of the contract control its functionality - e.g. Bancor's kill switch), Liquality empowers its users to easily own and deploy contracts for each atomic swap. The Liquality open-source smart contract templates leverage community standards for HTLCs, have been reviewed by professional security experts, and are unique / disposable to each swap. This makes swapping cryptocurrencies more secure (no central smart contract to hack), private (each swap has its own set of contracts that only users can own, deploy, access, and operate), disintermediated (no admin control or kill switch), and cost efficient. Learn more about why decentralized exchanges (DEX) are insecure.

How do I find a Counterparty for my atomic swap?

Liquality's cross-chain atomic swap Alpha interface does not have a discovery or matching mechanism. It is purely an execution and settlement interface for conducting atomic swaps, meant to eliminate counterparty risk and fees. Users should utilize their networks, communities, groups, and other means to find a counterparty and agree on a price before using Liquality's interface to execute and settle swaps.

I don't trust the atomic swap interface. Why should I trust Liquality and how can I verify your software?

Contributors are staunch advocates for the "Don't trust; verify" movement. You don't have to trust Liquality, and you shouldn't need to. Here are some factors that may affect your decision to use the interface: 1) There is no third party in Liquality swaps as users own and deploy their own contracts for each atomic swap; 2) atomic swap parameters are verified by your browser to make sure you are running the latest version of the code and deploying the correct contracts; and 3) everything we do is completely open source so you can explore, download, run, and fork our repositories at any time.

My bitcoins aren't showing up on my Ledger Live interface - what's happening?

Liquality's Alpha software currently only supports Bitcoin (BTC) legacy transactions (Segwit is not yet supported). In order to view your Bitcoin (BTC) legacy balance, go to your LedgerLive once you have completed your swap, then click: New Account → Bitcoin → Legacy → add.

What's coming next for Liquality?

Our cross-chain atomic swap Alpha interface is the first step towards building a value management system that allows for shared, accessible, and efficient liquidity networks. Over the coming months, users can expect:

  • More wallet support, especially for Trezor devices + Segwit addresses
  • More token support beyond BTC/ETH pairs: Other UTXO-based coins, like Litecoin (LTC); Ethereum-based tokens, including the DAI stablecoin and other ERC20s; and privacy coins, like Monero (XMR), ZCash (ZEC), and Grin (GRIN)
  • Further parameter customization (e.g. swap lock time)
  • Custom node deployment, configuration, and signing for automated cross-chain atomic swaps
  • Near-real-time cross-chain atomic swaps through Layer 2 solutions
  • Ability to share liquidity pools with chosen users (e.g. dark pools)

Which wallets are compatible with Liquality?

Currently, the cross-chain atomic swap interface supports MetaMask and Ledger devices. We will be enabling more wallets in the coming months, starting with Trezor. If you want to help us integrate a new wallet, please add a provider for it in our open source Chain Abstraction Layer and reach out on our Telegram.

Which browsers are compatible with Liquality?

Currently, the cross-chain atomic swap interface only works on the Chrome browser. We will be adding support for other browsers, such as Firefox and Safari over the coming months.

Does Liquality charge fees / are there any fees when using Liquality?

Liquality does not and could not charge an exchange fee, as atomic swaps are entirely peer-to-peer via user-owned-and-deployed contracts. This makes using Liquality cheaper and more secure than existing alternatives. Users still have to pay mining fees on the respective blockchains they are swapping on, and those will vary depending on each network's transaction congestion.

How do Liquality contributors make money?

We believe the exchange of value is a universal human right - the base layer for exchange should remain accessible, neutral, and censorship-resistant, not monetized by unnecessary intermediaries. Liquality will make money by providing users with useful products and value-add services that sit on top of the base layer of exchange, bringing us closer to shared, accessible, and efficient liquidity networks.

Are my funds safe while swapping with the Liquality atomic swap interface?

You are always in complete control and custody of your funds. When a user initiates an atomic swap, their funds are locked in an escrow (HTLC) until the counterparty has locked their funds in an escrow - these escrows cannot be tampered with or hacked and they are bound by the parties' private keys. In other words, the atomic swap is programmatically guaranteed to ensure a successful swap or refund to both parties. As long as you properly secure your private keys, your funds are safu.

I received less money than what I had initially agreed with my counterparty - what happened?

This is due to mining fees that are taken out of users' swaps. Liquality's interface estimates mining fees in real time so that your swap is included and mined within the next two blocks. These mining fees will vary depending on each network's transaction congestion and will be shown to you in your MetaMask or Ledger wallet respectively.

How long do Cross-Chain Atomic Swaps take?

Because atomic swaps are currently executed on-chain, they will move at the speed of the slowest chain - if a swap involves Bitcoin, each step that involves a Bitcoin transaction will take ~10 min (longer if the network is congested). This means most swaps will execute and settle within ~20 min if all counterparties are online and active for Bitcoin transactions, and under 1 minute if the swap is solely on Ethereum. We are working on enabling configurable options to speed up cross-chain swaps, including near-real-time swaps via Layer 2 solutions and 0 confirmation Bitcoin swaps.

What happens if the counterparty doesn't confirm the terms or claim the swap?

If a counterparty backs out of a swap, you will be able to refund your assets after the lock up period (in the Alpha launch, the lock up period is set for 12 hours - this parameter will be configurable moving forward). After the lock up period, a refund screen will appear on the interface so you can refund your assets. You will need your wallet to sign another transaction in order to unlock and refund the funds held in the HTLC escrow. There will never be a situation where you give away your assets without getting the counterparty's assets in return. The atomic swap either happens for both parties or none at all and you all get your assets back.

Do I need to be online for the entirety of the swap?

You do not need to be online for the entirety of the swap, however, it is recommended that you leave your browser open and save the backup link. If you are planning on closing your browser session, make sure you copy and save the backup link generated after initiating the swap, so that you can get back to your swap without any issues.

What happens if I lose the backup link and my browser closes?

If you lost the backup link and the respective browser session, send us a note via the Crisp chat interface (bottom right of interface) and Liquality contributors will work with you to recover your funds.

Which tokens and chains are currently supported?

Liquality's interface currently supports Bitcoin (BTC) and Ethereum (ETH) for the Alpha phase. As we move forward, we plan to offer more token support beyond BTC/ETH pairs, including: Other UTXO-based coins, like Litecoin (LTC); Ethereum-based tokens, including the DAI stablecoin and other ERC20s; and privacy coins, like Monero (XMR), ZCash (ZEC), and Grin (GRIN). If you would like to integrate a specific token / asset into our cross-chain atomic swap protocol, please check out and contribute to the open source Chain Abstraction Layer, the base for our Liquality interface.

Is it possible to export transaction history from Liquality?

At this moment, it is not possible to export transaction history with Liquality, as Liquality contributors have no control over your transactions, and each transaction uses its own user-owned-and-deployed disposable contracts.

Do I need to register to access Liquality?

You do not need to register to access Liquality - all you need are your wallets and your counterparty's addresses to start swapping. Down the line we will enable optional KYC integrations for institutions who need to meet specific compliance measures, while assuring that an alternative remains in place for everyone.

Is there mobile support for cross-chain atomic swaps with Liquality?

At this moment, there is no mobile support for cross-chain atomic swaps although it is on our medium term roadmap. If you have the technical skills and interest, please check out the Chain Abstraction Layer and expand it to support mobile transactions - we have made the Chain Abstraction Layer modular and simple enough so that our community can expand it beyond our imagination!

Where can I find more information about Liquality?

You can read more about Liquality in our Blog, contribute to / follow our development progress on our Github, and join the community discussion on our Telegram.

What is the Chain Abstraction Layer (CAL)?

The Chain Abstraction Layer is reference library for developers that abstracts away blockchain logic for simple cross-chain interoperability and interoperable blockchain development. Projects that are using the Chain Abstraction Layer include: Atomic Loans. If you would like to help build Liquality's vision, feel free to comment on, use, and extend the CAL.