Host-customized fork of https://github.com/tecnovert/basicswap/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
162 lines
4.3 KiB
162 lines
4.3 KiB
|
|
## Source code |
|
|
|
$ git clone https://github.com/tecnovert/basicswap.git |
|
|
|
|
|
## Run Using Docker |
|
|
|
Docker must be installed and started: |
|
|
|
$ docker -v |
|
|
|
Should return a line containing `Docker version`... |
|
|
|
|
|
It's recommended to setup docker to work without sudo: |
|
|
|
https://docs.docker.com/engine/install/linux-postinstall/ |
|
|
|
|
|
#### Create the images: |
|
|
|
$ cd basicswap/docker |
|
$ docker-compose build |
|
|
|
|
|
#### Prepare the datadir: |
|
|
|
Set XMR_RPC_HOST and BASE_XMR_RPC_PORT to a public XMR node or exclude to run a local node. |
|
Set xmrrestoreheight to the current xmr chain height. |
|
Adjust `--withcoins` and `--withoutcoins` as desired, eg: `--withcoins=monero,bitcoin`. By default only Particl is loaded. |
|
|
|
$ export COINDATA_PATH=/var/data/coinswaps |
|
$ docker run --rm -e XMR_RPC_HOST="node.xmr.to" -e BASE_XMR_RPC_PORT=18081 -t --name swap_prepare -v $COINDATA_PATH:/coindata i_swapclient \ |
|
basicswap-prepare --datadir=/coindata --withcoins=monero --htmlhost="0.0.0.0" --xmrrestoreheight=2485205 |
|
|
|
**Record the mnemonic from the output of the above command.** |
|
|
|
|
|
##### FastSync |
|
|
|
Use `--usebtcfastsync` to optionally initialise the Bitcoin datadir with a chain snapshot from btcpayserver FastSync. |
|
[FastSync README.md](https://github.com/btcpayserver/btcpayserver-docker/blob/master/contrib/FastSync/README.md) |
|
|
|
|
|
#### Set the timezone (optional): |
|
|
|
Edit the `.env` file in the docker directory, set TZ to your local timezone. |
|
Valid options can be listed with: `timedatectl list-timezones` |
|
|
|
|
|
#### Start the container: |
|
|
|
$ export COINDATA_PATH=/var/data/coinswaps |
|
$ docker-compose up |
|
|
|
Open in browser: `http://localhost:12700` |
|
|
|
|
|
|
|
### Add a coin |
|
|
|
$ docker-compose stop |
|
$ export COINDATA_PATH=/var/data/coinswaps |
|
$ docker run --rm -t --name swap_prepare -v $COINDATA_PATH:/coindata i_swapclient basicswap-prepare --datadir=/coindata --addcoin=bitcoin |
|
|
|
You can copy an existing pruned datadir (excluding bitcoin.conf and any wallets) over to `$COINDATA_PATH/bitcoin` |
|
Remove any existing wallets after copying over a pruned chain or the Bitcoin daemon won't start. |
|
|
|
|
|
|
|
## Windows |
|
|
|
#### Setup WSL 2 and Docker Desktop |
|
[docs.docker.com/docker-for-windows/wsl](https://docs.docker.com/docker-for-windows/wsl/) |
|
|
|
|
|
Open a wsl terminal |
|
Windows key + R -> "wsl" -> Enter |
|
|
|
|
|
Install Git: |
|
|
|
$ sudo apt update |
|
$ sudo apt install git |
|
|
|
|
|
Download the BasicSwap code: |
|
|
|
$ git clone https://github.com/tecnovert/basicswap.git |
|
$ cd basicswap/docker/ |
|
|
|
|
|
It's significantly faster to set COINDATA_PATH in the linux filesystem. |
|
You can access it from the windows side at: `\\wsl$\Ubuntu` |
|
|
|
Continue from the [Run Using Docker](#run-using-docker) section. |
|
|
|
|
|
## Run Without Docker: |
|
|
|
|
|
### Ubuntu Setup: |
|
|
|
$ apt-get install -y wget python3-pip gnupg unzip protobuf-compiler automake libtool pkg-config |
|
|
|
### OSX Setup: |
|
|
|
Install Homebrew: |
|
|
|
https://brew.sh/ |
|
|
|
Command Line Tools: |
|
|
|
$ xcode-select --install |
|
|
|
Dependencies: |
|
|
|
$ brew install wget unzip python git protobuf gnupg automake libtool pkg-config |
|
|
|
|
|
### Basicswap: |
|
|
|
$ export SWAP_DATADIR=/Users/$USER/coinswaps |
|
$ mkdir -p "$SWAP_DATADIR/venv" |
|
$ python3 -m venv "$SWAP_DATADIR/venv" |
|
$ . $SWAP_DATADIR/venv/bin/activate && python -V |
|
$ cd $SWAP_DATADIR |
|
$ wget -O coincurve-anonswap.zip https://github.com/tecnovert/coincurve/archive/anonswap.zip |
|
$ unzip coincurve-anonswap.zip |
|
$ cd $SWAP_DATADIR/coincurve-anonswap |
|
$ pip3 install . |
|
|
|
|
|
$ cd $SWAP_DATADIR |
|
$ git clone https://github.com/tecnovert/basicswap.git |
|
$ cd $SWAP_DATADIR/basicswap |
|
$ protoc -I=basicswap --python_out=basicswap basicswap/messages.proto |
|
$ pip3 install . |
|
|
|
Prepare the datadir: |
|
|
|
XMR_RPC_HOST="node.xmr.to" BASE_XMR_RPC_PORT=18081 basicswap-prepare --datadir=$SWAP_DATADIR --withcoins=monero --xmrrestoreheight=2245107 |
|
|
|
OR using a local XMR daemon: |
|
basicswap-prepare --datadir=$SWAP_DATADIR --withcoins=monero --xmrrestoreheight=2245107 |
|
|
|
Record the mnemonic from the output of the above command. |
|
|
|
Start the app |
|
|
|
$ basicswap-run --datadir=$SWAP_DATADIR |
|
|
|
Open in browser: `http://localhost:12700` |
|
It may take a few minutes to start as the coin daemons are started before the http interface. |
|
|
|
|
|
Start after installed: |
|
|
|
$ export SWAP_DATADIR=/Users/$USER/coinswaps |
|
$ . $SWAP_DATADIR/venv/bin/activate && python -V |
|
$ basicswap-run --datadir=$SWAP_DATADIR
|
|
|