Skip to content
AnnChain is the core engine of the new generation alliance chain of Zhongan Science and Technology
Go C C++ Assembly Java Python Other
Branch: master
Clone or download

Latest commit


Type Name Latest commit message Commit time
Failed to load latest commit information.
chain add account and nonce to audit log Jan 14, 2020
cmd gtool add pending nonce and update docs Feb 5, 2020
docker update docker Aug 30, 2019
docs gtool add pending nonce and update docs Feb 5, 2020
eth add KV tx Oct 30, 2019
gemmill logger : rename time key Feb 7, 2020
scripts optimize code Aug 16, 2019
utils add audit log Dec 26, 2019
version commit message May 27, 2019
.gitignore optimize code Oct 10, 2019
.travis.yml add smoke test to ci Dec 27, 2019
LICENSE add LICENSE May 27, 2019
Makefile optimize make test Sep 29, 2019 add readme cn Dec 30, 2019 add readme cn Dec 30, 2019 fix rtool's version Oct 15, 2019
codecov.yml Create codecov.yml Sep 19, 2019
docker-compose.yaml specialop--->adminOp Dec 10, 2019 optimize code Aug 16, 2019
go.mod Update go.mod Nov 13, 2019
go.sum add raft Sep 5, 2019



AnnChain is the core engine of the new generation alliance chain of Zhongan Science and Technology. It has the characteristics of high security, high performance and high availability. It aims to provide a tightly integrated block chain system for enterprises. It is very suitable for business cooperation among commercial organizations with alliance nature, and also for high-frequency financial transactions and security. A demanding scene. Dozens of actual business scenarios have been applied.

version API Reference Go version Go Report Card Travis license

Branch Tests Coverage
master TravisCI codecov


Automated builds are available for stable releases.


Requirement Notes
Go version Go1.12.0 or higher

Building the source

export GOPATH=$HOME/.gopkgs

git clone

cd AnnChain



Supported Consensus

AnnChain supports bft and raft consensus as valid consensus options,and bft is the default.if you want to use raft, you can operate like this:

First, set consensus to raft in config.toml file:
consensus = "raft"
Then, add raft peers config file raft-cluster.json into the runtime dir(take four nodes for example):
    "advertise": "ann7939-validator8fc99df2-2.default.svc.cluster.local:23000",
    "local": {
        "bind": "",
        "pub_key": [
        "rpc": "ann7939-validator8fc99df2-2.default.svc.cluster.local:47000"
    "peers": [
            "bind": "ann7939-validator480649ca-0.default.svc.cluster.local:23000",
            "pub_key": [
            "rpc": "ann7939-validator480649ca-0.default.svc.cluster.local:47000"
            "bind": "ann7939-validatorb14a47dc-1.default.svc.cluster.local:23000",
            "pub_key": [
            "rpc": "ann7939-validatorb14a47dc-1.default.svc.cluster.local:47000"
            "bind": "ann7939-validator8fc99df2-2.default.svc.cluster.local:23000",
            "pub_key": [
            "rpc": "ann7939-validator8fc99df2-2.default.svc.cluster.local:47000"
            "bind": "ann7939-validatore78bd527-3.default.svc.cluster.local:23000",
            "pub_key": [
            "rpc": ""
  • advertise: advertise address is used for others peers to connect.

  • local.bind: local bind address for raft protocl.

  • local.pub_key: node's pubkey, same as pbft pubkey.

  • local.rpc: node's rpc bind address.

  • peers: others node's bind address and pub_key info, including it selft.

Quick Start

Single node

./build/genesis init

./build/genesis run

Local cluster using docker-compose

## start cluster
➜  docker-compose up

## remove cluster
➜  docker-compose down


Command Tool
Golang SDK
Java SDK



If you have any questions,please report.
If you'd like to contribute code, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base

You can’t perform that action at this time.