The next three steps are an example of how to acquire the source and build in an appropriate way.
Acquire the source and install dependencies.
git clone https://github.com/MealwormsBiz/worm
sudo chmod -R a+rw worm
cd worm/depends
./install-dependencies.sh
Set the default mingw-w32 g++ compiler option to auto (option 0) by default.
sudo update-alternatives --config i686-w64-mingw32-g++
Build in the usual way.
./build-wins.sh
The next three steps are an example of how to acquire the source and build in an appropriate way.
Acquire the source and install dependencies.
git clone https://github.com/MealwormsBiz/worm
sudo chmod -R a+rw worm
cd worm/depends
./install-dependencies.sh
Set the default mingw-w64 g++ compiler option to posix (option 1).
sudo update-alternatives --config x86_64-w64-mingw32-g++
Build in the usual way.
./build-wins.sh x64
Use
sudo add-apt-repository ppa:bitcoin/bitcoin; git clone https://github.com/MealwormsBiz/worm; cd worm; depends/install-dependencies.sh; ./autogen.sh; ./configure --disable-tests --with-boost-libdir=/usr/local/lib; make clean; make -j$(nproc)
Add bitcoin repository for Berkeley DB 4.8
sudo add-apt-repository ppa:bitcoin/bitcoin
Clone worm repository
git clone https://github.com/MealwormsBiz/worm
Build worm
cd worm
./depends/install-dependencies.sh
./autogen.sh
./configure --disable-tests
make -j$(nproc)
The commands in this guide should be executed in a Terminal application.
The built-in one is located in /Applications/Utilities/Terminal.app.
Install the OS X command line tools:
xcode-select --install
When the popup appears, click Install.
If you're running macOS Mojave 10.14/Xcode 10.0 or later, and want to use the depends system, you'll also need to use the following script to install the macOS system headers into /usr/include.
open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg
Then install Homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install cmake automake berkeley-db4 leveldb libtool boost@1.64 --c++11 --without-single --without-static miniupnpc openssl pkg-config protobuf qt5 libevent imagemagick --with-librsvg
Link boost 1.64
brew link boost@1.64 --force
Clone the Worm source code and cd into worm
git clone https://github.com/MealwormsBiz/worm
cd worm
./building/mac/requirements.sh
./building/mac/build.sh
This example lists the steps necessary to setup and build a command line only, non-wallet distribution of the latest changes on Arch Linux:
pacman -S git base-devel boost libevent python
git clone https://github.com/MealwormsBiz/worm
cd worm/
./autogen.sh
./configure --without-miniupnpc --disable-tests
make -j$(nproc)
Note:
Enabling wallet support requires either compiling against a Berkeley DB newer than 4.8 (package db) using --with-incompatible-bdb,
or building and depending on a local version of Berkeley DB 4.8. The readily available Arch Linux packages are currently built using
--with-incompatible-bdb according to the
As mentioned above, when maintaining portability of the wallet between the standard Bitcoin Core distributions and independently built
node software is desired, Berkeley DB 4.8 must be used.
These steps can be performed on, for example, an Ubuntu VM. The depends system will also work on other Linux distributions, however the commands for installing the toolchain will be different.
Make sure you install the build requirements mentioned above. Then, install the toolchain and curl:
sudo apt-get install g++-arm-linux-gnueabihf curl
To build executables for ARM:
cd depends
make HOST=arm-linux-gnueabihf NO_QT=1
cd ..
./configure --prefix=$PWD/depends/arm-linux-gnueabihf --enable-glibc-back-compat --enable-reduce-exports LDFLAGS=-static-libstdc++
make -j$(nproc)
For further documentation on the depends system see README.md in the depends directory.
Clang is installed by default as cc compiler, this makes it easier to get
started than on OpenBSD. Installing dependencies:
pkg install autoconf automake libtool pkgconf
pkg install boost-libs openssl libevent
pkg install gmake
You need to use GNU make (gmake) instead of make.
(libressl instead of openssl will also work)
For the wallet (optional):
./contrib/install_db4.sh `pwd`
setenv BDB_PREFIX $PWD/db4
Then build using:
./autogen.sh
./configure BDB_CFLAGS="-I${BDB_PREFIX}/include" BDB_LIBS="-L${BDB_PREFIX}/lib -ldb_cxx"
gmake
The master branch is regularly built and tested, but is not guaranteed to be
completely stable. Tags are created
regularly to indicate new official, stable release versions of Worm.
The contribution workflow is described in CONTRIBUTING.md.
Testing and code review is the bottleneck for development; we get more pull requests than we can review and test on short notice. Please be patient and help out by testing other people's pull requests, and remember this is a security-critical project where any mistake might cost people lots of money.
Developers are strongly encouraged to write unit tests for new code, and to
submit new unit tests for old code. Unit tests can be compiled and run
(assuming they weren't disabled in configure) with: make check. Further details on running
and extending unit tests can be found in /src/test/README.md.
There are also regression and integration tests of the RPC interface, written
in Python, that are run automatically on the build server.
These tests can be run (if the test dependencies are installed) with: qa/pull-tester/rpc-tests.py
Changes should be tested by somebody other than the developer who wrote the code. This is especially important for large or high-risk changes. It is useful to add a test plan to the pull request description if testing the changes is not straightforward.
We try to prompt our users for the basic information We always need for new issues.
Please fill out the issue template below and submit it to our discord channel
