Hot Wallet: Bitcoin Core (bitcoind)

Created by Charles Wernicke
Last updated: Dec 21, 2020

This is a step-by-step guide for adding bitcoind as a Hot Wallet Buy source. The following example is based on the presumption that the bitcoind daemon has been installed, configured, and tested for proper use.

This guide is intended to help you setup a working Bitcoin Core server with a functional CAS.

Click here for instructions on installing a Bitcoin Core node.

Even more information: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/1002733610

Assemble the required information for CAS:

User: this is the “RPC User” you created when setting up the node. For this example we'll just say it's “rpcuser”.

Password: is the “RPC Password” created by rpcauth.py earlier, or the one you made up (if you didn't implement a token).  For this example, we'll make the password just plain “rpcpw”.

  • NOTE: this password is DIFFERENT than any Wallet Tunnel password provided.

Host: the IP of the Bitcoin Core server.

  • If using a SSH tunnel, it would be: 127.0.0.1

  • When using the Wallet Tunnel, the IP is the server's public IP.

Port: the exposed port of the Bitcoin Core server (normally 8332).

Label: (optional) a wallet label specified within your Bitcoin Core implementation.

Next, add a new crypto-currency type to CAS:

  1. Enter the “Crypto Settings” menu in the left-hand column. 

  2. Click on the “+ ADD” button. 

  3. Create a suitable description, i.e. “Bitcoind BTC”.

  4. Select “BTC” for the required Crypto Currency* setting.

  5. Set Configuration Cash Currency* to“USD” (or whatever your local currency might be).

  6. Set Buy Rate Source to whatever source you prefer.

  7. Set Minimum Cash Amount Per Transaction*

  • Enter the smallest transaction amount you'll accept. 

  • When a transaction has been initiated by the customer, the first banknote inserted in the acceptor must be this amount, or more.

8. Select your Hot Wallet Buy source to “Bitcoin Core - bitcoind”.

9. Enter the Parameters for bitcoind as determined in the previous steps:

  • Example (typical): “http:rpcuser:rpcpw:127.0.0.1:8332”

10. If you are using the GB Wallet Tunnel, enable it and enter the tunnel password:

11. Click on “SUBMIT” to save your settings:

Finally, test it out :

Select Test Hot Wallet Buy from the RUN BTC SETTINGS TEST.

Presuming everything was entered correctly, you should receive confirmation of success!

Configure the Hot Wallet Sell using the same parameters if you implement it on any 2-way BATMs.

You're done!