Trias StreamNet

The trias-lab/iri repository is the main StreamNet reference implementation, for the design details, please see yellow paper [StreamNet]. The original iri reference could be found at [iri].

-* License: GPLv3

1. Installing

The preferred option is that you compile yourself. The second option is that you utilize the provided jar, which is released whenever there is a new update here: Github Releases.

1.1 Compiling yourself

Make sure to have Maven and Java 8 installed on your computer.

1.1.1 To compile & package

git clone https://github.com/trias-lab/iri
cd iri
mvn clean compile
mvn package

This will create a target directory in which you will find the executable jar file that you can use.

1.1.2 To compiple docker

docker build -t <name>:<tag> .

This will create a docker image for you to deploy

1.2 Running yourself

1.2.1 How to run one node

Run one node in single transaction mode

cd scripts/examples/one_node/
./conflux_dag.sh
./start_cli.sh
./parallel_put_txn.sh
./get_balance.sh

Run one node in batch transaction mode

cd scripts/examples/one_node_batch
./conflux_dag.sh
./start_cli.sh
./parallel_put_txn.sh
./get_balance.sh

1.2.2 How to run two nodes

Run two nodes in single transaction mode

cd scripts/examples/two_nodes
./conflux_dag_two_nodes.sh
./start_cli_two_nodes.sh
./parallel_put_txn_two_nodes.sh
./get_balance_two_nodes.sh

Run two nodes in multiple transaction mode

cd scripts/examples/two_nodes_batch
./conflux_dag_two_nodes.sh
./start_cli_two_nodes.sh
./parallel_put_txn_two_nodes.sh
./get_balance_two_nodes.sh

1.2.3 How to run docker

$ docker run -d --net=host --name <name> -v <local_data_dir>:/iri/data -v <neighbor_file>:/iri/conf/neighbors <name>:<tag> /entrypoint.sh

2. MISC

2.1 Performance Tunning

Please refere [Performance tunning] for details of how to measure performance using Nginx + Jmeter.

2.2 Cluster deployment

Please refere [Cluster deployment] for details of how to deploy multiple nodes.