Private Geth Testnet

Ethereum network is a peer-to-peer network consists of multiple nodes running the Ethereum client such as Geth or OpenEthereum.
In this repository, we are setting up a private network with N nodes as follows:

1. Bootnode — the bootstrap node that is used for peer discovery purpose. It listens on port 30303, the other nodes joining the network connect to this bootnode first.
2. JSON-RPC endpoint — this node exposes JSON-RPC API over HTTP endpoint on port 8545. We will publish the port 8545 of this node container to the host machine to allow external interaction with this private blockchain.
3. Miner — this node is responsible for mining (the process of creating a new block in our blockchain). When the miner node successfully mines a new block, it receives the rewards into the configured account.

Requirements

• Docker Engine should be installed and running.
• Docker Compose
• jq , JSON Command line tool
• sed, File Streams Command line tool

Testnet related operations

Using the control.sh script

control.sh is the main control script for the testnet.
Usage : control.sh <action> <arguments>

Actions:
  start  --val-num|-n <num of validators>
       Starts a network with <num_validators> 
  configure --val-num|-n <num of validators>
       configures a network with <num_validators> 
  stop
       Stops the running network
  clean
       Cleans up the configuration directories of the network
  status
       Prints the status of the network

Contributors

IFF Research Team @ UNIC

• Marios Touloupos ( @mtouloup ) - UBRI Fellow Researcher / PhD Candidate, University of Nicosia - Institute for the Future ( UNIC -IFF)
• Antonios Inglezakis ( @antIggl ) - UBRI Fellow Researcher / Senior Software Engineer and Systems Administrator, University of Nicosia - Institute For the Future (UNIC-IFF)

Research Team

• Marios Touloupou (@mtouloup) [ [email protected] ]
• Antonios Inglezakis (@antiggl) [ [email protected] ]
• Klitos Christodoulou [ [email protected] ]
• Elias Iosif [ [email protected] ]

Acknowledgements

This work is funded by the Ripple’s Impact Fund, an advised fund of Silicon Valley Community Foundation (Grant id: 2018–188546). Link: University Blockchain Research Initiative

About IFF

IFF is an interdisciplinary research centre, aimed at advancing emerging technologies, contributing to their effective application and evaluating their impact. The general mission at IFF is to educate leaders, develop knowledge and build communities to help society prepare for a future shaped by transformative technologies. The institution has been engaged with the community since 2013 offering the World’s First Massive Open Online Course (MOOC) on blockchain and cryptocurrency for free, supporting the community and bridging the educational gap on blockchains and digital currencies.