Install Node.js by your favorite method, or use Node Version Manager by following directions at https://github.com/creationix/nvm
nvm install v4
To develop litecore-node:
cd ~
git clone [email protected]:<yourusername>/litecore-node.git
git clone [email protected]:<yourusername>/litecore-lib.git
To develop litecoin or to compile from source:
git clone [email protected]:<yourusername>/litecoin.git
git fetch origin <branchname>:<branchname>
git checkout <branchname>
Note: See litecoin documentation for building litecoin on your platform.
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
cd litecore-lib
npm install
cd ../litecore-node
npm install
Note: If you get a message about not being able to download litecoin distribution, you'll need to compile litecoind from source, and setup your configuration to use that version.
We now will setup symlinks in litecore-node
(repeat this for any other modules you're planning on developing):
cd node_modules
rm -rf litecore-lib
ln -s ~/litecore-lib
rm -rf bitcoind-rpc
ln -s ~/bitcoind-rpc
And if you're compiling or developing litecoin:
cd ../bin
ln -sf ~/litecoin/src/litecoind
If you do not already have mocha installed:
npm install mocha -g
To run all test suites:
cd litecore-node
npm run regtest
npm run test
To run a specific unit test in watch mode:
mocha -w -R spec test/services/bitcoind.unit.js
To run a specific regtest:
mocha -R spec regtest/bitcoind.js
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 litecore-node.json
touch package.json
Edit litecore-node.json
with something similar to:
{
"network": "livenet",
"port": 3001,
"services": [
"litecoind",
"web",
"insight-api",
"insight-ui",
"<additional_service>"
],
"servicesConfig": {
"litecoind": {
"spawn": {
"datadir": "/home/<youruser>/.litecoin",
"exec": "/home/<youruser>/litecoin/src/litecoind"
}
}
}
}
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 ~/litecore-lib
ln -s ~/litecore-node
ln -s ~/insight-api
ln -s ~/insight-ui
Make sure that the <datadir>/litecoin.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:29332
zmqpubhashblock=tcp://127.0.0.1:29332
rpcallowip=127.0.0.1
rpcuser=litecoin
rpcpassword=local321
From within the devnode
directory with the configuration file, start the node:
../litecore-node/bin/litecore-node start