Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stevennevins/house-protocol
A permission-less peer-to-pool open source betting protocol
https://github.com/stevennevins/house-protocol
buidler chainlink chainlink-vrf eth frontend link solidity testnet-eth
Last synced: about 1 month ago
JSON representation
A permission-less peer-to-pool open source betting protocol
- Host: GitHub
- URL: https://github.com/stevennevins/house-protocol
- Owner: stevennevins
- Created: 2020-10-20T00:53:07.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-04-03T01:58:41.000Z (almost 4 years ago)
- Last Synced: 2024-12-09T16:59:14.954Z (about 2 months ago)
- Topics: buidler, chainlink, chainlink-vrf, eth, frontend, link, solidity, testnet-eth
- Language: JavaScript
- Homepage:
- Size: 1.68 MB
- Stars: 4
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Quickstart - Overview
Demo: [Netlify App](https://houseprotocol.netlify.app/)
House Protocol is a peer-to-pool protocol built on Ethereum and Chainlink. House protocol has 3 types of participants: Players, Dealers (HDealer), and Bankroll Liquidity Providers (HPools & HTokens). Players place bets in ERC20 tokens through an HDealer which commits the bet, routes the commitment to the appropriate HPool, and resolves the result of the reveal. The HDealer that routes the bet shares the House edge 50:50 with the HPool. Liquidity Providers contribute collateral ERC20 tokens to an HPool and are issued HTokens for their collateral, which represent their share of the Bankroll for the ERC20 token contributed. Interest accumulates in real-time as bets are routed/resolved by HDealers and placed against the collateral in HPools.
## Tl;dr:
1. Imagine a casino accepting any ERC20 as a bet
2. Anyone can swap in or out of an HPool to earn a share of house edge from their collateral
3. All dealers share the same bankrolls and mutually benefit from their growth
4. Anyone who can capture a niche of player experience can deploy an HDealer from the HDealerFactory and earn revenue without having to take on the risk of raising and securing a bankroll
## Quickstart - Frontend
```bash
git clone https://github.com/dmintercept/house-protocol.git
cd house-protocol
```
>You might want to use tmux to manage the active terminal windows
```bash
yarn install
```
> you might get node-gyp errors, ignore them and run:
```bash
yarn start
```
1. Play
- Get link from [faucet](https://kovan.chain.link/)
- Get Kovan Eth from a [faucet](https://faucet.kovan.network/)
- Get wBTC on Kovan from Compound [faucet](https://app.compound.finance/)
- Approve the HDealer as a spender of Link
- Approve the HPool as spender of the ERC20 token
- Place a bet greater than 10000 wei (this is for precision)
- Edge is deducted from winning bets and given to HPool and HDealer (Can be 0)
2. Deal
- Deploy your own HDealer
- Fork frontend and modify to capture your player niche
- Earn 50% of the edge on bets that flow through your HDealer
3. Earn
- Approve HPool as spender of collateral
- Swap in an out of the pool
- Earn your share of 50% of the edge that flow through the HPool
## Quickstart - Deploy your own
First you will need a buidler account to deploy from
```bash
yarn run generate
```
Once you have your deployer account you will need to get some Kovan Eth : https://faucet.kovan.network/
Once you have Kovan eth in your deployer account you are ready to deploy the contracts
Navigate to the scripts directory in the builder package:
```bash
house-protocol/buidler/scripts
```
Edit the deploy script to deploy either part or all of the protocol.
If you want your own copy of the protocol to play around with you will need to add a line in the deploy script for each of the following:
- HDealerFactory.sol
- HPoolFactory.sol
- HDealer.sol
- HPool.sol
The deploy script will compile, deploy, and publish the contract info into the react application
> in a third terminal window:
```bash
yarn deploy
```