README
¶
AnnChain/简体中文
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.
| Branch | Tests | Coverage |
|---|---|---|
| master | |
 |
Releases
Automated builds are available for stable releases.
Requirements
| Requirement | Notes |
|---|---|
| Go version | Go1.12.0 or higher |
Building the source
export GOPATH=$HOME/.gopkgs
git clone https://github.com/dappledger/AnnChain.git
cd AnnChain
./get_pkgs.sh
make
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": "0.0.0.0:23000",
"pub_key": [
1,
"35EC28D113DB8D057140F903BAB049770CABAD4C2838509602552511C3F2D2E3"
],
"rpc": "ann7939-validator8fc99df2-2.default.svc.cluster.local:47000"
},
"peers": [
{
"bind": "ann7939-validator480649ca-0.default.svc.cluster.local:23000",
"pub_key": [
1,
"7B788FD0A5A1504C438B2D6B5602717C07F5E82D25175B4065B75C46017B770D"
],
"rpc": "ann7939-validator480649ca-0.default.svc.cluster.local:47000"
},
{
"bind": "ann7939-validatorb14a47dc-1.default.svc.cluster.local:23000",
"pub_key": [
1,
"1FE0A5560BB9376348CB8F218BDA2011280606571DB20B841FA9F7560143796D"
],
"rpc": "ann7939-validatorb14a47dc-1.default.svc.cluster.local:47000"
},
{
"bind": "ann7939-validator8fc99df2-2.default.svc.cluster.local:23000",
"pub_key": [
1,
"35EC28D113DB8D057140F903BAB049770CABAD4C2838509602552511C3F2D2E3"
],
"rpc": "ann7939-validator8fc99df2-2.default.svc.cluster.local:47000"
},
{
"bind": "ann7939-validatore78bd527-3.default.svc.cluster.local:23000",
"pub_key": [
1,
"3C521E9D3D942654FA1E6C52E7B3A4EDE059E047FB4DF4F00F04C092149002EA"
],
"rpc": "10.103.237.176:47000"
}
]
}
-
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.sh genesis
./build/genesis init
./build/genesis run
Local cluster using docker-compose
# docker build image and docker-compose run
make fastrun
# remove cluster
make clean_fastrun
Usage
Command Tool
Golang SDK
Java SDK
Applications
Contributing
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
Directories
¶
| Path | Synopsis |
|---|---|
|
chain
|
|
|
cmd
|
|
|
Package ethereum defines interfaces for interacting with Ethereum.
|
Package ethereum defines interfaces for interacting with Ethereum. |
|
accounts/abi
Package abi implements the Ethereum ABI (Application Binary Interface).
|
Package abi implements the Ethereum ABI (Application Binary Interface). |
|
accounts/abi/bind
Package bind generates Ethereum contract Go bindings.
|
Package bind generates Ethereum contract Go bindings. |
|
common
Package common contains various helper functions.
|
Package common contains various helper functions. |
|
common/hexutil
Package hexutil implements hex encoding with 0x prefix.
|
Package hexutil implements hex encoding with 0x prefix. |
|
common/math
Package math provides integer math utilities.
|
Package math provides integer math utilities. |
|
common/mclock
Package mclock is a wrapper for a monotonic clock source
|
Package mclock is a wrapper for a monotonic clock source |
|
core/rawdb
Package rawdb contains a collection of low level database accessors.
|
Package rawdb contains a collection of low level database accessors. |
|
core/state
Package state provides a caching layer atop the Ethereum state trie.
|
Package state provides a caching layer atop the Ethereum state trie. |
|
core/types
Package types contains data types related to Ethereum consensus.
|
Package types contains data types related to Ethereum consensus. |
|
core/vm
Package vm implements the Ethereum Virtual Machine.
|
Package vm implements the Ethereum Virtual Machine. |
|
core/vm/runtime
Package runtime provides a basic execution model for executing EVM code.
|
Package runtime provides a basic execution model for executing EVM code. |
|
crypto/bn256
Package bn256 implements the Optimal Ate pairing over a 256-bit Barreto-Naehrig curve.
|
Package bn256 implements the Optimal Ate pairing over a 256-bit Barreto-Naehrig curve. |
|
crypto/bn256/cloudflare
Package bn256 implements a particular bilinear group at the 128-bit security level.
|
Package bn256 implements a particular bilinear group at the 128-bit security level. |
|
crypto/bn256/google
Package bn256 implements a particular bilinear group.
|
Package bn256 implements a particular bilinear group. |
|
crypto/secp256k1
Package secp256k1 wraps the bitcoin secp256k1 C library.
|
Package secp256k1 wraps the bitcoin secp256k1 C library. |
|
event
Package event deals with subscriptions to real-time events.
|
Package event deals with subscriptions to real-time events. |
|
log
Package log15 provides an opinionated, simple toolkit for best-practice logging that is both human and machine readable.
|
Package log15 provides an opinionated, simple toolkit for best-practice logging that is both human and machine readable. |
|
metrics
Go port of Coda Hale's Metrics library <https://github.com/rcrowley/go-metrics> Coda Hale's original work: <https://github.com/codahale/metrics>
|
Go port of Coda Hale's Metrics library <https://github.com/rcrowley/go-metrics> Coda Hale's original work: <https://github.com/codahale/metrics> |
|
metrics/exp
Hook go-metrics into expvar on any /debug/metrics request, load all vars from the registry into expvar, and execute regular expvar handler
|
Hook go-metrics into expvar on any /debug/metrics request, load all vars from the registry into expvar, and execute regular expvar handler |
|
rlp
Package rlp implements the RLP serialization format.
|
Package rlp implements the RLP serialization format. |
|
trie
Package trie implements Merkle Patricia Tries.
|
Package trie implements Merkle Patricia Tries. |
|
ed25519
Package ed25519 implements the Ed25519 signature algorithm.
|
Package ed25519 implements the Ed25519 signature algorithm. |
|
modules/go-common
Classical-inheritance-style service declarations.
|
Classical-inheritance-style service declarations. |
|
modules/go-flowrate/flowrate
Package flowrate provides the tools for monitoring and limiting the flow rate of an arbitrary data stream.
|
Package flowrate provides the tools for monitoring and limiting the flow rate of an arbitrary data stream. |
|
p2p
Uses nacl's secret_box to encrypt a net.Conn.
|
Uses nacl's secret_box to encrypt a net.Conn. |
|
p2p/upnp
Taken from taipei-torrent Just enough UPnP to be able to forward ports
|
Taken from taipei-torrent Just enough UPnP to be able to forward ports |
|
rpc/server
Commons for HTTP handling
|
Commons for HTTP handling |
|
scripts
|
|
Click to show internal directories.
Click to hide internal directories.