Repository files navigation

TrueChain Consensus Protocol

InstallDocker andHyperMake.

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 imagego-toolchain fromhttps://hub.docker.com/r/truechain/go-toolchain/
• Dependencies as persrc/vendor/manifest, which again, could be generated usinggvt.

The binaries would be available inbin/'s platform-specific folders.

git clone https://github.com/truechain/truechain-consensus-core.gitcd truechain-consensus-coregit checkout devel

OR

go get -u github.com/truechain/truechain-consensus-core

Make sure you have$GOBIN in$PATH:

export GOBIN=$GOPATH/binexport PATH=$PATH:$GOBIN

And before running, make sure you have the following taken care of, for orchestration:

1. TRUE_TUNABLES_CONF corresponds to/etc/truechain/tunables_bft.yaml, default's under project'sconfig/ folder.

2. TRUE_GENERAL_CONF corresponds to/etc/truechain/logistics_bft.cfg, default's under this project'sconfig/

3. 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.

4. 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 -hUsage 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: 4127.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 intrueconsensus/vendor/manifest folder, just run this fromtrueconsensus/:

gvt fetch github.com/fatih/color

This would add a foldertrueconsensus/vendor if not already present, and would also generate/append totrueconsensus/vendor/manifest.

Note thatgvt fetch <package_name> updates the filesrc/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 usedarwin as an argument to build.sh instead oflinux 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 ofpy-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 joinour 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.SeeCONTRIBUTIONS.md for more details.Before starting any work, please either comment on an existing issue, or file a new one.

Track ourMilestones hereAnd for different codebases of truechain engineering,here's an explanation

Join our gitter channel for live discussions and clarifications.

1. For contributions/general engineering discussions and all things PR/codebasestruechain-net/engg-foss-global
2. For events, announcements and so ontruechain-net/community
3. For research,truechain-net/research
4. Architecture attruechain-net/architecture

Subscribe to thegoogle groups mailing list to receive regular updates and post discussions

• Main site:https://www.truechain.pro/en/
  • News from Truechainhttps://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 fullLICENSE txt file in project's root folder.