Vox is an experimental Delegated Proof of Stake blockchain with an unproven consensus algorithm.
- Currency symbol Vox
- 1.000 Vox block reward at launch
- 10% APR inflation narrowing to 1% APR over 20 years.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Rather than attempt to describe the rules of the blockchain, it is up to each individual to inspect the code to understand the consensus rules.
A list of some seed nodes to get you started: 1. 2.
Specifies whether to build with or without optimization and without or with the symbol table for debugging. Unless you are specifically debugging or running tests, it is recommended to build as release.
Builds voxd to be a consensus-only low memory node. Data and fields not needed for consensus are not stored in the object database. This option is recommended for witnesses and seed-nodes.
Clears old votes from memory that are no longer required for consensus.
Builds vox for use in a private testnet. Also required for building unit tests.
The account history plugin does not allow querying of operations by transaction id. This requires around 65% of CPU time when reindexing so disabling the index is a huge gain if you do not need this functionality.
For Ubuntu 16.04 users, after installing the right packages with apt Vox
will build out of the box without further effort:
# Required packages
sudo apt-get install -y \
autoconf \
automake \
cmake \
g++ \
git \
libssl-dev \
libtool \
make \
pkg-config \
python3 \
python3-jinja2
# Boost packages (also required)
sudo apt-get install -y \
libboost-chrono-dev \
libboost-context-dev \
libboost-coroutine-dev \
libboost-date-time-dev \
libboost-filesystem-dev \
libboost-iostreams-dev \
libboost-locale-dev \
libboost-program-options-dev \
libboost-serialization-dev \
libboost-signals-dev \
libboost-system-dev \
libboost-test-dev \
libboost-thread-dev
# Optional packages (not required, but will make a nicer experience)
sudo apt-get install -y \
doxygen \
libncurses5-dev \
libreadline-dev \
perl
git clone https://github.com/voxchain/vox
cd vox
git checkout origin/vox
git submodule update --init --recursive
cmake -DCMAKE_BUILD_TYPE=Release .
make -j$(nproc) voxd
make -j$(nproc) cli_wallet
# optional
make install # defaults to /usr/local
(It is strongly advised to use Ubuntu 16.04 LTS instead)
Here are the required packages:
# Required packages
sudo apt-get install -y \
autoconf \
cmake \
g++ \
git \
libssl-dev \
libtool \
make \
pkg-config \
doxygen \
libncurses5-dev \
libreadline-dev \
libbz2-dev \
python-dev \
perl \
python3 \
python3-jinja2
The Boost provided in the Ubuntu 14.04 package manager (Boost 1.55) is too old. Vox requires Boost 1.58 (as in Ubuntu 16.04) and works with versions up to 1.60 (including). So building Vox on Ubuntu 14.04 requires downloading and installing a more recent version of Boost.
According to this mailing list post, Boost 1.58 is not compatible with gcc 4.8 (the default C++ compiler for Ubuntu 14.04) when compiling in C++11 mode (which Vox does). So we will use Boost 1.60.
Here is how to build and install Boost 1.60 into your user's home directory (make sure you install all the packages above first):
export BOOST_ROOT=$HOME/opt/boost_1_60_0
URL='http://sourceforge.net/projects/boost/files/boost/1.60.0/boost_1_60_0.tar.bz2/download'
wget -c "$URL" -O boost_1_60_0.tar.bz2
[ $( sha256sum boost_1_60_0.tar.bz2 | cut -d ' ' -f 1 ) == \
"686affff989ac2488f79a97b9479efb9f2abae035b5ed4d8226de6857933fd3b" ] \
|| ( echo 'Corrupt download' ; exit 1 )
tar xjf boost_1_60_0.tar.bz2
cd boost_1_60_0
./bootstrap.sh "--prefix=$BOOST_ROOT"
./b2 install
Then the instructions are the same as for Vox:
git clone https://github.com/voxchain/vox
cd vox
git submodule update --init --recursive
git checkout origin/vox
cmake -DCMAKE_BUILD_TYPE=Release .
make -j$(nproc) voxd
make -j$(nproc) cli_wallet
Install Xcode and its command line tools by following the instructions here: https://guide.macports.org/#installing.xcode. In OS X 10.11 (El Capitan) and newer, you will be prompted to install developer tools when running a developer command in the terminal.
Accept the Xcode license if you have not already:
sudo xcodebuild -license accept
Install Homebrew by following the instructions here: http://brew.sh/
brew doctor brew update
brew install \
autoconf \
automake \
cmake \
git \
boost160 \
libtool \
openssl \
python3 \
python3-jinja2
Note: brew recently updated to boost 1.61.0, which is not yet supported by vox. Until then, this will allow you to install boost 1.60.0.
Optional. To use TCMalloc in LevelDB:
brew install google-perftools
Optional. To use cli_wallet and override macOS's default readline installation:
brew install --force readline
brew link --force readline
git clone https://github.com/voxchain/vox.git
cd vox
git checkout origin/vox
export OPENSSL_ROOT_DIR=$(brew --prefix)/Cellar/openssl/1.0.2h_1/
export BOOST_ROOT=$(brew --prefix)/Cellar/[email protected]/1.60.0/
git submodule update --init --recursive
cmake -DBOOST_ROOT="$BOOST_ROOT" -DCMAKE_BUILD_TYPE=Release .
make -j$(sysctl -n hw.logicalcpu)
Also, some useful build targets for make are:
voxd
chain_test
cli_wallet
e.g.:
make -j$(sysctl -n hw.logicalcpu) voxd
This will only build voxd.
-
Windows build instructions do not yet exist.
-
The developers normally compile with gcc and clang. These compilers should be well-supported.
-
Community members occasionally attempt to compile the code with mingw, Intel and Microsoft compilers. These compilers may work, but the developers do not use them. Pull requests fixing warnings / errors from these compilers are accepted.
See doc/testing.md for test build targets and info on how to use lcov to check code test coverage.