neo-go/README.md

107 lines
3.1 KiB
Markdown
Raw Normal View History

2018-01-28 18:05:06 +00:00
<p align="center">
2018-02-24 07:23:02 +00:00
<img
src="https://neo-cdn.azureedge.net/images/neo_logo.svg"
width="250px">
2018-01-28 18:05:06 +00:00
</p>
<p align="center">
2018-02-01 17:40:04 +00:00
<b>Go</b> Node and SDK for the <a href="https://neo.org">NEO</a> blockchain.
2018-01-28 18:05:06 +00:00
</p>
<hr />
[![codecov](https://codecov.io/gh/nspcc-dev/neo-go/branch/master/graph/badge.svg)](https://codecov.io/gh/nspcc-dev/neo-go)
[![CircleCI](https://circleci.com/gh/nspcc-dev/neo-go/tree/master.svg?style=svg)](https://circleci.com/gh/nspcc-dev/neo-go/tree/master)
[![Report](https://goreportcard.com/badge/github.com/nspcc-dev/neo-go)](https://goreportcard.com/report/github.com/nspcc-dev/neo-go)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/nspcc-dev/neo-go?sort=semver)
![License](https://img.shields.io/github/license/nspcc-dev/neo-go.svg?style=popout)
2018-01-28 18:05:06 +00:00
# Overview
This project aims to be a full port of the original C# [NEO project](https://github.com/neo-project).
2018-02-01 17:40:04 +00:00
A complete toolkit for the NEO blockchain, including:
- Consensus node (WIP)
- [RPC node & client](https://github.com/nspcc-dev/neo-go/tree/master/pkg/rpc/README.md)
- [RPC client](https://github.com/nspcc-dev/neo-go/blob/master/pkg/rpc/README.md)
- [CLI tool](https://github.com/nspcc-dev/neo-go/blob/master/cli/README.md)
- [Smart contract compiler](https://github.com/nspcc-dev/neo-go/blob/master/pkg/vm/compiler/README.md)
- [NEO virtual machine](https://github.com/nspcc-dev/neo-go/blob/master/pkg/vm/README.md)
2018-02-01 17:40:04 +00:00
# Getting started
2018-01-31 11:51:02 +00:00
## Installation
2018-01-31 11:51:02 +00:00
Go: 1.12+
Install dependencies.
2018-01-28 18:37:03 +00:00
`neo-go` uses [GoModules](https://github.com/golang/go/wiki/Modules) as dependency manager:
2018-02-01 17:40:04 +00:00
2018-02-01 18:06:17 +00:00
```
make deps
```
## How to setup a node
### Docker
Each tagged build is built to docker hub and the `:latest` tag pointing at the latest tagged build.
By default the `CMD` is set to run a node on `testnet`, so to do this simply run:
```bash
docker run -d --name neo-go -p 20332:20332 -p 20333:20333 cityofzion/neo-go
```
Which will start a node on `testnet` and expose the nodes port `20333` and `20332` for the `JSON-RPC` server.
### Building
2018-02-01 18:06:17 +00:00
Build the **neo-go** CLI:
```
make build
```
2018-02-01 17:40:04 +00:00
Quick start a NEO node on the private network. This requires the [neo-privatenet](https://hub.docker.com/r/cityofzion/neo-privatenet/) Docker image running on your machine.
2018-01-28 18:37:03 +00:00
2018-02-01 17:40:04 +00:00
```
make run
2018-02-01 17:40:04 +00:00
```
2018-01-28 18:37:03 +00:00
To run the binary directly:
2018-02-01 17:40:04 +00:00
```
./bin/neo-go node
2018-02-01 17:40:04 +00:00
```
By default the node will run on the `private network`, to change his:
2018-02-01 17:40:04 +00:00
```
./bin/neo-go node --mainnet
2018-02-01 17:40:04 +00:00
```
Available network flags:
- `--mainnet, -m`
- `--privnet, -p`
- `--testnet, -t`
2018-01-31 11:51:02 +00:00
2018-01-29 07:11:08 +00:00
# Contributing
2018-01-31 11:51:02 +00:00
2018-02-24 07:23:02 +00:00
Feel free to contribute to this project after reading the
[contributing guidelines](https://github.com/nspcc-dev/neo-go/blob/master/CONTRIBUTING.md).
2018-02-01 17:40:04 +00:00
2018-02-24 07:23:02 +00:00
Before starting to work on a certain topic, create an new issue first,
describing the feature/topic you are going to implement.
2018-01-29 07:11:08 +00:00
2018-01-31 10:58:19 +00:00
# Contact
2018-02-01 17:40:04 +00:00
- [@roman-khimov](https://github.com/roman-khimov) on GitHub
- [@volekerb](https://github.com/volekerb) on Github
- Reach out to us on the [NEO Discord](https://discordapp.com/invite/R8v48YA) channel
# License
2018-02-01 17:40:04 +00:00
- Open-source [MIT](https://github.com/nspcc-dev/neo-go/blob/master/LICENSE.md)