nerodev
/
wownerodocs.org-old
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

use ofrnxmr script exclusively

Browse Source
master
lza_menace 3 weeks ago
parent ebfc56b81b
commit be097ba65f
1 changed files with 11 additions and 101 deletions
Show Stats Download Patch File Download Diff File

112
content/docs/atomic-swaps.md
Unescape Escape View File

@ -2,138 +2,48 @@
title: "Atomic Swaps" title: "Atomic Swaps"
--- ---
You can perform atomic swaps between Wownero and another chain called [Particl](https://particl.io/coin), a privacy focused Bitcoin fork. From that chain you can swap into a number of other coins: You can perform atomic swaps between Wownero and a few other chains using a software called [BasicSwap](https://basicswapdex.com/). It runs on your computer and connects to other participants where you can place and accept bids. Funds go directly into your wallets without any middle-man, completely decentralized.
![](/basicswap_coins.png)
| coin name | ticker | | coin name | ticker |
| --- | --- | | --- | --- |
| Bitcoin | BTC | | Bitcoin | BTC |
| Bitcoin Cash | BCH |
| Monero | XMR | | Monero | XMR |
| Wownero | WOW | | Wownero | WOW |
| Decred | DCR | | Decred | DCR |
| Firo | FIRO | | Firo | FIRO |
| Litecoin | LTC | | Litecoin | LTC |
| Namecoin | NMC |
| Navcoin | NAV |
| PIVX | PIVX | | PIVX | PIVX |
| Dash | DASH | | Dash | DASH |
| Particl | PART | | Particl | PART |
To do this you run a software called [BasicSwap](https://basicswapdex.com/) on your computer which connects to other participants where you can place and accept bids. Funds go directly into your wallets without any middle-man, completely decentralized.
## Installation ## Installation
The official documentation can be found here: https://academy.particl.io/en/latest/basicswap-guides/basicswapguides_installation.html The official documentation can be found here: https://academy.particl.io/en/latest/basicswap-guides/basicswapguides_installation.html
A community member ran, shout out to [ofrnxmr](https://twitter.com/ofrnXMR), command line tool can be found here: https://github.com/nahuhh/basicswap-bash/releases A community member named [ofrnxmr](https://twitter.com/ofrnXMR) runs a scripted installation which is the best way to use it. Follow the instructions here: https://github.com/nahuhh/basicswap-bash/releases
The Docker method is pretty convoluted, I don't recommend it (and I love docker). The system installation is much easier.
For Linux users, see below:
## Debian/Ubuntu Linux
```bash
# Install package dependencies
sudo apt install git python3-venv tor
# Clone and install project
git clone https://github.com/basicswap/basicswap $HOME/basicswapdex
cd $HOME/basicswapdex
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Setup new basicswap deployment with Wownero and Monero
python basicswap/bin/prepare.py \
--datadir=$HOME/.basicswap/ \
--withcoin=wownero \
--withcoin=monero \
--xmrrestoreheight=3314350 \
--wowrestoreheight=695109
# ...
# IMPORTANT - Save your particl wallet recovery phrase:
# carton jealous rib ability damage regular royal
# tobacco basic become sting timber speed solve
#soda potato circle help now swept citizen chef drive cable
#
# Done.
#
```
**SAVE THE MNEMONIC SEED SHOWN AT THE END!**
Your basicswap installation data will reside in `$HOME/.basicswap` and the project in `$HOME/basicswapdex`. It will manage and install it's own set of binaries for the node and wallet-rpc. There are some contributors which make updates to ensure Wownero stays up to date.
## Customize Data Directories (Optional)
Basicswap will also set it's own directory for the chains to sync their data to. If you're like me and you already run your own nodes, be sure to modify the wownerod and monerod config files to use your existing data folders.
```bash
vim $HOME/.basicswap/wownero/wownerod.conf
# data-dir=/home/<YOURUSER>/.wownero
vim $HOME/.basicswap/monero/monerod.conf
# data-dir=/home/<YOURUSER>/.bitmonero
```
## Enable Tor (Optional) ## Using
If you want everything to route through tor you need to update your basicswap deployment like so:
```bash
python basicswap/bin/prepare.py --enabletor
```
Your basicswap deployment will now be configured to use tor as seen in `$HOME/.basicswap/basicswap.json`. The `tor_control_password` will be autogenerated, along with a matching tor config file in `$HOME/.basicswap/tor/torrc`.
If you have tor enabled for your deployment you will need to make sure it is running while you have basicswap running since it will be expecting to route/proxy traffic through it.
```bash
tor -f $HOME/.basicswap/tor/torrc
```
## Adding Other Coins
```bash
python basicswap/bin/prepare.py --addcoin=bitcoin
python basicswap/bin/prepare.py --addcoin=litecoin
```
You're on your own after that.
## Running
Make sure you are in the project directory (`$HOME/basicswapdex` if you followed this guide) and run the software (depending on your installation route), which probably looks like this:
```bash
cd $HOME/basicswapdex
source .venv/bin/active
python basicswap/bin/run.py
```
Open your browser and go to http://127.0.0.1:12700/offers - you should see any active offers for the coins you have enabled. Run basicswapdex and open your browser to http://127.0.0.1:12700/offers - you should see any active offers for the coins you have enabled.
![](/basicswap_dash.png) ![](/basicswap_dash.png)
## Using
Go to the Wallets paged and make sure they're all synced up - you might have to wait a bit. Go to the Wallets paged and make sure they're all synced up - you might have to wait a bit.
Copy the address or subaddress of the wallet and send funds. When the transfer is confirmed on that network you will be able to participate in atomic swaps. Copy the address or subaddress of the wallet and send funds. When the transfer is confirmed on that network you will be able to participate in atomic swaps.
Particl will always be your intermediary, there are no direct atomic swaps from Wownero to Monero for example. You can perform atomic swaps with Wownero and any SegWit capable chains, which will always be your intermediary; there are no direct atomic swaps from Wownero to Monero for example.
| Swap Routes | | Swap Route Examples |
| --- | | --- |
| Wownero -> Particl -> Monero | | Wownero -> Particl -> Monero |
| Wownero -> Particl -> Bitcoin |
| Monero -> Particl -> Wownero | | Monero -> Particl -> Wownero |
| Monero -> Particl -> Bitcoin | | Wownero -> Litecoin -> Monero |
| Bitcoin -> Particl -> Wownero | | Monero -> Litecoin -> Wownero |
| Bitcoin -> Particl -> Monero |
Look for offers that suit your criteria (the coin you have, the coin you want, and a market rate you are comfortable with) or place your own offer. Look for offers that suit your criteria (the coin you have, the coin you want, and a market rate you are comfortable with) or place your own offer.