aljaz/bitcoin-tutorials
1
1
Fork 0
mirror of https://github.com/openoms/bitcoin-tutorials.git synced 2026-02-03 02:34:19 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
ed0e70d7138f87c60aa29024231f4e3c7bfbbc81
bitcoin-tutorials/joinmarket
History
openoms ed0e70d713 joinmarket: view tranaction history
2019-10-30 17:50:54 +00:00
..
README.md
joinmarket: view tranaction history
2019-10-30 17:50:54 +00:00

README.md

JoinMarket on the RaspiBlitz

Testing on a RPi4 4GB with RaspiBlitz v1.3

Open the Tor browser and check out the current fees and available liquidity in the JoinMarket order book: https://joinmarket.me/ob/

Installation

  • Run in the RaspiBlitz terminal:

    $ git clone https://github.com/JoinMarket-Org/joinmarket-clientserver.git
$ cd joinmarket-clientserver
$ ./install.sh
# (follow instructions on screen; provide sudo password when prompted)
# do not install QT-dependencies - running headless on the RPi

  • Activate the virtual environment to see the prompt: (jmvenv) $
    This needs to be done at every new login.

    $ cd joinmarket-clientserver
$ source jmvenv/bin/activate
$ cd scripts

Generate a wallet

  • Using the JoinMarket wallet: https://github.com/JoinMarket-Org/joinmarket/wiki/Using-the-JoinMarket-internal-wallet

    (jmvenv) $ python wallet-tool.py generate

    Created a new `joinmarket.cfg`. Please review and adopt the settings and restart joinmarket.
    • JoinMarket uses a hot wallet sitting on your Raspberry Pi. Keep it safe.
    • Backup your seed and store safely. Best to not keep the seed and the passphrase together.
    • The wallet encryption password will be needed every time when there is interaction with the wallet. Store it somewhere accessible, best if encrypted.

  • Fill in the PasswordB to the joinmarket.cfg
    (as in /mnt/hdd/bitcoin/bitcoin.conf)

    $ nano joinmarket.cfg

    [BLOCKCHAIN]
rpc_user = raspibolt
rpc_password = PasswordB-as-in-bitcoin.conf
rpc_host = localhost #default usually correct 
rpc_port = 8332 # default for mainnet

  • Display the addresses to fund (look in mixdepth 0):

    (jmvenv) $ python wallet-tool.py wallet.jmdat

    and run again after the first time

Send payments through coinjoins with sendpayment.py

Run a Yield Generator

  • Read the basics: https://github.com/JoinMarket-Org/joinmarket/wiki/Running-a-Yield-Generator

  • Edit the settings:
    $ nano yield-generator-basic.py

    """THESE SETTINGS CAN SIMPLY BE EDITED BY HAND IN THIS FILE:
"""
txfee = 100
cjfee_a = 500
cjfee_r = '0.00002'
ordertype = 'swreloffer' #'swreloffer' or 'swabsoffer'
nickserv_password = ''
max_minsize = 1000
gaplimit = 6
    • set the txfee to 0 to reduce the minimum offer amount
    • cjfee_a is the fixed coinjoin fee to be earned
    • cjfee_r = '0.00002' is the relative fee depending on the used amount
    • to use an absolute fee swap swreloffer to swabsoffer

  • Once set up run:

    (jmvenv) $ python yield-generator-basic.py wallet.jmdat

Check the transaction history

  • use the wallet tool:

    (jmvenv) $ python wallet-tool.py wallet.jmdat history

  • View the log of the transactions of the Yield Generator:

    $ cat ~/joinmarket-clientserver/scripts/logs/yigen-statement.csv

Keep the offers running in the background with Tmux

  • Install on the RaspiBlitz:
    $ sudo apt install tmux
  • Start:
    $ tmux
  • Work in the terminal as described above.
    Find a basic introduction at https://www.ocf.berkeley.edu/~ckuehl/tmux/
  • If the terminal is disconnected the processes in tmux keep running (as it is running the Blitz) and can be reopened
  • when logged in after a disconnection run:
    $ tmux a
    to pick up where left off

Resources: