From be097ba65f7f98eadb429b498cee6bad2386a54b Mon Sep 17 00:00:00 2001 From: lza_menace Date: Mon, 30 Dec 2024 10:05:59 -0800 Subject: [PATCH] use ofrnxmr script exclusively --- content/docs/atomic-swaps.md | 112 ++++------------------------------- 1 file changed, 11 insertions(+), 101 deletions(-) diff --git a/content/docs/atomic-swaps.md b/content/docs/atomic-swaps.md index dc3fda2..ad879a3 100644 --- a/content/docs/atomic-swaps.md +++ b/content/docs/atomic-swaps.md @@ -2,138 +2,48 @@ 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 | | --- | --- | | Bitcoin | BTC | +| Bitcoin Cash | BCH | | Monero | XMR | | Wownero | WOW | | Decred | DCR | | Firo | FIRO | | Litecoin | LTC | +| Namecoin | NMC | +| Navcoin | NAV | | PIVX | PIVX | | Dash | DASH | | 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 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 - -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. +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 -```bash -vim $HOME/.basicswap/wownero/wownerod.conf -# data-dir=/home//.wownero -vim $HOME/.basicswap/monero/monerod.conf -# data-dir=/home//.bitmonero -``` -## Enable Tor (Optional) - -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 -``` +## Using -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) - -## Using - 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. -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 -> Bitcoin | | Monero -> Particl -> Wownero | -| Monero -> Particl -> Bitcoin | -| Bitcoin -> Particl -> Wownero | -| Bitcoin -> Particl -> Monero | +| Wownero -> Litecoin -> Monero | +| Monero -> Litecoin -> Wownero | 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.