智慧物流>> geth-cluster>> 返回
项目作者： SteveKeller

项目描述 ：
Private Ethereum Blockchain - dockerized
高级语言： JavaScript
项目地址: git://github.com/SteveKeller/geth-cluster.git
创建时间： 2018-08-02T20:50:05Z
项目社区：https://github.com/SteveKeller/geth-cluster
开源协议：MIT License
下载


Private Ethereum Blockchain - Geth Cluster

This project provide a private ethereum blockchain based on a geth cluster with additional features.

F1: automatically P2P discovery with a bootnode for all ethereum miners

F2: miners are scalable while runtime

F3: exposed node for interacting (additional miners, remix, web3, node-red, …) from outside with the blockchain

F4: smart contract deployment with truffle

F5: integrated blockchain explorer

F6: some tests :)

ever wanted to have your own ethereum blockchain and just play a little?

…then it’s a match ;)

Requirements

Software
  • docker 18.03.0-ce <=
  • docker-compose 1.21.0 <=
Ressource Recommendations

CPU depends heavy on running miner count, default miner count is 2, each miner mines with 1 cpu thread

  • Disk Space (docker dir) >= 10GB
  • CPU >= 4
  • Memory >= 2GB
Prerequisites
  • clone geth-cluster repo
  • edit envar.env file and set environment variables for your setup

Getting Started

  1. docker-compose up

Ethereum Blockchain needs about 30 minutes for bootstrapping (depends on your cpu hardware), which means to build and run all containers. Building container is only required if they are not already build once.
The ethereum network builds a DAG (directed acyclic graph) for the proof of work algorithm. The building process takes all available cpu cores from the docker host machine.
After the DAG was built miner nodes are starting to mine. The DAG is generated only once as long as the containers are not destroyed.

Scale Miners
  1. docker-compose up -d --scale geth-miner=${MinerCount} --no-recreate

Ethereum

Account Management

Every miner, including exposed node, has already an existing ethereum account. The account address is located in the file /privatechain/accID inside each miner container or you can use geth console to get it.
The account will be generated when the miner containers are first started. The password is predefined in the file geth-miner/passfile.

Genesis Block

Genesis block is predefined with a very low difficulty to mine. In generally it sould take about 10-20 seconds to mine the next block.

Testing

Tested with: Debian Stretch (9.4) | docker 18.03.0-ce | docker-compose 1.21.0

The geth cluster needs some time to bootstrap and get the ethereum network ready.
Tests can fail if they are executed to fast after the docker-compose is started.

Build test container
  1. docker build -t testing-1 testing
Run test container and attach to existing compose network
  1. docker run -it --network=geth-cluster_overlay --env-file envar.env testing-1

Deployment Smart Contract

Deploy solidity smart contract with truffle. There are two example smart contracts in the folder truffle/sc.
For developing your own smart contract use truffle and your preferred IDE and put it in a separate folder truffle/your-smart-contract.
Both example smart contract are ready to deploy on your ethereum network.

Build truffle deployment container
  1. docker build -t truffle-1 truffle
Run truffle container and attach to existing compose network
  1. docker run -it -w /dapp/${WorkDirSmartContract} --network=geth-cluster_overlay truffle-1 migrate --network geth-chain
  1. # example for deploying example smart contract called "Weather1"
  2. docker run -it -w /dapp/your-smart-contract --network=geth-cluster_overlay truffle-1 migrate --network geth-chain