go-nebulas

go-nebulas

Official Go implementation of the Nebulas protocol. The current version is 2.0, also called Nebulas Nova. For the roadmap of Nebulas, please visit the roadmap page.

For more information of Nebulas protocol, design documents, please refer to our wiki.

TestNet is released, please check here for more details.

Mainnet is released, please check here for more details.

Building from source

Prerequisites

Components	Version	Description
Golang	>= 1.12	The Go Programming Language

Build

Checkout repo.

git clone github.com/nebulasio/go-nebulas

The project is under active development. New users may want to checkout and use the stable mainnet release in master.

cd github.com/nebulasio/go-nebulas
git checkout master

Or use the stable testnet release in testnet.

git checkout testnet

Install native libs.

Nebulas execution need NVM and NBRE two dependent libraries. We provide stable versions of both libraries. Execute the execution script to install

cd github.com/nebulasio/go-nebulas

OS X:
./setup.sh

Linux:
source setup.sh

Note:

The dependency libraries are not installed in the system directory, and there are different path-loading methods used in Darwin and Linux systems.

• OS X:

  • In the user's root directory to create lib folder, system to load the library path can read this path, ensure that the root directory of the current folder does not exist. All of these operations in setup.sh already processing.(DYLD_LIBRARY_PATH is not possible unless System Integrity Protection (SIP) is disabled)

  ./setup.sh
  

• Linux - Ubuntu

  • setup.sh export LD_LIBRARY_PATH for native libs.

Build the neb binary.

• run command

make build

Building from Docker

You can specify the config file by modifying the docker-compose environment configuration.

• default docker compose config(version3):

version: '3'

services:
  
  node:
    image: nebulasio/go-nebulas
    build:
      context: ./docker
    ports:
      - '8680:8680'
      - '8684:8684'
      - '8685:8685'
      - '8888:8888'
      - '8086:8086'
    volumes:
      - .:/go/src/github.com/nebulasio/go-nebulas
    environment:
      - REGION=China
      - config=mainnet/conf/config.conf
    command: bash docker/scripts/neb.bash

• install docker and docker-compose
• run docker command

sudo docker-compose build
sudo docker-compose up -d

Run

Run node

Starting a Nebulas node is simple. After the build step above, run a command:

./neb [-c /path/to/config.conf]

Quick start please use script and added check(Recommend):

./start.sh mainnet|testnet|[-c /path/to/config.conf]

tips: more details about configuration, please refer to template.conf

You will see log message output like:

…

From the log, we can see the binary execution starts neblet, starts network service, starts RPC API server, and starts consensus state machine.

TestNet

We are glad to release Nebulas Testnet here. You can use and join our TestNet right now.

MaintNet

We are glad to release Nebulas Mainnet here. You can use and join our MainNet right now.

Explorer

Nebulas provides a block explorer to view block/transaction information. Please check Explorer.

Wallet

Nebulas provides a web wallet to send transaction and deploy/call contract. Please check Web-Wallet

Wiki

Please check our Wiki to learn more about Nebulas.

Contribution

We are very glad that you are considering to help Nebulas Team or go-nebulas project, including but not limited to source code, documents or others.

If you'd like to contribute, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base. If you wish to submit more complex changes though, please check up with the core devs first on our slack channel to ensure those changes are in line with the general philosophy of the project and/or get some early feedback which can make both your efforts much lighter as well as our review and merge procedures quick and simple.

Please refer to our contribution guideline for more information.

Thanks.

License

The go-nebulas project is licensed under the GNU Lesser General Public License Version 3.0 (“LGPL v3”).

For the more information about licensing, please refer to Licensing page.