GlcoinCore/joininbox
1
0
Fork 0
mirror of https://github.com/openoms/joininbox.git synced 2026-08-15 12:50:37 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
joininbox/prepare_remote_node.md
openoms 169e6bc6b3
improve RPC connectrion instructions
2021-01-19 22:46:07 +00:00

6 KiB
Raw Blame History

Prepare a bitcoin node to accept a remote RPC connection

If you have arrived here from runing JoininBox locally on the RaspiBlitz can skip these steps (CTRL+C to exit the connection settings). The connection to the local bitcoin node is set up automatically.

JoinMarket (running in JoininBox) needs to connect to Bitcoin Core via RPC.
A pruned node with the bitcoind wallet enabled will do and txindex is not required.

RaspiBlitz

Enable the bitcoind wallet

Since the RaspiBlitz v1.6 run this script:
$ config.scripts/network.wallet.sh on

To set up manually:

  • Edit the bitcoin.conf:
    $ sudo nano /mnt/hdd/bitcoin/bitcoin.conf

  • Change the disablewallet option to 0:

    disablewallet=0

  • Specify the wallet to be used:

    main.wallet=wallet.dat

    The default setting in JoininBox is to use the wallet.dat.
    It needs to specified in the bitcoin.conf because otherwise when other applications (like Specter) add bitcoind wallets JoinMarket would stop working.

  • Restart bitcoind:
    $ sudo systemctl restart bitcoind

LAN connection

In the terminal of the node - allow remote RPC connections to Bitcoin Core
This can be skipped if you connect through Tor

  1. Edit the bitcoin.conf
    $ sudo nano /mnt/hdd/bitcoin/bitcoin.conf

    Add the values:

    • rpcallowip=JOININBOX_IP or RANGE
      • either specify the LAN IP of the computer (here JoininBox)
      • or use a range like: 192.168.1.0/24 - edit to your local subnet - the first 3 numbes of the LAN IP address, the example used here is: 192.168.1.x
    • rpcbind=LAN_IP_OF_THE_NODE
      • use the local IP of the bitcoin node in the example: 192.168.1.4
    • can keep the other rpcallowip and rpcbind entires especially for the localhost: 127.0.0.1

    Example:

    rpcallowip=192.168.1.0/24
rpcbind=192.168.1.4

  2. Restart Bitcoin Core

    $ sudo systemctl restart bitcoind

  3. Open the firewall to allow the RPC connection from LAN

    edit to your local subnet - in the example here 192.168.1.X):
    $ sudo ufw allow from 192.168.1.0/24 to any port 8332

  4. Take note of the LAN_ADDRESS of the remote node and fill it in to the rpc_host in joinmarket.cfg

Tor connection

On the node - activate Tor and create a Hidden Service

Make sure that Tor is installed or active in the SERVICES menu

Create a Hidden Service to forward the bitcoin RPC port:

  1. On the RaspiBlitz since v1.4 there is a script to create a hidden service:
    ./config.scripts/internet.hiddenservice.sh bitcoinrpc 8332 8332

  2. Take note of the Tor_Hidden_Service.onion and fill in to the rpc_host in the joinmarket.cfg

Alternatively proceed manually:

  1. Open the Tor configuration file
    $ sudo nano /etc/tor/torrc

  2. Insert the lines

    # Hidden Service v3 for bitcoinrpc
HiddenServiceDir /mnt/hdd/tor/bitcoinrpc
HiddenServiceVersion 3
HiddenServicePort 8332 127.0.0.1:8332

  3. Restart Tor

    $ sudo systemctl restart tor

  4. Take note of the Tor_Hidden_Service.onion

    $ sudo cat /mnt/hdd/tor/bitcoinrpc/hostname

Fill in the Tor_Hidden_Service.onion to the rpc_host in the joinmarket.cfg

RoninDojo

Enable the bitcoind wallet

Copy the two lines as one command to the ssh terminal:

$ sed -i 's/  -disablewallet=.*$/  -disablewallet=0\
  -wallet=wallet.dat/' ~/dojo/docker/my-dojo/bitcoin/restart.sh

Alternatively edit manually:
$ nano ~/dojo/docker/my-dojo/bitcoin/restart.sh
and modify:

  -disablewallet=1

to

  -disablewallet=0

and add within the brackets:

  -wallet=wallet.dat

LAN connection

Edit the bitcoind container settings:

$ nano ~/dojo/docker/my-dojo/conf/docker-bitcoind.conf

Set the following:

# should be already on
BITCOIND_RPC_EXTERNAL=on   
# the RoninDojo_IP is the LAN IP address of your RoninDojo
BITCOIND_RPC_EXTERNAL_IP=RoninDojo_IP

Open the firewall to allow the RPC connection from LAN
(edit to your local subnet - in the example here 192.168.1.X):
$ sudo ufw allow from 192.168.1.0/24 to any port 28256

Take note: Dojo uses the port 28256 instead of the deafult 8332.

Tor connection

Create a Hidden Service to forward the bitcoin RPC port:

Edit the torrc:
$ sudo nano /etc/tor/torrc

Add:

HiddenServiceDir /var/lib/tor/bitcoinrpc/
HiddenServiceVersion 3
HiddenServicePort 8332 127.0.0.1:28256

Restart Tor:
$ sudo systemctl restart tor

Show the .onion service address:
$ sudo cat /var/lib/tor/bitcoinrpc/hostname

Recompile the Docker containers (takes time)

$ cd ~/dojo/docker/my-dojo && ./dojo.sh upgrade --nolog

Get the Credentials

Fill the connection settings from the 5 Credentials -> 6 Bitcoind menu:
Username: RoninDojo
Password: [RPC Password]
Host: [RoninDojo_IP or sudo cat /var/lib/tor/bitcoinrpc/hostname]
Port: [28256 for LAN or 8332 for the .onion service]

Remember to use torify with the python scripts when connecting remotely through Tor (applied automatically in the JoininBox)

Example:
torify wallet-tool.py wallet.jmdat

also need to allow Tor to connect to localhost

Resources