sweaty-chair / blockopoly-dapp

A complete web dApp for land jackpot buying.

Blockopoly Web DApp

A complete web DApp for land jackpot buying.

There's 42 lands in total and ONE land is released each week. A land is split into 42 plots and all players can join 1 of 4 teams and bid on one or more plots with ethers. Each team has different reward divided rules. (More detail of each team will be finalized)

The bidding process will be just like eBay, where a bidder place a maximum bid and the current bidding price of the plot is automatically adjusted every time another bidder placing a bid. At the end of the week, the team with most bided plots wins the land. The owner of the land will be assigned to the player who having the most total bids within that team. A portion of the bid ethers go back to rewarding the winning team and the rest will be deposited into the final jackpot. How the team get rewards depends on team rule. (E.g. 50% of the bid ethers distributed back to all bidders in winning team, proportionally to their bided total) The winning team and contributed bidders are saved into the land's description permanently.

After all 42 lands are sold, the game enters free-trade period for another week. Land owners can freely trade their lands to another with agreed prices. A small percentage fee will be charged and deposited into the final jackpot. At the end of the free-trade week, the owner of most lands take the final jackpot ethers. (In case the number of lands are equal for 2 players, the player with the most total bidding price wins)

The ownership of the land is a ERC721 token and will be owned by the owner in life time. Owners of the lands can customize and create building of the land, which will be part of Block42 world and will receive income from the interaction with Block42 players.

Please note that this is still in prototype and under heavy development. The final product may be subject to a number of quality assurance tests to verify conformance with specifications.

• Prototype from Truffle Box React
• Bootstrap v4.1.3
• Web3.js v1.0 beta 35
• OpenZeppelin v1.12.0 solidity framework for best security and stability

Getting Started

Prerequisites

• Node.js
• Truffle npm install -g truffle

Install local dependencies

npm install

Setup enviroment

Mneonmic is used to generate the same wallets every time for easier testing. For security reason, you have to put in your own mneonmic from either Metamask or Geneche. Rename .env.example to .env, put your Mnenonmic and Infura API Key (if you deploy to testnet).

Blockchain smart contract development

Run the Truffle development console

truffle develop

Compile and migrate the smart contracts in Truffle console

compile
migrate

Test smart contracts

// If inside the development console.
test
// If outside the development console..
truffle test

React.js frontend development

Run the webpack server for front-end hot reloading (outside the development console

// Serves the front-end on http://localhost:3000
npm run start

Jest is included for testing React components. Compile your contracts before running Jest, or you may receive some file not found errors

npm run test

To build the application for production, use the build command. A production build will be in the build_webpack folder

npm run build

(Optional) This project utilizes gh-pages to deploy to GitHub Pages for demo purpose.

npm run deploy

Deployed demo

• Github Page

Terminology For Dummies

• Truffle - A development framework for Ethereum for writing, deploying and testing smart contract solidity scripts
• Web3.js - A JavaScript library for communicating with Ethereum network
• React.js - A JavaScript library for building frontend user interfaces
• Node.js - A JavaScript runtime for building scalable network applications

More Info

• Truffle Boxes
• create-react-app

Helper Links

• GitHub Page Demo
• Ethereum Ropsten Faucet
• Ethereum Rinkeby Faucet
• Ethereum Kovan Faucet

TODO

• Add better graphic for MetaMask install instruction
• Add CoverAlls badge