Skip to content

development.md

Latest commit

 

History

History
162 lines (130 loc) · 3.36 KB

development.md

File metadata and controls

162 lines (130 loc) · 3.36 KB

Setting up Development Environment

Install Node.js

Install Node.js by your favorite method, or use Node Version Manager by following directions at https://github.com/creationix/nvm

nvm install v4

Fork and Download Repositories

To develop auroracoin-node:

cd ~
git clone git@github.com:<yourusername>/auroracoin-node.git
git clone git@github.com:<yourusername>/auroracoin.git

To develop auroracoin or to compile from source:

git clone git@github.com:<yourusername>/auroracoin.git
git fetch origin <branchname>:<branchname>
git checkout <branchname>

Note: See auroracoin documentation for building auroracoin on your platform.

Install Development Dependencies

For Ubuntu:

sudo apt-get install libzmq3-dev
sudo apt-get install build-essential

Note: Make sure that libzmq-dev is not installed, it should be removed when installing libzmq3-dev.

For Mac OS X:

brew install zeromq

Install and Symlink

cd auroracoin
npm install
cd ../auroracoin-node
npm install

Note: If you get a message about not being able to download auroracoin distribution, you'll need to compile auroracoind from source, and setup your configuration to use that version.

We now will setup symlinks in auroracoin-node (repeat this for any other modules you're planning on developing):

cd node_modules
rm -rf auroracoin
ln -s ~/auroracoin
rm -rf auroracoind-rpc
ln -s ~/auroracoind-rpc

And if you're compiling or developing auroracoin:

cd ../bin
ln -sf ~/auroracoin/src/auroracoind

Run Tests

If you do not already have mocha installed:

npm install mocha -g

To run all test suites:

cd auroracoin-node
npm run regtest
npm run test

To run a specific unit test in watch mode:

mocha -w -R spec test/services/auroracoind.unit.js

To run a specific regtest:

mocha -R spec regtest/auroracoind.js

Running a Development Node

To test running the node, you can setup a configuration that will specify development versions of all of the services:

cd ~
mkdir devnode
cd devnode
mkdir node_modules
touch auroracoin-node.json
touch package.json

Edit auroracoin-node.json with something similar to:

{
  "network": "livenet",
  "port": 3001,
  "services": [
    "auroracoind",
    "web",
    "insight-api",
    "insight-ui",
    "<additional_service>"
  ],
  "servicesConfig": {
    "auroracoind": {
      "spawn": {
        "datadir": "/home/<youruser>/.auroracoin",
        "exec": "/home/<youruser>/auroracoin/src/auroracoind"
      }
    }
  }
}

Note: To install services insight-api and insight-ui you'll need to clone the repositories locally.

Setup symlinks for all of the services and dependencies:

cd node_modules
ln -s ~/auroracoin
ln -s ~/auroracoin-node
ln -s ~/insight-api
ln -s ~/insight-ui

Make sure that the <datadir>/auroracoin.conf has the necessary settings, for example:

server=1
whitelist=127.0.0.1
txindex=1
addressindex=1
timestampindex=1
spentindex=1
zmqpubrawtx=tcp://127.0.0.1:214022
zmqpubhashblock=tcp://127.0.0.1:214022
rpcallowip=127.0.0.1
rpcuser=auroracoin
rpcpassword=local321

From within the devnode directory with the configuration file, start the node:

../auroracoin-node/bin/auroracoin-node start