TrueChain Engineering Code
TrueChain is a truly fast, permissionless, secure and scalable public blockchain platform which is supported by hybrid consensus technology called Minerva and a global developer community. TrueChain uses hybrid consensus combining PBFT and fPoW to solve the biggest problem confronting public blockchain: the contradiction between decentralization and efficiency.
TrueChain uses PBFT as fast-chain to process transactions, and leave the oversight and election of PBFT to the hands of PoW nodes. Besides, TrueChain integrates fruitchain technology into the traditional PoW protocol to become fPoW, to make the chain even more decentralized and fair.
TrueChain also creates a hybrid consensus incentive model and a stable gas fee mechanism to lower the cost for the developers and operators of DApps, and provide better infrastructure for decentralized eco-system.
Building the source
Building getrue requires both a Go (version 1.14 or later) and a C compiler. You can install them using your favourite package manager. Once the dependencies are installed, run
make getrue
or, to build the full suite of utilities:
make all
The execuable command getrue will be found in the cmd
directory.
Running getrue
Going through all the possible command line flags is out of scope here (please consult our CLI Wiki page), also you can quickly run your own getrue instance with a few common parameter combos.
Running on the Truechain main network
$ getrue console
This command will:
- Start getrue with network ID
19330
in full node mode(default, can be changed with the--syncmode
flag after version 1.1). - Start up Getrue's built-in interactive console,
(via the trailing
console
subcommand) through which you can invoke all officialweb3
methods as well as Geth's own management APIs. This too is optional and if you leave it out you can always attach to an already running Getrue instance withgetrue attach
.
Running on the Truechain test network
To test your contracts, you can join the test network with your node.
$ getrue --testnet console
The console
subcommand has the exact same meaning as above and they are equally useful on the
testnet too. Please see above for their explanations if you've skipped here.
Specifying the --testnet
flag, however, will reconfigure your Geth instance a bit:
- Test network uses different network ID
18928
- Instead of connecting the main TrueChain network, the client will connect to the test network, which uses testnet P2P bootnodes, and genesis states.
Configuration
As an alternative to passing the numerous flags to the getrue
binary, you can also pass a configuration file via:
$ getrue --config /path/to/your_config.toml
To get an idea how the file should look like you can use the dumpconfig
subcommand to export your existing configuration:
$ getrue --your-favourite-flags dumpconfig
Running on the Truechain singlenode(private) network
To start a getrue instance for single node, run it with these flags:
$ getrue --singlenode console
Specifying the --singlenode
flag, however, will reconfigure your Geth instance a bit:
- singlenode network uses different network ID
400
- Instead of connecting the main or test TrueChain network, the client has no peers, and generate fast block without committee.
Which will start sending transactions periodly to this node and mining fruits and snail blocks.