Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Tip

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

Info

Even more information: Node Tutorial (Generic)

Assemble the required information for CAS:

protocol : user : password : host : port : label

protocol: http (always)

user: this is the “RPC User” you created when setting up the node.

  • From this example we'll use: AnyNameYouWantHere

password: is the “RPC Password” created by the rpcauth.py script during the node setup.

  • For this example, the password is: Kq66rZya7MNpCU_e0zZSgjR2Mb7rBeyX9QSeGhwPMeY=

  • You may (instead) use a password you made up (if you didn't implement a token via rpcauth.py).

  • NOTE: do not confuse this password with the Wallet Tunnel password. They are different!

host: the IP of the Bitcoin Core server.

  • If using a SSH tunnel from the node to CAS, 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.

  • NOTE: a wallet label is discouraged. The Bitcoin convention is to use a unique, unused wallet address for every transaction. Setting a wallet label defeats that privacy intent, and has little (if any) benefit. Please inquire with Support if you’d like instructions anyhow.

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): “httphttp:rpcuser:rpcpwAnyNameYouWantHere:Kq66rZya7MNpCU_e0zZSgjR2Mb7rBeyX9QSeGhwPMeY=:127.0.0.1:8332”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.

Tip

Test your settings before deploying them.

  1. Save your setting first,

  2. return to the same Crypto Setting,

  3. run the test(s).

See: https://generalbytes.atlassian.net/l/cp/9Zdit1KP

Tip

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

You're done!

Info