Study material for understanding various real scenarios and it's effect on the Bitcoin RPC usage.
Built by Karl-Johan Alm as training material for the Blockchain Core Camp (BC2) workshop, this is for educational purposes only and not intended to be used in a production app.
Currently this works on OSX & Linux only.
Make sure you have the following installed:
You can install those yourself, or follow these instructions.
For OSX (assuming you have Homebrew installed):
$ brew install node mongodb
$ brew services start mongodb
$ npm install -g mocha #sometimes this might require sudo
For Ubuntu 64-bit:
$ sudo apt-get install curl
$ curl -sL https://deb.nodesource.com/setup_7.x | sudo -E bash -
$ sudo apt-get install nodejs mongodb
$ sudo systemctl start mongodb
$ sudo systemctl enable mongodb
$ sudo ln -s /usr/bin/nodejs /usr/local/bin/node # Buggy if Nodejs is not installed
$ sudo npm install -g mocha
We assume you've compiled Bitcoind yourself. If you're on OSX and downloaded from https://bitcoin.org/en/download instead, follow the "Alternate Install" instructions.
After downloading, copy the files into a folder inside your Bitcoin folder. Here, for example inside /rpcapp:
$ ls /<YOUR_BITCOIN_FOLDER>/rpcapp
api.js
bitcoin.js
[...]
From that folder, run npm install to get the necessary files:
$ cd /<YOUR_BITCOIN_FOLDER>/rpcapp
$ npm install
By default, this app uses rpcuser=user and rpcpassword=password, so either set those setting inside the bitcoin.conf or change config.js.
If there are no issues, running ./rpc-cli should show something like this:
$ ./rpc-cli
available commands:
create <amount> ...
[...]
Set the BITCOIN_PATH to the Bitcoin-Qt app folder. By default, it's in your Applications folder.
$ export BITCOIN_PATH=/Applications/Bitcoin-Qt.app/Contents/MacOS/
Same as the above, from your RPCApp folder, run npm install to get the necessary files:
$ cd /<YOUR_RPCAPP_FOLDER>/
$ npm install
Similarly, if there are no issues, running ./rpc-cli should show something like this:
$ ./rpc-cli
available commands:
create <amount> ...
[...]
Run npm test and work through the outputs:
$ npm test
This project is licensed under the MIT License. See the https://opensource.org/licenses/MIT for more information.