One of the hardest problems to solve when creating a distributed application that lives on the Etehereum blockchain is to derive a truly random number that is immune to manipulation by Ethereum miners.
The event raffle algorithm requires that one winner be selected randomly, i.e, the red circle.
This demo shows us how we can use Keep's Random Beacon implementation to solve this problem.
Jackpot is empty, no players entered
Player 1 enters raffle by submitting at least the minimumn entry fee
Player 2 enters raffle by submitting at least the minimumn entry fee
The manager randomly picks a winner
The jackpots is awarded to the winner
Jackpot is empty, no players entered
This application models an event raffle. Raffles are similar to lotteries, with a few exceptions.
| Element | Lottery | Raffle |
|---|---|---|
| Run By | State run | Charity run and governed by regulatory body |
| Term | Short-term | Longer term, exception allowed for event based bearer raffles |
| Participation Requirement | Bearer certificates (personal information not taken) | Personal info required unless event based bearer raffle |
| Roll Over | There may or may not be a winner for each draw | Definite winner |
| Jackpot Distribution | Jackpot is shared amongst winners | Jackpot is not shared |
| Ticket Number | Scheme Choose your ticket number or randomized ticket numbers available | Randomized draw numbers only |
| Prize Pool | Prize pool grows if there is no winner | Prize pool does not accumulate past draw |
| Number of Tickets | No restriction on the number of tickets sold | Limits the amount of tickets sold |
| Duplicate Tickets | Allows duplicate tickets | Does not allow duplicate tickets |
git clone https://github.com/l3x/blockchain-raffle.git && cd blockchain-raffle
npm i
npm run test
Your output should look like this:
$ npm run test
> blockchainRaffle@0.0.2 test /Users/lex/dev/dapp/blockchain-raffle
> mocha
Keccak bindings are not compiled. Pure JS implementation will be used.
EventRaffle Contract
✓ deploys a contract
✓ allows one account to enter (50ms)
✓ allows multiple accounts to enter (96ms)
✓ requires a minimum amount of ether to enter
✓ only manager can call pickWinner
✓ winner gets jackpot (58ms)
✓ picking winner resets players array and jackpot balance (73ms)
✓ randomly selects a winner (1626ms)
8 passing (2s)
npm must be installed.
-
We use Solidity to create our EventRaffle.sol Ethereum smart contract.
-
We use Ganache to create a virtual Ethereum blockchain, and it generates some fake accounts that our Mocha Javascript tests use.
-
Ether is the cryptocurrency we use to test our smart contract.
-
The Ethereum Virtual Machine EVM is the runtime environment for smart contracts in Ethereum.
-
When we use Ganache, our network of nodes and EVM live within our web browser. Later, we'll use public test networks. When we use the main network, it will cost money to run transactions, until then we're using play money.
-
When we execute smart contract methods that modify data, it costs a small amount of Ether. This is called "gas". Gas is an internal transaction pricing mechanism which is used to mitigate spam and allocate resources on the network.
| Version | Description |
|---|---|
| 1.0.0 | Smart contract, Mocha test framework using Ganache |
| 2.0.0 | Client application using ReactJS and Metamask |
| 3.0.0 | Client application using the Rinkeby test network, not dependent on Metamask |
| 4.0.0 | Client application using the Keep Random Beacon |
| Desciption | Official Link |
|---|---|
| Official Website | https://keep.network/ |
| Official Twitter | https://twitter.com/keep_project |
| Official Slack | https://keep-network.slack.com |
| Official Medium | https://blog.keep.network |
| Official Reddit | https://www.reddit.com/r/KeepNetwork/ |
| Official Telegram | https://t.me/KeepNetworkOfficial |