This repo provides code for directly simulating a selfish mining attack on a real, simplified blockchain. Blocks are actually mined using their hashes, and mining order is determined by the relative hash power of each miner. This code supports an unlimited number of honest and adversarial miners (given that their fractional hash power sums to 1).
- To run the mining backend, first install the python libraries in
mining/requirements.txt. - Next, run
python mining/server.py
GET /start (Start Mining with defaults)POST /start (Start Mining with Custom Params)
name type data type description honest_powerrequired list[int] List of honest mining powers adversarial_powerrequired list[int] List of adversarial mining powers ^^ Must sum to 1 difficultyoptional str Difficulty, EX: 0000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
{"honest_power":[0.2,0.1], "adversarial_power":[0.7], "difficulty":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"}
http code content-type response 200text/plain;charset=UTF-8Started!400application/jsonHash power does not sum to 1
GET /stop (Stop Mining)GET /restart (Restart Mining - Call /start afterwards)GET /blockchain (Get String representation of the Blockchain)GET /chain-quality (Get chain quality as a decimal)GET /longest-chain (Get block hashes of the longest chain)- Install packages with
npm install - Start the development server with
npm run dev
- Set the mining difficulty (higher leads to longer mining time)
- Add some number of miners, set their hash powers as fractions which sum to 1, and choose which should be adversarial
- Start mining, and stop mining to change simulation parameters again
- The gray block is the genesis block
- White blocks are blocks mined by honest nodes
- Red blocks are published blocks mined by adversarial nodes
- Yellow blocks are unpublished blocks mined by adversarial nodes
- Block numbers are effectively the miner address, referring to the nth honest or adversarial miner