TrueChain Consensus Protocol
Make sure you have hmake in your $GOBIN
path.
This project uses:
- HyperMake to interact with toolchain (containerized environment) and build cross-platform binaries.
gvt
to manage dependencies.
$ hmake --targets
$ hmake check
$ hmake build
The first time, it would download:
- TrueChain's docker image
go-toolchain
from https://hub.docker.com/r/truechain/go-toolchain/ - Dependencies as per
src/vendor/manifest
, which again, could be generated using gvt.
The binaries would be available in bin/
's platform-specific folders.
git clone https://github.com/truechain/truechain-consensus-core.git
cd truechain-consensus-core
git checkout devel
OR
go get -u github.com/truechain/truechain-consensus-core
Make sure you have $GOBIN
in $PATH
:
export GOBIN=$GOPATH/bin
export PATH=$PATH:$GOBIN
And before running, make sure you have the following taken care of, for orchestration:
-
TRUE_TUNABLES_CONF
corresponds to/etc/truechain/tunables_bft.yaml
, default's under project'sconfig/
folder. -
TRUE_GENERAL_CONF
corresponds to/etc/truechain/logistics_bft.cfg
, default's under this project'sconfig/
-
TRUE_NETWORK_CONF
corresponds to/etc/truechain/hosts
, Default's under this project'sconfig/
This file is populated with repetitive 5-6 lines containing loopback IP address127.0.0.1
. -
TRUE_SIMULATION
is as follows:
- if set to 0 (default) - should tell the project to pickup testbed configurations.
- if set to 1 - staging, meaning all CI/CD tests are run before draft run. (dummy functionality at the moment)
- if set to 1 - production. Will try to connect to boot nodes. (dummy functionality at the moment)
Server:
./bin/{linux/darwin}/truechain-engine
Client:
$ ./bin/{linux/darwin}/pbft-client -h
Usage of pbft-client:
-numquest int
number of requests (default 10)
Optional - To install:
./support/scripts/install.sh linux
# then from 1 shell, run
$ truechain-engine
# and a different shell, run
$ pbft-client -numquest 40
This triggers both server and client subroutines. Also displays progress of key signing, data exchange and ledger log.
2018/07/31 18:19:23 Loaded logistics configuration.
[.]Loading IP configs...
2018/07/31 18:19:23 ---> using following configurations for project:
tunables:
testbed:
total: 5
client_id: 5
server_id_init: 4
127.0.0.1 49500 0
[!]Going to tolerate 1 adversaries
[!]Initial Node Config &{cfg:0xc4200a6600 mu:{state:0 sema:0} clientMu:{state:0 sema:0} peers:[] port:49500 killFlag:false ListenReady:<nil> SetupReady:<nil> EcdsaKey:<nil> helloSignature:<nil> connections:0 ID:0 N:4 view:0 viewInUse:true f:1 lowBound:0 highBound:0 Primary:0 seq:0 lastExecuted:0 lastStableCheckpoint:0 checkpointProof:[] checkpointInterval:100 vmin:0 vmax:0 waiting:map[] timeout:600 clientBuffer: active:map[] prepared:map[] prepDict:map[] commDict:map[] viewDict:map[] KeyDict:map[] outputLog:<nil> commitLog:<nil> nodeMessageLog:{mu:{state:0 sema:0} content:map[]} clientMessageLog:map[] committedBlock:<nil> txPool:<nil> genesis:<nil> tc:<nil>}
[ ]Genesis block generated: 56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421
...
<snip>
...
[!][3] ProxyProcessCommit 4
[!][1] Committed 4
[!][2] Committed 4
[!][3] Committed 4
hmake build test check
TODO: add travis yaml
In case you have a new dependency that's not listed in trueconsensus/vendor/manifest
folder, just run this from trueconsensus/
:
gvt fetch github.com/fatih/color
This would add a folder trueconsensus/vendor
if not already present, and would also generate/append to trueconsensus/vendor/manifest
.
Note that gvt fetch <package_name>
updates the file src/vendor/manifest
.
Additionally, you could choose to build without using containers. For a very basic sanity test, run the following:
./support/scripts/build.sh {linux/darwin}
Note: you could also use darwin
as an argument to build.sh instead of linux
to get an OSX binary. Support for more will be extended soon.
To be added.
To be added.
Feedback is greatly appreciated. We're a blend of py-go-c++
devs looking to merge ideas and we may err at times in the realm of language paradigms and correct design approach. We're hoping to find you (yes you!) and incentivize you for auditing our codebase, polish the erm out of it and teach us how to fish in this process. Feel free to open issues / contact us on our channels.
We need contributions from you. You are welcome to create github issues and contribute to the codebase. We have a list of important tasks from Truechain Foundation. We welcome people who have related background to join our consensus design and implementation.
The maintainers actively manage the issues list, and try to highlight issues suitable for newcomers. The project follows the typical GitHub pull request model. See CONTRIBUTIONS.md for more details. Before starting any work, please either comment on an existing issue, or file a new one.
Track our Milestones here And for different codebases of truechain engineering, here's an explanation
Join our gitter channel for live discussions and clarifications.
- For contributions/general engineering discussions and all things PR/codebases truechain-net/engg-foss-global
- For events, announcements and so on truechain-net/community
- For research, truechain-net/research
- Architecture at truechain-net/architecture
Subscribe to the google groups mailing list to receive regular updates and post discussions
- Main site: https://www.truechain.pro/en/
- News from Truechain https://www.truechain.pro/en/news
- Twitter: https://twitter.com/truechaingroup
- Facebook: https://www.facebook.com/TrueChaingroup/
- Telegram: http://www.t.me/truechainglobal/
The Apache License (2.0).
A copy of the header is included within all files in the codebase along with the full LICENSE txt file in project's root folder.