An application for you and your friends to bet on horse races on the Blockchain with Ethereum!
- Developed by Kevin Aiken, Alexander Mitchell, Jenny Choi, Kevin Luna, and Aarohi Savaliya.
- React
- Reacstrap
- Drizzle
- Truffle
- Ganache
- Metamask
- Solidity
This section will help you get HorsEther downloaded, installed, and running.
The main directory of the project contains a default layout truffle initiated Solidity project. In addition to this, in the /app folder there is a React app bootstrapped with Create React App.
- Clone the project to your local machine
$ git clone git@github.com:KevinAiken/CSC4980_horse_racing_dapp.git- Make sure that you have all the tools needed to use the app installed:
- Metamask: Download browser plugin at https://metamask.io/
- Ganache: Download the desktop application at https://truffleframework.com/ganache to run a local blockchain
- Truffle:
$ npm install -g truffle
- Deploy the truffle contracts
$ truffle migrate --all --reset- Navigate to the project folder via your terminal and install all the project node modules
$ cd app
$ npm install-
Make sure that you are logged into your Metamask account.
-
Point Metamask at your local Ganache blockchain. You can see how to do this by doing the following:
- Create a workspace in Ganache and enter your Metamask mneumonic in the "Accounts & Keys" section
- Click on Metamask icon and click on the tab that says "Main Ethereum Network" and select "Custom RPC".
- In the box titled "New RPC URL" (to the right of "New Network") enter http://127.0.0.1:8545 and click Save.
- Start the application
We are in the app folder
$ npm start- Open http://localhost:3000 to view the app in your browser.
Before you start placing bets you'll need to act as the admin and create some races to bet on. Keep in mind a race must be in the future.
- Navigate to http://localhost:3000/admin to view the admin panel.
- Type in a race time in ISO 8601 format under "Race Time". After this time bettors can no longer bet on the race, and the race becomes eligible to be evaluated. What evaluation is and how to do it is covered later.
- Enter the Admin Password, 'password'.
- Press create a race.
- "Overrall Number of races" should increment.
- Click load races below. Your race should appear in the table.
After a race's time passes, it becomes eligible to be evaluated. Evaluating a race runs a contract function that psuedo-randomly selected a winner, marks the race evaluated, and transfers funds to bettors following the formula (theirBetValue x numberOfHorses x .8) The other 20% is a fee to the game operator.
- Make sure your contract is properly funded. The contract needs enough Ethereum to be able to pay out potential bets.
- Navigate to http://localhost:3000/admin to view the admin panel.
- Under the create a race form there is a form for evaluating races.
- Enter the Race Index of the race you would like to evaluate. This number can be found by clicking "Load Races" and viewing your race in the table. The race time must be in the past.
- Enter the Admin Password, 'password'.
- Click "Evaluate Race".
- Clicking "Load Races" should refresh the races and let you see the winner and that "Race Evaluated" is now true.
- Click the "Get Started" on the home page or navigate to http://localhost:3000/bet.
- Click "Load Races" to load races that are available to bet on.
- Enter the number of the race you would like to bet on based on the races table.
- Select a horse number. Horses are numbered sequentially.
- Enter your bet amount in Ethereum. Decimal amounts are also acceptable.
- Once a race is evaluated you will receive Ethereum if you bet on the winning horse and nothing if you bet on a losing horse.
To view the results of past races go to http://localhost:3000/past-races and click "Load Races".
Home Page
Place a bet
View past races
View Profile
Admin Panel
Example of a connection failure
