https://github.com/rubenafo/eth-playground

Your very own private Ethereum cluster running on Docker
https://github.com/rubenafo/eth-playground

bitcoin blockchain dlt docker eth ethereum finance truffle

Last synced: 2 months ago
JSON representation

Your very own private Ethereum cluster running on Docker

• Host: GitHub
• URL: https://github.com/rubenafo/eth-playground
• Owner: rubenafo
• License: apache-2.0
• Created: 2019-06-11T07:07:54.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-04-28T02:32:35.000Z (over 3 years ago)
• Last Synced: 2024-04-14T22:45:12.517Z (9 months ago)
• Topics: bitcoin, blockchain, dlt, docker, eth, ethereum, finance, truffle
• Language: Java
• Homepage:
• Size: 223 KB
• Stars: 10
• Watchers: 2
• Forks: 12
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# eth-playground

An Ethereum private network running on Docker to mess with Blockchain and smart contracts.   





   


## Motivation

To provide a simple, private Ethereum setup as close as possible to a production environment where the nodes are completely independent and just share the same network.   

The setup is simple enough to allow further experiments (thus the *playground* name) and deals with all the technical details as Docker deployment, node discovery and stats reporting.

## Features 

Builds and maintains 3 independent nodes in a Docker network and a *bootnode* to connect them.   

* Vanilla Ethereum: everything is built and setup from scratch

* Each node gets its own IP address and eth account, also:

   * broadcasts its default account id from the **9090** TCP port.

   * reports stats to the *netstat* node that is running [eth-netstats](https://github.com/cubedro/eth-netstats)

* The *bootnode* node connects nodes dynamically when added into the network

* A *netstat* node displaying the [eth-netstat dashboard](https://github.com/cubedro/eth-netstats)

* *epl*, a CLI tool to perform maintenance operations: build, start, stop, login into nodes, check truffle, etc

## Install

1. Clone this repo

2. cd eth-playground

2. ./build.sh

3. ./epl deploy

Docker will display 4 nodes (ethbn, eth1, eth2, eth3) running inside the **ethnet** network.

## Epl Usage

Once installed the nodes are fully independentent and self-discoverable thanks to the bootnode in place (**ethbn**).

* epl login _nodeName_ : logs automatically inside the selected node

* epl geth _nodeName_  : opens a geth console inside the selected node

* epl stop : stops the eth network

* epl start: starts the network again

* epl deploy: stops and deploys the whole network again

* epl info: displays the netstat node URL containing the dashboard