Frequently Asked Questions (FAQ)
Find an answer to the most frequently asked questions that you may have about BasicSwap DEX.
Getting Started
How do I set up BasicSwap?
1- Open the build instructions here.
2- Follow them to build and launch BasicSwap.
3- Give the client and wallets time to sync. You can track progress on the Wallets page.
4- Once the blockchains have synced, you're ready to swap.
How does BasicSwap work under the hood?
For a detailed walkthrough of how BasicSwap works, see this page.
How can I deposit coins?
1- Open BasicSwap and go to the Wallets page.
2- Find the coin you want to deposit and click its Manage button.
3- Copy the deposit address BasicSwap shows you.
4- Send your funds to that address.
How can I withdraw coins?
1- Open BasicSwap and go to the Wallets page.
2- Click the Manage button next to the coin you want to withdraw.
3- Enter the destination address and the amount, and check both carefully.
4- Click Withdraw to send the transaction.
How can I place or take an offer on the order book?
The full steps for placing and taking offers are in the documentation. See the guides for placing an offer and taking an offer.
How can I follow the progress of an ongoing swap?
1- Open the Swaps in Progress tab in BasicSwap.
2- Click the BID ID of the swap you want to track.
3- Check the Swap Progress section to see which stage of the atomic swap it's at.
User Experience
Does BasicSwap require a native coin or token to use?
No. BasicSwap has no native coin, no token, and no monetization layer, so nothing sits between you and a swap. That also makes it a clean base layer for other apps and services to build on.
What coins are available to trade?
BasicSwap is open-source, so anyone can work on adding a coin. You can see the current list of supported coins here.
If you want to add one, follow these integration examples.
What are the fees?
0%. BasicSwap charges no trading or service fees. Because swaps settle on-chain, you still pay the normal network fee for each coin you move, usually a few cents, sometimes less.
How long does it take to set up BasicSwap?
Setup has two parts: building the application, and getting the coins you enable ready to use. The build usually takes 10 to 30 minutes, depending on your machine and how closely you follow the steps. There is also a community Linux script here.
How long the coins take depends on whether you run them as full nodes or in lightweight mode. In lightweight mode there is almost nothing to wait for: the script coins (Bitcoin, Litecoin, and so on) read chain state from public Electrum servers, and Monero and Wownero use remote nodes, so you can swap without syncing a chain yourself. See the lightweight modes guide for the details.
If you prefer to run full nodes, you sync each chain locally, which takes longer and depends on your connection. For Bitcoin, the fast-sync option loads a pruned chain snapshot and cuts sync time by more than 90%. For Monero, you can start swapping before the chain finishes syncing, because it temporarily connects to a public node while it catches up.
How long does it take to complete a swap?
It depends on the coins involved. BasicSwap uses atomic swaps, so every swap settles on-chain and waits for confirmations on both chains. That ties swap time to each chain's block time.
For a rough estimate, take the block time of the coin being swapped and multiply by 6, or by 10 for Monero, which is about the number of confirmations a swap needs to finish.
What are the types of order?
BasicSwap currently supports limit orders only. More order types may arrive as contributors keep building on the protocol.
What happens if a swap fails?
If something goes wrong mid-swap, both sides are refunded automatically, at no extra cost, because the swap is atomic.
An atomic swap only moves to the next step when its exact conditions are met. If they are not, the swap times out and the coins, held in the swap's time-locked addresses, return to their original owners.
Is there any way for a swap to get “stuck”?
No. The atomic design means a swap cannot get stuck. If a condition is never met, or one side stops taking the required steps, the coins return to their owners automatically after a set time. They cannot stay locked in a swap.
Do you need to run a local node to perform a swap?
For now, your BasicSwap node needs to stay online for the whole swap.
BasicSwap uses the peer-to-peer SecureMessaging network (SMSG) to pass the data each atomic swap step needs between the two sides. Because the steps run in sequence, your node has to be online to send that data when it is needed.
Can I run my node on a cloud server or VPS?
Yes. Running BasicSwap on a VPS is a practical way to keep it online 24/7, and a cloud instance is a good idea if you plan to run the automated market making script. One caveat: BasicSwap runs the official core wallet of every coin you enable, so a third-party server carries real risk. Encrypt your instance if you go this route.
Do you collect any data about me?
No. BasicSwap is peer-to-peer and open-source. There is no central party, operator, or service provider to collect or share your data. This website stores nothing about you either.
Technology
Is BasicSwap ready to use today?
Yes. BasicSwap is live on mainnet and runs reliably for everyday swaps. It is also under active development: some features are still being refined or added, and the long-term goal reaches well beyond what ships today. Opening it up to more users now is how that gets built, through real feedback and real-world testing.
What are the core components of the BasicSwap DEX?
BasicSwap is best understood as a decentralized version of the SWIFT messaging network. All it does is pass messages between two peers over the decentralized SMSG network so they can run a coin swap together, with no central party involved.
BasicSwap does not do the swap itself. The swap runs as an on-chain atomic swap on the blockchains of the coins being traded. BasicSwap's job is to let the two sides talk: to exchange the data an atomic swap needs, and to broadcast offers publicly without an intermediary.
It rests on three components: the atomic swap protocol layer, the SecureMessaging network (SMSG), and the official coin cores of the coins you swap. A user-friendly GUI wraps all of it.
Atomic swaps: the mechanism that lets two parties swap directly, with no intermediary. Coins are held in time-locked addresses under a condition-based process until every condition is met. If any step fails, the swap is voided and the coins return to their owners after a set time. Read more about atomic swaps here, and about Monero atomic swaps here.
SecureMessaging: a peer-to-peer, decentralized messaging network (a mixnet) that lets two peers who want to swap reach each other and share the data, such as transaction hashes and proofs, that satisfies the atomic swap's conditions. It gives blockchain interoperability with no central control, and it also powers other DEX functions like BasicSwap's decentralized order book. Read more about SMSG here.
Coin cores: BasicSwap has no wallet of its own. It uses the official coin cores of the coins you swap. When you set it up, you install the cores (Bitcoin Core, Litecoin Core, and so on) that hold your coins and run the atomic swaps. You can also point BasicSwap at existing nodes, local or remote.
Is the order book really entirely decentralized?
Yes. BasicSwap's order book is fully decentralized, with no central point of failure and no centralized parts. It runs on the SecureMessaging (SMSG) network, so it is fully distributed. For how SMSG makes that work, read more here.
Who runs the SMSG network that powers the DEX?
SMSG is a global peer-to-peer network of nodes. When you run BasicSwap, you become one of those nodes. The network's strength comes directly from the people running BasicSwap.
Does BasicSwap connect to a third-party service?
BasicSwap's core functions do not rely on any third-party service; the protocol is fully decentralized, with no central point of failure. Some convenience features in the interface, like historical price charts, may pull data from external APIs.
Is BasicSwap dependent on a team or organization to operate and function?
No. BasicSwap is fully open-source and decentralized, so it does not depend on any team or central organization. If all community development stopped today, BasicSwap would keep working exactly as it does now.
What makes the BasicSwap network stable?
Every user runs a peer-to-peer node, so the DEX keeps running as long as people use it. That is the whole basis of its stability.
Are Monero swaps truly decentralized? What’s the catch?
It is a fair question, and there is no catch. BasicSwap uses h4sh3d's Monero atomic swap protocol; everything else runs on the SecureMessaging (SMSG) network and scriptless scripts. There are no wrapped Monero tokens, no intermediary chains, and no workarounds.
How can I verify and audit BasicSwap’s code?
All of it is open-source. To audit or just read the code, visit the GitHub. You can check every line yourself and confirm BasicSwap does exactly what it says.
Get Involved
How can I learn more about BasicSwap?
This FAQ is a good start. For more depth, head to the documentation.
How can I get in touch with the community?
Join the Matrix channel and say hello.
How can I get involved or help the BasicSwap project?
There are many ways to help, including contributing code. You do not have to be a developer, though. The two most useful things you can do are spread the word about BasicSwap and provide liquidity. More users and deeper liquidity are what make the DEX more usable and a real alternative to centralized exchanges. Every bit helps, whatever its size.
How can I provide liquidity on the order book?
Adding liquidity, and earning from arbitrage along the way, is straightforward with the automated market making script. For step-by-step instructions, see the market making guide, or watch the video tutorials.