Will be integrated with edu-chain

---

blockchain-simulator

a general purpose blockchain simulation tool.

Based on one-chain

Abstract

TBA

Details

TBA

Use-Cases

edu-chain

• Instructional Blockchain

How to Use

Preconditions

• Environments

  • Python 3.6.7
  • Node.js v8.11.3 (>=4.3.2)
  • cURL 7.55.1 or Postman v6.4.4

• npm install for onechain, master, and mallcious.

  sh preconditions.sh

Run

sh run.sh

또는

nohup python3 main.py --nodes=400 --neighbors=8 --prop_delay_avg=5000 --prop_delay_std=2000 --sleep=60

• nodes: (full) node 수

• neighbors: 한 노드와 연결할 다른 (최소) 노드 수

• prop_delay_avg: propagation delay의 평균

• prop_delay_std: propagation delay의 표준편차

• sleep: 대기 시간이 필요한 코드들(예를들어 connection이 완료되기를 기다리거나) 사이에서 기다릴 시간, 초(sec) 단위.

• log를 출력하고 싶을 시 nohup 제외:

  python3 main.py --nodes=400 --neighbors=8 --prop_delay_avg=5000 --prop_delay_std=2000 --sleep=60

RESTful API

Get blockchain

curl http://127.0.0.1:3001/blocks

You can pretty-print JSON with:

curl http://127.0.0.1:3001/blocks | python -m json.tool

Python >= 2.6 required.

Add new block

curl -X POST http://127.0.0.1:3001/mineBlock
curl -H "Content-type:application/json" --data "{\"data\" : [\"Anything you want\", \"Anything you need\"]}" http://127.0.0.1:3001/mineBlock

Get connected peers

curl http://127.0.0.1:3001/peers

Cleanup

sh cleanup.sh

Trouble Shootings

flake8 convention

flake8 --ignore E501, E722

ToDo

• 일반적인 블록체인과의 비교

  • ex) geth, etc.

• propagation delay와 selected neighbors에 대한 topology를 설정해야 함.

  • 현재는 그냥 random.gauss나 random으로 주고 있지만, 이유가 있으면 더 좋음.

• mallcious node, light client 추가하기

License

The blockchain-simulator project is licensed under the Apache License, Version 2.0, also included in our repository in the LICENSE file.