Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Metaverse Core Integration/staging Tree

Build Status AGPL v3



Metaverse(MVS) is a decentralised system based on the blockchain technology, through which, a network of smart properties, digital identities and value intermediators are established.

Metaverse Features:

Building MVS

Compiler requirements

Compilier Minimum Version Recommanded Version
gcc/g++ 5.0 9.0.0+
clang++ 3.4 (8.0.0) 10.0.0+
MSVC 19.0 (VS2015) VS2019

C++ compiler support C++14 standard or newer. Dependencies of MVS binaris are static linked (including libstdc++).

Toolchain requirements

  • cmake 3.0+
  • git
  • automake (speck256k1/ZeroMQ)
$ yum/brew/apt-get install git cmake
$ yum/brew/apt-get install autoconf automake libtool pkg-config

Setup Library Dependencies


Installing ZeroMQ secp256k1 automatically by:

$ sudo ./

Installing boost upnp automatically by:

$ sudo ./ --build-boost --build-upnpc


boost 1.56+

$ sudo yum/brew/apt-get install libboost-all-dev

Download Boost 1.69.0.

zeromq 4.2.1+

$ wget
$ tar -xzvf zeromq-4.2.1.tar.gz
$ cd zeromq-4.2.1
$ ./
$ ./configure
$ make -j4
$ sudo make install && sudo ldconfig

server/explorer requires ZeroMQ.


$ git clone
$ cd secp256k1
$ ./
$ ./configure --enable-module-recovery
$ make -j4
$ sudo make install && sudo ldconfig

Sometimes we may got the following compile error undefined reference to '__gmpn_sub_n' ... See more details here #issue209

$ ./configure --enable-module-recovery --with-bignum=no


$ wget
$ tar -xzvf miniupnpc-2.0.tar.gz
$ cd miniupnpc-2.0
$ make -j4
$ sudo INSTALLPREFIX=/usr/local make install && sudo ldconfig

blockchain/network requires upnp if specified.


$ git clone
$ cd metaverse && mkdir build && cd build
$ cmake -DUSE_UPNP=OFF ..
$ make -j4
$ make install

To enable UPnP, use cmake .. instead.


$ make test (should install boost_unit_test_framework)
$ make doc  (should install doxygen and graphviz)

Run it

  • mvsd - server program
    Runs a full metaverse node in the global peer-to-peer network.

  • mvs-cli - client program
    Sent your request to the server, the server will process it and return response to your client.

$ cd bin
$ ./mvsd
$ ./mvs-cli
$ ./mvs-cli getnewaccount -h
$ ./mvs-cli $command $params $options

Read More Command line usage and Configuration file.

Building/Run under docker


Install Docker.

wget qO | sh

Build Metaverse docker image

git clone
cd metaverse
docker build -t metaverse -f docker/Dockerfile .

Where is your built image? It’s in your machine’s local Docker image registry:

docker images

Run && Test

Start docker container

docker run -p 8820:8820 metaverse


curl -X POST --data '{"jsonrpc":"2.0","method":"getinfo","params":[],"id":25}'

Execute mvs-cli commands

Run mvs-cli commands via docker exec command. Example:

docker exec metaverse mvs-cli getinfo

Docker Compose

An example docker-compose file can be found at docker/docker-compose.yml.

docker-compose -f docker/docker-compose.yml up
# OR
cd docker
docker-compose up -d

# Use CLI
docker-compose exec mvs-cli getheight

Build for raspberry pi

Cross compile mvs using Docker in ubuntu 16.04

you need to change to root when executing the flowing command.


check versin first, linux kerne and docker version:

host docker >= 17.05.0-ce
host kernel >= 4.8

install qemu:

apt-get install qemu-user-static


Clone the mvs source. then enter mvs source directory, then run:

// for arm 64 (eg: aarch64, armv8(and abover))
sudo bash ./ arm64

When everything ok, the binary file and .so/.a file will be found in output directory.