https://github.com/melanke/critter
Critter is just a codename. This project is a POC of a fully decentralized betting game on Ethereum that doesn't rely on external parts.
https://github.com/melanke/critter
betting dapp ethereum game smart-contracts
Last synced: 6 months ago
JSON representation
Critter is just a codename. This project is a POC of a fully decentralized betting game on Ethereum that doesn't rely on external parts.
- Host: GitHub
- URL: https://github.com/melanke/critter
- Owner: melanke
- License: mit
- Created: 2025-04-03T16:18:29.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-07T11:19:33.000Z (6 months ago)
- Last Synced: 2025-04-07T12:27:13.731Z (6 months ago)
- Topics: betting, dapp, ethereum, game, smart-contracts
- Language: TypeScript
- Homepage:
- Size: 14.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# Critter
_(codename, will change)_
## About
This project is a proof of concept (POC) for a fully decentralized betting game on Ethereum that doesn't rely on external parties.
## Requirements
Before you begin, install the following tools:
- [Node.js (>= v18.18)](https://nodejs.org/en/download/)
- Yarn ([v1](https://classic.yarnpkg.com/en/docs/install/) or [v2+](https://yarnpkg.com/getting-started/install))
- [Git](https://git-scm.com/downloads)
## Quickstart
### 1. Install dependencies
```sh
yarn install
```
### 2. Run a local network
In the first terminal:
```sh
yarn chain
```
This starts a local Ethereum network using Hardhat. The network runs on your machine and can be used for testing and development. You can customize the configuration in `packages/hardhat/hardhat.config.ts`.
### 3. Deploy the contract
In a second terminal:
```sh
yarn deploy
```
This deploys the smart contract to the local network. Contracts are located in `packages/hardhat/contracts`, and the deployment script is in `packages/hardhat/deploy`.
### 4. Start the Next.js app
In a third terminal:
```sh
yarn start
```
Then visit: [http://localhost:3000](http://localhost:3000)
To run smart contract tests:
```sh
yarn hardhat:test
```
### 5. Mock other bettors
To simulate additional bettors, run:
```sh
yarn fillgame --game-id 1
```
This script places a bet on each empty option.
### 6. End the betting period
There are two ways to end the betting period:
#### a) Manually
While logged in with a burner wallet, a "Close Game" button appears when the game reaches the minimum block. Click it and wait.
#### b) Automatically
Run the game recycler bot:
```sh
yarn gamerecycler
```
This bot automatically closes eligible games and creates new ones if no public open games exist.