Enable or Disable Coins in BasicSwap

A new BasicSwap runs Particl, which it needs for itself, plus the coins you chose when you installed. You can add more coins, or switch one off, at any time. Adding a coin downloads its daemon and creates its wallet from your existing recovery phrase, so it needs no new backup. Disabling a coin stops its daemon but keeps its data, so you can turn it back on later without syncing from the start.

Every change follows the same pattern, in which you stop BasicSwap, run the command once for each coin and then start BasicSwap again. The coin names to use are bitcoin, litecoin, monero, wownero, bitcoincash, dogecoin, namecoin, decred, dash, pivx and firo, while Particl always stays on.

Enable a coin

basicswap-bash

With BasicSwap stopped, run the add-coin command:

bsx-addcoin

It lists the coins you can add and asks which one you want. For Bitcoin and Litecoin it also asks whether to use an Electrum light wallet and, for a full Bitcoin node, whether to start from a snapshot, while for other coins it offers to connect to a node you already run. When it's done, start BasicSwap again with basicswap-bash.

Docker

In the basicswap/docker folder, stop BasicSwap, add the coin and start it again:

docker-compose stop
docker-compose run --rm swapclient basicswap-prepare --datadir=/coindata --addcoin=bitcoin --usebtcfastsync
docker-compose up

From source

With BasicSwap stopped, set up the terminal, add the coin and start BasicSwap again:

export SWAP_DATADIR=$HOME/coinswaps
. $SWAP_DATADIR/venv/bin/activate
basicswap-prepare --datadir=$SWAP_DATADIR --addcoin=bitcoin --usebtcfastsync
basicswap-run --datadir=$SWAP_DATADIR

Replace bitcoin with the coin you want, and leave out --usebtcfastsync for any other coin, where it does nothing. A few more options change how the new coin runs:

--btc-mode=electrum or --ltc-mode=electrum adds Bitcoin or Litecoin as an Electrum light wallet instead of a full node.
For Monero or Wownero, you choose a remote node with the environment variables that Prepare options lists.
If your wallets are encrypted, give the password as WALLET_ENCRYPTION_PWD, for example docker-compose run --rm -e WALLET_ENCRYPTION_PWD=yourpassword swapclient basicswap-prepare …, or WALLET_ENCRYPTION_PWD=yourpassword basicswap-prepare … from source.

The new coin then syncs its blockchain, which you can follow on the Wallets page.

Disable a coin

basicswap-bash

With BasicSwap stopped, run bsx-removecoin, enter the coin's name, then start BasicSwap again with basicswap-bash.

Docker

docker-compose stop
docker-compose run --rm swapclient basicswap-prepare --datadir=/coindata --disablecoin=bitcoin
docker-compose up

From source

export SWAP_DATADIR=$HOME/coinswaps
. $SWAP_DATADIR/venv/bin/activate
basicswap-prepare --datadir=$SWAP_DATADIR --disablecoin=bitcoin
basicswap-run --datadir=$SWAP_DATADIR

A disabled coin comes back on when you enable it again in the same way as above.