{"id":17971141,"url":"https://github.com/stevennevins/house-protocol","last_synced_at":"2025-07-05T09:05:04.379Z","repository":{"id":158522683,"uuid":"305550507","full_name":"stevennevins/house-protocol","owner":"stevennevins","description":"A permission-less peer-to-pool open source betting protocol","archived":false,"fork":false,"pushed_at":"2021-04-03T01:58:41.000Z","size":1763,"stargazers_count":4,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-02T17:56:26.762Z","etag":null,"topics":["buidler","chainlink","chainlink-vrf","eth","frontend","link","solidity","testnet-eth"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stevennevins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-20T00:53:07.000Z","updated_at":"2024-01-08T15:43:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"b43e0bf6-d63a-4b3b-bbf3-34898ad28c2b","html_url":"https://github.com/stevennevins/house-protocol","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stevennevins/house-protocol","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevennevins%2Fhouse-protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevennevins%2Fhouse-protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevennevins%2Fhouse-protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevennevins%2Fhouse-protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stevennevins","download_url":"https://codeload.github.com/stevennevins/house-protocol/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevennevins%2Fhouse-protocol/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263715326,"owners_count":23500241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["buidler","chainlink","chainlink-vrf","eth","frontend","link","solidity","testnet-eth"],"created_at":"2024-10-29T15:37:01.686Z","updated_at":"2025-07-05T09:05:04.362Z","avatar_url":"https://github.com/stevennevins.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Quickstart - Overview\n\nDemo: [Netlify App](https://houseprotocol.netlify.app/)\n\nHouse 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 \u0026 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.\n\n## Tl;dr:\n\n1. Imagine a casino accepting any ERC20 as a bet\n\n2. Anyone can swap in or out of an HPool to earn a share of house edge from their collateral\n\n3. All dealers share the same bankrolls and mutually benefit from their growth\n\n4. 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\n\n## Quickstart - Frontend\n\n```bash \ngit clone https://github.com/dmintercept/house-protocol.git \n\ncd house-protocol \n```\n\u003eYou might want to use tmux to manage the active terminal windows\n```bash\nyarn install\n```\n\u003e you might get node-gyp errors, ignore them and run:\n```bash\nyarn start\n```\n\n1. Play\n    - Get link from [faucet](https://kovan.chain.link/) \n    - Get Kovan Eth from a [faucet](https://faucet.kovan.network/)\n    - Get wBTC on Kovan from Compound [faucet](https://app.compound.finance/)\n    - Approve the HDealer as a spender of Link\n    - Approve the HPool as spender of the ERC20 token\n    - Place a bet greater than 10000 wei (this is for precision)\n    - Edge is deducted from winning bets and given to HPool and HDealer (Can be 0)\n\n2. Deal\n    - Deploy your own HDealer\n    - Fork frontend and modify to capture your player niche\n    - Earn 50% of the edge on bets that flow through your HDealer\n\n 3. Earn\n    - Approve HPool as spender of collateral\n    - Swap in an out of the pool\n    - Earn your share of 50% of the edge that flow through the HPool\n\n## Quickstart - Deploy your own\n\nFirst you will need a buidler account to deploy from\n```bash\nyarn run generate\n```\n\nOnce you have your deployer account you will need to get some Kovan Eth : https://faucet.kovan.network/\n\nOnce you have Kovan eth in your deployer account you are ready to deploy the contracts\n\nNavigate to the scripts directory in the builder package:\n\n```bash\nhouse-protocol/buidler/scripts\n```\n\nEdit the deploy script to deploy either part or all of the protocol.\n\nIf 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:\n\n- HDealerFactory.sol\n- HPoolFactory.sol\n- HDealer.sol\n- HPool.sol\n\nThe deploy script will compile, deploy, and publish the contract info into the react application\n\n\u003e in a third terminal window:\n```bash\nyarn deploy\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevennevins%2Fhouse-protocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevennevins%2Fhouse-protocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevennevins%2Fhouse-protocol/lists"}