mirror of
https://github.com/basicswap/basicswap.git
synced 2024-11-16 15:58:17 +00:00
docs: update install docs
This commit is contained in:
parent
72fc065928
commit
d5f643aab9
4 changed files with 33 additions and 37 deletions
|
@ -21,12 +21,10 @@ test_task:
|
||||||
- XMR_BINDIR: ${BIN_DIR}/monero
|
- XMR_BINDIR: ${BIN_DIR}/monero
|
||||||
setup_script:
|
setup_script:
|
||||||
- apt-get update
|
- apt-get update
|
||||||
- apt-get install -y wget python3-pip gnupg unzip automake libtool pkg-config
|
- apt-get install -y git python3-pip gnupg automake libtool pkg-config
|
||||||
- pip install tox pytest
|
- pip install tox pytest wheel
|
||||||
- python3 setup.py install
|
- python3 setup.py install
|
||||||
- wget -O coincurve-basicswap.zip https://github.com/basicswap/coincurve/archive/refs/tags/basicswap_v0.2.zip
|
- git clone https://github.com/basicswap/coincurve.git -b basicswap_v0.2 coincurve-basicswap
|
||||||
- unzip -d coincurve-basicswap coincurve-basicswap.zip
|
|
||||||
- mv ./coincurve-basicswap/*/{.,}* ./coincurve-basicswap || true
|
|
||||||
- cd coincurve-basicswap
|
- cd coincurve-basicswap
|
||||||
- pip install .
|
- pip install .
|
||||||
bins_cache:
|
bins_cache:
|
||||||
|
|
|
@ -5,13 +5,10 @@ ENV LANG=C.UTF-8 \
|
||||||
DATADIRS="/coindata"
|
DATADIRS="/coindata"
|
||||||
|
|
||||||
RUN apt-get update; \
|
RUN apt-get update; \
|
||||||
apt-get install -y wget python3-pip gnupg unzip make g++ autoconf automake libtool pkg-config gosu tzdata;
|
apt-get install -y git python3-pip gnupg make g++ autoconf automake libtool pkg-config gosu tzdata;
|
||||||
|
|
||||||
ARG COINCURVE_VERSION=v0.2
|
ARG COINCURVE_VERSION=v0.2
|
||||||
RUN wget -O coincurve-basicswap.zip https://github.com/basicswap/coincurve/archive/refs/tags/basicswap_$COINCURVE_VERSION.zip && \
|
RUN git clone https://github.com/basicswap/coincurve.git -b basicswap_$COINCURVE_VERSION coincurve-basicswap && \
|
||||||
echo "c309deef22c929c9ab5b3adf7adbda940bffcea6c6ec7c66202d6c3d4e3ceb79 coincurve-basicswap.zip" | sha256sum -c && \
|
|
||||||
unzip coincurve-basicswap.zip && \
|
|
||||||
mv ./coincurve-basicswap_$COINCURVE_VERSION ./coincurve-basicswap && \
|
|
||||||
cd coincurve-basicswap && \
|
cd coincurve-basicswap && \
|
||||||
pip install .
|
pip install .
|
||||||
|
|
||||||
|
|
|
@ -54,7 +54,7 @@ Depending on your environment, the `docker-compose` command may not work. If tha
|
||||||
|
|
||||||
Set xmrrestoreheight to the current xmr chain height.
|
Set xmrrestoreheight to the current xmr chain height.
|
||||||
|
|
||||||
CURRENT_XMR_HEIGHT=$(curl https://localmonero.co/blocks/api/get_stats | jq .height)
|
CURRENT_XMR_HEIGHT=$(curl -s http://node2.monerodevs.org:18089/get_info | jq .height)
|
||||||
|
|
||||||
Adjust `--withcoins` and `--withoutcoins` as desired, eg: `--withcoins=monero,bitcoin`. By default only Particl is loaded.
|
Adjust `--withcoins` and `--withoutcoins` as desired, eg: `--withcoins=monero,bitcoin`. By default only Particl is loaded.
|
||||||
|
|
||||||
|
@ -140,7 +140,7 @@ Continue from the [Run Using Docker](#run-using-docker) section.
|
||||||
|
|
||||||
### Ubuntu Setup:
|
### Ubuntu Setup:
|
||||||
|
|
||||||
apt-get install -y wget git python3-venv python3-pip gnupg unzip automake libtool pkg-config curl jq
|
apt-get install -y git python3-venv python3-pip gnupg automake libtool pkg-config curl jq
|
||||||
|
|
||||||
### OSX Setup:
|
### OSX Setup:
|
||||||
|
|
||||||
|
@ -150,21 +150,18 @@ Install Homebrew (See https://brew.sh/):
|
||||||
|
|
||||||
Dependencies:
|
Dependencies:
|
||||||
|
|
||||||
brew install wget unzip python git protobuf gnupg automake libtool pkg-config curl jq
|
brew install python git protobuf gnupg automake libtool pkg-config curl jq
|
||||||
|
|
||||||
Close the terminal and open a new one to update the python symlinks.
|
Close the terminal and open a new one to update the python symlinks.
|
||||||
|
|
||||||
|
|
||||||
### Basicswap:
|
### Basicswap:
|
||||||
|
|
||||||
export SWAP_DATADIR=/Users/$USER/coinswaps
|
export SWAP_DATADIR=$HOME/coinswaps
|
||||||
mkdir -p "$SWAP_DATADIR/venv"
|
|
||||||
python3 -m venv "$SWAP_DATADIR/venv"
|
python3 -m venv "$SWAP_DATADIR/venv"
|
||||||
. $SWAP_DATADIR/venv/bin/activate && python -V
|
. $SWAP_DATADIR/venv/bin/activate && python -V
|
||||||
cd $SWAP_DATADIR
|
cd $SWAP_DATADIR
|
||||||
wget -O coincurve-basicswap.zip https://github.com/tecnovert/coincurve/archive/refs/tags/basicswap_v0.2.zip
|
git clone https://github.com/basicswap/coincurve.git -b basicswap_v0.2 coincurve-basicswap
|
||||||
unzip -d coincurve-basicswap coincurve-basicswap.zip
|
|
||||||
mv ./coincurve-basicswap/*/{.,}* ./coincurve-basicswap || true
|
|
||||||
cd $SWAP_DATADIR/coincurve-basicswap
|
cd $SWAP_DATADIR/coincurve-basicswap
|
||||||
pip3 install .
|
pip3 install .
|
||||||
|
|
||||||
|
@ -182,12 +179,13 @@ From https://pypi.org/project/certifi/
|
||||||
|
|
||||||
Continue installing Basicswap
|
Continue installing Basicswap
|
||||||
|
|
||||||
|
pip3 install wheel
|
||||||
pip3 install .
|
pip3 install .
|
||||||
|
|
||||||
|
|
||||||
Prepare the datadir:
|
Prepare the datadir:
|
||||||
|
|
||||||
CURRENT_XMR_HEIGHT=$(curl https://localmonero.co/blocks/api/get_stats | jq .height)
|
CURRENT_XMR_HEIGHT=$(curl -s http://node2.monerodevs.org:18089/get_info | jq .height)
|
||||||
|
|
||||||
basicswap-prepare --datadir=$SWAP_DATADIR --withcoins=monero --xmrrestoreheight=$CURRENT_XMR_HEIGHT
|
basicswap-prepare --datadir=$SWAP_DATADIR --withcoins=monero --xmrrestoreheight=$CURRENT_XMR_HEIGHT
|
||||||
|
|
||||||
|
|
39
doc/notes.md
39
doc/notes.md
|
@ -11,33 +11,28 @@ In chainclients.monero:
|
||||||
- connection_type - rpc
|
- connection_type - rpc
|
||||||
- manage_daemon - false
|
- manage_daemon - false
|
||||||
- manage_wallet_daemon - true
|
- manage_wallet_daemon - true
|
||||||
- rpchost - ip of remote monero node (192.168.1.9)
|
- rpchost - ip of remote monero node (example: 192.168.1.9)
|
||||||
- rpcport - rpcport that monero is listening on remote node (18081)
|
- rpcport - rpcport that monero is listening on remote node (18089)
|
||||||
- rpcuser - test_user
|
- rpcuser - test_user
|
||||||
- rpcpassword - test_pwd
|
- rpcpassword - test_pwd
|
||||||
|
|
||||||
|
|
||||||
Edit monerod.conf on the remote node:
|
Edit monerod.conf on the remote node:
|
||||||
|
|
||||||
data-dir=PATH_TO_MONERO_DATADIR
|
|
||||||
restricted-rpc=1
|
|
||||||
rpc-login=test_user:test_pwd
|
rpc-login=test_user:test_pwd
|
||||||
rpc-bind-port=18081
|
rpc-restricted-bind-port=18089
|
||||||
rpc-bind-ip=192.168.1.9
|
rpc-restricted-bind-ip=0.0.0.0
|
||||||
prune-blockchain=1
|
|
||||||
|
|
||||||
Start the remote monerod binary with `--confirm-external-bind`
|
Remember to open port 18089 in the remote machine's firewall if necessary.
|
||||||
|
|
||||||
Remember to open port 18081 in the remote machine's firewall if necessary.
|
|
||||||
|
|
||||||
You can debug the connection using curl (from the local node)
|
You can debug the connection using curl (from the local node)
|
||||||
|
|
||||||
curl http://192.168.1.9:18081/json_rpc -u test_user:test_pwd --digest -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' -H 'Content-Type: application/json'
|
curl http://node.ip.addr.here:18089/json_rpc -u test_user:test_pwd --digest -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' -H 'Content-Type: application/json'
|
||||||
|
|
||||||
|
|
||||||
## Monero remote private node with ssh tunneling
|
## Monero remote private node with ssh tunneling
|
||||||
|
|
||||||
Example connecting to a private remote monero node running at 192.168.1.9
|
Example connecting to a private remote monero node over ssh:
|
||||||
|
|
||||||
Set the following in basicswap.json:
|
Set the following in basicswap.json:
|
||||||
|
|
||||||
|
@ -46,13 +41,20 @@ In chainclients.monero:
|
||||||
- manage_daemon - false
|
- manage_daemon - false
|
||||||
- manage_wallet_daemon - true
|
- manage_wallet_daemon - true
|
||||||
- rpchost - localhost
|
- rpchost - localhost
|
||||||
- rpcport - rpcport that monero is listening on remote node (18081)
|
- rpcport - rpcport that monero is listening on remote node (18089)
|
||||||
|
|
||||||
On the remote machine open an ssh tunnel to port 18081:
|
Edit monerod.conf on the remote node:
|
||||||
|
|
||||||
ssh -N -R 18081:localhost:18081 user@LOCAL_NODE_IP
|
rpc-restricted-bind-port=18089
|
||||||
|
|
||||||
|
On the remote machine open an ssh tunnel to BSX:
|
||||||
|
|
||||||
|
ssh -N -R 18089:localhost:18089 user@LOCAL_BSX_IP
|
||||||
|
|
||||||
|
Or, on the BSX host machine create a tunnel to the node:
|
||||||
|
|
||||||
|
ssh -N -L 18089:localhost:18089 user@REMOTE_NODE_IP
|
||||||
|
|
||||||
And start monerod
|
|
||||||
|
|
||||||
|
|
||||||
## SSH Tunnel to Remote BasicSwap Node
|
## SSH Tunnel to Remote BasicSwap Node
|
||||||
|
@ -92,8 +94,8 @@ Create and activate a venv
|
||||||
|
|
||||||
Install coincurve
|
Install coincurve
|
||||||
|
|
||||||
git clone https://github.com/basicswap/coincurve.git -b basicswap
|
git clone https://github.com/basicswap/coincurve.git -b basicswap_v0.2 coincurve-basicswap
|
||||||
cd coincurve/
|
cd coincurve-basicswap
|
||||||
pip3 install .
|
pip3 install .
|
||||||
|
|
||||||
|
|
||||||
|
@ -101,6 +103,7 @@ Install basicswap
|
||||||
|
|
||||||
git clone https://github.com/basicswap/basicswap.git
|
git clone https://github.com/basicswap/basicswap.git
|
||||||
cd basicswap
|
cd basicswap
|
||||||
|
pip3 install wheel
|
||||||
pip3 install .
|
pip3 install .
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue